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

خاص بـ: الحزمة الكاملة · واجهة API

نموذج البيانات

جداول قاعدة البيانات والعلاقات بينها.

الهيكل في prisma/schema.prisma. بعد تعديله شغّل npx prisma db push (يطبّقه على قاعدة البيانات) و npx prisma generate (يحدّث الكود).

Category 1 ── * MenuItem 1 ── * OptionGroup 1 ── * Option
Order 1 ── * OrderItem          (نسخ من الأسماء والأسعار والخيارات وقت الطلب)
Order 1 ── * OrderEvent         (سجل الحالات: من ومتى وملاحظة)
Reservation                     (طلبات حجز الطاولات)
StaffUser                       (حسابات اللوحة)
Setting                         (صف واحد، id = 1)
الجدول أهم الحقول
Setting الأسماء والشعارات والعناوين باللغتين، والهاتف، وواتساب، ورابط الخريطة، والعملة وخاناتها، ونسبة الضريبة، ورسوم التوصيل، والحد الأدنى، وطرق الاستلام والدفع المفعّلة، و acceptingOrders، و hours (JSON)
Category slug و nameAr و nameEn و sort و active
MenuItem slug، والقسم، والأسماء والأوصاف، و price و image و calories و prepMinutes و tags (JSON) و available و featured و sort
OptionGroup الطبق، والأسماء، و required و maxSelect و sort
Option المجموعة، والأسماء، و priceDelta
Order code (العام)، و status و type، واسم الزبون وهاتفه وعنوانه، والطاولة، والملاحظات، و subtotal و deliveryFee و tax و total و paymentMethod و paymentStatus و paymentRef (جلسة ثواني) و locale
OrderItem الأسماء باللغتين، و unitPrice و quantity و options (نسخة JSON) و note و lineTotal
OrderEvent status، و by (اسم الموظف أو customer أو thawani أو system)، و note و at
Reservation code، والاسم والهاتف، و people و date (YYYY-MM-DD) و time (HH:MM)، والملاحظات، و status
StaffUser الاسم، و email و passwordHash (scrypt) و role (OWNER / STAFF) و active

قواعد مهمة

  • المال دائماً عدد صحيح بأصغر وحدة، ولا تُحفظ الكسور أبداً.
  • الطلبات تنسخ ما بيع فيها. تغيير طبق أو حذفه لا يغيّر الطلبات السابقة ولا التقارير.
  • رموز الطلبات عشوائية (SF-XXXX-XXXX، حروف وأرقام بلا المتشابهات مثل 0/O و1/I)، فلا يستطيع زبون تخمين طلبات غيره.
  • مسار الطلب مفروض على الخادم في src/lib/rules.ts، واللوحة لا تعرض إلا الخطوات المسموحة.
  • ساعات العمل تُفحص بتوقيت RESTAURANT_TIMEZONE، ووقت الإغلاق الأبكر من الفتح يمتد بعد منتصف الليل.

للقواعد البحتة (الأسعار والحالات والساعات والرموز وإخفاء الهاتف) اختبارات وحدات في tests/ (npm test).