محلل صكوك الأحكام والعقودJudgment deed and contract analyzer
يستخرج من صك الحكم المرفوع: رقم الحكم وتاريخه والمنطوق والنتيجة، ويقترحها على المحامي لتعبئة B11 الأحكام وطرق الاعتراض. ويراجع العقد بقائمة بنود المكتبة ليشير إلى البنود الخطرة أو الناقصة. اقتراح يعتمده المحامي، لا تعبئة صامتة.
بطاقة الميزة
| البند | القيمة |
|---|---|
| 1. اسم الميزة | محلل صكوك الأحكام والعقود — Judgment deed and contract analyzer |
| 2. المعرّف (Feature ID) | B31 |
| 3. مصدر المتطلب | تقييم القرارات الهندسية: المرحلة 4 (تحليل صكوك الأحكام)، الوثيقة المعمارية: وظائف خدمة الذكاء، دليل المطور ص22-25 (مراجعة العقود) |
| 4. تصنيف المحتوى | متطلب وارد في الملفات تحليل الصك ومراجعة العقد (بنود خطرة أو ناقصة) ضمن المرحلة 4. اقتراح هندسي الحقول المستخرجة ومسار المراجعة. |
| الوحدة | الذكاء الاصطناعي |
| الأدوار المعنية | محامٍ، شريك |
| درجة الخطورة | متوسطة |
| حالة الاعتماد | يحتاج اعتمادًا قانونيًا |
| المنصات المرتبطة | استضافة نماذج الذكاء داخل المملكة |
5الهدف التجاري والمشكلة التي تعالجها
نقل بيانات الصك يدويًا مصدر أخطاء، وأهمها تاريخ يبدأ مهلة.
6المجال القانوني المرتبط للمطوّر غير المتخصص
تاريخ استلام الصك ليس في الصك نفسه غالبًا؛ يدخله المحامي B11 الأحكام وطرق الاعتراض. تقييم خطورة بند قرار المحامي يحتاج اعتمادًا قانونيًا.
7المستخدمون والأدوار والصلاحيات
المحامي يرفع ويراجع.
8شروط البدء والاعتماديات
B32 خدمة OCR وتحويل الصوت إلى نص OCR. B22 العقود الإلكترونية واتفاقيات الأتعاب والتوقيع مكتبة البنود. خدمة الذكاء داخل المملكة.
9السيناريو الأساسي خطوة بخطوة
- رفع الصك أو العقد B13 المستندات والإصدارات والأرشفة والأصول الورقية.
- OCR ثم تنقيح الأسماء ثم استخراج منظم.
- مقارنة كل رقم وتاريخ مستخرج بالنص (المدقق نفسه في استرجاع النصوص النظامية والتحقق من الاستشهاد).
- شاشة مقارنة: النص بجانب الحقول المقترحة.
- المحامي يقبل أو يصحح.
10السيناريوهات البديلة والاستثناءات
ثقة منخفضة أو تعارض أرقام: الحقل فارغ مع إشارة إلى الموضع.
11المدخلات والحقول
| الاسم العربي | الاسم البرمجي | النوع | إلزامي | التحقق | القيمة الافتراضية | مصدر البيانات |
|---|---|---|---|---|---|---|
| المستند | document | Link → Legal Document | نعم | — | — | B13 المستندات والإصدارات والأرشفة والأصول الورقية |
| المستخرج | extraction | JSON | تلقائي | — | — | الخدمة |
| الحالة | status | Select | تلقائي | قيد المعالجة / للمراجعة / مقبول / مرفوض | — | — |
12المخرجات والإشعارات والسجلات والتقارير
حقول مقترحة للحكم. قائمة ملاحظات العقد مع البند المرجعي.
13قواعد العمل بصيغة قابلة للتحويل إلى كود
RULE B31.1 every extracted number/date must appear in OCR text, else blank
RULE B31.2 nothing written to Judgment without lawyer acceptance
RULE B31.3 contract review cites library Clause ids; no free legal opinion14حالات السجل وانتقالاتها وشروطها
قيد المعالجة ← للمراجعة ← مقبول / مرفوض.
15نموذج البيانات والعلاقات والقيود والفهارس
Document Analysis اقتراح هندسي.
16DocTypes المطلوبة في Frappe
Document Analysis(document, kind, extraction, status, reviewed_by).
17الشاشات والعناصر والأزرار ورسائل الخطأ
شاشة مقارنة متجاورة.
18خدمات Backend ومسؤولية كل خدمة
/v1/analyze/judgment و/v1/analyze/contract في الخدمة الداخلية.
19واجهات API الداخلية
لا توجد واجهة API خاصة بهذه الميزة.
20الأحداث والمهام الخلفية والجدولة وإعادة المحاولة
طابور long.
21التكاملات المرتبطة بالميزة وحدودها
استضافة نماذج الذكاء داخل المملكة.
22الأمن والخصوصية والتدقيق والاحتفاظ والحذف
التنقيح قبل النموذج والاستعادة بعده (دليل المطور ص16).
23حالات الاختبار
| المعرّف | النوع | السيناريو | النتيجة المتوقعة |
|---|---|---|---|
B31-T01 | طبيعي | صك اصطناعي | رقم وتاريخ صحيحان. |
B31-T02 | أمني | تاريخ مستخرج غير موجود في النص | فارغ. |
24معايير القبول
- لا تعبئة دون قبول.
25تعريف الاكتمال (Definition of Done)
- كل قواعد العمل في هذه الصفحة منفذة في الخادم (Controller أو Service)، لا في الواجهة وحدها.
- حالات الاختبار المذكورة هنا مكتوبة اختباراتٍ آلية في إطار اختبار Frappe، وتنجح مع كل دفعة كود.
- اختبارات الصلاحيات تثبت أن مستخدمًا خارج فريق الملف لا يرى السجل في القائمة ولا برابطه المباشر ولا في البحث العام ولا في العدّادات.
- الحقول المخصصة والأدوار ومسارات الاعتماد مُصدَّرة في Fixtures التطبيق، وتظهر بعد تثبيت نظيف على موقع فارغ دون إعداد يدوي.
- لا تعديل في ملفات Frappe أو ERPNext.
- كل قيمة قانونية (مدة، نسبة، مبلغ، قائمة) محفوظة في إعداد قابل للتعديل، وموسومة بحالة اعتمادها.
- نصوص الواجهة ورسائل الخطأ بالعربية، وتخبر المستخدم بما يفعله.
- معايير القبول في هذه الصفحة مُتحقق منها ومسجلة في مصفوفة التتبع.
26القرارات المفتوحة والمخاطر والاعتمادات المطلوبة
المرحلة 4 بحسب تقييم القرارات (التقييم الهندسي).