ramedde commited on
Commit
d6dfe6b
·
verified ·
1 Parent(s): d893aee

Update app.py

Browse files
Files changed (1) hide show
  1. app.py +153 -867
app.py CHANGED
@@ -1,18 +1,23 @@
1
  """
2
  دورة القانون – Hugging Face Space
3
  النسخة العربية الكاملة
4
- Compatible avec le Docker HF (gradio 4.44.1 bundled + Python 3.13).
5
  TTS: Microsoft Edge Neural Voices (edge-tts) — صوت عربي طبيعي
 
 
6
  الأصوات المتاحة:
7
  ar-DZ-IsmaelNeural — رجل، لهجة جزائرية ✅ (موصى به)
8
  ar-DZ-AminaNeural — امرأة، لهجة جزائرية
9
  ar-SA-HamedNeural — رجل، فصحى سعودية
10
  ar-SA-ZariyahNeural — امرأة، فصحى سعودية
11
  ar-EG-SalmaNeural — امرأة، مصرية
 
12
  ar-MA-JamalNeural — رجل، مغربي
13
  """
14
- import os, json, time, tempfile, random, threading, glob, asyncio
15
  import sys
 
 
16
 
17
  try:
18
  import pyaudioop
@@ -34,698 +39,16 @@ try:
34
  except Exception:
35
  pass
36
 
