شارك المقالة
تحليل الرقم القومي المصري في Flutter وحدود التحقق

تحليل الرقم القومي المصري في Flutter وحدود التحقق

الرقم القومي المصري في Flutter: استخراج تاريخ أو محافظة من الرقم لا يثبت صحة الهوية أو ملكية الرقم.

تحليل الرقم القومي المصري في Flutter باستخدام egyptian_id_parser مع تطبيع الأرقام وفحص المدخلات، والتمييز بين قراءة البنية وإثبات الهوية.

التحليل ليس تحققًا رسميًا

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

افصل الصورة عن الرقم

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

تطبيع الأرقام دون تغيير المعنى

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

الحقول تحتاج تفسيرًا دقيقًا

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

الخطأ والخصوصية في الواجهة

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

اختبار البنية قبل التكامل

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

التمييز بين مستويات الاختبار

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

مثال الشفرة وحدوده

String normalizeEgyptianIdInput(String raw){
 final normalized=String.fromCharCodes(raw.trim().runes.map((r){
  if(r>=0x0660&&r<=0x0669)return 0x30+r-0x0660;
  if(r>=0x06F0&&r<=0x06F9)return 0x30+r-0x06F0;
  return r;
 }));
 if(!RegExp(r'^[0-9]{14}$').hasMatch(normalized)){
  throw const FormatException('Exactly 14 digits required');
 }
 return normalized;
}
// Syntax normalization only: this does NOT validate issuance or ownership.
// For package integration after validation (dependency: egyptian_id_parser):
// import 'package:egyptian_id_parser/egyptian_id_parser.dart';
// final parsed = EgyptianIdParser(normalizedInput);
// Read only required fields, catch parsing errors, and do not log the ID.

مراجع التنفيذ

تطبيق الرقم القومي المصري في Flutter في مشروعك

استخراج تاريخ أو محافظة من الرقم لا يثبت صحة الهوية أو ملكية الرقم؛ افصل التحقق البنيوي عن أي تحقق رسمي ولا تسجل البيانات الحساسة.

عند مراجعة صفحة egyptian_id_parser كان الإصدار المنشور 1.1.0. أرقام الإصدارات في المثال الأصلي قد تختلف؛ قارِن دليل الهجرة وإعدادات المنصة قبل التحديث، ولا ترفع قيد الاعتماد وحده مع إبقاء استدعاءات واجهة قديمة.

مراجع الموضوع: pub.dev — egyptian_id_parser

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع