Carry Go — بوابة المستودعات

نظرة عامة#

بوابة المستودعات هي النواة التشغيلية لـ Carry Go: تطبيق ويب ثنائي اللغة (عربي/إنجليزي) يدير العمل اليومي لعملية مستودعات وتوصيل — إدارة الطلبات، والحضور، والرواتب، والمحاسبة — من واجهة واحدة، مبني على تطبيق Frappe مخصص (carry_go) فوق ERPNext.

المشكلة#

كان مشرفو المستودعات يتتبعون الصناديق والإيداعات والنقل بين المستودعات والحضور والرواتب عبر جداول Excel والمكالمات الهاتفية، ثم ينتقلون لـ ERPNext بشكل منفصل للمحاسبة والتقارير. لا شيء كان مترابطًا، وكل شاشة كان لازم تعمل بشكل صحيح بالعربي والإنجليزي معًا.

الحل#

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

المعمارية#

تتواصل البوابة مع طبقة REST بـ Python/Frappe مدعومة بـ ERPNext v16، منشور على Bench معزول خاص به (منافذ Redis منفصلة، Python 3.14، Node 24) يعمل جنبًا إلى جنب مع نسخة v15 قائمة دون أي تعارض. يتولى Redis التخزين المؤقت والمهام المجدولة الخلفية في Frappe؛ وتُعد MariaDB مصدر الحقيقة الوحيد للبيانات.

الميزات#

• واجهة ثنائية اللغة (عربي/إنجليزي) تغطي إدارة الطلبات والحضور والرواتب والمحاسبة.
• وحدة محاسبية مدمجة — تعرض الأرباح والخسائر ودفتر الأستاذ العام والفواتير وبطاقات المؤشرات مباشرة داخل البوابة.
• سير عمل استلام وتسليم بالباركود لموظفي المستودع.
• إدارة طلبات الإيداع وصناديق المستودعات مرتبطة بنفس نموذج البيانات الذي تقرأ منه التطبيقات المحمولة.
• تتبع النقل بين المستودعات مع سجل تدقيق كامل.

عملية التطوير#

توليت التطبيق بالكامل من تصميم المخطط حتى النشر: تعريف أنواع المستندات، والـ hooks، والـ fixtures، وبناء واجهات REST التي استهلكتها تطبيقات Flutter لاحقًا، وإقامة البنية التحتية. تم نشر ERPNext v16 على Bench معزول بحيث أُطلقت البوابة الجديدة دون المساس بنظام v15 الإنتاجي الذي تعمل بجانبه.

التحديات#

كان هناك خلل مؤقّت يعيد كتابة صفحات البوابة بصمت كل 12 ثانية في ظروف معينة — تم تتبعه إلى فاصل استطلاع مُهيّأ بشكل خاطئ وإصلاحه من المصدر. تم اكتشاف مشكلة أمنية بأولوية P0 — تخزين بيانات البطاقات الائتمانية كنص صريح — وإزالتها أثناء مراجعة، واستُبدلت بعلامة حالة دفع مرتبطة بمزود الدفع الفعلي. فُقد الوصول لجذر MariaDB أثناء عملية ترحيل، واستُعيد عبر مصادقة unix_socket دون أي توقف.

النتائج#

يدير مشرفو المستودعات الآن الطلبات والحضور والرواتب والمحاسبة من نظام ثنائي اللغة واحد بدلًا من خمس أدوات منفصلة. تم نشر التطبيق على GitHub مع ملف README كامل ودليل تثبيت وتوثيق لواجهات API.

تحسينات مستقبلية#

لوحة تحليلات للمشرفين تتجاوز تقارير ERPNext المدمجة، وشاشات رئيسية مخصصة حسب كل مستودع.