مساعدة

قاموس مصطلحات ERPNext وFrappe

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

ERPNextإي آر بي نكست
نظام تخطيط موارد مؤسسات مفتوح المصدر مرخّص بـ GPLv3، مبني فوق Frappe Framework. يجمع المحاسبة والمخزون والمبيعات والمشتريات وإدارة العملاء والمشاريع والتصنيع والأصول في قاعدة بيانات واحدة ويعمل من المتصفح. تستطيع شركة تجارية في اليمن أن تبدأ به كبرنامج محاسبة ومخزون ثم تضيف بقية الوحدات تدريجياً.
Frappe Frameworkإطار عمل فرابي
إطار برمجي مفتوح المصدر بترخيص MIT مكتوب بلغة Python ويعمل مع قاعدة بيانات MariaDB وRedis وNode.js. يوفّر جاهزاً المستخدمين والصلاحيات والنماذج والتقارير وواجهة REST API، ولذلك تُبنى عليه أنظمة كاملة دون كتابة هذه الأساسيات من الصفر. ERPNext نفسه تطبيق مبني فوق Frappe، ويمكن بناء نظام مستقل عليه لا علاقة له بالمحاسبة.
Benchبنش (بيئة التشغيل)
أداة سطر أوامر ومجلد عمل يجمع التطبيقات والمواقع والإعدادات على السيرفر. من خلالها يثبّت مدير النظام التطبيقات وينشئ المواقع ويشغّل التحديثات والنسخ الاحتياطي. المستخدم العادي لا يراها، لكنها أساس كل عملية صيانة على السيرفر.
Siteالموقع (النسخة)
نسخة مستقلة من النظام لها قاعدة بيانات خاصة بها ونطاق (دومين) خاص، وتعمل داخل Bench. يمكن أن يستضيف السيرفر الواحد عدة مواقع منفصلة البيانات تماماً، مثل موقع للتشغيل الفعلي وموقع آخر للتجربة والتدريب. أي تعديل يُجرّب أولاً على موقع التجربة قبل نقله إلى موقع التشغيل.
Custom Appتطبيق مخصص
تطبيق Frappe يُكتب خصيصاً لجهة معيّنة ويُثبَّت بجانب ERPNext دون تعديل كوده الأصلي. يحمل الحقول والنماذج والتقارير والمنطق الخاص بالجهة، فيبقى ERPNext قابلاً للتحديث. مثال ذلك تطبيق يضيف دورة عمل لطلبات الصرف في منظمة غير ربحية أو نظام حجوزات لمكتب سفريات.
DocTypeنوع المستند
الوحدة الأساسية في Frappe: تعريف لنوع بيانات يحدد حقوله وصلاحياته وشكل نموذجه، ويُنشئ له النظام جدولاً في قاعدة البيانات تلقائياً. العميل والصنف وفاتورة المبيعات كلها DocTypes. عندما تحتاج جهة إلى تسجيل شيء غير موجود في ERPNext، مثل عقود الإيجار، يُنشأ له DocType جديد.
Child Tableجدول فرعي
جدول داخل مستند يحتوي صفوفاً متعددة مرتبطة بهذا المستند فقط. أوضح مثال جدول الأصناف داخل فاتورة المبيعات، حيث يحمل كل صف صنفاً وكمية وسعراً. يُعرَّف الجدول الفرعي نفسه كـ DocType من نوع خاص يُضاف كحقل في المستند الأب.
Custom Fieldحقل مخصص
حقل يُضاف إلى نموذج قائم في ERPNext دون تعديل الكود، من شاشة Customize Form أو عبر تطبيق مخصص. يُستخدم لتسجيل معلومة تحتاجها الجهة ولا يوفرها النظام، مثل رقم السجل التجاري للعميل أو اسم المندوب في الفاتورة. يبقى الحقل محفوظاً عند تحديث النظام.
Naming Seriesسلسلة الترقيم
نمط يحدد كيف تُرقَّم المستندات تلقائياً، مثل بادئة ثم سنة ثم رقم تسلسلي. يمكن تعريف أكثر من سلسلة لنفس المستند، كأن يكون لكل فرع سلسلة فواتير خاصة به في صنعاء وعدن. تُضبط من إعدادات الترقيم أو من حقل السلسلة داخل المستند.
Workflowدورة العمل (سير الاعتماد)
مجموعة حالات وانتقالات تحدد من يحق له نقل المستند من مرحلة إلى أخرى، مثل مسودة ثم بانتظار موافقة المدير المالي ثم مُقَرّ. تُعرَّف من شاشة Workflow دون برمجة وتعتمد على الأدوار. تستفيد منها الجهات الحكومية والمنظمات التي تشترط أكثر من توقيع على طلب الشراء أو أمر الصرف.
Roleالدور
مجموعة صلاحيات تُسند إلى المستخدمين بدلاً من إعطاء كل مستخدم صلاحيات منفردة. يأتي ERPNext بأدوار جاهزة مثل Accounts User وStock Manager، ويمكن إنشاء أدوار جديدة. يمكن مثلاً إنشاء دور أمين صندوق يرى نقطة البيع فقط ولا يصل إلى التقارير المالية.
Role Permission Managerمدير صلاحيات الأدوار
الشاشة التي يُحدَّد فيها لكل دور ما يمكنه فعله في كل DocType: القراءة أو الإنشاء أو التعديل أو الاعتماد أو الإلغاء أو الطباعة أو التصدير. تُدار منها صلاحيات النظام كله دون كتابة كود. أي خطأ فيها قد يفتح بيانات حساسة، لذلك تُراجع بعناية قبل التشغيل.
User Permissionصلاحية المستخدم على السجلات
قيد يحصر ما يراه مستخدم معيّن في سجلات محددة، مثل فرع واحد أو مخزن واحد أو شركة واحدة. يُستخدم مع الأدوار: الدور يحدد نوع العملية، وصلاحية المستخدم تحدد نطاق البيانات. مثاله أن يرى مدير فرع تعز فواتير فرعه ومخزنه فقط.
Client Scriptسكربت الواجهة
كود JavaScript يُضاف من داخل النظام ليعمل في متصفح المستخدم على نموذج معيّن. يُستخدم لتعبئة حقل تلقائياً أو إظهار تنبيه أو إخفاء قسم حسب قيمة حقل آخر. لا يصلح وحده لفرض قواعد إلزامية لأن التحقق الحقيقي يجب أن يتم على السيرفر.
Server Scriptسكربت الخادم
كود Python مقيَّد يُكتب من داخل النظام ويعمل على السيرفر عند حدث معيّن، مثل قبل حفظ المستند أو بعد اعتماده، أو كواجهة API أو مهمة مجدولة. يُستخدم لفرض قاعدة عمل، مثل منع اعتماد فاتورة تتجاوز حد ائتمان العميل. يجب تفعيله في إعدادات السيرفر قبل استخدامه، وللمنطق الكبير يُفضَّل تطبيق مخصص.
تصميم يحدد شكل المستند عند طباعته أو تحويله إلى PDF، مثل الفاتورة أو سند القبض. يمكن إنشاؤه بأداة التصميم بالسحب والإفلات أو بقالب HTML مع دعم كامل للعربية واتجاه RTL. تحتاج معظم الجهات في اليمن إلى قالب يحمل شعارها وبياناتها ومبلغ الفاتورة كتابة.
Script Reportتقرير برمجي
تقرير يُكتب بلغة Python مع واجهة فلاتر بـ JavaScript، ويُستخدم عندما يحتاج التقرير إلى جمع بيانات من عدة جداول أو حسابات معقدة. تقارير مثل الميزانية العمومية وأعمار الديون في ERPNext من هذا النوع. يُبنى عادة داخل تطبيق مخصص حين لا يكفي Report Builder.
Notificationالإشعار
قاعدة ترسل تنبيهاً تلقائياً عبر البريد أو داخل النظام عند حدث معيّن، مثل إنشاء مستند أو تغيّر قيمة أو اقتراب تاريخ. تُعرَّف من شاشة Notification مع شروط ونص الرسالة. مثاله تنبيه المدير المالي عند وصول طلب شراء يتجاوز حداً معيّناً، ويمكن ربطها بتكامل واتساب عبر تطبيق إضافي.
Webhookالويب هوك (الإشعار البرمجي)
آلية ترسل بيانات المستند تلقائياً إلى رابط خارجي عند حدث معيّن، مثل اعتماد فاتورة أو إنشاء عميل. تُستخدم لربط ERPNext بأنظمة أخرى دون أن يسأل النظام الخارجي باستمرار. مثالها إرسال بيانات الطلب إلى منصة شحن أو خدمة رسائل فور اعتماده.
REST APIواجهة برمجة REST
واجهة يوفّرها Frappe تلقائياً لكل DocType تتيح للأنظمة الخارجية القراءة والإنشاء والتعديل عبر طلبات HTTP بصيغة JSON. إلى جانبها يمكن تعريف دوال مخصصة مسموح باستدعائها. بها يُربط تطبيق جوال أو موقع إلكتروني أو بوابة دفع ببيانات ERPNext.
API Key / API Secretمفتاح وسر الواجهة البرمجية
زوج من القيم يُولَّد لمستخدم معيّن من صفحة المستخدم ليستخدمه نظام خارجي في التحقق عند استدعاء REST API. يحصل النظام الخارجي على صلاحيات ذلك المستخدم نفسها، لذلك يُنشأ له مستخدم مخصص بأقل صلاحيات لازمة. يُحفظ السر في مكان آمن ولا يُرسل في الرسائل أو يُكتب في الكود المكشوف.
Schedulerالمجدول
خدمة في Frappe تشغّل مهاماً تلقائياً في أوقات محددة: كل بضع دقائق أو كل ساعة أو يومياً أو أسبوعياً. عليها تعتمد المهام الدورية مثل إرسال التقارير بالبريد وتنفيذ النسخ الاحتياطي المجدول وتذكيرات الاستحقاق. إذا توقف المجدول تتوقف هذه المهام بصمت، لذلك يُراقب على السيرفر.
Background Jobمهمة في الخلفية
عملية طويلة تُنفَّذ خارج طلب المستخدم عبر طابور يديره Redis وعمّال (workers) مخصصون، حتى لا تتجمد الشاشة. من أمثلتها استيراد آلاف الأصناف أو إعادة حساب قيمة المخزون أو إرسال رسائل جماعية. يمكن متابعة حالتها من شاشة RQ Job داخل النظام.
Backupالنسخة الاحتياطية
نسخة من قاعدة بيانات الموقع وملفاته المرفوعة تُنشأ بأمر bench أو تلقائياً عبر المجدول. لا تكفي النسخة المحفوظة على السيرفر نفسه، بل يجب نقلها إلى مكان آخر واختبار استرجاعها دورياً. في اليمن مع انقطاع الكهرباء وأعطال الأقراص تصبح هذه الممارسة ضرورة لا رفاهية.
bench migrateأمر الترحيل
أمر يُشغَّل على السيرفر بعد تحديث التطبيقات أو تثبيت تطبيق جديد، فيطبّق تغييرات بنية قاعدة البيانات وينفّذ سكربتات الترحيل (patches) ويحدّث التخصيصات. يجب أخذ نسخة احتياطية قبله دائماً. تشغيله على موقع التجربة أولاً يكشف أي مشكلة قبل أن تمس بيانات التشغيل.
Companyالشركة
الكيان القانوني أو المحاسبي الذي تُسجَّل باسمه الحركات، ولكل شركة دليل حسابات وعملة أساسية خاصة بها. يدعم ERPNext عدة شركات في موقع واحد، فتستطيع مجموعة تجارية إدارة شركاتها المنفصلة من نظام واحد. يظهر حقل الشركة في معظم المستندات المالية والمخزنية.
Cost Centerمركز التكلفة
وحدة تحليلية تُوزَّع عليها الإيرادات والمصروفات لمعرفة ربحية أو تكلفة كل جزء من المؤسسة، مثل فرع أو قسم أو مشروع. تُبنى في شجرة، ويمكن ربط الموازنات بها لمنع تجاوز المصروف المخطط. تستخدمها المنظمات غير الربحية لتتبّع الإنفاق على كل برنامج أو منحة.
Accounting Dimensionالبُعد المحاسبي
بُعد تحليلي إضافي يُعرَّف إلى جانب مركز التكلفة، مثل المشروع أو الجهة المانحة أو المنطقة، ويُضاف تلقائياً إلى القيود والفواتير. يسمح باستخراج تقارير مالية مفصّلة حسب هذا البُعد. تحتاجه الجهات التي تقدّم تقارير لأكثر من ممول أو تدير أنشطة في عدة محافظات.
Chart of Accountsدليل الحسابات
شجرة الحسابات التي تُسجَّل عليها كل القيود: الأصول والخصوم وحقوق الملكية والإيرادات والمصروفات. يقترح ERPNext دليلاً جاهزاً عند إنشاء الشركة، ويمكن استيراد دليل مخصص أو تعديله. تصميمه بعناية من البداية يوفّر كثيراً من التعب في التقارير لاحقاً.
Itemالصنف
كل ما تبيعه المؤسسة أو تشتريه أو تخزّنه أو تقدمه كخدمة، ويحمل رمزاً ووحدة قياس ومجموعة وأسعاراً. يمكن تعريف وحدات تحويل، كأن يُشترى الصنف بالكرتون ويُباع بالحبة، ويمكن تتبّعه بالأرقام التسلسلية أو الدفعات وتواريخ الانتهاء. هذا مهم لمحلات الأدوية والمواد الغذائية.
Warehouseالمخزن
موقع تُحفظ فيه الأصناف ويُتتبّع رصيدها، سواء كان مستودعاً فعلياً أو رفاً في فرع أو مخزن عبور. تُبنى المخازن في شجرة تحت كل شركة، ولكل حركة مخزنية مخزن مصدر أو هدف. تستطيع شركة لها فروع في عدة مدن يمنية أن ترى رصيد كل فرع على حدة ورصيدها الإجمالي.
Stock Entryقيد المخزون (حركة مخزنية)
مستند لتسجيل حركات المخزون غير المرتبطة مباشرة ببيع أو شراء، مثل التحويل بين المخازن أو صرف مواد للاستهلاك أو استلام مواد أو التصنيع. عند اعتماده يُحدّث الرصيد وتُنشأ القيود المحاسبية إذا كان الجرد الدائم مفعّلاً. مثاله نقل بضاعة من مخزن صنعاء الرئيس إلى فرع الحديدة.
Sales Invoiceفاتورة المبيعات
المستند الذي يثبت البيع للعميل ويُنشئ عند اعتماده قيد المديونية والإيراد، ويمكن أن يخصم المخزون مباشرة. يمكن إنشاؤها من أمر بيع أو إشعار تسليم أو مستقلة، وبأي عملة معرّفة في النظام. فواتير نقاط البيع هي نفسها فواتير مبيعات بواجهة أسرع.
Payment Entryسند الدفع / القبض
المستند الذي يسجّل استلام مبلغ من عميل أو دفع مبلغ لمورد، ويخصّصه على فاتورة أو أكثر. يحدد الحساب النقدي أو البنكي المستخدم ويحسب فروق العملة إذا اختلفت عملة الدفع. مثاله تحصيل دفعة من عميل بالعملة المحلية وتسويتها مقابل فاتورة صادرة بعملة أجنبية.
Journal Entryالقيد اليومي
مستند لتسجيل قيد محاسبي يدوي بطرفين مدين ودائن، يُستخدم للحركات التي لا تغطيها المستندات الأخرى مثل الاستهلاك والتسويات والقيود الافتتاحية. يجب أن يتساوى مجموع المدين والدائن قبل الاعتماد. الاعتماد عليه بكثرة بدل المستندات المخصصة يُضعف ربط الحركات ببعضها.
POS Profileملف نقطة البيع
إعداد يحدد لكل نقطة بيع أو كاشير المخزن الذي يُخصم منه وقائمة الأسعار وطرق الدفع المقبولة والحسابات والمستخدمين المسموح لهم. لا تعمل شاشة نقطة البيع دون ملف مرتبط بالمستخدم. يمكن لمطعم أو سوبر ماركت أن يعرّف ملفاً لكل كاشير أو لكل فرع.
BOM (Bill of Materials)قائمة المواد
قائمة المكونات والكميات والعمليات اللازمة لإنتاج صنف واحد، وهي أساس وحدة التصنيع في ERPNext. منها تُحسب تكلفة المنتج ويُحدد ما يُصرف من المخزن عند الإنتاج. تستفيد منها المصانع الصغيرة والمخابز، وكذلك المطاعم لحساب تكلفة الوجبة من مكوناتها.
HRMSنظام الموارد البشرية
تطبيق Frappe منفصل يُثبَّت مع ERPNext ويغطي الموظفين والحضور والإجازات والرواتب والتوظيف والتقييم والسلف. فُصل عن ERPNext في الإصدارات الحديثة فأصبح يُثبَّت كتطبيق مستقل. يمكن تهيئة مكونات الراتب والبدلات والخصومات بحسب لوائح الجهة.
Currency Exchangeسعر الصرف
سجل يحفظ سعر تحويل عملة إلى أخرى بتاريخ معيّن، ويستخدمه النظام لتحويل الفواتير والمدفوعات إلى العملة الأساسية للشركة. يمكن إدخاله يدوياً أو جلبه آلياً، ويحسب النظام أرباح وخسائر فروق الصرف عند التسوية. في اليمن حيث تتعامل المنشآت بأكثر من عملة يُفضَّل إدخال السعر الذي تعتمده الجهة يومياً بدل الاعتماد على الجلب الآلي.
Submit / Cancel / Amendالمسودة / الاعتماد / الإلغاء / التعديل بنسخة جديدة
يبدأ المستند القابل للاعتماد كمسودة (Draft) يمكن تعديلها أو حذفها دون أي أثر. الاعتماد (Submit) يثبّته وينشئ أثره في الحسابات والمخزون فلا يُعدَّل بعدها مباشرة، والإلغاء (Cancel) يعكس هذا الأثر مع إبقاء السجل للتدقيق. ثم يتيح التعديل (Amend) إنشاء نسخة جديدة برقم مشتق من الأصل لتصحيحها واعتمادها، وهو أثر كامل لكل تصحيح يطلبه المدققون في الجهات الحكومية والمنظمات.

أسئلة شائعة

هل واجهة ERPNext متاحة باللغة العربية؟

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

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

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

لماذا لا أستطيع تعديل فاتورة بعد اعتمادها؟

لأن الاعتماد أنشأ قيوداً محاسبية وحركات مخزنية، والسماح بتعديلها مباشرة يكسر سلامة الدفاتر. الطريق الصحيح هو إلغاء الفاتورة ثم استخدام Amend لإنشاء نسخة مصححة. بعض الحقول غير المؤثرة يمكن جعلها قابلة للتعديل بعد الاعتماد عبر خاصية Allow on Submit.