مدقق خوارزمية لوهن

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

ما الذي تعنيه نتيجة لوهن فعلياً

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

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

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

إعداد المدخل وفهم الأخطاء

أرسلوا القيمة في الحقل <code>number</code> كسلسلة غير فارغة لا تحتوي إلا على المحارف من صفر إلى تسعة. تُرفض المسافات والشرطات وعلامات الجمع والفواصل العشرية وفواصل الأسطر والحروف بوصفها مدخلاً غير صالح. هذا السلوك الصارم مقصود؛ فإزالة علامات التنسيق بصمت قد تخفي عيباً سابقاً في المصدر، أو تغير معنى بيانات منسوخة، أو توهم بتطابق نظامين رغم تلقيهما نصين مختلفين.

إذا عرض المصدر قيماً مجمعة، فطبّعوا التنسيق عمداً ضمن مساركم قبل استدعاء هذه الإمكانية، واحتفظوا بالقيمة الأصلية عندما يكون سجل التدقيق مهماً. لا تحولوا السلسلة إلى عدد صحيح أولاً، لأن ذلك قد يحذف الأصفار البادئة ويقرب القيم الطويلة. يعيد الاستدعاء الناجح دائماً كائناً يحوي حقلاً منطقياً اسمه <code>valid</code>.

تعني <code>true</code> أن المجموع يقبل القسمة على عشرة، بينما تعني <code>false</code> أن المدخل صحيح نحوياً لكنه أخفق في المجموع الاختباري. يختلف خطأ المدخل عن نتيجة عدم الصلاحية، وينبغي عادةً أن يؤدي إلى التصحيح أو المراجعة بدلاً من معالجته كرقم غير صالح فحسب.

استخدام التحقق الحتمي في التطبيقات

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

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

إذا كان مجالكم يفرض طولاً أو بادئة أو تحققاً من الملكية أو الحالة الفورية، فطبقوا تلك القواعد بصورة منفصلة.