37
- try:
38
- from llama_cpp import Llama
39
- _LLAMA_AVAILABLE = True
40
- except ImportError:
41
- _LLAMA_AVAILABLE = False
42
-
43
- # ── TTS: edge-tts (Microsoft Neural Arabic) ──────────────────────────────────
44
- try:
45
- import edge_tts
46
- _EDGE_TTS_AVAILABLE = True
47
- print("[law-app] edge-tts متاح ✅")
48
- except ImportError:
49
- _EDGE_TTS_AVAILABLE = False
50
- print("[law-app] edge-tts غير متاح — سيتم استخدام gTTS كبديل")
51
-
52
- # الصوت الافتراضي: جزائري — يمكنك تغييره من القائمة أعلاه
53
- DEFAULT_VOICE = "ar-DZ-IsmaelNeural"
54
-
55
- # معدل الكلام: -10% أبطأ قليلاً لوضوح أفضل في المحتوى القانوني
56
- DEFAULT_RATE = "-10%"
57
- DEFAULT_PITCH = "+0Hz"
58
-
59
- from huggingface_hub import hf_hub_download
60
-
61
- try:
62
- from llama_cpp import Llama
63
- _LLAMA_OK = True
64
- except ImportError:
65
- _LLAMA_OK = False
66
-
67
- # ── تحميل نموذج اللغة ────────────────────────────────────────────────────────
68
- _llm = None
69
- _llm_lock = threading.Lock()
70
-
71
- def download_model():
72
- model_path = "/app/model.gguf"
73
- if os.path.exists(model_path):
74
- print("[law-app] النموذج موجود مسبقاً.")
75
- return model_path
76
- print("[law-app] جارٍ تحميل النموذج...")
77
- try:
78
- path = hf_hub_download(
79
- repo_id="Qwen/Qwen2.5-0.5B-Instruct-GGUF",
80
- filename="qwen2.5-0.5b-instruct-q4_k_m.gguf",
81
- local_dir="/app",
82
- local_dir_use_symlinks=False,
83
- )
84
- if path != model_path:
85
- os.rename(path, model_path)
86
- print("[law-app] اكتمل التحميل.")
87
- return model_path
88
- except Exception as e:
89
- print(f"[law-app] خطأ في التحميل: {e}")
90
- return None
91
-
92
- def get_llm():
93
- global _llm
94
- if _llm is not None:
95
- return _llm
96
- if not _LLAMA_AVAILABLE:
97
- return None
98
- with _llm_lock:
99
- if _llm is not None:
100
- return _llm
101
- gguf_files = glob.glob("/app/*.gguf") + glob.glob("*.gguf")
102
- if not gguf_files:
103
- print("[law-app] لم يُعثر على ملف .gguf – الذكاء الاصطناعي معطّل.")
104
- return None
105
- model_path = gguf_files[0]
106
- print(f"[law-app] تحميل النموذج: {model_path}")
107
- _llm = Llama(model_path=model_path, n_ctx=512, n_threads=2,
108
- n_gpu_layers=int(os.getenv("N_GPU_LAYERS", "-1")), verbose=False)
109
- print("[law-app] النموذج جاهز.")
110
- return _llm
111
-
112
- # ── دروس القانون ─────────────────────────────────────────────────────────────
113
- LESSONS = [
114
- {
115
- "title": "الدرس الأول — المبادئ التوجيهية للإثبات والمحاكمة العادلة",
116
- "text": """
117
- بناءً على الفقه الجنائي الفرنسي، يرتكز الإطار العام للخصومة الجزائية على مبدأين أساسيين: المحاكمة العادلة وحرية الإثبات.
118
- الجزء الأول: الحق في محاكمة عادلة وقرينة البراءة.
119
- يُعتبر الحق في محاكمة عادلة حجر الزاوية في الإجراءات. هذا المبدأ يفرض توازناً بين حقوق الدفاع وسلطات الاتهام. وتُعد قرينة البراءة امتداداً طبيعياً لهذا الحق، حيث يتحمل الادعاء عبء إثبات التهمة، ويُفسر أي شك لصالح المتهم.
120
- الإسقاط على القانون الجز��ئري: تبنى المشرع الجزائري هذه الفلسفة صراحة في المادة الأولى من قانون الإجراءات الجزائية، حيث نص على أن القانون يقوم على مبادئ الشرعية والمحاكمة العادلة واحترام كرامة وحقوق الإنسان، وأكد أن الشك يفسر في كل الأحوال لصالح المتهم.
121
- الجزء الثاني: حرية الإثبات والاقتناع الشخصي.
122
- في المادة الجنائية، وخلافاً للمادة المدنية، النظام السائد هو الأدلة المعنوية وليس الأدلة القانونية المقيدة. القاضي يبني حكمه على قناعته الصميمة بناءً على ما يُعرض أمامه من أدلة خضعت للنقاش الوجاهي.
123
- الإسقاط على القانون الجزائري: نجد هذا المبدأ مجسداً في المادة ثلاثمائة وتسعة وأربعين، التي تنص على جواز إثبات الجرائم بأي طريق، وأن القاضي يصدر حكمه تبعاً لاقتناعه الخاص.
124
- الجزء الثالث: مبدأ مشروعية الدليل.
125
- يشير الفقه الفرنسي إلى أن حرية الإثبات ليست مطلقة، إذ يُمنع على السلطات العامة استخدام الحيل أو الاستفزاز لارتكاب الجريمة من أجل الحصول على دليل.
126
- """,
127
- "questions": [
128
- {"q": "ما هو المبدأ اللاتيني الذي يعني أن الشك يفسر لصالح المتهم، وأين نجد تطبيقه في القانون الجزائري؟",
129
- "hint": "مبدأ In dubio pro reo، وتم تكريسه بوضوح في المادة (1) من قانون الإجراءات الجزائية الجزائري."},
130
- {"q": "ما هو الفرق بين نظام الأدلة القانونية ونظام الاقتناع الشخصي؟",
131
- "hint": "الأدلة القانونية تلزم القاضي بقيمة محددة للدليل (كالمدني)، بينما الاقتناع الشخصي يترك للقاضي حرية تقييم الدليل بناءً على وجدانه وضميره (كما في المادة 349 جزائري)."},
132
- {"q": "ما المقصود بمبدأ مشروعية الدليل بالنسبة لسلطات الأمن؟",
133
- "hint": "عدم لجوء السلطات إلى الحيل الخداعية أو الاستفزاز لارتكاب الجريمة من أجل الإيقاع بالمتهم وجمع الأدلة ضده."},
134
- ],
135
- },
136
- {
137
- "title": "الدرس الثاني — أجهزة الدعوى: النيابة العامة والشرطة القضائية",
138
- "text": """
139
- تعتمد الإجراءات الجزائية على أجهزة مكلفة باكتشاف الجريمة وتحريك الدعوى، وهي الشرطة القضائية والنيابة العامة.
140
- الجزء الأول: الشرطة القضائية والفرق بينها وبين الشرطة الإدارية.
141
- يفرق الفقه الفرنسي بوضوح بين الشرطة الإدارية، وهدفها وقائي بحت لمنع الإخلال بالنظام العام، والشرطة القضائية، وهدفها قمعي يبدأ عند وقوع الجريمة للبحث عن مرتكبيها. رجال الشرطة القضائية يتصرفون تحت إدارة النيابة العامة.
142
- الإسقاط على القانون الجزائري: نجد هذا التقسيم الهرمي في القانون الجزائري، حيث توضع الشرطة القضائية تحت إشراف النائب العام وإدارة وكيل الجمهورية ورقابة غرفة الاتهام.
143
- الجزء الثاني: النيابة العامة ومبدأ ملاءمة المتابعة.
144
- النيابة العامة هي خصم في الدعوى، ولكنها تدافع عن المجتمع. تتميز النيابة العامة بخاصيتين فقهيتين:
145
- الأولى: التبعية التدرجية، والتي يُعبر عنها بالمثل الفرنسي المأثور: القلم عبد لكن الكلمة حرة، أي أن القاضي ملزم بالتعليمات المكتوبة لرؤسائه، لكنه حر في إبداء رأيه شفهياً في الجلسة.
146
- الثانية: مبدأ ملاءمة المتابعة، حيث أن النيابة ليست ملزمة بمتابعة كل جريمة تصل لعلمها، بل تُقّدر ما إذا كانت المتابعة ملائمة أم أن حفظ الملف أفضل.
147
- الإسقاط على القانون الجزائري: تم تكريس مبدأ الاستقلالية الشفوية في المادة إحدى وأربعين، كما تكرس المادة سبعة وأربعون مبدأ ملاءمة المتابعة.
148
- """,
149
- "questions": [
150
- {"q": "اشرح القاعدة الفقهية: القلم عبد والكلمة حرة وكيف طبقها القانون الجزائري؟",
151
- "hint": "تعني خضوع عضو النيابة للتعليمات المكتوبة لرؤسائه، لكنه يتمتع بحرية إبداء رأيه الشفوي في الجلسة. كرسها القانون الجزائري في المادة (41)."},
152
- {"q": "ما الفرق الجوهري بين الشرطة الإدارية والشرطة القضائية؟",
153
- "hint": "الشرطة الإدارية وقائية (تمنع الجريمة)، والشرطة القضائية قمعية وإجرائية (تبدأ بعد وقوع الجريمة لجمع الأدلة)."},
154
- {"q": "ماذا يُقصد بمبدأ ملاءمة المتابعة الممنوح لوكيل الجمهورية؟",
155
- "hint": "سلطة وكيل الجمهورية في تقييم ما إذا كان من الأفضل للمجتمع تحريك الدعوى أو حفظ الملف لعدم الملاءمة (المادة 47)."},
156
- ],
157
- },
158
- {
159
- "title": "الدرس الثالث — الدعاوى الناشئة عن الجريمة وأسباب انقضائها",
160
- "text": """
161
- تولد الجريمة حقين: حق المجتمع في توقيع العقاب وهي الدعوى العمومية، وحق الضحية في التعويض وهي الدعوى المدنية.
162
- الجزء الأول: استقلالية وتداخل الدعويين.
163
- الدعوى العمومية هي الهدف الأصلي للإجراءات، بينما الدعوى المدنية هي دعوى تابعة. ومع ذلك، للضحية خيار إما اللجوء للقضاء المدني المستقل، أو الانضمام كطرف مدني أمام القضاء الجزائي.
164
- الإسقاط على القانون الجزائري: سمح القانون الجزائري في المادتين الثالثة والرابعة للطرف المتضرر بمباشرة الدعوى المدنية مع الدعوى العمومية. كما كرس القاعدة الفقهية الجزائي يعقل المدني في المادة الخامسة، التي توجب على القاضي المدني إرجاء الفصل حتى يفصل القضاء الجزائي.
165
- الجزء الثاني: انقضاء الدعوى والتقادم.
166
- حسب الفقه، التقادم مبرره فقدان الأدلة مع مرور الزمن، ونسيان المجتمع للاضطراب الذي خلفته الجريمة.
167
- هناك إشكالية فقهية حول الجرائم الخفية، وهي متى يبدأ تقادمها؟ استقر الفقه الفرنسي على تأخير بدء التقادم إلى يوم اكتشاف الجريمة، مع وضع سقف زمني لضمان عدم بقاء التهديد بالمتابعة للأبد.
168
- الإسقاط على القانون الجزائري: تطرق المشرع الجزائري لانقضاء الدعوى في المادة التاسعة. وتبنى نظرية الجرائم الخفية والمخفية في المادة الخامسة عشرة، حيث جعل سريان التقادم يبدأ من يوم ظهورها للعلن.
169
- """,
170
- "questions": [
171
- {"q": "ماذا تعني القاعدة الفقهية الجزائي يعقل المدني المكرسة في المادة الخامسة من القانون الجزائري؟",
172
- "hint": "تعني أن القاضي المدني يجب أن يوقف الفصل في دعوى التعويض المرفوعة أمامه، حتى يصدر حكم نهائي في الدعوى الجزائية المرتبطة بها."},
173
- {"q": "ما هي الجريمة المخفية وكيف يعالجها القانون من حيث التقادم؟",
174
- "hint": "هي الجريمة التي يضع الجاني مناورات لإخفائها. لا يبدأ تقادمها إلا من يوم ظهورها للعلن، مع احترام سقف زمني أقصى حدده القانون الجزائري في المادة (15)."},
175
- {"q": "هل تنازل الضحية عن الدعوى المدنية يوقف الدعوى العمومية؟",
176
- "hint": "كقاعدة عامة لا يوقفها (لأن الدعوى العمومية ملك للمجتمع)، إلا في الحالات الاستثنائية التي يعلق فيها القانون المتابعة على شكوى (المادة 3)."},
177
- ],
178
- },
179
- {
180
- "title": "الدرس الرابع — التحقيق التحضيري والحرية الفردية",
181
- "text": """
182
- يعتبر التحقيق التحضيري مرحلة وسطى بين التحريات والمحاكمة، ويتميز بطبيعة مزدوجة تمزج بين النظام التنقيبي السري والمكتوب من جهة، والنظام الاتهامي الوجاهي الذي يكفل ضمانات الدفاع من جهة أخرى.
183
- الجزء الأول: إخطار قاضي ال��حقيق العيني.
184
- من المبادئ الفقهية الكبرى أن قاضي التحقيق يُخطر بالوقائع لا بالأشخاص. لا يملك القاضي حق التصدي من تلقاء نفسه، بل يجب أن يأتيه طلب افتتاحي من النيابة. إذا اكتشف وقائع جديدة، لا يجوز له التحقيق فيها إلا بعد الحصول على طلب إضافي.
185
- الإسقاط على القانون الجزائري: كرس المشرع الجزائري هذا المبدأ في المادة مئة وأربعين بمنع قاضي التحقيق من إجراء تحقيق إلا بموجب طلب من وكيل الجمهورية.
186
- الجزء الثاني: المساس بالحرية، الحبس المؤقت والرقابة.
187
- يؤكد الفقه على أن المتهم بريء حتى تثبت إدانته، وبالتالي فالحرية هي الأصل والتقييد هو الاستثناء. الحبس المؤقت هو أشد تدبير، ويُشترط الفقه أن يكون الخيار الأخير.
188
- الإسقاط على القانون الجزائري: تماشياً مع هذا، قررت المادة مئة وسبعة وتسعون أن المتهم يبقى حراً، ويمكن اللجوء للرقابة القضائية. ولا يُلجأ إلى الحبس المؤقت إلا بصفة استثنائية وبموجب أمر مسبب في المادة مئتان وواحد.
189
- """,
190
- "questions": [
191
- {"q": "ما معنى قاعدة الإخطار العيني لقاضي التحقيق؟",
192
- "hint": "تعني أن قاضي التحقيق مقيد بالتحقيق في الوقائع (الأفعال) المحددة في طلب النيابة العامة، ولا يملك حق التحقيق في وقائع جديدة يكتشفها من تلقاء نفسه (المادة 140 جزائري)."},
193
- {"q": "كيف وازن القانون بين حق المجتمع في التحقيق وحق المتهم في الحرية؟",
194
- "hint": "بجعل الحرية هي الأصل (المادة 197)، والرقابة القضائية هي البديل الأول، واعتبار الحبس المؤقت تدبيراً استثنائياً له مبررات صارمة ومدد زمنية قصوى (المادة 201)."},
195
- {"q": "ماذا يسمى الطلب الذي يوجهه وكيل الجمهورية لقاضي التحقيق للتحقيق في وقائع جديدة مكتشفة؟",
196
- "hint": "يُسمى الطلب الإضافي للتحقيق، وبالفرنسية Réquisitoire supplétif."},
197
- ],
198
- },
199
- {
200
- "title": "الدرس الخامس — المحاكمة وقوة الشيء المقضي فيه",
201
- "text": """
202
- تعتبر مرحلة المحاكمة تتويجاً للإجراءات، وتتميز بالعلنية والمشافهة والوجاهية أي النقاش الحضوري.
203
- الجزء الأول: المحاكمة الغيابية.
204
- تاريخياً، كان يُطلق على محاكمة الجنايات غيابياً مصطلح التمرد، وكانت إجراءاتها قاسية جداً تحرم المتهم من الدفاع. تطور الفقه الأوروبي للقضاء على هذه التسمية واستبدالها بإجراءات الغياب التي تضمن حداً أدنى من الحقوق.
205
- الإسقاط على القانون الجزائري: القانون الجزائري نظم المحاكمة في الغياب أمام محكمة الجنايات بشكل يضمن أنه إذا حضر محامي المتهم الغائب بعذر مقبول، فإنه يرافع عنه وتعتبر المحاكمة حضورية. وإذا كان الغياب بدون عذر، يحاكم غيابياً بدون محلفين وفق المادة أربعمئة واثنين وخمسين.
206
- الجزء الثاني: حجية الشيء المقضي فيه.
207
- ينص المبدأ الفقهي الشهير Non bis in idem على أنه لا يجوز محاكمة الشخص عن نفس الفعل مرتين. ويشترط لنجاح هذا الدفع توافر ثلاثة عناصر: وحدة الوقائع، وحدة الأطراف، ووحدة السبب.
208
- الإسقاط على القانون الجزائري: تُعتبر قوة الشيء المقضي فيه سبباً من أسباب انقضاء الدعوى العمومية في المادة التاسعة. وقد نصت المادة الأولى بصيغة صريحة على أنه لا يجوز متابعة أو محاكمة أو معاقبة شخص مرتين من أجل نفس الأفعال ولو تم إعطاؤها وصفاً مغايراً.
209
- """,
210
- "questions": [
211
- {"q": "ما هو مبدأ عدم المحاكمة مرتين وأين تم النص عليه في قانون الإجراءات الجزائية الجزائري؟",
212
- "hint": "هو مبدأ عدم جواز محاكمة الشخص مرتين عن نفس الأفعال، وقد كُرس في المادة (1) كنقطة مبدئية، وفي المادة (9) كسبب لانقضاء الدعوى."},
213
- {"q": "كيف تعامل المشرع الجزائري مع غياب المتهم أمام محكمة الجنايات؟",
214
- "hint": "إذا غاب المتهم غياباً غير مبرر، يُحاكم غيابياً بواسطة القضاة فقط (بدون إشراك المحلفين) وفقاً للمادة (451)."},
215
- {"q": "لماذا شدد الفقه الحديث على إلغاء إجراءات التمرد؟",
216
- "hint": "لأنها كانت تحرم المتهم الغائب من أي حق في الدفاع حتى لو حضر محاميه، وهو ما يتعارض مع الحقوق الأساسية للمحاكمة العادلة."},
217
- ],
218
- },
219
- {
220
- "title": "الدرس السادس — بدائل المتابعة والعدالة التفاوضية",
221
- "text": """
222
- ظهر في الفقه الجنائي الحديث توجه نحو العدالة التفاوضية لتخفيف العبء عن المحاكم، وتسريع الإجراءات في الجرائم غير الخطيرة.
223
- الجزء الأول: الوساطة الجزائية.
224
- هي بديل للمتابعة يعتمد على الصلح بين الجاني والضحية. تهدف إلى جبر الضرر وإعادة السلم الاجتماعي دون الحاجة لصدور حكم إدانة.
225
- الإسقاط على القانون الجزائري: نظمها المشرع في المواد من تسعة وخمسين إلى ثمانية وستين. يمكن لوكيل الجمهورية اقتراحها قبل تحريك الدعوى في جنح معينة كخيانة الأمانة والتهديد والسب العلني. تنفيذ اتفاق الوساطة يؤدي إلى انقضاء الدعوى العمومية.
226
- الجزء الثاني: الأمر الجزائي.
227
- هو إجراء مبسط بدون جلسة مرافعة.
228
- الإسقاط على القانون الجزائري: حددته المواد من خمسمئة وواحد وثلاثين إلى خمسمئة وثمانية وثلاثين في المخالفات والجنح البسيطة التي عقوبتها أقل من سنتين. يفصل القاضي من مكتبه بغرامة أو براءة بناء على طلب النيابة، وللمتهم حق الاعتراض.
229
- الجزء الثالث: المثول بناءً على الاعتراف المسبق بالذنب.
230
- مستوحى من النظم الأنجلوسكسونية، وهو إجراء يعرض فيه المدعي العام عقوبة مخففة على المتهم مقابل اعترافه.
231
- الإسقاط على القانون الجزائري: كرسه القانون الجزائري في المواد من خمسمئة وتسعة وثلاثين إلى خمسمئة وثمانية وأربعين. إذا اعترف المتهم، يقترح عليه وكيل الجمهورية عقوبة لا تتجاوز نصف الحد الأقصى للحبس. يُصادق عليها قاضي الحكم في جلسة، ويكون للمحضر قوة الإدانة.
232
- """,
233
- "questions": [
234
- {"q": "ما هي الميزة الأساسية للوساطة الجزائية في القانون الجزائري؟",
235
- "hint": "أن تنفيذ اتفاق الوساطة بين الطرفين يؤدي إلى انقضاء الدعوى العمومية دون تسجيل إدانة قضائية (المادتان 9 و 59)."},
236
- {"q": "في إجراء المثول بناء على الاعتراف المسبق بالذنب، ما هو الحد الأقصى للعقوبة التي يمكن للنيابة اقتراحها؟",
237
- "hint": "يجب ألا تتجاوز مدة الحبس المقترحة نصف الحد الأقصى للعقوبة المقررة قانوناً لتلك الجنحة (المادة 541)."},
238
- {"q": "بماذا يختلف إجراء الأمر الجزائي عن المحاكمة العادية؟",
239
- "hint": "الأمر الجزائي يتم بدون مرافعة وجاهية في الجلسة، حيث يفصل القاضي بناءً على الملف فقط، وبعقوبة الغرامة أو البراءة (المادة 533)."},
240
- ],
241
- }
242
- ]
243
-
244
- LISTEN_SECONDS = 10 # 900 في بيئة الإنتاج (15 دقيقة)
245
- PASS_SCORE = 6
246
-
247
- # ── ذاكرة تخزين الصوت ────────────────────────────────────────────────────────
248
- _audio_cache = {}
249
- _audio_lock = threading.Lock()
250
-
251
- # ── دالة TTS الرئيسية باستخدام edge-tts ─────────────────────────────────────
252
- def _run_edge_tts(text: str, path: str, voice: str, rate: str, pitch: str) -> bool:
253
- """تشغيل edge-tts بشكل متزامن داخل حلقة asyncio جديدة."""
254
- async def _synthesize():
255
- communicate = edge_tts.Communicate(text, voice=voice, rate=rate, pitch=pitch)
256
- await communicate.save(path)
257
-
258
- try:
259
- # نحاول الحصول على حلقة قائمة أو إنشاء واحدة جديدة
260
- try:
261
- loop = asyncio.get_event_loop()
262
- if loop.is_closed():
263
- raise RuntimeError("loop closed")
264
- except RuntimeError:
265
- loop = asyncio.new_event_loop()
266
- asyncio.set_event_loop(loop)
267
-
268
- if loop.is_running():
269
- # نحن داخل حلقة موجودة (مثل Gradio) — نستخدم thread منفصل
270
- import concurrent.futures
271
- with concurrent.futures.ThreadPoolExecutor(max_workers=1) as executor:
272
- future = executor.submit(_sync_run, text, path, voice, rate, pitch)
273
- future.result(timeout=60)
274
- else:
275
- loop.run_until_complete(_synthesize())
276
- return True
277
- except Exception as e:
278
- print(f"[law-app] خطأ edge-tts: {e}")
279
- return False
280
-
281
-
282
- def _sync_run(text, path, voice, rate, pitch):
283
- """تشغيل asyncio في thread مستقل."""
284
- new_loop = asyncio.new_event_loop()
285
- asyncio.set_event_loop(new_loop)
286
- try:
287
- async def _synthesize():
288
- communicate = edge_tts.Communicate(text, voice=voice, rate=rate, pitch=pitch)
289
- await communicate.save(path)
290
- new_loop.run_until_complete(_synthesize())
291
- finally:
292
- new_loop.close()
293
-
294
-
295
- def get_lecture_audio(lesson_idx: int, voice: str = DEFAULT_VOICE):
296
- """توليد الصوت للدرس باستخدام edge-tts مع gTTS كاحتياطي."""
297
- cache_key = f"{lesson_idx}_{voice}"
298
- if cache_key in _audio_cache and os.path.exists(_audio_cache[cache_key]):
299
- return _audio_cache[cache_key]
300
-
301
- with _audio_lock:
302
- if cache_key in _audio_cache and os.path.exists(_audio_cache[cache_key]):
303
- return _audio_cache[cache_key]
304
-
305
- text = LESSONS[lesson_idx]["text"]
306
-
307
- # ── المحاولة الأولى: edge-tts ──────────────────────────────────────
308
- if _EDGE_TTS_AVAILABLE:
309
- try:
310
- path = tempfile.mktemp(suffix=".mp3")
311
- success = False
312
- # نشغّل في thread منفصل دائماً لتجنب تعارض event loops
313
- import concurrent.futures
314
- with concurrent.futures.ThreadPoolExecutor(max_workers=1) as executor:
315
- future = executor.submit(_sync_run, text, path, voice, DEFAULT_RATE, DEFAULT_PITCH)
316
- future.result(timeout=90)
317
- success = os.path.exists(path) and os.path.getsize(path) > 1000
318
- if success:
319
- _audio_cache[cache_key] = path
320
- print(f"[law-app] ✅ edge-tts: درس {lesson_idx + 1} ({voice})")
321
- return path
322
- else:
323
- print(f"[law-app] ⚠️ edge-tts أنتج ملفاً فارغاً، سيتم الرجوع إلى gTTS")
324
- except Exception as e:
325
- print(f"[law-app] ⚠️ edge-tts فشل ({e})، سيتم الرجوع إلى gTTS")
326
-
327
- # ── الاحتياطي: gTTS ────────────────────────────────────────────────
328
- try:
329
- from gtts import gTTS
330
- tts = gTTS(text=text, lang="ar", slow=False)
331
- path = tempfile.mktemp(suffix=".mp3")
332
- tts.save(path)
333
- _audio_cache[cache_key] = path
334
- print(f"[law-app] ✅ gTTS (احتياطي): درس {lesson_idx + 1}")
335
- return path
336
- except Exception as e:
337
- print(f"[law-app] ❌ خطأ gTTS: {e}")
338
- return None
339
-
340
- # ── الحالة ────────────────────────────────────────────────────────────────────
341
- def fresh():
342
- return json.dumps({
343
- "phase": "idle",
344
- "listen_start": None,
345
- "question_idx": None,
346
- "lesson_idx": 0,
347
- "voice": DEFAULT_VOICE,
348
- })
349
-
350
- def S(s): return json.loads(s)
351
- def D(d): return json.dumps(d)
352
-
353
- # ── التقييم بالذكاء الاصطناعي ─────────────────────────────────────────────────
354
- def evaluate_answer(question, answer, hint):
355
- llm = get_llm()
356
- if llm is None:
357
- kw = [w.strip().lower() for w in hint.split("،")]
358
- hits = sum(1 for k in kw if k in answer.lower())
359
- score = min(10, round((hits / max(len(kw), 1)) * 10))
360
- return score, f"(بدون ذكاء اصطناعي – الكلمات المفتاحية: {hits}/{len(kw)})"
361
-
362
- prompt = (
363
- "<|im_start|>system\n"
364
- "أنت أستاذ قانون جزائري صارم ومتفهم. "
365
- "تقيّم إجابات الطلاب وتردّ فقط بصيغة JSON صحيحة.\n"
366
- "<|im_end|>\n"
367
- "<|im_start|>user\n"
368
- f"السؤال: {question}\n"
369
- f"إجابة الطالب: {answer}\n"
370
- f"العناصر المتوقعة: {hint}\n\n"
371
- "قيّم هذه الإجابة من 10 وأعطِ تعليقاً موجزاً باللغة العربية.\n"
372
- 'أجب فقط بهذا JSON في سطر واحد دون أي إضافة:\n'
373
- '{"score": <عدد صحيح 0-10>, "feedback": "<تعليق موجز>"}\n'
374
- "<|im_end|>\n"
375
- "<|im_start|>assistant\n"
376
- )
377
- try:
378
- out = llm(prompt, max_tokens=150, temperature=0.1,
379
- stop=["<|im_end|>", "\n\n", "###"])
380
- text = out["choices"][0]["text"].strip()
381
- print(f"[law-app] رد النموذج: {text}")
382
- start = text.find("{")
383
- end = text.rfind("}") + 1
384
- if start == -1 or end == 0:
385
- raise ValueError("لا يوجد JSON في الرد")
386
- data = json.loads(text[start:end])
387
- return max(0, min(10, int(data["score"]))), data.get("feedback", "")
388
- except Exception as e:
389
- print(f"[law-app] خطأ في التقييم: {e}")
390
- kw = [w.strip().lower() for w in hint.split("،")]
391
- hits = sum(1 for k in kw if k in answer.lower())
392
- score = min(10, round((hits / max(len(kw), 1)) * 10))
393
- return score, f"(خطأ في النموذج – الكلمات المفتاحية: {hits}/{len(kw)})"
394
-
395
- # ── المعالجات ──────────────────────────────────────────────────────────────────
396
- def start_listening(ss):
397
- state = S(ss)
398
- lesson_idx = state.get("lesson_idx", 0)
399
- voice = state.get("voice", DEFAULT_VOICE)
400
- lesson = LESSONS[lesson_idx]
401
- state.update({"phase": "listen", "listen_start": time.time(), "question_idx": None})
402
- audio = get_lecture_audio(lesson_idx, voice)
403
- total = len(LESSONS)
404
- msg = (
405
- f"🎧 **{lesson['title']}** ({lesson_idx + 1}/{total})\n\n"
406
- "استمع لمدة **15 دقيقة** كاملة، ثم انقر على **🔄 التحقق من الوقت**."
407
- )
408
- return (
409
- audio, msg,
410
- gr.update(visible=True),
411
- gr.update(visible=False),
412
- gr.update(visible=False),
413
- gr.update(visible=False),
414
- gr.update(interactive=False, value="⏳ جارٍ الاستماع…"),
415
- D(state),
416
- )
417
-
418
-
419
- def change_voice_and_reload(voice_choice, ss):
420
- """تغيير الصوت وإعادة توليد الصوت للدرس الحالي."""
421
- state = S(ss)
422
- state["voice"] = voice_choice
423
- # مسح الكاش للدرس الحالي حتى يُعاد التوليد
424
- lesson_idx = state.get("lesson_idx", 0)
425
- cache_key = f"{lesson_idx}_{voice_choice}"
426
- # لا نمسح الكاش — إذا لم يكن موجوداً سيُولَّد تلقائياً
427
- return D(state)
428
-
429
-
430
- def check_timer(ss):
431
- state = S(ss)
432
- if state["phase"] != "listen" or not state["listen_start"]:
433
- return gr.update(), "⚠️ ابدأ الاستماع أولاً.", ss
434
- rem = max(0, LISTEN_SECONDS - (time.time() - state["listen_start"]))
435
- m, s = divmod(int(rem), 60)
436
- if rem <= 0:
437
- return (
438
- gr.update(interactive=True, value="✅ الانتقال إلى الاختبار"),
439
- "✅ انتهى الوقت! انقر على **الانتقال إلى الاختبار**.",
440
- ss,
441
- )
442
- return (
443
- gr.update(interactive=False, value=f"⏳ تبقّى {m:02d}:{s:02d}"),
444
- f"🎧 انتظر **{m} دقيقة و{s:02d} ثانية** إضافية.",
445
- ss,
446
- )
447
-
448
-
449
- def open_quiz(ss):
450
- state = S(ss)
451
- elapsed = time.time() - (state["listen_start"] or 0)
452
- if elapsed < LISTEN_SECONDS:
453
- m, s = divmod(int(LISTEN_SECONDS - elapsed), 60)
454
- return (
455
- gr.update(visible=True), gr.update(visible=False),
456
- gr.update(visible=False), gr.update(visible=False),
457
- f"⚠️ انتظر **{m} دقيقة و{s:02d} ثانية** إضافية.", "", "", ss,
458
- )
459
- lesson_idx = state.get("lesson_idx", 0)
460
- idx = random.randrange(len(LESSONS[lesson_idx]["questions"]))
461
- state.update({"phase": "quiz", "question_idx": idx})
462
- return (
463
- gr.update(visible=False), gr.update(visible=True),
464
- gr.update(visible=False), gr.update(visible=False),
465
- "", LESSONS[lesson_idx]["questions"][idx]["q"], "", D(state),
466
- )
467
-
468
-
469
- def submit_answer(answer, ss):
470
- state = S(ss)
471
- lesson_idx = state.get("lesson_idx", 0)
472
-
473
- if state["phase"] != "quiz":
474
- yield (
475
- gr.update(visible=True), gr.update(visible=False),
476
- gr.update(visible=False), gr.update(visible=False),
477
- "",
478
- gr.update(value="📤 إرسال الإجابة", interactive=True),
479
- gr.update(interactive=True),
480
- ss,
481
- )
482
- return
483
-
484
- # الخطوة 1: تعطيل الزر فوراً
485
- yield (
486
- gr.update(visible=False), gr.update(visible=True),
487
- gr.update(visible=False), gr.update(visible=False),
488
- "",
489
- gr.update(value="⏳ تم إرسال الإجابة — جارٍ التصحيح…", interactive=False),
490
- gr.update(interactive=False),
491
- ss,
492
- )
493
-
494
- # الخطوة 2: التقييم
495
- q = LESSONS[lesson_idx]["questions"][state["question_idx"]]
496
- score, fb = evaluate_answer(q["q"], answer, q["hint"])
497
- total = len(LESSONS)
498
- is_last = (lesson_idx >= total - 1)
499
-
500
- if score >= PASS_SCORE:
501
- state["phase"] = "pass"
502
- result = (
503
- f"## 🎉 أحسنت! اجتزت الدرس {lesson_idx + 1} من {total}.\n\n"
504
- f"**النتيجة: {score}/10**\n\n**التعليق:** {fb}"
505
- )
506
- next_label = "🏆 عرض الشهادة" if is_last else f"➡️ {LESSONS[lesson_idx + 1]['title']}"
507
- else:
508
- state["phase"] = "fail"
509
- result = (
510
- f"## ❌ النتيجة غير كافية: {score}/10\n\n"
511
- f"**التعليق:** {fb}\n\n"
512
- f"الحد الأدنى المطلوب: **{PASS_SCORE}/10**. "
513
- "يُرجى **إعادة الاستماع إلى الدرس** قبل المحاولة مجدداً."
514
- )
515
- next_label = "🔄 إعادة الاستماع إلى الدرس"
516
-
517
- # الخطوة 3: عرض النتيجة
518
- yield (
519
- gr.update(visible=False), gr.update(visible=False),
520
- gr.update(visible=True), gr.update(visible=False),
521
- result,
522
- gr.update(value="📤 إرسال الإجابة", interactive=True),
523
- gr.update(value="", interactive=True),
524
- D(state),
525
- )
526
-
527
-
528
- def handle_next(ss):
529
- state = S(ss)
530
- lesson_idx = state.get("lesson_idx", 0)
531
- total = len(LESSONS)
532
-
533
- if state["phase"] == "fail":
534
- return start_listening(D(state))
535
-
536
- if lesson_idx >= total - 1:
537
- state["phase"] = "done"
538
- cert_text = (
539
- "# 🏆 تهانينا!\n\n"
540
- "لقد أتممت دورة **القانون الجنائي الإجرائي** بنجاح.\n\n"
541
- f"اجتزت جميع الدروس الستة وحصلت على شهادة الإتمام.\n\n"
542
- "---\n*استمر في التعلم واستكشاف مجالات القانون الأخرى.*"
543
- )
544
- return (
545
- None, "",
546
- gr.update(visible=False),
547
- gr.update(visible=False),
548
- gr.update(visible=False),
549
- gr.update(visible=True, value=cert_text),
550
- gr.update(interactive=False, value="✅ انتهى"),
551
- D(state),
552
- )
553
- else:
554
- state["lesson_idx"] = lesson_idx + 1
555
- state["listen_start"] = None
556
- return start_listening(D(state))
557
-
558
-
559
- def restart_from_cert(ss):
560
- return start_listening(fresh())
561
-
562
-
563
- # ── واجهة المستخدم ─────────────────────────────────────────────────────────────
564
- CSS = """
565
- footer { display: none !important; }
566
- #title { text-align: center; }
567
- .gradio-container {
568
- direction: rtl;
569
- font-family: 'Amiri', 'Noto Sans Arabic', 'Segoe UI', sans-serif;
570
- }
571
- .gr-button { font-family: 'Amiri', 'Noto Sans Arabic', sans-serif; }
572
- #voice-selector { direction: rtl; }
573
- .voice-info { font-size: 0.85em; color: #666; margin-top: 4px; }
574
- """
575
-
576
- # قائمة الأصوات المتاحة (الاسم للعرض + الكود للاستخدام)
577
- VOICE_CHOICES = [
578
- ("🇩🇿 جزائري — إسماعيل (رجل)", "ar-DZ-IsmaelNeural"),
579
- ("🇩🇿 جزائرية — أمينة (امرأة)", "ar-DZ-AminaNeural"),
580
- ("🇸🇦 سعودي — حامد (رجل)", "ar-SA-HamedNeural"),
581
- ("🇸🇦 سعودية — زارية (امرأة)", "ar-SA-ZariyahNeural"),
582
- ("🇪🇬 مصرية — سلمى (امرأة)", "ar-EG-SalmaNeural"),
583
- ("🇪🇬 مصري — شاكر (رجل)", "ar-EG-ShakirNeural"),
584
- ("🇲🇦 مغربي — جمال (رجل)", "ar-MA-JamalNeural"),
585
- ]
586
-
587
- with gr.Blocks(title="دورة القانون", css=CSS) as demo:
588
- session = gr.State(fresh())
589
-
590
- gr.Markdown(
591
- "# ⚖️ دورة القانون — التكوين القانوني\n"
592
- "استمع إلى كل درس · أجب عن السؤال · تقدّم درساً بعد درس",
593
- elem_id="title",
594
- )
595
-
596
- # ── اختيار الصوت ──────────────────────────────────────────────────────────
597
- with gr.Row():
598
- with gr.Column(scale=2):
599
- voice_dropdown = gr.Dropdown(
600
- choices=[(label, code) for label, code in VOICE_CHOICES],
601
- value=DEFAULT_VOICE,
602
- label="🎙️ اختر صوت القراءة",
603
- interactive=True,
604
- elem_id="voice-selector",
605
- )
606
- with gr.Column(scale=1):
607
- gr.Markdown(
608
- "<div class='voice-info'>الصوت الجزائري موصى به للمحتوى القانوني الجزائري.<br>"
609
- "سيُطبَّق الصوت عند بدء الدرس القادم.</div>"
610
- )
611
-
612
- # ── مرحلة الاستماع ────────────────────────────────────────────────────────
613
- with gr.Column(visible=True) as listen_col:
614
- gr.Markdown("## 🎧 الخطوة الأولى — الاستماع إلى الدرس")
615
- listen_msg = gr.Markdown("انقر على **ابدأ** للبدء.")
616
- audio_out = gr.Audio(
617
- label="الدرس الصوتي (صوت عربي طبيعي)",
618
- autoplay=False,
619
- interactive=False,
620
- )
621
- timer_info = gr.Markdown("")
622
- with gr.Row():
623
- start_btn = gr.Button("▶️ بدء الاستماع", variant="primary")
624
- check_btn = gr.Button("🔄 التحقق من الوقت", variant="secondary")
625
- quiz_btn = gr.Button("✅ الانتقال إلى الاختبار", variant="secondary",
626
- interactive=False)
627
-
628
- # ── مرحلة الاختبار ────────────────────────────────────────────────────────
629
- with gr.Column(visible=False) as quiz_col:
630
- gr.Markdown("## 📝 الخطوة الثانية — سؤال التقييم")
631
- question_md = gr.Markdown("")
632
- answer_box = gr.Textbox(
633
- label="إجابتك",
634
- placeholder="اكتب إجابتك هنا…",
635
- lines=5,
636
- )
637
- submit_btn = gr.Button("📤 إرسال الإجابة", variant="primary")
638
-
639
- # ── النتيجة ───────────────────────────────────────────────────────────────
640
- with gr.Column(visible=False) as result_col:
641
- gr.Markdown("## 📊 النتيجة")
642
- result_md = gr.Markdown("")
643
- next_btn = gr.Button("➡️ الدرس التالي", variant="primary")
644
-
645
- # ── الشهادة ───────────────────────────────────────────────────────────────
646
- with gr.Column(visible=False) as cert_col:
647
- cert_md = gr.Markdown("")
648
- restart_btn = gr.Button("🔄 إعادة البدء من الأول", variant="secondary")
649
-
650
- # ── ربط الأحداث ──────────────────────────────────────────────────────────
651
- LISTEN_OUT = [
652
- audio_out, listen_msg,
653
- listen_col, quiz_col, result_col, cert_col,
654
- quiz_btn, session,
655
- ]
656
-
657
- # تغيير الصوت يحفظ الاختيار في الحالة
658
- voice_dropdown.change(
659
- fn=change_voice_and_reload,
660
- inputs=[voice_dropdown, session],
661
- outputs=[session],
662
- )
663
-
664
- start_btn.click(start_listening, [session], LISTEN_OUT)
665
- check_btn.click(check_timer, [session], [quiz_btn, timer_info, session])
666
-
667
- QUIZ_OUT = [
668
- listen_col, quiz_col, result_col, cert_col,
669
- timer_info, question_md, answer_box, session,
670
- ]
671
- quiz_btn.click(open_quiz, [session], QUIZ_OUT)
672
-
673
- RES_OUT = [
674
- listen_col, quiz_col, result_col, cert_col,
675
- result_md, submit_btn, answer_box, session,
676
- ]
677
- submit_btn.click(submit_answer, [answer_box, session], RES_OUT)
678
- answer_box.submit(submit_answer, [answer_box, session], RES_OUT)
679
-
680
- next_btn.click(handle_next, [session], LISTEN_OUT)
681
- restart_btn.click(restart_from_cert,[session], LISTEN_OUT)
682
-
683
- # ── تحميل نموذج اللغة مسبقاً عند الإطلاق ─────────────────────────────────────
684
- threading.Thread(target=get_llm, daemon=True).start()
685
-
686
- if __name__ == "__main__":
687
- demo.launch(server_name="0.0.0.0", server_port=7860, show_error=True)
688
- """
689
- دورة القانون – Hugging Face Space
690
- النسخة العربية الكاملة
691
- Compatible avec le Docker HF (gradio 4.44.1 bundled + Python 3.13).
692
- TTS: Microsoft Edge Neural Voices (edge-tts) — صوت عربي طبيعي
693
- الأصوات المتاحة:
694
- ar-DZ-IsmaelNeural — رجل، لهجة جزائرية ✅ (موصى به)
695
- ar-DZ-AminaNeural — امرأة، لهجة جزائرية
696
- ar-SA-HamedNeural — رجل، فصحى سعودية
697
- ar-SA-ZariyahNeural — امرأة، فصحى سعودية
698
- ar-EG-SalmaNeural — امرأة، مصرية
699
- ar-MA-JamalNeural — رجل، مغربي
700
- """
701
- import os, json, time, tempfile, random, threading, glob, asyncio
702
- import sys
703
-
704
- try:
705
- import pyaudioop
706
- sys.modules["audioop"] = pyaudioop
707
- except ImportError:
708
- pass
709
-
710
- import gradio as gr
711
-
712
- try:
713
- import gradio_client.utils as _gcu
714
- import gradio.blocks as _gb
715
- _orig = _gcu.json_schema_to_python_type
716
- def _safe(schema):
717
- try: return _orig(schema)
718
- except Exception: return "Any"
719
- _gcu.json_schema_to_python_type = _safe
720
- _gb.client_utils.json_schema_to_python_type = _safe
721
- except Exception:
722
- pass
723
 
