المستخدمون والأدوار والصلاحياتUsers, roles and permissions

من يرى ماذا ويفعل ماذا: تسعة أدوار، صلاحيات على مستوى نوع المستند ثم على مستوى السجل (ملفات فريقي)، ثم على مستوى الحقل، مع حاجز المعلومات والتحقق الثنائي. هذه الميزة شرط لكل ما بعدها.

بطاقة الميزة

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

معلومات القضايا سرّ مهني بين المحامي وموكّله؛ محامٍ يرى ملفًا ليس في فريقه خلل أمني، لا تفصيل واجهة (دليل الميزة 1 ص3). والمكتب بوصفه جهة تحكم مسؤول عن ألّا يصل إلى البيانات إلا من يحتاجها (دليل المطور ص14).

المشكلة: أنظمة الملفات المشتركة وجداول Excel لا تفرّق بين محامٍ وآخر، ولا تسجّل من اطّلع.

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

المكتب يمثّل موكّلين قد يكونون خصومًا لموكّلين آخرين بعد سنوات. لذلك لا يكفي أن «يثق» المكتب بموظفيه: يجب أن يثبت النظام أن الوصول كان بقدر الحاجة. وحين يُقبل ملف بشروط بعد فحص تعارض، يُحجب محامٍ بعينه عنه بـحاجز معلومات.

ما يقرره المحامي: من يدخل فريق الملف. ما ينفذه ERPOS: منع الوصول خارج الفريق وتسجيل كل استثناء.

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

المصدر: (دليل المطور ص3، 15) (الوثيقة المعمارية الأدوار والصلاحيات) (دليل الميزة 1 ص14). الأسماء البرمجية اقتراح هندسي: ثابتة بالإنجليزية والعرض بالعربية لأن الكود يعتمد الاسم الإنجليزي (دليل الميزة 1 ص11).

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

موقع Frappe لكل مكتب مع ERPNext والتطبيق المخصص تعدد المكاتب والعزل.

سياسة كلمات المرور والتحقق الثنائي مفعّلة في System Settings قبل إنشاء أول مستخدم.

تعتمد عليها كل الميزات؛ وتعتمد هي على B03 ملف العمل القانوني لقاعدة الفريق.

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

1. مدير النظام ينشئ المستخدم بالبريد والجوال ويختار دورًا واحدًا رئيسيًا أو أكثر.
2. المستخدم يفعّل التحقق الثنائي في أول دخول؛ لا يُسمح بالدخول دونه لموظفي المكتب (دليل المطور ص15).
3. عند إضافة المستخدم إلى team في ملف، يصبح الملف وكل ما تحته (جلسات، مستندات، مهل، ساعات) مرئيًا له تلقائيًا بالوراثة (دليل المطور ص15).
4. كل استعلام قائمة يمر بـ permission_query_conditions، وكل فتح سجل يمر بـ has_permission، والنتيجتان متطابقتان (دليل الميزة 1 ص15).
5. الحقول ذات permlevel الأعلى (أرقام الهويات، مبالغ الأتعاب) لا تظهر إلا للأدوار المخولة (دليل المطور ص15).

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

• ملف محجوب (restricted = 1): لا يراه إلا المسمّون بالاسم. الدخول الاستثنائي يطلب سببًا مكتوبًا، ويُسجّل، ويُشعر المحامي المسؤول (دليل المطور ص15).
• مستخدم في قائمة الحاجز وهو في الفريق: يُرفض في has_permission لأن الحاجز يتقدم على الفريق (الوثيقة المعمارية الأدوار والصلاحيات).
• موظف غادر: يُعطَّل حسابه (لا يُحذف) فتبقى سجلاته باسمه؛ وتُلغى رموز أجهزته في الجوال (دليل المطور ص20).
• فشل الدخول المتكرر: قفل الحساب بعد عدد محاولات في الإعدادات، ومهلة خمول للجلسة (دليل المطور ص15).
• موظف دعم من مزوّد المنصة: لا يدخل إلا بإذن مؤقت من المكتب ينتهي تلقائيًا، ويُسجّل B42 عقود الخدمة ومستوى الخدمة ووصول الدعم.

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

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

• سجل دخول المستخدمين (جاهز في Frappe).
• Matter Access Log: كل اطّلاع على ملف «سري جدًا» أو دخول استثنائي: المستخدم، الملف، السبب، الوقت، العنوان اقتراح هندسي (دليل المطور ص15).
• إشعار فوري للمحامي المسؤول عند كل دخول استثنائي.
• تقرير شهري: الأدوار الممنوحة، الحسابات غير المستخدمة 90 يومًا، الدخولات الاستثنائية.

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

RULE B01.1  # قاعدة "ملفات فريقي"
IF user has role "Managing Partner": allow all matters
ELSE allow matter WHERE user IN matter.team.user
     AND user NOT IN matter.blocked_users
     AND (matter.restricted = 0 OR user IN matter.allowed_users)

