المخطط في 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.