leaders

نظام "رصد" لإدارة مخالفات وملاحظات الطلاب بالـ QR (React + Supabase)

الوصف:

نظام ويب (Mobile-First) لإدارة السلوك والمخالفات المدرسية، يستخدمه المشرفون (Leaders) لتسجيل مخالفات وملاحظات الطلاب بسرعة من الموبايل، وتستخدمه الإدارة للمراجعة والاعتماد ومتابعة كل طالب والتقارير. يدعم النظام مسح كود QR الخاص بالطالب للوصول الفوري لملفه، وتصدير البيانات إلى Excel، ويعمل كتطبيق PWA قابل للتثبيت مع شاشة ترحيب وتنبيه عدم الاتصال. الصلاحيات مضبوطة على مستوى قاعدة البيانات (Row Level Security) بحيث يرى المشرف ما يخصه وترى الإدارة كل شيء.

أهم المميزات:

- دور المشرف (Leader): تسجيل مخالفة/ملاحظة جديدة، مسح QR للطالب، عرض الطلاب وملف كل طالب ومخالفاته.

- دور الإدارة (Admin): مراجعة واعتماد المخالفات، إدارة الطلاب، التقارير والإحصائيات، التصدير إلى Excel/CSV.

- بطاقات QR للطلاب (عرض + مسح بكاميرا الموبايل).

- إشعارات فورية داخل التطبيق + شاشة تحميل + دعم العمل دون اتصال (تنبيه + تخزين مؤقت).

- تحميل كسول للصفحات (Lazy Loading) لسرعة الفتح على شبكات المدارس الضعيفة.

- واجهة عربية RTL كاملة بخط Cairo + شريط علوي وسفلي وزر إضافة سريع (FAB) مناسب للموبايل.

التقنيات والأدوات المستخدمة:

React 18 + Vite 6 + React Router 6 — Supabase (PostgreSQL + Auth + RLS) — qrcode.react لعرض الأكواد + jsqr للمسح — xlsx للتصدير إلى Excel — vite-plugin-pwa — lucide-react — واجهة Mobile-First عربية RTL.

دوري في تنفيذ المشروع:

تصميم وتطوير النظام بالكامل: الواجهات العشر (تسجيل الدخول، الرئيسية، إضافة مخالفة، الطلاب، ملف الطالب، المخالفات، تفاصيل المخالفة، التقارير، المسح، الجدول)، مخطط قاعدة البيانات وسياسات RLS وملفات التأسيس (schema + seed)، تكامل QR، والتصدير إلى Excel.

ملاحظات مهمة للعميل:

- المشروع أصلي ومنفذ فعليًا ومربوط بقاعدة بيانات مدرسية حقيقية، لذلك لقطة الشاشة المرفقة لصفحة الدخول فقط حفاظًا على خصوصية بيانات الطلاب.

- لا يوجد رابط معاينة عام — يمكن عرض نسخة حية (Demo) ببيانات تجريبية عند الطلب الجاد.