المحاكم والدوائر والقوائم المرجعيةCourts, circuits and reference lists
قوائم يعتمد عليها كل شيء: المحاكم (نوعها ومدينتها والجهة القضائية)، الدوائر، أنواع القضايا، أطوار الملف، أنواع المستندات. تُدخل مرة، ويعتمدها المحامي، وتُصدَّر في Fixtures.
بطاقة الميزة
| البند | القيمة |
|---|---|
| 1. اسم الميزة | المحاكم والدوائر والقوائم المرجعية — Courts, circuits and reference lists |
| 2. المعرّف (Feature ID) | B05 |
| 3. مصدر المتطلب | دليل المطور ص3، 11، دليل الميزة 1 ص5، 8-9 |
| 4. تصنيف المحتوى | متطلب وارد في الملفات DocTypes المحكمة والدائرة وأنواع القضايا والأطوار. يحتاج اعتمادًا قانونيًا القوائم نفسها يعتمدها المحامي المستشار كتابيًا. |
| الوحدة | التقاضي والجلسات |
| الأدوار المعنية | شريك، مدير نظام |
| درجة الخطورة | متوسطة |
| حالة الاعتماد | يحتاج اعتمادًا قانونيًا |
| المنصات المرتبطة | لا توجد |
5الهدف التجاري والمشكلة التي تعالجها
قائمة خاطئة تجعل القواعد والتقارير خاطئة. نوع المحكمة حقل إلزامي لأن المهل تختلف بحسبه (دليل المطور ص3).
6المجال القانوني المرتبط للمطوّر غير المتخصص
محاكم الدرجة الأولى في القضاء العام: عامة، جزائية، أحوال شخصية، تجارية، عمالية (دليل المطور ص3). ديوان المظالم جهة قضائية مستقلة. الدوائر متخصصة داخل المحكمة. لا نضع قائمة محاكم كاملة من عندنا: تُدخل من مصدر رسمي ويعتمدها المحامي يحتاج اعتمادًا قانونيًا.
7المستخدمون والأدوار والصلاحيات
الشريك ومدير النظام يضيفون ويعطّلون. الجميع يقرأ. لا حذف لقيمة مستخدمة.
8شروط البدء والاعتماديات
اعتماد كتابي من المحامي المستشار لقوائم الأطوار وأنواع القضايا قبل الإطلاق (دليل الميزة 1 ص5).
9السيناريو الأساسي خطوة بخطوة
- المدير يدخل المحكمة: الاسم، النوع، المدينة، الجهة القضائية.
- يضيف دوائرها: الرقم والتخصص.
- يدخل أنواع القضايا ويربط كل نوع بنوع محكمة افتراضي.
- يدخل الأطوار ويحدد المُغلِق منها (
is_closing) (دليل الميزة 1 ص9). - تُصدَّر القوائم المعتمدة في Fixtures لتظهر في كل تثبيت.
10السيناريوهات البديلة والاستثناءات
قيمة لم تعد مستخدمة: تُعطّل (disabled) ولا تُحذف، فتبقى السجلات القديمة صحيحة (دليل الميزة 1 ص9). محكمة جديدة: تُضاف بالشروط نفسها.
11المدخلات والحقول
| الاسم العربي | الاسم البرمجي | النوع | إلزامي | التحقق | القيمة الافتراضية | مصدر البيانات |
|---|---|---|---|---|---|---|
| اسم المحكمة | court_name | Data | نعم | فريد | — | مصدر رسمي |
| نوع المحكمة | court_type | Select | نعم | عامة / جزائية / أحوال شخصية / تجارية / عمالية / استئناف / عليا / تنفيذ / إدارية | — | (دليل المطور ص3) |
| المدينة | city | Data | نعم | — | — | المدير |
| الجهة القضائية | judicial_body | Select | نعم | وزارة العدل / ديوان المظالم | وزارة العدل | (دليل المطور ص11) |
| رقم الدائرة | circuit_no | Data | نعم في الدائرة | فريد داخل المحكمة | — | المدير |
| التخصص | specialization | Data | لا | — | — | المدير |
| اسم النوع/الطور | type_name / stage_name | Data | نعم | فريد | — | (دليل الميزة 1 ص9) |
| الترتيب | sort_order | Int | لا | للعرض فقط | — | (دليل الميزة 1 ص9) |
| طور مُغلِق | is_closing | Check | لا | — | 0 | (دليل الميزة 1 ص9) |
| معطّل | disabled | Check | لا | — | 0 | (دليل الميزة 1 ص9) |
12المخرجات والإشعارات والسجلات والتقارير
قوائم منسدلة في الملف والمرحلة. تقرير «القوائم المعتمدة» بتاريخ الاعتماد ومن اعتمدها.
13قواعد العمل بصيغة قابلة للتحويل إلى كود
RULE B05.1 Link fields filter disabled = 0
RULE B05.2 delete forbidden when referenced; use disabled = 1
RULE B05.3 circuit.court must equal proceeding.court
RULE B05.4 sort_order is display only; never enforces stage order14حالات السجل وانتقالاتها وشروطها
مفعّل / معطّل.
15نموذج البيانات والعلاقات والقيود والفهارس
Court 1 ← n Court Circuit. Matter Type وMatter Stage قوائم مستقلة. فهرس فريد على (court, circuit_no).
16DocTypes المطلوبة في Frappe
Court،Court Circuit(دليل المطور ص11).Matter Type(type_name, default_court_type, disabled)،Matter Stage(stage_name, sort_order, is_closing, disabled) (دليل الميزة 1 ص8-9).Document Kindلأنواع المستندات B13 المستندات والإصدارات والأرشفة والأصول الورقية.
17الشاشات والعناصر والأزرار ورسائل الخطأ
شاشات Desk قياسية بقائمة وتصفية حسب النوع والمدينة. زر «تعطيل» بدل الحذف.
18خدمات Backend ومسؤولية كل خدمة
لا خدمات خاصة؛ Fixtures في hooks.py.
19واجهات API الداخلية
لا توجد واجهة API خاصة بهذه الميزة.
20الأحداث والمهام الخلفية والجدولة وإعادة المحاولة
لا ينطبق على هذه الميزة.
21التكاملات المرتبطة بالميزة وحدودها
قد يعيد ناجز وناجز للمطورين أسماء محاكم بصيغة مختلفة: جدول تحويل Court Alias اقتراح هندسي بدل إنشاء محاكم مكررة.
22الأمن والخصوصية والتدقيق والاحتفاظ والحذف
تعديل القوائم مسجل. القوائم ليست بيانات شخصية.
23حالات الاختبار
| المعرّف | النوع | السيناريو | النتيجة المتوقعة |
|---|---|---|---|
B05-T01 | طبيعي | تعطيل نوع قضية مستخدم | يختفي من الاختيار ويبقى في الملفات القديمة. |
B05-T02 | سلبي | حذف محكمة مستخدمة | يُمنع. |
B05-T03 | سلبي | اختيار دائرة من محكمة أخرى | يُمنع الحفظ. |
B05-T04 | طبيعي | تثبيت نظيف | القوائم المعتمدة موجودة. |
24معايير القبول
- القوائم معتمدة كتابيًا ومصدّرة.
- لا حذف لقيمة مستخدمة.
25تعريف الاكتمال (Definition of Done)
- كل قواعد العمل في هذه الصفحة منفذة في الخادم (Controller أو Service)، لا في الواجهة وحدها.
- حالات الاختبار المذكورة هنا مكتوبة اختباراتٍ آلية في إطار اختبار Frappe، وتنجح مع كل دفعة كود.
- اختبارات الصلاحيات تثبت أن مستخدمًا خارج فريق الملف لا يرى السجل في القائمة ولا برابطه المباشر ولا في البحث العام ولا في العدّادات.
- الحقول المخصصة والأدوار ومسارات الاعتماد مُصدَّرة في Fixtures التطبيق، وتظهر بعد تثبيت نظيف على موقع فارغ دون إعداد يدوي.
- لا تعديل في ملفات Frappe أو ERPNext.
- كل قيمة قانونية (مدة، نسبة، مبلغ، قائمة) محفوظة في إعداد قابل للتعديل، وموسومة بحالة اعتمادها.
- نصوص الواجهة ورسائل الخطأ بالعربية، وتخبر المستخدم بما يفعله.
- معايير القبول في هذه الصفحة مُتحقق منها ومسجلة في مصفوفة التتبع.
26القرارات المفتوحة والمخاطر والاعتمادات المطلوبة
قائمة المحاكم الكاملة ومصدرها الرسمي يحتاج تحققًا أو موافقة رسمية: لم تُدرج في الملفات.