# وضع العرض للمسابقة

## الهدف

إظهار قوة المعمارية في رحلة واحدة واضحة من الصورة إلى قرار الباحث ثم إلى مخرج قابل لإعادة الاستعمال، من دون حذف أدوات النظام أو عرض درجات غير معايرة كأنها احتمالات.

## الرحلة الظاهرة

1. تفريغ الصفحة وإظهار الأسطر وإحداثياتها.
2. فتح قائمة المراجعة وترتيب مواضع الشك.
3. موازنة الدليل البصري والترجيح اللغوي وشواهد المصادر والاقتراح الخارجي.
4. تسجيل قبول الباحث أو تعديله أو رفضه.
5. تصدير PAGE-XML أو TEI أو حزمة تدريب مراجعة.

## ما أُضيف

- زر `وضع العرض` في رأس التطبيق.
- لوحة تقدم من خمس مراحل مع إجراء تالٍ واضح.
- مؤشرات محلية للصفحة: الأسطر، قائمة المراجعة، تدخلات النموذج اللغوي، قنوات الأدلة، قرارات الباحث، وشواهد المصادر.
- إخفاء الأدوات الثانوية أثناء العرض مع إمكانية إظهارها فوراً.
- تخزين لوحة أدلة السطر في الواجهة لتجنب إعادة طلبها عند فتح السطر نفسه.
- حذف صياغة نسبة الثقة غير المعايرة من وصف تدخل النموذج اللغوي.
- معرض من أربع صفحات صعبة ومتنوعة: حواشٍ وحبر أحمر، فقه باهت شديد الكثافة، تاريخ داخل إطار، وموسيقى بعناوين ملونة.
- تشغيل الصفحات على الصور الأصلية ومضلعات PAGE-XML البشرية عبر مسار `recognize_manual` الحقيقي.
- كاش موقّع بمحتوى الصورة وXML وتوقيع خط الأنابيب؛ يتبطل تلقائياً عند تغيير النموذج أو الإعدادات.
- بطاقة لكل صفحة تقترح مسار ميزات مختلفاً كي لا يصبح العرض تكراراً لنفس الأزرار.

## حدود الادعاء

المؤشرات تصف أحداث الصفحة الحالية ولا تمثل CER أو دقة أو احتمالاً معايراً. درجات المرشحات تبقى درجات نسبية داخل آلية فك الترميز.

صفحات المعرض أمثلة تطوير سبق فتحها واختيارها، وليست مجموعة اختبار نهائية. النص داخل PAGE-XML لا يدخل التعرّف؛ تُستخدم هندسة السطور فقط، والنص المعروض ناتج النموذج.

### سبب اختيار الصفحات

اختيرت الصفحات قبل بناء المعرض من قياس داخلي سابق لمسار PAGE-XML اليدوي مقابل تفريغ بشري، محفوظ في
`reports/eval_manual_FINAL_cleanLM_20260807_044439_lines.csv`:

| الصفحة | التحدي البصري | CER الصفحة السابق |
|---|---|---:|
| `BULAC_MS_ARA_1977_0022` | متن كثيف وحواشٍ وحبر أحمر | 3.61% |
| `BULAC_MS_ARA_1943_180494` | كتابة باهتة صغيرة وكثيفة | 5.60% |
| `BULAC_MS_ARA_417_0076` | صفحة تاريخية داخل إطار | 3.61% |
| `BULAC_MS_ARA_1977_0190` | مصطلحات موسيقية وعناوين حمراء | 3.32% |

هذه الأرقام **دليل اختيار داخلي لا نتيجة نهائية للمسابقة**؛ الصفحات مكشوفة للتطوير، والبروتوكول السابق يخص النموذج السابق. بعد اعتماد `exp8` يجب إعادة تشغيل الصفحات الأربع بالتوقيع الجديد، وفحص النص بصرياً، وتسخين الكاش، واستبعاد أي صفحة لا يبقى تفريغها مناسباً للعرض.

## التحقق

- فحص نحوي لملفات JavaScript الخمسة، بما فيها وضع العرض وService Worker.
- اختبار بمتصفح Chrome حقيقي: الدخول إلى وضع العرض، إظهار الأدوات الكاملة، ثم الخروج والعودة إلى الواجهة العادية.
- اختبار عقد الأحداث لكل مراحل الرحلة على خادم واجهة ثابت لا يستخدم GPU.
- الاختبار الطرفي مع OCR الحقيقي مؤجل إلى ما بعد انتهاء تدريب `exp8` ودمج هذا الفرع في فرع العرض.

## الدمج

العمل معزول في الفرع `feature/competition-demo` ولا يلمس فرع التدريب أو نموذج العرض الحالي. يُدمج بعد انتهاء التدريب ثم تُعاد رحلة المتصفح على الخادم الحقيقي.