منصة مستر بيولوجي التعليمية – نظام باك إند متكامل مكوّن من 95 API يغطي جميع وظائف المنصة التعليمية.

Back-End السبت 15 مارس 2025

وصف المشروع

منصة Mr Biology التعليمية هي منصة إلكترونية متخصصة في تقديم المحتوى التعليمي لمادة الأحياء، تم تصميمها لتوفير تجربة تعليمية متكاملة للطلاب والمعلمين، مع نظام إداري احترافي يتيح التحكم الكامل في جميع جوانب العملية التعليمية.

نظام الواجهات البرمجية (APIs):
تم تطوير أكثر من 95 واجهة برمجة تطبيقات (API) متكاملة تغطي جميع جوانب النظام الأساسية، وتشمل تسجيل الطلاب وإدارة حساباتهم ونظام حماية الأجهزة، إدارة الكورسات والمحاضرات ونظام المجلدات وترتيب المحتوى، إنشاء الاختبارات والواجبات، تتبع التقدم الدراسي للطلاب، إدارة الاشتراكات والمدفوعات وأكواد الخصم، بالإضافة إلى واجهات مخصصة للعمليات الإدارية ومتابعة الأداء العام للمنصة.

ميزات واجهة الطالب:

- القسم الرئيسي - لوحة المعلومات:
- عرض عدد الكورسات الإجمالي المتاح على المنصة.
- عرض عدد الكورسات المملوكة للطالب والمشترك فيها.
- عرض عدد المحاضرات المشاهدة من قبل الطالب.
- عرض كود المجموعة التي ينتمي إليها الطالب.
- عرض الكورسات المضافة حديثاً للمنصة لمتابعة المحتوى الجديد.

- قسم تسجيل الدخول وحماية الحساب - نظام الجهازين (Two-Device Security System):
- نظام أمني مخصص يتم تفعيله في الفترات الحساسة من العام الدراسي، وعلى رأسها فترة المراجعات النهائية قبل امتحانات الثانوية العامة الرسمية، حيث تحتوي هذه الفترة على مراجعات وكورسات مصيرية للطالب، مما يستوجب حماية مضاعفة لحسابه من أي استخدام أو مشاركة غير مصرح بها.
- ربط حساب الطالب بجهازين فقط كحد أقصى، يقوم الطالب باختيار نوعيهما بنفسه عند أول استخدام من بين ثلاثة أنواع مدعومة: (mobile، tablet، computer)، على أن يكون الجهاز الحالي الذي يقوم بالإعداد أحد هذين النوعين إلزامياً.
- منع مشاركة حساب الطالب مع أي طالب آخر بشكل كامل، بحيث يصبح كل حساب مقيداً فعلياً بجهازي صاحبه فقط، ولا يمكن الدخول من أي جهاز ثالث أو من أي حساب آخر يفوق العدد المسموح به.
- عند محاولة الدخول من جهاز جديد غير مسجل، يتم تسجيل طلب انتظار موافقة تلقائياً، ولا يستطيع الطالب استخدام الجهاز الجديد إلا بعد مراجعة الإدارة والموافقة عليه يدوياً، لضمان تحكم كامل من الإدارة في كل عملية ربط جهاز جديد بأي حساب.
- عند الوصول للحد الأقصى من الأجهزة المسجلة (جهازين)، يتم إيقاف تسجيل أي جهاز إضافي تلقائياً، ولا يمكن إضافة جهاز ثالث إلا بعد تواصل الطالب مع الإدارة لحذف أحد الجلسات المسجلة له مسبقاً.
- كل جهاز مسجل يتم تتبعه بشكل مستقل ودقيق، من حيث نوعه وحالة اعتماده وآخر نشاط له، لضمان رقابة كاملة من الإدارة على كل عملية دخول من كل جهاز.
- إمكانية إيقاف نظام الجهازين وإعادة تفعيله بالكامل حسب الحاجة الموسمية للمنصة، مع الحفاظ الكامل على بيانات الطلاب والاشتراكات دون أي تأثير، بحيث يمكن العودة لنظام تسجيل الدخول التقليدي البسيط خارج فترات المراجعات المصيرية.

