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

جداول قاعدة البيانات وأهم أعمدتها، والقواعد التي تحفظ المخزون والمبالغ صحيحة.

المخطط في prisma/schema.prisma. أعمدة المبالغ أعداد صحيحة بأصغر وحدة للعملة (البيسة للريال العماني)، والنصوص التي يراها العميل لها عمود عربي وآخر إنجليزي.

الجداول

الجدول محتواه
Setting صف واحد (id = 1): اسم المتجر وشعاره النصي والإعلان والتواصل والعملة وخاناتها والضريبة وحد المخزون المنخفض وطرق التوصيل (JSON) وخيارات الدفع واستقبال الطلبات والهدف الشهري وصلاحيات الأدوار (JSON)
Category الأقسام: الرابط والاسمان والوصفان والصورة والترتيب والظهور
Collection التشكيلات: الحقول نفسها إضافة إلى featured، مرتبطة بالمنتجات بعلاقة متعدد لمتعدد
Product الرابط والقسم والاسمان والوصفان والسعر الأساسي price وcompareAt الاختياري (السعر السابق) وimages (قائمة JSON، أولها الغلاف) وfeatured وactive وsort
ProductVariant تركيبة قابلة للشراء: sku فريد وsize واسما اللون وcolorHex وprice خاص اختياري (الفارغ يعني سعر المنتج) وstock
Coupon code (بحروف كبيرة وفريد) وtype نسبة PERCENT أو مبلغ FIXED وvalue وminOrder وexpiresAt وusageLimit وusedCount وactive
Order code يصعب تخمينه وstatus واسم العميل وهاتفه وبريده وgovernorate والولاية والعنوان والملاحظات وطريقة التوصيل وsubtotal وdiscount وshippingFee وtax وtotal ورمز الكوبون وpaymentMethod (COD أو CARD) وpaymentStatus (UNPAID أو PAID أو FAILED أو REFUNDED) وpaymentRef (جلسة «ثواني») وlocale وcustomerId الاختياري
OrderItem نسخة مما اشتُري: معرّفا المنتج والخيار وSKU والأسماء ووصف الخيار («M / رملي») والصورة وسعر الوحدة والكمية وإجمالي السطر
OrderEvent سجلّ الطلب: الحالة والملاحظة ومن أجرى التغيير (customer أو thawani أو system أو اسم المشرف) والوقت
StaffUser حسابات اللوحة: الاسم والبريد الفريد وبصمة كلمة المرور (scrypt) وrole (OWNER أو ADMIN أو STAFF) وactive
Customer حسابات العملاء: الاسم والبريد الفريد والهاتف وبصمة كلمة المرور
WishlistItem عميل ومنتج، فريدان معًا
ContactMessage رسائل صفحة التواصل، مع handled

العلاقات

Category 1─* Product *─* Collection
Product 1─* ProductVariant
Product 1─* WishlistItem *─1 Customer
Customer 1─* Order 1─* OrderItem
                Order 1─* OrderEvent

حذف منتج يحذف خياراته وسجلات المفضلة المرتبطة به، وتحتفظ الطلبات السابقة بنسختها من الأسماء والأسعار (أعمدة OrderItem) فلا يتغير التاريخ. لا يُحذف قسم فيه منتجات. وحذف حساب عميل يبقي طلباته (يُفرَّغ الربط فقط).

قواعد تحفظ الأرقام صحيحة

  • الأسعار من قاعدة البيانات لا من المتصفح. يدمج src/lib/pricing.ts الأسطر المكررة، ويتحقق أن كل خيار معروض ومتوفر، ويطبق الكوبون (دون أن يتجاوز المجموع الفرعي)، ويختار رسوم التوصيل (مجاني فوق حد الطريقة، محسوبًا بعد الخصم)، ثم يضيف الضريبة على المجموع الفرعي ناقص الخصم زائد التوصيل، مقرّبة لأقرب بيسة.
  • المخزون والكوبون يُخصمان في معاملة الطلب بتحديثات مشروطة (stock >= quantity وusedCount < usageLimit)، فإن فشل أحدهما لم يُحفظ شيء.
  • الإلغاء والاسترداد يعيدان المخزون، والإلغاء يعيد استخدام الكوبون أيضًا.
  • رموز الطلبات مثل SQ-7KQ2-M9XD: عشوائية، دون حروف متشابهة الشكل، ويُعاد توليدها في حال التصادم النادر.
  • الأدوار يُتحقق منها مقابل قاعدة البيانات في كل طلب، فيسري أي تغيير فورًا.

هذه القواعد دوال خالصة في src/lib/pricing.ts وsrc/lib/rules.ts وsrc/lib/filters.ts وsrc/lib/permissions.ts، ويختبرها npm test.

تعديل المخطط

عدّل prisma/schema.prisma ثم شغّل npx prisma db push (يطبّق التغيير ويعيد توليد العميل). ولفريق عمل أو متجر قائم على PostgreSQL قد تفضّل الترحيلات: npx prisma migrate dev --name what-changed.