أمانات الموكّلينClient trust accounting

B24العقود والماليةمتطلب وارد في الملفات يحتاج اعتمادًا قانونيًا

الأمانة مال الموكّل في يد المكتب لغرض محدد (رسوم، خبير، تسوية). ليست إيرادًا ولا دفعة مقدمة. أربع حركات فقط بقيود ثابتة، ولا يصبح رصيد ملف سالبًا أبدًا، ومن ينشئ الحركة غير من يعتمدها.

بطاقة الميزة

البند	القيمة
1. اسم الميزة	أمانات الموكّلين — Client trust accounting
2. المعرّف (Feature ID)	`B24`
3. مصدر المتطلب	الوثيقة المعمارية: الأمانات، تقييم القرارات الهندسية: فصل الأمانات عن الدفعات المقدمة
4. تصنيف المحتوى	متطلب وارد في الملفات حساب بنكي مستقل، أربع حركات بقيود ثابتة، لا رصيد سالب، صانع ≠ مدقق، تسوية ثلاثية شهرية. يحتاج اعتمادًا قانونيًا السند المهني (قواعد السلوك) ومعاملة الضريبة.
الوحدة	العقود والمالية
الأدوار المعنية	محاسب، شريك، موكّل
درجة الخطورة	حرجة
حالة الاعتماد	يحتاج اعتمادًا قانونيًا
المنصات المرتبطة	لا توجد

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

خلط أموال الموكّلين بأموال المكتب مخالفة مهنية وخطأ ضريبي (التقييم الهندسي).

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

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

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

المحاسب ينشئ. مستخدم آخر (الشريك) يعتمد. الموكّل يرى كشف أمانته في البوابة.

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

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

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

إيداع: الموكّل يحوّل للحساب المستقل ← قيد (مدين بنك الأمانات، دائن التزام أمانات الموكّل) مع الملف.
دفع لطرف ثالث: رسوم أو خبير ← إيصال إلزامي.
تحويل لتسوية فاتورة صادرة: يتطلب فاتورة صادرة وبندًا في العقد يسمح.
رد عند الإغلاق.
كل حركة: صانع ← مدقق مختلف ← ترحيل.
شهريًا: تسوية ثلاثية: كشف البنك = دفتر الأمانات = مجموع أرصدة الملفات (الوثيقة المعمارية).

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

رصيد غير كافٍ: تُرفض الحركة. فرق في التسوية: تقرير فرق يمنع إغلاق الشهر حتى يُعالج اقتراح هندسي.

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

الاسم العربي	الاسم البرمجي	النوع	إلزامي	التحقق	القيمة الافتراضية	مصدر البيانات
النوع	`movement_type`	Select	نعم	إيداع / دفع لطرف ثالث / تحويل لتسوية فاتورة / رد	—	(الوثيقة المعمارية)
الملف	`legal_matter`	Link → Legal Matter	نعم	—	—	—
المبلغ	`amount`	Currency	نعم	> 0	—	—
الفاتورة	`sales_invoice`	Link	عند التحويل	صادرة وغير مسددة	—	—
الإيصال	`receipt`	Attach	نعم	—	—	(الوثيقة المعمارية)
أنشأه / اعتمده	`maker / checker`	User	نعم	مختلفان	—	(الوثيقة المعمارية)

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

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

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

قواعد

RULE B24.1  balance(matter) - amount >= 0 for outflows
RULE B24.2  maker != checker
RULE B24.3  transfer_to_invoice requires submitted unpaid invoice + contract clause
RULE B24.4  fixed GL mapping per movement_type (no free journal)
RULE B24.5  monthly 3-way reconciliation must pass to close period

التفاصيل في قيود الأمانات والتسوية الثلاثية.

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

مسودة ← بانتظار التدقيق ← مرحّلة / مرفوضة.

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

Trust Movement ينشئ Journal Entry أو Payment Entry بالبُعد «القضية» (الوثيقة المعمارية).

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

Trust Movement، Trust Reconciliation اقتراح هندسي.

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

رصيد الأمانة في رأس الملف للمحاسب والشريك. شاشة التسوية بالأرقام الثلاثة.

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

legal_erp.trust.post(movement)، legal_erp.trust.reconcile(month).

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

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

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

شهري: تقرير التسوية.

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

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

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

اختبار آلي إلزامي لأرصدة الأمانات (الوثيقة المعمارية).

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

المعرّف	النوع	السيناريو	النتيجة المتوقعة
`B24-T01`	وحدة	دفع يتجاوز الرصيد	مرفوض.
`B24-T02`	سلبي	الصانع يعتمد حركته	مرفوض.
`B24-T03`	وحدة	تسوية بفرق	تقرير فرق ومنع الإغلاق.
`B24-T04`	سلبي	تحويل بلا فاتورة	مرفوض.

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

لا رصيد سالب في أي اختبار.
التسوية الثلاثية تطابق.

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

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

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

اعتماد الدليل المحاسبي من محاسب قانوني (الوثيقة المعمارية).