- قسم كورساتي - المحتوى الدراسي الخاص:
- استعراض جميع الكورسات المشترك فيها الطالب بشكل منظم.
- استعراض جميع المحاضرات المشترك فيها بشكل منفصل.
- مشاهدة المحاضرات بجودات متعددة للفيديو تشمل (240p، 360p، 480p، 720p، 1080p) لتناسب سرعة الإنترنت المتاحة.
- عرض المرفقات التعليمية بصيغة PDF الخاصة بكل محاضرة للمراجعة والدراسة.
- إمكانية تحميل المرفقات للاستخدام دون اتصال بالإنترنت.
- استعراض الكورسات المقسمة بنظام المجلدات (Folders) بحيث يتصفح الطالب الكورس عبر مجلدات منظمة (فصول أو أبواب)، ويرى كل مجلد بمحاضراته الخاصة به بشكل منفصل ومرتب.
- ظهور المحاضرات دائماً بنفس ترتيبها المحدد من الإدارة (Sort Order) سواء داخل الكورس مباشرة أو داخل كل مجلد على حدة، لضمان تسلسل دراسي منطقي ومتناسق للطالب.

- قسم الكورسات المدفوعة:
- عرض جميع الكورسات المدفوعة المتوفرة على المنصة.
- استعراض تفاصيل كل كورس مدفوع قبل الاشتراك.
- إمكانية الاشتراك في الكورسات المدفوعة مباشرة عبر بوابة الدفع الإلكتروني.
- عرض السعر والمحتوى التعليمي لكل كورس بشكل واضح.
- إمكانية استخدام كود خصم أثناء الاشتراك في الكورس، مع تحقق فوري من صلاحية الكود وحالته قبل إتمام عملية الدفع.

- قسم الكورسات المجانية:
- عرض جميع الكورسات المجانية المتاحة للطلاب.
- إمكانية الاشتراك المباشر في الكورسات المجانية دون الحاجة للدفع.
- استعراض محتوى الكورسات المجانية بالكامل.

- قسم الاختبارات - نظام التقييم الشامل:
- عرض جميع الاختبارات المتاحة للطالب والمرتبطة بكورساته.
- عرض الاختبارات السابقة مع النتائج التفصيلية.
- عرض نتيجة كل اختبار بشكل دقيق مع الدرجة الكلية والنسبة المئوية.
- إمكانية أداء الاختبارات الجديدة ضمن الوقت المحدد.
- عرض الاختبار بشكل كامل مع جميع الأسئلة واختياراتها.
- دعم الأسئلة النصية والأسئلة بالصور لتنوع أساليب التقييم.
- عرض الإجابات الصحيحة والخاطئة بعد إنهاء الاختبار.

- قسم الواجبات - متابعة الواجبات المطلوبة:
- عرض جميع الواجبات المطلوبة من الطالب.
- عرض الواجبات المكتملة مع النتائج والدرجات الحاصل عليها.
- عرض الواجبات غير المكتملة مع إمكانية تسليمها.
- إمكانية رفع الواجبات بصيغ مختلفة وتسليمها إلكترونياً.
- عرض تاريخ التسليم النهائي لكل واجب لضمان الالتزام بالمواعيد.
- عرض ملف الواجب PDF الخاص بكل واجب مطلوب.

- قسم الحصص المباشرة (Live Sessions):
- عرض جميع الحصص المباشرة المجدولة من قبل المشرفين.
- عرض رابط الانضمام للحصة المباشرة في الوقت المحدد.
- عرض عنوان وتوقيت كل حصة مباشرة.
- إمكانية التفاعل المباشر مع المعلم خلال الحصص.

ميزات لوحة تحكم الإدارة - نظام إداري متكامل:

