README.ar.md

إدارة البيانات الرئيسية (MDM) لـ Frappe / ERPNext

مركزية الاداره. موحَّدة. خاضعة للرقابه


نظرة عامة • DocTypes الأساسية • التقارير • الصفحات • الميزات • البنية المعمارية • التثبيت

---

🖼️ لمحات مرئية

هيكل هرمي متقدم يوفر رؤية مالية موحدة عند كل مستوى.

---

Unified Party Hub (UPH)

يُعد Unified Party Hub (UPH) امتدادًا مؤسسيًا لإدارة البيانات الرئيسية (MDM) ضمن ERPNext. يقوم بتجميع الأدوار التجارية المنفصلة (العملاء، الموردون، الموظفون او اي نوع من الاطراف) ضمن هيكل موحد قائم على الهيكل الهرمي، مما يوفر رؤية مالية متكاملة وحوكمة صارمة للبيانات عبر الأنظمة التجارية المعقدة.

نظرة عامة

غالبًا ما تواجه تطبيقات ERPNext القياسية تحديات عند إدارة الكيانات التجارية المعقدة:

هوية مجزأة: قد تعمل جهة قانونية واحدة كعميل ومورد في الوقت نفسه، لكنها تظهر كمستندين منفصلين غير مرتبطين.

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

تقارير معزولة: يتم تقسيم التقارير المالية (دفتر الأستاذ العام، تقارير الأعمار) حسب سجل الطرف، مما يصعّب الحصول على رؤية شاملة لمخاطر الجهة القانونية.

تكرار البيانات: يجب تكرار بيانات العناوين وجهات الاتصال عبر أدوار متعددة.

يعالج UPH هذه المشكلات من خلال تقديم Party Master — طبقة حوكمة مركزية تعلو أنواع الأطراف القياسية في ERPNext.

---

DocTypes الأساسية

يقدم UPH DocTypes التالية لإدارة بيانات الأطراف:

1. Party Master

المركز الرئيسي لجميع الكيانات المرتبطة بالأطراف. أهم الميزات:

هيكل شجري: يدعم العلاقات بين الأصل والفروع ضمن الهياكل التنظيمية

ترقيم هرمي: ترقيم تلقائي بناءً على العقدة الأم

دعم تعدد الأدوار: ربط العملاء والموردين والموظفين تحت كيان واحد

الهوية القانونية: الرقم الضريبي، أرقام التسجيل، وأنواع الكيانات القانونية

جهات الاتصال والعناوين: إدارة مركزية لبيانات الاتصال

أدوار أساسية وثانوية: تحديد الدور الرئيسي وربط الأدوار الأخرى

طرف داخلي: إمكانية تعريف الطرف كطرف داخلي للمعاملات بين الشركات

2. Party Analytic Accounting

يوفر محاسبة مواقع مشابهة لنظام Oracle TCA. الميزات:

منع تكرار الحسابات: التخلص من الحسابات المكررة للفروع

أنواع أبعاد متعددة: الموقع، وحدة الأعمال، الفرع، الإقليم، مركز التكلفة، المصنع

قواعد خاصة بكل شركة: إعداد القواعد حسب كل شركة

التأريخ الفعّال: تتبع فترات صلاحية الأبعاد المحاسبية

قواعد السماح/التقييد: التحكم في الأطراف المسموح لها باستخدام أبعاد معينة

3. Party Master Parties

جدول ربط يصل Party Master بأطراف ERPNext:

روابط ديناميكية: ربط العملاء والموردين والموظفين والمساهمين

تتبع العملة: تسجيل العملة لكل طرف مرتبط

اسم الطرف: مرجع لاسم الطرف المرتبط

4. Party Master Settings

الإعدادات المركزية لـ UPH:

قواعد أنواع الأطراف: ضبط قواعد التفرد لكل نوع

تخطيط DocType: إضافة حقل party_master إلى مستندات المعاملات

مزامنة الحقول: مزامنة البيانات بين Party Master والأطراف المرتبطة

إعداد PAA: تفعيل وضبط المحاسبة التحليلية للأطراف

إعدادات العرض الشجري: توسيع المستويات تلقائيًا وإخفاء الرصيد

فحص السندات المكررة: منع إنشاء سندات مكررة لنفس Party Master

5. Party Relationship

تعريف العلاقات متعددة الاتجاهات بين الأطراف:

أنواع العلاقات: شركة أم/تابعة، ملكية، إدارة

