سُفرة التوثيق · سُفرة

توثيق سُفرة

شغّل قالب مطعم سُفرة، وجهّزه لمطعمك، وجد الحل عندما يحدث خطأ.

سُفرة نظام طلبات أونلاين متكامل للمطاعم، بالعربية والإنجليزية. مشروع 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)

الخطوات التالية

  1. ثبّت المشروع وادخل إلى اللوحة.
  2. أدخل اسم مطعمك وعنوانه وساعاته وأسعاره في اللوحة > الإعدادات.
  3. استبدل القائمة التجريبية من اللوحة > القائمة.
  4. اضبط ألوانك وشعارك (الهوية والألوان).
  5. قرّر بشأن الدفع بالبطاقة (الدفع) ثم انشر الموقع (التثبيت اليدوي والنشر).