التهيئة (Provision)

الهدف: أن يُنهي المدير التهيئة الأولى (onboarding) فيجد مدرسة تعمل فعلاً — صفوف، ومواد، وفصول دراسية، وحصص، وقاعات، وشُعب، ومسودّة جدول — كلها مشتقّة من أربع إجابات فقط (الدولة، نوع المدرسة، المرحلة، السعة). وكل ما يُنشئه المهيّئ هنا افتراضي لا نهائي: كل سجل قابل للتعديل من واجهات الإدارة المعتادة.

متى تعمل التهيئة

المسارات الكاملة الثلاثة تلتقي كلها عند repairProvisioning() في src/components/catalog/provision.ts — محرّك تهيئة واحد لا ثلاثة.

ولأن مشغّل التهيئة الأولى يعمل بعد الاستجابة داخل after()، قد يقتله انتهاء مهلة الخادم في منتصف السلسلة. وهذا مقبول عمداً: كل مرحلة قابلة لإعادة التشغيل بأمان (idempotent)، والطبيب يلتقط المراحل الناقصة بالضبط في الاستدعاء التالي.

المراحل

يستدعي repairProvisioning() أولاً getProvisioningStatus() (جولة عدّ واحدة مجمّعة)، ثم يشغّل المراحل الناقصة فقط بترتيب الاعتماديات. فشل مرحلة لا يوقف البقية أبداً — تُجمع الإخفاقات ويُبلَّغ عنها.

المرحلتان 2–3 من اختصاص الفهرس — استنتاج المنهج، وسلسلة المطابقة التدريجية للمواد، وإعدادات البنية الأكاديمية لكل منهج موثّقة في الفهرس. وجانب التهيئة الأولى (أي خطوة في المعالج تغذّي أي حقل) في التهيئة الأولى. هذه الصفحة تملك المراحل 4–6 والطبيب.

خارج الطبيب، يُطلق provisionSchoolDefaults() أيضاً syncStudentGrades() وprovisionSchoolFees() وإشعارات دليل الإعداد؛ ويشغّل publishSchool() إضافةً initializeAccountingSystem() (شجرة الحسابات — فجوة معروفة: المدرسة التي لا تمرّ بمسار النشر اليدوي تبقى بلا حسابات دفترية حتى إعداد المالية).

المرحلة 4 — جدولة مدركة للفصول الدراسية

تعرف مرحلة الجدولة ثلاثة أشياء: دولة المدرسة، وهيكل الجدول المختار (الذي يحمل طابع المنهج)، وتاريخ اليوم. ومنها تشتق السنة الدراسية، وعدد الفصول الدراسية، وحدود كل فصل، وأي فصل نشط الآن.

التقويمات الأكاديمية

ACADEMIC_CALENDARS في src/components/school-dashboard/timetable/calendars.ts يربط رموز الدول بأنماط الفصول الافتراضية (مدقّقة وفق تقاويم الوزارات 2025–26؛ وكل التواريخ قابلة للتعديل لاحقاً من المدرسة ← الإعدادات ← الأكاديمية):

ملاحظات مضمّنة في البيانات:

• السعودية عادت إلى فصلين دراسيين في العام 1447هـ (2025–26) — نظام الفصول الثلاثة (2021) انتهى.
• افتراضات السودان تقريبية لما قبل الحرب (ثقة منخفضة) — تحتاج تأكيداً يدوياً مع المدرسة.
• الهند (CBSE) هي الوحيدة بسنة تبدأ في أبريل؛ computeTermDates() يعالج التفاف السنة الميلادية.

سلسلة الحسم

resolveAcademicCalendar(country, structureSlug)
  1. تجاوز من الهيكل      — مثلاً sd-british ← تقويم GB (مدرسة بريطانية في
                            السودان تتبع فصول المملكة المتحدة لا السودانية)
  2. مطابقة الدولة تماماً — SD, SA, AE, …
  3. احتياطي إقليمي       — SA/AE/QA/KW/BH/OM ← GULF · EG/JO/LB/TN/MA/DZ ← MENA
  4. الافتراضي (*)        — سبتمبر–يونيو، فصلان

