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 وإلى نموذج اللوحة.