مطابقة صلاحيات الوكالة مع الإجراءPOA powers checker

قبل إجراء حساس (صلح، إقرار، قبض مال، تنازل، طعن) يقارن النظام الإجراء بصلاحيات الوكالات السارية للملف، ويحذّر إن لم يجد صلاحية مطابقة. تحذير لا منع، والقرار للمحامي.

بطاقة الميزة

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

منع خطأ شائع: محامٍ يوقّع صلحًا والوكالة لا تشمل الصلح (دليل المطور ص7).

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

الصلاحيات تُفسَّر من نص الوكالة، وقد تكون عامة أو مقيدة. لا يقرر النظام كفاية الوكالة؛ يقارن رموزًا معيارية أدخلها إنسان يحتاج اعتمادًا قانونيًا.

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

المحامي يرى التحذير ويقرر. الشريك يرى سجل التجاوزات المقبولة.

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

B07 سجل الوكالات الشرعية بصلاحيات مرمّزة. قائمة POA Power Code معتمدة.

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

1. المحامي يبدأ إجراء من قائمة الإجراءات المرمّزة (مثلًا تسجيل صلح B10 تقارير الجلسات ومخرجاتها، اعتماد مذكرة طعن B14 مكتبة المذكرات القديمة وقوالب المذكرات الجديدة، قيد تحصيل B24 أمانات الموكّلين).
2. النظام يجلب الوكالات السارية للملف ويقارن رمز الإجراء.
3. لا مطابقة: نافذة تحذير بالنص «لم نجد في الوكالات السارية صلاحية: [الصلح]».
4. المحامي يتابع مع سبب أو يلغي؛ يُسجل القرار.

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

وكالة عامة مرمّزة GENERAL: تحذير مخفف يطلب التأكد من النص. لا وكالة سارية أصلًا: تحذير أقوى. إجراء غير مرمّز: لا فحص.

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

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

سجل POA Check Log لكل تحذير وقرار.

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

ACTION_POWER_MAP (editable, [legal]):
  RECORD_SETTLEMENT   -> SETTLE
  RECORD_ADMISSION    -> ADMIT
  RECEIVE_FUNDS       -> RECEIVE_MONEY
  WAIVE_CLAIM         -> WAIVE
  FILE_APPEAL         -> APPEAL
RULE B08.1  required = MAP[action]; ok if any active POA of matter has power in {required, GENERAL}
RULE B08.2  not ok -> warn; never block; log decision

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

لا ينطبق على هذه الميزة.

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

POA Power Code (code, label, description)، POA Action Map (action_code, power_code)، POA Check Log (matter, action_code, result, decision, reason, user).

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

• POA Power Code، POA Action Map، POA Check Log اقتراح هندسي.

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

نافذة تحذير بزرّي «متابعة مع السبب» و«إلغاء».

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

legal_erp.poa.check(matter, action_code) يُستدعى من الإجراءات.

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

POST /api/method/legal_erp.api.v1.poa.check

فحص إجراء.

الصلاحية: فريق الملف.

{
  "matter": "MAT-2026-00001",
  "action": "RECORD_SETTLEMENT"
}

{
  "ok": false,
  "missing": "SETTLE",
  "active_poas": 1
}

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

لا ينطبق على هذه الميزة.

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

لا ينطبق على هذه الميزة.

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

السجل غير قابل للتعديل.

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

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

• التحذير لا يمنع.
• كل قرار مسجل بسببه.

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

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

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

الخريطة ورموز الصلاحيات تحتاج اعتماد المحامي المستشار يحتاج اعتمادًا قانونيًا.