تقارير الجلسات ومخرجاتهاHearing reports and outcomes
بعد كل جلسة يكتب المحامي ما حدث وقرار المحكمة والمطلوب قبل الجلسة التالية. للتقرير نسختان: داخلية كاملة، ومبسطة للموكّل لا تخرج إلا بعد الاعتماد. النتيجة تولّد تلقائيًا الجلسة التالية والمهام والمهل.
بطاقة الميزة
| البند | القيمة |
|---|---|
| 1. اسم الميزة | تقارير الجلسات ومخرجاتها — Hearing reports and outcomes |
| 2. المعرّف (Feature ID) | B10 |
| 3. مصدر المتطلب | دليل المطور ص37-39 (الميزة 7)، خطة ناجز للمطورين: خدمة محاضر الجلسات |
| 4. تصنيف المحتوى | متطلب وارد في الملفات النتائج الثماني، نسختان داخلية وللموكّل، الاعتماد قبل الإرسال، التصعيد. يحتاج تحققًا أو موافقة رسمية جلب المحضر من ناجز بعد الموافقة. |
| الوحدة | التقاضي والجلسات |
| الأدوار المعنية | محامٍ، شريك، موكّل |
| درجة الخطورة | عالية |
| حالة الاعتماد | معتمد في الوثائق |
| المنصات المرتبطة | ناجز وناجز للمطورين، منصة واتساب للأعمال |
5الهدف التجاري والمشكلة التي تعالجها
الموكّل يريد أن يعرف ماذا حدث، والمكتب يحتاج ألا تضيع المطالب. والنتيجة «صدر حكم» تبدأ أخطر عملية في النظام: المهلة B12 محرك المهل النظامية وحاسبة الاعتراض.
6المجال القانوني المرتبط للمطوّر غير المتخصص
القاضي قد يطلب ردًا أو مستندًا بتاريخ، أو يحيل لخبير، أو يحجز القضية للحكم، أو يشطبها (دليل المطور ص38). النتيجة تُختار من قائمة ثابتة لأن كل قيمة تشغّل إجراءً.
7المستخدمون والأدوار والصلاحيات
المحامي الحاضر يكتب. المسؤول أو الشريك يعتمد. الموكّل يرى النسخة المبسطة المعتمدة فقط.
8شروط البدء والاعتماديات
B09 الجلسات والتقويم المزدوج ومنع التعارض الزمني الجلسة. B44 الإشعارات والتذكيرات قوالب الإرسال. B32 خدمة OCR وتحويل الصوت إلى نص لتحويل الصوت (اختياري).
9السيناريو الأساسي خطوة بخطوة
- بعد انتهاء الجلسة يفتح المحامي نموذج التقرير السريع من الجوال.
- يختار النتيجة ويكتب: الحضور، ما قدمناه، ما قدمه الخصم، قرار المحكمة، الجلسة التالية، المطلوب منا ومن الموكّل، المرفقات.
- أو يسجل ملاحظة صوتية ← نص عربي ← مسودة منظمة يراجعها B32 خدمة OCR وتحويل الصوت إلى نص.
- يكتب ملخص الموكّل بثلاثة أسئلة: ماذا حدث؟ ما الخطوة التالية؟ ما المطلوب منك؟
- الاعتماد ← تشغيل نتائج النتيجة ← إرسال ملخص الموكّل بقناته المفضلة.
10السيناريوهات البديلة والاستثناءات
| النتيجة | ما ينشئه النظام |
|---|---|
| تأجيل | جلسة جديدة بالموعد وتذكيراتها |
| تكليف بمذكرة أو مستند | مهمة مستحقة قبل الجلسة التالية أو في المدة التي حددها القاضي |
| إحالة لخبير | مهمة متابعة |
| حجز للحكم | حالة المرحلة «محجوزة للحكم» |
| صدر حكم | سجل Judgment وطلب تاريخ استلام الصك ثم المهلة B12 محرك المهل النظامية وحاسبة الاعتراض |
| شطب | مهلة طلب السير ومهمة عاجلة |
| صلح | إنهاء المرحلة وطلب محضر الصلح |
| لم تنعقد | سبب وموعد بديل |
المصدر: (دليل المطور ص38).
11المدخلات والحقول
| الاسم العربي | الاسم البرمجي | النوع | إلزامي | التحقق | القيمة الافتراضية | مصدر البيانات |
|---|---|---|---|---|---|---|
| الجلسة | hearing | Link → Hearing | نعم | واحد لكل جلسة | — | B09 الجلسات والتقويم المزدوج ومنع التعارض الزمني |
| النتيجة | outcome | Select | نعم | القيم الثماني | — | (دليل المطور ص38) |
| الحضور | attendees | Small Text | لا | — | — | المحامي |
| ما قدمناه | our_submissions | Text | لا | — | — | المحامي |
| ما قدمه الخصم | opponent_submissions | Text | لا | — | — | المحامي |
| قرار المحكمة | court_decision | Text | نعم | — | — | المحامي |
| ملاحظات داخلية | internal_notes | Text | لا | لا تخرج أبدًا | — | المحامي |
| ملخص الموكّل | client_summary | Text | نعم قبل الإرسال | لا رأي داخلي | — | المحامي |
| الجلسة التالية | next_hearing_at | Datetime | عند التأجيل | > موعد الجلسة | — | المحكمة |
| بنود العمل | action_items | Table → Report Action Item | لا | جهة ومسؤول وتاريخ | — | المحامي |
| ملف المحضر | minutes_file | Attach | لا | — | — | ناجز أو المحامي |
| ملاحظة صوتية | voice_note | Attach | لا | صوت | — | الجوال |
| الحالة | status | Select | تلقائي | مسودة / قيد المراجعة / معتمد / أُرسل | مسودة | سير العمل |
| أُرسل للموكّل في | sent_to_client_at | Datetime | تلقائي | — | — | الخادم |
12المخرجات والإشعارات والسجلات والتقارير
ملخص دوري للموكّل لكل ملفاته. لوحة الشريك: جلسات الأسبوع، جلسات بلا تقارير، القضايا المحجوزة، الأحكام ونتائجها (دليل المطور ص39).
13قواعد العمل بصيغة قابلة للتحويل إلى كود
RULE B10.1 report required within office period after hearing; then reminder; then partner escalation
RULE B10.2 only approved client_summary leaves the system
RULE B10.3 internal_notes never rendered in portal, WhatsApp, email, push (tested per channel)
RULE B10.4 outcome "صدر حكم" without judgment received_on -> open alert; no deadline computed
RULE B10.5 next_hearing_at changed -> update linked reminders and tasks
RULE B10.6 on approve: run outcome handler (table above) inside one transaction; send after commitالمصدر: (دليل المطور ص39).
14حالات السجل وانتقالاتها وشروطها
| من | إلى | من |
|---|---|---|
| مسودة | قيد المراجعة | الكاتب |
| قيد المراجعة | معتمد | المسؤول أو الشريك |
| معتمد | أُرسل | آلي بعد الإرسال |
| قيد المراجعة | مسودة | إرجاع بملاحظة |
15نموذج البيانات والعلاقات والقيود والفهارس
Hearing Report 1 ↔ 1 Hearing. Report Action Item فرعي يُنشئ Task B18 المهام ولوحة المدير وموزّع العمل.
16DocTypes المطلوبة في Frappe
Hearing Report،Report Action Item(description, owner_side عميل/مكتب, assignee, due_date, task) (دليل المطور ص39).
17الشاشات والعناصر والأزرار ورسائل الخطأ
نموذج سريع للجوال بحقول قليلة، وزر تسجيل صوت. معاينة «ما سيراه الموكّل». رسالة: «سجّلت النتيجة صدر حكم. أدخل تاريخ استلام صك الحكم لنحسب المهلة.»
18خدمات Backend ومسؤولية كل خدمة
legal_erp.court.reports.on_approve (معالجات النتائج)، legal_erp.court.reports.escalate_missing يوميًا، legal_erp.ai.transcribe_report B32 خدمة OCR وتحويل الصوت إلى نص.
19واجهات API الداخلية
POST /api/method/legal_erp.api.v1.mobile.submit_hearing_report
حفظ مسودة من الجوال (يعمل دون اتصال عبر الطابور B34 العمل دون اتصال).
الصلاحية: المحامي الحاضر.
{
"hearing": "HRG-0042",
"outcome": "تأجيل",
"court_decision": "تأجيل لتقديم الرد (تجريبي)",
"next_hearing_at": "2026-12-02T10:00:00+03:00",
"client_summary": "أُجلت الجلسة إلى 2 ديسمبر. نحتاج منك عقد العمل الأصلي.",
"client_request_id": "7c1e0f3a-0000-4000-8000-000000000001"
}{
"report": "HR-0042",
"status": "مسودة"
}20الأحداث والمهام الخلفية والجدولة وإعادة المحاولة
يومي: الجلسات المنتهية بلا تقرير ← تذكير ثم تصعيد. بعد الاعتماد: إرسال الملخص عبر القناة في مهمة خلفية بإعادة محاولة B44 الإشعارات والتذكيرات.
21التكاملات المرتبطة بالميزة وحدودها
منتج «خدمة محاضر الجلسات» في ناجز للمطورين (Production) لجلب المحضر وملخصه بعد الموافقة (خطة ناجز ص4) يحتاج تحققًا أو موافقة رسمية. الإرسال عبر منصة واتساب للأعمال بقالب معتمد.
22الأمن والخصوصية والتدقيق والاحتفاظ والحذف
الفصل بين الداخلي والخارجي يُختبر لكل قناة. الصوت يُعالج داخل المملكة حماية البيانات الشخصية والذكاء الاصطناعي.
23حالات الاختبار
| المعرّف | النوع | السيناريو | النتيجة المتوقعة |
|---|---|---|---|
B10-T01 | طبيعي | نتيجة تأجيل مع موعد | جلسة جديدة وتذكيرات (دليل المطور ص39). |
B10-T02 | طبيعي | نتيجة صدر حكم | يُطلب تاريخ الاستلام ثم تُحسب المهلة. |
B10-T03 | سلبي | محاولة إرسال ملخص غير معتمد | يُمنع. |
B10-T04 | أمني | الملاحظات الداخلية في البوابة وواتساب والبريد | لا تظهر في أي قناة. |
B10-T05 | طبيعي | ملاحظة صوتية عربية | مسودة منظمة قابلة للتعديل. |
B10-T06 | حدّي | جلسة مضت عليها المدة بلا تقرير | تظهر في لوحة الشريك. |
B10-T07 | صلاحيات | محامٍ «ب» ليس في فريق الملف يفتح قائمة Hearing Report | لا يظهر سجل الملف، والعدّاد لا يحسبه. |
B10-T08 | صلاحيات | المحامي «ب» يفتح رابط سجل Hearing Report لملف المحامي «أ» مباشرة | رسالة عدم صلاحية، ولا تظهر أي حقول. |
B10-T09 | صلاحيات | المحامي «ب» يبحث في الشريط العلوي بعنوان السجل | لا نتيجة. |
B10-T10 | صلاحيات | مستخدم في قائمة حاجز المعلومات وهو عضو في الفريق | يُرفض الوصول ويُسجَّل. |
24معايير القبول
- معايير القبول الخمسة للميزة 7 في الدليل ناجحة (دليل المطور ص39).
25تعريف الاكتمال (Definition of Done)
- كل قواعد العمل في هذه الصفحة منفذة في الخادم (Controller أو Service)، لا في الواجهة وحدها.
- حالات الاختبار المذكورة هنا مكتوبة اختباراتٍ آلية في إطار اختبار Frappe، وتنجح مع كل دفعة كود.
- اختبارات الصلاحيات تثبت أن مستخدمًا خارج فريق الملف لا يرى السجل في القائمة ولا برابطه المباشر ولا في البحث العام ولا في العدّادات.
- الحقول المخصصة والأدوار ومسارات الاعتماد مُصدَّرة في Fixtures التطبيق، وتظهر بعد تثبيت نظيف على موقع فارغ دون إعداد يدوي.
- لا تعديل في ملفات Frappe أو ERPNext.
- كل قيمة قانونية (مدة، نسبة، مبلغ، قائمة) محفوظة في إعداد قابل للتعديل، وموسومة بحالة اعتمادها.
- نصوص الواجهة ورسائل الخطأ بالعربية، وتخبر المستخدم بما يفعله.
- معايير القبول في هذه الصفحة مُتحقق منها ومسجلة في مصفوفة التتبع.
26القرارات المفتوحة والمخاطر والاعتمادات المطلوبة
مدة كتابة التقرير بعد الجلسة يحددها المكتب.