خدمة

تخصيص ERPNext وتطوير تطبيقات Frappe

تخصيص ERPNext هو تعديل سلوك النظام ليطابق عمليات مؤسستك دون المساس بالنواة: من تغيير الإعدادات وإضافة حقول مخصصة، إلى كتابة سكربتات وسير عمل ونماذج طباعة عربية، وصولاً إلى بناء تطبيق Frappe مستقل عند الحاجة. تقدّم يمن فرابي هذه الخدمة للشركات والجهات الحكومية والمنظمات غير الربحية في اليمن، مع التزام ثابت: كل تخصيص يبقى قابلاً للتحديث مع إصدارات ERPNext القادمة.

ما خدمة التخصيص ومتى تحتاجها؟

الإعداد القياسي لـ ERPNext يغطي الدورة المحاسبية والمخزنية والبيعية لمعظم المؤسسات، لكن كل جهة لديها تفاصيل خاصة: حقل إضافي في الفاتورة يطلبه المدقق، سلسلة موافقات على طلبات الشراء تمر بثلاثة مستويات، تقرير شهري بصيغة محددة، أو عملية كاملة لا يوجد لها مستند في النظام. هنا يأتي التخصيص.

القاعدة التي نعمل بها في يمن فرابي: نبدأ من الإعداد القياسي، ونصعد في سلّم التخصيص درجة واحدة في كل مرة، ولا نلمس شيفرة ERPNext أو Frappe الأصلية. تعديل النواة يعني أن أي تحديث أمني أو إصدار جديد سيكسر النظام أو يُلغي التعديل، وهذا ثمن لا تستطيع أي مؤسسة في اليمن تحمّله على المدى الطويل.

سلّم التخصيص: من الإعدادات إلى التطبيق المستقل

  1. الإعدادات القياسية: كثير من الطلبات تُحل من شاشات الإعداد نفسها: سلاسل الترقيم، سياسات التسعير، قواعد الضرائب، منع المخزون السالب، وصلاحيات الأدوار. لا شيفرة ولا خطر عند التحديث.
  2. Custom Field وProperty Setter: إضافة حقول جديدة إلى أي مستند قياسي، أو تغيير خصائص الحقول الموجودة (إلزامي، مخفي، التسمية العربية، القيمة الافتراضية) من واجهة Customize Form.
  3. Client Script وServer Script: منطق صغير يعمل في المتصفح (حساب تلقائي، تحقق من قيمة، إظهار تحذير) أو على الخادم عند الحفظ والترحيل، دون نشر شيفرة في ملفات التطبيق.
  4. Workflow: تعريف حالات المستند (مسودة، مراجعة المدير المالي، مُجاز، مرفوض) ومن يملك صلاحية الانتقال بين كل حالة، على فواتير الشراء أو طلبات الصرف أو الإجازات.
  5. Print Format والتقارير: نماذج طباعة عربية بتخطيط مؤسستك وشعارها وختمها، وتقارير مبنية بـ Report Builder أو Script Report تجمع البيانات بالشكل الذي تطلبه الإدارة أو الجهة الرقابية.
  6. تطبيق Frappe مستقل: عندما تحتاج مستندات جديدة بالكامل أو منطقاً معقداً أو تكاملات خارجية، نبني تطبيقاً منفصلاً يُثبَّت بجانب ERPNext ويحتفظ بكل التخصيصات في مستودع Git خاص بالمؤسسة.

ما هو Frappe Framework باختصار؟

Frappe Framework هو إطار العمل مفتوح المصدر برخصة MIT الذي بُني عليه ERPNext، بلغة Python مع قاعدة بيانات MariaDB وRedis وNode. وحدته الأساسية هي DocType: تعريف واحد للمستند يولّد منه الإطار جدول قاعدة البيانات، ونموذج الإدخال، وقائمة العرض، والصلاحيات، وواجهة REST API تلقائياً. فاتورة البيع والصنف والموظف كلها DocTypes، وعندما نبني لك مستنداً جديداً مثل طلب صرف نقدي أو محضر استلام فإنه يحصل على القدرات نفسها فوراً.

هذا ما يجعل التخصيص على Frappe أسرع وأكثر أماناً من التعديل على أنظمة مغلقة: المستند المخصص يعيش في طبقة منفصلة عن النواة، ويتحدث إلى بقية ERPNext عبر الروابط والأحداث نفسها التي تستخدمها المستندات القياسية. تجد شرحاً أوسع في مقال ما هو Frappe Framework، وتعريفات المصطلحات في قاموس المصطلحات.

