المسعّر الذكي للقضايا الجديدةSmart matter pricer

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

يقترح نطاق أتعاب (أدنى/مقترح/أعلى) لقضية جديدة من الساعات الفعلية لملفات المكتب المغلقة المشابهة وتكلفة ساعة كل دور. الأرقام من معادلات، والنموذج لا يكتب سعرًا أبدًا، والسعر النهائي قرار الشريك.

بطاقة الميزة

البند	القيمة
1. اسم الميزة	المسعّر الذكي للقضايا الجديدة — Smart matter pricer
2. المعرّف (Feature ID)	`B20`
3. مصدر المتطلب	دليل المطور ص33-34 (الميزة 5 الجزء 2)، الوثيقة المعمارية: المسعّر
4. تصنيف المحتوى	متطلب وارد في الملفات المدخلات والمعادلات الشفافة ونطاق السعر والنماذج، دور الذكاء محدود. يحتاج اعتمادًا قانونيًا رسوم التقاضي والضريبة. اقتراح هندسي حد أدنى لعدد الملفات المشابهة.
الوحدة	الوقت والتسعير
الأدوار المعنية	شريك، محامٍ
درجة الخطورة	عالية
حالة الاعتماد	يحتاج اعتمادًا قانونيًا
المنصات المرتبطة	لا توجد

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

التسعير بالتقدير يخسر المكتب في قضايا طويلة. البيانات الفعلية تجعله قابلًا للتفسير (دليل المطور ص33).

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

نماذج الأتعاب: ثابتة، مراحل، ساعة بسقف، نسبة من المحكوم به، مختلطة. رسوم التقاضي والإعفاءات وأثر الصلح عليها ذكرها الدليل من مصادر ثانوية (دليل المطور ص34) يحتاج اعتمادًا قانونيًا؛ تُحفظ في Pricing Settings بحالة «غير معتمدة» حتى المراجعة. ضريبة القيمة المضافة 15% ومعاملة العميل غير المقيم تحتاج رأيًا ضريبيًا (دليل المطور ص34) يحتاج اعتمادًا قانونيًا.

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

المحامي يدخل المدخلات. الشريك يعتمد. الموكّل لا يرى التقدير الداخلي.

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

B19 تسجيل الوقت الفعلي والمتتبع المعلن ساعات فعلية لملفات مغلقة، B21 تكلفة الساعة والربحية تكلفة الساعة، Pricing Settings.

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

المدخلات: نوع القضية، نوع المحكمة ومدينتها، قيمة المطالبة، عدد الأطراف، التعقيد (استبيان)، المراحل المطلوبة، الاستعجال، النموذج المفضل (دليل المطور ص33).
الجهد المتوقع لكل مرحلة = وسيط الساعات الفعلية لملفات مغلقة مشابهة (النوع والمحكمة)؛ أو القيم الافتراضية من الشريك إن لم توجد بيانات.
التكلفة = Σ(ساعات الدور × تكلفة ساعة الدور) + المصروفات المتوقعة.
السعر المقترح = التكلفة × (1 + الهامش المستهدف + علاوة مخاطرة تزيد مع تباين ساعات المشابهة).
نطاق مع السبب: عدد الملفات المشابهة (أرقام لا أسماء) والافتراضات.
حسب النموذج: ثابت، أقساط بالمراحل، ساعة بسقف، نسبة (يدخل المحامي القيمة المتوقعة واحتمال النجاح)، مختلط.
الشريك يعتمد ← مسودة عقد أتعاب B22 العقود الإلكترونية واتفاقيات الأتعاب والتوقيع.

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

بيانات غير كافية (أقل من حد في الإعداد): «بيانات غير كافية» واستخدام الافتراضيات المعلنة (الوثيقة المعمارية). الذكاء: يستخرج عوامل التعقيد من الوصف ويجد ملفات مشابهة دلاليًا فقط (دليل المطور ص34).

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

الاسم العربي	الاسم البرمجي	النوع	إلزامي	التحقق	القيمة الافتراضية	مصدر البيانات
المرجع	`reference`	Dynamic Link	نعم	زيارة أو ملف	—	B17 الزوار والاستقبال والمواعيد
المدخلات	`inputs`	JSON	نعم	مخطط ثابت	—	المحامي
الساعات بالمرحلة	`hours_by_stage`	JSON	تلقائي	—	—	المعادلة
التكلفة	`cost_total`	Currency	تلقائي	—	—	المعادلة
الأدنى / المقترح / الأعلى	`price_low / price_suggested / price_high`	Currency	تلقائي	أدنى ≤ مقترح ≤ أعلى	—	المعادلة
النموذج	`fee_model`	Select	نعم	النماذج الخمسة	—	المحامي
الملفات المشابهة	`similar_matters`	JSON	تلقائي	معرّفات فقط	—	البحث
اعتمده	`approved_by`	Link → User	للاستخدام	شريك	—	الشريك

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

بطاقة التقدير بكل رقم قابل للتتبع إلى معادلته ومدخلاته (دليل المطور ص34).

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

قواعد

RULE B20.1  hours(stage) = median(actual hours of closed similar matters) if n >= min_similar else default_hours[type][stage]
RULE B20.2  cost = Σ_role hours_role × hourly_cost_role + expected_expenses
RULE B20.3  suggested = cost × (1 + target_margin + risk_factor × cv(similar hours))
RULE B20.4  LLM may classify/extract only; output numbers come from formulas
RULE B20.5  final price = human decision (approved_by)

التفاصيل في خوارزمية المسعّر.

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

مسودة ← معتمد ← مستخدم في عقد.

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

Pricing Estimate، Pricing Settings (target_margin, risk_factor, default_hours, court_cost_rate, court_cost_cap, min_similar) (دليل المطور ص34).

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

Pricing Estimate، Pricing Settings.

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

نموذج المدخلات، بطاقة النطاق مع «كيف حُسب؟» قابل للتوسيع.

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

legal_erp.pricing.estimate(inputs)، similar_matters(inputs).

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

`POST /api/method/legal_erp.api.v1.pricing.estimate`

تقدير.

الصلاحية: محامٍ أو شريك.

JSON · الطلب

{
  "matter_type": "عمالي",
  "court_type": "عمالية",
  "city": "الرياض",
  "claim_value": 120000,
  "stages": [
    "ابتدائية",
    "استئناف"
  ],
  "fee_model": "ثابتة"
}

JSON · الاستجابة

{
  "similar_count": 0,
  "note": "بيانات غير كافية؛ استُخدمت الافتراضيات",
  "price_low": null,
  "price_suggested": null,
  "price_high": null
}

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

أسبوعي: تحديث متوسطات الساعات حسب النوع والمرحلة B21 تكلفة الساعة والربحية.

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

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

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

التقدير الداخلي لا يظهر للموكّل. الملفات المشابهة بأرقام لا أسماء.

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

المعرّف	النوع	السيناريو	النتيجة المتوقعة
`B20-T01`	وحدة	معادلة بمدخلات ثابتة	نتيجة محددة قابلة للتكرار.
`B20-T02`	حدّي	لا ملفات مشابهة	«بيانات غير كافية».
`B20-T03`	أمني	الملفات المشابهة في الاستجابة	أرقام فقط.

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

كل رقم قابل للتتبع لمعادلته (دليل المطور ص34).

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

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

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

رسوم التقاضي ونسبها وإعفاءاتها يحتاج اعتمادًا قانونيًا. الهامش وعلاوة المخاطرة قرار الشريك.