مجموع السلة يظهر 12.300000000000001: حسابات الدينار بالفلس
باختصار: إذا ظهر في سلة متجرك الإلكتروني أو في فاتورة يولّدها تطبيقك مجموع غريب مثل 12.300000000000001 بدل 12.300، أو اختلف المجموع بفلس واحد بين صفحة السلة والفاتورة، فالسبب على الأرجح أن الحسابات تتم بأرقام عشرية عادية في JavaScript. توثيق MDN يوضح أن نوع Number في JavaScript قيمة عشرية ثنائية بدقة مزدوجة وفق معيار IEEE 754، وأن الحسابات بعد حد معين من الدقة تخضع للتقريب. الحل: احسب المبالغ بالفلس كأعداد صحيحة، وقرّب في مكان واحد بقاعدة واضحة، واستخدم Intl.NumberFormat لعرض المبلغ بعملة الدينار.
كيف يظهر الخطأ للزبون؟
متجر عطور في عمّان أضاف ميزة جديدة: خصم بنسبة مئوية على السلة. بعد الإطلاق لاحظت خدمة العملاء رسائل من زبائن: «المجموع مكتوب بأرقام طويلة غريبة»، و«الفاتورة اللي وصلتني على الإيميل مختلفة فلس عن الموقع». مبلغ الفلس لا يهم مالياً، لكنه يجعل المتجر يبدو غير دقيق، ويربك المحاسب عند المطابقة.
هذا مثال توضيحي لمشكلة شائعة، والأرقام في المقال أمثلة حسابية لا أسعار حقيقية.
لماذا لا يجمع الحاسوب الكسور «بشكل صحيح»؟
نحن نكتب الأرقام بالنظام العشري، والحاسوب يخزنها بالنظام الثنائي. بعض الكسور البسيطة عندنا، مثل 0.1، لا يمكن تمثيلها بدقة تامة في النظام الثنائي، كما لا يمكن كتابة الثلث بدقة تامة كعدد عشري.
توثيق MDN لنوع Number يشرح أن الأرقام في JavaScript قيمة بصيغة ثنائية بدقة مزدوجة من 64 بت وفق معيار IEEE 754، مثل نوع double في لغات أخرى. ويضيف أن هذا يسمح بتمثيل القيم الكسرية، لكن مع حدود على حجم الرقم ودقته. ويذكر أن الدقة تعادل تقريباً 15 إلى 17 رقماً عشرياً ذا دلالة، وأن الحسابات فوق هذا المستوى من الدقة تخضع للتقريب.
النتيجة العملية: جمع عدة مبالغ كسرية، أو ضربها في نسبة خصم، قد ينتج رقماً قريباً جداً من الصحيح لكنه ليس هو بالضبط. إذا عُرض هذا الرقم كما هو، يرى الزبون الذيل الطويل من الأرقام. وإذا قُرّب في مكان ولم يُقرّب في مكان آخر، يظهر الفرق بفلس.
لماذا الدينار الأردني حساس لهذا أكثر؟
الدينار يُقسم إلى ألف فلس، فالمبالغ تُكتب عادة بثلاث خانات بعد الفاصلة. كثير من القوالب والإضافات الجاهزة مصممة لعملات بخانتين، فإذا لم تُضبط، قد تقرّب إلى خانتين في مكان وثلاث في مكان آخر. وكلما زادت خانات الكسر، زادت فرص ظهور فروق التقريب في الأطراف.
الحل الأول: احسب بالفلس لا بالدينار
بدلاً من تخزين السعر كرقم كسري بالدينار، خزّنه كعدد صحيح بالفلس. مثلاً: منتج سعره دينار وربع يُخزن كـ 1250 فلساً. جمع الأعداد الصحيحة دقيق ما دامت ضمن حد الأعداد الصحيحة الآمنة، والتوثيق يذكر أن أكبر عدد صحيح آمن في JavaScript هو 2 أس 53 ناقص واحد، وهو أكبر بكثير من أي مجموع سلة في متجر صغير.
القاعدة:
- الأسعار في قاعدة البيانات والكود: أعداد صحيحة بالفلس.
- الجمع والطرح والكميات: على الأعداد الصحيحة.
- القسمة إلى دينار: فقط عند العرض.
الحل الثاني: قرّب مرة واحدة، في مكان واحد
النسب المئوية تنتج كسوراً حتى مع الفلس. خصم 15% على 1250 فلساً يعطي 187.5 فلساً. هنا يجب أن تقرر:
- متى تقرّب؟ على كل سطر في السلة، أم على المجموع فقط؟ النتيجتان قد تختلفان بفلس.
- كيف تقرّب؟ للأعلى، للأسفل، أم لأقرب قيمة؟
- أين يحدث التقريب؟ في مكان واحد في الكود، تستخدمه السلة والفاتورة والبريد ولوحة التحكم.
أغلب فروق الفلس بين السلة والفاتورة تأتي من أن صفحتين تحسبان المبلغ بطريقتين مختلفتين. إذا كانت الفاتورة تُحسب على الخادم والسلة في المتصفح، فيجب أن تتبعا القاعدة نفسها، والأفضل أن يعرض المتصفح ما حسبه الخادم.
الحل الثالث: اعرض المبلغ بتنسيق العملة الصحيح
لعرض المبلغ للزبون، توفر JavaScript أداة Intl.NumberFormat. توثيق MDN يشرح أن خيار currency يقبل رموز العملات وفق معيار ISO 4217، ورمز الدينار الأردني فيه JOD. ويذكر أن الحد الأدنى الافتراضي لخانات الكسر في تنسيق العملة هو عدد خانات الوحدة الصغرى الذي توفره قائمة ISO 4217، أو خانتان إذا لم توفر القائمة ذلك.
أي أن تنسيق المبلغ بعملة الدينار يُفترض أن يعرض عدد الخانات المناسب للدينار تلقائياً، دون أن يكتب المطور «ثلاث خانات» بيده في كل مكان. ويذكر التوثيق أيضاً خيار roundingMode لتحديد طريقة التقريب، والقيمة الافتراضية فيه تقرّب الأنصاف بعيداً عن الصفر.
تنبيه: التنسيق للعرض فقط. لا تستخدم النص المنسق في حسابات لاحقة، ولا تخزنه في قاعدة البيانات كرقم.
لا تعتمد على toFixed في كل شيء
كثير من المطورين يحلون المشكلة بقص الرقم إلى ثلاث خانات عند العرض. هذا يخفي الذيل الطويل، لكنه لا يحل الفرق بين السلة والفاتورة إذا كان كل منهما يحسب بطريقته. الحل الحقيقي هو الأعداد الصحيحة والتقريب الموحد، والتنسيق في النهاية.
الضريبة والشحن: نفس القاعدة
إذا كانت الأسعار تشمل الضريبة أو تُضاف إليها، أو كان الشحن يُحسب حسب المنطقة، فهذه مصادر إضافية للكسور. قرر مع المحاسب: هل تُحسب الضريبة على كل سطر أم على المجموع؟ وهل يُضاف الشحن قبل الخصم أم بعده؟ ثم اكتب القرار في وثيقة قصيرة يرجع إليها المطور، كي لا يحسب كل جزء من النظام بطريقته. هذا قرار محاسبي قبل أن يكون تقنياً.
قائمة اختبار للمتجر
- أضف ثلاثة منتجات بأسعار فيها فلوس، وتحقق أن المجموع يظهر بثلاث خانات فقط.
- طبّق خصماً بنسبة مئوية، وقارن المجموع في السلة، وصفحة الدفع، والبريد، والفاتورة، ولوحة التحكم.
- غيّر الكميات عدة مرات وتأكد أن المجموع لا ينحرف.
- جرّب كوبوناً بمبلغ ثابت مع خصم نسبة في الوقت نفسه، إذا كان المتجر يسمح بذلك.
- اطلب من المحاسب مطابقة تقرير يوم كامل مع مجموع الطلبات.
إذا كان المتجر مبنياً على منصة جاهزة
إذا كنت تستخدم منصة متجر جاهزة، فراجع إعدادات العملة وعدد الخانات العشرية فيها أولاً، لأن كثيراً من المشاكل يأتي من إعداد خانتين لعملة بثلاث. ثم انتبه للإضافات والأكواد المخصصة، مثل إضافة خصومات أو حاسبة شحن، لأنها قد تحسب بطريقتها الخاصة بعيداً عن المنصة.
أسئلة شائعة
ليش المجموع بالسلة طالع أرقام طويلة زي 12.300000000000001؟
لأن JavaScript تحسب الكسور بأرقام ثنائية لا تمثل بعض الكسور العشرية بدقة، فيظهر فرق تقريب صغير.
ليش الفاتورة مختلفة فلس عن الموقع؟
غالباً لأن السلة والفاتورة تقرّبان في مكانين أو بطريقتين مختلفتين. وحّد قاعدة التقريب في مكان واحد.
شو الحل الأسلم للحسابات؟
خزّن واحسب المبالغ كأعداد صحيحة بالفلس، وقسّم على ألف عند العرض فقط.
كيف أعرض الدينار بالخانات الصحيحة؟
استخدم Intl.NumberFormat بعملة JOD، فيأخذ عدد الخانات الافتراضي من قائمة ISO 4217.
إذا كانت مجاميع متجرك أو فواتيرك تظهر أرقاماً غريبة، تواصل معنا ونراجع الحسابات معك.