العقود الإلكترونية واتفاقيات الأتعاب والتوقيعE-contracts, fee agreements and signature

توليد عقد الأتعاب والعقود من قوالب ببيانات الملف، وإرسالها للمراجعة والتوقيع الإلكتروني، وحفظ النسخة الموقعة بأثر التوقيع (من، متى، كيف تحقّقنا). رمز OTP يثبت التحكم في الجوال وموافقة على خطوة، ولا يساوي التوقيع الرقمي بشهادة.

بطاقة الميزة

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

عقد الأتعاب أساس المطالبة والفوترة؛ وغيابه أو غموضه أصل النزاع مع الموكّل (دليل المطور ص35).

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

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

عقد الأتعاب الموحد عبر نافذ: يذكر الدليل أنه يكتسب صفة السند التنفيذي عند تسجيله في خدمة العقود، وأن التسجيل غير إلزامي حاليًا (دليل المطور ص35) يحتاج تحققًا أو موافقة رسمية. «نافذ» منصة السندات التنفيذية، و«نفاذ» منصة الهوية الرقمية الوطنية؛ لا علاقة بينهما في هذا التدفق إلا أن نفاذ قد يُستخدم للتحقق من الهوية. لا API عامًا معروفًا لنافذ، فالنظام يجهز البيانات بترتيب العقد الموحد والمحامي يسجل يدويًا (دليل المطور ص35).

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

المحامي يولد ويعدّل. الشريك يعتمد البنود خارج القالب. الموكّل يراجع ويوقع من البوابة.

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

Contract Template وClause معتمدة يحتاج اعتمادًا قانونيًا. B20 المسعّر الذكي للقضايا الجديدة تقدير معتمد. قناة إرسال B44 الإشعارات والتذكيرات.

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

1. قالب يُملأ من الملف والتقدير المعتمد.
2. تفاوض: كل تعديل إصدار جديد بفروقه.
3. بند خارج القالب يتطلب اعتماد الشريك.
4. إرسال رابط عبر البوابة أو واتساب؛ الموكّل يراجع ثم يتحقق بـ OTP ويوقع؛ ثم يوقع المكتب.
5. ختم PDF نهائي بصفحة أثر: الأسماء، الأوقات، طريقة التحقق، بصمة الملف.
6. اختياري: مرجع نافذ وحالته بعد التسجيل اليدوي.
7. جدول الدفعات ينشئ Fee Agreement والفواتير في مواعيدها B23 الفوترة على المراحل والفوترة الإلكترونية.

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

المصدر: (دليل المطور ص35). تعديل بعد التوقيع: بملحق موقع فقط.

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

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

PDF موقع مع صفحة الأثر. تنبيه قبل انتهاء العقود السنوية. فواتير الجدول.

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

RULE B22.1  signed contract immutable; changes only via signed addendum
RULE B22.2  keep template_version used
RULE B22.3  fee agreement must contain: scope & stages, fees & model, installments, expenses & court costs bearer, termination, return of originals, confidentiality [legal] -> pre-send checklist
RULE B22.4  no contract to client without lawyer review
RULE B22.5  templates for personal status / real-estate deeds: e-sign disabled unless lawyer review recorded [legal]
RULE B22.6  UI labels OTP signature as "موافقة بالتحقق من الجوال", never "توقيع رقمي"
RULE B22.7  nafith_ref entered manually; system never claims registration

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

مسودة ← مراجعة داخلية ← أُرسل للموكّل ← موقّع ← ساري ← منتهٍ أو ملغى (دليل المطور ص36).

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

Legal Contract n → 1 Contract Template؛ 1 → n Signature Request؛ 1 ↔ 1 Fee Agreement.

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

• Contract Template، Clause، Legal Contract، Signature Request (دليل المطور ص36)، Fee Agreement (دليل المطور ص11).

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

محرر العقد مع الفروق بين الإصدارات. صفحة البوابة للمراجعة والتوقيع. شارة «سجّل في نافذ (يدوي)».

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

legal_erp.contracts.render، send_for_signature، seal_pdf، ESignProvider واجهة لمزود موثّق اقتراح هندسي.

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

POST /api/method/legal_erp.api.v1.portal.sign_contract

توقيع الموكّل بعد OTP.

الصلاحية: الموكّل الطرف في العقد.

{
  "signature_request": "SR-0012",
  "otp": "000000"
}

{
  "status": "signed_by_client",
  "next": "office_signature"
}

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

تنبيه قبل انتهاء العقود السنوية. انتهاء صلاحية روابط التوقيع.

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

نافذ — منصة السندات التنفيذية يدوي. نفاذ — النفاذ الوطني الموحد ومزود التوقيع الإلكتروني الموثّق للتوقيع الموثق بعد الاعتماد يحتاج تحققًا أو موافقة رسمية. منصة واتساب للأعمال للإرسال.

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

روابط التوقيع موقعة ومؤقتة. OTP يُخزن مجزأ (hash) وينتهي سريعًا اقتراح هندسي.

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

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

• معايير الميزة 6 ناجحة (دليل المطور ص36).

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

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

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

هل العقد الموحد عبر نافذ هو الافتراضي؟ أي مزود توقيع موثّق؟ (دليل المطور ص47) يحتاج تحققًا أو موافقة رسمية.