backend/.env.example

# ────────────────────────────────────────────────
# Phoenix AI — إعدادات النظام (نسخة نموذجية)
# ────────────────────────────────────────────────
# انسخ هذا الملف إلى .env واملأ القيم الحقيقية:
#   cp .env.example .env
# ────────────────────────────────────────────────

# مفتاح API الخاص بـ OpenRouter (مطلوب للتصحيح والتحليل الذكي)
OPENROUTER_API_KEY=sk-or-v1-your-key-here

# مفتاح API الخاص بـ Google Gemini (مساعد الرؤية)
GOOGLE_GEMINI_KEY=your-gemini-key-here

# مفتاح OpenAI اختياري لبعض الموصلات الخارجية. لا تضع المفتاح الحقيقي في Git.
OPENAI_API_KEY=your-openai-key-here

# النماذج التي يطلبها LLMService عبر OpenRouter
LLM_MODEL_EASY=gpt-5.4-mini
LLM_MODEL_HARD=gpt-5.5

# تفعيل محرك القراءة البصري (Vision OCR)
# سنقوم بتعطيله لاستخدام نماذجك المحلية (Kraken)
USE_VISION_OCR=false

# ── GPU & Performance Settings ──
DEVICE=auto
USE_FP16=true
MAX_IMAGE_SIZE=2500
MAX_UPLOAD_MB=20
TASK_WORKERS=1

# OCR routing profile: auto | default | logic
SEGMENTATION_PROFILE=auto
RECOGNITION_PROFILE=auto
LOGIC_SEG_MODEL_FILE=logic_philosophy_v2_seg.mlmodel
LOGIC_REC_MODEL_FILE=logic_philosophy_v2_rec.mlmodel

# نموذج العرض المنشور — exp9، مع بصمة تمنع تشغيل ملف مختلف بالاسم نفسه.
REC_MODEL_FILE=phoenix_htr_exp9_multidomain_81_2896fef9.mlmodel
REC_MODEL_EXPECTED_SHA256=2896fef9d9665cbb82fba8faa3bf0c628ac6a5cc62eb678f40c707db833aebea
SEG_MODEL_FILE=seg_finetuned_v4.mlmodel

# النموذج العام النظيف تجاه validation. لا تجعل char8_trainval افتراضياً:
# فهو مدرّب على validation ويُبطل أي ضبط أو قياس عليها.
LM_FILE=char8_visual.lm
LM_LOGIC_FILE=char8_logic_selftrained.lm
LM_ARCHIVE_FILE=char8_general_archive_mixed.lm
LM_ARCHIVE_AUTO_APPLY=false
LM_UNKNOWN_DOMAIN_POLICY=greedy
USE_GATED_LM=true
LM_GENERAL_CONF_MIN=0.82
LM_GENERAL_CONF_THRESHOLD=0.88

# ── خط معالجة بسيط كـ eScriptorium ──
# افتراضياً: تعطيل تصحيح الميلان (deskew) والتصغير (resize) لمطابقة سلوك eScriptorium وتفادي تشوه الخط العربي
OCR_AUTO_DESKEW=false
OCR_RESIZE=true

# بدائل القراءة البصرية (الدرجة نسبية داخل الشعاع، وليست احتمال صحة)
CANDIDATES_ENABLED=true
AUTO_CANDIDATES=false
CANDIDATES_MAX_K=8
CANDIDATES_BEAM=10