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

Ticketoryشغّل تيكيتوري محليًا

شغّل تيكيتوري محليًا

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

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

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

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

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

افتح كل طرفية في المكان الذي تتوقعه الأوامر أدناه: داخل ticketory-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 من وجود كل صورة تجريبية في public/media، ثم ينشئ database.sqlite وجداوله وأربعة منظّمين تجريبيين، لكل منهم مساحة عمل: 29 صلاحية، وأدوار المالك والمدير والمالية وتسجيل الدخول، و9 أماكن، و36 فعالية (22 منها على الموقع)، و1,145 طلبًا، و14 حساب موظف، وحاضرًا لديه ثمانية طلبات. وينتهي بطباعة بيانات دخول المالك والحاضر. تتبع التواريخ اليوم الذي تشغّل فيه الأمر. تشغيله مرة أخرى لا يضيف صفوفًا ولا يعيد ضبط أي كلمة مرور، لكنه يعيد الأدوار الأربعة الجاهزة إلى صلاحياتها الافتراضية.

    الطرفيةفي 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 ticketory-backend
yarn install
cp .env.example .env
    تواجه مشكلة؟

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

    يتحقق yarn seed من وجود كل صورة تجريبية في public/media، ثم ينشئ database.sqlite وجداوله وأربعة منظّمين تجريبيين، لكل منهم مساحة عمل: 29 صلاحية، وأدوار المالك والمدير والمالية وتسجيل الدخول، و9 أماكن، و36 فعالية (22 منها على الموقع)، و1,145 طلبًا، و14 حساب موظف، وحاضرًا لديه ثمانية طلبات. وينتهي بطباعة بيانات دخول المالك والحاضر. تتبع التواريخ اليوم الذي تشغّل فيه الأمر. تشغيله مرة أخرى لا يضيف صفوفًا ولا يعيد ضبط أي كلمة مرور، لكنه يعيد الأدوار الأربعة الجاهزة إلى صلاحياتها الافتراضية.

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

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

    الطرفيةفي ticketory-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 ticketory-website
yarn install
cp .env.example .env
    تواجه مشكلة؟

  2. شغّله

    الطرفيةفي ticketory-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محلي نموذج تسجيل الدخول. سجّل الدخول بالبريد owner@example.test وكلمة المرور DemoOnly!2026.

    تواجه مشكلة؟

شغّل لوحة المنظّم

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

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

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

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

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

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

    النتيجة المتوقعة: يفتح localhost:3031محلي نموذج تسجيل الدخول. سجّل الدخول بالبريد owner@example.test وكلمة المرور DemoOnly!2026، وهما مقبولان في واجهة API التي فيها بيانات تجريبية.

    تواجه مشكلة؟

منافذ أخرى

من دون Docker تكون المنافذ ثابتة داخل الملفات. يمرّر سكربتا dev وstart للموقع في package.json الخيار -p 3030، ويمرّر سكربتا اللوحة الخيار -p 3031: غيّر الرقم هناك لنقل أحدهما، ثم أضف العنوان الجديد إلى CORS_ORIGIN في .env الخاص بواجهة API، واضبط هناك STOREFRONT_URL إذا نقلت الموقع، أو FRONTEND_URL إذا نقلت اللوحة. ولنقل واجهة API اضبط PORT وPUBLIC_MEDIA_URL وPUBLIC_API_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
STOREFRONT_URL=http://localhost:3030
PUBLIC_API_URL=http://localhost:8000
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-31

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

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

حل المشكلات

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

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