سجل الوكالات الشرعيةPower of attorney registry

كل ملف يعمل فيه المحامي باسم موكّل يحتاج وكالة سارية تمنحه الصلاحيات المطلوبة. السجل يحفظ رقمها وتاريخها وانتهاءها وصلاحياتها والوكلاء، وينبّه قبل الانتهاء.

بطاقة الميزة

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

المحامي الذي يترافع بوكالة منتهية أو لا تشمل الإقرار أو الصلح يعرّض الموكّل والمكتب للخطر (دليل المطور ص7).

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

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

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

السكرتارية تدخل الوكالة وترفع ملفها. المحامي يراجع ويربطها بالملفات. الشريك يرى تقرير الانتهاءات.

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

B02 الموكّلون والأطراف والعلاقات لأطراف الوكالة (الموكّل والوكلاء).

قائمة الصلاحيات المعيارية B08 مطابقة صلاحيات الوكالة مع الإجراء معتمدة من المحامي.

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

1. إدخال رقم الوكالة وتاريخ إصدارها وانتهائها.
2. تحديد الموكّل (أو الموكّلين) والوكلاء من المحامين.
3. اختيار الصلاحيات من القائمة المعيارية مع نص الصلاحية كما ورد.
4. رفع صورة الوكالة كمستند خاص B13 المستندات والإصدارات والأرشفة والأصول الورقية.
5. ربطها بملف أو أكثر في Matter POA.
6. التنبيه قبل الانتهاء بفترات من الإعداد.

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

وكالة بلا تاريخ انتهاء: الحقل فارغ ويُطلب تأكيد المحامي. فسخ الوكالة: الحالة «مفسوخة» بتاريخ، وتنبيه لكل ملف مرتبط. وكيل غادر المكتب: تنبيه أن الوكالة باسم شخص لم يعد في المكتب. جلب من ناجز: بعد الاعتماد، يُعرض كفرق للمراجعة B45 ربط الملفات بناجز.

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

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

تنبيهات قبل الانتهاء للمحامي المسؤول عن كل ملف مرتبط. تقرير الوكالات المنتهية خلال 30 يومًا افتراض تنفيذي. شارة في الملف: «لا وكالة سارية».

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

RULE B07.1  status = "منتهية" if expires_on and expires_on < today; "مفسوخة" if revoked_on set
RULE B07.2  daily job: notify at offsets from settings (default [assume] 30, 7, 1 days)
RULE B07.3  matter with category "قضية" and no linked active POA -> warning badge (not block)
RULE B07.4  agent user disabled -> notify responsible lawyer of each linked matter
RULE B07.5  data_source == ناجز -> fields read-only; diffs via Sync Diff

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

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

Power of Attorney ↔ Legal Matter عبر Matter POA (متعدد لمتعدد). فهرس على expires_on للمهمة اليومية.

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

• Power of Attorney (دليل المطور ص11)، POA Power (فرعي: power_code, power_text)، Matter POA (فرعي في الملف).

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

نموذج الوكالة مع معاينة الملف المرفق بجانب الحقول. في الملف: قسم «الوكالات» بالحالة والانتهاء.

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

legal_erp.poa.refresh_status يوميًا، وlegal_erp.poa.expiry_notices.

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

GET /api/method/legal_erp.api.v1.poa.for_matter?matter=MAT-2026-00001

الوكالات السارية لملف مع صلاحياتها.

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

{
  "items": [
    {
      "poa": "POA-00009",
      "status": "سارية",
      "expires_on": "2027-03-01",
      "powers": [
        "PLEAD",
        "RECEIVE_JUDGMENT"
      ]
    }
  ]
}

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

يومي: تحديث الحالات وإرسال التنبيهات. لاحقًا: جلب من ناجز بعد الموافقة.

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

منتج «الوكالات متعددة الأطراف وسجل الاستخدام» في ناجز للمطورين في بيئة Staging وقت كتابة الخطة (خطة ناجز ص4) يحتاج تحققًا أو موافقة رسمية. لا يُستخدم قبل موافقة الوزارة.

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

صورة الوكالة خاصة (is_private) وفيها أرقام هويات. لا تُرسل إلى نموذج ذكاء خارج المملكة.

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

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

• تنبيهات الانتهاء تصل.
• الوكالة مربوطة بالملفات.
• لا جلب آلي قبل الموافقة.

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

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

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

فترات التنبيه الافتراضية افتراض تنفيذي؛ هل تكفي وكالة باسم المكتب أم يلزم اسم المحامي؟ يحتاج اعتمادًا قانونيًا.