المساعد القانوني (RAG)Legal assistant (RAG)

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

بطاقة الميزة

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

المحامي يبحث في الأنظمة يدويًا، والنماذج العامة تخترع مواد ومددًا. المساعد يسترجع النص ويشرحه ولا يقدم رأيًا قانونيًا؛ القرار دائمًا للمحامي (دليل المساعد القانوني ص2).

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

الوحدة هي المادة كاملة بفقراتها؛ النص يتغير بالتعديل والإلغاء والتعديل عبر نظام آخر، وأي نص يحكم الوقائع القديمة قرار للمحامي، والمساعد يعرض النص كما كان نافذًا في التاريخ المختار (دليل المساعد القانوني ص5).

نطاق الإصدار الأول: الأنظمة واللوائح فقط؛ الأحكام والمذكرات والصياغة الكاملة وتحليل الوقائع خارجه (دليل المساعد القانوني ص4). دليل المطور أوسع (أحكام، مستندات المكتب، صياغة) (دليل المطور ص22-25): تعارض نطاق C-12، والحسم: v1 أنظمة فقط ثم مدونات أخرى لاحقًا اقتراح هندسي.

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

المحامي والشريك فقط؛ المساعد الإداري لا يرى الصفحة في v1، والموكّل لا يستخدمه أبدًا (دليل المساعد القانوني ص13). المحامي يرى أسئلته فقط، والشريك يرى التقييمات السلبية للمراجعة.

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

خدمة ذكاء داخلية FastAPI غير مكشوفة للإنترنت، Qdrant، خادم نماذج محلي داخل المملكة، نماذج منزّلة مرة ومخزنة محليًا (دليل المساعد القانوني ص7).

موقع «المدوّنة» المركزي بنصوص معتمدة B15 مكتبة الأنظمة واللوائح بإصداراتها.

مجموعة تقييم ذهبية من 100 سؤال يعدها المحامي المستشار (دليل المساعد القانوني ص15).

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

1. السؤال يُقنّع أولًا (أسماء، هويات، جوالات، آيبان ← رموز) ولا يُحفظ خامًا أبدًا (دليل المساعد القانوني ص11).
2. إن وُجد رقم مادة واسم نظام: المسار المباشر يجلب النسخة النافذة ويعرضها فورًا بلا نموذج.
3. وإلا: تطبيع وتوسيع الاختصارات، بحث كثيف ومتناثر (40 لكل منهما)، دمج RRF (30)، إعادة ترتيب (5–8) — مع مرشح التاريخ داخل كل مسار.
4. أعلى درجة تحت العتبة ← امتناع دون استدعاء النموذج.
5. التوليد من المواد المرفقة فقط، كل جملة تنتهي بمعرّف النسخة [V-123].
6. المدقق: كل جملة مستشهد بها، كل معرّف من المسترجع، كل رقم في الإجابة موجود في نص المادة، الاقتباس حرفي؛ وإلا امتناع.
7. العرض: الإجابة وبطاقات المصادر وتقييم المحامي.

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

رقم بلا نظام: قائمة الأنظمة التي فيها المادة. تاريخ أقدم من أقدم نسخة: «لا تتوفر في المدوّنة نسخة أقدم» لا عرض الحالي بصمت (دليل المساعد القانوني ص11). الخدمة متوقفة: «المساعد غير متاح الآن» ولا بديل خارجي أبدًا (دليل المساعد القانوني ص13). أسئلة متتالية: سؤال ومتابعة واحدة فقط في v1.

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

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

شريط ثابت: التنبيه وآخر تحديث للمدونة ورقم الإصدار. بطاقات المواد بزر «نسخ الاستشهاد» بصيغة المذكرة. قائمة «أسئلتي». سجل كل استدعاء بالتكلفة والمستخدم (دليل المطور ص22-25).

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

RULE B29.1  raw question never stored or logged; mask before save & send
RULE B29.2  date filter inside each retrieval path (not after fusion)
RULE B29.3  top rerank score < threshold -> abstain (no LLM call)
RULE B29.4  checker: uncited sentence -> regenerate once then abstain; unknown id -> abstain;
            number not in cited text -> abstain; quote mismatch -> abstain
