- مقدمة
- العرض
- MVP
- خارطة الطريق
- متطلبات المنتج
- ابدأ الآن
- البيئة المحلية
- البنية المعمارية
- الهيكل
- الأنماط
- الحزمة التقنية
- قاعدة البيانات
- تعدّد المستأجرين
- الفهرس (Catalog)
- العمل دون اتصال
- المصادقة
- التهيئة (Onboarding)
- تدفق التكامل (Integration Flow)
- التهيئة (Provision)
- القبول
- الحضور
- الامتثال التنظيمي
- الملف الشخصي
- الاجتماعات
- إدارة الرسوم
- الفاتورة
- التدويل
- الترجمة
- دليل الترجمة
- أمان قاعدة البيانات
- المساهمة
- هَوْغوارتس
- عرض حي
- الإلهام
المبيعات والانتشار
تُسجِّل وثيقة MVP ما هو مشحون اليوم عبر 14 ملحمة. خارطة الطريق هذه تُسجِّل ما هو قادم. المواضيع هنا مرتبطة بفروع وقضايا ومراجعات حقيقية قيد التنفيذ — وليست قائمة أمنيات. التاريخ المرجعي: 2026-05-10.
للمتطلبات والقيود راجع PRD. للتوجه التجاري راجع Business model.
نظرة فصلية
| الفصل | الموضوع | المخرجات الرئيسية |
|---|---|---|
| Q2 2026 (الآن) | إعادة تنظيم المالية + إنزال النقل | إنزال P0 لمظلة المدفوعات (#263). شحن التزويد التلقائي للرسوم (#264). استقرار سطوح النقل الجاهزة للإنتاج. تغطية تدقيق الترجمة للصفحات عالية المرور. |
| Q3 2026 | تصليب الامتحانات + UI واعٍ بالأدوار | إغلاق P0/P1 لمراجعة إنتاج بلوك الامتحانات. اكتمال المسح الشامل لـUI واعٍ بالأدوار في لوحة المدرسة. طرح المرحلة 2 من الحضور (مرتكزة على القسم). |
| Q4 2026 | تلميع mobile-web + كتالوج LMS | اكتشاف كتالوج Lumos عبر المدارس. دمج WhatsApp في Messages. التحقق من البنية القائمة على الأقسام من البداية للنهاية. تلميع تدفق إعارة المكتبة. |
| 2027+ | الصحة، تطبيقات أصلية، سوق محتوى | وحدة الصحة (UI عيادة على نموذج Prisma قائم). مسار iOS/Android أصلي إذا ثبت PMF. خطط السوق فقط بعد إشارة تبنّي الكتالوج متعدد المدارس. |
نضج الملاحم
| الملحمة | النضج | ملاحظات |
|---|---|---|
| Onboarding | مُنفَّذ + تحسين | معالج 18 خطوة مباشر؛ تعديلات على النصوص وترتيب الخطوات قيد العمل. |
| Authentication | مُنفَّذ | NextAuth v5، OAuth، 2FA، الدعوات، audit log جميعها في الإنتاج. |
| Multi-tenancy | مُنفَّذ | توجيه نطاق فرعي عبر edge، نطاقات مخصّصة عبر Upstash، إنفاذ schoolId على الخادم. |
| Admission | مُنفَّذ | تقديم عام بـ9 خطوات، متتبع OTP، مراجعة وثائق بـAI، ترتيب جدارة، دفع متعدد البوابات. |
| Application | مُنفَّذ + تحسين | الحفظ التلقائي والاستئناف يعملان؛ تلميع UX على تدفق قبول العرض. |
| Students | مُنفَّذ | معالج 12 خطوة، ملف بـ8 تبويبات، استيراد CSV بالجملة. |
| Teachers | مُنفَّذ | معالج 9 خطوات، خبرات + مؤهلات + سنوات عمل. |
| Classrooms | مُنفَّذ | نموذج مرتكز على القسم في مكانه؛ التحقق من UI بانتظار المرحلة 2. |
| Attendance | مُنفَّذ + تحسين | تم شحن إصلاحات المرحلة 1. المرحلة 2 (الترحيل المرتكز على القسم) قيد التنفيذ. |
| Timetable | مُنفَّذ | منشئ بصري، اكتشاف تعارضات، توليد، قوالب، بدائل. |
| Exams | مُنفَّذ + مراجعة | مراجعة إنتاج قيد التنفيذ — 14 P0 / 22 P1 / 18 P2 عبر البلوك. |
| Fees + Invoice | مُنفَّذ + تحسين | إعادة تنظيم مظلة المدفوعات نشطة (#263)؛ التزويد التلقائي مخطط (#264). |
| Notifications | مُنفَّذ | داخل التطبيق + بريد + push + جسر WhatsApp مع إعادة المحاولة. |
| Lumos / LMS | مُنفَّذ + تحسين | خط أنابيب proposer → approve → catalog مكتمل؛ instructor-switcher ومسارات الرفض مباشرة. |
| Library / Books | مُنفَّذ | تصفح الكتالوج، المساهمة، سجلات الإعارة. |
| Catalog | مُنفَّذ | نمط الجسر + مساهمات المجتمع؛ تم بذر 4 مناهج. |
| Transportation | مُنفَّذ | شُحن في 2026-05 مع إعدادات قابلة للكتابة، سطوح /me + /fees، webhook الصعود بـgeofence. |
| Messages | مُنفَّذ + تحسين | دمج WhatsApp في حوار إعدادات Messages مخطط (#164). |
المبادرات النشطة
هذه التغييرات الهيكلية تُشكِّل الفصلين القادمين. كل واحدة منها مراجعة شاملة أو إعادة هيكلة من البداية للنهاية — وليست تذكرة واحدة.
| المبادرة | الملخص |
|---|---|
| مظلة المدفوعات (#263) | مراجعة مالية شاملة + خارطة طريق مرحلية P0/P1/P2/P3. اليوم Stripe فقط يعمل E2E؛ Tap عبارة عن stub؛ محرك القيد المزدوج بلا مستدعين. راجع Fees. |
| التزويد التلقائي للرسوم (#264) | مزامنة هجينة على غرار catalog/setup.ts بحيث لا ترى المدارس الجديدة صفحة رسوم فارغة أبداً. تحلّ محل نهج سكربت البذر في P0-3 ضمن #263. |
| مراجعة إنتاج بلوك الامتحانات | 14 P0 / 22 P1 / 18 P2 عبر بلوك الامتحانات. أبرز P0: بق التسليم بسبب استخدام User.id كـStudent.id، rate limiter في الذاكرة على serverless، 17 نموذجاً تنقصه lang، تغطية اختبار 0% لـRBAC + الحاسبة. راجع Exams. |
| تدقيق الترجمة | تدقيق منهجي بـPlaywright MCP لصفحات لوحة المدرسة بحثاً عن الإنجليزية المضمَّنة. الإصلاح صفحة بصفحة قبل الانتقال. راجع Translation. |
| المسح الشامل لـUI واعٍ بالأدوار | تقييد الـSidebar / PageNav / Toolbar / إجراءات الصف عبر لوحة المدرسة. القوائم موصولة بـpermissions.ts + UIPermissions؛ المالية + المدرسة + المبيعات معلقة. |
| البنية القائمة على الأقسام | تم النشر وتم ترحيل قاعدة البيانات. تحتاج اختبار Playwright MCP على سطوح الحضور + الجدول المرتكزة على القسم. راجع Attendance. |
| دمج WhatsApp في Messages (#164) | نقل إعدادات WhatsApp إلى حوار إعدادات Messages وجسر الرسائل تلقائياً إلى WhatsApp. |
| النقل الجاهز للإنتاج | شُحن في 2026-05. العمل المتبقي تصليب: دقة geofence أكثر إحكاماً، دقة معاينة الرسوم، نوافذ إشعارات تطبيق ولي الأمر. راجع transportation block. |
ليست على خارطة الطريق (هذا العام)
بعض الأمور تبدو مجاورة لكنها مؤجلة بشكل صريح. ندرجها هنا حتى لا يبدأ المساهمون عملاً تخمينياً.
- إعادة هيكلة تقسيم الكتالوج. تقسيم
catalog/setup.tsإلى تكوينات لكل منهج موقوف حتى تنضم مدرسة غير سعودية. جدول DB واحد كافٍ في الوقت الحالي. - API الموبايل خارج المسارات الحالية. المسارات القائمة (auth + الصعود بـgeofence للنقل) كافية. لا سطح API أوسع موجَّه للموبايل أولاً هذا العام.
- خطط السوق. لا سوق للمعلمين / المحتوى حتى تُشير إشارات تبنّي الكتالوج عبر المدارس إلى طلب حقيقي.
- وحدات السكن والكافيتيريا. ذكر في القاموس فقط؛ بلا schema، بلا UI، بلا قيد على خارطة الطريق.
- تطبيقات iOS / Android أصلية. mobile web يعمل اليوم. مسار React Native لا يُفتح إلا بعد وضوح PMF.
كيف تُتَّخذ القرارات
- المتطلبات: يُعرِّف PRD النطاق وNFRs والقيود. أي عمل جديد يُثبت ملاءمته لها قبل إضافته هنا.
- الحالة المشحونة: MVP هو مصدر الحقيقة لما يعمل اليوم. إذا تعارض مع هذه الوثيقة، يُرجَّح MVP لـ«ما هو موجود» وخارطة الطريق لـ«ما هو قادم».
- التوجه التجاري: Business model يُشكِّل أولوية المبادرات — المالية والقبول تُشحن أولاً لأنها مرتبطة بالإيرادات.
- البنية: Architecture هي وثيقة التصميم القانونية. المبادرات التي تنتهكها (مثل إضعاف عزل multi-tenant، أعمدة ثنائية اللغة، كسر نمط المرآة) تُرفض.
- القضايا قبل الدردشة. كل ما على هذه الصفحة مُتتبَّع أيضاً في GitHub issues. إذا لم يكن لبند خارطة الطريق قضية، فهو مسوّدة ولا يجب التقاطه بعد.
انظر أيضاً
- MVP — الحالة المشحونة عبر 14 ملحمة بشارات نضج
- PRD — متطلبات المنتج، نموذج الأدوار، NFRs، القيود
- Business model — التسعير، الفئات، توقعات ARR
- Architecture — تصميم النظام والأنماط