تطوير موقع استعلام مستوى الطالب مع استضافة داخل السعودية وربط مباشر بـ Sheets

لدينا ملف Google Sheets يحوي بيانات الطلاب ودرجاتهم وملاحظات صفّية. النظام الحالي مبني عبر Google Apps Script مع واجهة HTML بسيطة. المطلوب تحويله إلى موقع ويب للعرض فقط (دون تعديل درجات)، مستضاف داخل السعودية، مع إبقاء Google Sheets مصدر البيانات. يدخل وليّ الأمر/الطالب الرقم الأكاديمي فتُعرَض خلاصة المستوى مع مخططات مقارنة بمتوسط الشعبة.

2) الواجهة الرئيسة (للاستعلام)

واجهة عربية RTL لصفحة استعلام بسيطة تتضمّن:

حقل إدخال الرقم الأكاديمي لعرض:

بيانات الطالب الأساسية: (الاسم، الشعبة، الرقم الأكاديمي).

درجات مختارة: (السلوك العام، الغياب، المشاركة، المشاريع، الاختبارات… إلخ).

الملاحظات الصفّية الموجودة في Google Sheets.

رسوم بيانية مختصرة:

أعمدة لمقارنة الطالب بمتوسط الشعبة.

خطية لتتبّع تقدّم “قراءة” الطالب خلال فترة زمنية.

3) مصادر البيانات وخرائط الأعمدة

الدرجات والمكوّنات: المشاركة، المشاريع، الواجبات، الاختبارات، الاستماع، متوسط الفترة، أعلى درجة.

تُضبط الخرائط بدقّة حسب أعمدة الشيت، مع إمكانيّة تعديلها من صفحة الأدمن.

4) الصفحات المطلوبة

صفحة وليّ الأمر/الطالب: عرض بيانات الطالب بعد إدخال الرقم الأكاديمي.

صفحة الإحصاءات للموجّه الطلابي/مدير المدرسة/الوكيل (دخولهم برقم الهوية مثل الطالب):

أمثلة الإحصاءات: الطلاب ذوو الدرجات المتدنية (من الصفر فأعلى)، الطلاب المتميّزون، الطلاب غير المؤدّين للواجبات/المشاريع/القراءة.

صفحة الأدمن (للمعلّم): كل ما يتوفر في صفحات المستخدمين بالإضافة إلى إمكانية تعديل مسمّيات الحقول وخريطة الأعمدة و إدارة الإعدادات العامّة.

5) رسائل أولياء الأمور

حقل نصّي يكتب فيه وليّ الأمر رسالة للمعلم.

تُعرَض في صفحة المعلّم مرفقةً بـ: اسم الطالب، رقم هويته، صفّه، الطابع الزمني.

6) متطلبات تفضَّل مراعاتها (أمن/موثوقية/إدارة)

تأمين الواجهة وواجهات الـAPI: تقييد CORS على النطاق، Rate Limiting، اجتياز اختبار ضغط بسيط.

سجل تدقيق (Audit Log) غير قابل للتلاعب: تسجيل كل استعلام مع الوقت والمصدر، ولوحة لاستعراض السجل ضمن مدة محدّدة، مع تصدير إلى Excel/CSV.

نسخ احتياطي تلقائي: لقطات دوريّة من البيانات المعروضة وملفّات الإعداد، مع خطة استرجاع.

واجهة الطالب: زر طباعة/تصدير PDF ملائم لـ A4 مع رمز QR للتحقّق يعرض بيانات الطالب ووقت الإصدار.

لوحة تحكّم إداريّة: إحصاءات الاستخدام (استعلامات اليوم/الأسبوع)، أكثر الشعب بحثًا، أخطاء الخادم، مخزون الكاش.

كشف تجميعي: عرض مجموع درجات كل طالب في كل أداة تقييم في صفحة المعلّم والموجّه ومدير المدرسة والوكيل.

7) الكاش والمزامنة (Caching & Sync)

زر تحديث الكاش الآن مع عرض آخر تحديث.

سياسة كاش: وقت صلاحية (TTL) بالدقائق، تمكين/تعطيل.

جدولة مزامنة اختيارية: كل X دقائق/ساعات (للتحضير لقراءة محليّة مستقبلًا).

قائمة لقطات: حفظ لقطة JSON/CSV لنتيجة القراءة مع زر تنزيل.

8) جودة البيانات (Data Quality)

فحوصات تلقائية:

أرقام أكاديميّة مكرّرة.

خلايا حرجة فارغة (الاسم/الصف/الرقم).

قيم خارج النطاق (مثل درجة > 100).

تقارير قابلة للتنزيل: ملف CSV بأخطاء الجودة لإصلاحها في الشيت.

مقارنة التبويبات: التحقّق من وجود الرقم الأكاديمي في التبويب الرئيس و”كشف المتابعة”.

9) التقارير والطباعة

تقرير قابل للطباعة للطالب (A4 + QR). للتحقّق يعرض بيانات الطالب نفسها ووقت الإصدار

تقرير إحصائي للمعلّم/الموجّه/الوكيل.

كشف درجات تجميعي لكل الطلاب في صفحة واحدة مع إمكانيّة تصديره إلى Excel.

تقرير تحليل مستويات وإحصاءات على مستوى الطالب وعلى مستوى جميع الطلاب (خاص بالمعلّم والموجّه والوكيل).

10) ما سيتوفّر للمطوّر

رابط الشيت وصلاحيّة القراءة/الكتابة لحساب الخدمة (Service Account).

ملفّات مرجعيّة: index.html, Code.gs للاسترشاد بالمنطق السابق.

نطاق واستضافة داخل السعودية (stc cloud).

الخلاصة:

تصميم 3 صفحات:

صفحة واحدة هي الأدمن للمعلم

صفحة واحدة لولي أمر الطالب لعرض البيانات و الطباعة فقط

صحفة واحدة تظهر للوكيل و مدير المدرسة و الموجه الطلابي