خدمة
تخصيص ERPNext وتطوير تطبيقات Frappe
تخصيص ERPNext هو تعديل سلوك النظام ليطابق عمليات مؤسستك دون المساس بالنواة: من تغيير الإعدادات وإضافة حقول مخصصة، إلى كتابة سكربتات وسير عمل ونماذج طباعة عربية، وصولاً إلى بناء تطبيق Frappe مستقل عند الحاجة. تقدّم يمن فرابي هذه الخدمة للشركات والجهات الحكومية والمنظمات غير الربحية في اليمن، مع التزام ثابت: كل تخصيص يبقى قابلاً للتحديث مع إصدارات ERPNext القادمة.
ما خدمة التخصيص ومتى تحتاجها؟
الإعداد القياسي لـ ERPNext يغطي الدورة المحاسبية والمخزنية والبيعية لمعظم المؤسسات، لكن كل جهة لديها تفاصيل خاصة: حقل إضافي في الفاتورة يطلبه المدقق، سلسلة موافقات على طلبات الشراء تمر بثلاثة مستويات، تقرير شهري بصيغة محددة، أو عملية كاملة لا يوجد لها مستند في النظام. هنا يأتي التخصيص.
القاعدة التي نعمل بها في يمن فرابي: نبدأ من الإعداد القياسي، ونصعد في سلّم التخصيص درجة واحدة في كل مرة، ولا نلمس شيفرة ERPNext أو Frappe الأصلية. تعديل النواة يعني أن أي تحديث أمني أو إصدار جديد سيكسر النظام أو يُلغي التعديل، وهذا ثمن لا تستطيع أي مؤسسة في اليمن تحمّله على المدى الطويل.
سلّم التخصيص: من الإعدادات إلى التطبيق المستقل
- الإعدادات القياسية: كثير من الطلبات تُحل من شاشات الإعداد نفسها: سلاسل الترقيم، سياسات التسعير، قواعد الضرائب، منع المخزون السالب، وصلاحيات الأدوار. لا شيفرة ولا خطر عند التحديث.
- Custom Field وProperty Setter: إضافة حقول جديدة إلى أي مستند قياسي، أو تغيير خصائص الحقول الموجودة (إلزامي، مخفي، التسمية العربية، القيمة الافتراضية) من واجهة Customize Form.
- Client Script وServer Script: منطق صغير يعمل في المتصفح (حساب تلقائي، تحقق من قيمة، إظهار تحذير) أو على الخادم عند الحفظ والترحيل، دون نشر شيفرة في ملفات التطبيق.
- Workflow: تعريف حالات المستند (مسودة، مراجعة المدير المالي، مُجاز، مرفوض) ومن يملك صلاحية الانتقال بين كل حالة، على فواتير الشراء أو طلبات الصرف أو الإجازات.
- Print Format والتقارير: نماذج طباعة عربية بتخطيط مؤسستك وشعارها وختمها، وتقارير مبنية بـ Report Builder أو Script Report تجمع البيانات بالشكل الذي تطلبه الإدارة أو الجهة الرقابية.
- تطبيق Frappe مستقل: عندما تحتاج مستندات جديدة بالكامل أو منطقاً معقداً أو تكاملات خارجية، نبني تطبيقاً منفصلاً يُثبَّت بجانب ERPNext ويحتفظ بكل التخصيصات في مستودع Git خاص بالمؤسسة.
ما هو Frappe Framework باختصار؟
Frappe Framework هو إطار العمل مفتوح المصدر برخصة MIT الذي بُني عليه ERPNext، بلغة Python مع قاعدة بيانات MariaDB وRedis وNode. وحدته الأساسية هي DocType: تعريف واحد للمستند يولّد منه الإطار جدول قاعدة البيانات، ونموذج الإدخال، وقائمة العرض، والصلاحيات، وواجهة REST API تلقائياً. فاتورة البيع والصنف والموظف كلها DocTypes، وعندما نبني لك مستنداً جديداً مثل طلب صرف نقدي أو محضر استلام فإنه يحصل على القدرات نفسها فوراً.
هذا ما يجعل التخصيص على Frappe أسرع وأكثر أماناً من التعديل على أنظمة مغلقة: المستند المخصص يعيش في طبقة منفصلة عن النواة، ويتحدث إلى بقية ERPNext عبر الروابط والأحداث نفسها التي تستخدمها المستندات القياسية. تجد شرحاً أوسع في مقال ما هو Frappe Framework، وتعريفات المصطلحات في قاموس المصطلحات.
متى تحتاج تطبيق Frappe مستقلاً؟
ليس كل طلب يستحق تطبيقاً. نلجأ إلى التطبيق المستقل عندما يتحقق واحد أو أكثر من هذه الشروط:
- العملية تحتاج مستندات جديدة بالكامل لا يوجد لها مكافئ في ERPNext، مثل إدارة عقود تأجير أو سجل معاملات حكومية أو متابعة منح.
- المنطق أكبر من أن يُكتب في Server Script: حسابات متعددة الخطوات، تكاملات مع أنظمة خارجية، أو مهام مجدولة تعمل في الخلفية.
- تريد نشر التخصيصات نفسها على أكثر من موقع أو فرع أو شركة تابعة بأمر تثبيت واحد.
- تحتاج إلى واجهات مستخدم خاصة خارج شاشات Desk القياسية، مثل بوابة للعملاء أو تطبيق داخلي مبسط للموظفين غير التقنيين.
- تريد أن تكون التخصيصات موثّقة ومحفوظة في Git ومنفصلة تماماً عن قاعدة البيانات، لتسهيل المراجعة والاسترجاع.
وعندما تكون الحاجة تكاملاً مع واتساب أو بوابة دفع أو جهاز حضور، فإن التطبيق المستقل هو المكان الطبيعي لهذه الشيفرة، ونغطي ذلك في خدمة تكامل الأنظمة.
كيف نحافظ على التخصيصات آمنة عند التحديث؟
- لا نعدّل أي ملف داخل تطبيقي frappe أو erpnext؛ كل شيء يعيش في التطبيق المخصص أو في مستندات التخصيص (Custom Field، Property Setter، Client Script).
- نصدّر التخصيصات كـ Fixtures داخل التطبيق، فتنتقل مع الشيفرة إلى أي بيئة جديدة ولا تضيع عند إعادة التثبيت.
- نستخدم hooks الإطار (doc_events وoverride) لتغيير سلوك المستندات القياسية بدل نسخها وتعديلها.
- نختبر كل تحديث لـ ERPNext على بيئة تجريبية بنسخة من بياناتك قبل تطبيقه على بيئة الإنتاج.
- نوثّق كل تخصيص: لماذا أُضيف، ومن طلبه، وما المستندات التي يمسها، حتى يستطيع أي فريق لاحق فهمه.
أمثلة على احتياجات شائعة في اليمن
| الحاجة | الأداة في Frappe وERPNext | تعديل النواة؟ |
|---|---|---|
| فاتورة عربية بشعار الجهة وختمها وتوقيعات محددة | Print Format مخصص | لا |
| موافقة المدير المالي ثم المدير العام على فواتير الشراء | Workflow بحالات وأدوار | لا |
| حقول الزكاة والضريبة المحلية في الفاتورة والقيود | Custom Field وقوالب الضرائب | لا |
| موظف الفرع يرى بيانات فرعه فقط | User Permission على المستودع ومركز التكلفة | لا |
| تحويل المبلغ إلى كلمات عربية وتحذير عند تجاوز حد الائتمان | Client Script وServer Script | لا |
| سجل متابعة معاملات أو عقود لا يوجد لها مستند قياسي | تطبيق Frappe مستقل بـ DocTypes جديدة | لا |
الجدول يوضح أن أغلب ما تطلبه المؤسسات في اليمن يُحل في الدرجات الأولى من السلّم، وأن التطبيق المستقل خيار للحالات التي تستحقه فعلاً. نفصّل منهجية كل درجة في مقال تخصيص ERPNext وتطوير Frappe.
لمن تناسب هذه الخدمة؟
- المؤسسات والجهات الحكومية: سلاسل موافقات متعددة المستويات، نماذج رسمية مطابقة للمعمول به، وسجل تدقيق لكل تغيير، وكلها تُبنى بـ Workflow وPrint Format دون شيفرة في النواة.
- المنظمات غير الربحية: حقول للممول والمشروع والمنحة على المصروفات والقيود، وتقارير بصيغة نماذج المانحين.
- الشركات والمؤسسات التجارية: سياسات تسعير وخصم خاصة، نماذج طباعة لكل فرع، وضوابط على حدود الائتمان وصلاحيات الفروع.
- المشاريع والشركات الناشئة: تطبيق Frappe صغير يغلّف نموذج العمل الخاص بها (اشتراكات، تأجير، نقاط ولاء) فوق محاسبة ERPNext القياسية.
المخرجات التي تحصل عليها
- وثيقة تحدد كل تخصيص ودرجته في السلّم وسبب اختياره.
- تطبيق Frappe في مستودع Git باسم مؤسستك، مع Fixtures لكل التخصيصات.
- نماذج طباعة وتقارير عربية جاهزة للاستخدام.
- بيئة تجريبية لاختبار التحديثات قبل الإنتاج.
- تدريب للمستخدمين على المستندات والشاشات الجديدة، وانتقال إلى الدعم الفني المستمر.
أسئلة شائعة
هل يمكن تخصيص ERPNext بدون برمجة؟
نعم في كثير من الحالات. إضافة الحقول وتغيير خصائصها وإخفاء ما لا يُستخدم وبناء سير العمل ونماذج الطباعة البسيطة كلها تُنجز من واجهة ERPNext دون كتابة شيفرة. تُستدعى البرمجة عندما يحتاج المنطق إلى حسابات معقدة أو مستندات جديدة أو تكامل خارجي.
هل يؤثر التخصيص على تحديث ERPNext إلى الإصدارات الجديدة؟
إذا تم التخصيص بتعديل ملفات النواة فنعم، سيضيع التعديل أو يكسر التحديث. أما التخصيص عبر Custom Field والسكربتات وسير العمل وتطبيق مستقل فيبقى منفصلاً عن شيفرة ERPNext، ويُختبر على بيئة تجريبية قبل كل تحديث. هذا هو الأسلوب الوحيد الذي نعمل به.
ما الفرق بين Custom Field وتطبيق Frappe مخصص؟
Custom Field يضيف حقلاً إلى مستند قياسي موجود مثل الفاتورة، ويُخزَّن كإعداد داخل قاعدة البيانات. التطبيق المخصص هو حزمة شيفرة منفصلة تحتوي مستندات جديدة ومنطقاً وتكاملات، ويُدار في Git ويُثبَّت على أي موقع. الأول للتعديلات الصغيرة، والثاني للعمليات الكاملة.
هل يمكن عمل نموذج فاتورة عربي بشعار الشركة في ERPNext؟
نعم. يتيح ERPNext بناء نماذج طباعة متعددة لكل مستند، بتخطيط عربي من اليمين إلى اليسار وبشعار الجهة وختمها وبنودها القانونية، ويمكن تعيين نموذج مختلف لكل فرع أو نوع فاتورة. النموذج يعيش خارج النواة ولا يتأثر بالتحديثات.
من يملك التخصيصات والشيفرة بعد انتهاء العمل؟
مؤسستك. التطبيق المخصص يُسلَّم في مستودع Git باسمك مع وثائقه، ويبقى مفتوحاً لأي فريق تختاره لاحقاً. هذا من مزايا البناء على إطار مفتوح المصدر مثل Frappe بدل الأنظمة المغلقة.