- القسم الرئيسي - لوحة الإحصائيات الشاملة:
- عرض عدد الطلاب الإجمالي المسجلين على المنصة.
- عرض عدد طلاب الأونلاين (Online) المسجلين ضمن المجموعات الفعلية.
- عرض عدد طلاب السنتر المسجلين ضمن المجموعات الفعلية.
- عرض عدد الكورسات الإجمالي على المنصة.
- عرض عدد الكورسات المفعلة والمتاحة للطلاب.
- عرض عدد الكورسات غير المفعلة والتي قيد التجهيز.
- عرض عدد عمليات الشراء المكتملة بنجاح.
- عرض عدد عمليات الشراء غير المكتملة أو المعلقة.
- عرض طلبات الانضمام للمنصة من الطلاب الجدد.
- عرض الأرباح المدفوعة المحصلة من المبيعات.
- عرض الأرباح غير المدفوعة أو قيد المراجعة.

- قسم المستخدمين (الطلاب) - إدارة شاملة:
- عرض جميع الطلاب المسجلين بشكل منظم وتفصيلي.
- فلترة الطلاب حسب رقم الهاتف، الحالة (الكل، Online، السنتر).
- عرض بيانات كل طالب كاملة تشمل الاسم، رقم الهاتف، المجموعة، الكورسات المشترك فيها.
- تحكم كامل CRUD (عرض، إضافة، تعديل، حذف) لحسابات الطلاب.
- قسم خاص لـ عرض بيانات الطالب التفصيلية كاملة.
- قسم لـ تعديل بيانات الطالب وتحديث معلوماته.
- إمكانية التحكم في حساب الطالب بشكل متكامل (تفعيل، تعطيل، إعادة تعيين كلمة المرور).

- قسم إدارة أجهزة الطلاب - التحكم في نظام الجهازين:
- عرض جميع طلبات الأجهزة الجديدة المعلقة (Pending Requests) في مكان واحد، مع بيانات كل طالب صاحب الطلب (الاسم، رقم الهاتف)، ونوع الجهاز، ورمز الجهاز، وآخر نشاط، وتاريخ إرسال الطلب.
- إمكانية الموافقة على أي جهاز جديد بضغطة واحدة فور التأكد من هوية الطالب، ليتمكن الطالب فوراً من استخدام الجهاز في تسجيل الدخول.
- إمكانية حذف أي جلسة جهاز مسجلة لأي طالب في أي وقت، سواء لجهاز غير معتمد بعد أو جهاز كان معتمداً مسبقاً، مما يفتح المجال لتسجيل جهاز بديل بدلاً منه فوراً.
- عرض جميع الأجهزة المسجلة لطالب معين بشكل تفصيلي عبر البحث بكود الطالب، مع بيانات كل جهاز على حدة (النوع، الرمز، حالة الاعتماد، آخر نشاط، تاريخ التسجيل).
- عرض إحصائية عدد الطلاب الذين قاموا بإعداد أجهزتهم ضمن لوحة الإحصائيات الرئيسية للإدارة.

- قسم المسؤولين - إدارة الصلاحيات:
- عرض جميع المسؤولين على المنصة.
- عرض تفاصيل كل مسؤول ودوره (سوبر أدمن، أدمن، مصحح).
- تحكم كامل CRUD (عرض، إضافة، تعديل، حذف) للمسؤولين.
- قسم خاص لـ إضافة مسؤول جديد مع تحديد الاسم، رقم الهاتف، كلمة المرور، ونوع الحساب.
- تحديد صلاحيات كل مسؤول بدقة حسب دوره.