724
- try:
725
- from llama_cpp import Llama
726
- _LLAMA_AVAILABLE = True
727
- except ImportError:
728
- _LLAMA_AVAILABLE = False
729
 
730
  # ── TTS: edge-tts (Microsoft Neural Arabic) ──────────────────────────────────
731
  try:
@@ -736,66 +59,10 @@ except ImportError:
736
  _EDGE_TTS_AVAILABLE = False
737
  print("[law-app] edge-tts غير متاح — سيتم استخدام gTTS كبديل")
738
 
739
- # الصوت الافتراضي: جزائري — يمكنك تغييره من القائمة أعلاه
740
  DEFAULT_VOICE = "ar-DZ-IsmaelNeural"
741
-
742
- # معدل الكلام: -10% أبطأ قليلاً لوضوح أفضل في المحتوى القانوني
743
  DEFAULT_RATE = "-10%"
744
  DEFAULT_PITCH = "+0Hz"
745
 
746
- from huggingface_hub import hf_hub_download
747
-
748
- try:
749
- from llama_cpp import Llama
750
- _LLAMA_OK = True
751
- except ImportError:
752
- _LLAMA_OK = False
753
-
754
- # ── تحميل نموذج اللغة ────────────────────────────────────────────────────────
755
- _llm = None
756
- _llm_lock = threading.Lock()
757
-
758
- def download_model():
759
- model_path = "/app/model.gguf"
760
- if os.path.exists(model_path):
761
- print("[law-app] النموذج موجود مسبقاً.")
762
- return model_path
763
- print("[law-app] جارٍ تحميل النموذج...")
764
- try:
765
- path = hf_hub_download(
766
- repo_id="Qwen/Qwen2.5-0.5B-Instruct-GGUF",
767
- filename="qwen2.5-0.5b-instruct-q4_k_m.gguf",
768
- local_dir="/app",
769
- local_dir_use_symlinks=False,
770
- )
771
- if path != model_path:
772
- os.rename(path, model_path)
773
- print("[law-app] اكتمل التحميل.")
774
- return model_path
775
- except Exception as e:
776
- print(f"[law-app] خطأ في التحميل: {e}")
777
- return None
778
-
779
- def get_llm():
780
- global _llm
781
- if _llm is not None:
782
- return _llm
783
- if not _LLAMA_AVAILABLE:
784
- return None
785
- with _llm_lock:
786
- if _llm is not None:
787
- return _llm
788
- gguf_files = glob.glob("/app/*.gguf") + glob.glob("*.gguf")
789
- if not gguf_files:
790
- print("[law-app] لم يُعثر على ملف .gguf – الذكاء الاصطناعي معطّل.")
791
- return None
792
- model_path = gguf_files[0]
793
- print(f"[law-app] تحميل النموذج: {model_path}")
794
- _llm = Llama(model_path=model_path, n_ctx=512, n_threads=2,
795
- n_gpu_layers=int(os.getenv("N_GPU_LAYERS", "-1")), verbose=False)
796
- print("[law-app] النموذج جاهز.")
797
- return _llm
798
-
799
  # ── دروس القانون ─────────────────────────────────────────────────────────────
