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,18 @@
+/// ==============================================================================
+/// SAQEL ENTERPRISE (EDTECH 2.0) - SOCRATIC VIDEO PLAYER SCREEN
+/// ==============================================================================
+/// 
+/// ملف: socratic_video_player_screen.dart
+/// الهدف المعماري:
+/// مشغل الفيديو السقراطي الذكي والمحمي في تطبيق صَقِل:
+/// 1. تشغيل الفيديو الرقمي وبث HLS عبر مشغل مخصص عالي الأداء.
+/// 2. حماية الملكية الفكرية بعلامة مائية متحركة ديناميكية (Dynamic Anti-Piracy Watermark).
+/// 3. محاذاة نقاط التقدم اللمسية مع نقاط الفحص السقراطي الزمني (Socratic Checkpoints).
+/// 4. تجميد الفيديو وإظهار نافذة الفحص السقراطي عند وصول المؤشر لنقطة الفحص.
+/// 5. تفعيل الإرجاع العلاجي (Rewind Remediation) عند الإجابة الخاطئة لترسيخ الفهم.
+/// 6. إبراز شارة المعلم المختار (شرح الذكاء الاصطناعي أو المعلم المعتمد).
+library;
+
 import 'dart:async';
 import 'package:flutter/cupertino.dart';
 import 'package:flutter/material.dart';
@@ -12,6 +27,7 @@ import '../../widgets/luxury_widgets.dart';
 import '../../widgets/socratic_dialog.dart';
 import 'package:video_player/video_player.dart';

+/// مشغل الفيديو السقراطي الذكي ونقاط الفحص والإرجاع العلاجي
 class SocraticVideoPlayerScreen extends StatefulWidget {
  final CurriculumLessonItemModel lesson;
  final SubjectModel? subject;