انتقل إلى المقال
Aniq-UI

Velraشغّل الوكالة محليًا

شغّل الوكالة محليًا

ثبّت كل تطبيق وشغّله باستخدام Node.js و Yarn، بطرفية مستقلة لكل تطبيق.

لحزمة الحزمة الكاملة

Dockerموصى بهالتثبيت اليدوي

قبل أن تبدأ: ثبّت Node.js 22 أو أحدث وشغّل corepack enable مرة واحدة (على Node.js 25 وما بعده، التي لا تضم Corepack، شغّل npm install -g corepack أولًا). لا حاجة إلى خادم قاعدة بيانات.

اطّلع على المتطلبات

افتح كل طرفية في المكان الذي تتوقعه الأوامر أدناه: داخل velra-real-estate-full-stack للحزمة الكاملة، أو بجانب مجلد التطبيق لحزمة التطبيق الواحد.

التطبيقالمجلدالعنوان
APIback-endlocalhost:8000محلي
الموقع العامstorefrontlocalhost:3030محلي
لوحة تحكم الوكالةadmin-dashboardlocalhost:3031محلي

شغّل واجهة API أولًا: تقرأ الواجهتان الأماميتان كل بياناتهما منها.

شغّل واجهة API

  1. ثبّت واضبط الإعداد

    يعمل .env.example كما هو للتطوير المحلي: SQLite على المنفذ 8000.

    الطرفية
    corepack enable
cd back-end
yarn install
cp .env.example .env
    تواجه مشكلة؟

  2. أنشئ قاعدة البيانات

    يتحقق yarn seed من وجود كل صورة أولية، ثم ينشئ database.sqlite وجداوله والوكالة التجريبية: 31 صلاحية، ودورَي المدير العام والوكيل، والحسابين، و11 إعدادًا للوكالة، و6 أحياء، و17 عقارًا (15 منشورًا ومسودتان) مع 38 صورة معرض، ومعاينتين معتمدتين للتأثيث، و5 استفسارات، و8 طلبات معاينة. وتشغيله مرة أخرى يضيف ما ينقص فقط ولا يعيد ضبط أي كلمة مرور.

    الطرفيةفي back-end
    yarn seed

  3. شغّل الخادم

    الطرفيةفي back-end
    yarn dev

    النتيجة المتوقعة: يجيب localhost:8000/api/healthمحلي بـ "status":"ok" و"database":"up".

    تواجه مشكلة؟

شغّل واجهة API

  1. ثبّت واضبط الإعداد

    يعمل .env.example كما هو للتطوير المحلي: SQLite على المنفذ 8000.

    الطرفية
    corepack enable
cd velra-backend
yarn install
cp .env.example .env
    تواجه مشكلة؟

  2. أنشئ قاعدة البيانات

    يتحقق yarn seed من وجود كل صورة أولية، ثم ينشئ database.sqlite وجداوله والوكالة التجريبية: 31 صلاحية، ودورَي المدير العام والوكيل، والحسابين، و11 إعدادًا للوكالة، و6 أحياء، و17 عقارًا (15 منشورًا ومسودتان) مع 38 صورة معرض، ومعاينتين معتمدتين للتأثيث، و5 استفسارات، و8 طلبات معاينة. وتشغيله مرة أخرى يضيف ما ينقص فقط ولا يعيد ضبط أي كلمة مرور.

    الطرفيةفي velra-backend
    yarn seed

  3. شغّل الخادم

    الطرفيةفي velra-backend
    yarn dev

    النتيجة المتوقعة: يجيب localhost:8000/api/healthمحلي بـ "status":"ok" و"database":"up".

    تواجه مشكلة؟

شغّل الموقع العام

في طرفية ثانية:

  1. ثبّت واضبط الإعداد

    يوجّه ملف .env المنسوخ الموقعَ إلى واجهة API على المنفذ 8000.

    الطرفية
    cd storefront
yarn install
cp .env.example .env

  2. شغّله

    الطرفيةفي storefront
    yarn dev

    النتيجة المتوقعة: يفتح localhost:3030محلي الموقع بالإنجليزية مع العقارات التجريبية؛ والعربية على /ar.

    تواجه مشكلة؟

شغّل الموقع العام

واجهة API ليست جزءًا من هذه الحزمة. شغّلها أولًا؛ يتوقعها ملف .env المنسوخ على http://localhost:8000/api.

  1. ثبّت واضبط الإعداد

    إذا كانت واجهة API تعمل في مكان آخر، اضبط NEXT_PUBLIC_API_BASE_URL في .env على عنوانها، مع /api.

    الطرفية
    corepack enable
cd velra-website
yarn install
cp .env.example .env
    تواجه مشكلة؟

  2. شغّله

    الطرفيةفي velra-website
    yarn dev

    النتيجة المتوقعة: يفتح localhost:3030محلي الموقع مع العقارات القادمة من واجهة API الخاصة بك؛ والعربية على /ar.

    تواجه مشكلة؟

شغّل لوحة تحكم الوكالة