نسب الملكية: تتبع حصص التملك

فترات الصلاحية: تحديد تواريخ سريان العلاقة

نوع العلاقة: إعداد البيانات الرئيسية لأنواع العلاقات

6. Duplicate Exclusion

قواعد لاستبعاد التكرارات:

معايير الاستبعاد: تحديد القواعد لتجاهل بعض التكرارات

أنواع المستندات: تطبيق القواعد على DocTypes محددة

DocTypes مساندة

Party Master Accounts: ربط الحسابات بكل طرف

Party Master Role: تعريف الأدوار

Party Analytic Accounting Party: تعيين الأطراف ضمن PAA

Party Analytic Accounting Allowed Company: صلاحيات الشركات

Party Master Settings DocType: إعداد DocTypes

Party Master Settings DocField: إعداد ربط الحقول

Party Master Settings Party Type: إعداد قواعد أنواع الأطراف

---

التقارير

يوفر UPH قدرات تقارير شاملة:

1. Party Master Ledger

عرض موحد لدفتر الأستاذ عبر جميع الأطراف المرتبطة:

التصفية حسب Party Master أو نوع الطرف أو الشركة أو الفترة

عرض جميع المعاملات تحت كيان واحد

إجماليات موحدة عبر الأطراف المرتبطة

2. Party Account Balances

تقارير أرصدة الحسابات لكل طرف:

أرصدة القبض/الدفع

تحليل حسب العملة

تحليل الأعمار

3. Party Accounting Ledger

تفاصيل المعاملات المحاسبية:

التصفية حسب Party Master والبُعد المحاسبي

تفاصيل حسب السند

ملخصات مدين/دائن

4. Party Ledger

دفتر أطراف قياسي مع تكامل Party Master:

رابط مباشر مع Party Master

خيارات تصفية موسعة

5. Chronological Party Ledger

سجل زمني لمعاملات الأطراف:

ترتيب زمني للمعاملات

ملخصات حسب التاريخ

تصفية حسب نوع المعاملة

6. Party Account Statement

تقارير على نمط كشوف الحساب:

مخرجات بصيغة كشف حساب

جاهزة لتأكيد الأرصدة

تفاصيل المعاملات مع رصيد جاري

7. Party Master Health Report

تقارير جودة البيانات والحوكمة:

حالة الربط

أرقام ضريبية مفقودة

أطراف غير مرتبطة

مؤشرات اكتمال البيانات

---

الصفحات

Data Quality Dashboard

مراقبة جودة البيانات في الوقت الحقيقي:

مؤشر الحوكمة: مقياس عام لجودة البيانات

إحصاءات الربط: الأطراف المرتبطة مقابل غير المرتبطة

اكتشاف التكرارات: تحديد التكرارات المحتملة

الامتثال الضريبي: تتبع الأرقام الضريبية المفقودة

إجراءات سريعة: ربط الأطراف، دمج التكرارات، إنشاء استثناءات

---

الميزات

🛡️ حوكمة هوية الأطراف

تتبع مؤشر الحوكمة لحظيًا

إحصاءات وربط مرئي

اكتشاف ذكي للتكرارات باستخدام المطابقة التقريبية

التحقق من الرقم الضريبي وتتبع الامتثال

🚀 تهيئة جاهزة للإنتاج

نافذة ربط ذكية للربط الجماعي

معالج "إنشاء طرف كـ" لتوفير الأدوار فورًا

توريث تلقائي للعناوين وبيانات الاتصال والضرائب

دعم ترحيل البيانات للأطراف الحالية

💱 دعم هرمي متعدد العملات

تعريف حسابات المجموعة على مستوى Party Master

اجتياز تلقائي للهيكل لمطابقة العملات

كيان طرف واحد مع معاملات متعددة العملات

ربط صحيح بدفتر الأستاذ لكل عملة

⚡ بنية عالية الأداء

SmartCache: طبقة تخزين مؤقت تعتمد على Redis

معالجة مجمّعة: استعلامات SQL محسّنة

تحديد نطاق الطلب: ذاكرة مؤقتة محلية لكل طلب

Query Builder: استخدام frappe.qb لتحقيق الكفاءة

📊 المحاسبة التحليلية للأطراف

محاسبة مواقع مشابهة لـ Oracle TCA

أبعاد متعددة (الموقع، الفرع، الإقليم...)

