تطبيق المحامي على الجوالLawyer mobile app

المحامي في المحكمة يحتاج: اليوم، الجلسة، تقريرها، الملف، المهل، الوقت، المساعد، مسح المستندات. المرحلة الأولى PWA بواجهة Frappe UI (Vue)، والثانية تطبيق أصلي عند الحاجة لإشعارات iOS والعمل دون اتصال والصوت الطويل والمسح (دليل المطور ص20).

بطاقة الميزة

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

التقرير يُكتب بعد الجلسة مباشرة أو يُنسى.

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

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

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

المحامون والمتدربون.

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

واجهات /api/method/legal_erp.api.v1.mobile.* (دليل المطور ص20).

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

1. الدخول بكلمة مرور وتحقق ثنائي؛ رمز الجهاز في Keychain/Keystore.
2. شاشة «اليوم»: الجلسات والمهل والمهام.
3. الجلسة: أزرار الوقت B19 تسجيل الوقت الفعلي والمتتبع المعلن والتقرير B10 تقارير الجلسات ومخرجاتها.
4. المسح بالكاميرا ← مستند B13 المستندات والإصدارات والأرشفة والأصول الورقية.
5. نسخة مشفرة لأيام قادمة B34 العمل دون اتصال.

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

فقدان الجهاز: المدير يلغي الرمز، والتطبيق يمسح النسخة المحلية عند التشغيل التالي (دليل المطور ص20). إصدار واجهة قديم: الإصدار في المسار يحمي التوافق.

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

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

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

إشعارات بنص عام بلا أسرار.

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

RULE B33.1  REST /api/resource for simple reads; per-screen methods versioned in path (v1)
RULE B33.2  push payload carries no names, case numbers or content (FCM/APNs outside KSA)
RULE B33.3  revoked device token -> wipe local copy on next launch

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

الجهاز: مفعّل / ملغى.

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

Mobile Device (user, platform, token_hash, last_seen, revoked) اقتراح هندسي.

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

• Mobile Device.

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

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

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

legal_erp.api.v1.mobile.*، legal_erp.push.send.

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

GET /api/method/legal_erp.api.v1.mobile.today

شاشة اليوم (انظر B09 الجلسات والتقويم المزدوج ومنع التعارض الزمني).

الصلاحية: المستخدم نفسه.

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

إرسال الإشعارات عبر خدمة الدفع إشعارات الجوال (FCM/APNs).

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

إشعارات الجوال (FCM/APNs): في الاستضافة الذاتية تُبنى خدمة صغيرة إلى FCM/APNs (دليل المطور ص20).

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

لا أسرار في الإشعار. رمز الجهاز قابل للإلغاء.

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

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

• الشاشات الثمانية تعمل.

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

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

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

PWA أولًا أم أصلي (OD-10).