مكتبة الأنظمة واللوائح بإصداراتهاVersioned laws and regulations library

B15المستندات والمعرفةمتطلب وارد في الملفات يحتاج تحققًا أو موافقة رسمية

المعنى الثاني لـ«اللوائح»: الأنظمة واللوائح التنفيذية بنصوص موادها وإصداراتها. القضية قد يحكمها النص النافذ وقت الواقعة، فلا يُحذف نص قديم أبدًا: التعديل يغلق النسخة السابقة ويُنشئ جديدة.

بطاقة الميزة

البند	القيمة
1. اسم الميزة	مكتبة الأنظمة واللوائح بإصداراتها — Versioned laws and regulations library
2. المعرّف (Feature ID)	`B15`
3. مصدر المتطلب	دليل المطور ص44-45 (الميزة 9-ب)، دليل ميزة المساعد (RAG): مصادر المعرفة
4. تصنيف المحتوى	متطلب وارد في الملفات Law وLaw Article وLaw Amendment، قاعدة «النص النافذ في تاريخ»، عدم حذف القديم، محوّل الأرقام بالكلمات، الإدخال اليدوي المراجع. يحتاج تحققًا أو موافقة رسمية الحصول على النصوص من المصدر الرسمي.
الوحدة	المستندات والمعرفة
الأدوار المعنية	شريك، محامٍ، مدير نظام
درجة الخطورة	عالية
حالة الاعتماد	يحتاج اعتمادًا قانونيًا
المنصات المرتبطة	هيئة الخبراء — منصة الأنظمة، تقويم أم القرى والجريدة الرسمية

5الهدف التجاري والمشكلة التي تعالجها

المساعد الذكي والمهل والمذكرات تستشهد بمواد؛ إن كان النص قديمًا أو محرفًا صار الاستشهاد خطأ قانونيًا.

6المجال القانوني المرتبط للمطوّر غير المتخصص

الأنظمة تصدر بمرسوم ملكي أو قرار مجلس الوزراء، ولها تاريخ نشر وتاريخ نفاذ وأحكام انتقالية. مثال من الدليل: نظام المعاملات المدنية نافذ من 16 ديسمبر 2023 وألغى مواد من أنظمة أخرى (دليل المطور ص44). تواريخ النفاذ في الأمثلة تحتاج تحققًا من المصدر الرسمي قبل الإدخال يحتاج تحققًا أو موافقة رسمية.

أرقام المواد تُكتب بالكلمات («السابعة والثمانون بعد المائة») فيُحفظ الرقم 187 والتسمية كما وردت (دليل المطور ص45).

7المستخدمون والأدوار والصلاحيات

مدير المكتبة (محامٍ أو مدير نظام بتفويض) يضيف ويراجع. الجميع يقرأ. المساعد يقرأ بقاعدة التاريخ.

8شروط البدء والاعتماديات

حق الوصول للنص الرسمي: بوابة هيئة الخبراء تمنع الجلب الآلي، فالإدخال يدوي مراجع أو بترخيص بيانات (دليل المطور ص45) هيئة الخبراء — منصة الأنظمة.

9السيناريو الأساسي خطوة بخطوة

المدير يلصق أو يرفع النص الرسمي.
المحلل يقسم بكلمة «المادة» ورقمها (بالكلمات أو الأرقام).
شاشة مراجعة: الأصل بجانب المستخرج لكل مادة.
إدخال بيانات الأداة: الرقم والتاريخ والنشر والنفاذ والأحكام الانتقالية ورابط المصدر.
النشر: إعادة فهرسة المساعد ومراجعة قواعد المهل المرتبطة B12 محرك المهل النظامية وحاسبة الاعتراض.
تنبيه أثر: كل ملف مفتوح أو مسودة تستشهد بمادة تغيرت تُبلّغ المحامي المسؤول (دليل المطور ص45).

10السيناريوهات البديلة والاستثناءات

تعديل مادة: Law Amendment يغلق النسخة (valid_to) وينشئ جديدة تشير لسابقتها. إلغاء نظام: الحالة «ملغى» مع replaced_by. نص لم يُراجع: لا يظهر للمساعد. نص من مصدر غير رسمي: مرفوض.

11المدخلات والحقول

الاسم العربي	الاسم البرمجي	النوع	إلزامي	التحقق	القيمة الافتراضية	مصدر البيانات
عنوان النظام	`title`	Data	نعم	—	—	المصدر الرسمي
نوع النص	`law_kind`	Select	نعم	نظام / لائحة تنفيذية / تعميم / مبدأ قضائي	—	(دليل المطور ص45)
الأداة	`instrument`	Data	نعم	مرسوم أو قرار + رقم + تاريخ	—	المصدر الرسمي
تاريخ النشر / النفاذ	`published_on / effective_on`	Date	نعم	النفاذ ≥ النشر	—	المصدر الرسمي
الحالة	`status`	Select	نعم	نافذ / معدّل / ملغى	نافذ	—
يحل محل / حل محله	`replaces / replaced_by`	Link → Law	لا	—	—	—
رابط المصدر	`source_url`	Data	نعم	نطاق رسمي	—	هيئة الخبراء — منصة الأنظمة
رقم المادة	`article_number`	Int	نعم	> 0	—	المحوّل
تسمية المادة	`article_label`	Data	نعم	كما وردت	—	النص
نص المادة	`text`	Long Text	نعم	—	—	النص
ساري من / إلى	`valid_from / valid_to`	Date	نعم / لا	لا تداخل لنفس المادة	—	الأداة
النسخة السابقة	`previous_version`	Link → Law Article	لا	—	—	التعديل
راجعه	`reviewed_by`	Link → User	شرط النشر	—	—	المراجع

