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,15 +1,31 @@
+/// ==============================================================================
+/// SAQEL ENTERPRISE (EDTECH 2.0) - ADAPTIVE EXAM STATE MANAGEMENT (CUBIT)
+/// ==============================================================================
+/// 
+/// ملف: exam_cubit.dart
+/// الهدف المعماري:
+/// إدارة حالة دورة حياة الامتحانات التكيفية والتشخيص الذكي في تطبيق الطالب:
+/// 1. جلب الامتحانات مباشرة من واجهات السيرفر (Pure API-Driven) دون أي بيانات أو أسئلة محلية ثابتة.
+/// 2. إدارة المؤقت التنازلي الذكي ومزامنة الوقت المتبقي.
+/// 3. إدارة التنقل بين الأسئلة وحفظ اختيارات الطالب وتحديد البدائل المحددة.
+/// 4. إرسال الإجابات إلى السيرفر لتصحيحها واستلام تقرير التشخيص السقراطي ومؤشر الجاهزية للتوجيهي.
+library;
+
 import 'dart:async';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import '../../data/models/exam_model.dart';
 import '../../data/repositories/app_repositories.dart';

+/// الحالات العامة للامتحان
 abstract class ExamState {}

+/// الحالة المبدئية قبل بدء التحميل
 class ExamInitial extends ExamState {}

+/// حالة انتظار جلب الأسئلة من السيرفر
 class ExamLoading extends ExamState {
  final String message;
-  ExamLoading({this.message = 'جاري تحضير الامتحان والأسئلة التكيفية...'});
+  ExamLoading({this.message = 'جاري تحضير الامتحان والأسئلة التكيفية من السيرفر...'});
 }

 class ExamLoaded extends ExamState {