ملف العمل القانونيLegal matter registry

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

بطاقة الميزة

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

كل الميزات اللاحقة تتعلق بالملف (دليل الميزة 1 ص1). الميزة إعداد لا خوارزميات، وتُستخدم من اليوم الأول بإدخال قضايا المكتب الشريك (دليل الميزة 1 ص1). التقدير 7–10 أيام عمل (دليل الميزة 1 ص1).

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

الملف أوسع من القضية: استشارة، عقد، صلح، تحكيم، اشتراك سنوي، أو قضية لها مراحل (دليل المطور ص2). الاستشارة لا محكمة فيها ولا صفة موكّل (دليل الميزة 1 ص10).

ما يقرره المحامي: فتح الملف وتصنيفه وإغلاقه بنتيجة. ما ينفذه ERPOS: الترقيم، الصلاحيات، سجل التغيير، منع الحذف. ما لا يصدر إلا من الجهة الرسمية: رقم القيد ونتيجة الحكم.

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

الشريك: كل الملفات، ينشئ، يعيد فتح المغلق، يؤرشف. المحامي: ملفات فريقه، ينشئ ويعدّل. المساعد الإداري: يقرأ ملفات فريقه. أي دور آخر كالمحاسب: لا شيء (دليل الميزة 1 ص14). لا أحد يحذف.

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

B01 المستخدمون والأدوار والصلاحيات وB02 الموكّلون والأطراف والعلاقات، وقوائم B05 المحاكم والدوائر والقوائم المرجعية (نوع القضية، المحكمة، الطور) مُدخلة ومعتمدة من المحامي المستشار كتابيًا (دليل الميزة 1 ص5، 17).

لا بيانات حقيقية قبل توقيع اتفاقية السرية ومعالجة البيانات (دليل الميزة 1 ص5).

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

1. المدير أو المحامي يفتح ملفًا لموكّل: الفئة، النوع، الموكّل، العنوان، تاريخ الفتح (اليوم افتراضيًا).
2. إن كانت الفئة «قضية»: يظهر قسم المحكمة وصفة الموكّل (إلزامية) (دليل الميزة 1 ص11).
3. يضيف الأطراف الأخرى ووكلاءهم من سجل B02 الموكّلون والأطراف والعلاقات.
4. يُضاف المنشئ تلقائيًا إلى الفريق: مسؤولًا إن كان الفريق فارغًا وإلا مساعدًا (دليل الميزة 1 ص12).
5. يُنشأ Project مرتبط 1:1 ويُسجّل الملف قيمة لبُعد «القضية» المحاسبي (الوثيقة المعمارية نموذج البيانات).
6. لا يتحوّل الملف إلى «نشط» دون فحص تعارض معتمد B16 فحص تعارض المصالح (دليل المطور ص32).
7. ينتقل بين الأطوار ويُحفظ تاريخ كل تغيير ومن قام به (دليل الميزة 1 ص1).
8. يُغلق بتاريخ ونتيجة، ثم يؤرشفه الشريك؛ لا حذف أبدًا.

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

• الاستئناف يعيد القضية للمحكمة الأولى: الرجوع بين الأطوار مسموح، والسجل يوثق (دليل الميزة 1 ص13).
• الموكّل يأتي بقضية مرفوعة منذ سنة: لا يُفرض أن تاريخ القيد بعد تاريخ الفتح (دليل الميزة 1 ص13).
• الملف قبل القيد أو استشارة: رقم القضية غير إلزامي (دليل الميزة 1 ص13).
• رقم قضية مكرر في ملف لا يراه المستخدم: يُمنع الحفظ برسالة لا تكشف الملف الآخر (دليل الميزة 1 ص13-14).
• الموكّل يظهر طرفًا مقابلًا (تطابق معرّف): يُمنع؛ أبسط صورة للتعارض (دليل الميزة 1 ص13).
• إعادة فتح ملف مغلق: للشريك وحده، وتعود الحالة «مفتوح» (دليل الميزة 1 ص13).

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

التسمية MAT-.YYYY.-.##### اقتراح هندسي (دليل الميزة 1 يقترح CASE-.YYYY.-.##### (دليل الميزة 1 ص9)؛ غيّرنا البادئة لأن الملف ليس قضية دائمًا). حقل العنوان title، وتتبع التغييرات مفعّل.

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

• قائمة «قضاياي» للمحامي تعرض فريقه فقط دون إعداد إضافي (دليل الميزة 1 ص16).
• مساحة عمل «القضايا»: اختصارات، بطاقات (الملفات المفتوحة، الملفات في طور «صدر حكم ابتدائي»)، ورسما الملفات حسب الطور وحسب المحامي — كلها تحترم الصلاحيات (دليل الميزة 1 ص16).
• سجل التغييرات أسفل النموذج.

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