RULE B01.2  # الوراثة: كل سجل له حقل matter يأخذ صلاحية ملفه
FOR doctype IN [Case Proceeding, Hearing, Judgment, Legal Deadline, Legal Document,
                Hearing Report, Timesheet(legal_matter), Legal Contract, Trust Movement]:
    allowed(doc) = allowed(doc.matter)

RULE B01.3  permission_query_conditions(user) == has_permission(doc, user) لكل سجل   # اختبار آلي
RULE B01.4  لا دور يحمل "Delete" على Legal Matter أو Legal Party؛ الأرشفة بديل الحذف
RULE B01.5  لا "Share" ولا "Export" لدور Lawyer؛ الوصول الوحيد إضافة إلى الفريق {F1 ص14}
RULE B01.6  System Manager لا يُمنح لمستخدم له دور Lawyer أو Trainee Lawyer
RULE B01.7  أي دالة تجلب سجلات تستخدم frappe.get_list (يحترم الصلاحيات) لا frappe.get_all ولا frappe.db.sql

مصدر القواعد: (دليل الميزة 1 ص14-15) (دليل المطور ص15) (الوثيقة المعمارية الأدوار والصلاحيات). القاعدة 7 هي «أشهر مصدر تسرّب في تطبيقات Frappe» (دليل الميزة 1 ص15).

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

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

الكيانات: User (Frappe)، Role، Has Role، Employee (ERPNext)، وجداول على Legal Matter: team وallowed_users وblocked_users. سجل Matter Access Log جديد اقتراح هندسي.

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

• Matter Access Log (جديد، غير قابل للتعديل والحذف): matter, user, access_type (استثنائي/سري جدًا/تصدير/طباعة/تنزيل), reason, ip, user_agent.
• Custom Fields على Employee: license_no, license_expiry, job_role_legal.
• Custom DocPerm مصدّرة في Fixtures لـ Customer وLegal Party وLegal Matter.

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

• شاشة المستخدم (Desk): الأدوار، الحالة، التحقق الثنائي.
• في الملف: تبويب «الفريق والوصول» يعرض الفريق، وزر «حجب الملف» للشريك، وقائمة الممنوعين.
• نافذة الدخول الاستثنائي: «هذا الملف محجوب. اكتب سبب الدخول، وسيُبلَّغ المحامي المسؤول.» وزر «دخول مسجّل».
• رسائل الخطأ: «ليس لديك صلاحية على هذا الملف. اطلب من المحامي المسؤول إضافتك إلى الفريق.»

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

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

POST /api/method/legal_erp.api.v1.access.request_exceptional_access

طلب دخول استثنائي لملف محجوب أو لست في فريقه (للشريك أو بإذن مسبق).

الصلاحية: مستخدم مفعّل؛ يُرفض لمن في قائمة الحاجز.

{
  "matter": "MAT-2026-00007",
  "reason": "مراجعة طلب الموكّل بعد غياب المحامي المسؤول"
}

{
  "granted": true,
  "expires_at": "2026-11-04T18:00:00+03:00",
  "log": "MAL-000123"
}

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

• يوميًا: إلغاء أذونات الدخول الاستثنائي المنتهية.
• شهريًا: تقرير الحسابات غير المستخدمة والأدوار الحساسة إلى الشريك.

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

دخول الموكّل للبوابة برمز لمرة واحدة، وقد يُضاف التحقق عبر نفاذ — النفاذ الوطني الموحد بعد استكمال إجراءات الربط يحتاج تحققًا أو موافقة رسمية. موظفو المكتب بكلمة مرور وتحقق ثنائي.

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

• التحقق الثنائي إلزامي لكل موظفي المكتب، مهلة خمول، قفل بعد محاولات فاشلة (دليل المطور ص15).
• سجل تعديلات (track_changes) على كل DocType قانوني (دليل المطور ص12).
• لا تُحذف سجلات الدخول والاطلاع؛ تُحفظ مدة سياسة الاحتفاظ B38 الاحتفاظ والإتلاف والتجميد القانوني.
• نقاط التسرب التي تُختبر: البحث العام، عدّادات مساحة العمل، اقتراحات حقول الإشارة، المرفقات العامة (دليل الميزة 1 ص15)، روابط تنزيل الملفات، فهارس البحث الدلالي (تقرير التدقيق (Gemini) AUD-04).

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

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

• اختبار آلي يثبت أن محاميين بدور Lawyer لا يرى أحدهما ملف الآخر لا في القائمة ولا بالرقم (دليل الميزة 1 ص17).
• كل الـ DocTypes التابعة للملف ترث صلاحيته (اختبار لكل نوع).
• لا محامٍ يحمل System Manager.
• التحقق الثنائي مفروض على أدوار المكتب.
• كل دخول استثنائي مسجّل ويصل إشعاره.

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

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

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

• هل يُسمح بدخول الموكّل عبر نفاذ من البداية؟ يتوقف على إجراءات الربط يحتاج تحققًا أو موافقة رسمية (OD-11).
• مدة صلاحية الدخول الاستثنائي الافتراضية افتراض تنفيذي: حتى نهاية اليوم.