توثيق ERPOSالمرجع التنفيذي للمطورين

تقارير الجلسات ومخرجاتهاHearing reports and outcomes

B10التقاضي والجلساتمتطلب وارد في الملفات يحتاج تحققًا أو موافقة رسمية

بعد كل جلسة يكتب المحامي ما حدث وقرار المحكمة والمطلوب قبل الجلسة التالية. للتقرير نسختان: داخلية كاملة، ومبسطة للموكّل لا تخرج إلا بعد الاعتماد. النتيجة تولّد تلقائيًا الجلسة التالية والمهام والمهل.

بطاقة الميزة

البندالقيمة
1. اسم الميزةتقارير الجلسات ومخرجاتها — Hearing reports and outcomes
2. المعرّف (Feature ID)B10
3. مصدر المتطلبدليل المطور ص37-39 (الميزة 7)، خطة ناجز للمطورين: خدمة محاضر الجلسات
4. تصنيف المحتوىمتطلب وارد في الملفات النتائج الثماني، نسختان داخلية وللموكّل، الاعتماد قبل الإرسال، التصعيد. يحتاج تحققًا أو موافقة رسمية جلب المحضر من ناجز بعد الموافقة.
الوحدةالتقاضي والجلسات
الأدوار المعنيةمحامٍ، شريك، موكّل
درجة الخطورةعالية
حالة الاعتمادمعتمد في الوثائق
المنصات المرتبطةناجز وناجز للمطورين، منصة واتساب للأعمال

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

الموكّل يريد أن يعرف ماذا حدث، والمكتب يحتاج ألا تضيع المطالب. والنتيجة «صدر حكم» تبدأ أخطر عملية في النظام: المهلة B12 محرك المهل النظامية وحاسبة الاعتراض.

القاضي قد يطلب ردًا أو مستندًا بتاريخ، أو يحيل لخبير، أو يحجز القضية للحكم، أو يشطبها (دليل المطور ص38). النتيجة تُختار من قائمة ثابتة لأن كل قيمة تشغّل إجراءً.

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

المحامي الحاضر يكتب. المسؤول أو الشريك يعتمد. الموكّل يرى النسخة المبسطة المعتمدة فقط.

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

B09 الجلسات والتقويم المزدوج ومنع التعارض الزمني الجلسة. B44 الإشعارات والتذكيرات قوالب الإرسال. B32 خدمة OCR وتحويل الصوت إلى نص لتحويل الصوت (اختياري).

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

  1. بعد انتهاء الجلسة يفتح المحامي نموذج التقرير السريع من الجوال.
  2. يختار النتيجة ويكتب: الحضور، ما قدمناه، ما قدمه الخصم، قرار المحكمة، الجلسة التالية، المطلوب منا ومن الموكّل، المرفقات.
  3. أو يسجل ملاحظة صوتية ← نص عربي ← مسودة منظمة يراجعها B32 خدمة OCR وتحويل الصوت إلى نص.
  4. يكتب ملخص الموكّل بثلاثة أسئلة: ماذا حدث؟ ما الخطوة التالية؟ ما المطلوب منك؟
  5. الاعتماد ← تشغيل نتائج النتيجة ← إرسال ملخص الموكّل بقناته المفضلة.

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

النتيجةما ينشئه النظام
تأجيلجلسة جديدة بالموعد وتذكيراتها
تكليف بمذكرة أو مستندمهمة مستحقة قبل الجلسة التالية أو في المدة التي حددها القاضي
إحالة لخبيرمهمة متابعة
حجز للحكمحالة المرحلة «محجوزة للحكم»
صدر حكمسجل Judgment وطلب تاريخ استلام الصك ثم المهلة B12 محرك المهل النظامية وحاسبة الاعتراض
شطبمهلة طلب السير ومهمة عاجلة
صلحإنهاء المرحلة وطلب محضر الصلح
لم تنعقدسبب وموعد بديل

المصدر: (دليل المطور ص38).

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

الاسم العربيالاسم البرمجيالنوعإلزاميالتحققالقيمة الافتراضيةمصدر البيانات
الجلسةhearingLink → Hearingنعمواحد لكل جلسة—B09 الجلسات والتقويم المزدوج ومنع التعارض الزمني
النتيجةoutcomeSelectنعمالقيم الثماني—(دليل المطور ص38)
الحضورattendeesSmall Textلا——المحامي
ما قدمناهour_submissionsTextلا——المحامي
ما قدمه الخصمopponent_submissionsTextلا——المحامي
قرار المحكمةcourt_decisionTextنعم——المحامي
ملاحظات داخليةinternal_notesTextلالا تخرج أبدًا—المحامي
ملخص الموكّلclient_summaryTextنعم قبل الإرساللا رأي داخلي—المحامي
الجلسة التاليةnext_hearing_atDatetimeعند التأجيل> موعد الجلسة—المحكمة
بنود العملaction_itemsTable → Report Action Itemلاجهة ومسؤول وتاريخ—المحامي
ملف المحضرminutes_fileAttachلا——ناجز أو المحامي
ملاحظة صوتيةvoice_noteAttachلاصوت—الجوال
الحالةstatusSelectتلقائيمسودة / قيد المراجعة / معتمد / أُرسلمسودةسير العمل
أُرسل للموكّل فيsent_to_client_atDatetimeتلقائي——الخادم

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

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 العمل دون اتصال).

الصلاحية: المحامي الحاضر.

JSON · الطلب
{
  "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"
}
JSON · الاستجابة
{
  "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معايير القبول

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

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

مدة كتابة التقرير بعد الجلسة يحددها المكتب.