# 🔥 حزمة العرض التقديمي — PHOENIX AI

نسخة **مستقرة** للعرض الأولي. النماذج المعتمدة: **`exp6_best`** (تعرّف مغربي) + **`seg_best`** (تجزئة).
كل الميزات الخطرة مطفأة افتراضياً، وكل شيء قابل للرجوع عبر `env`.

---

## 📂 محتويات الحزمة
- `صور/` — صور المخطوطات الثلاث للعرض (واضحة / متوسطة / حواشٍ).
- `نصوص/` — النص المستخرج لكل صورة.
- `تحليل/` — شرح المصطلحات، التلخيص، العنوان، الكيانات، البحث، بدائل القراءة.
- `لقطات/` — ضع هنا لقطات الشاشة (انظر قائمة اللقطات أدناه).
- `المقارنات_الرقمية.md` — الأرقام للعرض.

---

## 🎬 ترتيب العرض خطوة بخطوة

### 1. المقدّمة (نصف دقيقة)
«منصة لتحقيق المخطوطات العربية بالذكاء الاصطناعي — تعرّف على الخط المغربي + أدوات فهم وتحليل.»

### 2. التعرّف على الخط (الأقوى)
- ارفع **`صور/واضحة_1926.jpg`** → يظهر النص المستخرج النظيف.
- أبرِز: **النموذج القديم كان يعطي نصاً بلا معنى؛ نموذجنا المغربي يقرأ بدقّة 92.5%** (`المقارنات_الرقمية.md`).
- اعرض **`صور/متوسطة_1977.jpg`** → نصّ طويل متماسك (قصص الخلق) = إقناع بصري قوي.

### 3. أدوات الفهم (شريط الأدوات)
على نص 1977:
- **📋 تلخيص + عنوان** → عنوان مقترح: «قصص الخلق وأول النور».
- **🏷️ استخراج الكيانات** → أعلام (وهب بن منبه، سفيان الثوري، ابن عباس...).
- **📖 شرح المصطلحات** → شرح اصطلاحي بالسياق.
- **🔍 بحث «الحوت»** → 5 مطابقات داخل المخطوطة.
(كلها محفوظة مسبقاً في `تحليل/متوسطة_1977.md` كخطة طوارئ.)

### 4. مراجعة ذكية — بدائل القراءة
- افتح سطراً مشكوكاً → **❓ بدائل** → اعرض كيف يرجّح النظام **«المقربين» بدل «المقربير»** (تصحيح صحيح، `تحليل/بدائل_القراءة.md`).

### 5. فصل المتن عن الحاشية
- اعرض **`صور/حواشٍ_1960.jpg`** → بدّل بين **📚 الكل / 📄 المتن / 📑 الحواشي**.
- أبرِز: الحواشي تُفصَل تنظيمياً **ولا تُحذف**، وتُصدَّر موسومة.

### 6. الفهرس (إن وقت سمح)
- بحث عن عنوان عمل → نُسخه ومواقعه (catalog).

---

## ⚡ السرعة — مهم جداً للعرض
**الحقيقة:** التعرّف يأخذ ~14–16 ثانية للصفحة الواحدة، والسبب **التجزئة العصبية (`blla`) ~11s** (متأصّلة في kraken، لا في إعداداتنا). لتجنّب الانتظار أمام الجمهور:

1. **سخّن الكاش قبل العرض (الأهم):** ارفع كل صورة من صور العرض **مرّة واحدة** في **«وضع مباشر»** قبل بدء العرض. النظام يحفظ النتيجة بصمة الصورة (cache)، فإعادة رفع **نفس الصورة** أثناء العرض تظهر **فوراً**.
2. **تأكّد من GPU:** التعرّف على GPU ~4s مقابل ~10s على CPU. تأكّد أن حاوية التشغيل ترى CUDA (`/api/system/info` يبيّن الجهاز).
3. تم تسريع طفيف: `CANDIDATES_ENABLED=false` (لا استخراج صور أسطر مُسبقاً؛ البدائل تعمل عند الطلب عبر الواجهة).

## 🆘 خطة الطوارئ
- **إذا تعطّل التشغيل المباشر أو بطؤ Docker:** اعرض مباشرةً الصور من `صور/` والنصوص من `نصوص/` ونتائج `تحليل/` — كلها جاهزة دون إنترنت ولا خادم.
- **ميزات الـ LLM (شرح/تلخيص/كيانات):** تحتاج إنترنت + مفتاح. **إن غاب المفتاح يردّ النظام رسالة لطيفة ولا ينهار** — والنتائج الجاهزة في `تحليل/` بديل كامل.
- **النتائج الرقمية:** كلها في `المقارنات_الرقمية.md`.

---

## ⚙️ إعدادات النسخة المستقرة (للرجوع)
| الإعداد | القيمة | للرجوع |
|---|---|---|
| نموذج التعرّف | `exp6_best.mlmodel` | `REC_MODEL_FILE` |
| نموذج التجزئة | `seg_best.mlmodel` | `SEG_MODEL_FILE` |
| `OCR_ENHANCE` | **`false`** (إصلاح مهم: تجزئة نظيفة وسريعة) | `OCR_ENHANCE=true` يعيد المعالجة العدوانية (لا يُنصح) |
| `USE_LM` | `false` (مطفأ للاستقرار) | `USE_LM=true` لتفعيله |
| `AUTO_CANDIDATES` | `false` | حسب الطلب فقط |
| فصل المتن/الحاشية | مفعّل (محافظ) | `MARGIN_CLASSIFY_ENABLED=false` |
| تصفية الضوضاء | مفعّلة (محافظة) | `SEG_FILTER_ENABLED=false` |

تشغيل الخادم: `cd backend && python run.py` (المنفذ 8001) → الواجهة على `/app`.

---

## 📸 قائمة اللقطات المطلوبة (التقطها في تجربة تمهيدية)
ضعها في `لقطات/`:
1. `01_تعرف_واضحة.png` — صفحة 1926 والنص المستخرج.
2. `02_تعرف_متوسطة.png` — صفحة 1977 (النص الطويل).
3. `03_تلخيص_عنوان.png` — نتيجة التلخيص.
4. `04_كيانات.png` — استخراج الأعلام/المصطلحات.
5. `05_شرح_مصطلحات.png` — الشرح.
6. `06_بحث.png` — نتائج البحث «الحوت».
7. `07_بدائل_قراءة.png` — نافذة البدائل (المقربين).
8. `08_فصل_حواشي.png` — أوضاع المتن/الحواشي على 1960.