ثم يثبّت computeTermDates(calendar, now) النمط على تواريخ حقيقية: يختار سنة الأساس من now مقابل yearStartMonth، ويلفّ الأشهر الواقعة قبل بداية السنة إلى السنة الميلادية التالية، ويسمّي السنة (2026/2027)، ويعلّم فصلاً واحداً بالضبط نشطاً — الفصل الذي يحوي اليوم، أو الفصل القادم بين الفصول.

ما تكتبه المرحلة

نفس منطق التقويم يدعم التهيئة الاحتياطية في resolveActiveTerm() داخل src/lib/term-resolver.ts، فالمدرسة التي تصل إلى الجدول بلا فصول دراسية تحصل على الطقم الكامل الصحيح للدولة، لا على فصل واحد مؤقت.

هياكل الجدول (~23 هيكلاً لتوزيع الحصص الأسبوعي حسب الدولة ونوع المدرسة) ونظام ترشيحها موثّقة في تدفق التكامل.

المرحلة 5 — القاعات والشُعب

خطوة السعة في التهيئة الأولى تضبط School.sectionsPerGrade (افتراضي 2) وSchool.studentsPerSection (افتراضي 30). لكل AcademicGrade يُنشئ المهيّئ N قاعة رئيسية و N شعبة، مقترنتين واحدة-بواحدة:

الصف 7  ←  قاعة "Grade 7-A" (سعة 30، gradeId)  ↔  شعبة "Grade 7-A" (حرف A)
           قاعة "Grade 7-B" (سعة 30، gradeId)  ↔  شعبة "Grade 7-B" (حرف B)

هذا يرسّخ السلسلة التي تعتمد عليها بقية المنصة: القاعة الرئيسية ملك لصف، ومنهج الصف يحدد المواد التي تُدرَّس في تلك القاعة، والشعبة هي مجموعة الطلاب التي تسكنها. فمعرفة القاعة تعني معرفة صفها وموادها و(بعد المرحلة 6) جدولها الأسبوعي. الاقتران واحد-بواحد بحكم التصميم — Section.classroomId مفتاح مفرد، فلكل شعبة قاعة رئيسية واحدة فقط، ونوع الغرفة يحكم (القاعة الرئيسية من نوع classroom). راجع القاعات › التكامل.

المختبرات والمساحات المشتركة شيء آخر عمداً — ليست مملوكة لصف ولا تكون أبداً قاعة رئيسية لشعبة، فتُنشأ يدوياً من القوائم ← القاعات بنوع ClassroomType خاص بها (مختبر، حاسوب، مكتبة…) ويُوصَل إليها لكل حصة عبر الجدول، ويستطيع المولّد توجيه المواد المعلَّمة كمختبرات إليها.

عمليات الإدراج مفتاحها (schoolId, roomName) و(schoolId, gradeId, letter) — إعادة التشغيل لا تكرّر شيئاً أبداً.

المرحلة 6 — توليد الجدول

بوجود الصفوف والمواد والشُعب والحصص والفصول الدراسية، يشتق الجدول نفسه:

لكل شعبة (Grade N-X):
  المواد   = صفوف SubjectSelection للصف N (لكلٍ weeklyPeriods)
  القاعة   = القاعة المقترنة بالشعبة
  الشبكة   = أيام الدوام × الحصص التدريسية (بلا استراحات/غداء)
  ← وزّع المواد على الشبكة ← حصص Timetable

تُكتب الحصص مبنية على الشُعب — sectionId + subjectId + classroomId مع teacherId: null. لا يشترط وجود معلمين لتعليق الجدول على الحائط؛ يُسندون لاحقاً (خبرة لكل مادة، ثم لكل حصة). والكتابة عبر createMany({ skipDuplicates: true }) على قيد الفرادة المستوى-شعبة، فإعادة التوليد آمنة.