في طرفية ثالثة:

  1. ثبّت واضبط الإعداد

    يوجّه ملف .env المنسوخ لوحة التحكم إلى واجهة API وإشعاراتها المباشرة على المنفذ 8000.

    الطرفية
    cd admin-dashboard
yarn install
cp .env.example .env

  2. شغّلها وسجّل الدخول

    ينسخ yarn dev أولًا عامل مكتبة الخرائط إلى public/maplibre/، ثم يشغّل لوحة التحكم.

    الطرفيةفي admin-dashboard
    yarn dev

    النتيجة المتوقعة: يفتح localhost:3031محلي نموذج تسجيل الدخول. سجّل الدخول بـ admin@velra.example وكلمة المرور Admin@123.

    تواجه مشكلة؟

شغّل لوحة تحكم الوكالة

واجهة API ليست جزءًا من هذه الحزمة. شغّلها أولًا؛ يتوقعها ملف .env المنسوخ على http://localhost:8000/api.

  1. ثبّت واضبط الإعداد

    إذا كانت واجهة API تعمل في مكان آخر، اضبط NEXT_PUBLIC_API_BASE_URL (مع /api) وNEXT_PUBLIC_WEBSOCKET_BASE_URL (من دونه) في .env على عنوانها.

    الطرفية
    corepack enable
cd velra-agency-dashboard
yarn install
cp .env.example .env
    تواجه مشكلة؟

  2. شغّلها وسجّل الدخول

    الطرفيةفي velra-agency-dashboard
    yarn dev

    النتيجة المتوقعة: يفتح localhost:3031محلي نموذج تسجيل الدخول. سجّل الدخول بـ admin@velra.example وكلمة المرور Admin@123، وتقبلهما واجهة API التي مُلئت بالبيانات الأولية.

    تواجه مشكلة؟

منافذ أخرى

بدون Docker تكون المنافذ ثابتة في الملفات. يمرّر سكربتا dev وstart للموقع في package.json الخيار -p 3030، ويمرر سكربتا لوحة التحكم -p 3031: غيّر الرقم هناك لنقل أحدهما، ثم أضف العنوان الجديد إلى CORS_ORIGIN في ملف .env الخاص بواجهة API، وللوحة التحكم اضبط FRONTEND_URL هناك عليه أيضًا. ولنقل واجهة API اضبط PORT وPUBLIC_MEDIA_URL في .env الخاص بها على الرقم نفسه، وNEXT_PUBLIC_API_BASE_URL في الواجهتين الأماميتين (وNEXT_PUBLIC_WEBSOCKET_BASE_URL للوحة التحكم أيضًا).

بناء الإنتاج

المجلدات نفسها، تُبنى مرة واحدة ثم تُشغَّل. اضبط أولًا .env الخاص بواجهة API للإنتاج: مع NODE_ENV=production لا تغيّر واجهة API الجداول عند التشغيل، وترفض البدء ما دام JWT_SECRET فارغًا أو ما زال قيمة المثال، أو ما دام CORS_ORIGIN فارغًا.

ملف .env الخاص بواجهة API
NODE_ENV=production
JWT_SECRET=paste-the-generated-secret-here
CORS_ORIGIN=http://localhost:3030,http://localhost:3031
FRONTEND_URL=http://localhost:3031
PUBLIC_MEDIA_URL=http://localhost:8000/media

ولّد السر بالأمر node -e "console.log(require('crypto').randomBytes(48).toString('hex'))". ثم، في مجلد واجهة API، ابنها وأنشئ جداولها مرة واحدة وشغّلها. يضيف yarn seed:prod الوكالة التجريبية وحساباتها؛ أما yarn db:sync:prod فينشئ بدلًا منه جداول فارغة بلا حسابات.

الطرفية
yarn build
yarn seed:prod
yarn start:prod

بناء الإنتاج للواجهات الأمامية

في مجلد كل واجهة أمامية، ابنِ مرة واحدة ثم شغّل. يعمل الموقع على 3030 ولوحة التحكم على 3031.

الطرفية
yarn build
yarn start

تدمج الواجهتان الأماميتان ملف .env عند البناء، لذلك شغّل yarn build مرة أخرى بعد تغييره. قبل النشر في أي مكان عام، اقرأ دليل النشر.

ابدأ من جديد ببيانات تجريبية جديدة

أوقف واجهة API، ثم احذف ملف قاعدة البيانات واملأه بالبيانات مرة أخرى، داخل مجلد واجهة API. هذا يحذف كل ما أنشأته.

الطرفية
rm -f database.sqlite* && yarn seed

في PowerShell:

الطرفية
Remove-Item database.sqlite*; yarn seed

التالي

هل كان هذا مفيدًا؟

تمت مراجعته على إصدار 2026-10-11

توقفت عند خطوة؟

ابحث عن الحل قبل أن تبدأ من جديد.

حل المشكلات

تفضيلات ملفات تعريف الارتباط

نستخدم ملفات تعريف الارتباط لتعزيز تجربة التصفح الخاصة بك وتحليل حركة المرور على الموقع وتخصيص المحتوى. بالنقر على "قبول الكل"، فإنك توافق على استخدامنا لملفات تعريف الارتباط للتحليلات والإعلانات المخصصة.