800
  LESSONS = [
801
  {
@@ -928,46 +195,16 @@ LESSONS = [
928
  }
929
  ]
930
 
931
- LISTEN_SECONDS = 10 # 900 في بيئة الإنتاج (15 دقيقة)
932
- PASS_SCORE = 6
933
 
934
  # ── ذاكرة تخزين الصوت ────────────────────────────────────────────────────────
935
  _audio_cache = {}
936
  _audio_lock = threading.Lock()
937
 
938
- # ── دالة TTS الرئيسية باستخدام edge-tts ─────────────────────────────────────
939
- def _run_edge_tts(text: str, path: str, voice: str, rate: str, pitch: str) -> bool:
940
- """تشغيل edge-tts بشكل متزامن داخل حلقة asyncio جديدة."""
941
- async def _synthesize():
942
- communicate = edge_tts.Communicate(text, voice=voice, rate=rate, pitch=pitch)
943
- await communicate.save(path)
944
-
945
- try:
946
- # نحاول الحصول على حلقة قائمة أو إنشاء واحدة جديدة
947
- try:
948
- loop = asyncio.get_event_loop()
949
- if loop.is_closed():
950
- raise RuntimeError("loop closed")
951
- except RuntimeError:
952
- loop = asyncio.new_event_loop()
953
- asyncio.set_event_loop(loop)
954
-
955
- if loop.is_running():
956
- # نحن داخل حلقة موجودة (مثل Gradio) — نستخدم thread منفصل
957
- import concurrent.futures
958
- with concurrent.futures.ThreadPoolExecutor(max_workers=1) as executor:
959
- future = executor.submit(_sync_run, text, path, voice, rate, pitch)
960
- future.result(timeout=60)
961
- else:
962
- loop.run_until_complete(_synthesize())
963
- return True
964
- except Exception as e:
965
- print(f"[law-app] خطأ edge-tts: {e}")
966
- return False
967
-
968
-
969
  def _sync_run(text, path, voice, rate, pitch):
970
- """تشغيل asyncio في thread مستقل."""
971
  new_loop = asyncio.new_event_loop()
972
  asyncio.set_event_loop(new_loop)
973
  try:
@@ -991,27 +228,21 @@ def get_lecture_audio(lesson_idx: int, voice: str = DEFAULT_VOICE):
991
 
992
  text = LESSONS[lesson_idx]["text"]
993
 
994
- # ── المحاولة الأولى: edge-tts ──────────────────────────────────────
995
  if _EDGE_TTS_AVAILABLE:
996
  try:
997
- path = tempfile.mktemp(suffix=".mp3")
998
- success = False
999
- # نشغّل في thread منفصل دائماً لتجنب تعارض event loops
1000
  import concurrent.futures
 
1001
  with concurrent.futures.ThreadPoolExecutor(max_workers=1) as executor:
1002
  future = executor.submit(_sync_run, text, path, voice, DEFAULT_RATE, DEFAULT_PITCH)
1003
- future.result(timeout=90)
1004
- success = os.path.exists(path) and os.path.getsize(path) > 1000
1005
- if success:
1006
  _audio_cache[cache_key] = path
1007
  print(f"[law-app] ✅ edge-tts: درس {lesson_idx + 1} ({voice})")
1008
  return path
1009
- else:
1010
- print(f"[law-app] ⚠️ edge-tts أنتج ملفاً فارغاً، سيتم الرجوع إلى gTTS")
1011
  except Exception as e:
1012
  print(f"[law-app] ⚠️ edge-tts فشل ({e})، سيتم الرجوع إلى gTTS")
1013
 
1014
- # ── الاحتياطي: gTTS ────────────────────────────────────────────────
1015
  try:
1016
  from gtts import gTTS
1017
  tts = gTTS(text=text, lang="ar", slow=False)
@@ -1024,60 +255,116 @@ def get_lecture_audio(lesson_idx: int, voice: str = DEFAULT_VOICE):
1024
  print(f"[law-app] ❌ خطأ gTTS: {e}")
1025
  return None
1026
 
1027
- # ── الحالة ────────────────────────────────────────────────────────────────────
1028
- def fresh():
1029
- return json.dumps({
1030
- "phase": "idle",
1031
- "listen_start": None,
1032
- "question_idx": None,
1033
- "lesson_idx": 0,
1034
- "voice": DEFAULT_VOICE,
1035
- })
1036
 
1037
- def S(s): return json.loads(s)
1038
- def D(d): return json.dumps(d)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1039
 
1040
- # ── التقييم بالذكاء الاصطناعي ─────────────────────────────────────────────────
1041
- def evaluate_answer(question, answer, hint):
1042
- llm = get_llm()
1043
- if llm is None:
1044
- kw = [w.strip().lower() for w in hint.split("،")]
1045
- hits = sum(1 for k in kw if k in answer.lower())
1046
- score = min(10, round((hits / max(len(kw), 1)) * 10))
1047
- return score, f"(بدون ذكاء اصطناعي الكلمات المفتاحية: {hits}/{len(kw)})"
1048
-
1049
- prompt = (
1050
- "<|im_start|>system\n"
 
 
 
 
 
 
 
 
1051
  "أنت أستاذ قانون جزائري صارم ومتفهم. "
1052
- "تقيّم إجابات الطلاب وتردّ فقط بصيغة JSON صحيحة.\n"
1053
- "<|im_end|>\n"
1054
- "<|im_start|>user\n"
1055
  f"السؤال: {question}\n"
1056
  f"إجابة الطالب: {answer}\n"
1057
  f"العناصر المتوقعة: {hint}\n\n"
1058
  "قيّم هذه الإجابة من 10 وأعطِ تعليقاً موجزاً باللغة العربية.\n"
1059
- 'أجب فقط بهذا JSON في سطر واحد دون أي إضافة:\n'
1060
- '{"score": <عدد صحيح 0-10>, "feedback": "<تعليق موجز>"}\n'
1061
- "<|im_end|>\n"
1062
- "<|im_start|>assistant\n"
1063
  )
 
1064
  try:
1065
- out = llm(prompt, max_tokens=150, temperature=0.1,
1066
- stop=["<|im_end|>", "\n\n", "###"])
1067
- text = out["choices"][0]["text"].strip()
1068
- print(f"[law-app] رد النموذج: {text}")
1069
- start = text.find("{")
1070
- end = text.rfind("}") + 1
 
1071
  if start == -1 or end == 0:
1072
  raise ValueError("لا يوجد JSON في الرد")
1073
- data = json.loads(text[start:end])
1074
- return max(0, min(10, int(data["score"]))), data.get("feedback", "")
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1075
  except Exception as e:
1076
- print(f"[law-app] خطأ في التقييم: {e}")
1077
- kw = [w.strip().lower() for w in hint.split("،")]
1078
- hits = sum(1 for k in kw if k in answer.lower())
1079
- score = min(10, round((hits / max(len(kw), 1)) * 10))
1080
- return score, f"(خطأ في النموذج – الكلمات المفتاحية: {hits}/{len(kw)})"
 
 
 
 
 
 
 
 
 
 
 
 
1081
 
1082
  # ── المعالجات ──────────────────────────────────────────────────────────────────
1083
  def start_listening(ss):
@@ -1104,13 +391,8 @@ def start_listening(ss):
1104
 
1105
 
1106
  def change_voice_and_reload(voice_choice, ss):
1107
- """تغيير الصوت وإعادة توليد الصوت للدرس الحالي."""
1108
  state = S(ss)
1109
  state["voice"] = voice_choice
1110
- # مسح الكاش للدرس الحالي حتى يُعاد التوليد
1111
- lesson_idx = state.get("lesson_idx", 0)
1112
- cache_key = f"{lesson_idx}_{voice_choice}"
1113
- # لا نمسح الكاش — إذا لم يكن موجوداً سيُولَّد تلقائياً
1114
  return D(state)
1115
 
1116
 
@@ -1118,7 +400,7 @@ def check_timer(ss):
1118
  state = S(ss)
1119
  if state["phase"] != "listen" or not state["listen_start"]:
1120
  return gr.update(), "⚠️ ابدأ الاستماع أولاً.", ss
1121
- rem = max(0, LISTEN_SECONDS - (time.time() - state["listen_start"]))
1122
  m, s = divmod(int(rem), 60)
1123
  if rem <= 0:
1124
  return (
@@ -1134,7 +416,7 @@ def check_timer(ss):
1134
 
1135
 
1136
  def open_quiz(ss):
1137
- state = S(ss)
1138
  elapsed = time.time() - (state["listen_start"] or 0)
1139
  if elapsed < LISTEN_SECONDS:
1140
  m, s = divmod(int(LISTEN_SECONDS - elapsed), 60)
@@ -1154,7 +436,7 @@ def open_quiz(ss):
1154
 
1155
 
1156
  def submit_answer(answer, ss):
1157
- state = S(ss)
1158
  lesson_idx = state.get("lesson_idx", 0)
1159
 
1160
  if state["phase"] != "quiz":
@@ -1168,17 +450,17 @@ def submit_answer(answer, ss):
1168
  )
1169
  return
1170
 
1171
- # الخطوة 1: تعطيل الزر فوراً
1172
  yield (
1173
  gr.update(visible=False), gr.update(visible=True),
1174
  gr.update(visible=False), gr.update(visible=False),
1175
  "",
1176
- gr.update(value="⏳ تم إرسال الإجابة — جارٍ التصحيح…", interactive=False),
1177
  gr.update(interactive=False),
1178
  ss,
1179
  )
1180
 
1181
- # الخطوة 2: التقييم
1182
  q = LESSONS[lesson_idx]["questions"][state["question_idx"]]
1183
  score, fb = evaluate_answer(q["q"], answer, q["hint"])
1184
  total = len(LESSONS)
@@ -1190,7 +472,6 @@ def submit_answer(answer, ss):
1190
  f"## 🎉 أحسنت! اجتزت الدرس {lesson_idx + 1} من {total}.\n\n"
1191
  f"**النتيجة: {score}/10**\n\n**التعليق:** {fb}"
1192
  )
