المهام ولوحة المدير وموزّع العملTasks, manager dashboard and work allocator
مهام مرتبطة بالملفات (من التقارير والمهل والطلبات)، ولوحة للمدير تعرض الحمل والمتأخر، وموزّع يقترح ثلاثة مرشحين لكل مهمة بأسباب (التوفر، التخصص، السرعة، الجودة، الاستبعادات بالحواجز والتعارض). يقترح ولا يسند.
بطاقة الميزة
| البند | القيمة |
|---|---|
| 1. اسم الميزة | المهام ولوحة المدير وموزّع العمل — Tasks, manager dashboard and work allocator |
| 2. المعرّف (Feature ID) | B18 |
| 3. مصدر المتطلب | تقييم القرارات الهندسية: طلبات العميل الأول (لوحة المدير لتوزيع المهام)، الوثيقة المعمارية: الموزّع والمؤشرات |
| 4. تصنيف المحتوى | متطلب وارد في الملفات المهام الأساسية ولوحة المدير لتوزيع المهام (طلب العميل الأول). اقتراح هندسي موزّع يقترح أفضل ثلاثة بأسباب، والقرار للمدير. |
| الوحدة | الوقت والتسعير |
| الأدوار المعنية | شريك، محامٍ، متدرب، سكرتارية |
| درجة الخطورة | متوسطة |
| حالة الاعتماد | معتمد في الوثائق |
| المنصات المرتبطة | لا توجد |
5الهدف التجاري والمشكلة التي تعالجها
المدير يوزع العمل يدويًا ولا يرى الحمل الحقيقي ولا المتأخر (التقييم الهندسي).
6المجال القانوني المرتبط للمطوّر غير المتخصص
لا يُسند عمل في ملف لمن عليه حاجز أو تعارض B06 فريق الملف وحواجز المعلومات. المتدرب يعمل تحت مراجعة.
7المستخدمون والأدوار والصلاحيات
المدير يسند. المحامي يرى مهامه. السكرتارية تنشئ مهام إدارية.
8شروط البدء والاعتماديات
B03 ملف العمل القانوني، B06 فريق الملف وحواجز المعلومات، B19 تسجيل الوقت الفعلي والمتتبع المعلن لبيانات السرعة.
9السيناريو الأساسي خطوة بخطوة
- المهمة تنشأ يدويًا أو من بند عمل في تقرير الجلسة أو من مهلة.
- الموزّع يحسب أفضل ثلاثة: يستبعد المحجوبين ثم يرتب بالتوفر (ساعات المهام المفتوحة)، التخصص (أنواع ملفاته)، السرعة والجودة من السجل (الوثيقة المعمارية).
- المدير يختار ويُسجل اختيار المقترح أو غيره.
- متابعة الاستحقاق والتصعيد.
10السيناريوهات البديلة والاستثناءات
لا بيانات كافية: الموزّع يعرض «بيانات غير كافية» ويترك الاختيار. التدوير: عند التساوي يُفضل من لم يُسند إليه مؤخرًا (الوثيقة المعمارية).
11المدخلات والحقول
| الاسم العربي | الاسم البرمجي | النوع | إلزامي | التحقق | القيمة الافتراضية | مصدر البيانات |
|---|---|---|---|---|---|---|
| الملف | legal_matter | Link → Legal Matter | لا | — | — | المصدر |
| الوصف | subject | Data | نعم | — | — | المنشئ |
| المسند إليه | assigned_to | Link → User | نعم | غير محجوب | — | المدير |
| الاستحقاق | exp_end_date | Date | لا | — | — | المصدر |
| المصدر | source_doc | Dynamic Link | لا | — | — | تقرير/مهلة |
| اقتراحات الموزّع | allocator_suggestions | JSON | تلقائي | — | — | الموزّع |
12المخرجات والإشعارات والسجلات والتقارير
لوحة المدير: الحمل لكل شخص، المتأخر، مهل الأسبوع، جلسات بلا تقارير، أيام بلا تقدم في الملفات (الوثيقة المعمارية).
13قواعد العمل بصيغة قابلة للتحويل إلى كود
RULE B18.1 candidates = team-eligible users minus blocked (B06) minus conflicted
RULE B18.2 score = w1*availability + w2*specialization + w3*speed + w4*quality ; weights in settings [eng]
RULE B18.3 show top 3 with reasons; never auto-assign
RULE B18.4 quality/speed indicators advisory only; not linked to pay or discipline [AR]14حالات السجل وانتقالاتها وشروطها
مفتوحة ← قيد العمل ← مكتملة / ملغاة.
15نموذج البيانات والعلاقات والقيود والفهارس
يعيد استخدام Task في ERPNext بحقول مخصصة.
16DocTypes المطلوبة في Frappe
- Custom Fields على
Task: legal_matter, source_doc, allocator_suggestions.Allocator Settingsاقتراح هندسي.
17الشاشات والعناصر والأزرار ورسائل الخطأ
لوحة المدير ببطاقات ورسوم. نافذة الإسناد بالمرشحين الثلاثة وأسبابهم.
18خدمات Backend ومسؤولية كل خدمة
legal_erp.tasks.suggest(task)، legal_erp.dashboard.manager.
19واجهات API الداخلية
GET /api/method/legal_erp.api.v1.tasks.suggest?task=TASK-0091
مرشحو الإسناد.
الصلاحية: الشريك أو من يملك الإسناد.
{
"candidates": [
{
"user": "lawyer.a@example.test",
"reasons": [
"متاح 12 ساعة هذا الأسبوع",
"أنجز 6 ملفات عمالية"
]
}
]
}20الأحداث والمهام الخلفية والجدولة وإعادة المحاولة
يومي: المتأخر والتصعيد. أسبوعي: مؤشرات الأداء.
21التكاملات المرتبطة بالميزة وحدودها
لا ينطبق على هذه الميزة.
22الأمن والخصوصية والتدقيق والاحتفاظ والحذف
مؤشرات الأداء للإدارة فقط.
23حالات الاختبار
| المعرّف | النوع | السيناريو | النتيجة المتوقعة |
|---|---|---|---|
B18-T01 | طبيعي | اقتراح مرشحين | ثلاثة بأسباب. |
B18-T02 | أمني | محامٍ محجوب | لا يظهر مرشحًا. |
B18-T03 | سلبي | إسناد لمحجوب يدويًا | يُمنع. |
24معايير القبول
- لا إسناد آلي.
- الاستبعادات مطبقة.
25تعريف الاكتمال (Definition of Done)
- كل قواعد العمل في هذه الصفحة منفذة في الخادم (Controller أو Service)، لا في الواجهة وحدها.
- حالات الاختبار المذكورة هنا مكتوبة اختباراتٍ آلية في إطار اختبار Frappe، وتنجح مع كل دفعة كود.
- اختبارات الصلاحيات تثبت أن مستخدمًا خارج فريق الملف لا يرى السجل في القائمة ولا برابطه المباشر ولا في البحث العام ولا في العدّادات.
- الحقول المخصصة والأدوار ومسارات الاعتماد مُصدَّرة في Fixtures التطبيق، وتظهر بعد تثبيت نظيف على موقع فارغ دون إعداد يدوي.
- لا تعديل في ملفات Frappe أو ERPNext.
- كل قيمة قانونية (مدة، نسبة، مبلغ، قائمة) محفوظة في إعداد قابل للتعديل، وموسومة بحالة اعتمادها.
- نصوص الواجهة ورسائل الخطأ بالعربية، وتخبر المستخدم بما يفعله.
- معايير القبول في هذه الصفحة مُتحقق منها ومسجلة في مصفوفة التتبع.
26القرارات المفتوحة والمخاطر والاعتمادات المطلوبة
الأوزان الافتراضية افتراض تنفيذي.