# EM — الأداء بالألوان وتصحيح ملف التلميذ — V3.1 — 16/11/2026

هذه الحزمة تشمل تعديل V2 (الأداء أثناء التسجيل) وتضيف وضوح حالات الأداء وتصحيح الملف والصورة. استعمل V3.1 فقط، ولا تركب V2 أو V3 القديم فوقها.

## حالات الأداء والدفعات

الحالة والباقي يتحسبان تلقائياً من الأداءات المحفوظة، بعد تطبيق التخفيض واحتساب التسجيل، ومع فصل رصيد الوفاء عن المبلغ المقبوض:
- أخضر: Payé — soldé، الباقي 0.
- أصفر/برتقالي: Paiement partiel، المبلغ الباقي واضح.
- أحمر: Non payé، المبلغ المستحق واضح.
- أزرق: الدفعات في سجل الأداء، مع التاريخ والمبلغ والتوصيل. الملغى رمادي ومميز بعبارة Annulé، ولا يدخل في المجموع.
تظهر الحالات في ملخص ملف التلميذ، Paiements des langues، تجديدات اللغات، وأداء الدعم حسب المادة والشهر.
كل أداء جديد يحدّث الباقي وحالته عند الحفظ وإعادة عرض الملف. سجل اللغات يبين أيضاً الباقي وقت تسجيل الدفعة، حيث يتوفر هذا الرقم في السجل.
في مرحلة تأكيد التسجيل تبقى خانات المبالغ، معاينة الباقي وزر «Le montant total a été reçu» من V2. استعمل الزر فقط عندما توصلتم بالمبلغ الكامل فعلاً.

## المتأخرون وأصحاب الباقي

من القائمة: Finances et documents → Retards / Soldes élèves.
تظهر المبالغ المتبقية بألوان واضحة، مع الفصل بين ما توصل به المركز ورصيد الوفاء. من خلص كامل الباك لا يدخل اللائحة؛ من بقي عليه مبلغ يبقى ظاهراً.
نافذة Retards du soutien scolaire تحتفظ بقاعدة الاستحقاق الحالية (الخامس من الشهر أو تاريخ التسجيل إن كان لاحقاً).
لم نضف تاريخ استحقاق افتراضياً لباكات اللغات: لائحة الباقي لا تعني أن كل صاحب تقسيط متأخر عن موعده. يجب مراعاة الاتفاق معه قبل التذكير.
التسجيلات القديمة التي ليس لها أداء مسجل لا تُصفّر بالتخمين؛ أضف المبلغ الحقيقي مرة واحدة من Paiements بعد مراجعة التاريخ والتوصيلات.

## تصحيح المعلومات والصورة

في ملف التلميذ، مباشرة تحت معلوماته: Modifier les informations / Changer la photo.
تقدر الكاتبة، في الفرع المسموح لحسابها، تصحح الاسم والهاتف والإيميل وتاريخ الازدياد وبيانات المسؤول والعنوان والجنس.
لتبديل صورة خاطئة: اختر Nouvelle photo من ملفات الجهاز ثم Enregistrer les corrections. اترك الخانة فارغة إذا أردت الاحتفاظ بالصورة الحالية. الصورة الجديدة تصبح صورة الملف، والوثيقة القديمة تبقى في التاريخ.
تقبل الصورة JPG أو PNG فقط، حتى 10 Mo، بنفس فحص الملفات الموجود في المنصة.
تعديل الهاتف يغير رقم الدخول الخاص بالتلميذ؛ لا يغير كلمة سره. الهاتف المستعمل لحساب آخر مرفوض.
هذا الزر لا يغير الفرع أو الصلاحيات أو كلمة السر أو رقم الملف أو الثمن أو الأداءات. الملفات المقفلة أو المعطلة يلزم التعامل مع حالتها من الإدارة أولاً.
التصحيح يتسجل باسم صاحبه مع المعلومات قبل وبعد. إذا تغيرت المعلومات/الصورة في جلسة أخرى، يطلب إعادة تحميل الملف قبل الحفظ.

## التركيب على الرسمية حسب اختيار المستخدم

