قارئ الإشعارات الحكوميةGovernment notice reader

B28التكاملاتمتطلب وارد في الملفات

بدل الدخول إلى ناجز بكلمة مرور المحامي (ممنوع)، يقرأ النظام الإشعارات التي تصل المكتب أصلًا (بريد، رسائل نصية يمررها المحامي أو يلصقها)، ويستخرج نوعها ورقم القضية، ويربطها بالملف، ويقترح إجراءً مبدئيًا يؤكده الإنسان.

بطاقة الميزة

البند	القيمة
1. اسم الميزة	قارئ الإشعارات الحكومية — Government notice reader
2. المعرّف (Feature ID)	`B28`
3. مصدر المتطلب	الوثيقة المعمارية: قارئ الإشعارات، تقييم القرارات الهندسية: العمل عبر الإدخال المنظم وقارئ الإشعارات
4. تصنيف المحتوى	متطلب وارد في الملفات لا دخول للبوابات، صندوق بريد وتمرير الرسائل، قوالب لكل جهة، نموذج احتياطي بعد التنقيح، الربط بالقضية، الإجراءات، منع التكرار، مبدئي حتى التأكيد.
الوحدة	التكاملات
الأدوار المعنية	محامٍ، سكرتارية
درجة الخطورة	عالية
حالة الاعتماد	معتمد في الوثائق
المنصات المرتبطة	ناجز وناجز للمطورين، تراضي — المصالحة، مزود الرسائل النصية المحلي

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

حتى يوافق الربط الرسمي مع ناجز، الإشعارات هي المصدر الأسرع للمواعيد والأحكام (التقييم الهندسي).

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

الإشعار ليس تبليغًا رسميًا بالضرورة؛ ما يُستخرج منه مبدئي حتى يتحقق المحامي من المصدر الرسمي.

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

المحامي يمرر أو يلصق. السكرتارية تفرز غير المربوط.

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

صندوق بريد مخصص للمكتب. نقطة استقبال سرية للرسائل الممررة. قوالب الجهات من عينات (الوثيقة المعمارية).

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

وصول بريد أو رسالة ممررة أو نص ملصوق ← Inbound Notice.
مطابقة قالب الجهة (ناجز، تراضي…) واستخراج الحقول.
إن فشل القالب: نموذج احتياطي بعد تنقيح الأسماء (الوثيقة المعمارية).
الربط: برقم القضية ← بالمحكمة والأسماء ← فرز يدوي.
الإجراء المقترح: جلسة ← جلسة مبدئية مع فحص تداخل؛ حكم ← مهلة مبدئية؛ تراضي ← موعد.
التأكيد البشري يحول المبدئي إلى رسمي.

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

مكرر: يُتجاهل بالمعرف أو بصمة النص. غير مربوط: في لوحة يومية (الوثيقة المعمارية).

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

الاسم العربي	الاسم البرمجي	النوع	إلزامي	التحقق	القيمة الافتراضية	مصدر البيانات
القناة	`channel`	Select	نعم	بريد / رسالة ممررة / لصق	—	(الوثيقة المعمارية)
النص الخام	`raw_text`	Long Text	نعم	—	—	الوارد
الجهة	`entity`	Select	تلقائي	—	—	القالب
النوع	`notice_kind`	Select	تلقائي	جلسة / حكم / طلب / موعد / أخرى	—	القالب
رقم القضية	`case_number`	Data	تلقائي	—	—	الاستخراج
الملف المرتبط	`legal_matter`	Link	تلقائي/يدوي	—	—	الربط
الحالة	`status`	Select	تلقائي	جديد / مربوط / مبدئي / مؤكد / متجاهل	جديد	—
البصمة	`dedupe_hash`	Data	تلقائي	—	—	الخادم

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

جلسات ومهل مبدئية بشارة «من إشعار — يحتاج تأكيدًا». لوحة غير المربوط.

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

قواعد

RULE B28.1  never log into government portals; never store lawyer credentials
RULE B28.2  created hearing/deadline status "مبدئي" until human confirm
RULE B28.3  dedupe by message id or hash(normalized text)
RULE B28.4  LLM fallback only on redacted text

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

جديد ← مربوط ← مبدئي ← مؤكد؛ أو متجاهل.

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

Inbound Notice n → 1 Legal Matter؛ ينشئ Hearing أو Legal Deadline مبدئيًا.

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

Inbound Notice، Notice Template (entity, pattern, field_map) اقتراح هندسي.

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

صندوق الإشعارات بفرز، وزر «تأكيد» يحول المبدئي.

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

legal_erp.notices.ingest، match_template، link، propose_action.

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

`POST /api/method/legal_erp.api.v1.notices.ingest_sms`

استقبال رسالة ممررة.

الصلاحية: رمز سري لكل مكتب يُدار في الخزنة، يُرسل في ترويسة.

JSON · الطلب

{
  "from": "+966500000001",
  "text": "[نص إشعار اصطناعي للاختبار]",
  "received_at": "2026-11-04T07:10:00+03:00"
}

JSON · الاستجابة

{
  "notice": "IN-0301",
  "status": "جديد"
}

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

جلب البريد كل بضع دقائق افتراض تنفيذي. لوحة يومية لغير المربوط.

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

ناجز وناجز للمطورين وتراضي — المصالحة ومزود الرسائل النصية المحلي مصادر نصية فقط.

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

الإشعارات تحوي بيانات قضايا: تشفير وصلاحيات الملف بعد الربط.

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

المعرّف	النوع	السيناريو	النتيجة المتوقعة
`B28-T01`	طبيعي	إشعار جلسة برقم قضية معروف	جلسة مبدئية مربوطة.
`B28-T02`	حدّي	الإشعار نفسه مرتين	مرة واحدة.
`B28-T03`	سلبي	إشعار بلا رقم	فرز يدوي.

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

لا دخول للبوابات.
كل مستخرج مبدئي حتى التأكيد.

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

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

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

عينات إشعارات حقيقية لكل جهة (منقحة) لبناء القوالب.