هذا الترتيب هو جوهر السلسلة كلها:

الجدول موجود (بلا معلمين)
  ← ضع الطلاب في الشُعب          (تنسيب القبول ← Student.sectionId)
  ← أسند المعلمين إلى المواد/الحصص (TeacherSubjectExpertise ← slot.teacherId)
  ← الحضور والاختبارات والتقارير تتدفق من هناك

لا شيء في الأسفل ينتظر "اكتمال" ما فوقه — تستطيع المدرسة تشغيل جدول يراه الطلاب قبل إسناد معلم واحد.

مسودّة الجدول الاحتياطية

إذا وصلت مدرسة إلى صفحة الجدول بلا فصول دراسية إطلاقاً (لم يُختر هيكل، أو ضاعت التهيئة)، فالشبكة لا تكتب شيئاً عند القراءة. تعرض جدولاً مركّباً من هيكل المدرسة (buildDraftSchedule()) مع شريط تنبيه وزرّ "Set up timetable" للمدير يشغّل مسار التهيئة الحقيقي.

طبيب التهيئة

getProvisioningStatus(schoolId) فحص صحي للقراءة فقط — جولة عدّ مجمّعة واحدة عبر كل مرحلة، آمن من لوحات المشغّل:

Copyconst status = await getProvisioningStatus(schoolId)
// status.counts   — yearLevels, departments, scoreRanges, academicLevels,
//                   academicGrades, subjectSelections, periods, terms,
//                   weekConfigs, classroomTypes, sections, timetableSlots, …
// status.missing  — مثلاً ["schedule", "timetable"]
// status.healthy  — missing.length === 0

قواعد "الناقص" الجديرة بالمعرفة:

• schedule وtimetable لا يُعلَّمان إلا إذا كان School.timetableStructure مضبوطاً — المدرسة التي لم تختر هيكلاً ليست "معطوبة"، بل قبل-الجدولة.
• schedule يُعلَّم أيضاً عند غياب SchoolWeekConfig (لا الحصص/الفصول فقط).
• sections يُعلَّم عندما تكون الشُعب أو صفوف ClassroomType صفراً.
• هيكل بمعرّف مجهول يُفشل المرحلة بصوت عالٍ الآن (يهبط في failed[]) بدل تعليمها مُصلَحة بصمت.
• academicStreams وكتب المكتبة تُذكر في العدّ لكن لا تُعلَّم ناقصة أبداً — المسارات توجد فقط في المناهج التي تعرّفها، وتبنّي الكتب قرار مدرسي من منتقي المكتبة.

يشغّل repairProvisioning(schoolId) المراحل الناقصة بعزل أخطاء لكل مرحلة، ويعيد { repaired, failed, healthy, status }، واستدعاؤه على مدرسة سليمة آمن (لا-عملية).

سياسة classId القديم

تتقارب المنصة نحو الشعبة كوحدة التشغيل:

يبقى Timetable.classId على الصفوف القديمة للتاريخ؛ وتحرير مثل هذه الحصة يملأ sectionId/subjectId فيُرحّلها في مكانها. لا تُنشأ بيانات جدول جديدة مبنية على classId.

أنماط الفشل

فحص الجاهزية

Copyconst ready =
  levels > 0 &&
  grades > 0 &&
  selections > 0 &&
  classrooms > 0 &&
  periods > 0 &&
  terms > 0 &&
  weekConfig !== null
// المعلمون ليسوا شرطاً عمداً — الجدول يُهيّأ بلا معلمين

انظر أيضاً

• تدفق التكامل — خريطة الطبقات الكاملة التي يقلعها هذا الخط
• الفهرس — استنتاج المنهج، واحتياطي المواد، وإعدادات البنية لكل منهج
• التهيئة الأولى — أي خطوة في المعالج تغذّي أي مدخل تهيئة
• الجدول الدراسي — الميزة التي يهبط فيها خط التهيئة