سُفرة نظام طلبات أونلاين متكامل للمطاعم، بالعربية والإنجليزية. مشروع Next.js واحد يضم ثلاثة أجزاء تعمل على قاعدة بيانات واحدة:
| الجزء | ماذا يفعل | أين |
|---|---|---|
| موقع الطلبات | قائمة طعام مع بحث، وخيارات للأطباق، وسلة، وإتمام الطلب للاستلام أو التوصيل أو الطاولة، وتتبع مباشر للطلب، وحجز طاولات | /ar و /en |
| لوحة الموظفين | لوحة مطبخ حيّة مع تنبيه صوتي، وإدارة القائمة والصور، والحجوزات، وساعات العمل، والأسعار، وحسابات الموظفين | /ar/dashboard |
| واجهة API | نقاط REST يستخدمها الجزءان، ويمكن أن تستخدمها تطبيقاتك الخاصة | /api/... |
ما الذي تحصل عليه
- العربية أولاً (من اليمين إلى اليسار) مع نسخة إنجليزية كاملة، والتبديل متاح في كل صفحة.
- الأسعار تُحسب دائماً على الخادم من القائمة في قاعدة البيانات، بأصغر وحدة للعملة (البيسة للريال العماني).
- الدفع نقداً جاهز، والدفع بالبطاقة عبر ثواني عند إضافة مفاتيحك.
- ساعات عمل تدعم الإغلاق بعد منتصف الليل، وزر «إيقاف الطلبات أونلاين» لليالي الزحام.
- صلاحيتان: المالك والموظف. الموظفون يديرون الطلبات والحجوزات والأطباق النافدة، والمالك وحده يغيّر الأسعار والقائمة والإعدادات والحسابات.
- ذكاء اصطناعي اختياري يكتب أوصاف الأطباق باللغتين، مع أي مزوّد متوافق مع OpenAI.
- مطعم عُماني تجريبي (6 أقسام و22 طبقاً بصورها وخياراتها) ليبدو الموقع مكتملاً من أول دقيقة.
بداية سريعة
npm install
cp .env.example .env
npm run setup
npm run dev
افتح http://localhost:3301 للموقع، و http://localhost:3301/ar/dashboard للوحة. حساب المالك الأول يأتي من OWNER_EMAIL و OWNER_PASSWORD في ملف .env (انظر التثبيت).
أين توجد الأشياء
prisma/schema.prisma جداول قاعدة البيانات
prisma/seed.mjs المطعم التجريبي وحساب المالك الأول
messages/ar.json, en.json كل نصوص الموقع واللوحة
src/app/[locale]/(site) صفحات موقع الطلبات
src/app/[locale]/dashboard صفحات لوحة الموظفين
src/app/api الـ API
src/lib الأسعار، قواعد الطلبات، الدفع، الذكاء الاصطناعي، الجلسات
src/components مكونات الموقع واللوحة
src/app/globals.css الألوان والخطوط والزوايا (هويتك)
public/images/menu صور الأطباق
tests اختبارات الوحدات (npm test)
الخطوات التالية
- ثبّت المشروع وادخل إلى اللوحة.
- أدخل اسم مطعمك وعنوانه وساعاته وأسعاره في اللوحة > الإعدادات.
- استبدل القائمة التجريبية من اللوحة > القائمة.
- اضبط ألوانك وشعارك (الهوية والألوان).
- قرّر بشأن الدفع بالبطاقة (الدفع) ثم انشر الموقع (التثبيت اليدوي والنشر).