# دليل استكشاف الأخطاء

## المشكلة 1: الدرس لا يظهر في التطبيق

### السبب:
API يعرض فقط الدروس بحالة `published` (منشور).

### الحل:
1. افتح لوحة الإدارة: `http://127.0.0.1:8000/admin/lessons/lesson/`
2. ابحث عن الدرس
3. تأكد من أن الحالة `published` (منشور)
4. إذا كانت الحالة `draft` (مسودة)، غيرها إلى `published`

## المشكلة 2: لم يتم تحويل النص إلى صوت

### الأسباب المحتملة:

#### 1. gTTS غير مثبت
**الحل:**
```bash
pip install gtts
```

#### 2. الملف الصوتي موجود بالفعل
**السبب:** إذا كان هناك ملف صوتي موجود بالفعل، الإشارة لن تحول النص إلى صوت.

**الحل:** 
- إذا كنت تريد تحويل النص من PDF إلى صوت، احذف الملف الصوتي الموجود أولاً
- أو انتظر حتى يتم استخراج النص من PDF أولاً

#### 3. النص غير موجود
**السبب:** الإشارة تحتاج إلى `transcribed_text` (النص المفروغ) لتحويله إلى صوت.

**الحل:**
- تأكد من وجود ملف PDF أو نص في `text_content`
- تأكد من استخراج النص من PDF (يحدث تلقائياً)

#### 4. الإشارات لا تعمل
**الحل:**
- أعد تشغيل السيرفر: `python manage.py runserver`
- تأكد من أن `apps.py` يستورد الإشارات بشكل صحيح

### التحقق من الأخطاء:

افتح لوحة الإدارة وتحقق من:
1. وجود `transcribed_text` (النص المفروغ)
2. وجود `audio_file` (الملف الصوتي)
3. حالة الدرس `status`

### سجلات الأخطاء:

راجع سجلات Django للتحقق من الأخطاء:
- في لوحة الإدارة
- في Terminal/Shell حيث يعمل السيرفر