تكلفة الساعة والربحيةHourly cost and profitability

تكلفة ساعة كل موظف من راتبه وتكاليف صاحب العمل وساعاته المتاحة، ثم ربحية كل ملف: الأتعاب ناقص (الساعات × التكلفة) ناقص المصروفات غير المستردة.

بطاقة الميزة

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

يعرف الشريك أي القضايا تربح وأيها تخسر، ويغذي المسعّر B20 المسعّر الذكي للقضايا الجديدة (دليل المطور ص34).

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

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

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

الشريك والمحاسب فقط.

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

B26 الرواتب والموارد البشرية بالمتطلبات السعودية بيانات الرواتب، B19 تسجيل الوقت الفعلي والمتتبع المعلن الساعات، B23 الفوترة على المراحل والفوترة الإلكترونية الإيرادات.

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

1. شهريًا: تكلفة الساعة = (12 × الثابت + حصة صاحب العمل في التأمينات + مخصص نهاية الخدمة + التأمين الطبي + الرسوم الحكومية) ÷ ((أيام العمل − الإجازات − العطلات) × ساعات اليوم × نسبة الاستغلال) (الوثيقة المعمارية).
2. تحديث Activity Cost لكل موظف؛ الساعات المعتمدة تقفل سعرها.
3. ربحية الملف = الأتعاب − Σ(الساعات × التكلفة المباشرة) − المصروفات غير المستردة؛ والصافي بعد توزيع المصروفات العامة بالساعات (الوثيقة المعمارية).
4. لوحة: المقدر مقابل الفعلي، نسبة الفوترة لكل محامٍ، متوسط الساعات لكل نوع ومرحلة (دليل المطور ص34).

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

موظف بلا راتب مسجل: تكلفة افتراضية من الشريك بعلامة. ملف بنسبة نجاح: الإيراد عند التحصيل الفعلي.

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

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

لوحة الربحية للملف والمحامي والنوع. مؤشرات: نسبة الاستهلاك، الهامش، التكلفة المتوقعة عند الإغلاق، الجلسات مقابل المتوسط (الوثيقة المعمارية).

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

RULE B21.1  hourly_cost(emp, month) per formula; inputs versioned by effective date
RULE B21.2  approved timesheet freezes costing_rate at approval time
RULE B21.3  margin(matter) = revenue - Σ hours×cost - non_recoverable_expenses
RULE B21.4  visibility: Managing Partner, Legal Accountant only

مثال توضيحي في الوثيقة المعمارية: 227,150 ÷ 1,191 ساعة ≈ 191 ريالًا للساعة (الوثيقة المعمارية) — رقم توضيحي لا معيار.

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

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

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

يعيد استخدام Activity Cost وActivity Type. Hourly Cost Run شهري اقتراح هندسي.

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

• Hourly Cost Run (month, employee, inputs JSON, result) اقتراح هندسي.

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

لوحة بمرشحات الفترة والنوع والمحامي.

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

legal_erp.costing.monthly_run، legal_erp.costing.matter_margin.

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

لا توجد واجهة API خاصة بهذه الميزة.

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

شهري: حساب تكلفة الساعة. أسبوعي: الربحية (الوثيقة المعمارية).

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

المؤسسة العامة للتأمينات الاجتماعية مصدر النسب الرسمي؛ لا ربط آلي موثق.

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

رواتب وتكاليف: أعلى سرية داخلية.

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

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

• الربحية لكل ملف تطابق القيود.

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

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

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

نسب التأمينات ومكونات نهاية الخدمة لسنة 2026 يحتاج اعتمادًا قانونيًا.