مِمّ يتكوّن القالب
بيع تذاكر الفعاليات من ورش العمل والمحاضرات والمهرجانات في ثلاثة تطبيقات: الموقع العام الذي يجد فيه الحضور الفعاليات ويشترون التذاكر، ولوحة المنظّم، وواجهة NestJS API التي تخدم الاثنين.
| التطبيق | المجلد | المنفذ | ما هو |
|---|---|---|---|
| الموقع العام | storefront/ | 3030 | فعاليات مع بحث وفلاتر تبقى في العنوان، وصفحات للفعاليات، واختيار المقاعد على خريطة مقاعد حية مع حجز مؤقت بمهلة، ودفع مستضاف (التذاكر المجانية تتخطى الدفع)، وتذاكر برموز QR وملفات PDF وملفات تقويم، وتذاكر الحاضر وطلباته وفعالياته المحفوظة وملفه الشخصي، والأماكن والمنظّمون والأسعار والأسئلة الشائعة والتواصل |
| لوحة المنظّم | admin-dashboard/ | 3031 | نظرة عامة على المبيعات والباب المباشر، والفعاليات ومحررها، والأماكن على خريطة مع محرر مخطط المقاعد، وتسجيل الدخول بالكاميرا أو برمز يُكتب يدويًا، والطلبات والاستردادات، وتقارير مع تصدير CSV، والفريق والأدوار، ومساحات العمل، والاستفسارات، والإشعارات المباشرة، ومساعد الفعاليات بالذكاء الاصطناعي واستوديو الأماكن بالذكاء الاصطناعي |
| API | back-end/ | 8000 | NestJS 11 وTypeORM، على SQLite محليًا وMySQL بالإعداد، وكل المسارات تحت /api |
يحتوي المجلد أيضًا على docker-compose.yml الذي يبني التطبيقات الثلاثة ويشغّلها بأمر واحد، ولكل تطبيق Dockerfile خاص به.
ما تحتويه حزمتك
حزمة موقع التذاكر هي الموقع العام وحده.
| التطبيق | المجلد | المنفذ | ما هو |
|---|---|---|---|
| الموقع العام | storefront/ | 3030 | فعاليات مع بحث وفلاتر تبقى في العنوان، وصفحات للفعاليات، واختيار المقاعد على خريطة مقاعد حية مع حجز مؤقت بمهلة، ودفع مستضاف (التذاكر المجانية تتخطى الدفع)، وتذاكر برموز QR وملفات PDF وملفات تقويم، وتذاكر الحاضر وطلباته وفعالياته المحفوظة وملفه الشخصي، والأماكن والمنظّمون والأسعار والأسئلة الشائعة والتواصل |
ليس له بيانات خاصة به: كل فعالية ومقعد وحجز وطلب وتذكرة تأتي من واجهة API الخاصة بتيكيتوري، لذلك يحتاج إلى تشغيل تلك الواجهة. واجهة API ولوحة المنظّم حزمتان منفصلتان وليستا ضمن هذا التنزيل.
ما تحتويه حزمتك
حزمة لوحة المنظّم هي لوحة المنظّم وحدها.
| التطبيق | المجلد | المنفذ | ما هو |
|---|---|---|---|
| لوحة المنظّم | admin-dashboard/ | 3031 | نظرة عامة على المبيعات والباب المباشر، والفعاليات ومحررها، والأماكن على خريطة مع محرر مخطط المقاعد، وتسجيل الدخول بالكاميرا أو برمز يُكتب يدويًا، والطلبات والاستردادات، وتقارير مع تصدير CSV، والفريق والأدوار، ومساحات العمل، والاستفسارات، والإشعارات المباشرة، ومساعد الفعاليات بالذكاء الاصطناعي واستوديو الأماكن بالذكاء الاصطناعي |
ليس لها بيانات خاصة بها: كل شاشة تقرأ وتكتب عبر واجهة API الخاصة بتيكيتوري، لذلك تحتاج إلى تشغيل تلك الواجهة. واجهة API والموقع العام حزمتان منفصلتان وليستا ضمن هذا التنزيل.
ما تحتويه حزمتك
حزمة واجهة API الخلفية هي واجهة NestJS API وحدها، مع قاعدة البيانات والمنظّمين التجريبيين وكل مسار يستخدمه التطبيقان الأماميان.
| التطبيق | المجلد | المنفذ | ما هو |
|---|---|---|---|
| API | back-end/ | 8000 | NestJS 11 وTypeORM، على SQLite محليًا وMySQL بالإعداد، وكل المسارات تحت /api |
الموقع العام ولوحة المنظّم حزمتان منفصلتان وليستا ضمن هذا التنزيل. يستطيع أي عميل استخدام واجهة API عبر HTTP.
على Windows، استخدم PowerShell أو Git Bash لتنفيذ الأوامر الواردة في هذه الأدلة.
تعمل الواجهتان الأماميتان بالإنجليزية والعربية، مع واجهة عربية من اليمين إلى اليسار، وبمظهر فاتح وداكن ومظهر يتبع النظام.