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

الجداول في prisma/schema.prisma والعلاقات بينها.

Category 1─* Course *─1 Instructor 0..1─1 StaffUser ─* Message
               │
               ├─* Section 1─* Lesson
               ├─* Quiz 1─* Question          (قد يشير الاختبار إلى القسم الذي يليه)
               ├─* LiveSession
               ├─* Review *─1 Student
               ├─* Thread 1─* Message          (Thread *─1 Student)
               ├─* WishlistItem *─1 Student
               └─* Enrolment *─1 Student
                      ├─* LessonProgress *─1 Lesson
                      ├─* QuizAttempt *─1 Quiz
                      └─0..1 Certificate

Student 1─* Order 1─* OrderItem *─0..1 Course
Student 1─* LessonNote *─1 Lesson
Coupon و Post (*─0..1 Instructor) و Setting (صف واحد)

الجداول

الجدول أهم الحقول
Setting صف واحد (id 1): الأسماء والشعارات النصية والنبذة وبيانات التواصل والعملة وكسورها وtaxPercent وcardEnabled وbankEnabled وبيانات التحويل وacceptingEnrolments وinstructorShare وموقّع الشهادة وinstructorPermissions (قائمة JSON)
StaffUser حسابات اللوحة: role مشرف ADMIN أو مدرّب INSTRUCTOR، وactive، وpasswordHash بخوارزمية scrypt
Instructor الملف العام: الأسماء والمسميات والنبذات وexperience وskills (JSON) والصورة والروابط وuserId لربط حساب اللوحة
Category الرابط والأسماء والأوصاف وcolor (لون مجال أو #hex) والترتيب والظهور
Course الرابط والمجال والمدرّب والعناوين والعناوين الفرعية والأوصاف وما سيتعلّمه والمتطلبات والأسئلة (JSON)، وlevel وlanguage وformat (RECORDED أو LIVE)، وprice وcompareAt بالبيسة، والغلاف، وstatus (DRAFT أو PUBLISHED أو ARCHIVED)، وfeatured وcertificate وpublishedAt
Section الدورة والعنوانان وsort
Lesson الدورة والقسم والعنوانان، وkind (TEXT أو VIDEO)، وvideoUrl، ونصا Markdown، وminutes وpreview وsort
Quiz الدورة والقسم الاختياري والعنوانان وpassMark وrequired وmaxAttempts (صفر = غير محدود)
Question kind (MCQ أو TF)، ونصا السؤال، وoptions بصيغة JSON ‏[{ar, en}]، ورقم الإجابة correct، والشرح
Student حسابات المتعلّمين (منفصلة عن حسابات اللوحة): الاسم والبريد الفريد والهاتف والنبذة
Enrolment فريد لكل متعلّم ودورة؛ source (FREE أو PAID أو ADMIN)، وorderId، وprogress المحفوظ من 0 إلى 100، وlastLessonId، وcompletedAt
LessonProgress فريد لكل تسجيل ودرس، مع completedAt
LessonNote ملاحظة المتعلّم الخاصة على كل درس
QuizAttempt التسجيل والاختبار وanswers بصيغة JSON وscore وpassed
Certificate code فريد، وشهادة واحدة لكل تسجيل، مع صورة للاسم والدورة والمدرّب والساعات وissuedAt
Order code فريد، والمتعلّم، وsubtotal وdiscount وtax وtotal وcouponCode، وpaymentMethod (FREE أو CARD أو BANK)، وstatus (PENDING أو PAID أو FAILED أو CANCELLED أو REFUNDED)، ومرجع «ثواني» paymentRef، وpaidAt
OrderItem الدورة (يبقى عنوانها نصًا لو حُذفت)، وinstructorId، وprice، وnet (المدفوع فعلًا بعد حصة الكوبون)
Coupon code وtype (PERCENT أو FIXED) وvalue وminOrder وexpiresAt وusageLimit وusedCount وactive
WishlistItem الدورات المحفوظة
Review فريد لكل متعلّم ودورة؛ rating وbody وstatus (PENDING أو APPROVED أو HIDDEN) وfeatured وreply
LiveSession الدورة والعنوانان وstartsAt وminutes وmeetingUrl والملاحظات
Thread وMessage محادثات المتعلّم مع المدرّب، وstatus (OPEN أو CLOSED)، وعلامتا «غير مقروء» لكل طرف
Post مقالات المدونة: الرابط والعنوانان والملخصان ونصا Markdown والغلاف والوسوم والكاتب وpublished وreadMinutes

قواعد في الشيفرة لا في قاعدة البيانات

تحمل الوحدات الخالصة في src/lib (يختبرها npm test) القواعد: learning.ts (التقدّم، وتصحيح الاختبارات، والمحاولات، وشروط الشهادة، وترتيب الدروس، وروابط الفيديو)، وpricing.ts (أسطر السلة، والكوبونات، والإجماليات، وتوزيع الخصم، وحصة المدرّب)، وrules.ts (الرموز والروابط ومسار الطلب)، وroles.ts (الصلاحيات)، وfilters.ts (تصفية الكتالوج وتوحيد صيغ الكتابة العربية في البحث).

تعديل المخطط

عدّل prisma/schema.prisma، ثم شغّل npx prisma db push (يحفظ البيانات ويرفض التغييرات الهدّامة) وnpx prisma generate. وأضف الحقل إلى مخطط zod في src/lib/inputs.ts وإلى نموذج اللوحة.