- قسم الكورسات - إدارة المحتوى التعليمي:
- عرض جميع كورسات المنصة بشكل منظم.
- عرض تفاصيل كل كورس تشمل الاسم، الوصف، النوع (مجاني أو مدفوع)، الحالة (مفعل أو غير مفعل).
- عرض عدد الطلاب المشتركين في كل كورس.
- زر للانتقال لمحاضرات الكورس مباشرة لسهولة الوصول.
- فلترة الكورسات حسب (الكل، مفعل، غير مفعل).
- تحكم كامل CRUD (عرض، إضافة، تعديل، حذف) للكورسات.
- قسم خاص لـ إضافة كورس جديد مع تحديد اسم الكورس، الوصف، الحالة، النوع، وصورة الكورس.
- قسم خاص لـ عرض الطلاب المشتركين في كل كورس بشكل محدد.
- نظام مجلدات كامل للكورسات (Course Folders System): إمكانية تفعيل نظام المجلدات لأي كورس عند الإضافة أو التعديل، بحيث يتم تقسيم محتوى الكورس إلى مجلدات (فصول/أبواب) بدلاً من عرض المحاضرات مباشرة.
- إضافة عدد غير محدود من المجلدات لكل كورس، مع إمكانية إعادة تسميتها أو حذفها أو إضافة مجلدات جديدة في أي وقت.
- حماية كاملة من فقدان البيانات: عند إلغاء تفعيل نظام المجلدات لكورس معين، يتم إخفاء المجلدات فقط دون حذفها، وتعود بكامل بياناتها فور إعادة التفعيل مرة أخرى.
- منع حذف أي مجلد يحتوي على محاضرات إلا بعد نقل هذه المحاضرات لمجلد آخر أو حذفها أولاً، لضمان عدم فقدان أي محتوى تعليمي بالخطأ.
- عند حذف الكورس بالكامل، يتم حذف جميع مجلداته ومحاضراته المرتبطة به تلقائياً (Cascade Delete).

- قسم المحاضرات - إدارة دقيقة للمحتوى:
- عرض جميع محاضرات الكورس المحدد، سواء بشكل مباشر أو مقسمة حسب المجلدات حال تفعيلها.
- عرض تفاصيل كل محاضرة كاملة تشمل الاسم، الوصف، السعر، الحالة (مفعلة أو غير مفعلة).
- تحكم كامل CRUD (عرض، إضافة، تعديل، حذف) للمحاضرات.
- قسم خاص لـ إضافة محاضرة جديدة مع تحديد:
- اسم المحاضرة.
- وصف المحاضرة التفصيلي.
- السعر (0 للمحاضرات المجانية، أعلى من 0 للمدفوعة).
- صورة المحاضرة.
- فيديو المحاضرة عبر سيرفر خارجي مشفر لمنع التحميل غير المصرح به.
- جودات الفيديو المتعددة (240p، 360p، 480p، 720p، 1080p).
- حالة المحاضرة (مفعلة، غير مفعلة).
- المرفقات التعليمية بصيغة PDF لدعم المحاضرة.
- المجلد التابعة له المحاضرة تلقائياً حال كان الكورس يستخدم نظام المجلدات، مع منع إضافة محاضرات مباشرة داخل كورس مفعّل عليه المجلدات.
- قسم خاص لـ عرض الطلاب المشتركين في كل محاضرة بشكل محدد.
- إمكانية نقل أي محاضرة بين المجلدات داخل نفس الكورس بسهولة من خلال قسم تعديل المحاضرة، دون التأثير على باقي بيانات المحاضرة.
- نظام ترتيب المحاضرات (Sort Order System):
- كل محاضرة تمتلك ترتيباً مستقلاً داخل مكانها فقط (داخل الكورس مباشرة إن لم يكن به مجلدات، أو داخل المجلد التابعة له إن كان الكورس يستخدم نظام المجلدات)، بحيث لا يؤثر ترتيب كورس أو مجلد على أي كورس أو مجلد آخر.
- أزرار تحريك سريعة (Up / Down) بجانب كل محاضرة لإعادة ترتيبها بسهولة تامة، مع تبديل فوري لترتيبها مع المحاضرة السابقة أو التالية مباشرة.
- المحاضرات الجديدة تحصل تلقائياً على آخر ترتيب متاح داخل مكانها عند إضافتها، دون الحاجة لأي تدخل يدوي من الإدارة.
- عند ترقية النظام تم الحفاظ الكامل على ترتيب جميع المحاضرات الموجودة مسبقاً دون أي تغيير أو تحريك، لضمان استمرارية تجربة الطالب دون أي إزعاج.

- قسم الاختبارات - نظام تقييم احترافي:
- عرض جميع الاختبارات على المنصة.
- تحكم كامل CRUD (عرض، إضافة، تعديل، حذف) للاختبارات.
- قسم خاص لـ إضافة اختبار جديد مع تحديد:
- عنوان الاختبار.
- الكورس المرتبط بالاختبار.
- تاريخ البداية للاختبار.
- تاريخ الإغلاق للاختبار.
- الدرجة لكل سؤال.
- مدة الاختبار بالدقائق.
- قسم خاص لـ إضافة أسئلة الاختبار بشكل متكامل مع تحكم كامل CRUD للأسئلة.
- دعم الأسئلة النصية والأسئلة بالصور.
- تحديد الإجابات الصحيحة لكل سؤال.
- إضافة اختيارات متعددة لكل سؤال.

