عن المشروع

CokieCollege هو حل شامل متعدد المنصات موجه للإدارة الأكاديمية والتأديبية والإدارية للمؤسسات التعليمية. يهدف إلى تسهيل التفاعل في الوقت الفعلي بين الإداريين ومنسقي المستويات والمعلمين والطلاب وموظفي الكافتيريا من خلال تطبيقات الويب والجوال. البنية ينظم النظام في وحدات منفصلة. الخادم الخلفي هو واجهة برمجة تطبيقات REST في Node.js مع Express 5.x يدير منطق الأعمال، والأمان باستخدام Helmet، وتحديد الطلبات، وضغط GZIP، والمصادقة الإدارية مع Supabase، والإشعارات الفورية عبر Expo Server SDK. تطبيق الجوال مطور باستخدام Expo 54 وExpo Router وi18next (الإسبانية والإنجليزية)، مع تصميم متكيف في الوضع الفاتح والداكن. تستخدم بوابة الويب React مع Vite للمراقبة والإدارة المؤسسية. كما تتضمن مجلدًا للنماذج الأولية البصرية وموارد التصميم. قاعدة البيانات هي Supabase PostgreSQL، مع سياسات Row Level Security والمصادقة والتخزين والمشغلات. الوظائف حسب الدور توفر وحدة الطلاب اليومية التربوية مع مراقبة الحضور وإشارة سلوك بأربعة ألوان، ووحدة تحكم الدرجات مع تفصيل نسبي حسب الأنشطة، وطلب التبريرات مع المرفقات في Supabase Storage، والطلب المسبق للغداء مع إنشاء رمز QR للاستلام والدفع. تتيح وحدة المعلمين إدخال وسجل الدرجات مع التحقق من 0.00 إلى 10.00 وعد تنازلي حسب الفترة، وتذاكر تمديد الموعد النهائي إلى المنسق، وتسجيل الحضور المباشر حسب الفصل والمادة. تشمل وحدة المنسقين والإداريين إدارة المستخدمين مع التصفية حسب الدور والترقيم، والموافقة على التبريرات مع مراجعة الأدلة، ونشر الإشعارات والأحداث المؤسسية حسب المستوى التعليمي، وتعيين الجداول والأقسام والفصول والعبء الأكاديمي. تتيح وحدة الكافتيريا نشر قائمة الطعام اليومية، وإدارة الطلبات بحالات (مطلوب، مُجهز، مُسلّم)، ومسح رموز QR لتأكيد تسليم الغداء. التشغيل يتطلب Node.js 18 أو أعلى، وExpo CLI، وحساب Supabase. يتم تشغيل نص SQL في محرر Supabase لتهيئة الجداول والأنواع المعددة والدوال والعروض وسياسات RLS. بعد ذلك يتم تثبيت وتشغيل الخادم الخلفي بإعداد ملف .env، ويبدأ تطبيق الجوال مع Expo. يتم تنفيذ بناء الجوال والتحديثات OTA باستخدام EAS. الأمان والأداء يمكّن المشروع Row Level Security في جداول Supabase، ويطبق حماية HTTP باستخدام helmet وexpress-rate-limit وضغط GZIP، ويتضمن فهارس قاعدة بيانات لتحسين الاستعلامات الثقيلة. يدعم التدويل للإسبانية والإنجليزية.