1193
- next_label = "🏆 عرض الشهادة" if is_last else f"➡️ {LESSONS[lesson_idx + 1]['title']}"
1194
  else:
1195
  state["phase"] = "fail"
1196
  result = (
@@ -1199,9 +480,7 @@ def submit_answer(answer, ss):
1199
  f"الحد الأدنى المطلوب: **{PASS_SCORE}/10**. "
1200
  "يُرجى **إعادة الاستماع إلى الدرس** قبل المحاولة مجدداً."
1201
  )
1202
- next_label = "🔄 إعادة الاستماع إلى الدرس"
1203
 
1204
- # الخطوة 3: عرض النتيجة
1205
  yield (
1206
  gr.update(visible=False), gr.update(visible=False),
1207
  gr.update(visible=True), gr.update(visible=False),
@@ -1238,7 +517,7 @@ def handle_next(ss):
1238
  D(state),
1239
  )
1240
  else:
1241
- state["lesson_idx"] = lesson_idx + 1
1242
  state["listen_start"] = None
1243
  return start_listening(D(state))
1244
 
@@ -1257,18 +536,18 @@ footer { display: none !important; }
1257
  }
1258
  .gr-button { font-family: 'Amiri', 'Noto Sans Arabic', sans-serif; }
1259
  #voice-selector { direction: rtl; }