- قسم الواجبات - إدارة الواجبات المطلوبة:
- عرض جميع الواجبات على المنصة.
- تحكم كامل CRUD (عرض، إضافة، تعديل، حذف) للواجبات.
- قسم خاص لـ إضافة واجب جديد مع تحديد:
- عنوان الواجب.
- ملف الواجب بصيغة PDF.
- الدرجة الكلية للواجب.
- تاريخ الإغلاق للتسليم.
- المجموعة المرتبطة بالواجب.
- قسم خاص لـ الاطلاع على الطلاب الذين قاموا بتسليم الواجب.
- إمكانية تقييم الواجبات المسلمة ومنح الدرجات.

- قسم الحصص المباشرة (Live Sessions) - إدارة الحصص:
- عرض جميع الحصص المباشرة المجدولة.
- تحكم كامل CRUD (عرض، إضافة، تعديل، حذف) للحصص المباشرة.
- قسم خاص لـ إضافة حصة مباشرة جديدة مع تحديد:
- عنوان الحصة.
- رابط الحصة المباشرة (Live Link).
- تاريخ ووقت الحصة.

- قسم المجموعات - تنظيم الطلاب:
- عرض جميع المجموعات على المنصة.
- تحكم كامل CRUD (عرض، إضافة، تعديل، حذف) للمجموعات.
- قسم خاص لـ إضافة مجموعة جديدة مع تحديد:
- اسم المجموعة.
- نوع المجموعة (أونلاين أو سنتر).
- كود المجموعة الخاص.

- قسم المدفوعات - متابعة العمليات المالية:
- عرض جميع المدفوعات التي تمت على المنصة.
- عرض تفاصيل كل عملية دفع تشمل:
- اسم الطالب صاحب العملية.
- المحتوى المشترك فيه (كورس أو محاضرة).
- السعر المدفوع.
- حالة الدفع (مكتمل أو غير مكتمل).
- تاريخ ووقت العملية.
- تحكم كامل في البحث والفلترة للعمليات المالية.
- إمكانية حذف العمليات عند الحاجة.

- قسم طلبات الانضمام - إدارة الطلبات الجديدة:
- عرض جميع طلبات الانضمام من الطلاب الجدد.
- عرض بيانات الطالب صاحب الطلب كاملة.
- عرض تاريخ تقديم الطلب.
- تحكم كامل في الفلترة للطلبات.
- إمكانية قبول الطلب وإنشاء حساب للطالب.
- إمكانية رفض الطلب مع إشعار الطالب.

- قسم أكواد الخصم - نظام كوبونات متكامل:
- إمكانية إنشاء عمليات توليد أكواد خصم بشكل جماعي (Bulk Generation)، بتحديد عدد الأكواد المطلوب توليدها دفعة واحدة، مع توليد كود عشوائي فريد لكل كوبون تلقائياً.
- عرض جميع عمليات توليد الأكواد السابقة، مع إحصائية دقيقة لكل عملية توضح عدد الأكواد الكلي، عدد الأكواد المستخدمة، وعدد الأكواد المتبقية.
- عرض تفاصيل كل كود على حدة داخل أي عملية، تشمل حالة الكود (مستخدم أو غير مستخدم)، وفي حال الاستخدام: بيانات الطالب الذي استخدمه، الكورس الذي تم تطبيق الخصم عليه، وتاريخ الاستخدام بالتفصيل.
- إمكانية تصدير أكواد أي عملية بصيغة CSV لتسهيل طباعتها أو توزيعها أو أرشفتها خارج النظام.
- إمكانية حذف كود خصم واحد بشكل منفرد عند الحاجة.
- إمكانية حذف عملية توليد كاملة بكل ما تتضمنه من أكواد واستخدامات مرتبطة بها دفعة واحدة (Cascade Delete).
- الأكواد مرتبطة حصرياً بالاشتراك في الكورسات فقط، مع تحقق فوري وقت استخدام الطالب للكود من صلاحيته وعدم تكرار استخدامه من نفس الطالب.

