بوت رفع أسماء العوائل10 عوائل فقط لكل دائرة في تطبيق عين العراق ( على ان تكون بصيغة بوت )

1️⃣ الهدف: إنشاء بوت يقوم بـ رفع بيانات العائلات تلقائيًا على تطبيق عين العراق، بحيث: كل عائلة تتكون من 1 إلى 9 أفراد كحد أقصى. الحد الأقصى للأسماء المسموح رفعها لكل دائرة هو 10 عوائل. حفظ الوقت والجهد عن طريق إدخال البيانات بشكل تلقائي دون الحاجة لإدخالها يدويًا. 2️⃣ المتطلبات الأساسية: أ. من المستخدم: ملف Excel أو CSV يحتوي على جميع بيانات العوائل، بحيث لكل صف يمثل عائلة كاملة. الأعمدة المطلوبة لكل فرد: الاسم الكامل الرباعي اسم الأم الثلاثي صلة القرابة مع رب الأسرة تاريخ الميلاد نوع الجنس (ذكر/أنثى) بيانات الدائرة أو المركز الذي سيتم رفع العائلة فيه. ب. من البوت: الدخول على تطبيق عين العراق أو API الخاص به (إذا كان متاح). التحقق من عدد العوائل المسموح رفعها لكل دائرة (10 عوائل كحد أقصى). رفع بيانات كل عائلة واحدة تلو الأخرى، مع فحص كامل لكل فرد من أفراد العائلة. تأكيد الحفظ بعد كل رفع. تسجيل أي خطأ يحدث أثناء رفع البيانات للمتابعة. 3️⃣ خطوات البوت بالتفصيل: قراءة ملف البيانات البوت يقرأ ملف Excel/CSV. لكل صف يمثل عائلة. يتأكد أن عدد الأفراد في العائلة لا يتجاوز 9 أفراد. تحديد الدائرة/المركز قبل رفع العائلة، يحدد البوت الدائرة المناسبة. يتحقق من الحد الأقصى للعوائل المسموح بها (10 عوائل لكل دائرة). رفع بيانات العائلة يبدأ بالتحقق من كل فرد داخل العائلة: الاسم الكامل اسم الأم صلة القرابة تاريخ الميلاد نوع الجنس يملأ النموذج داخل التطبيق أو يرسل البيانات للـ API. تأكيد الحجز بعد إدخال بيانات العائلة، يقوم البوت بالضغط على زر تأكيد الحجز. يسجل البوت رسالة التأكيد أو رقم الحجز لكل عائلة. التعامل مع الأخطاء إذا كانت العائلة تحتوي على أكثر من 9 أفراد → يتجاهلها أو يعطي رسالة خطأ. إذا تجاوز عدد العوائل المسموح بها في الدائرة → يتوقف البوت أو ينتقل لدائرة أخرى. أي خطأ في البيانات أو الشبكة → يسجل البوت سبب الفشل. التقارير بعد رفع كل العوائل، ينتج البوت تقريرًا شاملًا: عدد العوائل المرفوعة بنجاح عدد العوائل التي فشل رفعها مع سبب الفشل رقم الحجز لكل عائلة ناجحة 4️⃣ ملاحظات للمبرمج: يجب استخدام التحقق من صحة البيانات قبل الإرسال لتجنب رفض التطبيق للطلبات. البوت يجب أن يحترم حد 10 عوائل لكل دائرة. البوت يمكن أن يكون سطح المكتب أو سكربت Python/Node.js يعتمد على واجهة الويب للتطبيق أو API. واجهة المستخدم للبوت يمكن أن تكون بسيطة: زر رفع ملف البيانات اختيار الدائرة عرض تقرير بعد الانتهاء