عن المشروع

هذا المستودع عبارة عن منصة إدارة مدرسية ذاتية الاستضافة لمدرسة واحدة لكل عملية نشر. وهي مبنية باستخدام Laravel 13 وPHP 8.3 وMySQL 8 وRedis 7، وتأتي مع حزمة Docker Compose (app وnginx وdb وredis وMinIO وHorizon وscheduler). واجهة الإدارة معروضة من الخادم باستخدام Laravel Blade وBootstrap 5. النطاق والوحدات: يصف ملف README 26 وحدة مجال مجمعة في المنصة الأساسية (المدرسة، السنوات الأكاديمية/الصفوف/الشعب/المواد/الجداول، المستخدمون والمصادقة)، دورة حياة الطالب (التسجيل، الترقية، التحويل، القبول عبر الإنترنت، استيراد البيانات)، الأكاديميات (الامتحانات، الدرجات، GPA/الجدولة، الشهادات، الحضور عبر RFID)، المالية (بنود الرسوم، المدفوعات عبر bKash/SSLCommerz/Stripe/PayPal، الشيكات، المبالغ المستردة، الرواتب، التقارير)، الاتصال (الإعلانات، إرسال دفعات SMS، سلاسل الرسائل)، والعمليات (الموظفون، الإجازات، المكتبة، النقل، بطاقات الهوية، LMS، نظام إدارة محتوى الموقع). توفر وحدة الترجمة ترجمات مخزنة في قاعدة البيانات مع دعم RTL. تشمل الأدوار المدير العام، والمدير، والمعلم، والمحاسب، وأمين المكتبة، وموظف الاستقبال، والطالب، وولي الأمر، مع بوابات منفصلة للإدارة والموظفين والطلاب/أولياء الأمور. يستخدم التفويض Spatie Laravel Permission لواجهة الويب ورموز Laravel Sanctum مع صلاحيات لواجهة API. ملاحظات معمارية: نمط وحدات موثق من 10 خطوات (migration وmodel وrepository وservice وobserver وrequests وresources وcontroller/routes وtests وstyle/docs)، ونمط مستودع مع تخزين مؤقت قائم على الوسوم يعمل أيضًا على مخازن تخزين مؤقت غير Redis، وكتابات مالية ملفوفة ضمن معاملات قاعدة البيانات، واستعلامات مقيدة بـ school_id. يذكر README أن هناك أكثر من 206 اختبار ميزة وأن PHPStan يعمل بالمستوى 5. النشر: بدء سريع عبر Docker مع بيانات اعتماد تجريبية مهيأة، بالإضافة إلى مسارات موثقة للاستضافة المشتركة cPanel وتثبيتات VPS التي ترجع إلى التخزين المؤقت/قوائم الانتظار/الجلسات المدعومة بقاعدة البيانات وتخزين الملفات المحلي. تُولَّد وثائق API باستخدام Scribe. يغطي الدعم متعدد الدول اللغة، والعملة، والمنطقة الزمنية، وأيام عطلة نهاية الأسبوع، وبوابات الدفع الخاصة بكل دولة، وعدة قوالب درجات (بنغلاديش 5.0، الولايات المتحدة 4.0، المملكة المتحدة 9-1، النسبة المئوية). يصف README المشروع بأنه جهد هواية/بحث وتطوير بُني بشكل كبير باستخدام وكيل برمجة ذكاء اصطناعي، ويؤطره صراحةً كساحة نماذج أولية وليس منتجًا خضع لضمان جودة احترافي. وهو مرخص بموجب AGPL-3.0، حيث يتطلب شرط الاستخدام عبر الشبكة نشر التعديلات عند تشغيله كخدمة شبكية.