البنية التقنية والمنهجية:
- النظام مبني على هيكلية منظمة وقابلة للتوسع (Scalable Architecture) لضمان سهولة التطوير المستقبلي وإضافة ميزات جديدة.
- دعم أفضل ممارسات الأمان في حفظ البيانات الحساسة مثل كلمات المرور والمعلومات الشخصية.
- جميع العمليات قائمة على واجهات برمجية حديثة (RESTful APIs) تتيح التواصل السلس بين الواجهة الأمامية ولوحة الإدارة.
- النظام يعتمد على هيكل بيانات منظم يربط بين المستخدمين، الكورسات، المجلدات، المحاضرات، الاختبارات، الواجبات، المدفوعات، وأكواد الخصم لضمان دقة البيانات وتكاملها.
- إمكانية التكامل مع الخدمات الخارجية مثل بوابات الدفع وأنظمة تشفير الفيديو لتوفير تجربة مستخدم متكاملة وآمنة.
- البنية التقنية تدعم التحقق من صحة البيانات بشكل لحظي وتقديم استجابات بصيغة JSON لتسهيل التكامل مع أي واجهات خارجية مستقبلية.
- دعم نظام الأدوار والصلاحيات (Role-Based Access Control) لتحديد صلاحيات كل مسؤول بدقة.
- استخدام سيرفر خارجي لتشفير الفيديو لحماية المحتوى التعليمي ومنع التحميل أو القرصنة.
- تنفيذ جميع التحديثات والإضافات الجديدة (نظام المجلدات، نظام الترتيب، نظام أكواد الخصم) مع الحفاظ الكامل على التوافق العكسي (Backward Compatibility) وعدم التأثير على أي بيانات أو كورسات أو محاضرات كانت موجودة بالفعل على النظام قبل التطوير.
- طبقة تحقق مركزية موحدة (Centralized Authentication Layer) مسؤولة عن جميع عمليات المصادقة الخاصة بالطلاب داخل المنصة، بحيث يمكن التبديل بين أكثر من نظام حماية مختلف (نظام التوكن التقليدي المعتمد على انتهاء الصلاحية، أو نظام الجهازين الأمني) من مكان واحد فقط دون التأثير على باقي أجزاء المشروع.
- إمكانية التبديل الكامل بين أنظمة الحماية (تفعيل نظام الجهازين أو العودة للنظام التقليدي) بأقل قدر ممكن من التعديلات، عبر تغيير قيمة متغير واحد داخل طبقة التحقق المركزية، مما يجعل تفعيل الحماية الموسمية في فترات الامتحانات الرسمية أمراً سريعاً وآمناً ولا يؤثر على استقرار باقي أجزاء المنصة.

الفكرة الأساسية:
منصة Mr Biology التعليمية تهدف إلى تقديم تجربة تعليمية متكاملة ومتطورة لطلاب الأحياء، مع توفير أدوات إدارة احترافية للمشرفين والمعلمين، وتجربة مستخدم سلسة وآمنة للطلاب، مما يجعلها منصة تعليمية رقمية متكاملة تجمع بين المحتوى التعليمي عالي الجودة ونظام إداري محترف.

الربط الخارجي والتكامل:
- بوابة الدفع: المدفوعات مربوطة ببوابة الدفع فواتيرك (Fawaterak) لتسهيل عمليات الدفع الإلكتروني بشكل آمن وسلس، مع دعم جميع وسائل الدفع الإلكترونية المتاحة، ودعم تطبيق أكواد الخصم أثناء عملية الدفع.
- حماية الفيديو: جميع فيديوهات المحاضرات مستضافة على سيرفر خارجي متخصص في تشفير الفيديو لضمان عدم إمكانية التحميل غير المصرح به وحماية حقوق الملكية الفكرية للمحتوى التعليمي.

التقنيات المستخدمة

PHP NativeMySQLRESTful APIsJson
mr-biology.com