12المخرجات والإشعارات والسجلات والتقارير

صفحة نظام بمواده ونسخها. استعلام «النص النافذ في تاريخ». تنبيهات الأثر.

13قواعد العمل بصيغة قابلة للتحويل إلى كود

قواعد

RULE B15.1  in_force(article, X) = version where valid_from <= X and (valid_to is null or valid_to > X)
RULE B15.2  never delete a version; amendment sets valid_to on previous and creates new
RULE B15.3  publish requires reviewed_by; unreviewed text invisible to assistant
RULE B15.4  ordinal converter words <-> number with unit tests (187 <-> "السابعة والثمانون بعد المائة")
RULE B15.5  on publish: reindex RAG; list Deadline Rules citing the law for review; notify matters citing changed articles

المصدر: (دليل المطور ص45).

14حالات السجل وانتقالاتها وشروطها

مسودة ← قيد المراجعة ← منشور. النظام: نافذ / معدّل / ملغى.

15نموذج البيانات والعلاقات والقيود والفهارس

Law 1 → n Law Article (نسخ متسلسلة)؛ Law Amendment يشير لمواد متأثرة؛ Citation في المستندات يشير لنسخة محددة. فهرس (law, article_number, valid_from).

16DocTypes المطلوبة في Frappe

Law، Law Article، Law Amendment (دليل المطور ص45)، Knowledge Source للمساعد (دليل المساعد القانوني ص7).

17الشاشات والعناصر والأزرار ورسائل الخطأ

صفحة النظام بشريط زمني للتعديلات. اختيار «اعرض النص في تاريخ». شاشة المراجعة المتجاورة.

18خدمات Backend ومسؤولية كل خدمة

legal_erp.library.parse_articles، ordinal.to_number / to_words، library.in_force(article, date)، library.impact_alert.

19واجهات API الداخلية

`GET /api/method/legal_erp.api.v1.library.article_in_force?law=LAW-CPL&number=187&on=2026-11-04`

نص المادة النافذ في تاريخ.

الصلاحية: كل المستخدمين الداخليين.

JSON · الاستجابة

{
  "article": "ART-CPL-187-v1",
  "label": "المادة السابعة والثمانون بعد المائة",
  "valid_from": "—",
  "text": "[نص المادة من المصدر الرسمي بعد إدخاله]"
}

20الأحداث والمهام الخلفية والجدولة وإعادة المحاولة

إعادة الفهرسة بعد النشر في طابور long.

21التكاملات المرتبطة بالميزة وحدودها

هيئة الخبراء — منصة الأنظمة وتقويم أم القرى والجريدة الرسمية: مصادر رسمية، بلا جلب آلي.

22الأمن والخصوصية والتدقيق والاحتفاظ والحذف

المكتبة ليست بيانات شخصية لكنها مصدر ثقة: كل تعديل مسجل بمن راجع.

23حالات الاختبار

المعرّف	النوع	السيناريو	النتيجة المتوقعة
`B15-T01`	وحدة	محوّل 187 ↔ الكلمات	تحويل صحيح في الاتجاهين (دليل المطور ص45).
`B15-T02`	طبيعي	استعلام مادة في تاريخ سابق للتعديل	يعيد النص القديم.
`B15-T03`	طبيعي	تعديل مادة مستشهد بها في ملف مفتوح	تنبيه للمحامي المسؤول.
`B15-T04`	سلبي	نص غير مراجع	لا يظهر للمساعد.

24معايير القبول

معايير الميزة 9-ب ناجحة (دليل المطور ص45).

25تعريف الاكتمال (Definition of Done)

كل قواعد العمل في هذه الصفحة منفذة في الخادم (Controller أو Service)، لا في الواجهة وحدها.
حالات الاختبار المذكورة هنا مكتوبة اختباراتٍ آلية في إطار اختبار Frappe، وتنجح مع كل دفعة كود.
اختبارات الصلاحيات تثبت أن مستخدمًا خارج فريق الملف لا يرى السجل في القائمة ولا برابطه المباشر ولا في البحث العام ولا في العدّادات.
الحقول المخصصة والأدوار ومسارات الاعتماد مُصدَّرة في Fixtures التطبيق، وتظهر بعد تثبيت نظيف على موقع فارغ دون إعداد يدوي.
لا تعديل في ملفات Frappe أو ERPNext.
كل قيمة قانونية (مدة، نسبة، مبلغ، قائمة) محفوظة في إعداد قابل للتعديل، وموسومة بحالة اعتمادها.
نصوص الواجهة ورسائل الخطأ بالعربية، وتخبر المستخدم بما يفعله.
معايير القبول في هذه الصفحة مُتحقق منها ومسجلة في مصفوفة التتبع.

26القرارات المفتوحة والمخاطر والاعتمادات المطلوبة

ترخيص بيانات من الجهة الرسمية أم إدخال يدوي؟ يحتاج تحققًا أو موافقة رسمية. أي الأنظمة أولًا (OD-07).