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

apps/student_app/lib/main.dart

@@ -1,3 +1,16 @@
+/// ==============================================================================
+/// SAQEL ENTERPRISE (EDTECH 2.0) - FLUTTER APPLICATION ENTRY POINT
+/// ==============================================================================
+/// 
+/// ملف: main.dart
+/// الهدف المعماري:
+/// نقطة الدخول الرئيسية لتطبيق الطالب الموحد لمنصة صَقِل.
+/// يتولى هذا الملف:
+/// 1. تهيئة بيئة تشغيل فلاتر وتثبيت معايير التصميم العالمي (Cupertino Dark Aesthetic).
+/// 2. حقن وإدارة كافة الـ BLoC/Cubit Providers (المصادقة، المنهاج، المشغل، لوحة الطالب وولي الأمر).
+/// 3. التوجيه التلقائي بين شاشة تسجيل الدخول والشاشة الموحدة وفق حالة الجلسة.
+library;
+
 import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'core/config/app_config.dart';
@@ -10,11 +23,13 @@ import 'logic/cubits/video_playback_cubit.dart';
 import 'presentation/screens/auth/auth_screen.dart';
 import 'presentation/screens/home/unified_home_screen.dart';
 
+/// نقطة انطلاق التطبيق الرئيسية
 void main() {
   WidgetsFlutterBinding.ensureInitialized();
   runApp(const SaqelAppRoot());
 }
 
+/// الودجت الجذرية للتطبيق (Root Widget) المحتوية على المزودات وإعدادات الثيم والاتجاه العربي
 class SaqelAppRoot extends StatefulWidget {
   const SaqelAppRoot({super.key});