RULE B29.5  forbidden advice phrases ("ننصح", "الأفضل لموكلك") rejected
RULE B29.6  browser -> Frappe -> AI service (service token); browser never sees service address
RULE B29.7  usage limit per user (e.g. 60/hour) [RG]
RULE B29.8  no external model API; no runtime model download

التفاصيل في استرجاع النصوص النظامية والتحقق من الاستشهاد.

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

شاشة بخمس حالات: مسار مباشر، إجابة، امتناع، انتظار (بعدد الأنظمة الفعلي)، الخدمة متوقفة (دليل المساعد القانوني ص13).

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

ثلاثة أماكن (دليل المساعد القانوني ص10): موقع المدونة (Legal Instrument، Article، Article Version، Amending Instrument، Corpus Release)، فهرس الخدمة (مجموعة Qdrant واحدة، نقطة لكل نسخة معتمدة)، وموقع المكتب (Legal Query).

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

• في موقع المكتب: Legal Query (يحفظ بحسب سياسة الاحتفاظ فقط).
• تعارض C-12: دليل المطور يسمي AI Conversation وAI Message وKnowledge Source في موقع المكتب (دليل المطور ص22-25)؛ نعتمد نموذج دليل RAG للإصدار الأول، وAI Conversation للسكرتير B30 السكرتير الذكي (وكيل خدمة العملاء) اقتراح هندسي.

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

صفحة «المساعد القانوني» في واجهة المحامين: الشريط الثابت، صندوق السؤال مع اختيار الأنظمة والتاريخ (بالهجري)، الإجابة بأرقام استشهاد قابلة للنقر، البطاقات (تحت الإجابة في الجوال)، التقييم، المتابعة الواحدة، قائمة الأسئلة الجانبية (دليل المساعد القانوني ص13). نص التنبيه المقترح يعتمده المستشار يحتاج اعتمادًا قانونيًا.

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

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

POST /api/method/legal_erp.api.v1.ai.ask

سؤال من واجهة المحامي.

الصلاحية: محامٍ أو شريك؛ حد الاستخدام.

{
  "question": "ما مدة الاعتراض على الحكم في المسائل المستعجلة؟",
  "as_of_date": "2026-11-04",
  "laws": []
}

{
  "outcome": "answer",
  "answer": "[إجابة قصيرة] [V-…]",
  "citations": [
    {
      "law": "نظام المرافعات الشرعية",
      "ref": "…",
      "version": "V-…"
    }
  ],
  "corpus_release": "R-…",
  "disclaimer": "المساعد يعرض نصوص الأنظمة ويشرحها، ولا يقدم رأياً قانونياً."
}

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

شهري: فحص التعديلات وتحديث المدونة وإعادة الفهرسة (دليل المساعد القانوني ص9). أسبوعي: مراجعة التقييمات «غير دقيق» وتحويل كل خطأ مؤكد إلى سؤال تقييم.

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

هيئة الخبراء — منصة الأنظمة مصدر النص الوحيد يدويًا. استضافة نماذج الذكاء داخل المملكة استضافة النماذج داخل المملكة.

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

لا بيانات مكتب في الخدمة (عديمة الحالة). لا نص خام. السؤال بيانات لا أوامر (مقاومة حقن التعليمات) اختبارات الذكاء وحقن التعليمات والعزل.

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

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

• مقاييس مقترحة في الدليل يعتمدها المستشار كتابيًا قبل البدء (دليل المساعد القانوني ص15): المادة الصحيحة ضمن أول 5 ≥ 90%، دقة الاستشهاد ≥ 95%، امتناع صحيح ≥ 19 من 20، امتناع زائد ≤ 15%، أخطاء أرقام = 0، المسار المباشر 100%. هذه أهداف لا نتائج مقاسة غير مثبت.
• تقرير قبول بإصدار المدونة واسم النموذج.
• لا اتصال خارجي، ولا نص خام في أي سجل.

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

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

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

• النموذج ومكانه (OD-05): ALLaM-7B مضغوط مرشح أول في دليل RAG، وتقييم القرارات يشكك في قدرته على صيغة الاستشهاد ويؤجل الميزة للمرحلة 4 بنموذج أكبر (التقييم الهندسي).
• تقدير 15–20 يومًا في دليل RAG مقابل 8–10 أسابيع في تقييم القرارات (التعارض C-12).
• قائمة الأنظمة الأولى (8–12) ونص التنبيه يحتاج اعتمادًا قانونيًا.