كيف بنينا YeloInvoice: منصة فوترة متوافقة ضريبيًا بُنيت بوكلاء ذكاء اصطناعي

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

كان الهدف منتجًا يثق به المحاسب، يسلّمه فريق صغير بسرعة شركة ناشئة. وهذا المزيج تحديدًا هو حيث تؤتي الهندسة المدعومة بالذكاء الاصطناعي ثمارها، شرط أن تكون العملية منضبطة.

YeloInvoice مستودع موحّد بـ pnpm. الواجهة البرمجية بـ NestJS مع Prisma على Postgres وRedis. وتطبيق الويب بـ Next.js مع App Router وTailwind، بالفرنسية افتراضيًا، وبالعربية بتخطيطات من اليمين إلى اليسار، وبالإنجليزية. وتضمّ حزمة مشتركة مخططات Zod وتعدادات المجال ومحرك حسابات ضريبية خالصًا بلا اعتماد على قاعدة بيانات أو إطار عمل.

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

بدأ كل جزء من YeloInvoice بوثيقة تصميم: النواة الضريبية، وقوالب PDF، والضرائب الموسّعة، والمحاسبة والتقارير، ونقاط البيع، والإدارة، والاستيراد، وطرق الدفع بحسب نوع النشاط. وتحدّد كل مواصفة المتطلبات، ومصادر الامتثال، وما هو خارج النطاق صراحةً.

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

القواعد الضريبية موثّقة بمصادرها، والأسئلة المفتوحة تُتابَع على حدة حتى يؤكّدها محاسب. وبدلًا من الوعد بمصادقة قانونية، يوضّح المنتج صراحةً أن التحقّق الضريبي النهائي يبقى مسؤولية الشركة ومحاسبها، ويسهّل تلك المهمة بمستندات نظيفة وكاملة.

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

لا يشغّل YeloInvoice خادم MCP بعد، لكنه بُني بحيث تكون إضافته طبقة رقيقة لا إعادة كتابة. فكل قدرة متاحة عبر واجهة OpenAPI 3 موثّقة بمخططات مُنمّطة. والصلاحيات دقيقة ويُتحقق منها في كل طلب. والكتابات المهمة غير قابلة للتكرار. وهذه الخصائص الثلاث هي بالضبط ما تحتاجه أداة MCP آمنة: مخطط يصفها، وصلاحية تضبطها، وعدم تكرار يجعل إعادة محاولة الوكيل غير ضارة.

وتتبع طبقة MCP المخطط لها النموذج الذي استخدمته OHY Labs في YeloScale. تأتي أولًا أدوات القراءة للفواتير والعملاء والمدفوعات. وإنشاء مسودّة كتابة قابلة للتراجع بمفتاح عدم تكرار. أما إصدار فاتورة أو تسجيل دفعة فهو إجراء حساس يتطلب خطوة تحضير ثم تأكيد بوجود إنسان في الحلقة.

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

وبالنسبة لـ OHY Labs، يثبت YeloInvoice أن الهندسة المدعومة بالذكاء الاصطناعي قادرة على تسليم برمجيات في مجال تكلفة الخطأ فيه عالية، ما دامت المواصفات والاختبارات والمراجعة البشرية حاضرة في الحلقة.