انتقل إلى المحتوى
DevOrbit
مقالEngineering· 2 دقائق قراءة

كيف نبني برمجيات مالية لا تخطئ في الحساب

القيد المزدوج الثابت، الحساب بالأعداد الصحيحة، مفاتيح منع التكرار، والمطابقة اليومية: المبادئ الهندسية التي نطبقها في Books و Qistora لتبقى الأرقام صحيحة.

بقلم Owner · نُشر

كيف نبني برمجيات مالية لا تخطئ في الحساب

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

1. الخادم وحده يحسب

لا تُجري الواجهة أي حساب مالي. السعر، الضريبة، الخصم، الربح، وجدول الأقساط كلها تُحسب على الخادم، والواجهة تعرض النتيجة فقط. في Qistora يمكنك معاينة جدول الأقساط قبل حفظ العقد، لكن المعاينة نفسها تُحسب على الخادم بنفس المحرك الذي سيُنشئ العقد.

2. لا كسور عشرية عائمة

نحسب المبالغ بالأعداد الصحيحة (بالهللة في Books) أو بأنواع عشرية دقيقة، ولا نستخدم الأعداد العائمة (float) في المال أبداً. التقريب يحدث في نقطة واحدة معروفة، بقاعدة واحدة.

3. قيد مزدوج لا يُعدَّل

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

4. نقرة واحدة = عملية واحدة

الشبكة البطيئة والنقر المزدوج سببان شائعان للدفعات المكررة. لذلك تتطلب كل عملية مالية في Qistora مفتاح منع تكرار (Idempotency Key): إن أُرسل الطلب مرتين، تُعاد النتيجة الأصلية دون تنفيذ ثانٍ. وفي Books تمنع نقطة البيع البيع المزدوج حتى مع بطء الاتصال.

5. المطابقة اليومية

مهمة مجدولة تطابق يومياً بين أرصدة الذمم في الدفتر ومجموع الأقساط القائمة. أي فرق يظهر فوراً في لوحة المعلومات بدل أن يُكتشف بعد أشهر.

6. سجل تدقيق لكل شيء

من سجّل الدفعة؟ من عدّل الإعداد؟ من كشف رقم هوية العميل؟ كل ذلك مسجّل بالمستخدم والوقت ومعرّف الطلب.


هذه المبادئ ليست نظرية؛ يمكنك رؤيتها بنفسك في النسخة التجريبية لـ Qistora والنسخة التجريبية لـ Books.

  • Devorbit Books — نظام إدارة المكتبات ونقاط البيع المتكامل
    مدفوعنشطv1.0.0

    Devorbit Books

    نظام متكامل لإدارة المكتبات ونقاط البيع: بيع بالباركود، مخزون متعدد الفروع، مشتريات، صناديق، ولاء العملاء، وتقارير ضريبية — بواجهة عربية أولاً.

    • PHP
    • Laravel
    • Livewire
    • Alpine.js
    • Tailwind CSS
  • Devorbit Qistora — نظام إدارة التقسيط والتمويل
    مدفوعنشطv1.0.0

    Devorbit Qistora

    نظام متكامل لإدارة التقسيط والتمويل: العملاء، العقود وجداول الأقساط، الدفعات، التحصيل والمتأخرات، دفتر قيود مزدوج، المحفظة والتقارير — بواجهة عربية.

    • PHP
    • Laravel
    • Livewire
    • Vue.js
    • Alpine.js
  • مقال1 دقائق قراءة

    ما تعلمناه من العمل على Next.js 16

    منصتنا ونظام Qistora مبنيان على Next.js 16. هذه أهم التغييرات التي لمسناها عملياً: proxy.ts بدل middleware، و Turbopack افتراضياً، و Cache Components الاختيارية.

    اقرأ المقال