1260
- .voice-info { font-size: 0.85em; color: #666; margin-top: 4px; }
 
1261
  """
1262
 
1263
- # قائمة الأصوات المتاحة (الاسم للعرض + الكود للاستخدام)
1264
  VOICE_CHOICES = [
1265
- ("🇩🇿 جزائري — إسماعيل (رجل)", "ar-DZ-IsmaelNeural"),
1266
- ("🇩🇿 جزائرية — أمينة (امرأة)", "ar-DZ-AminaNeural"),
1267
- ("🇸🇦 سعودي — حامد (رجل)", "ar-SA-HamedNeural"),
1268
- ("🇸🇦 سعودية — زارية (امرأة)", "ar-SA-ZariyahNeural"),
1269
- ("🇪🇬 مصرية — سلمى (امرأة)", "ar-EG-SalmaNeural"),
1270
- ("🇪🇬 مصري — شاكر (رجل)", "ar-EG-ShakirNeural"),
1271
- ("🇲🇦 مغربي — جمال (رجل)", "ar-MA-JamalNeural"),
1272
  ]
1273
 
1274
  with gr.Blocks(title="دورة القانون", css=CSS) as demo:
@@ -1280,6 +559,12 @@ with gr.Blocks(title="دورة القانون", css=CSS) as demo:
1280
  elem_id="title",
1281
  )
1282
 
 
 
 
 
 
 
1283
  # ── اختيار الصوت ──────────────────────────────────────────────────────────
1284
  with gr.Row():
1285
  with gr.Column(scale=2):
@@ -1307,9 +592,9 @@ with gr.Blocks(title="دورة القانون", css=CSS) as demo:
1307
  )
1308
  timer_info = gr.Markdown("")
1309
  with gr.Row():
1310
- start_btn = gr.Button("▶️ بدء الاستماع", variant="primary")
1311
- check_btn = gr.Button("🔄 التحقق من الوقت", variant="secondary")
1312
- quiz_btn = gr.Button("✅ الانتقال إلى الاختبار", variant="secondary",
1313
  interactive=False)
1314
 
1315
  # ── مرحلة الاختبار ────────────────────────────────────────────────────────
@@ -1341,7 +626,6 @@ with gr.Blocks(title="دورة القانون", css=CSS) as demo:
1341
  quiz_btn, session,
1342
  ]
1343
 
1344
- # تغيير الصوت يحفظ الاختيار في الحالة
1345
  voice_dropdown.change(
1346
  fn=change_voice_and_reload,
1347
  inputs=[voice_dropdown, session],
@@ -1364,11 +648,13 @@ with gr.Blocks(title="دورة القانون", css=CSS) as demo:
1364
  submit_btn.click(submit_answer, [answer_box, session], RES_OUT)
1365
  answer_box.submit(submit_answer, [answer_box, session], RES_OUT)
1366
 
1367
- next_btn.click(handle_next, [session], LISTEN_OUT)
1368
- restart_btn.click(restart_from_cert,[session], LISTEN_OUT)
 
 
 
1369
 
1370
- # ── تحميل نموذج اللغة مسبقاً عند الإطلاق ─────────────────────────────────────
1371
- threading.Thread(target=get_llm, daemon=True).start()
1372
 
1373
  if __name__ == "__main__":
1374
  demo.launch(server_name="0.0.0.0", server_port=7860, show_error=True)
 
1
  """
2
  دورة القانون – Hugging Face Space
3
  النسخة العربية الكاملة
4
+ Compatible avec le Docker HF (gradio 4.44.1 bundled + Python 3.11).
5
  TTS: Microsoft Edge Neural Voices (edge-tts) — صوت عربي طبيعي
6
+ LLM: خادم gemma4cpu عبر HTTP (OpenAI-compatible API)
7
+ https://ramedde-gemma4cpu.hf.space/v1/chat/completions
8
  الأصوات المتاحة:
9
  ar-DZ-IsmaelNeural — رجل، لهجة جزائرية ✅ (موصى به)
10
  ar-DZ-AminaNeural — امرأة، لهجة جزائرية
11
  ar-SA-HamedNeural — رجل، فصحى سعودية
12
  ar-SA-ZariyahNeural — امرأة، فصحى سعودية
13
  ar-EG-SalmaNeural — امرأة، مصرية
14
+ ar-EG-ShakirNeural — رجل، مصري
15
  ar-MA-JamalNeural — رجل، مغربي
16
  """
17
+ import os, json, time, tempfile, random, threading, asyncio
18
  import sys
19
+ import urllib.request
20
+ import urllib.error
21
 
22
  try:
23
  import pyaudioop
 
39
  except Exception:
40
  pass
41
 
42
+ # ── إعدادات الخادم البعيد ──────────────────────────────────────────────────────
43
+ # عنوان خادم gemma4cpu — يمكن تجاوزه بمتغير بيئة LLM_BASE_URL
44
+ LLM_BASE_URL = os.getenv(
45
+ "LLM_BASE_URL",
46
+ "https://ramedde-gemma4cpu.hf.space"
47
+ ).rstrip("/")
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
48
 
49
+ LLM_CHAT_ENDPOINT = f"{LLM_BASE_URL}/v1/chat/completions"
50
+ LLM_MODEL_NAME = os.getenv("LLM_MODEL_NAME", "gemma-4-e2b-q4")
51
+ LLM_TIMEOUT = int(os.getenv("LLM_TIMEOUT", "120")) # ثانية
 
 
52
 
53
  # ── TTS: edge-tts (Microsoft Neural Arabic) ──────────────────────────────────
54
  try:
 
59
  _EDGE_TTS_AVAILABLE = False
60
  print("[law-app] edge-tts غير متاح — سيتم استخدام gTTS كبديل")
61
 
 
62
  DEFAULT_VOICE = "ar-DZ-IsmaelNeural"
 
 
63
  DEFAULT_RATE = "-10%"
64
  DEFAULT_PITCH = "+0Hz"
65
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
66
  # ── دروس القانون ─────────────────────────────────────────────────────────────
67
  LESSONS = [
68
  {
 
195
  }
196
  ]
197
 
198
+ LISTEN_SECONDS = 900 # 15 دقيقة
199
+ PASS_SCORE = 6
200
 
201
  # ── ذاكرة تخزين الصوت ────────────────────────────────────────────────────────
202
  _audio_cache = {}
203
  _audio_lock = threading.Lock()
204
 
205
+ # ── TTS helpers ───────────────────────────────────────────────────────────────
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
206
  def _sync_run(text, path, voice, rate, pitch):
207
+ """توليد الصوت في thread مستقل لتجنب تعارض event loops."""
208
  new_loop = asyncio.new_event_loop()
209
  asyncio.set_event_loop(new_loop)
210
  try:
 
228
 
229
  text = LESSONS[lesson_idx]["text"]
230
 
 
231
  if _EDGE_TTS_AVAILABLE:
232
  try:
 
 
 
233
  import concurrent.futures
234
+ path = tempfile.mktemp(suffix=".mp3")
235
  with concurrent.futures.ThreadPoolExecutor(max_workers=1) as executor:
236
  future = executor.submit(_sync_run, text, path, voice, DEFAULT_RATE, DEFAULT_PITCH)
237
+ future.result(timeout=120)
238
+ if os.path.exists(path) and os.path.getsize(path) > 1000:
 
239
  _audio_cache[cache_key] = path
240
  print(f"[law-app] ✅ edge-tts: درس {lesson_idx + 1} ({voice})")
241
  return path
242
+ print(f"[law-app] ⚠️ edge-tts أنتج ملفاً فارغاً، سيتم الرجوع إلى gTTS")
 
243
  except Exception as e:
244
  print(f"[law-app] ⚠️ edge-tts فشل ({e})، سيتم الرجوع إلى gTTS")
245
 
 
246
  try:
247
  from gtts import gTTS
248
  tts = gTTS(text=text, lang="ar", slow=False)
 
255
  print(f"[law-app] ❌ خطأ gTTS: {e}")
256
  return None
257
 
 
 
 
 
 
 
 
 
 
258
 
259
+ # ── التقييم عبر الخادم البعيد (OpenAI-compatible) ──────────────────────────
260
+ def _call_remote_llm(system_prompt: str, user_prompt: str) -> str:
261
+ """
262
+ استدعاء خادم gemma4cpu عبر /v1/chat/completions.
263
+ يعيد النص الخام من الرد، أو يرفع استثناء عند الفشل.
264
+ """
265
+ payload = json.dumps({
266
+ "model": LLM_MODEL_NAME,
267
+ "messages": [
268
+ {"role": "system", "content": system_prompt},
269
+ {"role": "user", "content": user_prompt},
270
+ ],
271
+ "max_tokens": 300,
272
+ "temperature": 0.1,
273
+ "stream": False,
274
+ }).encode("utf-8")
275
+
276
+ req = urllib.request.Request(
277
+ LLM_CHAT_ENDPOINT,
278
+ data=payload,
279
+ headers={"Content-Type": "application/json"},
280
+ method="POST",
281
+ )
282
+ with urllib.request.urlopen(req, timeout=LLM_TIMEOUT) as resp:
283
+ data = json.loads(resp.read().decode("utf-8"))
284
 
285
+ # استخراج النص من رد OpenAI-compatible
286
+ return data["choices"][0]["message"]["content"].strip()
287
+
288
+
289
+ def _keyword_score(answer: str, hint: str):
290
+ """تسجيل احتياطي بالكلمات المفتاحية عند غياب الخادم."""
291
+ kw = [w.strip().lower() for w in hint.split("،")]
292
+ hits = sum(1 for k in kw if k in answer.lower())
293
+ score = min(10, round((hits / max(len(kw), 1)) * 10))
294
+ return score, f"(وضع الكلمات المفتاحية – {hits}/{len(kw)} مطابقة)"
295
+
296
+
297
+ def evaluate_answer(question: str, answer: str, hint: str):
298
+ """
299
+ تقييم إجابة الطالب.
300
+ يحاول أولاً استخدام الخادم البعيد gemma4cpu،
301
+ ويرجع إلى تقييم الكلمات المفتاحية عند الفشل.
302
+ """
303
+ system_prompt = (
304
  "أنت أستاذ قانون جزائري صارم ومتفهم. "
305
+ "تقيّم إجابات الطلاب وتردّ فقط بصيغة JSON صحيحة بدون أي نص إضافي."
306
+ )
307
+ user_prompt = (
308
  f"السؤال: {question}\n"
309
  f"إجابة الطالب: {answer}\n"
310
  f"العناصر المتوقعة: {hint}\n\n"
311
  "قيّم هذه الإجابة من 10 وأعطِ تعليقاً موجزاً باللغة العربية.\n"
312
+ 'أجب فقط بهذا JSON في سطر واحد بدون أي مقدمة:\n'
313
+ '{"score": <عدد صحيح 0-10>, "feedback": "<تعليق موجز>"}'
 
 
314
  )
315
+
316
  try:
317
+ print(f"[law-app] 🌐 إرسال طلب التقييم إلى {LLM_CHAT_ENDPOINT}")
318
+ raw = _call_remote_llm(system_prompt, user_prompt)
319
+ print(f"[law-app] رد الخادم: {raw}")
320
+
321
+ # استخراج أول JSON صالح من الرد
322
+ start = raw.find("{")
323
+ end = raw.rfind("}") + 1
324
  if start == -1 or end == 0:
325
  raise ValueError("لا يوجد JSON في الرد")
326
+ data = json.loads(raw[start:end])
327
+ score = max(0, min(10, int(data["score"])))
328
+ feedback = data.get("feedback", "")
329
+ return score, feedback
330
+
331
+ except urllib.error.URLError as e:
332
+ print(f"[law-app] ⚠️ خطأ شبكة للخادم البعيد: {e} — وضع الكلمات المفتاحية")
333
+ return _keyword_score(answer, hint)
334
+ except Exception as e:
335
+ print(f"[law-app] ⚠️ خطأ في التقييم البعيد: {e} — وضع الكلمات المفتاحية")
336
+ return _keyword_score(answer, hint)
337
+
338
+
339
+ # ── فحص صحة الخادم عند الإطلاق ──────────────────────────────────────────────
340
+ def _check_remote_server():
341
+ """فحص توفر خادم LLM البعيد عند بدء التشغيل."""
342
+ try:
343
+ req = urllib.request.Request(
344
+ f"{LLM_BASE_URL}/",
345
+ method="GET",
346
+ headers={"Accept": "application/json"},
347
+ )
348
+ with urllib.request.urlopen(req, timeout=15) as resp:
349
+ print(f"[law-app] ✅ خادم LLM البعيد متاح: {LLM_BASE_URL} (HTTP {resp.status})")
350
  except Exception as e:
351
+ print(f"[law-app] ⚠️ خادم LLM البعيد غير متاح: {e}")
352
+ print(f"[law-app] سيُستخدم وضع الكلمات المفتاحية عند فشل كل استدعاء.")
353
+
354
+
355
+ # ── الحالة ────────────────────────────────────────────────────────────────────
356
+ def fresh():
357
+ return json.dumps({
358
+ "phase": "idle",
359
+ "listen_start": None,
360
+ "question_idx": None,
361
+ "lesson_idx": 0,
362
+ "voice": DEFAULT_VOICE,
363
+ })
364
+
365
+ def S(s): return json.loads(s)
366
+ def D(d): return json.dumps(d)
367
+
368
 
369
  # ── المعالجات ──────────────────────────────────────────────────────────────────
370
  def start_listening(ss):
 
391
 
392
 
393
  def change_voice_and_reload(voice_choice, ss):
 
394
  state = S(ss)
395
  state["voice"] = voice_choice
 
 
 
 
396
  return D(state)
397
 
398
 
 
400
  state = S(ss)
401
  if state["phase"] != "listen" or not state["listen_start"]:
402
  return gr.update(), "⚠️ ابدأ الاستماع أولاً.", ss
403
+ rem = max(0, LISTEN_SECONDS - (time.time() - state["listen_start"]))
404
  m, s = divmod(int(rem), 60)
405
  if rem <= 0:
406
  return (
 
416
 
417
 
418
  def open_quiz(ss):
419
+ state = S(ss)
420
  elapsed = time.time() - (state["listen_start"] or 0)
421
  if elapsed < LISTEN_SECONDS:
422
  m, s = divmod(int(LISTEN_SECONDS - elapsed), 60)
 
436
 
437
 
438
  def submit_answer(answer, ss):
439
+ state = S(ss)
440
  lesson_idx = state.get("lesson_idx", 0)
441
 
442
  if state["phase"] != "quiz":
 
450
  )
451
  return
452
 
453
+ # الخطوة 1: تعطيل الزر فوراً وإبلاغ المستخدم
454
  yield (
455
  gr.update(visible=False), gr.update(visible=True),
456
  gr.update(visible=False), gr.update(visible=False),
457
  "",
458
+ gr.update(value="⏳ جارٍ التصحيح بواسطة Gemma…", interactive=False),
459
  gr.update(interactive=False),
460
  ss,
461
  )
462
 
463
+ # الخطوة 2: التقييم عبر الخادم البعيد
464
  q = LESSONS[lesson_idx]["questions"][state["question_idx"]]
465
  score, fb = evaluate_answer(q["q"], answer, q["hint"])
466
  total = len(LESSONS)
 
472
  f"## 🎉 أحسنت! اجتزت الدرس {lesson_idx + 1} من {total}.\n\n"
473
  f"**النتيجة: {score}/10**\n\n**التعليق:** {fb}"
474
  )
 
475
  else:
476
  state["phase"] = "fail"
477
  result = (
 
480
  f"الحد الأدنى المطلوب: **{PASS_SCORE}/10**. "
481
  "يُرجى **إعادة الاستماع إلى الدرس** قبل المحاولة مجدداً."
482
  )
 
483
 
 
484
  yield (
485
  gr.update(visible=False), gr.update(visible=False),
486
  gr.update(visible=True), gr.update(visible=False),
 
517
  D(state),
518
  )
519
  else:
520
+ state["lesson_idx"] = lesson_idx + 1
521
  state["listen_start"] = None
522
  return start_listening(D(state))
523
 
 
536
  }
537
  .gr-button { font-family: 'Amiri', 'Noto Sans Arabic', sans-serif; }
538
  #voice-selector { direction: rtl; }
539
+ .voice-info { font-size: 0.85em; color: #666; margin-top: 4px; }
540
+ .server-info { font-size: 0.80em; color: #4a7c59; margin-top: 4px; }
541
  """
542
 
 
543
  VOICE_CHOICES = [
544
+ ("🇩🇿 جزائري — إسماعيل (رجل)", "ar-DZ-IsmaelNeural"),
545
+ ("🇩🇿 جزائرية — أمينة (امرأة)", "ar-DZ-AminaNeural"),
546
+ ("🇸🇦 سعودي — حامد (رجل)", "ar-SA-HamedNeural"),
547
+ ("🇸🇦 سعودية — زارية (امرأة)", "ar-SA-ZariyahNeural"),
548
+ ("🇪🇬 مصرية — سلمى (امرأة)", "ar-EG-SalmaNeural"),
549
+ ("🇪🇬 مصري — شاكر (رجل)", "ar-EG-ShakirNeural"),
550
+ ("🇲🇦 مغربي — جمال (رجل)", "ar-MA-JamalNeural"),
551
  ]
552
 
553
  with gr.Blocks(title="دورة القانون", css=CSS) as demo:
 
559
  elem_id="title",
560
  )