قواعد خاصة بالشركات

وظائف السماح/التقييد

دعم التأريخ الفعّال

🌳 هيكل شجري

هياكل تنظيمية أصل/فرع

رؤية موحدة للأرصدة في كل مستوى

نظام ترقيم هرمي

تحديثات متتالية تلقائية

🔗 إدارة العلاقات

هياكل شركة أم/تابعة

نسب الملكية وصلاحيتها

ربط علاقات متقدم متعدد الاتجاهات

إعداد أنواع العلاقات

📋 الإعداد

إضافة حقول ديناميكية إلى DocTypes

قواعد تفرد لكل نوع طرف

قواعد تحقق وحقول إلزامية

إعدادات مزامنة الحقول

---

البنية المعمارية

تم بناء UPH كامتداد غير تدخلي لـ ERPNext.

المكونات الأساسية

Hooks & Events: اعتراض أحداث validate و on_update و on_trash لضمان سلامة البيانات

Dynamic Field Injection: استخدام Party Master Settings لإضافة حقول الربط دون تعديل المخطط

Override Methods: توسيع دالة get_party_details للحصول على بيانات موحدة

Smart Validation: تحسين الأداء عبر الخروج المبكر من عمليات التحقق

المستندات المعاملاتية المدعومة

يقوم UPH تلقائيًا بإضافة Party Master إلى المستندات التالية:

فاتورة المبيعات / عناصرها

فاتورة المشتريات / عناصرها

قيد اليومية / حساباته

سند الدفع

أمر البيع / عناصره

أمر الشراء / عناصره

إشعار التسليم / عناصره

استلام المشتريات / عناصره

مطالبة المصروفات

---

مرجع API

وحدات التحكم الخلفية

الدالة الوصف

validate_party_master_on_document_types_smart تحقق ذكي مع تحسين الخروج المبكر validate_party_master_on_target_party_type_smart التحقق من العميل/المورد/الموظف get_party_details تجاوز API القياسي لجلب بيانات الطرف normalize_text تطبيع النص للمطابقة التقريبية validate_document_quality التحقق من جودة البيانات party_master_link_query استعلام ربط محسّن مع ترتيب النتائج

---

التوافق

المكون الإصدار

Framework Frappe v15+ ERP ERPNext v15+ قاعدة البيانات MariaDB / PostgreSQL Python 3.10+

---

حالات الاستخدام

1. التكتلات: إدارة المعاملات بين الشركات عندما تكون الشركة التابعة موردًا وعميلًا في نفس الوقت

2. التجارة متعددة الجنسيات: التعامل مع عميل واحد يدفع بعدة عملات دون ازدحام سجل العملاء

3. الامتثال والحوكمة: فرض التحقق من الرقم الضريبي ومنع إنشاء عملاء مكررين

4. محاسبة الفروع: تتبع الأداء المالي حسب الفرع دون إنشاء سجلات منفصلة

5. رسم العلاقات: تعريف الهياكل المؤسسية المعقدة ونسب الملكية

---

التثبيت

عبر Bench (موصى به)

bench get-app https://github.com/Sendipad/uph.git bench install-app uph bench migrate

التثبيت اليدوي

1. استنساخ المستودع داخل مجلد apps:

cd ~/frappe-bench/apps git clone https://github.com/Sendipad/uph.git

2. تثبيت التطبيق:

bench install-app uph bench migrate

3. مسح الذاكرة المؤقتة:

bench clear-cache

---

التوثيق

التوثيق الكامل متاح على: https://sendipad.github.io/uph/

دليل البدء السريع

1. إعداد Party Master Settings لتحديد أنواع الأطراف

2. إنشاء الهيكل الهرمي لـ Party Master لبناء هيكل مؤسستك

3. ربط الأطراف الحالية باستخدام الربط الذكي

4. إعداد PAA وتحديد الأبعاد المحاسبية

5. التحقق من التقارير عبر تشغيل Party Master Ledger للتأكد من توحيد البيانات

---

الترخيص

هذا المشروع مرخّص بموجب رخصة GPL-3.0 — راجع ملف LICENSE لمزيد من التفاصيل.

---

الدعم

GitHub Issues: للإبلاغ عن الأخطاء وطلب الميزات

التوثيق: https://sendipad.github.io/uph/

مجتمع ERPNext: https://discuss.erpnext.com

---

_{تم تطويره ❤️ لخدمة مجتمع ERPNext}