الحزمة النهائية قورنت مع النسخة الرسمية المرسلة em-students-before-v3.zip بتاريخ 16/11/2026. حوفظ على تضمين قارئ QR ومساراته وصلاحياته، مع دمج الأداء أثناء التسجيل V2. ليست منصة كاملة.
لم تركب ملفاتها في الاستضافة بعد. المستخدم اختار تركيبها مباشرة في الرسمية بعد الاحتفاظ بنسخة حالية وتنزيلها ومراجعتها.
1. الحزمة EM_Paiements_Couleurs_Dossier_v3_1.zip تحتوي مجلد em-students؛ ارفع ZIP نفسه في /public_html، وليس داخل em-students.
2. في File Manager، حدد ZIP الجديد واضغط Extract واجعل الوجهة /public_html. يستبدل هذا الملفات المناظرة داخل /public_html/em-students.
3. لا تغير إعدادات config.php أو الملفات الخاصة أو قاعدة البيانات، ولا تستورد SQL.
4. بعد نجاح الاستخراج احذف ZIP التحديث المرفوع، واحتفظ بالنسخة الاحتياطية المنزلة في الكمبيوتر.
5. افتح digital.centreem.ma، حدث بـ Ctrl+F5، وتحقق من ظهور Scanner une carte، حالات الأداء، وزر تعديل المعلومات والصورة في ملف التلميذ.
6. راجع الدفعات الموجودة أولاً. اختبار تسجيل/أداء جديد يكون ببيانات تجريبية واضحة منفصلة، ولا تسجل أداءً ثانياً لتلميذ حقيقي سبق تسجيل أدائه.

الملفات: admission.php، index.php، language-payments.php، language-renewals.php، student-records.php، centre-reports.php، support-payments.php، support-overdue.php، student-tools.php، assets/admission-payment.js وassets/student-tools.css.
لا يوجد SQL للاستيراد ولا تغيير لـ config.php أو DNS أو الموقع العام أو منصة الأجور.
المقارنة تمت مع النسخة الرسمية المرفقة في هذه الدردشة، ولم يظهر فيها تركيب تحديث الحسابات وربط الموقع. هذه الدفعة لا تضيف ذلك التحديث. إذا عُدلت الملفات منذ تصدير em-students-before-v3.zip، راجع تلك التعديلات قبل الاستبدال.
قرار التركيب المباشر لا يغيّر حدود الاختبارات المحلية المذكورة أدناه؛ تجربة الاستضافة تبقى بعد التركيب.

## تجربة القبول

- تسجيل تلميذ تجريبي: 3700 تكوين + 200 تسجيل، توصلنا بـ 3700 و200 ← الباقي 0، أخضر، توصيل واحد.
- توصلنا بـ 800 و200 ← مجموع الأداء 1000، الباقي 2900، أصفر. أضف دفعة تكوين 2900 ← يصبح خالصاً أخضر ويخرج من أصحاب الباقي.
- أداء 0 ← أحمر، لا ينشأ توصيل.
- تحقق من ظهور كل دفعة بتاريخها ومبلغها وتوصيلها في السجل.
- ادخل بحساب كاتبة تجريبية: صحح الاسم وصورة تلميذ في فرعها، وتأكد من ظهورهما بعد الحفظ. جرب إبقاء الصورة فارغة للتأكد من بقائها.
- راجع عدم ظهور بيانات فرع آخر. لا تستخدم تلاميذ حقيقيين لاختبار إنشاء أداء جديد.

## الاختبارات وحدود التحقق

نجح فحص صياغة ملفات PHP التسعة.
نجحت 13 حالة لمنطق التسجيل والأداء: كامل وجزئي وبدون أداء، منع الزائد والسالب، دقة السنتيم، تراجع التسجيل مع فشل التوصيل، منع التكرار، التاريخ والفرع، وبقاء نموذج الأداء القديم يعمل.
نجحت 13 حالة للحالات وتصحيح الملف: صلاحية الكاتبة، حدود الفرع، عدم تغيير الصلاحيات والفرع وكلمة السر، تبديل الصورة، منع الهاتف المكرر، رفض الصيغة غير المصورة، منع الحفظ من نموذج قديم، تراجع التعديلات عند الفشل، منع الملفات المقفلة والمعطلة، وخروج الخالص وبقاء الجزئي من قائمة الباقي.
نجحت معاينة مكونات الواجهة في متصفح على عرض 360 و1280، مع تمييز الألوان وظهور منتقي الصور ودون تجاوز أفقي.
اختبارات PHP بقاعدة محاكاة؛ لم يتم اختبار قاعدة الاستضافة الحقيقية. اختبار المتصفح للمكونات فقط، وليس جلسة دخول كاملة على الاستضافة.