RULE B03.1  count(team where team_role = "محامٍ مسؤول") == 1               # every save, block
RULE B03.2  team.user unique                                                # every save, block
RULE B03.3  on_create: if team empty -> add creator as "محامٍ مسؤول" else as "محامٍ مساعد"
RULE B03.4  (court, court_case_number) unique across Case Proceedings        # block; message never names the other matter
RULE B03.5  matter_category == "قضية" -> client_role required               # block
RULE B03.6  parties.party unique within matter                              # block
RULE B03.7  any parties[i].party.id_hmac == client.legal_party.id_hmac -> block   # client cannot be opponent
RULE B03.8  id format warning (see B02.3)                                   # warn only
RULE B03.9  stage changed -> stage_changed_on = today                       # auto
RULE B03.10 stage.is_closing -> require closing_date & closing_result; status = "مغلق"
RULE B03.11 closing_date >= opening_date
RULE B03.12 leaving a closing stage (reopen) -> only Managing Partner; status = "مفتوح"
RULE B03.13 status -> "مؤرشف" only Managing Partner and only from "مغلق"
RULE B03.14 no Delete for any role
RULE B03.15 status -> "نشط" requires linked Conflict Check with decision approved   # B16

القواعد 1–14 من (دليل الميزة 1 ص12-13)، والقاعدة 15 من (دليل المطور ص32). القاعدة 4 نُقلت من الملف إلى المرحلة بحسب (تقرير التدقيق (Gemini) AUD-03) اقتراح هندسي. لا تُفرض: ترتيب الأطوار، أن القيد بعد الفتح، إلزامية رقم القضية (دليل الميزة 1 ص13).

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

قائمة الإغلاق: الفواتير مسددة، الأصول الورقية أُعيدت، التقرير الختامي أُرسل؛ بعدها يصبح الملف للقراءة ويبدأ عدّاد مدة الحفظ (دليل المطور ص17).

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

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

• Legal Matter (الرئيسي)، Matter Party وMatter Team Member (جداول فرعية بخيار istable) (دليل الميزة 1 ص9).
• Accounting Dimension باسم «القضية» يشير إلى Legal Matter، إلزامي على حسابات الإيراد ومصروفات القضايا والأمانات (الوثيقة المعمارية المحور الأول).

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

• نموذج الملف من الأعلى: البيانات الأساسية بعمودين، الطور، المحكمة (يختفي في الاستشارات)، الأطراف، الفريق، الملخص (دليل الميزة 1 ص15). يُختبر على هاتف لأن الأعمدة المزدوجة تنطوي.
• القائمة: الأعمدة العنوان واسم الموكّل والطور والمحكمة والحالة؛ المرشحات الطور ونوع القضية والحالة والمحامي المسؤول (دليل الميزة 1 ص11).
• رسائل: «حدّد محاميًا مسؤولًا واحدًا في جدول الفريق» — «رقم القضية مسجّل في ملف آخر؛ راجع الشريك المدير» (دون رقم الملف الآخر أو موكّله) (دليل الميزة 1 ص14).

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

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

GET /api/resource/Legal Matter?fields=["name","title","stage","status"]

قائمة ملفات المستخدم (REST الجاهز في Frappe، يحترم الصلاحيات) (دليل المطور ص19).

الصلاحية: بحسب قاعدة الفريق.

{
  "data": [
    {
      "name": "MAT-2026-00001",
      "title": "مطالبة مستحقات (تجريبي)",
      "stage": "منظورة",
      "status": "نشط"
    }
  ]
}

POST /api/method/legal_erp.api.v1.matters.close

إغلاق الملف بتاريخ ونتيجة.

الصلاحية: المحامي المسؤول أو الشريك.

{
  "matter": "MAT-2026-00001",
  "closing_date": "2026-11-04",
  "closing_result": "صلح"
}

{
  "status": "مغلق"
}

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

لا مهام مجدولة في هذه الميزة. إنشاء Project يجري داخل المعاملة نفسها.

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

بعد B45 ربط الملفات بناجز تصبح الحقول الرسمية (المحكمة، الدائرة، رقم القضية، تاريخ القيد) للقراءة ولا تتغير إلا بقرار في سجل الفروق (خطة ناجز ص9).

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

كل التحقق في الخادم لأن البيانات تأتي لاحقًا من استيراد أو API (دليل الميزة 1 ص12). المرفقات خاصة دائمًا (دليل الميزة 1 ص15). الإغلاق يجعل الملف للقراءة.

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

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

• السيناريوهات السبعة عشر في دليل الميزة 1 ناجحة بحسابات الاختبار الأربعة (دليل الميزة 1 ص16-17).
• الاختبارات الآلية في Git ناجحة.
• قائمة الأطوار وأنواع القضايا معتمدة كتابيًا من المحامي المستشار.
• القضايا التجريبية العشر مُدخلة ومراجعة من الشريك.
• محاميان من المكتب أدخلا ملفًا كاملًا دون مساعدة.

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

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

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

• بادئة الترقيم وطريقة ترقيم المكتب الحالية إن وُجدت تُطلب من الشريك (دليل الميزة 1 ص5).
• الحالة «نشط» مقابل «مفتوح»: دليل الميزة 1 لا يذكر «نشط»؛ أضفناها لربط شرط التعارض (دليل المطور ص32) اقتراح هندسي.