Enrich full codebase with architectural Arabic docblocks and synchronize database_schema.sql with live database

2026-09-03 16:51:29 +03:00
parent 9624cfb4c8
commit 0a61e32033
16 changed files with 310 additions and 43 deletions
@@ -1,18 +1,26 @@
 <?php
+/**
+ * ==============================================================================
+ * SAQEL ENTERPRISE (EDTECH 2.0) - DYNAMIC CURRICULUM SERVICE
+ * ==============================================================================
+ * 
+ * ملف: CurriculumService.php
+ * الهدف المعماري:
+ * إدارة المنظومة الحية للمناهج والكتب الوزارية وشجرة الدروس (Zero Mock Data):
+ * 1. مسح وتوليد الشجرة الهرمية للمناهج من ملفات (manifest.json) وملفات الماركداون الحية.
+ * 2. البحث الدلالي اللحظي في عناوين الدروس ونتاجات التعلم والمفاهيم.
+ * 3. قراءة وحفظ وتحديث نصوص الماركداون للدروس والمصادر والملخصات.
+ * 4. الربط المرجعي بين شجرة المناهج وقاعدة بيانات الدورات والدروس والفيديوهات.
+ */

 namespace App\Services;

 use App\Core\Database;

-/**
- * 100% Live Dynamic Curriculum Service (Zero Fake Data)
- * Manages real uploaded textbook manifests and dynamic markdown files.
- */
 class CurriculumService
 {
    /**
-     * Stub for backwards compatibility with controllers calling ensureSchema.
-     * Curriculum is now file-based.
+     * التحقق التوافقي التلقائي من بنية قاعدة البيانات للمناهج
     */
    public static function ensureSchema(): void
    {