بوابة الموكّل وتطبيقهClient portal and app

الموكّل يرى ملفاته بحالة مبسطة، وجلساته مع التقارير المعتمدة فقط، ومستنداته المشاركة، وفواتيره ويدفعها، وعقوده ويوقعها، ويحادث المكتب ويحجز.

بطاقة الميزة

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

تقليل «ما الجديد في قضيتي؟» ورفع الشفافية.

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

الموكّل لا يرى الملاحظات الداخلية ولا المسودات ولا قيود الوقت ولا بيانات الأطراف الأخرى B01 المستخدمون والأدوار والصلاحيات.

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

الموكّل (Client Portal User).

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

دخول برمز لمرة واحدة (دليل المطور ص20). B10 تقارير الجلسات ومخرجاتها ملخصات معتمدة.

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

1. الدخول بالجوال وOTP.
2. «ملفاتي»: حالة مبسطة.
3. الجلسات مع ملخصات معتمدة.
4. المستندات المشاركة والرفع «قيد المراجعة».
5. الفواتير والدفع ببوابة محلية.
6. العقود: مراجعة وتوقيع B22 العقود الإلكترونية واتفاقيات الأتعاب والتوقيع.
7. محادثة محفوظة في الملف، وحجز.
8. كشف الأمانة B24 أمانات الموكّلين.

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

موكّل منشأة بعدة مستخدمين: كل مستخدم مربوط بالطرف افتراض تنفيذي.

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

لا حقول إدخال خاصة بهذه الميزة؛ تستخدم حقول الكيانات المشار إليها في نموذج البيانات.

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

إشعارات للموكّل بقنواته.

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

RULE B35.1  portal reads only client_summary, shared documents, invoices, contracts of own matters
RULE B35.2  uploads -> status "قيد المراجعة"

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

لا ينطبق على هذه الميزة.

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

يعيد استخدام الكيانات بصلاحيات البوابة.

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

لا ينطبق على هذه الميزة.

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

ملفاتي، الجلسات، المستندات، الفواتير، العقود، المحادثة، الحجز (دليل المطور ص20).

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

legal_erp.api.v1.portal.*.

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

GET /api/method/legal_erp.api.v1.portal.my_matters

ملفات الموكّل.

الصلاحية: الموكّل.

{
  "items": [
    {
      "matter": "MAT-2026-00001",
      "title": "مطالبة (تجريبي)",
      "status_text": "القضية منظورة، الجلسة القادمة 2 ديسمبر"
    }
  ]
}

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

لا ينطبق على هذه الميزة.

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

بوابة الدفع المحلية. نفاذ — النفاذ الوطني الموحد للدخول لاحقًا بعد الاعتماد يحتاج تحققًا أو موافقة رسمية.

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

اختبار التسرب لكل حقل داخلي.

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

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

• الموكّل يرى ملفاته فقط.

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

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

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

لا ينطبق على هذه الميزة.