المشكلة
يعمل المستقلون ووكالات الويب ومستشارو تقنية المعلومات بأدوات متفرقة: واحدة للعملاء، وأخرى لعروض الأسعار، وجدول بيانات لتجديد النطاقات، ودفتر لبيانات الدخول إلى الخوادم. وفي إيطاليا عقبة إضافية: يجب إصدار كل فاتورة بصيغة FatturaPA XML وإرسالها عبر نظام التبادل الوطني (SDI)، ومعظم أنظمة CRM لا تفعل ذلك. بدأ BalanceAI كنظام CRM لشركتي الاستشارية، ثم أعدت بناءه لتتمكن شركات أخرى من تشغيله أيضًا.
ما الذي بنيته
بنيت منصة إدارة متعددة المستأجرين تجمع العملاء وعروض الأسعار والفواتير والجانب التقني من العمل في مكان واحد.
- نواة متعددة المستأجرين — تعمل كل شركة على بيانات معزولة، لأن كل استعلام يُصفّى حسب المستأجر. وتدير لوحة المشرف الأعلى المستأجرين، فيمكن للتثبيت نفسه أن يخدم شركة واحدة أو أن يُقدَّم كخدمة SaaS.
- الفوترة الإلكترونية الإيطالية — يولّد التطبيق ملفات FatturaPA 1.2.1 XML ويرسلها عبر واجهة Aruba البرمجية للفوترة الإلكترونية، مع تخزين رمز الدخول مؤقتًا لكل مستأجر. وتُتابع المدفوعات وتواريخ الاستحقاق في كل فاتورة.
- من العرض إلى الفاتورة — تتحول عروض الأسعار ذات البنود المتعددة والخصومات إلى فاتورة بخطوة واحدة، فلا يُكتب شيء مرتين.
- النطاقات والخوادم — تواريخ التجديد، واستعلامات WHOIS التلقائية، والربط مع cPanel/WHM API، لتظهر النطاقات وحسابات الاستضافة التي تقترب من الانتهاء قبل أن تصبح مشكلة لدى العميل.
- خزنة مشفّرة — تُحفظ بيانات اعتماد الخوادم وكلمات مرور العملاء والملاحظات الخاصة مشفّرة بـ AES-256-CBC مع IV عشوائي جديد لكل قيمة.
- البحث عن العملاء بالذكاء الاصطناعي — اكتب اسم الشركة أو رقم ضريبة القيمة المضافة، فيعيد نموذج من OpenAI (افتراضيًا GPT-4o mini) العنوان والبريد الإلكتروني المعتمد ورمز SDI بصيغة JSON صارمة لملء بطاقة العميل مسبقًا. وتعود الحقول غير المعروفة فارغة بدلًا من تخمينها.
- استيراد جماعي — تُستورد البيانات الحالية من ملفات Excel وCSV وWord وPDF.
التقنيات المستخدمة
Node.js وExpress، مع صفحات EJS تُعرض من جهة الخادم وBootstrap 5 في الواجهة الأمامية. وتُخزَّن البيانات في MySQL أو MariaDB. وينقسم الكود إلى 26 موجّهًا، واحد لكل وحدة، و16 نموذج بيانات. ويتم تسجيل الدخول عبر الجلسات مع كلمات مرور مجزّأة بـ bcrypt. التكاملات: الفوترة الإلكترونية من Aruba، وWHOIS، وcPanel/WHM، وOpenAI API الذي يُحفظ مفتاحه مشفّرًا لكل مستأجر. ويُثبَّت على خادم VPS خلف Nginx أو على استضافة cPanel.
لماذا بهذه الطريقة
كان BalanceAI في البداية نظام CRM لشركة واحدة. ثم جعله الإصدار 2.0.0 متعدد المستأجرين عبر سكربت ترحيل. يضيف السكربت عمود المستأجر إلى كل جدول وينقل جميع السجلات الحالية إلى المستأجر 1. وبقيت البيانات الحقيقية المتراكمة عبر سنوات من الاستخدام سليمة، وتحوّلت قاعدة الكود نفسها إلى منتج يمكن لوكالات أخرى استخدامه. والقاعدة التي رافقت ذلك بسيطة: لا يُنفَّذ أي استعلام دون مرشّح المستأجر.