متى تحتاج تطبيق Frappe مستقلاً؟

ليس كل طلب يستحق تطبيقاً. نلجأ إلى التطبيق المستقل عندما يتحقق واحد أو أكثر من هذه الشروط:

وعندما تكون الحاجة تكاملاً مع واتساب أو بوابة دفع أو جهاز حضور، فإن التطبيق المستقل هو المكان الطبيعي لهذه الشيفرة، ونغطي ذلك في خدمة تكامل الأنظمة.

كيف نحافظ على التخصيصات آمنة عند التحديث؟

أمثلة على احتياجات شائعة في اليمن

الحاجةالأداة في Frappe وERPNextتعديل النواة؟
فاتورة عربية بشعار الجهة وختمها وتوقيعات محددةPrint Format مخصصلا
موافقة المدير المالي ثم المدير العام على فواتير الشراءWorkflow بحالات وأدوارلا
حقول الزكاة والضريبة المحلية في الفاتورة والقيودCustom Field وقوالب الضرائبلا
موظف الفرع يرى بيانات فرعه فقطUser Permission على المستودع ومركز التكلفةلا
تحويل المبلغ إلى كلمات عربية وتحذير عند تجاوز حد الائتمانClient Script وServer Scriptلا
سجل متابعة معاملات أو عقود لا يوجد لها مستند قياسيتطبيق Frappe مستقل بـ DocTypes جديدةلا

الجدول يوضح أن أغلب ما تطلبه المؤسسات في اليمن يُحل في الدرجات الأولى من السلّم، وأن التطبيق المستقل خيار للحالات التي تستحقه فعلاً. نفصّل منهجية كل درجة في مقال تخصيص ERPNext وتطوير Frappe.

لمن تناسب هذه الخدمة؟

المخرجات التي تحصل عليها

أسئلة شائعة

هل يمكن تخصيص ERPNext بدون برمجة؟

نعم في كثير من الحالات. إضافة الحقول وتغيير خصائصها وإخفاء ما لا يُستخدم وبناء سير العمل ونماذج الطباعة البسيطة كلها تُنجز من واجهة ERPNext دون كتابة شيفرة. تُستدعى البرمجة عندما يحتاج المنطق إلى حسابات معقدة أو مستندات جديدة أو تكامل خارجي.

هل يؤثر التخصيص على تحديث ERPNext إلى الإصدارات الجديدة؟

إذا تم التخصيص بتعديل ملفات النواة فنعم، سيضيع التعديل أو يكسر التحديث. أما التخصيص عبر Custom Field والسكربتات وسير العمل وتطبيق مستقل فيبقى منفصلاً عن شيفرة ERPNext، ويُختبر على بيئة تجريبية قبل كل تحديث. هذا هو الأسلوب الوحيد الذي نعمل به.

ما الفرق بين Custom Field وتطبيق Frappe مخصص؟

Custom Field يضيف حقلاً إلى مستند قياسي موجود مثل الفاتورة، ويُخزَّن كإعداد داخل قاعدة البيانات. التطبيق المخصص هو حزمة شيفرة منفصلة تحتوي مستندات جديدة ومنطقاً وتكاملات، ويُدار في Git ويُثبَّت على أي موقع. الأول للتعديلات الصغيرة، والثاني للعمليات الكاملة.

هل يمكن عمل نموذج فاتورة عربي بشعار الشركة في ERPNext؟

نعم. يتيح ERPNext بناء نماذج طباعة متعددة لكل مستند، بتخطيط عربي من اليمين إلى اليسار وبشعار الجهة وختمها وبنودها القانونية، ويمكن تعيين نموذج مختلف لكل فرع أو نوع فاتورة. النموذج يعيش خارج النواة ولا يتأثر بالتحديثات.

من يملك التخصيصات والشيفرة بعد انتهاء العمل؟

مؤسستك. التطبيق المخصص يُسلَّم في مستودع Git باسمك مع وثائقه، ويبقى مفتوحاً لأي فريق تختاره لاحقاً. هذا من مزايا البناء على إطار مفتوح المصدر مثل Frappe بدل الأنظمة المغلقة.