schoolos-source-of-truth

> متى تُستعمل: "Use for Qatar MoE regulation, school-decision and related-law questions (HR law 15/2016, PDPPL 13/2016) from SchoolOS's source of truth (md; the PDF is final), and before encoding any

SKILL.md

GitHub

متى تُستعمل: "Use for Qatar MoE regulation, school-decision and related-law questions (HR law 15/2016, PDPPL 13/2016) from SchoolOS's source of truth (md; the PDF is final), and before encoding any regulatory number, deadline or role rule. Trigger on: absence threshold, exam deprivation, 40/60, grievance deadline, violation ladder, ministerial decision, [LEGAL]. استخدمها عند «كم يوم غياب يُحرم الطالب؟»، «مهلة التظلّم كم يوم؟»، «وصل تعميمٌ جديد»، «md يخالف الكود». ليست لـ: تشفير PII (pdppl-pii-audit)، موضع الشيفرة (schoolos-platform)."

مصدر الحقيقة — الجوابُ اللائحيّ بمصدرٍ ونوعٍ وثقة

الغرض: جوابٌ عن لوائح التعليم وقرارات المدرسة والقوانين ذات الصلة يُنسب إلى ملفٍّ ومادّةٍ وصفحة، ويفرّق بين النصّ والقرار والاستنتاج، ويرجع إلى الـPDF قبل أن يصير رقمٌ شيفرةً. المهارةُ إجراءٌ وخريطة؛ المحتوى في الأصول ونسختها لا هنا. المالكُ الأوّل لها «0301 · المستشار: التصنيف والتسمية»، وتقرؤها أيُّ جلسةٍ تريد ترميزَ قاعدةٍ لائحيّة. المصدر: delivery_manager_work/docs/tab_charters.md (ميثاق 0301)، وذاكرة project_goals_advisor.

متى تُستعمل ومتى لا

  • نعم: «كم يوم غياب يُحرم الطالب؟»، «من يقرّر الفصل في المخالفة 4-15؟»، «هل مهلة التظلّم 5 أم 25؟»، «هل هذه السياسة وزاريّة أم مدرسيّة؟»، «وصل تعميمٌ جديد»، مراجعةُ طلبٍ يرمّز عتبةً.
  • لا: سؤالٌ عن بنية نموذج Django أو مكان view (schoolos-platform)؛ فحصُ تشفير حقل (pdppl-pii-audit)؛ صياغةُ مواصفة البطاقة وتسميةُ الجلسة (ميثاق 0301).

الإجراء

  1. حدِّد الموضوعَ والوثيقةَ المرشّحة من الخريطة: references/00-source-map.md (موضوعٌ ⇐ ملفّ md ⇐ مجلّدُ الأصل).
  2. ابحث عن حكمٍ سابق قبل أن تبدأ: findings/ في عدّة التدقيق وسجلُّ التعارضات (references/02-conflicts-and-corrections.md). حكمٌ مؤرَّخٌ بصفحةٍ مقروءةٍ بصريّاً لا يُعاد من الصفر.
  3. اقرأ نسخةَ md من origin/main (git show origin/main:AAdocs/ministry_data/2026_2027/<ملف>) أو من شجرتك بعد مزامنتها — لا من نسخة D:/shschool_mvp العاملة؛ قد تكون على فرعٍ آخر بمحتوى أقدم.
  4. ارجع إلى الأصل وجوباً إن: كان الجوابُ رقماً أو شرطاً سيُرمَّز، أو كان md ملخَّصاً لا حرفيّاً، أو وُجد تعارض، أو لم تجد الموضعَ في md. صيِّر الصفحةَ وانظر إليها (scripts/sot_pdf.py render) — لا تعتمد طبقةَ نصّ الـPDF.
  5. اكتب الجوابَ بالصيغة الثابتة (references/01-answer-format.md): الجواب، المصدر (ملفٌّ ومادّةٌ وصفحةٌ مطبوعة/PDF)، النوع، الثقة، ما لم يُعثر عليه.
  6. إن خالف md الأصلَ أو تعارضت وثيقتان: اتّبع references/02-conflicts-and-corrections.md — تصحيحٌ بتعليقٍ مؤرَّخ، وإبلاغُ المالك، وبطاقةٌ إلى البوّابة إن مسّ عملَ جلسات.
  7. ما سكت عنه النصّ لا تحسمه: اعرض خياراتٍ على المالك واكتب «صامت» في الثقة.

