كيف تقرأ هذا التوثيقHow to read this documentation
دليل سريع للمطور: من أين يبدأ، وماذا تعني العلامات، وكيف تُقرأ صفحة الميزة ذات الستة والعشرين بندًا.
ترتيب القراءة المقترح
- معمارية النظام ثم تعدد المكاتب والعزل.
- معجم المجال القانوني والمنظومة القضائية للمطور إن لم تكن تعرف المحاكم السعودية.
- B01 المستخدمون والأدوار والصلاحيات وB03 ملف العمل القانوني: الصلاحيات والملف هما أساس كل شيء.
- B12 محرك المهل النظامية وحاسبة الاعتراض وخوارزمية حساب المهل النظامية: أخطر ميزة.
- خطة الاختبار قبل أول Commit.
- القرارات المعلقة والمخاطر لتعرف ما لم يُحسم.
العلامات
| العلامة | ماذا تفعل حين تراها |
|---|---|
| متطلب وارد في الملفات | نفّذ كما هو. المصدر بجانبه. |
| اقتراح هندسي | اقتراح التوثيق؛ يمكن تغييره بقرار تقني مسجل. |
| افتراض تنفيذي | افتراض ليكتمل التصميم؛ تحقّق منه قبل الإنتاج. |
| يحتاج اعتمادًا قانونيًا | ابنِ القيمة إعدادًا قابلًا للتعديل بحالة «غير معتمدة»، ولا تفعّله حتى يعتمده مختص. |
| يحتاج تحققًا أو موافقة رسمية | لا تبنِ الربط الرسمي قبل الموافقة؛ ابنِ المسار اليدوي والواجهة القابلة للتبديل. |
| غير مثبت | لا تعتمد عليه؛ للعلم فقط. |
مراجع المصادر
كل مرجع بين قوسين يفتح سجل المصادر والملفات على الملف المقصود مع رقم الصفحة أو القسم. «DG ص40» = دليل المطور صفحة 40 من ملف PDF.
صفحة الميزة
البنود 1–4 في بطاقة أعلى الصفحة، ثم 5–26 أقسامًا مرقمة. «لا ينطبق» تعني أن البند مدروس وليس منسيًا. تعريف الاكتمال يضم بنودًا مشتركة لكل الميزات.
كيف يُبنى الموقع
الصفحات مولّدة من ملفات بيانات في _build/data/ بالأمر node _build/build.mjs. التعديل يكون في ملفات البيانات لا في HTML. التفاصيل في README.md.