تسجيل الوقت الفعلي والمتتبع المعلنActual time recording and declared tracker

B19الوقت والتسعيرمتطلب وارد في الملفات يحتاج اعتمادًا قانونيًا اقتراح هندسي

كم ساعة فعلية في كل ملف: مؤقت يدوي، وأزرار في الجلسة («انطلقت/وصلت المحكمة/بدأت/انتهت») تنشئ ثلاثة سجلات (تنقل، انتظار، جلسة)، واقتراحات من النشاط داخل المنصة يؤكدها المحامي. لا ساعة بلا تأكيد، ولا مراقبة خارج المنصة.

بطاقة الميزة

البند	القيمة
1. اسم الميزة	تسجيل الوقت الفعلي والمتتبع المعلن — Actual time recording and declared tracker
2. المعرّف (Feature ID)	`B19`
3. مصدر المتطلب	دليل المطور ص33 (الميزة 5 الجزء 1)، الوثيقة المعمارية: المتتبع المعلن، تقييم القرارات الهندسية: شرعية التتبع
4. تصنيف المحتوى	متطلب وارد في الملفات مؤقت يدوي، أزرار الجلسة، اقتراحات يؤكدها المحامي، لا ساعة دون تأكيد. يحتاج اعتمادًا قانونيًا حدود التتبع (نظام العمل وحماية البيانات). اقتراح هندسي إشارات المتتبع المجمعة.
الوحدة	الوقت والتسعير
الأدوار المعنية	محامٍ، متدرب، شريك
درجة الخطورة	عالية
حالة الاعتماد	يحتاج اعتمادًا قانونيًا
المنصات المرتبطة	لا توجد

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

الساعات الفعلية أساس التسعير B20 المسعّر الذكي للقضايا الجديدة والربحية B21 تكلفة الساعة والربحية والفوترة بالساعة B23 الفوترة على المراحل والفوترة الإلكترونية.

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

المتتبع المعلن داخل المنصة فقط يحمي من مخالفات نظام العمل وحماية البيانات (التقييم الهندسي) يحتاج اعتمادًا قانونيًا: لا لقطات شاشة، لا ضغطات مفاتيح، لا تسجيل مكالمات (الوثيقة المعمارية). الموظف يعرف ما يُجمع.

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

المحامي يسجل ويؤكد. الشريك يرى ساعات الجميع وتكلفتها. الموظف لا يرى تكلفة زملائه.

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

Activity Type وActivity Cost B21 تكلفة الساعة والربحية. B09 الجلسات والتقويم المزدوج ومنع التعارض الزمني أزرار الجلسة.

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

مؤقت يدوي لكل ملف ونشاط على الويب والجوال.
أزرار الجلسة تنشئ سجلات تنقل وانتظار وجلسة؛ الجلسة عن بعد من فتح الرابط لإغلاقه (دليل المطور ص33).
اقتراحات من النشاط (تحرير مسودة، اجتماع تقويم) بإشارات مجمعة: تركيز، عدد تعديلات، صفحات PDF، حجم الفرق (الوثيقة المعمارية).
يومي: مسودة سجل يومية يراجعها المحامي ويؤكد أو يعدل أو يحذف.
إدخال متأخر يدوي بسبب.
بعد الفوترة يُقفل السجل.

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

خمول: قاعدة خمول توقف العد (الوثيقة المعمارية). فجوة: مؤشر فجوة لا عقوبة (الوثيقة المعمارية). ساعات غير قابلة للفوترة: تُسجل أيضًا (دليل المطور ص34).

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

الاسم العربي	الاسم البرمجي	النوع	إلزامي	التحقق	القيمة الافتراضية	مصدر البيانات
الملف	`legal_matter`	Link → Legal Matter	نعم	—	—	(دليل المطور ص34)
المرحلة / الجلسة	`proceeding / hearing`	Link	لا	—	—	(دليل المطور ص34)
النشاط	`activity_type`	Link → Activity Type	نعم	بحث/استشارة/صياغة/جلسة/انتظار/تنقل/تفاوض/إداري	—	(دليل المطور ص33)
المقطع	`segment`	Select	لا	تحضير/تنقل/انتظار/جلسة/تقرير	—	(دليل المطور ص33)
من / إلى	`from_time / to_time`	Datetime	نعم	إلى > من	—	المؤقت
قابل للفوترة	`billable`	Check	نعم	—	1	المحامي
ملاحظة للموكّل	`client_note`	Small Text	لا	—	—	المحامي
المصدر	`entry_source`	Select	تلقائي	يدوي / زر جلسة / اقتراح مؤكد / متأخر	—	اقتراح هندسي
سبب التأخير	`late_reason`	Small Text	عند المتأخر	—	—	المحامي

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

شاشة الجلسة: وقت التحضير والتنقل والانتظار والجلسة وتكلفتها (دليل المطور ص33). تقرير الساعات للملف وللمحامي.

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

قواعد

RULE B19.1  suggested entries are drafts; only confirmed entries count
RULE B19.2  hearing buttons: left->arrived = تنقل, arrived->started = انتظار, started->ended = جلسة
RULE B19.3  billed timesheet locked
RULE B19.4  raw tracker events aggregated daily then deleted [AR]; no screenshots/keystrokes/recordings
RULE B19.5  hearing.actual_cost = Σ(minutes × performer minute cost)

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

مسودة (اقتراح) ← مؤكد ← معتمد ← مفوتر (مقفل).

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

يعيد استخدام Timesheet وTimesheet Detail مع حقول مخصصة (دليل المطور ص34). Tracker Event مؤقت يُحذف بعد التجميع اقتراح هندسي.

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

Custom Fields على Timesheet Detail: legal_matter, proceeding, hearing, segment, client_note, entry_source.
Tracker Event (مؤقت)، Tracker Settings (idle_minutes, enabled).

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

مؤقت عائم. أزرار الجلسة الأربعة في الجوال. شاشة «مسودة يومي» للتأكيد.

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

legal_erp.time.hearing_button(hearing, event)، legal_erp.time.daily_draft(user).

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

`POST /api/method/legal_erp.api.v1.mobile.hearing_event`

ضغط زر جلسة.

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

JSON · الطلب

{
  "hearing": "HRG-0042",
  "event": "وصلت المحكمة",
  "at": "2026-11-04T08:40:00+03:00",
  "client_request_id": "7c1e0f3a-0000-4000-8000-000000000002"
}

JSON · الاستجابة

{
  "created": "TS-0101 (تنقل 35 دقيقة)"
}

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

ليلي: تجميع الإشارات وحذف الخام وإنشاء المسودات.

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

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

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

ساعات الموظف وتكلفته للإدارة فقط (دليل المطور ص34). إعلان واضح للموظف بما يُجمع يحتاج اعتمادًا قانونيًا.

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

المعرّف	النوع	السيناريو	النتيجة المتوقعة
`B19-T01`	قبول	أزرار الجلسة الأربعة	ثلاثة سجلات مرتبطة (دليل المطور ص34).
`B19-T02`	سلبي	اقتراح لم يُؤكد	لا يدخل في الحساب.
`B19-T03`	سلبي	تعديل سجل مفوتر	يُمنع.
`B19-T04`	أمني	المحامي يرى تكلفة زميله	لا.

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

أزرار الجلسة تنشئ السجلات.
شاشة الجلسة تعرض الأوقات والتكلفة.

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

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

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

نص الإعلان للموظف ومراجعة نظام العمل يحتاج اعتمادًا قانونيًا.