القواعد وأسبابها

  • الـPDF هو الحَكَم، وmd نسخةٌ قد تخطئ. ثبتت أخطاءُ نسخٍ في جداول الدرجات والغياب والصلاحيّات، وقدّر التدقيقُ الأوّل (09-25) أنّ نحو 55% من صفحات الأصول لها في md ملخَّصٌ فقط رغم أنّ index.md يدّعي الحرفيّة؛ وأُضيفت بعده مستخرجاتٌ جديدة، فحالُ كلّ وثيقةٍ تُؤخذ من 01_map.md لا من هذا الرقم. المصدر: project_sot_audit_2026_09_25، findings/05_final_report.md.
  • الحكمُ بالصورة لا بطبقة النصّ: طبقةُ النصّ العربيّة في هذه الملفّات تالفةُ الترتيب والحروف، والأرقامُ فيها سليمةٌ غالباً فتصلح مؤشّراً لا حُكماً. تحقّقتُ منه 2026-09-28 على صفحة 3.4.1.3. المصدر: source_of_truth_work/AGENT_BRIEF.md.
  • اذكر الرقمَين: الصفحةُ المطبوعة غيرُ فهرس الـPDF غالباً (دليل السلوك 2026: PDF = المطبوع + 9). من يفتح الأصلَ برقمٍ خاطئ يقرأ مادّةً أخرى. المصدر: project_goals_advisor.
  • اذكر نوعَ المصدر دائماً: سياسةُ الحضور في مجلّد الأصول مدرسيّةٌ لا وزاريّة، وبعضُ النماذج مدرسيّةٌ داخليّة. خلطُ النوعين يعمّم قراراً محلّيّاً كأنّه نصّ. المصدر: index.md على main (التعارض 4)، ورأس 07e_referral_forms.md.
  • لا تخترع مادّةً ولا رقماً ولا صفحة. «لم أجده» جوابٌ صحيح؛ مادّةٌ مختلَقةٌ تُرمَّز ثمّ تحكم على طالب. مثالٌ حقيقيّ سابق: نسبةٌ نُسبت إلى مادّةٍ في قانون التعليم الإلزامي لا تذكر نسبةً أصلاً. المصدر: docstring tests/test_absence_policy.py على main.
  • لا مراسلةَ لأيّ جهةٍ خارجيّة (الوزارة وغيرها) ولا تسويدَ لها: المنصّةُ جهدٌ شخصيٌّ للمالك، والتنسيقُ مع مدير المدرسة عبر المالك وحده. التعاميمُ الجديدة تُبحث في المصادر الرسميّة المنشورة فقط. المصدر: project_personal_effort_no_external_correspondence.
  • المستشارُ لا يكتب شيفرةَ المنتج ولا يدفع؛ يُخرج جواباً أو تصحيحاً مقترحاً. المصدر: tabs.json (permissions لتبويب 03).
  • لا نسخَ طويلاً ولا بياناتٍ شخصيّة: المستودعُ عامّ؛ اقتباسٌ قصيرٌ بمرجع صفحته يكفي، وما فيه أسماءٌ يبقى في ملفّاتٍ خاصّة. المصدر: AGENT_BRIEF.md (الخصوصيّة).
  • التحليلُ القانونيّ ليس فتوى: ما له وزنٌ قانونيٌّ يُرفع للمالك، وهو نفسُه مسؤولُ حماية البيانات فلا تقل له «راجع الـDPO». المصدر: project_goals_advisor (الميثاق 4)، user_dpo_role.
  • قرارُ المالك يُقدَّم حيث قاله ويُسمّى نوعَه: مثالُه إسقاطُ مؤهّلات المعلّمين للموادّ ولو ذكرتها وثيقة. المصدر: feedback_no_teacher_qualification.

فخاخٌ حقيقيّة

  • خطأ: «عتبة الغياب 6·9·12·16» من ذاكرةٍ قديمة. الصواب: هذا الرقمُ لا وجود له في أيّ أصل؛ النافذُ 5·8·11·15 للصفوف 1–11 وعتبتان للثاني عشر، والحرمانُ عند التجاوز — من الصفحة نفسها لا من الذاكرة.
  • خطأ: الاستدلالُ بجدول الإجراءات اليوميّ («اليوم 5: استدعاء») على شرط الحرمان. الصواب: الجدولُ السرديّ يصف التصعيد، والمادّةُ التعريفيّة تصف الشرط؛ طابِق نصَّ المادّة. المصدر: project_absence_thresholds_confirmed.
  • خطأ: «حدّ مجموع المادة 18 = 25 يوماً» من نسخةٍ قديمة. الصواب: 15 يوماً، مُصحَّحٌ من الـPDF بتعليقٍ مؤرَّخ وموسومٌ في index.md.
  • خطأ: فتحُ D:/shschool_mvp/data/2026-2027/. الصواب: نُقلت الأصولُ إلى AAdocs/ministry_data/2026-2027 PDF/ ومجلّدُها متجاهَلٌ في غيت فلا يوجد في أيّ شجرة عمل؛ وما زالت 54 إشارةً إلى المسار القديم في 35 ملفّاً على main (عددتُها 2026-09-28) — تعليقاتٌ لا تكسر شيئاً.
  • خطأ: «40/60 للكلّ» أو «50/50 لبعض الصفوف» جواباً قاطعاً. الصواب: تعارضٌ مفتوحٌ بين وثيقة 2015 والقرار 14/2018؛ أرجِح بالقرينة واذكرها، والحسمُ للمالك قبل بناء وحدة التوزيع.
  • خطأ: قراءةُ نسختين من دليلٍ واحد كأنّهما واحدة. الصواب: دليلا الرخص (نسختا 2018 و2020) يختلفان في مهلة التظلّم وشروط المنح؛ سمِّ النسخةَ وتاريخَها.
  • خطأ: «الميزان يقول كذا» حُكماً نهائيّاً. الصواب: بوّابةُ الميزان تصرّح بأنّ نصّها ليس رسميّاً والأصلُ الجريدةُ الرسميّة؛ الثقةُ «مؤكَّد قراءةً» والوزنُ القانونيّ للمالك.

المراجع

الملف متى تقرأه
references/00-source-map.md لتعرف أين الأصلُ وأين نسختُه، وأيَّ ملفّ md تفتح لموضوعٍ ما، وأدواتِ التصيير
references/01-answer-format.md قبل كتابة أيّ جواب؛ وقبل ترميز قاعدةٍ في شيفرةٍ أو اختبار؛ ولسؤالٍ قانونيّ (PDPPL، الموارد البشريّة)
references/02-conflicts-and-corrections.md عند تعارضٍ أو خطأ نسخ، أو ملفٍّ أو تعميمٍ جديد، أو سؤالٍ مسّ تعارضاً معروفاً
references/99-test-cases.md عند تعديل المهارة أو الشكّ في تفعيلها
scripts/sot_pdf.py find لاسم الأصل، وinfo للصفحات وإزاحة الترقيم، وrender لتصيير صفحةٍ ثمّ فتحها بـRead