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,3 +1,17 @@
+/// ==============================================================================
+/// SAQEL ENTERPRISE (EDTECH 2.0) - ADAPTIVE EXAM SCREEN (CUPERTINO LUXURY UI)
+/// ==============================================================================
+/// 
+/// ملف: adaptive_exam_screen.dart
+/// الهدف المعماري:
+/// شاشة تقديم الامتحانات التكيفية بتصميم أبل كوبرتينو المظلم (Dark OLED Aesthetic):
+/// 1. مؤشر تقدم تفاعلي متزامن مع نسبة الإجابات المكتملة.
+/// 2. مؤقت تنازلي ذكي يتغير لونه إلى الأحمر عند اقتراب انتهاء الوقت.
+/// 3. بطاقات أسئلة لمسية فاخرة مع أزرار اختيار مشعة (Glowing Glassmorphic Radios).
+/// 4. شاشة عرض نتائج متقدمة تحتوي على: نسبة الإتقان، وسام الاجتياز، تقرير التشخيص بالذكاء الاصطناعي،
+///    وسوم نقاط الضعف، ومؤشر الجاهزية لامتحان التوجيهي.
+library;
+
 import 'package:flutter/cupertino.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
@@ -7,6 +21,7 @@ import '../../../core/utils/saqel_toast.dart';
 import '../../../logic/cubits/exam_cubit.dart';
 import '../../widgets/luxury_widgets.dart';

+/// الشاشة التكيفية لتقديم الامتحان واستقبال نتائج التصحيح اللحظية
 class AdaptiveExamScreen extends StatelessWidget {
  final int examId;
  final String title;