561
 
562
+ # ── معلومات الخادم ────────────────────────────────────────────────────────
563
+ gr.Markdown(
564
+ f"<div class='server-info'>🤖 التقييم: <strong>Gemma 4 E2B</strong> عبر "
565
+ f"<code>{LLM_BASE_URL}</code></div>"
566
+ )
567
+
568
  # ── اختيار الصوت ──────────────────────────────────────────────────────────
569
  with gr.Row():
570
  with gr.Column(scale=2):
 
592
  )
593
  timer_info = gr.Markdown("")
594
  with gr.Row():
595
+ start_btn = gr.Button("▶️ بدء الاستماع", variant="primary")
596
+ check_btn = gr.Button("🔄 التحقق من الوقت", variant="secondary")
597
+ quiz_btn = gr.Button("✅ الانتقال إلى الاختبار", variant="secondary",
598
  interactive=False)
599
 
600
  # ── مرحلة الاختبار ────────────────────────────────────────────────────────
 
626
  quiz_btn, session,
627
  ]
628
 
 
629
  voice_dropdown.change(
630
  fn=change_voice_and_reload,
631
  inputs=[voice_dropdown, session],
 
648
  submit_btn.click(submit_answer, [answer_box, session], RES_OUT)
649
  answer_box.submit(submit_answer, [answer_box, session], RES_OUT)
650
 
651
+ next_btn.click(handle_next, [session], LISTEN_OUT)
652
+ restart_btn.click(restart_from_cert, [session], LISTEN_OUT)
653
+
654
+ # ── فحص الخادم عند الإطلاق ────────────────────────────────────────────────────
655
+ threading.Thread(target=_check_remote_server, daemon=True).start()
656
 
657
+ demo.queue()
 
658
 
659
  if __name__ == "__main__":
660
  demo.launch(server_name="0.0.0.0", server_port=7860, show_error=True)