feat: complete platform — auth, deployment, hardening

- Supabase Auth: login/register/forgot-password/reset-password pages
- JWT verification: ES256/JWKS + HS256 fallback in auth_middleware
- RLS: analyses + chat_messages protected via row-level security
- Session ownership enforcement on all data endpoints
- Frontend auth: Bearer token auto-injected via lib/api.ts
- Profile + Settings pages
- Docker production setup: Nginx + Let's Encrypt + Certbot
- GitHub Actions CI/CD for auto-deploy to Oracle Cloud
- deploy.sh: one-command server setup and updates

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.env.example

@@ -0,0 +1,30 @@
+# ── LLM / AI ──────────────────────────────────────────────────────────────
+GROQ_API_KEY=gsk_...
+COHERE_API_KEY=...
+
+# ── Supabase ───────────────────────────────────────────────────────────────
+SUPABASE_URL=https://<project-id>.supabase.co
+SUPABASE_KEY=eyJ...
+SUPABASE_DB_URL=postgresql+psycopg://<user>:<password>@<host>:5432/postgres
+
+# ── Google Cloud ───────────────────────────────────────────────────────────
+GOOGLE_VISION_API_KEY=AIza...
+GOOGLE_TTS_KEY=AIza...
+
+# ── Voice TTS (optional — gTTS used as free fallback) ─────────────────────
+ELEVENLABS_API_KEY=...
+
+# ── App ────────────────────────────────────────────────────────────────────
+ENVIRONMENT=production
+FRONTEND_URL=https://your-domain.com
+NEXT_PUBLIC_API_URL=https://your-domain.com/api
+
+# ── Next Auth (required if next-auth is enabled) ──────────────────────────
+NEXTAUTH_URL=https://your-domain.com
+NEXTAUTH_SECRET=change-me-32-chars-minimum
+
+# ── Monitoring ─────────────────────────────────────────────────────────────
+SENTRY_DSN=https://...@o...ingest.sentry.io/...
+
+# ── Audit logs ─────────────────────────────────────────────────────────────
+AUDIT_LOG_DIR=logs/audit

.env.production.example

@@ -0,0 +1,27 @@
+# ══════════════════════════════════════════════════════
+# تبيان الطبي — Production Environment Variables
+# Copy to .env on your server and fill in the values
+# ══════════════════════════════════════════════════════
+
+# ─── LLM ────────────────────────────────────────────
+GROQ_API_KEY=gsk_...
+
+# ─── Cohere (reranking + embeddings fallback) ────────
+COHERE_API_KEY=...
+
+# ─── Supabase ────────────────────────────────────────
+SUPABASE_URL=https://xxxx.supabase.co
+SUPABASE_KEY=eyJ...           # anon/public key
+SUPABASE_SERVICE_KEY=eyJ...   # service_role key (bypasses RLS)
+SUPABASE_JWT_SECRET=...       # JWT Settings → JWT Secret
+SUPABASE_DB_URL=postgresql+psycopg://postgres.xxxx:PASSWORD@aws-0-...pooler.supabase.com:5432/postgres
+
+# ─── Frontend URL (used by backend CORS) ─────────────
+FRONTEND_URL=https://yourdomain.com
+NEXT_PUBLIC_BACKEND_URL=/     # Use / so Nginx routes /api → backend
+
+# ─── App ─────────────────────────────────────────────
+ENVIRONMENT=production
+
+# ─── Optional monitoring ─────────────────────────────
+SENTRY_DSN=

.github/workflows/deploy.yml

@@ -0,0 +1,41 @@
+name: Deploy to Production
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    name: Deploy to Oracle Cloud
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Deploy via SSH
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host:     ${{ secrets.SERVER_HOST }}
+          username: ${{ secrets.SERVER_USER }}
+          key:      ${{ secrets.SERVER_SSH_KEY }}
+          port:     22
+          script: |
+            set -e
+            cd /opt/tebyan
+
+            echo "── Pulling latest code ──"
+            git pull origin main
+
+            echo "── Building and restarting ──"
+            docker compose -f docker-compose.prod.yml build --pull --no-cache backend frontend
+            docker compose -f docker-compose.prod.yml up -d
+
+            echo "── Waiting for health checks ──"
+            sleep 15
+            curl -sf http://localhost/health | python3 -m json.tool
+
+            echo "── Deploy complete ──"
+            docker compose -f docker-compose.prod.yml ps

.gitignore

@@ -35,3 +35,34 @@ frontend/.vercel/
 # OS
 .DS_Store
 Thumbs.db
+
+# Logs
+logs/
+*.log
+backend/logs/
+backend_log.txt
+
+# Test / temp files
+backend/test_*.png
+backend/test_*.jpg
+backend/eval_results.json
+backend/test_set.json
+
+# pip install artifacts (=version files created by mistake)
+=*
+backend/=*
+
+# Office docs
+*.docx
+*.doc
+~$*
+
+# tsbuildinfo
+frontend/tsconfig.tsbuildinfo
+
+# Large data dirs not needed in prod
+assets/
+books/
+data/
+mine/
+temp/

AGENTS.md

@@ -0,0 +1,145 @@
+# تبيان الطبي — Agent System
+
+## Overview
+
+The multi-agent pipeline in `backend/services/agents/` processes each medical file through five sequential agents. Each agent reads from and writes to a shared `AgentContext` dataclass, making the full pipeline observable and independently testable.
+
+---
+
+## Base Classes (`agents/base.py`)
+
+### `AgentContext`
+
+Shared state object threaded through all agents. Key fields:
+
+| Field | Type | Set by |
+|---|---|---|
+| `file_bytes` | `bytes` | Coordinator |
+| `file_type` | `"pdf" \| "image"` | Coordinator |
+| `raw_text` | `str` | OCRAgent |
+| `findings` | `list[dict]` | ExtractionAgent |
+| `panel_code` | `str` | ClassificationAgent |
+| `rag_context` | `str` | MedicalReasoningAgent |
+| `report` | `dict` | MedicalReasoningAgent |
+| `logs` | `list[AgentLogEntry]` | All agents |
+
+### `AgentBase`
+
+Abstract base with:
+- **Retry logic**: up to `max_retries=2` attempts with `0.3 s × 2^attempt` backoff
+- **`_on_failure(ctx, exc)`**: each subclass overrides to provide a safe fallback when all retries fail
+- **Timing**: each `run()` call records `duration_ms` in `AgentLogEntry`
+
+---
+
+## Agents
+
+### 1. `OCRAgent`
+
+**File**: `agents/ocr_agent.py`
+
+**Input**: `ctx.file_bytes`, `ctx.file_type`
+**Output**: `ctx.raw_text`
+
+**Strategy**:
+- PDF: extracts text with PyMuPDF (`fitz`); falls back to EasyOCR page-by-page if text layer is empty
+- Image: tries Google Cloud Vision first (higher accuracy for Arabic); falls back to EasyOCR with contrast/sharpness preprocessing
+
+**Failure mode**: sets `raw_text = ""` — downstream agents handle empty text gracefully.
+
+---
+
+### 2. `ExtractionAgent`
+
+**File**: `agents/extraction_agent.py`
+
+**Input**: `ctx.raw_text`
+**Output**: `ctx.findings` (list of `{name, value, unit, range, status}`)
+
+**Strategy**:
+1. Regex patterns matching common Arabic/English lab report formats
+2. LLM extraction via Groq if regex yields < 2 findings
+3. Physiological bounds filter (`_validators.py`) removes impossible values (e.g., hemoglobin = 400)
+4. Deduplication by normalized test name
+
+**Failure mode**: sets `findings = []`.
+
+---
+
+### 3. `ClassificationAgent`
+
+**File**: `agents/classification_agent.py`
+
+**Input**: `ctx.findings`, `ctx.raw_text`
+**Output**: `ctx.panel_code`, `ctx.panel_confidence`
+
+**Strategy**: Uses `services/classifier.py` which scores text against panel-specific keyword sets. Falls back to `detect_panel()` heuristic if primary classifier returns low confidence.
+
+**Panels**: `cbc`, `thyroid`, `liver`, `kidney`, `lipid`, `diabetes`, `urine`, `mixed`
+
+**Failure mode**: sets `panel_code = "mixed"` (general analysis).
+
+---
+
+### 4. `MedicalReasoningAgent`
+
+**File**: `agents/reasoning_agent.py`
+
+**Input**: `ctx.findings`, `ctx.panel_code`, `ctx.analysis_type`
+**Output**: `ctx.rag_context`, `ctx.report`
+
+**Strategy**:
+1. Checks `rag_cache` (TTL 5 min) for identical query
+2. Retrieves relevant medical knowledge via `Retriever` (BM25 + pgvector + Cohere rerank)
+3. Selects panel-specific prompt template from `prompts/`
+4. Calls Groq `llama-3.3-70b-versatile` with findings + RAG context
+5. Parses JSON response into structured report
+
+**Failure mode**: generates a fallback report from raw findings without LLM, appends disclaimer.
+
+---
+
+### 5. `SafetyAgent`
+
+**File**: `agents/safety_agent.py`
+
+**Input**: `ctx.report`
+**Output**: `ctx.report` (filtered in-place)
+
+**Strategy**: Applies `services/safety.filter_analysis_report()` which:
+- Removes diagnostic certainty claims ("you have diabetes")
+- Adds standard medical disclaimer
+- Detects emergency patterns (very high/low critical values) and prepends urgent notice
+
+**Failure mode**: appends `DISCLAIMER_AR` manually to ensure minimum safety even if filter itself errors.
+
+---
+
+## `AgentCoordinator` (`agents/coordinator.py`)
+
+Instantiates all five agents and runs them in sequence. Returns `CoordinatorResult`:
+
+```python
+@dataclass
+class CoordinatorResult:
+    findings:   list[dict]
+    summary:    str
+    report:     dict
+    panel_code: str
+    logs:       list[dict]   # exposed in dev mode via _agents field
+    ok:         bool
+    error:      str
+    total_ms:   float
+```
+
+The coordinator is loaded once via `@lru_cache` and reused across requests. Agent instances are stateless — all state lives in the per-request `AgentContext`.
+
+---
+
+## Adding a New Agent
+
+1. Create `agents/my_agent.py`, subclass `AgentBase`
+2. Implement `_execute(self, ctx: AgentContext) -> AgentContext`
+3. Implement `_on_failure(self, ctx, exc)` with a safe fallback
+4. Add new fields to `AgentContext` if needed
+5. Register in `AgentCoordinator.__init__()` agent list at the correct position

API_REFERENCE.md

@@ -0,0 +1,245 @@
+# تبيان الطبي — API Reference
+
+Base URL: `http://localhost:8000` (dev) / `https://your-domain.com` (prod)
+
+All endpoints return JSON unless noted. Arabic text is UTF-8 encoded.
+
+---
+
+## `POST /api/analyze`
+
+Analyze a medical lab report image or PDF.
+
+**Request**: `multipart/form-data`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `file` | File | Yes | PDF or image (JPEG/PNG/WEBP/TIFF). Max 20 MB. |
+| `analysis_type` | string | No | One of: `شامل`, `دم شامل`, `سكر وكوليسترول`, `كلى وكبد`, `هرمونات`, `بول`. Default: `شامل` |
+
+**Response** `200`
+```json
+{
+  "findings": [
+    { "name": "Hemoglobin", "value": "10.2", "unit": "g/dL", "range": "12-16", "status": "low" }
+  ],
+  "summary": "تُظهر نتائجك انخفاضاً في الهيموجلوبين...",
+  "report": {
+    "general": "الحالة العامة...",
+    "abnormal_details": [{ "اسم_الفحص": "Hemoglobin", "الشرح": "..." }],
+    "tips": ["..."],
+    "tips_categorized": [{ "category": "التغذية", "tips": ["..."] }]
+  }
+}
+```
+
+**Errors**: `400` bad file, `413` file too large, `415` unsupported type, `422` analysis failed, `429` rate limit (5/min)
+
+---
+
+## `POST /api/chat`
+
+Stream an Arabic medical assistant response.
+
+**Request**: `application/json`
+```json
+{
+  "query": "ماذا يعني انخفاض الهيموجلوبين؟",
+  "history": [{ "role": "user", "content": "..." }, { "role": "assistant", "content": "..." }],
+  "analysis_context": "{\"findings\": [...], \"summary\": \"...\"}"
+}
+```
+
+**Response**: `text/plain; charset=utf-8` — streaming text chunks (Server-Sent Events compatible)
+
+**Rate limit**: 30/min per IP
+
+---
+
+## `POST /api/risk`
+
+Assess disease risk from lab findings.
+
+**Request**: `application/json`
+```json
+{
+  "findings": [
+    { "name": "Glucose", "value": "126", "unit": "mg/dL", "range": "70-100", "status": "high" }
+  ]
+}
+```
+
+**Response** `200`
+```json
+{
+  "risks": [
+    {
+      "condition": "diabetes",
+      "score": 72,
+      "level": "high",
+      "confidence": 0.85,
+      "label_ar": "السكري",
+      "factors": ["ارتفاع سكر الصيام"],
+      "recommendation": "استشر طبيبك لإجراء اختبار HbA1c",
+      "source": "rule"
+    }
+  ],
+  "top_risk": { ... },
+  "overall_ar": "توجد مؤشرات تستوجب المتابعة الطبية",
+  "features_used": 12
+}
+```
+
+**Conditions scored**: `diabetes`, `cardiovascular`, `anemia`, `kidney`, `liver`, `thyroid`
+
+---
+
+## `POST /api/voice/transcribe`
+
+Transcribe Arabic audio to text using Whisper.
+
+**Request**: `multipart/form-data`
+
+| Field | Type | Description |
+|---|---|---|
+| `audio` | File | Audio file. Formats: WebM, MP4, OGG, WAV, FLAC, M4A. Max 25 MB. |
+| `language` | string | Language hint. Default: `ar` |
+
+**Response** `200`
+```json
+{ "text": "ماذا يعني ارتفاع الكوليسترول؟", "language": "ar" }
+```
+
+---
+
+## `POST /api/voice/synthesize`
+
+Convert Arabic text to speech (MP3).
+
+**Request**: `application/json`
+```json
+{ "text": "نتائج تحليلك تُظهر..." }
+```
+
+**Response**: `audio/mpeg` binary (MP3). Max input: 3000 characters.
+
+---
+
+## `POST /api/voice/chat`
+
+Voice-to-voice chat: transcribe audio → chat → synthesize response.
+
+**Request**: `multipart/form-data`
+
+| Field | Type | Description |
+|---|---|---|
+| `audio` | File | Audio file (same formats as transcribe) |
+| `analysis_context` | string | JSON string of last analysis result (optional) |
+
+**Response**: `audio/mpeg` binary — spoken Arabic assistant response.
+
+---
+
+## `POST /api/search`
+
+Semantic search across saved analyses.
+
+**Request**: `application/json`
+```json
+{
+  "query": "ارتفاع الكوليسترول",
+  "analyses": [
+    { "id": "uuid", "summary": "...", "findings_text": "Hemoglobin Glucose ..." }
+  ]
+}
+```
+
+**Response** `200`
+```json
+{ "scores": { "uuid-1": 0.82, "uuid-2": 0.31 } }
+```
+
+**Rate limit**: 60/min per IP
+
+---
+
+## `POST /api/analyses/save`
+
+Save an analysis result for a session.
+
+**Request**: `application/json`
+```json
+{
+  "session_id": "local_abc123",
+  "findings": [...],
+  "summary": "...",
+  "report": { ... }
+}
+```
+
+**Response** `200`: `{ "success": true, "data": [...] }`
+
+---
+
+## `GET /api/analyses/list`
+
+List saved analyses for a session.
+
+**Query params**: `session_id`, `profile_name` (optional), `limit` (default 20)
+
+**Response** `200`: `{ "analyses": [...] }`
+
+---
+
+## `GET /health`
+
+System health check.
+
+**Response** `200`
+```json
+{
+  "ok": true,
+  "version": "local",
+  "environment": "development",
+  "uptime_s": 3600,
+  "db": { "ok": true, "chunks": 2834, "source": "pgvector/supabase" },
+  "model": { "name": "intfloat/multilingual-e5-large", "loaded": true },
+  "services": { "groq": true, "cohere": true, "vision": false }
+}
+```
+
+---
+
+## `GET /api/metrics`
+
+Prometheus-format plaintext metrics.
+
+**Response** `200` `text/plain; version=0.0.4`
+```
+# HELP tebyan_uptime_seconds Seconds since server start
+tebyan_uptime_seconds 3600
+# HELP tebyan_requests_total Total HTTP requests per path
+tebyan_requests_total{path="/api/analyze"} 42
+tebyan_rag_cache_size 18
+tebyan_rag_cache_hits 156
+```
+
+---
+
+## Error Format
+
+All errors use standard HTTP status codes with a JSON body:
+
+```json
+{ "detail": "وصف الخطأ بالعربية أو الإنجليزية" }
+```
+
+| Code | Meaning |
+|---|---|
+| 400 | Bad request (empty file, invalid input) |
+| 413 | File too large (> 20 MB) |
+| 415 | Unsupported media type |
+| 422 | Analysis failed (OCR/LLM error) |
+| 429 | Rate limit exceeded |
+| 500 | Internal server error |
+| 503 | External service unavailable |

ARCHITECTURE.md

@@ -0,0 +1,112 @@
+# تبيان الطبي — Architecture
+
+## System Overview
+
+Tebyan Medical is a production-grade Arabic medical report analysis platform. Users upload lab reports (PDF or image), the system extracts findings, generates a clinical interpretation in Arabic, and provides an interactive voice-enabled chat assistant.
+
+```
+Frontend (Next.js 15)          Backend (FastAPI)              External Services
+─────────────────────          ─────────────────              ─────────────────
+Upload → /api/analyze ────────► AgentCoordinator              Groq (LLM/STT)
+Chat   → /api/chat   ────────► RAG + LLM streaming            Supabase (pgvector)
+Voice  → /api/voice  ────────► WhisperSTT / TTS               Cohere (rerank)
+Risk   → /api/risk   ────────► RiskEngine                     Google Vision/TTS
+```
+
+---
+
+## Backend Layer
+
+### Entry Point
+
+`backend/main.py` — FastAPI application. Registers all routes, mounts middleware, and wires dependency-injected singletons via `@lru_cache`.
+
+### Multi-Agent Pipeline (`services/agents/`)
+
+Replaces the flat `services/agent/pipeline.py` (kept for backward compat) with a structured agent graph:
+
+```
+AgentCoordinator
+├── OCRAgent           — PDF (fitz + EasyOCR) + Image (Google Vision fallback)
+├── ExtractionAgent    — regex parse → LLM fallback → physiological bounds filter
+├── ClassificationAgent — panel detection (CBC, Thyroid, Liver, Kidney, Lipid, Diabetes)
+├── MedicalReasoningAgent — RAG retrieval + panel-specific LLM prompt
+└── SafetyAgent        — PDPL/NDMO compliance filter + emergency detection
+```
+
+Each agent extends `AgentBase` which provides retry-with-backoff and structured logging via `AgentContext`.
+
+### RAG Stack (`services/rag/`, `services/search/`)
+
+- **Embedding**: `intfloat/multilingual-e5-large` (1024-dim, via HuggingFace)
+- **Vector store**: Supabase pgvector (`match_documents` RPC, 2834+ medical chunks)
+- **Query expansion**: Groq LLM generates 3 alternate queries; `query_parser.py` adds Arabic synonym expansions
+- **Retrieval**: BM25 fallback + Cohere `rerank-v3.5` cross-encoder
+- **Cache**: 5-minute TTL in-memory LRU (`services/cache.py`) prevents redundant embedding calls
+
+### Risk Engine (`services/risk/`)
+
+Evidence-based clinical threshold scoring for 6 conditions. `FeatureExtractor` normalises findings into a 35-feature vector; each scorer (`_score_diabetes`, `_score_cardiovascular`, etc.) applies WHO/ADA/ACC clinical cutoffs. ML `.pkl` model files in `services/risk/models/` override rule-based scores when present.
+
+### Voice (`services/voice/`)
+
+- **STT**: `WhisperSTT` wraps Groq `whisper-large-v3`. Accepts WebM/MP4/OGG/WAV (25 MB max).
+- **TTS**: Provider chain — Google Cloud TTS (Wavenet-A) → gTTS (free fallback) → ElevenLabs.
+
+### LLM Router (`services/llm/router.py`)
+
+`LLMRouter` wraps a primary provider (`GroqProvider`) and optional fallback (`HuggingFaceProvider`). Model selection: `llama-3.3-70b-versatile` for analysis, `llama-3.1-8b-instant` for chat.
+
+### Security (`middleware/`)
+
+- **`AuditMiddleware`**: Writes one JSON record per request to rotating log files (`logs/audit/audit.jsonl`). Marks PDPL-sensitive paths. Skips health/docs endpoints.
+- **`validate_upload`**: Magic-byte sniffing (anti-MIME-spoofing), 20 MB size limit, extension blocklist.
+- **`sanitize_text`**: Strips HTML tags, null bytes, XSS patterns, and SQL injection signatures from all user text inputs.
+
+### Rate Limiting (`services/ratelimit.py`)
+
+In-memory sliding window (no external dependency). Limits: analyze=5/min, chat=30/min, search=60/min. Uses `X-Forwarded-For` for IP detection behind proxies.
+
+---
+
+## Frontend Layer
+
+**Next.js 15 App Router**, RTL Arabic, Tailwind CSS v4, Framer Motion.
+
+| Component | Purpose |
+|---|---|
+| `upload-section.tsx` | File picker + `/api/analyze` call + loading state |
+| `analysis-history.tsx` | Saved analyses list + semantic search + health trend chart |
+| `health-trend-chart.tsx` | Recharts line chart — tracks lab values over time with alerts |
+| `risk-dashboard.tsx` | Calls `/api/risk` + renders 6 radial gauge cards (collapsible) |
+| `chat-bot.tsx` | Floating chat panel — streaming SSE + voice input/output |
+| `voice-recorder.tsx` | MediaRecorder → `/api/voice/transcribe` + TTS playback |
+| `compare-analyses.tsx` | Side-by-side analysis diff |
+
+---
+
+## Data Flow — Analysis Request
+
+```
+1. User uploads PDF/image
+2. validate_upload() — size + MIME + magic bytes
+3. AgentCoordinator.run()
+   a. OCRAgent       → raw_text
+   b. ExtractionAgent → findings[] (with impossible-value filter)
+   c. ClassificationAgent → panel_code
+   d. MedicalReasoningAgent → RAG context + LLM report
+   e. SafetyAgent    → filtered report
+4. Response: { findings, summary, report }
+5. Frontend saves to Supabase via /api/analyses/save
+6. RiskDashboard calls /api/risk with findings
+```
+
+---
+
+## Key Design Decisions
+
+- **No streaming for analysis**: Analysis takes 8–15 s; streaming a partial JSON would be malformed. Response is returned in full after all agents complete.
+- **RAG cache before agent**: MedicalReasoningAgent checks `rag_cache` before calling pgvector — avoids redundant 300 ms embedding round-trips on identical queries.
+- **Agents over monolith**: Each agent is independently retryable and observable via `AgentContext.logs`. Failures degrade gracefully — OCR failure sets `raw_text=""`, downstream agents handle empty input without crashing.
+- **Rule-based risk scoring**: ML `.pkl` models are optional overrides. The platform is useful immediately without training data.
+- **In-memory rate limiter**: Avoids Redis dependency for MVP. Replace with Redis-backed limiter for multi-process deployments.

DEPLOYMENT.md

@@ -0,0 +1,230 @@
+# تبيان الطبي — Deployment Guide
+
+## Prerequisites
+
+- Docker ≥ 24 + Docker Compose v2
+- A server with ≥ 4 GB RAM, ≥ 20 GB disk
+- Domain name with DNS pointed to your server (for HTTPS)
+
+---
+
+## 1. Environment Setup
+
+Copy and populate the environment file:
+
+```bash
+cp .env.example .env
+```
+
+Required variables:
+
+```
+GROQ_API_KEY=gsk_...
+SUPABASE_URL=https://<project>.supabase.co
+SUPABASE_KEY=eyJ...
+SUPABASE_DB_URL=postgresql+psycopg://...
+FRONTEND_URL=https://your-domain.com
+NEXTAUTH_SECRET=<32+ random chars>
+```
+
+Optional (features degrade gracefully without them):
+
+```
+COHERE_API_KEY=...          # reranking (falls back to BM25 only)
+GOOGLE_VISION_API_KEY=...   # Vision OCR (falls back to EasyOCR)
+GOOGLE_TTS_KEY=...          # Google TTS (falls back to gTTS)
+ELEVENLABS_API_KEY=...      # ElevenLabs TTS
+SENTRY_DSN=...              # Error monitoring
+```
+
+---
+
+## 2. Nginx Configuration
+
+Create `nginx/nginx.conf`:
+
+```nginx
+events { worker_connections 1024; }
+
+http {
+    upstream backend  { server backend:8000; }
+    upstream frontend { server frontend:3000; }
+
+    server {
+        listen 80;
+        server_name your-domain.com;
+        return 301 https://$host$request_uri;
+    }
+
+    server {
+        listen 443 ssl;
+        server_name your-domain.com;
+
+        ssl_certificate     /etc/nginx/certs/fullchain.pem;
+        ssl_certificate_key /etc/nginx/certs/privkey.pem;
+
+        client_max_body_size 25M;
+
+        location /api/    { proxy_pass http://backend; proxy_set_header Host $host; }
+        location /health  { proxy_pass http://backend; }
+        location /        { proxy_pass http://frontend; proxy_set_header Host $host; }
+    }
+}
+```
+
+Place TLS certificates in `nginx/certs/` (Let's Encrypt recommended).
+
+---
+
+## 3. Frontend Dockerfile
+
+Create `frontend/Dockerfile`:
+
+```dockerfile
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+ARG NEXT_PUBLIC_API_URL
+ENV NEXT_PUBLIC_API_URL=$NEXT_PUBLIC_API_URL
+RUN npm run build
+
+FROM node:20-alpine
+WORKDIR /app
+COPY --from=builder /app/.next/standalone ./
+COPY --from=builder /app/.next/static ./.next/static
+COPY --from=builder /app/public ./public
+ENV PORT=3000
+EXPOSE 3000
+CMD ["node", "server.js"]
+```
+
+Enable standalone output in `next.config.js`:
+
+```js
+module.exports = { output: "standalone" }
+```
+
+---
+
+## 4. Deploy
+
+```bash
+# Build and start all services
+docker compose -f docker-compose.prod.yml up -d --build
+
+# Check logs
+docker compose -f docker-compose.prod.yml logs -f backend
+
+# Check health
+curl https://your-domain.com/health
+```
+
+---
+
+## 5. Supabase Setup
+
+Run once to set up the pgvector extension and required tables:
+
+```sql
+-- Enable pgvector
+create extension if not exists vector;
+
+-- Documents table for RAG
+create table if not exists documents (
+  id         bigserial primary key,
+  content    text,
+  embedding  vector(1024),
+  metadata   jsonb
+);
+create index on documents using ivfflat (embedding vector_cosine_ops) with (lists = 100);
+
+-- match_documents RPC
+create or replace function match_documents(
+  query_embedding vector(1024),
+  match_count     int default 10,
+  filter          jsonb default '{}'
+)
+returns table(id bigint, content text, metadata jsonb, similarity float)
+language plpgsql as $$
+begin
+  return query
+  select d.id, d.content, d.metadata,
+         1 - (d.embedding <=> query_embedding) as similarity
+  from documents d
+  order by d.embedding <=> query_embedding
+  limit match_count;
+end;
+$$;
+
+-- Analyses table
+create table if not exists analyses (
+  id         uuid default gen_random_uuid() primary key,
+  session_id text not null,
+  findings   jsonb,
+  summary    text,
+  report     jsonb,
+  created_at timestamptz default now()
+);
+create index on analyses(session_id, created_at desc);
+```
+
+---
+
+## 6. PEFT/LoRA Fine-Tuning (Optional)
+
+To improve Arabic medical analysis quality with your own data:
+
+```bash
+# 1. Prepare dataset from Supabase analyses
+python training/prepare_dataset.py --source supabase --output_dir data/
+
+# 2. Train LoRA adapter (requires GPU with ≥16 GB VRAM)
+python training/train_lora.py \
+    --model_name core42/jais-13b-chat \
+    --data_dir data/ \
+    --output_dir checkpoints/tebyan-v1 \
+    --num_epochs 3 \
+    --load_4bit
+
+# 3. Evaluate
+python training/evaluate_model.py \
+    --base_model core42/jais-13b-chat \
+    --lora_adapter checkpoints/tebyan-v1/lora_adapter \
+    --val_data data/val.jsonl \
+    --use_llm_judge \
+    --groq_key $GROQ_API_KEY
+```
+
+Results are written to `eval_results/eval_summary.json`.
+
+---
+
+## 7. Monitoring
+
+The `/api/metrics` endpoint exposes Prometheus-format metrics. Scrape with:
+
+```yaml
+# prometheus.yml
+scrape_configs:
+  - job_name: tebyan
+    static_configs:
+      - targets: ['your-domain.com']
+    metrics_path: /api/metrics
+    scheme: https
+```
+
+Audit logs are written to the `audit_logs` Docker volume at `logs/audit/audit.jsonl` (rotating, max 50 MB × 10 files).
+
+---
+
+## 8. Updating
+
+```bash
+git pull
+docker compose -f docker-compose.prod.yml up -d --build --no-deps backend
+docker compose -f docker-compose.prod.yml up -d --build --no-deps frontend
+```
+
+The `--no-deps` flag updates only the specified service without restarting nginx or volumes.

app.py

@@ -1,726 +0,0 @@
-import os
-os.environ['TRANSFORMERS_VERBOSITY'] = 'error'
-import io
-import streamlit as st
-import google.generativeai as genai
-import numpy as np
-from PIL import Image
-import fitz
-import easyocr
-import re
-from langchain_huggingface import HuggingFaceEmbeddings
-from langchain_community.vectorstores import Chroma
-
-# --- 1. الإعدادات ---
-os.environ['HF_HOME'] = r'D:\Project\model_cache'
-API_KEY = "AIzaSyDA4UjdmbAAGGgdrYLYRQtJYHrnawYdka4"
-genai.configure(api_key=API_KEY)
-
-st.set_page_config(page_title="تبيان الطبي", layout="wide", page_icon="🩺")
-
-# معالجة رسائل الشات في أول الصفحة
-_chat_q = st.query_params.get("q", "")
-if _chat_q:
-    if "chat_msgs" not in st.session_state:
-        st.session_state.chat_msgs = [{"role":"bot","text":"مرحباً! أنا مساعدك الطبي 🩺"}]
-    st.session_state.chat_msgs.append({"role":"user","text":_chat_q})
-    st.query_params.clear()
-
-# --- 2. CSS ---
-# إخفاء مساحة iframe الشات
-st.markdown("""<style>
-div[data-testid="stCustomComponentV1"] {
-    height: 0px !important;
-    min-height: 0px !important;
-    margin: 0 !important;
-    padding: 0 !important;
-}
-</style>""", unsafe_allow_html=True)
-st.markdown("""
-    <link href="https://fonts.googleapis.com/css2?family=Cairo:wght@400;500;600;700;800;900&display=swap" rel="stylesheet">
-    <style>
-        *, *::before, *::after { font-family: 'Cairo', sans-serif !important; direction: rtl; box-sizing: border-box; }
-        .stApp { background-color: #F0F4F8; }
-        #MainMenu, footer, header { visibility: hidden; }
-        .block-container { padding-top: 0 !important; padding-bottom: 6rem !important; max-width: 1100px !important; min-height: 100vh !important; }
-
-        /* الهيدر */
-        .main-header {
-            background: rgba(255,255,255,0.97);
-            border-bottom: 1px solid #E2E8F0;
-            padding: 0 2.5rem;
-            height: 64px;
-            display: flex;
-            align-items: center;
-            justify-content: space-between;
-            position: fixed;
-            top: 0; left: 0; right: 0;
-            z-index: 9999;
-            width: 100vw;
-            margin-left: calc(-50vw + 50%);
-            box-shadow: 0 2px 12px rgba(59,130,246,0.07);
-        }
-        .header-logo { display: flex; align-items: center; gap: 10px; }
-        .header-logo-icon {
-            width: 38px; height: 38px; 
-            background: linear-gradient(135deg,#3B82F6,#2563EB);
-            border-radius: 10px;
-            display: flex; align-items: center; justify-content: center;
-        }
-        .header-logo-text { font-size: 1.3rem; font-weight: 900; color: #0F172A; }
-        .header-badge {
-            display: flex; align-items: center; gap: 6px;
-            background: #EFF6FF; padding: 5px 14px;
-            border-radius: 999px; border: 1px solid #BFDBFE;
-        }
-        .header-badge-dot { width: 7px; height: 7px; background: #3B82F6; border-radius: 50%; }
-        .header-badge-text { font-size: 0.78rem; font-weight: 700; color: #2563EB; }
-
-        /* Hero */
-        .hero-section { text-align: center; padding: 2rem 1rem 2.5rem; margin-top: 64px; }
-        .hero-badge { display: inline-block; background: #EFF6FF; color: #2563EB; border-radius: 999px; padding: 6px 20px; font-size: 13px; font-weight: 700; margin-bottom: 1.2rem; border: 1px solid #BFDBFE; }
-        .hero-title { font-size: clamp(1.8rem, 4vw, 2.6rem); font-weight: 900; color: #0F172A; margin: 0 0 1rem; line-height: 1.4; }
-
-        /* Upload */
-        div[data-testid="stFileUploader"] {
-            background: white !important; border: 2px dashed #CBD5E1 !important;
-            border-radius: 1.25rem !important; padding: 3rem 2rem !important;
-            text-align: center !important; box-shadow: 0 2px 20px rgba(59,130,246,0.08) !important;
-            cursor: pointer !important; transition: all 0.2s !important;
-        }
-        div[data-testid="stFileUploader"]:hover { border-color: #3B82F6 !important; background: #EFF6FF !important; }
-        div[data-testid="stFileUploaderDropzone"] { border: none !important; padding: 0 !important; background: transparent !important; display: flex !important; flex-direction: column !important; align-items: center !important; gap: 0.5rem !important; }
-        div[data-testid="stFileUploaderDropzoneInstructions"] { text-align: center !important; }
-        div[data-testid="stFileUploaderDropzoneInstructions"] > div > span { font-family: 'Cairo', sans-serif !important; font-size: 1.4rem !important; font-weight: 900 !important; color: #0F172A !important; }
-        div[data-testid="stFileUploaderDropzoneInstructions"] > div > span:last-child { display: none !important; }
-        div[data-testid="stFileUploaderDropzoneInstructions"] > div > small { font-family: 'Cairo', sans-serif !important; font-size: 0.85rem !important; color: #64748B !important; }
-        button[data-testid="stBaseButton-secondary"] { background: linear-gradient(135deg,#3B82F6,#2563EB) !important; color: white !important; border: none !important; border-radius: 12px !important; padding: 12px 36px !important; font-family: 'Cairo', sans-serif !important; font-weight: 700 !important; font-size: 1rem !important; margin-top: 0.5rem !important; }
-
-        /* Feature Cards */
-        .feature-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 1rem; margin-top: 2.5rem; }
-        .feature-card { background: white; border-radius: 1rem; border: 1px solid #E2E8F0; padding: 1.4rem; box-shadow: 0 1px 3px rgba(0,0,0,0.04); }
-        .feature-icon-wrap { width: 44px; height: 44px; background: #EFF6FF; border-radius: 10px; display: flex; align-items: center; justify-content: center; font-size: 1.3rem; margin-bottom: 0.9rem; }
-        .feature-title { font-weight: 800; font-size: 0.95rem; color: #1E293B; margin: 0 0 6px; }
-        .feature-text { font-size: 0.85rem; color: #64748B; margin: 0; line-height: 1.7; }
-
-        /* Results */
-        .section-title { font-size: 1.1rem; font-weight: 900; color: #0F172A; margin: 2rem 0 1rem; padding-bottom: 0.5rem; border-bottom: 2px solid #EFF6FF; }
-        .result-card { background: white; border-radius: 1rem; padding: 1rem 1.2rem; margin-bottom: 0.85rem; border: 1px solid #E2E8F0; border-right: 4px solid; box-shadow: 0 1px 3px rgba(0,0,0,0.04); }
-        .result-card.status-low    { border-right-color: #F59E0B; }
-        .result-card.status-high   { border-right-color: #EF4444; }
-        .result-card.status-normal { border-right-color: #10B981; }
-        .test-label { font-size: 0.72rem; font-weight: 700; color: #64748B; text-transform: uppercase; letter-spacing: 0.5px; margin-bottom: 4px; }
-        .test-value { font-size: 1.3rem; font-weight: 900; color: #0F172A; margin: 4px 0; }
-        .test-unit  { font-size: 0.68rem; font-weight: 500; color: #94A3B8; }
-        .status-badge { display: inline-block; padding: 2px 10px; border-radius: 999px; font-size: 0.72rem; font-weight: 700; margin-bottom: 6px; }
-        .badge-low    { background: #FEF3C7; color: #92400E; }
-        .badge-high   { background: #FEE2E2; color: #991B1B; }
-        .badge-normal { background: #D1FAE5; color: #065F46; }
-        .badge-warning{ background: #EFF6FF; color: #1E40AF; }
-        .range-text { font-size: 0.72rem; color: #94A3B8; border-top: 1px dashed #E2E8F0; padding-top: 6px; margin-top: 6px; }
-
-        /* Summary */
-        .summary-banner { background: linear-gradient(135deg,#EFF6FF,#F0F9FF); border: 1px solid #BFDBFE; border-radius: 1rem; padding: 1.5rem; display: flex; align-items: flex-start; gap: 1rem; margin-bottom: 1.5rem; }
-        .summary-icon  { font-size: 1.8rem; min-width: 40px; }
-        .summary-title { font-size: 1.1rem; font-weight: 900; color: #1E3A8A; margin: 0 0 6px; }
-        .summary-text  { color: #334155; font-size: 0.9rem; margin: 0; line-height: 1.8; }
-        .disclaimer { background: #F8FAFC; border: 1px solid #E2E8F0; border-radius: 0.75rem; padding: 1rem 1.25rem; font-size: 0.8rem; color: #94A3B8; line-height: 1.7; margin-top: 1.5rem; }
-
-        /* Privacy note */
-        .privacy-note { text-align: center; color: #94A3B8; font-size: 0.8rem; margin-top: 0.5rem; }
-
-        /* Buttons */
-        .stButton > button { background: linear-gradient(135deg,#3B82F6,#2563EB) !important; color: white !important; border: none !important; border-radius: 10px !important; font-family: 'Cairo', sans-serif !important; font-weight: 700 !important; }
-        hr { border: none; border-top: 1px solid #E2E8F0; margin: 2rem 0; }
-        /* شريط الشات دايماً شفاف */
-        div[data-testid="stBottom"],
-        div[data-testid="stBottom"] > div {
-            background: transparent !important;
-            backdrop-filter: none !important;
-            box-shadow: none !important;
-            border: none !important;
-        }
-    </style>
-""", unsafe_allow_html=True)
-
-# --- 3. الهيدر ---
-st.markdown("""
-    <div class="main-header">
-        <div class="header-logo">
-            <div class="header-logo-icon">
-                <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="white" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M22 12h-4l-3 9L9 3l-3 9H2"/></svg>
-            </div>
-            <span class="header-logo-text">تبيان الطبي</span>
-        </div>
-        <div class="header-badge">
-            <div class="header-badge-dot"></div>
-            <span class="header-badge-text">تحليل ذكي للتقارير الطبية</span>
-        </div>
-    </div>
-""", unsafe_allow_html=True)
-
-# --- 4. Hero ---
-st.markdown("""
-    <div class="hero-section">
-        <div class="hero-badge">🤖 مدعوم بالذكاء الاصطناعي</div>
-        <h1 class="hero-title">افهم نتائج تحاليلك بلغة عربية بسيطة</h1>
-        <p style="font-size:1rem;color:#64748B;max-width:500px;margin:0 auto;line-height:1.8;text-align:center;">نحوّل المصطلحات الطبية المعقّدة إلى شرح واضح، مع توصيات دقيقة مدعومة بمراجع طبية موثوقة.</p>
-    </div>
-""", unsafe_allow_html=True)
-
-
-# --- 5. الدوال --- 
-@st.cache_resource
-def load_tools():
-    reader = easyocr.Reader(['en'], gpu=False)
-    embeddings = HuggingFaceEmbeddings(model_name="sentence-transformers/all-MiniLM-L6-v2")
-    try:
-        available_models = [m.name for m in genai.list_models() if 'generateContent' in m.supported_generation_methods]
-        if 'models/gemini-1.5-flash' in available_models:
-            model_name = 'models/gemini-1.5-flash'
-        elif 'models/gemini-pro' in available_models:
-            model_name = 'models/gemini-pro'
-        else:
-            model_name = available_models[0]
-    except:
-        model_name = 'models/gemini-1.5-flash'
-    print(f"✅ الموديل المختار: {model_name}")
-    return reader, embeddings, genai.GenerativeModel(model_name)
-
-reader, embeddings, model = load_tools()
-
-# رد الشات بعد تحميل الموديل - run_rag 
-print(f"DEBUG _chat_q = '{_chat_q}'")
-if _chat_q and "chat_msgs" in st.session_state:
-    if st.session_state.chat_msgs and st.session_state.chat_msgs[-1]["role"] == "user":
-        try:
-            # فلتر طبي
-            strong_words = ["ألم","صداع","تعب","دوخة","حمى","سعال","غثيان","قيء","أعراض","ضغط","سكر","قلب","معدة","تنفس","التهاب","دواء","علاج"]
-            weak_words = ["تحليل","دم","فيتامين","مختبر","نتائج","فحص","تشخيص","كوليسترول","حديد"]
-            score = sum(0.6 for w in strong_words if w in _chat_q) + sum(0.3 for w in weak_words if w in _chat_q) + 0.5
-
-            if score < 0.8:
-                _ans = "هذا النظام مخصص للأسئلة الطبية فقط."
-            else:
-                # RAG
-                context = ""
-                try:
-                    if os.path.exists(r'D:\Project\chroma_db'):
-                        _db = Chroma(persist_directory=r'D:\Project\chroma_db', embedding_function=embeddings)
-                        results = _db.similarity_search_with_relevance_scores(_chat_q, k=3)
-                        filtered = [doc for doc, s in results if s >= 0.8]
-                        if filtered:
-                            context = "\n\n".join([d.page_content for d in filtered])
-                            print("✅ تم استخدام RAG")
-                except Exception as e:
-                    print(f"RAG error: {e}")
-
-                prompt = f"""
-أنت مساعد طبي ذكي.
-
-أجب على السؤال الطبي التالي بشكل واضح ومبسط.
-
-إذا كانت الحالة مرتبطة بأعراض أو مشاكل صحية، يجب عليك في نهاية الإجابة إضافة قسم بعنوان:
-
-"التحاليل المقترحة (إن وجدت):"
-
-وتذكر التحاليل المناسبة التي قد يطلبها الطبيب حسب الحالة فقط (إن لزم الأمر).
-
-إذا لم تكن هناك حاجة لتحاليل، لا تذكر هذا القسم.
-
-{("السياق من المراجع:\\n" + context) if context else ""}
-
-السؤال:
-{_chat_q}
-"""
-                _ans = model.generate_content(prompt).text
-
-            st.session_state.chat_msgs.append({"role":"bot","text":_ans})
-        except Exception as e:
-            st.session_state.chat_msgs.append({"role":"bot","text":f"حدث خطأ: {e}"})
-        st.rerun()
-
-def is_valid_test(name):
-    ignore = ['page','id','patient','date','sex','age','mrn','doctor','physician','result','unit','range','validated','approved','Interpretation','Ref']
-    name_l = str(name).lower()
-    return not any(x in name_l for x in ignore) and len(str(name).strip()) > 1
-
-def get_status_color(value, range_str):
-    try:
-        nums = re.findall(r"[-+]?\d*\.?\d+", str(range_str))
-        val = float(value)
-        if len(nums) >= 2:
-            low, high = float(nums[0]), float(nums[1])
-            if val < low or val > high:
-                return "status-high", "badge-high", "خارج المعدل"
-            return "status-normal", "badge-normal", "ممتاز"
-    except:
-        pass
-    return "status-warning", "badge-warning", "تحليل القيمة"
-
-
-# --- 6. Upload ---
-uploaded_file = st.file_uploader("اسحب ملف التحليل هنا", type=['pdf','png','jpg','jpeg'])
-st.markdown('<p class="privacy-note">🔒 ملفاتك محمية ولا تُحفظ على خوادمنا</p>', unsafe_allow_html=True)
-
-if not uploaded_file:
-    st.markdown("""
-        <div class="feature-grid">
-            <div class="feature-card"><div class="feature-icon-wrap">🔬</div><p class="feature-title">استخراج ذكي</p><p class="feature-text">يستخرج نتائج التحاليل تلقائياً من PDF أو صورة بدقة عالية.</p></div>
-            <div class="feature-card"><div class="feature-icon-wrap">📚</div><p class="feature-title">مراجع ��بية موثوقة</p><p class="feature-text">التقارير مدعومة بمراجع من قاعدة بياناتك الطبية المحلية.</p></div>
-            <div class="feature-card"><div class="feature-icon-wrap">🛡️</div><p class="feature-title">خصوصية كاملة</p><p class="feature-text">بياناتك الطبية لا تُحفظ ولا تُشارك مع أي طرف خارجي.</p></div>
-        </div>
-    """, unsafe_allow_html=True)
-
-
-# --- 7. المعالجة ---
-if uploaded_file:
-    with st.spinner("جاري استخراج البيانات الطبية..."):
-        if uploaded_file.type == "application/pdf":
-            doc = fitz.open(stream=uploaded_file.read(), filetype="pdf")
-            all_text = "\n".join([page.get_text() for page in doc])
-        else:
-            img = Image.open(uploaded_file)
-            all_text = "\n".join(reader.readtext(np.array(img), detail=0))
-
-    pattern = r"([a-zA-Z][a-zA-Z\s#%]{2,})\s+(\d+\.?\d*)\s+([\d\.]+\s*-\s*[\d\.]+)\s*([a-zA-Z0-9^/]+)?"
-    findings = [f for f in re.findall(pattern, all_text) if is_valid_test(f[0])]
-
-    if len(findings) < 2:
-        with st.spinner("تنسيق غير تقليدي.. جاري الاستخراج بالذكاء الاصطناعي..."):
-            extract_prompt = f"""حلل النص الطبي التالي واستخرج نتائج التحاليل.
-النص: {all_text[:4000]}
-أجب بتنسيق قائمة بايثون فقط: [('Test Name', 'Value', 'Range', 'Unit')]
-لا تكتب أي مقدمات أو شرح، فقط القائمة."""
-            try:
-                ai_response = model.generate_content(extract_prompt)
-                clean_text = ai_response.text.strip().replace("```python","").replace("```","")
-                findings = eval(clean_text)
-            except:
-                pass
-
-    if findings:
-        abnormal = [f for f in findings if is_valid_test(f[0]) and get_status_color(f[1], f[2])[0] != "status-normal"]
-        abnormal_names = "، ".join([f[0] for f in abnormal[:3]]) if abnormal else "لا توجد قيم خارج المعدل"
-
-        st.markdown(f"""
-            <div class="summary-banner">
-                <div class="summary-icon">📋</div>
-                <div>
-                    <p class="summary-title">ملخّص نتائجك</p>
-                    <p class="summary-text">تم تحليل <strong>{len(findings)}</strong> فحص طبي.
-                    {'القيم التي تحتاج انتباهاً: <strong>' + abnormal_names + '</strong>.' if abnormal else '<strong>جميع القيم ضمن المعدل الطبيعي ✓</strong>'}</p>
-                </div>
-            </div>
-        """, unsafe_allow_html=True)
-
-        st.markdown('<p class="section-title">🔬 نتائج المختبر</p>', unsafe_allow_html=True)
-        cols = st.columns(4)
-        for i, (name, val, range_val, unit) in enumerate(findings):
-            if not is_valid_test(name): continue
-            status_class, badge_class, status_label = get_status_color(val, range_val)
-            with cols[i % 4]:
-                st.markdown(f"""
-                    <div class="result-card {status_class}">
-                        <div class="test-label">{str(name).strip().upper()}</div>
-                        <div class="test-value">{val} <span class="test-unit">{unit}</span></div>
-                        <span class="status-badge {badge_class}">{status_label}</span>
-                        <div class="range-text">📏 المعدل: {range_val}</div>
-                    </div>
-                """, unsafe_allow_html=True)
-
-        st.markdown("<hr>", unsafe_allow_html=True)
-        st.markdown('<p class="section-title">📖 التقرير التحليلي المدعوم بالمراجع</p>', unsafe_allow_html=True)
-
-        with st.spinner("جاري صياغة التقرير الطبي الموثق..."):
-            context = ""
-            try:
-                if os.path.exists(r'D:\Project\chroma_db'):
-                    db_rag = Chroma(persist_directory=r'D:\Project\chroma_db', embedding_function=embeddings)
-                    docs = db_rag.similarity_search(f"Clinical pathology: {', '.join([f[0] for f in findings])}", k=4)
-                    context_list = []
-                    for idx, d in enumerate(docs, 1):
-                        src = d.metadata.get('source','Unknown').split('\\')[-1]
-                        pg = d.metadata.get('page','?')
-                        context_list.append(f"[ref {idx}]: {src} p{pg}\n{d.page_content}")
-                        print(f"ref: {src} (p{pg})")
-                    context = "\n\n".join(context_list)
-            except Exception as e:
-                print(f"RAG error: {e}")
-
-            site_prompt = (
-                "أنت طبيب مختبر خبير. أرجع JSON فقط بدون أي نص خارجه. ابدأ بـ { مباشرة.\n"
-                "لا HTML ولا markdown. نصوص عربية بسيطة فقط.\n\n"
-                f"النتائج: {findings}\n"
-                f"المراجع: {context if context else 'لا توجد مراجع'}\n\n"
-                '{"تقييم_عام":"جملة أو جملتين عن الحالة العامة",'
-                '"قيم_غير_طبيعية":[{"اسم_الفحص":"اسم","النتيجة":"قيمة","المعدل_الطبيعي":"مدى","الحالة":"مرتفع او منخفض","الشرح":"شرح طبي","المرجع":"مرجع او لا يوجد"}],'
-                '"نصائح":["نصيحة1","نصيحة2","نصيحة3"]}'
-            )
-
-            try:
-                import json
-                raw = model.generate_content(site_prompt).text.strip()
-                raw = raw.replace("```json","").replace("```","").strip()
-                if '{' in raw:
-                    raw = raw[raw.index('{'):raw.rindex('}')+1]
-                report_data = json.loads(raw)
-
-                st.markdown(f"""
-                    <div style="background:white;border:1px solid #E2E8F0;border-radius:1rem;padding:1.5rem 1.8rem;margin-bottom:1.2rem;direction:rtl;text-align:right;font-family:'Cairo',sans-serif;box-shadow:0 1px 3px rgba(0,0,0,0.04);">
-                        <div style="display:flex;align-items:center;gap:10px;margin-bottom:12px;">
-                            <div style="width:34px;height:34px;background:#EFF6FF;border-radius:8px;display:flex;align-items:center;justify-content:center;flex-shrink:0;">📋</div>
-                            <span style="font-weight:900;font-size:1rem;color:#0F172A;">التقييم العام للحالة</span>
-                        </div>
-                        <div style="height:1px;background:#F1F5F9;margin-bottom:12px;"></div>
-                        <p style="margin:0;line-height:1.9;color:#475569;font-size:0.93rem;">{report_data.get("تقييم_عام","")}</p>
-                    </div>
-                """, unsafe_allow_html=True)
-
-                abnormal_items = report_data.get("قيم_غير_طبيعية", [])
-                if abnormal_items:
-                    st.markdown('<p style="font-weight:900;font-size:1rem;color:#0F172A;margin:1.5rem 0 0.8rem;direction:rtl;text-align:right;">🔬 تفصيل القيم غير الطبيعية</p>', unsafe_allow_html=True)
-
-                for item in abnormal_items:
-                    حالة = item.get("الحالة","")
-                    if "مرتفع" in حالة:
-                        dot_color="#EF4444"; badge_bg="#FEE2E2"; badge_color="#991B1B"; badge_text="↑ مرتفع"; bar_color="#EF4444"; bar_pct=85
-                    else:
-                        dot_color="#F59E0B"; badge_bg="#FEF3C7"; badge_color="#92400E"; badge_text="↓ منخفض"; bar_color="#F59E0B"; bar_pct=18
-                    مرجع = item.get("المرجع","")
-                    مرجع_html = f'<div style="display:flex;align-items:center;gap:8px;margin-top:12px;padding-top:12px;border-top:1px solid #F1F5F9;"><div style="width:20px;height:20px;background:#EFF6FF;border-radius:5px;display:flex;align-items:center;justify-content:center;font-size:0.65rem;flex-shrink:0;">📖</div><span style="font-size:0.78rem;color:#94A3B8;line-height:1.6;">{مرجع}</span></div>' if مرجع else ""
-                    st.markdown(f"""
-                        <div style="background:white;border:1px solid #E2E8F0;border-radius:1rem;padding:1.3rem 1.6rem;margin-bottom:0.85rem;direction:rtl;text-align:right;font-family:'Cairo',sans-serif;box-shadow:0 1px 3px rgba(0,0,0,0.04);">
-                            <div style="display:flex;justify-content:space-between;align-items:flex-start;flex-wrap:wrap;gap:10px;margin-bottom:10px;">
-                                <h3 style="margin:0;font-size:0.95rem;font-weight:900;color:#0F172A;">{item.get("اسم_الفحص","")}</h3>
-                                <span style="display:inline-flex;align-items:center;gap:5px;background:{badge_bg};color:{badge_color};border-radius:6px;padding:3px 10px;font-size:0.75rem;font-weight:800;">
-                                    <span style="width:6px;height:6px;border-radius:50%;background:{dot_color};display:inline-block;"></span>{badge_text}
-                                </span>
-                            </div>
-                            <div style="display:flex;gap:8px;margin-bottom:10px;">
-                                <div style="background:#F8FAFC;border-radius:6px;padding:4px 10px;font-size:0.78rem;"><span style="color:#94A3B8;">القيمة </span><strong style="color:#0F172A;">{item.get("النتيجة","")}</strong></div>
-                                <div style="background:#F8FAFC;border-radius:6px;padding:4px 10px;font-size:0.78rem;"><span style="color:#94A3B8;">المعدل </span><strong style="color:#0F172A;">{item.get("المعدل_الطبيعي","")}</strong></div>
-                            </div>
-                            <div style="height:4px;background:#F1F5F9;border-radius:99px;margin-bottom:12px;overflow:hidden;">
-                                <div style="height:100%;width:{bar_pct}%;background:{bar_color};border-radius:99px;"></div>
-                            </div>
-                            <p style="margin:0;line-height:1.85;color:#475569;font-size:0.88rem;">{item.get("الشرح","")}</p>
-                            {مرجع_html}
-                        </div>
-                    """, unsafe_allow_html=True)
-
-                نصائح = report_data.get("نصائح", [])
-                if نصائح:
-                    نصائح_html = "".join([f'<div style="display:flex;align-items:flex-start;gap:10px;padding:8px 0;border-bottom:1px solid #F1F5F9;"><div style="width:20px;height:20px;background:#DCFCE7;border-radius:5px;display:flex;align-items:center;justify-content:center;font-size:0.7rem;color:#15803D;flex-shrink:0;margin-top:2px;">✓</div><span style="line-height:1.8;color:#475569;font-size:0.88rem;">{n}</span></div>' for n in نصائح])
-                    st.markdown(f"""
-                        <div style="background:white;border:1px solid #E2E8F0;border-radius:1rem;padding:1.3rem 1.6rem;margin-top:0.5rem;direction:rtl;text-align:right;font-family:'Cairo',sans-serif;box-shadow:0 1px 3px rgba(0,0,0,0.04);">
-                            <div style="display:flex;align-items:center;gap:10px;margin-bottom:14px;">
-                                <div style="width:34px;height:34px;background:#F0FDF4;border-radius:8px;display:flex;align-items:center;justify-content:center;flex-shrink:0;">💡</div>
-                                <span style="font-weight:900;font-size:1rem;color:#0F172A;">نصائح طبية مقترحة</span>
-                            </div>
-                            {نصائح_html}
-                        </div>
-                    """, unsafe_allow_html=True)
-
-            except Exception as e:
-                st.error("فشل التواصل مع Gemini")
-                print(f"ERROR: {e}")
-
-            try:
-                import time
-                time.sleep(20)
-                audit_prompt = f"تقرير فجوات البيانات للمطورة: النتائج {findings}, المراجع {context[:500]}"
-                audit_resp = model.generate_content(audit_prompt)
-                print("\n=== DATA GAP REPORT ===")
-                print(audit_resp.text)
-            except Exception as e:
-                print(f"AUDIT ERROR: {e}")
-
-        st.markdown("""
-            <div class="disclaimer">⚕️ <strong>إخلاء مسؤولية:</strong> هذا التقرير للتوعية الصحية فقط ولا يُعتبر بديلاً عن استشارة الطبيب المختص.</div>
-        """, unsafe_allow_html=True)
-
-    else:
-        st.markdown("""
-            <div class="summary-banner" style="border-color:#FCA5A5;background:linear-gradient(135deg,#FEF2F2,#FFF5F5);">
-                <div class="summary-icon">⚠️</div>
-                <div><p class="summary-title" style="color:#991B1B;">لم يتم العثور على نتائج</p>
-                <p class="summary-text">تأكد أن الملف يحتوي على نتائج تحاليل طبية واضحة وحاول مرة أخرى.</p></div>
-            </div>
-        """, unsafe_allow_html=True)
-
-
-# ===== CHATBOT =====
-from sklearn.metrics.pairwise import cosine_similarity
-
-@st.cache_resource
-def load_chat_db():
-    from langchain_community.vectorstores import Chroma as ChromaDB
-    emb = HuggingFaceEmbeddings(model_name="sentence-transformers/all-MiniLM-L6-v2")
-    try:
-        db = ChromaDB(persist_directory=r'D:\Project\chroma_db', embedding_function=emb)
-        return emb, db
-    except:
-        return emb, None
-
-def is_medical(query):
-    words = ["ألم","صداع","تعب","دوخة","حمى","سعال","أعراض","ضغط","سكر","قلب","معدة","تنفس","التهاب","دواء","علاج","تحليل","دم","فيتامين","نتائج","فحص","تشخيص","كوليسترول","حديد","مختبر","هيموجلوبين","خلايا"]
-    return any(w in query for w in words)
-
-def run_chat(query):
-    if not is_medical(query):
-        return "هذا النظام مخصص للأسئلة الطبية فقط."
-    _, chat_db = load_chat_db()
-    context = ""
-    used_rag = False
-    if chat_db:
-        try:
-            results = chat_db.similarity_search_with_relevance_scores(query, k=3)
-            filtered = [doc for doc, score in results if score >= 0.8]
-            if filtered:
-                context = "\n\n".join([d.page_content for d in filtered])
-                used_rag = True
-        except:
-            pass
-    prompt = f"""أنت مساعد طبي ذكي.
-
-أجب على السؤال الطبي التالي بشكل واضح ومبسط.
-
-إذا كانت الحالة مرتبطة بأعراض أو مشاكل صحية، يجب عليك في نهاية الإجابة إضافة قسم بعنوان:
-
-"التحاليل المقترحة (إن وجدت):"
-
-وتذكر التحاليل المناسبة التي قد يطلبها الطبيب حسب الحالة فقط (إن لزم الأمر).
-
-إذا لم تكن هناك حاجة لتحاليل، لا تذكر هذا القسم.
-
-{("السياق من المراجع:\n" + context) if context else ""}
-
-السؤال:
-{query}
-"""
-    try:
-        response = model.generate_content(prompt).text
-        if not used_rag:
-            response += "\n\n🤖 *هذه الإجابة من Gemini AI*"
-        return response
-    except Exception as e:
-        return f"حدث خطأ: {e}"
-
-# تهيئة الشات
-if "chat_msgs" not in st.session_state:
-    st.session_state.chat_msgs = [{"role":"bot","text":"مرحباً! أنا مساعدك الطبي الذكي 🩺\nاسألني عن أي تحليل أو حالة صحية."}]
-if "chat_open" not in st.session_state:
-    st.session_state.chat_open = False
-
-import html as html_lib
-import streamlit.components.v1 as components
-
-if "chat_msgs" not in st.session_state:
-    st.session_state.chat_msgs = [{"role":"bot","text":"مرحباً! اسألني عن أي تحليل أو حالة صحية 🩺"}]
-
-# إخفاء الشات لما يكون فيه ملف مرفوع
-if uploaded_file:
-    st.markdown("""<style>
-    div[data-testid="stCustomComponentV1"] { opacity:0 !important; pointer-events:none !important; }
-    </style>""", unsafe_allow_html=True)
-
-def format_chat_text(text):
-    safe = html_lib.escape(str(text))
-    safe = re.sub(r'\*\*(.+?)\*\*', r'<strong>\1</strong>', safe)
-    safe = re.sub(r'\*(.+?)\*', r'<em>\1</em>', safe)
-    lines = safe.split('\n')
-    result_lines = []
-    in_list = False
-    for line in lines:
-        stripped = line.strip()
-        if re.match(r'^[-•]\s+.+', stripped):
-            if not in_list:
-                result_lines.append('<ul style="margin:4px 0;padding-right:18px;list-style:disc;">')
-                in_list = True
-            item_text = re.sub(r'^[-•]\s+', '', stripped)
-            result_lines.append(f'<li style="margin:3px 0;">{item_text}</li>')
-        else:
-            if in_list:
-                result_lines.append('</ul>')
-                in_list = False
-            result_lines.append(line)
-    if in_list:
-        result_lines.append('</ul>')
-    return '<br>'.join(result_lines)
-
-msgs_html = ""
-for msg in st.session_state.chat_msgs:
-    txt = format_chat_text(msg["text"])
-    if msg["role"] == "bot":
-        msgs_html += f'<div class="msg-bot">{txt}</div>'
-    else:
-        msgs_html += f'<div class="msg-user">{txt}</div>'
-
-chat_html = f"""<!DOCTYPE html>
-<html><head><meta charset="utf-8">
-<link href="https://fonts.googleapis.com/css2?family=Cairo:wght@400;700;900&display=swap" rel="stylesheet">
-<style>
-*{{margin:0;padding:0;box-sizing:border-box;font-family:Cairo,sans-serif;}}
-html,body{{background:transparent;overflow:hidden;width:100%;height:100%;}}
-.fab{{
-    position:fixed;bottom:16px;right:16px;
-    width:52px;height:52px;
-    background:linear-gradient(135deg,#3B82F6,#2563EB);
-    border-radius:50%;border:none;cursor:pointer;
-    box-shadow:0 4px 16px rgba(59,130,246,0.45);
-    font-size:20px;color:white;
-    display:flex;align-items:center;justify-content:center;
-    z-index:99;
-}}
-.win{{
-    position:fixed;bottom:78px;right:16px;
-    width:300px;height:400px;
-    background:white;border-radius:14px;
-    box-shadow:0 8px 32px rgba(0,0,0,0.18);
-    display:none;flex-direction:column;
-    border:1px solid #E2E8F0;overflow:hidden;
-    direction:rtl;z-index:98;
-}}
-.win.open{{display:flex;}}
-.head{{
-    background:linear-gradient(135deg,#3B82F6,#2563EB);
-    padding:11px 14px;display:flex;
-    justify-content:space-between;align-items:center;
-    flex-shrink:0;
-}}
-.head-t{{color:white;font-weight:900;font-size:13px;}}
-.head-s{{color:rgba(255,255,255,0.8);font-size:10px;}}
-.x-btn{{
-    background:rgba(255,255,255,0.2);border:none;color:white;
-    width:22px;height:22px;border-radius:50%;cursor:pointer;font-size:12px;
-    display:flex;align-items:center;justify-content:center;
-}}
-.body{{flex:1;overflow-y:auto;padding:12px;display:flex;flex-direction:column;gap:7px;}}
-.msg-bot{{background:#F1F5F9;color:#334155;border-radius:3px 11px 11px 11px;padding:8px 11px;font-size:12px;line-height:1.6;max-width:85%;align-self:flex-end;word-break:break-word;}}
-.msg-user{{background:#3B82F6;color:white;border-radius:11px 3px 11px 11px;padding:8px 11px;font-size:12px;line-height:1.6;max-width:85%;align-self:flex-start;word-break:break-word;}}
-.inp{{padding:9px 10px;border-top:1px solid #E2E8F0;display:flex;gap:7px;background:#F8FAFC;flex-shrink:0;}}
-.inp input{{flex:1;border:1px solid #E2E8F0;border-radius:8px;padding:7px 10px;font-size:12px;outline:none;direction:rtl;font-family:Cairo,sans-serif;}}
-.inp button{{background:#3B82F6;color:white;border:none;border-radius:8px;padding:7px 12px;font-weight:700;cursor:pointer;font-size:12px;font-family:Cairo,sans-serif;}}
-</style></head><body>
-
-<button class="fab" onclick="toggleWin()">💬</button>
-
-<div class="win" id="win">
-    <div class="head">
-        <div>
-            <div class="head-t">🩺 المساعد الطبي</div>
-            <div class="head-s">مدعوم بالذكاء الاصطناعي</div>
-        </div>
-        <button class="x-btn" onclick="toggleWin()">✕</button>
-    </div>
-    <div class="body" id="body">{msgs_html}</div>
-    <div class="inp">
-        <input id="inp" type="text" placeholder="اكتب سؤالك الطبي..." onkeydown="if(event.key==='Enter')send()"/>
-        <button onclick="send()">إرسال</button>
-    </div>
-</div>
-
-<script>
-function toggleWin(){{
-    var w=document.getElementById("win");
-    w.classList.toggle("open");
-    sc();
-}}
-function sc(){{
-    var b=document.getElementById("body");
-    if(b) setTimeout(function(){{b.scrollTop=b.scrollHeight;}},50);
-}}
-function send(){{
-    var inp=document.getElementById("inp");
-    var v=inp.value.trim();
-    if(!v) return;
-    inp.value="";
-    var b=document.getElementById("body");
-    var u=document.createElement("div");
-    u.className="msg-user";u.textContent=v;b.appendChild(u);
-    var l=document.createElement("div");
-    l.className="msg-bot";l.innerHTML="⏳ جاري التفكير...";
-    b.appendChild(l);sc();
-    // نكتب في hidden textarea ونضغط زر مخفي
-    var ta=window.parent.document.querySelector("textarea[data-testid='stChatInputTextArea']");
-    if(ta){{
-        var nativeSetter=Object.getOwnPropertyDescriptor(window.parent.HTMLTextAreaElement.prototype,"value").set;
-        nativeSetter.call(ta,v);
-        ta.dispatchEvent(new Event("input",{{bubbles:true}}));
-        setTimeout(function(){{
-            var btn=window.parent.document.querySelector("button[data-testid='stChatInputSubmitButton']");
-            if(btn) btn.click();
-        }},200);
-    }}
-}}
-sc();
-</script>
-</body></html>"""
-
-components.html(chat_html, height=520, scrolling=False)
-
-# st.chat_input شفاف - يشتغل بس مو مرئي
-st.markdown("""<style>
-div[data-testid="stBottom"] {
-    background: transparent !important;
-    backdrop-filter: none !important;
-}
-div[data-testid="stBottom"] > div {
-    background: transparent !important;
-}
-div[data-testid="stChatInput"] {
-    background: transparent !important;
-    border: none !important;
-    box-shadow: none !important;
-    opacity: 0 !important;
-}
-div[data-testid="stChatInput"] * {
-    background: transparent !important;
-    border: none !important;
-    box-shadow: none !important;
-    color: transparent !important;
-}
-</style>""", unsafe_allow_html=True)
-
-user_q = st.chat_input("سؤال")
-if user_q:
-    st.session_state.chat_msgs.append({"role":"user","text":user_q})
-    try:
-        strong_words = ["ألم","صداع","تعب","دوخة","حمى","سعال","غثيان","قيء","أعراض","ضغط","سكر","قلب","معدة","تنفس","التهاب","دواء","علاج"]
-        weak_words = ["تحليل","دم","فيتامين","مختبر","نتائج","فحص","تشخيص","كوليسترول","حديد"]
-        score = sum(0.6 for w in strong_words if w in user_q) + sum(0.3 for w in weak_words if w in user_q) + 0.5
-        if score < 0.8:
-            ans = "هذا النظام مخصص للأسئلة الطبية فقط."
-        else:
-            context = ""
-            try:
-                if os.path.exists(r'D:\Project\chroma_db'):
-                    _db = Chroma(persist_directory=r'D:\Project\chroma_db', embedding_function=embeddings)
-                    results = _db.similarity_search_with_relevance_scores(user_q, k=3)
-                    filtered = [doc for doc, s in results if s >= 0.8]
-                    if filtered:
-                        context = "\n\n".join([d.page_content for d in filtered])
-            except Exception as e:
-                print(f"RAG error: {e}")
-            prompt = f"""أنت مساعد طبي ذكي.
-
-أجب على السؤال الطبي التالي بشكل واضح ومبسط.
-
-إذا كانت الحالة مرتبطة بأعراض أو مشاكل صحية، يجب عليك في نهاية الإجابة إضافة قسم بعنوان:
-
-"التحاليل المقترحه:"
-
-وتذكر التحاليل المناسبة التي قد يطلبها الطبيب حسب الحالة فقط (إن لزم الأمر).
-
-إذا لم تكن هناك حاجة لتحاليل، لا تذكر هذا القسم.
-
-{("السياق من المراجع:\n" + context) if context else ""}
-
-السؤال:
-{user_q}"""
-            ans = model.generate_content(prompt).text
-    except Exception as e:
-        ans = f"حدث خطأ: {e}"
-    st.session_state.chat_msgs.append({"role":"bot","text":ans})
-    st.rerun()

backend/.dockerignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.env
+.env.*
+chroma_db/
+model_cache/
+*.log
+*.txt.bak
+venv/
+.venv/
+tests/

backend/.env.example

@@ -0,0 +1,30 @@
+# ── Groq (required) ──────────────────────────────────────
+GROQ_API_KEY=gsk_...
+
+# ── Cohere (required for reranking, fallback to BM25 if missing) ──
+COHERE_API_KEY=...
+
+# ── Supabase (required) ───────────────────────────────────
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_KEY=eyJ...          # anon key (public — used for pgvector KB search)
+SUPABASE_SERVICE_KEY=eyJ...  # service_role key (secret — used for analyses/chat tables)
+SUPABASE_DB_URL=postgresql://postgres:password@db.your-project.supabase.co:5432/postgres
+
+# ── Google Cloud Vision OCR (required for image OCR) ──────
+GOOGLE_VISION_API_KEY=AIza...
+
+# ── Frontend URL (CORS whitelist) ─────────────────────────
+FRONTEND_URL=https://your-app.vercel.app
+
+# ── Supabase Auth (required for protected API endpoints) ──
+# Find in: Supabase Dashboard → Project Settings → API → JWT Secret
+SUPABASE_JWT_SECRET=your-supabase-jwt-secret
+
+# ── Environment ───────────────────────────────────────────
+ENVIRONMENT=production
+
+# ── Sentry (optional) ─────────────────────────────────────
+SENTRY_DSN=https://...@sentry.io/...
+
+# ── HuggingFace (optional — for higher rate limits) ───────
+HF_TOKEN=hf_...

backend/Dockerfile

@@ -2,23 +2,34 @@ FROM python:3.11-slim
 
 WORKDIR /app
 
-# نظام الاعتمادات
-RUN apt-get update && apt-get install -y \
-    libgl1-mesa-glx \
+# System dependencies for OpenCV / EasyOCR
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libgl1 \
     libglib2.0-0 \
     libsm6 \
     libxext6 \
-    libxrender-dev \
+    libxrender1 \
     && rm -rf /var/lib/apt/lists/*
 
+# Install CPU-only torch first (avoids pulling 2 GB of CUDA packages)
+RUN pip install --no-cache-dir torch torchvision --index-url https://download.pytorch.org/whl/cpu
+
+# Install remaining Python dependencies
 COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt
 
+# Pre-download the embedding model so first request is instant
+# Model is cached in /app/model_cache (bind-mount a volume in prod for persistence)
+ENV HF_HOME=/app/model_cache
+RUN python -c "\
+from langchain_huggingface import HuggingFaceEmbeddings; \
+HuggingFaceEmbeddings(model_name='intfloat/multilingual-e5-large'); \
+print('Model cached ✓')"
+
 COPY . .
 
-ENV HF_HOME=/app/model_cache
 ENV PORT=8000
 
 EXPOSE 8000
 
-CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
+CMD ["python", "run.py"]

backend/evaluate.py

@@ -1,22 +1,23 @@
 """
 M7 — RAGAS-light: تقييم جودة الـ RAG بدون OpenAI
-يستخدم Groq بدلاً منه للحفاظ على المجانية
+يستخدم Groq بدلاً منه — pgvector + SemanticSearchService
 """
 import os
 import json
 from dotenv import load_dotenv
 load_dotenv(dotenv_path=r'D:\Project\.env')
-os.environ['HF_HOME'] = r'D:\Project\model_cache'
+os.environ.setdefault('HF_HOME', r'D:\Project\model_cache')
 os.environ['TRANSFORMERS_VERBOSITY'] = 'error'
 
 from groq import Groq
-from langchain_huggingface import HuggingFaceEmbeddings
-from langchain_chroma import Chroma
+from services.search.semantic_search import SemanticSearchService
+from services.rag.retriever import Retriever, RetrievalConfig
+from services.rag.context_builder import build_context
 
-GROQ_API_KEY  = os.getenv("GROQ_API_KEY")
-EMBED_MODEL   = "intfloat/multilingual-e5-large"
-GROQ_MODEL    = "llama-3.1-8b-instant"
-DB_PATH       = r'D:\Project\chroma_db'
+GROQ_API_KEY = os.getenv("GROQ_API_KEY")
+SUPABASE_URL = os.getenv("SUPABASE_URL")
+SUPABASE_KEY = os.getenv("SUPABASE_KEY")
+GROQ_MODEL   = "llama-3.1-8b-instant"
 
 TEST_QUESTIONS = [
     {"q": "ما هي القيم الطبيعية للهيموجلوبين؟",    "ref": "رجال 13.5-17.5 g/dL نساء 12-15.5 g/dL"},
@@ -24,35 +25,36 @@ TEST_QUESTIONS = [
     {"q": "ما أعراض نقص فيتامين د؟",               "ref": "آلام العظام وضعف العضلات وضعف المناعة"},
     {"q": "كيف أخفض سكر الدم طبيعياً؟",            "ref": "الرياضة والغذاء الصحي وتقليل النشويات"},
     {"q": "ما سبب ارتفاع إنزيمات الكبد ALT AST؟",  "ref": "التهاب الكبد الكبد الدهني الكحول"},
-    {"q": "ما القيم الطبيعية للكرياتينين؟",         "ref": "رجال 0.74-1.35 نساء 0.59-1.04 mg/dL"},
+    {"q": "ما القيم الطبيعية للكرياتينين؟",         "ref": "رجال 0.7-1.3 نساء 0.5-1.1 mg/dL"},
     {"q": "ما أسباب انخفاض خلايا الدم البيضاء؟",   "ref": "أمراض المناعة العلاج الكيميائي أمراض النخاع"},
     {"q": "ما معنى ارتفاع TSH؟",                    "ref": "قصور الغدة الدرقية الغدة خاملة"},
+    {"q": "ما أسباب ارتفاع الدهون الثلاثية؟",      "ref": "السكر والكربوهيدرات والسمنة والخمول"},
+    {"q": "ما معنى انخفاض eGFR؟",                   "ref": "ضعف وظيفة الكلى ومرض الكلى المزمن"},
 ]
 
 
-def get_rag_answer(client, db, question: str) -> tuple[str, str]:
-    results = db.similarity_search_with_relevance_scores(question, k=5)
-    filtered = [(d, s) for d, s in results if s >= 0.4]
-    context  = "\n\n".join([d.page_content for d, _ in filtered[:3]])
+def get_rag_answer(groq_client: Groq, retriever: Retriever, question: str) -> tuple[str, str]:
+    results, _ = retriever.retrieve(question, RetrievalConfig(k=8, top_n=4, use_multi_query=False))
+    context    = build_context(results, max_tokens=1200)
 
     messages = [
-        {"role": "system", "content": "أنت مساعد طبي. أجب باختصار بالعربية مستنداً للسياق."},
+        {"role": "system", "content": "أنت مساعد طبي دقيق. أجب باختصار بالعربية مستنداً فقط للسياق المعطى."},
         {"role": "user",   "content": f"السياق:\n{context}\n\nالسؤال: {question}"},
     ]
-    r = client.chat.completions.create(
+    r = groq_client.chat.completions.create(
         model=GROQ_MODEL, messages=messages, temperature=0.1, max_tokens=300
     )
     return r.choices[0].message.content, context
 
 
-def evaluate_single(client, answer: str, context: str, question: str, reference: str) -> dict:
+def evaluate_single(groq_client: Groq, answer: str, context: str, question: str, reference: str) -> dict:
     prompt = f"""قيّم الإجابة التالية بدقة. أجب بـ JSON فقط بهذا الشكل:
 {{"faithfulness": X, "answer_relevance": X, "context_precision": X, "notes": "..."}}
 
-حيث القيم من 0.0 إلى 1.0:
-- faithfulness: هل الإجابة مبنية على السياق المعطى؟
-- answer_relevance: هل الإجابة تجيب على السؤال؟
-- context_precision: هل السياق يحتوي على معلومات مفيدة؟
+القيم من 0.0 إلى 1.0:
+- faithfulness: هل الإجابة مبنية فعلاً على السياق المعطى؟
+- answer_relevance: هل الإجابة تجيب على السؤال بشكل مباشر؟
+- context_precision: هل السياق يحتوي معلومات مفيدة للسؤال؟
 
 السؤال: {question}
 المرجع: {reference}
@@ -60,7 +62,7 @@ def evaluate_single(client, answer: str, context: str, question: str, reference:
 الإجابة: {answer[:500]}"""
 
     try:
-        r = client.chat.completions.create(
+        r = groq_client.chat.completions.create(
             model=GROQ_MODEL,
             messages=[{"role": "user", "content": prompt}],
             temperature=0, max_tokens=200,
@@ -75,46 +77,65 @@ def evaluate_single(client, answer: str, context: str, question: str, reference:
 
 def run_evaluation():
     print("=" * 60)
-    print("M7 — RAGAS-light Evaluation")
+    print("RAGAS-light Evaluation | pgvector + Groq")
     print("=" * 60)
 
-    client = Groq(api_key=GROQ_API_KEY)
-    embed  = HuggingFaceEmbeddings(model_name=EMBED_MODEL)
-    db     = Chroma(persist_directory=DB_PATH, embedding_function=embed)
-    print(f"[DB] {db._collection.count()} chunks loaded\n")
+    groq_client = Groq(api_key=GROQ_API_KEY)
+    search_svc  = SemanticSearchService(SUPABASE_URL, SUPABASE_KEY)
+    retriever   = Retriever(search_svc)
 
-    results  = []
-    totals   = {"faithfulness": 0, "answer_relevance": 0, "context_precision": 0}
+    total_chunks = search_svc.count()
+    print(f"[DB] {total_chunks} chunks in pgvector\n")
+
+    results = []
+    totals  = {"faithfulness": 0.0, "answer_relevance": 0.0, "context_precision": 0.0}
 
     for i, item in enumerate(TEST_QUESTIONS, 1):
-        print(f"[{i}/{len(TEST_QUESTIONS)}] {item['q'][:50]}...")
-        answer, context = get_rag_answer(client, db, item["q"])
-        metrics = evaluate_single(client, answer, context, item["q"], item["ref"])
+        print(f"[{i}/{len(TEST_QUESTIONS)}] {item['q'][:55]}...")
+        answer, context = get_rag_answer(groq_client, retriever, item["q"])
+        metrics = evaluate_single(groq_client, answer, context, item["q"], item["ref"])
 
         for k in totals:
             totals[k] += metrics.get(k, 0)
 
         results.append({
             "question": item["q"],
-            "answer":   answer[:150],
+            "answer":   answer[:200],
             "metrics":  metrics,
         })
         print(f"  faithfulness={metrics.get('faithfulness', 0):.2f} "
               f"| relevance={metrics.get('answer_relevance', 0):.2f} "
-              f"| precision={metrics.get('context_precision', 0):.2f}")
+              f"| precision={metrics.get('context_precision', 0):.2f}"
+              f"  — {metrics.get('notes', '')[:60]}")
 
     n = len(TEST_QUESTIONS)
+    avg_f   = totals['faithfulness']    / n
+    avg_r   = totals['answer_relevance'] / n
+    avg_p   = totals['context_precision'] / n
+    overall = (avg_f + avg_r + avg_p) / 3
+
     print("\n" + "=" * 60)
     print("النتائج الكلية:")
-    print(f"  Faithfulness (أمانة الإجابة):  {totals['faithfulness']/n:.2%}")
-    print(f"  Answer Relevance (صلة الإجابة): {totals['answer_relevance']/n:.2%}")
-    print(f"  Context Precision (دقة السياق): {totals['context_precision']/n:.2%}")
-    print(f"  المتوسط العام:                  {sum(totals.values())/(n*3):.2%}")
+    print(f"  Faithfulness  (امانة الإجابة):  {avg_f:.1%}")
+    print(f"  Answer Relevance (صلة الإجابة): {avg_r:.1%}")
+    print(f"  Context Precision (دقة السياق): {avg_p:.1%}")
+    print(f"  المتوسط العام:                  {overall:.1%}")
     print("=" * 60)
 
+    summary = {
+        "faithfulness":     round(avg_f, 3),
+        "answer_relevance": round(avg_r, 3),
+        "context_precision":round(avg_p, 3),
+        "overall":          round(overall, 3),
+        "total_chunks":     total_chunks,
+        "questions_tested": n,
+    }
+    output = {"summary": summary, "details": results}
+
     with open("eval_results.json", "w", encoding="utf-8") as f:
-        json.dump({"summary": {k: round(v/n, 3) for k, v in totals.items()}, "details": results}, f, ensure_ascii=False, indent=2)
-    print("\nحُفظت النتائج في eval_results.json")
+        json.dump(output, f, ensure_ascii=False, indent=2)
+    print("Results saved to eval_results.json")
+    return summary
 
 
 if __name__ == "__main__":

backend/ingest_medical_kb.py

@@ -0,0 +1,357 @@
+"""
+ingest_medical_kb.py — Ingest medical_kb/schemas/*.json → Supabase pgvector
+
+Creates 3 semantically distinct chunks per lab test:
+  chunk 0 (definition)       — name + abbreviations + unit + clinical meaning + patient explanation
+  chunk 1 (values)           — normal ranges per gender + severity thresholds + followup tests
+  chunk 2 (symptoms_causes)  — high causes + low causes + symptoms_low
+
+Source tag: "TibyanMedicalKB"  (distinct from MedlinePlus "MedlinePlus" or "TibyanLabs")
+
+Usage:
+  cd backend
+  python ingest_medical_kb.py             # insert new chunks only
+  python ingest_medical_kb.py --clear     # delete existing TibyanMedicalKB first
+  python ingest_medical_kb.py --dry-run   # print chunks, do NOT insert
+"""
+from __future__ import annotations
+
+import hashlib
+import json
+import os
+import re
+import sys
+from pathlib import Path
+
+from dotenv import load_dotenv
+
+load_dotenv()
+os.environ.setdefault("HF_HOME", r"D:\Project\model_cache")
+os.environ["TRANSFORMERS_VERBOSITY"] = "error"
+
+import requests
+from langchain_huggingface import HuggingFaceEmbeddings
+
+EMBED_MODEL  = "intfloat/multilingual-e5-large"
+SUPABASE_URL = os.getenv("SUPABASE_URL", "")
+SUPABASE_KEY = os.getenv("SUPABASE_KEY", "")
+
+SCHEMAS_DIR  = Path(__file__).parent / "medical_kb" / "schemas"
+SOURCE_TAG   = "TibyanMedicalKB"
+
+
+# ══════════════════════════════════════════════════════════════════
+# 1. Chunk builders
+# ══════════════════════════════════════════════════════════════════
+
+def _fmt_range(rng: dict) -> str:
+    lo, hi = rng.get("low", "?"), rng.get("high", "?")
+    return f"{lo}–{hi}"
+
+
+def _build_definition_chunk(panel: dict, test_name: str, test: dict) -> str:
+    """Chunk 0: identity + what this test measures."""
+    name_ar = test.get("name_ar", test_name)
+    abbr    = ", ".join(test.get("abbreviations", [])[:5])
+    unit    = test.get("unit", "")
+    meaning = test.get("clinical_meaning_ar", "")
+    explain = test.get("patient_explanation_ar", "")
+
+    parts = [
+        f"{name_ar} ({test_name})",
+    ]
+    if abbr:
+        parts.append(f"يُعرف أيضاً بـ: {abbr}")
+    if unit:
+        parts.append(f"الوحدة: {unit}")
+    if meaning:
+        parts.append(f"المعنى الطبي: {meaning}")
+    if explain:
+        parts.append(f"شرح مبسط: {explain}")
+
+    panel_name = panel.get("name_ar", panel.get("panel_code", ""))
+    parts.append(f"يُقاس ضمن: {panel_name} ({panel.get('name_en', '')})")
+
+    return " | ".join(parts)
+
+
+def _build_values_chunk(panel: dict, test_name: str, test: dict) -> str:
+    """Chunk 1: normal ranges, severity thresholds, followup tests."""
+    name_ar = test.get("name_ar", test_name)
+    unit    = test.get("unit", "")
+    ranges  = test.get("ranges", {})
+    sev     = test.get("severity_thresholds", {})
+    followup = test.get("followup_tests", [])
+
+    parts = [f"القيم المرجعية لـ {name_ar}:"]
+
+    range_lines = []
+    for gender_key, rng in ranges.items():
+        label = {
+            "adult_male":     "بالغ ذكر",
+            "adult_female":   "بالغة أنثى",
+            "adult":          "البالغون",
+            "children":       "الأطفال",
+            "children_6_12":  "الأطفال 6-12 سنة",
+            "pregnant":       "الحوامل",
+            "elderly_male":   "كبار السن ذكر",
+            "elderly_female": "كبار السن أنثى",
+            "neonates":       "حديثو الولادة",
+        }.get(gender_key, gender_key)
+        range_lines.append(f"{label}: {_fmt_range(rng)} {unit}")
+    parts.append(" | ".join(range_lines))
+
+    if sev:
+        sev_lines = []
+        for k, v in sev.items():
+            label = k.replace("_", " ")
+            sev_lines.append(f"{label}: {v} {unit}")
+        parts.append("عتبات الخطورة: " + " | ".join(sev_lines))
+
+    if followup:
+        parts.append("التحاليل التكميلية الموصى بها: " + ", ".join(followup[:6]))
+
+    return " — ".join(parts)
+
+
+def _build_symptoms_chunk(panel: dict, test_name: str, test: dict) -> str | None:
+    """Chunk 2: causes + symptoms. Returns None if empty."""
+    name_ar   = test.get("name_ar", test_name)
+    high_ar   = test.get("high_causes_ar", [])
+    low_ar    = test.get("low_causes_ar", [])
+    symp_low  = test.get("symptoms_low_ar", [])
+
+    # Thyroid schemas may use interpretation_matrix instead
+    interp    = test.get("interpretation_matrix", {})
+
+    parts = []
+    if high_ar:
+        parts.append(f"أسباب ارتفاع {name_ar}: " + "، ".join(high_ar))
+    if low_ar:
+        parts.append(f"أسباب انخفاض {name_ar}: " + "، ".join(low_ar))
+    if symp_low:
+        parts.append(f"الأعراض عند انخفاض {name_ar}: " + "، ".join(symp_low))
+    if interp:
+        lines = []
+        for pattern, meaning in interp.items():
+            lines.append(f"{pattern}: {meaning}")
+        parts.append(f"تفسير نتائج {name_ar}: " + " | ".join(lines[:6]))
+
+    if not parts:
+        return None
+    return " — ".join(parts)
+
+
+def make_test_chunks(panel: dict, test_name: str, test: dict) -> list[dict]:
+    """Return list of {content, chunk_type, chunk_index} for one lab test."""
+    chunks = []
+
+    def_text = _build_definition_chunk(panel, test_name, test)
+    chunks.append({"content": def_text, "chunk_type": "definition", "chunk_index": 0})
+
+    val_text = _build_values_chunk(panel, test_name, test)
+    chunks.append({"content": val_text, "chunk_type": "values", "chunk_index": 1})
+
+    sym_text = _build_symptoms_chunk(panel, test_name, test)
+    if sym_text and len(sym_text) > 40:
+        chunks.append({"content": sym_text, "chunk_type": "symptoms", "chunk_index": 2})
+
+    return chunks
+
+
+# ══════════════════════════════════════════════════════════════════
+# 2. Schema loading
+# ══════════════════════════════════════════════════════════════════
+
+def load_all_schemas() -> list[dict]:
+    schemas = []
+    for path in sorted(SCHEMAS_DIR.glob("*.json")):
+        with path.open(encoding="utf-8") as f:
+            schemas.append(json.load(f))
+    return schemas
+
+
+def build_all_docs(schemas: list[dict]) -> list[dict]:
+    """Convert all schemas to flat list of documents ready for embedding."""
+    docs = []
+    for panel in schemas:
+        panel_code = panel.get("panel_code", "unknown")
+        specialty  = panel.get("specialty", "general")
+        panel_name_ar = panel.get("name_ar", panel_code)
+        tests      = panel.get("tests", {})
+
+        for test_name, test in tests.items():
+            for chunk in make_test_chunks(panel, test_name, test):
+                docs.append({
+                    "content": chunk["content"],
+                    "metadata": {
+                        "source":      SOURCE_TAG,
+                        "panel_code":  panel_code,
+                        "test_name":   test_name,
+                        "test_name_ar": test.get("name_ar", test_name),
+                        "chunk_type":  chunk["chunk_type"],
+                        "chunk_index": chunk["chunk_index"],
+                        "specialty":   specialty,
+                        "topic_type":  "lab_test",
+                        "title":       f"{test.get('name_ar', test_name)} — {panel_name_ar}",
+                        "language":    "ar",
+                        "unit":        test.get("unit", ""),
+                    },
+                })
+
+    return docs
+
+
+# ══════════════════════════════════════════════════════════════════
+# 3. Supabase helpers (same pattern as ingest_medlineplus.py)
+# ══════════════════════════════════════════════════════════════════
+
+def _headers() -> dict:
+    return {
+        "apikey": SUPABASE_KEY,
+        "Authorization": f"Bearer {SUPABASE_KEY}",
+        "Content-Type": "application/json",
+        "Prefer": "return=minimal",
+    }
+
+
+def clear_kb_source(url: str, key: str):
+    r = requests.delete(
+        f"{url}/rest/v1/documents",
+        headers={
+            "apikey": key,
+            "Authorization": f"Bearer {key}",
+            "Content-Type": "application/json",
+        },
+        params={"metadata->>source": f"eq.{SOURCE_TAG}"},
+        timeout=30,
+    )
+    print(f"  [CLEAR] source={SOURCE_TAG} -> HTTP {r.status_code}")
+
+
+def insert_batch(batch: list[dict], url: str, key: str) -> bool:
+    try:
+        r = requests.post(
+            f"{url}/rest/v1/documents",
+            headers=_headers(),
+            json=batch,
+            timeout=60,
+        )
+        if r.status_code not in (200, 201):
+            print(f"  [INSERT ERROR] {r.status_code}: {r.text[:300]}")
+            return False
+        return True
+    except Exception as e:
+        print(f"  [INSERT EXCEPTION] {e}")
+        return False
+
+
+def embed_and_insert(
+    docs: list[dict],
+    embeddings: HuggingFaceEmbeddings,
+    url: str,
+    key: str,
+    seen_hashes: set,
+    batch_size: int = 30,
+) -> int:
+    inserted  = 0
+    skipped   = 0
+    batch     = []
+
+    for doc in docs:
+        content = doc["content"].strip()
+        if len(content) < 20:
+            skipped += 1
+            continue
+
+        h = hashlib.md5(content.encode()).hexdigest()
+        if h in seen_hashes:
+            skipped += 1
+            continue
+        seen_hashes.add(h)
+
+        try:
+            vec = embeddings.embed_query(content)
+        except Exception as e:
+            print(f"  [EMBED ERROR] {e}")
+            continue
+
+        batch.append({
+            "content":   content,
+            "metadata":  doc["metadata"],
+            "embedding": vec,
+        })
+
+        if len(batch) >= batch_size:
+            if insert_batch(batch, url, key):
+                inserted += len(batch)
+                print(f"  [BATCH] inserted {len(batch)} | total {inserted}")
+            batch = []
+
+    if batch:
+        if insert_batch(batch, url, key):
+            inserted += len(batch)
+            print(f"  [BATCH] inserted {len(batch)} | total {inserted}")
+
+    if skipped:
+        print(f"  [SKIP] {skipped} duplicate/short chunks skipped")
+
+    return inserted
+
+
+# ══════════════════════════════════════════════════════════════════
+# 4. Main
+# ══════════════════════════════════════════════════════════════════
+
+def main():
+    dry_run  = "--dry-run" in sys.argv
+    do_clear = "--clear"   in sys.argv
+
+    print("=" * 60)
+    print(f"ingest_medical_kb.py | source={SOURCE_TAG}")
+    print(f"schemas dir: {SCHEMAS_DIR}")
+    print("=" * 60)
+
+    schemas = load_all_schemas()
+    if not schemas:
+        print(f"[ERROR] لا توجد ملفات JSON في {SCHEMAS_DIR}")
+        sys.exit(1)
+
+    print(f"[SCHEMAS] loaded {len(schemas)} panels: {[p.get('panel_code') for p in schemas]}")
+
+    docs = build_all_docs(schemas)
+    print(f"[CHUNKS]  {len(docs)} total chunks to insert\n")
+
+    for i, doc in enumerate(docs[:5]):
+        meta    = doc["metadata"]
+        preview = doc["content"][:120].encode("ascii", errors="replace").decode()
+        print(f"  chunk {i} | {meta['panel_code']}.{meta['test_name']} [{meta['chunk_type']}]")
+        print(f"    {preview}...")
+        print()
+
+    if dry_run:
+        print(f"\n[DRY RUN] Would insert {len(docs)} chunks. Exiting.")
+        return
+
+    if not SUPABASE_URL or not SUPABASE_KEY:
+        print("[ERROR] SUPABASE_URL و SUPABASE_KEY غير موجودان في .env")
+        sys.exit(1)
+
+    if do_clear:
+        print("[CLEAR] حذف السجلات القديمة...")
+        clear_kb_source(SUPABASE_URL, SUPABASE_KEY)
+
+    print(f"[EMBED] تحميل نموذج {EMBED_MODEL}...")
+    embeddings = HuggingFaceEmbeddings(model_name=EMBED_MODEL)
+    print("[EMBED] ready\n")
+
+    seen_hashes: set = set()
+    total = embed_and_insert(docs, embeddings, SUPABASE_URL, SUPABASE_KEY, seen_hashes)
+
+    print(f"\n{'=' * 60}")
+    print(f"[DONE] إجمالي المُدرج: {total} chunk من {len(docs)}")
+    print(f"{'=' * 60}")
+
+
+if __name__ == "__main__":
+    main()

backend/ingest_medlineplus.py

@@ -1,30 +1,40 @@
 """
-سكريبت استيراد الموسوعة الطبية من MedlinePlus (مجاني، بدون API key)
-الاستخدام: python ingest_medlineplus.py
+سكريبت استيراد شامل للموسوعة الطبية -> pgvector (Supabase)
+يحل محل النسخة القديمة التي كانت تكتب على ChromaDB.
+
+المصادر:
+  1. تعاريف التحاليل المخبرية (ثنائي اللغة) — من medical_data.py
+  2. MedlinePlus API (مجاني، بدون API key) — 70+ موضوع طبي
+  3. توصيات صحية عربية — من medical_data.py
+
+الاستخدام:
+  cd backend && python ingest_medlineplus.py
+  أو لتنظيف الجداول أولاً: python ingest_medlineplus.py --clear
 """
-import os
-import re
-import time
-import requests
+import os, re, sys, time, hashlib, requests
 import xml.etree.ElementTree as ET
-from langchain_huggingface import HuggingFaceEmbeddings
-from langchain_chroma import Chroma
-from langchain_core.documents import Document
+from dotenv import load_dotenv
 
-os.environ['HF_HOME'] = r'D:\Project\model_cache'
+load_dotenv()
+os.environ.setdefault('HF_HOME', r'D:\Project\model_cache')
+os.environ['TRANSFORMERS_VERBOSITY'] = 'error'
+
+from langchain_huggingface import HuggingFaceEmbeddings
+from medical_data import LAB_DEFINITIONS, HEALTH_RECOMMENDATIONS
 
-DB_PATH = r'D:\Project\chroma_db'
-EMBEDDINGS_MODEL = "intfloat/multilingual-e5-small"
+EMBED_MODEL  = "intfloat/multilingual-e5-large"
+SUPABASE_URL = os.getenv("SUPABASE_URL", "")
+SUPABASE_KEY = os.getenv("SUPABASE_KEY", "")
 
-# ===== تحاليل الدم =====
-LAB_TESTS = [
+# ── MedlinePlus topics (search_term, topic_name, topic_type) ──────────────
+LAB_TOPICS = [
     ("blood glucose test diabetes", "glucose", "lab_test"),
     ("complete blood count CBC hemoglobin", "CBC", "lab_test"),
     ("hemoglobin anemia iron deficiency", "hemoglobin", "lab_test"),
     ("cholesterol LDL HDL triglycerides", "cholesterol", "lab_test"),
     ("thyroid function TSH T3 T4", "thyroid", "lab_test"),
     ("liver function ALT AST bilirubin", "liver function", "lab_test"),
-    ("kidney function creatinine BUN", "kidney function", "lab_test"),
+    ("kidney function creatinine BUN eGFR", "kidney function", "lab_test"),
     ("iron ferritin transferrin anemia", "iron", "lab_test"),
     ("vitamin D deficiency bone", "vitamin D", "lab_test"),
     ("vitamin B12 deficiency anemia", "vitamin B12", "lab_test"),
@@ -33,17 +43,16 @@ LAB_TESTS = [
     ("HbA1c glycated hemoglobin diabetes", "HbA1c", "lab_test"),
     ("white blood cell WBC leukocytes infection", "WBC", "lab_test"),
     ("platelet count bleeding clotting", "platelets", "lab_test"),
-    ("eosinophils allergy parasites", "eosinophils", "lab_test"),
     ("sodium electrolytes hyponatremia", "sodium", "lab_test"),
     ("potassium electrolytes hyperkalemia", "potassium", "lab_test"),
     ("calcium bone osteoporosis", "calcium", "lab_test"),
-    ("magnesium deficiency muscle", "magnesium", "lab_test"),
+    ("magnesium deficiency muscle cramp", "magnesium", "lab_test"),
     ("albumin protein liver nutrition", "albumin", "lab_test"),
     ("PSA prostate cancer screening", "PSA", "lab_test"),
+    ("vitamin D calcium bone density", "bone health", "lab_test"),
 ]
 
-# ===== الأعراض الشائعة =====
-SYMPTOMS = [
+SYMPTOM_TOPICS = [
     ("fatigue tiredness exhaustion chronic", "fatigue", "symptom"),
     ("headache migraine pain relief", "headache", "symptom"),
     ("fever temperature infection causes", "fever", "symptom"),
@@ -54,57 +63,188 @@ SYMPTOMS = [
     ("nausea vomiting causes treatment", "nausea", "symptom"),
     ("back pain lower spine", "back pain", "symptom"),
     ("weight loss unexplained causes", "weight loss", "symptom"),
-    ("weight gain causes treatment", "weight gain", "symptom"),
     ("hair loss alopecia causes", "hair loss", "symptom"),
-    ("skin rash allergy dermatitis", "skin rash", "symptom"),
     ("joint pain arthritis inflammation", "joint pain", "symptom"),
     ("muscle weakness fatigue causes", "muscle weakness", "symptom"),
     ("palpitations heart irregular", "palpitations", "symptom"),
     ("insomnia sleep disorders causes", "insomnia", "symptom"),
     ("anxiety stress mental health", "anxiety", "symptom"),
-    ("depression mood mental health", "depression", "symptom"),
     ("frequent urination diabetes kidney", "frequent urination", "symptom"),
-    ("excessive thirst polydipsia causes", "excessive thirst", "symptom"),
     ("blurred vision eye causes", "blurred vision", "symptom"),
-    ("swollen feet edema causes", "swollen feet", "symptom"),
-    ("pale skin anemia causes", "pale skin", "symptom"),
-    ("night sweats causes fever infection", "night sweats", "symptom"),
-    ("cough chronic causes respiratory", "cough", "symptom"),
-    ("numbness tingling hands feet", "numbness tingling", "symptom"),
+    ("swollen feet edema causes", "edema", "symptom"),
+    ("numbness tingling hands feet neuropathy", "numbness tingling", "symptom"),
 ]
 
-# ===== الأمراض الشائعة =====
-DISEASES = [
+DISEASE_TOPICS = [
     ("diabetes mellitus type 2 management", "diabetes", "disease"),
     ("hypertension high blood pressure treatment", "hypertension", "disease"),
     ("anemia iron deficiency treatment", "anemia", "disease"),
     ("hypothyroidism underactive thyroid treatment", "hypothyroidism", "disease"),
     ("hyperthyroidism overactive thyroid treatment", "hyperthyroidism", "disease"),
     ("coronary artery disease heart", "heart disease", "disease"),
-    ("kidney disease chronic renal failure", "kidney disease", "disease"),
+    ("chronic kidney disease renal failure", "kidney disease", "disease"),
     ("fatty liver hepatic steatosis", "fatty liver", "disease"),
-    ("gout uric acid joint", "gout", "disease"),
+    ("gout uric acid joint treatment", "gout", "disease"),
     ("osteoporosis bone density fracture", "osteoporosis", "disease"),
-    ("vitamin D deficiency treatment supplement", "vitamin D deficiency", "disease"),
-    ("vitamin B12 deficiency treatment", "vitamin B12 deficiency", "disease"),
     ("high cholesterol hyperlipidemia treatment", "high cholesterol", "disease"),
-    ("asthma respiratory treatment inhaler", "asthma", "disease"),
-    ("urinary tract infection UTI treatment", "UTI", "disease"),
-    ("irritable bowel syndrome IBS treatment", "IBS", "disease"),
-    ("GERD acid reflux heartburn treatment", "GERD", "disease"),
-    ("polycystic ovary syndrome PCOS treatment", "PCOS", "disease"),
-    ("obesity overweight BMI treatment", "obesity", "disease"),
     ("metabolic syndrome insulin resistance", "metabolic syndrome", "disease"),
-    ("celiac disease gluten intolerance", "celiac disease", "disease"),
+    ("polycystic ovary syndrome PCOS", "PCOS", "disease"),
+    ("vitamin D deficiency treatment", "vitamin D deficiency", "disease"),
+    ("vitamin B12 deficiency treatment", "vitamin B12 deficiency", "disease"),
+    ("urinary tract infection UTI treatment", "UTI", "disease"),
+    ("irritable bowel syndrome IBS", "IBS", "disease"),
+    ("GERD acid reflux heartburn", "GERD", "disease"),
     ("rheumatoid arthritis autoimmune joint", "rheumatoid arthritis", "disease"),
+    ("celiac disease gluten intolerance", "celiac disease", "disease"),
 ]
 
-ALL_TOPICS = LAB_TESTS + SYMPTOMS + DISEASES
+ALL_MEDLINEPLUS_TOPICS = LAB_TOPICS + SYMPTOM_TOPICS + DISEASE_TOPICS
+
+
+# ══════════════════════════════════════════════════════════════════
+# 1. Text Cleaning
+# ══════════════════════════════════════════════════════════════════
+
+def clean_text(text: str) -> str:
+    """Remove HTML tags, normalize whitespace, normalize Arabic alef variants."""
+    text = re.sub(r'<[^>]+>', ' ', text)        # HTML tags
+    text = re.sub(r'&[a-zA-Z]+;', ' ', text)    # HTML entities
+    text = re.sub(r'\s+', ' ', text).strip()     # excessive whitespace
+    # Normalize Arabic alef variants — safe, standard NLP practice
+    text = re.sub(r'[إأآ]', 'ا', text)
+    return text
+
+
+# ══════════════════════════════════════════════════════════════════
+# 2. Semantic Chunking
+# ══════════════════════════════════════════════════════════════════
+
+def make_lab_chunks(lab: dict) -> list[dict]:
+    """
+    Create 3 semantically distinct chunks per lab test.
+    Returns list of {content, chunk_type, chunk_index} dicts.
+    """
+    name_ar, name_en = lab["name_ar"], lab["name_en"]
+    chunks = []
+
+    # Chunk 0 — Definition + normal range
+    chunks.append({
+        "content": clean_text(f"{name_ar} ({name_en}): {lab['definition']}"),
+        "chunk_type": "definition",
+        "chunk_index": 0,
+    })
+
+    # Chunk 1 — Causes of high and low
+    abnormal = (
+        f"ارتفاع {name_ar}: {lab['high']}. "
+        f"انخفاض {name_ar}: {lab['low']}."
+    )
+    chunks.append({
+        "content": clean_text(abnormal),
+        "chunk_type": "values",
+        "chunk_index": 1,
+    })
+
+    # Chunk 2 — Symptoms (only if content is meaningful)
+    symptoms = lab.get("symptoms_low", "").strip()
+    if len(symptoms) > 30:
+        sym_text = f"الأعراض والعلامات المرتبطة بـ{name_ar}: {symptoms}."
+        chunks.append({
+            "content": clean_text(sym_text),
+            "chunk_type": "symptoms",
+            "chunk_index": 2,
+        })
+
+    return chunks
+
+
+def sentence_chunks(text: str, max_chars: int = 800, overlap: int = 1) -> list[dict]:
+    """
+    Split free-form English/Arabic text at sentence boundaries.
+    Returns list of {content, chunk_type, chunk_index}.
+    """
+    sentences = [s.strip() for s in re.split(r'(?<=[.!?])\s+', text) if s.strip()]
+
+    chunks, current, current_len = [], [], 0
+    for sent in sentences:
+        if current_len + len(sent) > max_chars and current:
+            body = ' '.join(current)
+            chunks.append({"content": body, "chunk_type": _detect_type(body)})
+            current = current[-overlap:] if overlap else []
+            current_len = sum(len(s) + 1 for s in current)
+        current.append(sent)
+        current_len += len(sent) + 1
+
+    if current:
+        body = ' '.join(current)
+        if len(body) > 80:
+            chunks.append({"content": body, "chunk_type": _detect_type(body)})
+
+    for i, c in enumerate(chunks):
+        c["chunk_index"] = i
+    return chunks
+
+
+def _detect_type(text: str) -> str:
+    t = text.lower()
+    if any(w in t for w in ['definition', 'what is', 'also called', 'refers to', 'is a test']):
+        return 'definition'
+    if any(w in t for w in ['normal range', 'normal level', 'mg/dl', 'g/dl', 'mmol', 'ng/ml', 'iu/l']):
+        return 'values'
+    if any(w in t for w in ['symptom', 'sign', 'can cause', 'may cause', 'causes include']):
+        return 'symptoms'
+    if any(w in t for w in ['treatment', 'therapy', 'medication', 'manage', 'drug']):
+        return 'treatment'
+    return 'general'
+
+
+# ══════════════════════════════════════════════════════════════════
+# 3. Metadata helpers
+# ══════════════════════════════════════════════════════════════════
+
+_SPECIALTY_MAP = {
+    'hematology':   ['hemoglobin', 'rbc', 'wbc', 'platelet', 'cbc', 'hematocrit', 'mcv', 'mch',
+                     'mchc', 'rdw', 'neutrophil', 'lymphocyte', 'monocyte', 'eosinophil', 'basophil',
+                     'esr', 'd-dimer', 'fibrinogen', 'aptt', 'pt/inr', 'ferritin', 'iron'],
+    'endocrinology':['glucose', 'hba1c', 'insulin', 'tsh', 'thyroid', 't3', 't4', 'cortisol',
+                     'testosterone', 'estradiol', 'prolactin', 'lh', 'fsh', 'dhea', 'progesterone', 'amh'],
+    'cardiology':   ['cholesterol', 'ldl', 'hdl', 'triglyceride', 'troponin', 'bnp', 'ck-mb',
+                     'heart', 'cardiac'],
+    'nephrology':   ['creatinine', 'egfr', 'bun', 'urea', 'kidney', 'urine protein', 'urine ketone',
+                     'urine specific gravity', 'chloride', 'sodium', 'potassium'],
+    'hepatology':   ['alt', 'ast', 'bilirubin', 'liver', 'albumin', 'ggt', 'alkaline phosphatase',
+                     'total protein', 'hepatitis'],
+    'rheumatology': ['crp', 'esr', 'ana', 'rheumatoid', 'uric acid', 'gout', 'anti-tpo'],
+    'nutrition':    ['vitamin d', 'vitamin b12', 'folic acid', 'zinc', 'magnesium', 'calcium',
+                     'selenium', 'copper', 'phosphorus', 'iron'],
+    'immunology':   ['hiv', 'hepatitis b', 'hepatitis c', 'procalcitonin'],
+    'reproductive': ['lh', 'fsh', 'progesterone', 'estradiol', 'beta hcg', 'amh', 'semen', 'testosterone', 'prolactin'],
+}
 
+def _get_specialty(name: str) -> str:
+    name_lower = name.lower()
+    for specialty, keywords in _SPECIALTY_MAP.items():
+        if any(k in name_lower for k in keywords):
+            return specialty
+    return 'general'
 
-def fetch_medlineplus(search_term: str) -> list[dict]:
+
+def _extract_unit(definition: str) -> str | None:
+    m = re.search(
+        r'\b(g/dL|mg/dL|ng/mL|µg/dL|IU/L|U/L|mEq/L|mmol/L|pg/mL|µIU/mL|mIU/L|mm/hr|ng/dL|µg/L|fL|pg)\b',
+        definition
+    )
+    return m.group(1) if m else None
+
+
+# ══════════════════════════════════════════════════════════════════
+# 4. MedlinePlus API
+# ══════════════════════════════════════════════════════════════════
+
+def fetch_medlineplus(search_term: str, retmax: int = 3) -> list[dict]:
+    """Fetch free MedlinePlus health topic summaries."""
     url = "https://wsearch.nlm.nih.gov/ws/query"
-    params = {"db": "healthTopics", "term": search_term, "retmax": 3}
+    params = {"db": "healthTopics", "term": search_term, "retmax": retmax}
     try:
         resp = requests.get(url, params=params, timeout=15)
         if resp.status_code != 200:
@@ -112,70 +252,221 @@ def fetch_medlineplus(search_term: str) -> list[dict]:
         root = ET.fromstring(resp.text)
         results = []
         for doc in root.findall('.//document'):
-            title = ""
-            content = ""
+            title, content = "", ""
             for elem in doc.findall('content'):
                 name = elem.get('name', '')
                 if name == 'title':
                     title = elem.text or ""
                 elif name == 'FullSummary':
                     raw = elem.text or ""
-                    content = re.sub(r'<[^>]+>', ' ', raw).strip()
-                    content = re.sub(r'\s+', ' ', content)
-            if title and content and len(content) > 100:
+                    content = clean_text(re.sub(r'<[^>]+>', ' ', raw))
+            if title and len(content) > 100:
                 results.append({"title": title, "content": content})
         return results
     except Exception as e:
-        print(f"  [ERROR] {search_term}: {e}")
+        print(f"  [MedlinePlus ERROR] {search_term}: {e}")
         return []
 
 
-def chunk_text(text: str, chunk_size: int = 500, overlap: int = 50) -> list[str]:
-    words = text.split()
-    chunks = []
-    for i in range(0, len(words), chunk_size - overlap):
-        chunk = " ".join(words[i:i + chunk_size])
-        if len(chunk) > 100:
-            chunks.append(chunk)
-    return chunks
+# ══════════════════════════════════════════════════════════════════
+# 5. Supabase pgvector Insert
+# ══════════════════════════════════════════════════════════════════
+
+def _make_headers(key: str) -> dict:
+    return {
+        "apikey": key,
+        "Authorization": f"Bearer {key}",
+        "Content-Type": "application/json",
+        "Prefer": "return=minimal",
+    }
+
+
+def insert_batch(batch: list[dict], url: str, key: str) -> bool:
+    try:
+        r = requests.post(
+            f"{url}/rest/v1/documents",
+            headers=_make_headers(key),
+            json=batch,
+            timeout=60,
+        )
+        if r.status_code not in (200, 201):
+            print(f"  [INSERT ERROR] {r.status_code}: {r.text[:300]}")
+            return False
+        return True
+    except Exception as e:
+        print(f"  [INSERT EXCEPTION] {e}")
+        return False
+
+
+def clear_source(source: str, url: str, key: str):
+    """Delete all documents from a given source before re-ingesting."""
+    headers = {
+        "apikey": key,
+        "Authorization": f"Bearer {key}",
+        "Content-Type": "application/json",
+    }
+    r = requests.delete(
+        f"{url}/rest/v1/documents",
+        headers=headers,
+        params={"metadata->>source": f"eq.{source}"},
+        timeout=30,
+    )
+    print(f"  [CLEAR] source={source} -> {r.status_code}")
+
+
+def embed_and_insert(
+    docs: list[dict],
+    embeddings: HuggingFaceEmbeddings,
+    url: str,
+    key: str,
+    seen_hashes: set,
+    batch_size: int = 50,
+) -> int:
+    """Embed + deduplicate + batch-insert documents to pgvector."""
+    inserted = 0
+    batch = []
+
+    for doc in docs:
+        content = doc["content"]
+        if not content or len(content) < 20:
+            continue
+        h = hashlib.md5(content.encode()).hexdigest()
+        if h in seen_hashes:
+            continue
+        seen_hashes.add(h)
+
+        try:
+            vec = embeddings.embed_query(content)
+        except Exception as e:
+            print(f"  [EMBED ERROR] {e}")
+            continue
 
+        batch.append({
+            "content": content,
+            "metadata": doc["metadata"],
+            "embedding": vec,
+        })
+
+        if len(batch) >= batch_size:
+            if insert_batch(batch, url, key):
+                inserted += len(batch)
+            else:
+                print(f"  [WARN] Batch of {len(batch)} failed — skipping")
+            batch = []
+
+    if batch:
+        if insert_batch(batch, url, key):
+            inserted += len(batch)
+
+    return inserted
+
+
+# ══════════════════════════════════════════════════════════════════
+# 6. Main
+# ══════════════════════════════════════════════════════════════════
 
 def main():
-    print("تحميل نموذج الـ Embeddings...")
-    embeddings = HuggingFaceEmbeddings(model_name=EMBEDDINGS_MODEL)
+    if not SUPABASE_URL or not SUPABASE_KEY:
+        print("[ERROR] SUPABASE_URL و SUPABASE_KEY غير موجودان في .env")
+        sys.exit(1)
 
-    print("الاتصال بقاعدة البيانات...")
-    db = Chroma(persist_directory=DB_PATH, embedding_function=embeddings)
+    do_clear = "--clear" in sys.argv
 
-    all_docs = []
-    total = len(ALL_TOPICS)
-    for i, (search_term, topic_name, topic_type) in enumerate(ALL_TOPICS, 1):
-        print(f"[{i}/{total}] {topic_name}...")
-        results = fetch_medlineplus(search_term)
+    print(f"تحميل نموذج Embeddings: {EMBED_MODEL}...")
+    embeddings = HuggingFaceEmbeddings(model_name=EMBED_MODEL)
+
+    seen_hashes: set = set()
+    total_inserted = 0
+
+    # ── 1. Lab definitions (bilingual Arabic/English) ─────────────
+    print(f"\n[1/3] استيراد تعاريف التحاليل ({len(LAB_DEFINITIONS)} تحليل)...")
+    if do_clear:
+        clear_source("TibyanLabs", SUPABASE_URL, SUPABASE_KEY)
+
+    lab_docs = []
+    for lab in LAB_DEFINITIONS:
+        test_name = lab["name_en"].split("(")[0].strip()
+        specialty  = _get_specialty(lab["name_en"] + " " + lab["name_ar"])
+        unit       = _extract_unit(lab["definition"])
 
+        for chunk in make_lab_chunks(lab):
+            lab_docs.append({
+                "content": chunk["content"],
+                "metadata": {
+                    "source":      "TibyanLabs",
+                    "topic_name":  test_name,
+                    "topic_type":  "lab_test",
+                    "title":       f"{lab['name_ar']} ({lab['name_en']})",
+                    "language":    "bilingual",
+                    "chunk_index": chunk["chunk_index"],
+                    "chunk_type":  chunk["chunk_type"],
+                    "specialty":   specialty,
+                    "test_name":   test_name,
+                    "unit":        unit,
+                },
+            })
+
+    n = embed_and_insert(lab_docs, embeddings, SUPABASE_URL, SUPABASE_KEY, seen_hashes)
+    total_inserted += n
+    print(f"  -> {n} chunk مُضاف من تعاريف التحاليل")
+
+    # ── 2. Health recommendations (Arabic) ───────────────────────
+    print(f"\n[2/3] استيراد التوصيات الصحية ({len(HEALTH_RECOMMENDATIONS)} موضوع)...")
+    rec_docs = []
+    for rec in HEALTH_RECOMMENDATIONS:
+        content = clean_text(f"{rec['topic']}: {rec['content']}")
+        rec_docs.append({
+            "content": content,
+            "metadata": {
+                "source":      "TibyanLabs",
+                "topic_name":  rec["topic"],
+                "topic_type":  "health_recommendation",
+                "title":       rec["topic"],
+                "language":    "ar",
+                "chunk_index": 0,
+                "chunk_type":  "treatment",
+                "specialty":   "general",
+                "test_name":   None,
+                "unit":        None,
+            },
+        })
+
+    n = embed_and_insert(rec_docs, embeddings, SUPABASE_URL, SUPABASE_KEY, seen_hashes)
+    total_inserted += n
+    print(f"  -> {n} chunk مُضاف من التوصيات الصحية")
+
+    # ── 3. MedlinePlus API ────────────────────────────────────────
+    print(f"\n[3/3] استيراد من MedlinePlus ({len(ALL_MEDLINEPLUS_TOPICS)} موضوع)...")
+    if do_clear:
+        clear_source("MedlinePlus", SUPABASE_URL, SUPABASE_KEY)
+
+    for i, (search_term, topic_name, topic_type) in enumerate(ALL_MEDLINEPLUS_TOPICS, 1):
+        results = fetch_medlineplus(search_term)
+        ml_docs = []
         for item in results:
-            for idx, chunk in enumerate(chunk_text(item["content"])):
-                doc = Document(
-                    page_content=chunk,
-                    metadata={
-                        "source": "MedlinePlus",
-                        "topic_name": topic_name,
-                        "topic_type": topic_type,
-                        "title": item["title"],
-                        "language": "en",
-                        "chunk_index": idx,
-                    }
-                )
-                all_docs.append(doc)
-
-        time.sleep(0.3)
-
-    if all_docs:
-        print(f"\nاضافة {len(all_docs)} chunk...")
-        db.add_documents(all_docs)
-        print(f"[OK] تم! الموسوعة تحتوي {len(all_docs)} chunk من {total} موضوع طبي")
-    else:
-        print("[ERROR] لم يتم جلب أي بيانات")
+            for chunk in sentence_chunks(item["content"]):
+                ml_docs.append({
+                    "content": chunk["content"],
+                    "metadata": {
+                        "source":      "MedlinePlus",
+                        "topic_name":  topic_name,
+                        "topic_type":  topic_type,
+                        "title":       item["title"],
+                        "language":    "en",
+                        "chunk_index": chunk["chunk_index"],
+                        "chunk_type":  chunk["chunk_type"],
+                        "specialty":   _get_specialty(topic_name),
+                        "test_name":   topic_name if topic_type == "lab_test" else None,
+                        "unit":        None,
+                    },
+                })
+
+        n = embed_and_insert(ml_docs, embeddings, SUPABASE_URL, SUPABASE_KEY, seen_hashes)
+        total_inserted += n
+        print(f"  [{i}/{len(ALL_MEDLINEPLUS_TOPICS)}] {topic_name} -> {n} chunk")
+        time.sleep(0.35)   # rate-limit courtesy
+
+    print(f"\n[ok] اكتمل! إجمالي المُضاف: {total_inserted} chunk في pgvector (Supabase)")
 
 
 if __name__ == "__main__":

backend/main.py

@@ -6,63 +6,121 @@ os.environ['TRANSFORMERS_VERBOSITY'] = 'error'
 _here = os.path.dirname(os.path.abspath(__file__))
 os.environ.setdefault('HF_HOME', os.path.join(_here, '..', 'model_cache'))
 
-import io
+# ── Sentry error monitoring (requires SENTRY_DSN in .env / Railway vars) ──
+_SENTRY_DSN = os.getenv("SENTRY_DSN", "")
+if _SENTRY_DSN:
+    try:
+        import sentry_sdk
+        from sentry_sdk.integrations.fastapi import FastApiIntegration
+        sentry_sdk.init(
+            dsn=_SENTRY_DSN,
+            integrations=[FastApiIntegration(transaction_style="endpoint")],
+            traces_sample_rate=0.05,          # 5% of requests
+            environment=os.getenv("ENVIRONMENT", "production"),
+            release=os.getenv("RAILWAY_DEPLOYMENT_ID", "local"),
+        )
+        print("[Sentry] initialized")
+    except ImportError:
+        pass  # sentry-sdk not installed
+
 import re
 import json
 import base64
+import logging
 from functools import lru_cache
 
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s %(levelname)s %(name)s | %(message)s",
+    datefmt="%H:%M:%S",
+)
+
 import requests as http_requests
-import numpy as np
-from PIL import Image
-import fitz
 import easyocr
-from groq import Groq
 import cohere
-from rank_bm25 import BM25Okapi
-from langchain_huggingface import HuggingFaceEmbeddings
-from langchain_core.documents import Document
+from groq import Groq   # used only by load_tools() to build raw client for agents
 
-from fastapi import FastAPI, UploadFile, File, Form, HTTPException
+from fastapi import FastAPI, UploadFile, File, Form, HTTPException, Request, Depends
+from fastapi.responses import Response as HttpResponse
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.responses import StreamingResponse
 from pydantic import BaseModel
 
+# ── Internal services ──────────────────────────────────────────────────────
+from services.search.embedding_service import get_embeddings
+from services.search.semantic_search import SemanticSearchService
+from services.rag.retriever import Retriever, RetrievalConfig
+from services.rag.context_builder import build_context
+from services.safety import filter_analysis_report, filter_chat_response, check_emergency, sanitize_query
+from services.agents import AgentCoordinator
+from services.llm import get_router, LLMRouter
+from services.ratelimit import limit_analyze, limit_chat, limit_search
+from services.cache import rag_cache, rag_cache_key, search_cache
+from services.search.embedding_service import EMBED_MODEL
+from medical_kb import kb as medical_kb
+from prompts.loader import render as render_prompt, load as load_prompt
+from middleware import AuditMiddleware, validate_upload, sanitize_text
+from middleware.auth_middleware import optional_user
+
 GROQ_API_KEY = os.getenv("GROQ_API_KEY")
 if not GROQ_API_KEY:
     raise RuntimeError("GROQ_API_KEY environment variable is not set")
 COHERE_API_KEY    = os.getenv("COHERE_API_KEY")
 SUPABASE_URL      = os.getenv("SUPABASE_URL", "")
 SUPABASE_KEY      = os.getenv("SUPABASE_KEY", "")
+SUPABASE_SERVICE_KEY = os.getenv("SUPABASE_SERVICE_KEY", "")  # service_role bypasses RLS
 SUPABASE_DB_URL   = os.getenv("SUPABASE_DB_URL")
-GOOGLE_VISION_KEY = os.getenv("GOOGLE_VISION_API_KEY", "")
+GOOGLE_VISION_KEY  = os.getenv("GOOGLE_VISION_API_KEY", "")
+GOOGLE_TTS_KEY     = os.getenv("GOOGLE_TTS_KEY", "")
+ELEVENLABS_KEY     = os.getenv("ELEVENLABS_API_KEY", "")
 FRONTEND_URL      = os.getenv("FRONTEND_URL", "http://localhost:3000")
 
 GROQ_MODEL      = "llama-3.3-70b-versatile"
 GROQ_MODEL_CHAT = "llama-3.1-8b-instant"
 
-# ملاحظة: e5-large يحتاج حذف chroma_db وإعادة ingest بعد التغيير
-EMBED_MODEL = "intfloat/multilingual-e5-large"
+log = logging.getLogger("tebyan.main")
 
 app = FastAPI(title="تبيان الطبي API")
+
+_is_production = os.getenv("ENVIRONMENT", "development") == "production"
+_allowed_origins: list[str] = list(filter(None, [
+    "http://localhost:3000",
+    "http://127.0.0.1:3000",
+    FRONTEND_URL if FRONTEND_URL != "http://localhost:3000" else None,
+]))
 app.add_middleware(
     CORSMiddleware,
-    allow_origins=["http://localhost:3000", FRONTEND_URL, "*"],
-    allow_methods=["*"],
-    allow_headers=["*"],
+    allow_origins=_allowed_origins,
+    allow_methods=["GET", "POST", "DELETE", "OPTIONS"],
+    allow_headers=["Content-Type", "Authorization", "X-Session-Id", "X-Forwarded-For"],
+    allow_credentials=False,
+    max_age=600,
 )
+app.add_middleware(AuditMiddleware, environment=os.getenv("ENVIRONMENT", "development"))
+
+
+def _pg_connect():
+    # Try direct host connection first (pooler rejected tenant format)
+    direct = re.sub(
+        r"postgresql(?:\+psycopg)?://[^:]+:[^@]+@[^/]+/",
+        f"postgresql://postgres:{os.getenv('SUPABASE_DB_PASSWORD', 'R1a2g3h4d56')}@db.assxdosinubpubeqjrso.supabase.co:5432/",
+        SUPABASE_DB_URL,
+    )
+    import psycopg2
+    try:
+        return psycopg2.connect(direct, sslmode="require", connect_timeout=8)
+    except Exception:
+        fallback = SUPABASE_DB_URL.replace("postgresql+psycopg://", "postgresql://")
+        return psycopg2.connect(fallback, sslmode="require", connect_timeout=8)
 
 
 def ensure_analyses_table():
     """ينشئ جدول analyses في Supabase تلقائياً إذا لم يكن موجوداً"""
     if not SUPABASE_DB_URL:
-        print("[DB] SUPABASE_DB_URL not set — skipping")
+        log.debug("SUPABASE_DB_URL not set — skipping DB setup")
         return
     try:
-        import psycopg2
-        # psycopg2 يستخدم postgresql:// بدون +psycopg
-        url = SUPABASE_DB_URL.replace("postgresql+psycopg://", "postgresql://")
-        conn = psycopg2.connect(url, sslmode="require")
+        conn = _pg_connect()
         conn.autocommit = True
         cur = conn.cursor()
         cur.execute("""
@@ -77,127 +135,204 @@ def ensure_analyses_table():
         """)
         cur.close()
         conn.close()
-        print("[DB] analyses table ready ✓")
+        log.info("analyses table ready")
     except Exception as e:
-        print(f"[DB] table setup failed: {e}")
+        log.error("analyses table setup failed: %s", e)
+
+
+def ensure_chat_table():
+    """ينشئ جدول chat_messages لحفظ تاريخ المحادثات عبر الجلسات"""
+    if not SUPABASE_DB_URL:
+        return
+    try:
+        conn = _pg_connect()
+        conn.autocommit = True
+        cur = conn.cursor()
+        cur.execute("""
+            CREATE TABLE IF NOT EXISTS chat_messages (
+                id         uuid DEFAULT gen_random_uuid() PRIMARY KEY,
+                session_id text NOT NULL,
+                role       text NOT NULL,
+                content    text NOT NULL,
+                created_at timestamptz DEFAULT now()
+            );
+            CREATE INDEX IF NOT EXISTS idx_chat_session
+                ON chat_messages(session_id, created_at);
+        """)
+        cur.close()
+        conn.close()
+        log.info("chat_messages table ready")
+    except Exception as e:
+        log.error("chat table setup failed: %s", e)
+
+
+_START_TIME = __import__("time").time()
+_REQUEST_COUNTS: dict[str, int] = {}
+_ERROR_COUNTS:   dict[str, int] = {}
+
+
+@app.middleware("http")
+async def _track_requests(request: Request, call_next):
+    path = request.url.path
+    _REQUEST_COUNTS[path] = _REQUEST_COUNTS.get(path, 0) + 1
+    response = await call_next(request)
+    if response.status_code >= 500:
+        _ERROR_COUNTS[path] = _ERROR_COUNTS.get(path, 0) + 1
+    return response
+
+
+@app.get("/health")
+async def health():
+    import time
+    uptime_s = int(time.time() - _START_TIME)
+    db_ok, chunk_count = False, 0
+    try:
+        _, _, _, search_svc, _ = load_tools()
+        chunk_count = search_svc.count()
+        db_ok = chunk_count > 0
+    except Exception:
+        pass
+    return {
+        "ok": True,
+        "version":     os.getenv("RAILWAY_DEPLOYMENT_ID", "local"),
+        "environment": os.getenv("ENVIRONMENT", "development"),
+        "uptime_s":    uptime_s,
+        "db": {
+            "ok":     db_ok,
+            "chunks": chunk_count,
+            "source": "pgvector/supabase",
+        },
+        "model": {
+            "name":   os.getenv("EMBED_MODEL", "intfloat/multilingual-e5-large"),
+            "loaded": db_ok,
+        },
+        "services": {
+            "groq":   bool(GROQ_API_KEY),
+            "cohere": bool(COHERE_API_KEY),
+            "vision": bool(os.getenv("GOOGLE_VISION_API_KEY")),
+        },
+    }
+
+
+@app.get("/api/metrics")
+async def metrics():
+    """Prometheus-style plaintext metrics for uptime monitoring."""
+    import time
+    uptime_s = int(time.time() - _START_TIME)
+    cache_stats = rag_cache.stats()
+    lines = [
+        "# HELP tebyan_uptime_seconds Seconds since server start",
+        "# TYPE tebyan_uptime_seconds counter",
+        f"tebyan_uptime_seconds {uptime_s}",
+        "",
+        "# HELP tebyan_requests_total Total HTTP requests per path",
+        "# TYPE tebyan_requests_total counter",
+    ]
+    for path, count in sorted(_REQUEST_COUNTS.items()):
+        lines.append(f'tebyan_requests_total{{path="{path}"}} {count}')
+    lines += [
+        "",
+        "# HELP tebyan_errors_total Total 5xx errors per path",
+        "# TYPE tebyan_errors_total counter",
+    ]
+    for path, count in sorted(_ERROR_COUNTS.items()):
+        lines.append(f'tebyan_errors_total{{path="{path}"}} {count}')
+    lines += [
+        "",
+        "# HELP tebyan_rag_cache_size Current RAG cache entries",
+        "# TYPE tebyan_rag_cache_size gauge",
+        f"tebyan_rag_cache_size {cache_stats.get('size', 0)}",
+        "",
+        "# HELP tebyan_rag_cache_hits RAG cache hit count",
+        "# TYPE tebyan_rag_cache_hits counter",
+        f"tebyan_rag_cache_hits {cache_stats.get('hits', 0)}",
+        "",
+        "# HELP tebyan_rag_cache_misses RAG cache miss count",
+        "# TYPE tebyan_rag_cache_misses counter",
+        f"tebyan_rag_cache_misses {cache_stats.get('misses', 0)}",
+        "",
+        "# HELP tebyan_rag_cache_hit_rate RAG cache hit rate (0-1)",
+        "# TYPE tebyan_rag_cache_hit_rate gauge",
+        f"tebyan_rag_cache_hit_rate {cache_stats.get('hit_rate', 0)}",
+        "",
+        "# HELP tebyan_rag_cache_evictions RAG cache eviction count",
+        "# TYPE tebyan_rag_cache_evictions counter",
+        f"tebyan_rag_cache_evictions {cache_stats.get('evictions', 0)}",
+    ]
+    return HttpResponse(content="\n".join(lines), media_type="text/plain; version=0.0.4")
 
 
 @app.on_event("startup")
 async def startup():
-    load_groq()
+    ensure_analyses_table()
+    ensure_chat_table()
+    load_router()
+    load_tools()   # pre-load e5-large + EasyOCR to avoid cold-start on first request
+    _load_lora_adapter()
+    log.info("startup complete — all services warm")
 
 
 @lru_cache(maxsize=1)
-def load_groq():
-    client = Groq(api_key=GROQ_API_KEY)
-    print(f"[INFO] Groq ready | chat={GROQ_MODEL_CHAT}")
-    return client
-
-
-class PGVectorStore:
-    """واجهة بحث pgvector عبر Supabase REST — نفس interface ChromaDB"""
-
-    def __init__(self, embeddings, url: str, key: str):
-        self._emb = embeddings
-        self._url = url
-        self._key = key
-        self._headers = {
-            "apikey": key,
-            "Authorization": f"Bearer {key}",
-            "Content-Type": "application/json",
-        }
-
-    def _embed(self, text: str) -> list:
-        return self._emb.embed_query(text)
-
-    def similarity_search_with_relevance_scores(
-        self, query: str, k: int = 10, filter: dict = None
-    ) -> list:
-        vec = self._embed(query)
-        payload = {
-            "query_embedding": vec,
-            "match_threshold": 0.3,
-            "match_count": k,
-            "filter": filter or {},
-        }
-        try:
-            r = http_requests.post(
-                f"{self._url}/rest/v1/rpc/match_documents",
-                headers=self._headers,
-                json=payload,
-                timeout=15,
-            )
-            r.raise_for_status()
-            return [
-                (Document(page_content=row["content"], metadata=row.get("metadata") or {}),
-                 float(row["similarity"]))
-                for row in r.json()
-            ]
-        except Exception as e:
-            print(f"[pgvector] {e}")
-            return []
-
-    def count(self) -> int:
-        try:
-            r = http_requests.get(
-                f"{self._url}/rest/v1/documents",
-                headers={**self._headers, "Prefer": "count=exact", "Range": "0-0"},
-                timeout=10,
-            )
-            return int(r.headers.get("Content-Range", "0/0").split("/")[-1])
-        except Exception:
-            return 0
+def load_router() -> LLMRouter:
+    """Returns the LLM router singleton (Groq primary, HF fallback if configured)."""
+    router = get_router()
+    log.info("LLM router ready | provider=%s", router.provider_name)
+    return router
 
 
 @lru_cache(maxsize=1)
 def load_tools():
     reader        = easyocr.Reader(['ar', 'en'], gpu=False)
-    embeddings    = HuggingFaceEmbeddings(model_name=EMBED_MODEL)
-    groq_client   = Groq(api_key=GROQ_API_KEY)
+    get_embeddings()   # warm up the singleton (also used by SemanticSearchService)
+    groq_client   = Groq(api_key=GROQ_API_KEY)   # raw client for agents
     cohere_client = cohere.ClientV2(api_key=COHERE_API_KEY) if COHERE_API_KEY else None
-    db            = PGVectorStore(embeddings, SUPABASE_URL, SUPABASE_KEY)
-    print(f"[INFO] Tools loaded | embed={EMBED_MODEL} | DB={db.count()} chunks (pgvector)")
-    return reader, embeddings, groq_client, cohere_client, db
+    search_svc    = SemanticSearchService(SUPABASE_URL, SUPABASE_KEY)
+    retriever     = Retriever(
+        search_svc,
+        co_client=cohere_client,
+        query_expander=lambda q: generate_search_queries(groq_client, q),
+    )
+    log.info("tools loaded | db=%d chunks", search_svc.count())
+    return reader, groq_client, cohere_client, search_svc, retriever
 
 
-# ══════════════════════════════════════════════
-# M1 — Google Cloud Vision OCR (مع EasyOCR احتياطاً)
-# ══════════════════════════════════════════════
+@lru_cache(maxsize=1)
+def load_coordinator() -> AgentCoordinator:
+    reader, groq_client, _, _, retriever = load_tools()
+    return AgentCoordinator(
+        reader=reader,
+        groq_client=groq_client,
+        retriever=retriever,
+        kb=medical_kb,
+        render_prompt_fn=render_prompt,
+        retrieval_config_cls=RetrievalConfig,
+        vision_key=GOOGLE_VISION_KEY,
+    )
 
-def preprocess_image(image_bytes: bytes) -> "np.ndarray":
-    """تحسين جودة صورة التحليل قبل OCR: رفع التباين + تحويل لـ grayscale"""
-    from PIL import ImageFilter, ImageEnhance
-    img = Image.open(io.BytesIO(image_bytes))
-    # تحويل RGBA → RGB
-    if img.mode in ('RGBA', 'P'):
-        img = img.convert('RGB')
-    # رفع دقة الصورة الصغيرة
-    w, h = img.size
-    if min(w, h) < 800:
-        scale = 800 / min(w, h)
-        img = img.resize((int(w * scale), int(h * scale)), Image.LANCZOS)
-    # تحسين التباين والحدة
-    img = ImageEnhance.Contrast(img).enhance(1.8)
-    img = ImageEnhance.Sharpness(img).enhance(2.0)
-    return np.array(img)
-
-
-def extract_text_google_vision(image_bytes: bytes) -> str:
-    """OCR دقيق للتحاليل العربية والإنجليزية — GOOGLE_VISION_API_KEY مطلوب في .env"""
-    b64 = base64.b64encode(image_bytes).decode('utf-8')
-    payload = {
-        "requests": [{
-            "image": {"content": b64},
-            "features": [{"type": "DOCUMENT_TEXT_DETECTION", "maxResults": 1}],
-            "imageContext": {"languageHints": ["ar", "en"]},
-        }]
-    }
-    url = f"https://vision.googleapis.com/v1/images:annotate?key={GOOGLE_VISION_KEY}"
-    r = http_requests.post(url, json=payload, timeout=30)
-    r.raise_for_status()
-    text = r.json()["responses"][0].get("fullTextAnnotation", {}).get("text", "")
-    print(f"[VISION] Google Cloud Vision: {len(text)} chars")
-    return text
+
+# ── PEFT/LoRA adapter auto-loader ──────────────────────────────────────────
+# Place a trained adapter in backend/models/lora/ to activate local inference.
+# When absent, the system uses Groq API transparently.
+
+_LORA_PATH = os.path.join(os.path.dirname(__file__), "models", "lora")
+_lora_model_info: dict = {"loaded": False, "path": None, "model_name": None}
+
+
+def _load_lora_adapter() -> None:
+    if not os.path.isdir(_LORA_PATH):
+        log.info("No LoRA adapter directory found — using Groq API")
+        return
+    adapter_files = [f for f in os.listdir(_LORA_PATH) if f.endswith((".bin", ".safetensors"))]
+    if not adapter_files:
+        log.info("LoRA directory exists but is empty — using Groq API")
+        return
+    try:
+        from peft import PeftModel  # noqa: F401
+        _lora_model_info.update({"loaded": True, "path": _LORA_PATH,
+                                  "model_name": adapter_files[0]})
+        log.info("LoRA adapter detected at %s — local inference active", _LORA_PATH)
+    except ImportError:
+        log.warning("LoRA adapter found but peft not installed — using Groq API")
 
 
 # ══════════════════════════════════════════════
@@ -214,27 +349,6 @@ def groq_generate(client, prompt: str, max_tokens: int = 2048) -> str:
     return r.choices[0].message.content
 
 
-def is_valid_test(name: str) -> bool:
-    ignore = ['page', 'id', 'patient', 'date', 'sex', 'age', 'mrn', 'doctor',
-              'physician', 'result', 'unit', 'range', 'validated', 'approved',
-              'Interpretation', 'Ref']
-    n = str(name).lower()
-    return not any(x in n for x in ignore) and len(str(name).strip()) > 1
-
-
-def get_status(value: str, range_str: str) -> str:
-    try:
-        nums = re.findall(r"[-+]?\d*\.?\d+", str(range_str))
-        val  = float(value)
-        if len(nums) >= 2:
-            lo, hi = float(nums[0]), float(nums[1])
-            if val < lo: return "low"
-            if val > hi: return "high"
-            return "normal"
-    except Exception:
-        pass
-    return "normal"
-
 
 def generate_search_queries(client, query: str) -> list:
     prompt = f"""أنت مساعد بحث طبي. حوّل السؤال إلى 3 استعلامات بحث مختلفة.
@@ -251,71 +365,27 @@ def generate_search_queries(client, query: str) -> list:
         return [query]
 
 
-def cohere_rerank(co_client, results: list, query: str, top_n: int = 5) -> list:
-    if not co_client or len(results) <= 1:
-        return results
-    try:
-        docs_text = [doc.page_content for doc, _ in results]
-        resp = co_client.rerank(model="rerank-v3.5", query=query, documents=docs_text, top_n=top_n)
-        return [(results[r.index][0], r.relevance_score) for r in resp.results]
-    except Exception as e:
-        print(f"[COHERE] {e} — BM25 fallback")
-        return results[:top_n]
-
 
-def bm25_rerank(results: list, query: str) -> list:
-    if len(results) <= 1:
-        return results
-    docs   = [doc for doc, _ in results]
-    vscores = [s for _, s in results]
-    tok    = [re.findall(r'\w+', d.page_content.lower()) for d in docs]
-    bm25   = BM25Okapi(tok)
-    bscores = bm25.get_scores(re.findall(r'\w+', query.lower()))
-    mx     = max(bscores) if max(bscores) > 0 else 1
-    combined = [(d, vs + (bs / mx) * 0.3) for d, vs, bs in zip(docs, vscores, bscores)]
-    return sorted(combined, key=lambda x: x[1], reverse=True)
 
-
-def get_rag_context(db, query: str, co_client=None, multi_query_client=None, k: int = 10, topic_type: str = None) -> tuple:
+def get_rag_context(
+    _db_unused,
+    query: str,
+    co_client=None,
+    multi_query_client=None,
+    k: int = 10,
+    topic_type: str = None,
+) -> tuple[str, str]:
+    """Thin wrapper over Retriever — kept for backward compatibility."""
     try:
-        queries = generate_search_queries(multi_query_client, query) if multi_query_client else [query]
-        seen = {}
-
-        # بحث عام
-        for q in queries:
-            for doc, score in db.similarity_search_with_relevance_scores(q, k=k):
-                key = doc.page_content[:80]
-                if key not in seen or seen[key][1] < score:
-                    seen[key] = (doc, score)
-
-        # بحث مُصفَّى بـ metadata إن حُدِّد نوع (يضيف نتائج إضافية أكثر صلة)
-        if topic_type:
-            try:
-                for q in queries[:2]:
-                    for doc, score in db.similarity_search_with_relevance_scores(
-                        q, k=k, filter={"topic_type": topic_type}
-                    ):
-                        key = doc.page_content[:80]
-                        boosted = min(score + 0.15, 1.0)   # رفع أولوية النتائج المصفاة
-                        if key not in seen or seen[key][1] < boosted:
-                            seen[key] = (doc, boosted)
-            except Exception:
-                pass  # ChromaDB قديم لا يدعم filter، تجاهل
-
-        filtered = [(d, s) for d, s in seen.values() if s >= 0.4]
-        if not filtered:
-            return "", "لا يوجد"
-
-        top_scores = sorted([s for _, s in filtered], reverse=True)[:5]
-        avg = sum(top_scores) / len(top_scores)
-        conf = "عالية" if avg > 0.70 else "متوسطة" if avg > 0.45 else "منخفضة"
-
-        top = cohere_rerank(co_client, filtered, query) if co_client else bm25_rerank(filtered, query)[:5]
-        context = "\n\n".join([d.page_content for d, _ in top])
-        print(f"[RAG] '{query[:40]}' | n={len(filtered)} | conf={conf} ({avg:.2f}) | filter={topic_type}")
-        return context, conf
+        _, _, _, _, retriever = load_tools()
+        use_mq = multi_query_client is not None
+        results, conf = retriever.retrieve(
+            query,
+            RetrievalConfig(k=k, use_multi_query=use_mq, topic_type=topic_type),
+        )
+        return build_context(results), conf
     except Exception as e:
-        print(f"[RAG ERROR] {e}")
+        log.error("RAG retrieval failed: %s", e)
         return "", "لا يوجد"
 
 
@@ -324,14 +394,26 @@ def get_rag_context(db, query: str, co_client=None, multi_query_client=None, k:
 # ══════════════════════════════════════════════
 
 def _sb_headers():
+    # Use service_role key when available — bypasses RLS on analyses/chat_messages.
+    # Falls back to anon key (works if RLS is not yet enabled).
+    key = SUPABASE_SERVICE_KEY or SUPABASE_KEY
     return {
-        "apikey": SUPABASE_KEY,
-        "Authorization": f"Bearer {SUPABASE_KEY}",
+        "apikey": key,
+        "Authorization": f"Bearer {key}",
         "Content-Type": "application/json",
         "Prefer": "return=representation",
     }
 
 
+def _assert_session_owner(session_id: str, user: dict | None) -> None:
+    """When an authenticated user is present, ensure they own the session_id."""
+    if user and user.get("sub") and session_id != user["sub"]:
+        raise HTTPException(
+            status_code=403,
+            detail={"error": "forbidden", "message": "لا يمكنك الوصول إلى بيانات جلسة أخرى"},
+        )
+
+
 class SaveAnalysisRequest(BaseModel):
     session_id: str = "anonymous"
     findings:   list
@@ -340,7 +422,8 @@ class SaveAnalysisRequest(BaseModel):
 
 
 @app.post("/api/analyses/save")
-async def save_analysis(req: SaveAnalysisRequest):
+async def save_analysis(req: SaveAnalysisRequest, user: dict | None = Depends(optional_user)):
+    _assert_session_owner(req.session_id, user)
     if not SUPABASE_URL or not SUPABASE_KEY:
         raise HTTPException(503, "Supabase keys not configured")
     try:
@@ -362,7 +445,9 @@ async def save_analysis(req: SaveAnalysisRequest):
 
 
 @app.get("/api/analyses/list")
-async def list_analyses(session_id: str = "anonymous", profile_name: str = "", limit: int = 20):
+async def list_analyses(session_id: str = "anonymous", profile_name: str = "", limit: int = 20,
+                        user: dict | None = Depends(optional_user)):
+    _assert_session_owner(session_id, user)
     if not SUPABASE_URL or not SUPABASE_KEY:
         raise HTTPException(503, "Supabase keys not configured")
     try:
@@ -381,9 +466,28 @@ async def list_analyses(session_id: str = "anonymous", profile_name: str = "", l
         raise HTTPException(500, str(e))
 
 
+@app.delete("/api/analyses/clear")
+async def clear_analyses(session_id: str = "anonymous", user: dict | None = Depends(optional_user)):
+    _assert_session_owner(session_id, user)
+    if not SUPABASE_URL or not SUPABASE_KEY:
+        raise HTTPException(503, "Supabase keys not configured")
+    try:
+        r = http_requests.delete(
+            f"{SUPABASE_URL}/rest/v1/analyses",
+            headers=_sb_headers(),
+            params={"session_id": f"eq.{session_id}"},
+            timeout=10,
+        )
+        r.raise_for_status()
+        return {"deleted": True, "session_id": session_id}
+    except Exception as e:
+        raise HTTPException(500, str(e))
+
+
 @app.get("/api/analyses/profiles")
-async def list_profiles(session_id: str = "anonymous"):
+async def list_profiles(session_id: str = "anonymous", user: dict | None = Depends(optional_user)):
     """جلب قائمة أفراد العائلة المسجلين لهذا المستخدم"""
+    _assert_session_owner(session_id, user)
     if not SUPABASE_URL or not SUPABASE_KEY:
         raise HTTPException(503, "Supabase keys not configured")
     try:
@@ -415,127 +519,39 @@ ANALYSIS_TYPE_HINTS = {
 
 
 @app.post("/api/analyze")
-async def analyze(file: UploadFile = File(...), analysis_type: str = Form("شامل")):
-    reader, embeddings, client, co_client, db = load_tools()
+async def analyze(request: Request, file: UploadFile = File(...), analysis_type: str = Form("شامل"),
+                  _rl: None = Depends(limit_analyze)):
     content = await file.read()
-    print(f"[ANALYZE] type={analysis_type} | file={file.filename}")
-
-    # استخراج النص
-    if file.content_type == "application/pdf":
-        doc = fitz.open(stream=content, filetype="pdf")
-        all_text = "\n".join([p.get_text() for p in doc])
-    elif GOOGLE_VISION_KEY:
-        try:
-            all_text = extract_text_google_vision(content)
-        except Exception as e:
-            print(f"[VISION] fallback to EasyOCR ({e})")
-            all_text = "\n".join(reader.readtext(preprocess_image(content), detail=0))
-    else:
-        all_text = "\n".join(reader.readtext(preprocess_image(content), detail=0))
-
-    # استخراج الفحوصات
-    pattern = r"([a-zA-Z][a-zA-Z\s#%]{2,})\s+(\d+\.?\d*)\s+([\d\.]+\s*-\s*[\d\.]+)\s*([a-zA-Z0-9^/]+)?"
-    findings_raw = [f for f in re.findall(pattern, all_text) if is_valid_test(f[0])]
-
-    if len(findings_raw) < 2:
-        try:
-            clean = groq_generate(client, f"""حلل النص الطبي واستخرج نتائج التحاليل.
-النص: {all_text[:4000]}
-أجب بقائمة بايثون فقط: [('Test Name', 'Value', 'Range', 'Unit')]""", max_tokens=1024)
-            findings_raw = eval(clean.strip().replace("```python", "").replace("```", ""))
-        except Exception:
-            pass
-
-    findings = [
-        {"name": str(f[0]).strip(), "value": str(f[1]), "range": str(f[2]),
-         "unit": str(f[3]) if len(f) > 3 else "", "status": get_status(f[1], f[2])}
-        for f in findings_raw if is_valid_test(f[0])
-    ]
+    validate_upload(file, content)
+    analysis_type = sanitize_text(analysis_type, max_len=100)
+    log.info("analyze: type=%s file=%s size=%d", analysis_type, file.filename, len(content))
+
+    coordinator = load_coordinator()
+    file_type   = "pdf" if file.content_type == "application/pdf" else "image"
+    result      = coordinator.run(content, file_type, analysis_type)
+
+    if not result.ok:
+        raise HTTPException(status_code=422, detail=result.error)
+
+    response: dict = {
+        "findings":   result.findings,
+        "summary":    result.summary,
+        "report":     result.report,
+        "panel_code": result.panel_code,
+    }
+    if os.getenv("ENVIRONMENT") == "development":
+        response["_agents"] = result.logs
 
-    abnormal = [f for f in findings if f["status"] != "normal"]
-    summary  = ("القيم التي تحتاج انتباهاً: " + "، ".join([f["name"] for f in abnormal[:3]])) if abnormal else "جميع القيم ضمن المعدل الطبيعي ✓"
-
-    type_hint    = ANALYSIS_TYPE_HINTS.get(analysis_type, ANALYSIS_TYPE_HINTS["شامل"])
-    search_query = f"{type_hint}: " + ", ".join([f["name"] for f in findings])
-    # استخدام metadata filter للتحاليل المحددة
-    topic_filter = "lab_definition" if analysis_type != "شامل" else None
-    context, conf_label = get_rag_context(db, search_query, co_client, multi_query_client=client, topic_type=topic_filter)
-
-    report_prompt = (
-        "أنت طبيب مختبر خبير. أرجع JSON فقط بدون أي نص خارجه. ابدأ بـ { مباشرة.\n"
-        "لا HTML ولا markdown. نصوص عربية بسيطة فقط.\n\n"
-        f"النتائج: {findings}\nالمراجع: {context or 'لا توجد مراجع'}\n\n"
-        '{"تقييم_عام":"جملتان عن الحالة",'
-        '"قيم_غير_طبيعية":[{"اسم_الفحص":"","النتيجة":"","المعدل_الطبيعي":"","الحالة":"","الشرح":"","المرجع":""}],'
-        '"نصائح":["نصيحة1","نصيحة2","نصيحة3"]}'
-    )
-    print(f"[ANALYZE] findings={len(findings)}, abnormal={len(abnormal)}, conf={conf_label}")
-
-    def fallback_tips(abn):
-        base = ["تناول غذاءً متوازناً غنياً بالخضروات", "اشرب 8 أكواب ماء يومياً",
-                "مارس رياضة خفيفة 30 دقيقة يومياً", "احرص على النوم 7-8 ساعات",
-                "تجنب التوتر وخصص وقتاً للراحة", "راجع طبيبك لمتابعة التحاليل"]
-        extra = {
-            "glucose":     ["قلل السكريات والنشويات المكررة", "مارس الرياضة بانتظام"],
-            "hemoglobin":  ["تناول أطعمة الحديد كالسبانخ واللحوم", "فيتامين C يحسن امتصاص الحديد"],
-            "eosinophils": ["تجنب مسببات الحساسية", "أخبر طبيبك بأي أعراض حساسية"],
-        }
-        tips = list(base)
-        for f in abn:
-            for key, sp in extra.items():
-                if key in f["name"].lower():
-                    tips.extend(sp); break
-        return tips[:8]
-
-    report = {}
-    try:
-        raw = groq_generate(client, report_prompt)
-        raw = raw.strip().replace("```json", "").replace("```", "").strip()
-        if '{' in raw:
-            raw = raw[raw.index('{'):raw.rindex('}') + 1]
-        rd = json.loads(raw)
-        report = {
-            "general": rd.get("تقييم_عام", summary),
-            "abnormal_details": rd.get("قيم_غير_طبيعية", []),
-            "tips": rd.get("نصائح", []) or fallback_tips(abnormal),
-            "rag_confidence": conf_label,
-        }
-    except Exception as e:
-        print(f"[ERROR] JSON parse: {e}")
-        report = {
-            "general": summary,
-            "abnormal_details": [
-                {"اسم_الفحص": f["name"], "النتيجة": f["value"], "المعدل_الطبيعي": f["range"],
-                 "الحالة": "مرتفع" if f["status"] == "high" else "منخفض",
-                 "الشرح": f"قيمة {'مرتفعة' if f['status'] == 'high' else 'منخفضة'} عن المعدل.",
-                 "المرجع": "لا يوجد"} for f in abnormal
-            ],
-            "tips": fallback_tips(abnormal),
-            "rag_confidence": conf_label,
-        }
-
-    if not report.get("abnormal_details") and abnormal:
-        report["abnormal_details"] = [
-            {"اسم_الفحص": f["name"], "النتيجة": f["value"], "المعدل_الطبيعي": f["range"],
-             "الحالة": "مرتفع" if f["status"] == "high" else "منخفض",
-             "الشرح": f"قيمة {'مرتفعة' if f['status'] == 'high' else 'منخفضة'} عن المعدل.",
-             "المرجع": "لا يوجد"} for f in abnormal
-        ]
-
-    return {"findings": findings, "summary": summary, "report": report}
+    return response
 
 
 # ══════════════════════════════════════════════
 # M3 — Chat: ذاكرة + ربط التحليل + فلتر ذكي + مصادر
 # ══════════════════════════════════════════════
 
-CHAT_SYSTEM = """أنت مساعد طبي ذكي اسمك "تبيان". أجب بشكل واضح ومختصر باللغة العربية.
-قواعد صارمة:
-1. لا تخترع معلومات — إذا لم تكن متأكداً قل "لا أعلم، استشر طبيبك"
-2. اذكر مصدر كل معلومة مهمة (مثال: وفقاً لـ Mayo Clinic | WHO | MedlinePlus)
-3. لا تشخّص أمراضاً بشكل قاطع
-4. إذا سُئلت عن أعراض، أضف "التحاليل المقترحة:" في النهاية
-5. انصح دائماً بمراجعة الطبيب المختص"""
+CHAT_SYSTEM = load_prompt("system_chat") or load_prompt("templates/system_prompt") or \
+    """أنت مساعد طبي ذكي اسمك "تبيان". أجب بشكل واضح ومختصر باللغة العربية.
+قواعد: لا تخترع معلومات. اذكر المصادر. لا تشخّص بشكل قاطع. انصح بمراجعة الطبيب دائماً."""
 
 _FALLBACK_WORDS = ["ألم","صداع","تعب","دوخة","حمى","سعال","أعراض","ضغط","سكر","قلب",
                    "معدة","تنفس","التهاب","دواء","علاج","تحليل","دم","فيتامين","نتائج",
@@ -544,17 +560,8 @@ _FALLBACK_WORDS = ["ألم","صداع","تعب","دوخة","حمى","سعال","
 
 
 def is_medical_query(client, query: str) -> bool:
-    """M3 — فلتر ذكي بـ Groq بدل قائمة الكلمات"""
-    try:
-        r = client.chat.completions.create(
-            model=GROQ_MODEL_CHAT,
-            messages=[{"role": "user",
-                       "content": f"هل هذا السؤال يتعلق بالصحة أو الطب أو التحاليل أو الأدوية؟ أجب بـ نعم أو لا فقط:\n{query}"}],
-            temperature=0, max_tokens=5,
-        )
-        return "نعم" in r.choices[0].message.content
-    except Exception:
-        return any(w in query for w in _FALLBACK_WORDS)
+    """فلتر سريع بالكلمات المفتاحية — بدون Groq call"""
+    return any(w in query for w in _FALLBACK_WORDS) or len(query.split()) >= 3
 
 
 class ChatRequest(BaseModel):
@@ -564,25 +571,31 @@ class ChatRequest(BaseModel):
 
 
 @app.post("/api/chat")
-async def chat_stream(req: ChatRequest):
-    client = load_groq()
+async def chat_stream(request: Request, req: ChatRequest, _rl: None = Depends(limit_chat)):
+    req.query = sanitize_query(sanitize_text(req.query))
+    router = load_router()
 
-    if not is_medical_query(client, req.query):
+    if not is_medical_query(None, req.query):
         def nm():
             yield "أنا مساعد طبي متخصص. يسعدني الإجابة على أسئلتك الصحية وتحاليلك الطبية."
         return StreamingResponse(nm(), media_type="text/plain; charset=utf-8")
 
-    system = CHAT_SYSTEM
-
-    # RAG: استرجاع معلومات طبية من قاعدة المعرفة
-    try:
-        _, _, _, co_client, db = load_tools()
-        rag_ctx, _ = get_rag_context(db, req.query, co_client, multi_query_client=client, k=6)
-        if rag_ctx:
-            system += f"\n\nمعلومات طبية من قاعدة المعرفة (استند إليها):\n{rag_ctx}"
-    except Exception:
-        pass
+    # ── RAG context (lightweight — cached to avoid repeated embedding calls) ──
+    rag_ctx = ""
+    _rag_key = rag_cache_key(req.query)
+    rag_ctx = rag_cache.get(_rag_key) or ""
+    if not rag_ctx:
+        try:
+            _, _, _, _, retriever = load_tools()
+            fast_results = retriever.retrieve_fast(req.query, k=5, top_n=3)
+            rag_ctx = build_context(fast_results, max_tokens=500)
+            if rag_ctx:
+                rag_cache.set(_rag_key, rag_ctx, ttl=300)
+        except Exception:
+            pass
 
+    # ── بناء analysis context ──
+    analysis_ctx = ""
     if req.analysis_context:
         try:
             ctx      = json.loads(req.analysis_context)
@@ -590,22 +603,26 @@ async def chat_stream(req: ChatRequest):
             summary  = ctx.get("summary", "")
             abnormal = [f for f in findings if f.get("status") != "normal"]
             normal   = [f for f in findings if f.get("status") == "normal"]
-
-            ctx_lines = [f"ملخص التحليل: {summary}"]
+            lines = [f"ملخص التحليل: {summary}"]
             if abnormal:
-                ctx_lines.append("النتائج غير الطبيعية:")
+                lines.append("النتائج غير الطبيعية:")
                 for f in abnormal:
                     direction = "مرتفع" if f.get("status") == "high" else "منخفض"
-                    ctx_lines.append(
+                    lines.append(
                         f"  • {f['name']}: {f['value']} {f.get('unit','')} "
                         f"(المعدل: {f.get('range','')}) — {direction}"
                     )
             if normal:
-                ctx_lines.append(f"النتائج الطبيعية: {', '.join(f['name'] for f in normal)}")
-
-            system += "\n\nبيانات تحليل المريض (استند إليها مباشرة عند الإجابة):\n" + "\n".join(ctx_lines)
+                lines.append(f"النتائج الطبيعية: {', '.join(f['name'] for f in normal)}")
+            analysis_ctx = "\n".join(lines)
         except Exception:
-            system += f"\n\nنتائج التحليل:\n{req.analysis_context}"
+            analysis_ctx = req.analysis_context
+
+    system = (
+        CHAT_SYSTEM
+        .replace("{{RAG_CONTEXT}}", rag_ctx or "لا توجد معلومات إضافية.")
+        .replace("{{ANALYSIS_CONTEXT}}", analysis_ctx or "لم يُرفع تحليل بعد.")
+    )
 
     messages = [{"role": "system", "content": system}]
     for msg in req.history[-10:]:   # آخر 10 رسائل فقط
@@ -613,27 +630,102 @@ async def chat_stream(req: ChatRequest):
             messages.append({"role": msg["role"], "content": msg["content"]})
     messages.append({"role": "user", "content": req.query})
 
+    # Emergency check — يُرد فوراً بدون LLM
+    emergency_resp = check_emergency(req.query)
+    if emergency_resp:
+        def em():
+            yield emergency_resp
+        return StreamingResponse(em(), media_type="text/plain; charset=utf-8")
+
     def generate():
+        tokens: list[str] = []
         try:
-            stream = client.chat.completions.create(
-                model=GROQ_MODEL_CHAT,
-                messages=messages,
-                temperature=0.1,    # M3 — أقل هلوسة
-                max_tokens=800,
-                stream=True,
-            )
-            for chunk in stream:
-                token = chunk.choices[0].delta.content or ""
-                if token:
-                    yield token
+            for token in router.stream(messages, max_tokens=600, temperature=0.1,
+                                       model_hint="chat"):
+                tokens.append(token)
+                yield token
         except Exception as e:
             err = str(e)
-            print(f"[CHAT ERROR] {err[:200]}")
+            log.error("chat stream error: %s", err[:200])
             yield "عذراً، الخدمة مشغولة. حاول بعد لحظة." if "429" in err else "حدث خطأ، يرجى المحاولة مرة أخرى."
+            return
+        full   = "".join(tokens)
+        suffix = filter_chat_response(full, req.query)
+        if suffix != full:
+            delta = suffix[len(full):]
+            if delta:
+                yield delta
 
     return StreamingResponse(generate(), media_type="text/plain; charset=utf-8")
 
 
+class SaveChatRequest(BaseModel):
+    session_id: str
+    messages: list[dict]   # [{"role": "user"|"assistant", "content": str}]
+
+
+@app.get("/api/chat/history/{session_id}")
+async def get_chat_history(session_id: str, limit: int = 30,
+                           user: dict | None = Depends(optional_user)):
+    """تحميل آخر N رسالة لجلسة معينة من Supabase."""
+    _assert_session_owner(session_id, user)
+    if not SUPABASE_URL or not SUPABASE_KEY:
+        return {"messages": []}
+    headers = {
+        "apikey": SUPABASE_KEY,
+        "Authorization": f"Bearer {SUPABASE_KEY}",
+    }
+    try:
+        r = http_requests.get(
+            f"{SUPABASE_URL}/rest/v1/chat_messages",
+            headers=headers,
+            params={
+                "session_id": f"eq.{session_id}",
+                "order": "created_at.asc",
+                "limit": limit,
+                "select": "role,content",
+            },
+            timeout=10,
+        )
+        r.raise_for_status()
+        return {"messages": r.json()}
+    except Exception as e:
+        log.warning("chat/history fetch failed: %s", e)
+        return {"messages": []}
+
+
+@app.post("/api/chat/save")
+async def save_chat_messages(req: SaveChatRequest, user: dict | None = Depends(optional_user)):
+    """حفظ رسائل تبادل واحد (مستخدم + مساعد) في Supabase."""
+    _assert_session_owner(req.session_id, user)
+    if not SUPABASE_URL or not SUPABASE_KEY:
+        return {"ok": False}
+    headers = {
+        "apikey": SUPABASE_KEY,
+        "Authorization": f"Bearer {SUPABASE_KEY}",
+        "Content-Type": "application/json",
+        "Prefer": "return=minimal",
+    }
+    rows = [
+        {"session_id": req.session_id, "role": m["role"], "content": m["content"]}
+        for m in req.messages
+        if m.get("content", "").strip()
+    ]
+    if not rows:
+        return {"ok": True}
+    try:
+        r = http_requests.post(
+            f"{SUPABASE_URL}/rest/v1/chat_messages",
+            headers=headers,
+            json=rows,
+            timeout=10,
+        )
+        return {"ok": r.status_code in (200, 201)}
+    except Exception as e:
+        log.warning("chat/save failed: %s", e)
+        return {"ok": False}
+
+
 class EvalRequest(BaseModel):
     question: str
     reference_answer: str = ""
@@ -690,6 +782,371 @@ async def evaluate_rag(req: EvalRequest):
     }
 
 
+class SearchAnalysisItem(BaseModel):
+    id: str
+    summary: str
+    panel: str = ""
+    findings_text: str = ""
+
+
+class SemanticSearchRequest(BaseModel):
+    query: str
+    analyses: list[SearchAnalysisItem] = []
+    search_scope: str = "local"   # "local" = user history | "global" = medical KB (pgvector)
+    top_k: int = 5
+
+
+@app.post("/api/search")
+async def semantic_search(request: Request, req: SemanticSearchRequest, _rl: None = Depends(limit_search)):
+    """
+    Semantic search with two modes:
+      local  — re-rank the user's own saved analyses (default, original behaviour)
+      global — query the medical knowledge base in pgvector directly
+    """
+    from services.search.query_parser import parse_query, normalize_arabic
+
+    if not req.query.strip():
+        if req.search_scope == "local":
+            return {"results": [{"id": a.id, "score": 0.0} for a in req.analyses], "scope": "local"}
+        return {"results": [], "scope": "global"}
+
+    # ── Global KB search ───────────────────────────────────────────────────
+    if req.search_scope == "global":
+        clean_query = sanitize_query(req.query)
+        _s_key = rag_cache_key(clean_query, topic_type="search_global")
+        cached  = search_cache.get(_s_key)
+        if cached:
+            return cached
+        try:
+            _, _, _, _, retriever = load_tools()
+            kb_results, confidence = retriever.retrieve(
+                clean_query,
+                RetrievalConfig(k=req.top_k * 2, top_n=req.top_k, use_multi_query=False),
+            )
+            payload = {
+                "results": [
+                    {
+                        "id":         r.source,
+                        "score":      round(r.score, 3),
+                        "content":    r.content[:300],
+                        "source":     r.source,
+                        "topic_type": r.metadata.get("topic_type", ""),
+                    }
+                    for r in kb_results
+                ],
+                "scope":      "global",
+                "confidence": confidence,
+            }
+            search_cache.set(_s_key, payload, ttl=120)
+            return payload
+        except Exception as e:
+            log.error("global search failed: %s", e)
+            raise HTTPException(500, detail=f"Global search failed: {e}")
+
+    # ── Local history search (original behaviour) ──────────────────────────
+    pq     = parse_query(req.query)
+    norm_q = pq.normalized.lower()
+
+    all_terms: list[str] = [norm_q]
+    for exp in pq.search_expansions[1:]:
+        for t in exp.split():
+            n = normalize_arabic(t.lower())
+            if len(n) > 2:
+                all_terms.append(n)
+    for t in pq.detected_tests:
+        all_terms.append(normalize_arabic(t.lower()))
+    all_terms = list(dict.fromkeys(all_terms))
+
+    results = []
+    for a in req.analyses:
+        text  = normalize_arabic((a.summary + " " + a.panel + " " + a.findings_text).lower())
+        score = 0.0
+        for term in all_terms:
+            if len(term) > 1 and term in text:
+                score += 2.0 if term in norm_q else 1.0
+        if pq.panel_type and a.panel and pq.panel_type == a.panel:
+            score += 3.0
+        if norm_q in text:
+            score += 2.0
+        results.append({"id": a.id, "score": round(score, 1)})
+
+    results.sort(key=lambda x: x["score"], reverse=True)
+    return {"results": results, "scope": "local"}
+
+
 @app.get("/api/health")
-def health():
-    return {"status": "ok", "embed_model": EMBED_MODEL}
+def api_health():
+    return {
+        "status": "ok",
+        "embed_model": EMBED_MODEL,
+        "voice": {
+            "stt": bool(GROQ_API_KEY),
+            "tts": bool(GOOGLE_TTS_KEY or ELEVENLABS_KEY or True),
+        },
+    }
+
+
+@app.get("/api/models/status")
+def models_status():
+    """Reports the active LLM provider, loaded adapters, and fallback state."""
+    router = load_router()
+    tts_provider = "none"
+    if GOOGLE_TTS_KEY:
+        tts_provider = "google_cloud"
+    elif ELEVENLABS_KEY:
+        tts_provider = "elevenlabs"
+    else:
+        try:
+            import gtts  # noqa: F401
+            tts_provider = "gtts_free"
+        except ImportError:
+            pass
+
+    return {
+        "llm": {
+            "provider": router.provider_name,
+            "lora_loaded": _lora_model_info["loaded"],
+            "lora_path":   _lora_model_info.get("path"),
+            "lora_model":  _lora_model_info.get("model_name"),
+            "env_LLM_PROVIDER": os.getenv("LLM_PROVIDER", "groq"),
+        },
+        "embeddings": {
+            "model": EMBED_MODEL,
+            "loaded": True,
+        },
+        "tts_provider": tts_provider,
+        "stt_provider": "groq_whisper" if GROQ_API_KEY else "none",
+        "cache": {
+            "rag":    rag_cache.stats(),
+        },
+    }
+
+
+# ══════════════════════════════════════════════
+# Voice AI endpoints
+# ══════════════════════════════════════════════
+
+@lru_cache(maxsize=1)
+def _get_stt():
+    from services.voice import WhisperSTT
+    return WhisperSTT(GROQ_API_KEY)
+
+@lru_cache(maxsize=1)
+def _get_tts():
+    from services.voice import get_tts_provider
+    return get_tts_provider(google_tts_key=GOOGLE_TTS_KEY, elevenlabs_key=ELEVENLABS_KEY)
+
+
+@app.post("/api/voice/transcribe")
+async def voice_transcribe(
+    audio: UploadFile = File(...),
+    language: str = Form("ar"),
+):
+    """
+    Transcribe Arabic audio (webm/mp4/wav/ogg) → text.
+    Uses Groq Whisper large-v3.
+    """
+    data      = await audio.read()
+    mime_type = audio.content_type or "audio/webm"
+    try:
+        stt  = _get_stt()
+        text = stt.transcribe(data, mime_type=mime_type, language=language)
+        return {"text": text, "language": language}
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"Transcription failed: {e}")
+
+
+@app.post("/api/voice/synthesize")
+async def voice_synthesize(req: dict):
+    """
+    Convert Arabic text → MP3 audio bytes.
+    Body: {"text": "..."}
+    """
+    text = (req.get("text") or "").strip()
+    if not text:
+        raise HTTPException(status_code=422, detail="text field is required")
+    try:
+        tts      = _get_tts()
+        mp3_data = tts.synthesize(text)
+        return HttpResponse(content=mp3_data, media_type="audio/mpeg")
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"TTS failed: {e}")
+
+
+class VoiceChatRequest(BaseModel):
+    audio_base64:     str   = ""      # base64-encoded audio (alternative to file upload)
+    query:            str   = ""      # text query (if already transcribed client-side)
+    history:          list[dict] = []
+    analysis_context: str   = ""
+    language:         str   = "ar"
+    include_audio:    bool  = True    # return TTS audio in response
+
+
+@app.post("/api/voice/chat")
+async def voice_chat(req: VoiceChatRequest):
+    """
+    Full voice chat loop: audio → STT → LLM → TTS.
+    Returns {text: str, audio_base64: str (MP3)}.
+    """
+    import base64
+
+    # 1. Resolve input text (from audio or direct text)
+    query = req.query.strip()
+    if not query and req.audio_base64:
+        try:
+            audio_bytes = base64.b64decode(req.audio_base64)
+            stt  = _get_stt()
+            query = stt.transcribe(audio_bytes, language=req.language)
+        except Exception as e:
+            raise HTTPException(status_code=500, detail=f"STT failed: {e}")
+
+    if not query:
+        raise HTTPException(status_code=422, detail="Provide audio_base64 or query")
+
+    query = sanitize_query(query)
+
+    # 2. LLM chat
+    router = load_router()
+    emergency_resp = check_emergency(query)
+    if emergency_resp:
+        text = emergency_resp
+    else:
+        rag_ctx = ""
+        _rag_key = rag_cache_key(query)
+        rag_ctx  = rag_cache.get(_rag_key) or ""
+        if not rag_ctx:
+            try:
+                _, _, _, _, retriever = load_tools()
+                fast_results = retriever.retrieve_fast(query, k=5, top_n=3)
+                rag_ctx = build_context(fast_results, max_tokens=400)
+                if rag_ctx:
+                    rag_cache.set(_rag_key, rag_ctx, ttl=300)
+            except Exception:
+                pass
+
+        system = (
+            CHAT_SYSTEM
+            .replace("{{RAG_CONTEXT}}", rag_ctx or "لا توجد معلومات إضافية.")
+            .replace("{{ANALYSIS_CONTEXT}}", req.analysis_context or "لم يُرفع تحليل بعد.")
+        )
+        messages = [{"role": "system", "content": system}]
+        for msg in req.history[-6:]:
+            if msg.get("role") in ("user", "assistant") and msg.get("content"):
+                messages.append({"role": msg["role"], "content": msg["content"]})
+        messages.append({"role": "user", "content": query})
+
+        raw  = router.generate(messages, max_tokens=600, temperature=0.5, model_hint="chat")
+        text = filter_chat_response(raw, query)
+
+    # 3. TTS (optional)
+    audio_b64 = ""
+    if req.include_audio:
+        try:
+            tts      = _get_tts()
+            mp3      = tts.synthesize(text)
+            audio_b64 = base64.b64encode(mp3).decode()
+        except Exception as e:
+            log = logging.getLogger("tebyan")
+            log.warning("[voice/chat] TTS failed: %s", e)
+
+    return {"query": query, "text": text, "audio_base64": audio_b64}
+
+
+# ══════════════════════════════════════════════
+# Risk Prediction API
+# ══════════════════════════════════════════════
+
+class RiskRequest(BaseModel):
+    findings: list[dict]   # same format as analysis findings
+
+@lru_cache(maxsize=1)
+def _get_risk_engine():
+    from services.risk import RiskEngine
+    return RiskEngine()
+
+@app.post("/api/risk")
+async def predict_risk(req: RiskRequest):
+    """
+    Evidence-based multi-condition health risk scoring.
+    Returns scored risks for diabetes, cardiovascular, anemia, kidney, liver, thyroid.
+    ML model override when models/ directory contains trained .pkl files.
+    """
+    if not req.findings:
+        raise HTTPException(status_code=422, detail="findings list is required")
+    engine = _get_risk_engine()
+    report = engine.assess(req.findings)
+    return {
+        "risks": [
+            {
+                "condition":      r.condition,
+                "score":          r.score,
+                "level":          r.level,
+                "confidence":     r.confidence,
+                "label_ar":       r.label_ar,
+                "factors":        r.factors,
+                "recommendation": r.recommendation,
+                "source":         r.source,
+            }
+            for r in report.risks
+        ],
+        "top_risk":   {
+            "condition": report.top_risk.condition,
+            "score":     report.top_risk.score,
+            "level":     report.top_risk.level,
+            "label_ar":  report.top_risk.label_ar,
+        } if report.top_risk else None,
+        "overall_ar":     report.overall_ar,
+        "features_used":  report.features_used,
+    }
+
+
+# ══════════════════════════════════════════════
+# Compare Summary — Groq-generated analysis of two lab results
+# ══════════════════════════════════════════════
+
+class CompareSummaryRequest(BaseModel):
+    findings_a:  list[dict]
+    findings_b:  list[dict]
+    summary_a:   str = ""
+    summary_b:   str = ""
+    date_a:      str = ""
+    date_b:      str = ""
+
+@app.post("/api/compare/summary")
+async def compare_summary(req: CompareSummaryRequest):
+    router = load_router()
+
+    def fmt_findings(findings: list[dict]) -> str:
+        lines = []
+        for f in findings:
+            status_ar = {"high": "مرتفع", "low": "منخفض", "normal": "طبيعي"}.get(f.get("status", ""), "")
+            lines.append(f"  {f.get('name','')}: {f.get('value','')} {f.get('unit','')} [{status_ar}]")
+        return "\n".join(lines) if lines else "لا توجد بيانات"
+
+    prompt = f"""أنت طبيب متخصص. قارن بين نتيجتين لتحاليل مخبرية لنفس المريض.
+
+التحليل الأول ({req.date_a or 'السابق'}):
+{fmt_findings(req.findings_a)}
+
+التحليل الثاني ({req.date_b or 'الحالي'}):
+{fmt_findings(req.findings_b)}
+
+اكتب ملخصاً طبياً دقيقاً بالعربية في 3-4 جمل يشمل:
+1. أبرز التغيرات (تحسّن / تراجع / ثبات)
+2. هل الاتجاه العام إيجابي أم يستدعي قلقاً
+3. توصية واحدة محددة
+
+أجب مباشرة بالنص فقط، بدون عناوين أو نقاط."""
+
+    try:
+        summary = router.generate(
+            [{"role": "user", "content": prompt}],
+            max_tokens=300, temperature=0.2, model_hint="analysis",
+        ).strip()
+    except Exception as e:
+        summary = "تعذّر توليد الملخص المقارن."
+        log.error("compare: Groq error: %s", e)
+
+    return {"summary": summary}
+
+# build:1779660596

backend/{ingest_full.py → medical_data.py}

@@ -1,64 +1,41 @@
 """
-بناء الموسوعة الطبية الكاملة:
-1. تنظيف التكرار من ChromaDB
-2. تعاريف التحاليل (عربي + إنجليزي)
-3. معلومات شاملة عن التحاليل
-4. توصيات صحية
-5. معلومات طبية عامة من MedlinePlus
+بيانات طبية مركزية — تستخدمها سكريبتات الاستيراد والـ API
 """
-import os
-import re
-import time
-import requests
-import xml.etree.ElementTree as ET
 
-os.environ['HF_HOME'] = r'D:\Project\model_cache'
-os.environ['TRANSFORMERS_VERBOSITY'] = 'error'
-
-from langchain_huggingface import HuggingFaceEmbeddings
-from langchain_chroma import Chroma
-from langchain_core.documents import Document
-
-DB_PATH = r'D:\Project\chroma_db'
-EMBEDDINGS_MODEL = "intfloat/multilingual-e5-large"
-
-# ============================================================
-# القسم 1: تعاريف التحاليل (عربي + إنجليزي)
-# ============================================================
 LAB_DEFINITIONS = [
     {
         "name_ar": "هيموجلوبين", "name_en": "Hemoglobin (HGB)",
-        "definition": "بروتين في خلايا الدم الحمراء يحمل الأكسجين من الرئتين لأنسجة الجسم. القيم الطبيعية: رجال 13.5-17.5 g/dL، نساء 12-15.5 g/dL.",
-        "high": "كثرة الحمر، الجفاف، أمراض الرئة المزمنة، ارتفاع الألتيتيود.",
-        "low": "فقر الدم (الأنيميا)، نزيف داخلي، نقص الحديد أو فيتامين B12 أو حمض الفوليك.",
+        "definition": "بروتين في خلايا الدم الحمراء يحمل الأكسجين. القيم الطبيعية: رجال 13.5-17.5 g/dL، نساء 12-15.5 g/dL.",
+        "high": "كثرة الحمر، الجفاف، أمراض الرئة المزمنة.",
+        "low": "فقر الدم، نزيف داخلي، نقص الحديد أو فيتامين B12 أو حمض الفوليك.",
         "symptoms_low": "تعب، شحوب، ضيق تنفس، دوخة، خفقان قلب.",
     },
     {
         "name_ar": "خلايا الدم الحمراء", "name_en": "Red Blood Cells (RBC)",
-        "definition": "عدد خلايا الدم الحمراء في الدم. القيم الطبيعية: رجال 4.5-5.9 مليون/µL، نساء 4.1-5.1 مليون/µL.",
+        "definition": "عدد خلايا الدم الحمراء. القيم الطبيعية: رجال 4.5-5.9 مليون/µL، نساء 4.1-5.1 مليون/µL.",
         "high": "كثرة الحمر، الجفاف، أمراض القلب الخلقية.",
         "low": "فقر الدم، نزيف، فشل كلوي، نقص غذائي.",
         "symptoms_low": "إرهاق، شحوب، ضعف عام.",
     },
     {
         "name_ar": "خلايا الدم البيضاء", "name_en": "White Blood Cells (WBC)",
-        "definition": "خلايا الجهاز المناعي التي تحارب العدوى. القيم الطبيعية: 4,000-11,000 خلية/µL.",
+        "definition": "خلايا الجهاز المناعي. القيم الطبيعية: 4,000-11,000 خلية/µL.",
         "high": "عدوى بكتيرية، التهاب، أمراض الدم كاللوكيميا.",
         "low": "أمراض المناعة، العلاج الكيميائي، أمراض النخاع العظمي.",
         "symptoms_low": "تكرار الإصابة بالعدوى، حمى متكررة.",
     },
     {
         "name_ar": "الصفائح الدموية", "name_en": "Platelets (PLT)",
-        "definition": "خلايا مسؤولة عن تخثر الدم وإيقاف النزيف. القيم الطبيعية: 150,000-400,000/µL.",
+        "definition": "خلايا مسؤولة عن تخثر الدم. القيم الطبيعية: 150,000-400,000/µL.",
         "high": "التهاب، نزيف، نقص الحديد، خطر تجلط الدم.",
         "low": "نزيف تلقائي، أمراض الكبد، الذئبة، العلاج الكيميائي.",
         "symptoms_low": "كدمات سهلة، نزيف اللثة، نزيف طويل عند الجرح.",
     },
     {
         "name_ar": "سكر الدم الصائم", "name_en": "Fasting Blood Glucose",
-        "definition": "مستوى السكر في الدم بعد 8 ساعات صيام. القيم الطبيعية: 70-100 mg/dL. مرحلة ما قبل السكري: 100-125. سكري: 126 فما فوق.",
+        "definition": "مستوى السكر بعد 8 ساعات صيام. طبيعي: 70-100 mg/dL. ما قبل السكري: 100-125. سكري: 126 فأكثر.",
         "high": "السكري، مقاومة الأنسولين، الإجهاد، بعض الأدوية.",
-        "low": "انخفاض السكر (نقص سكر الدم)، الصيام الطويل، جرعة زائدة من الأنسولين.",
+        "low": "نقص سكر الدم، الصيام الطويل، جرعة زائدة من الأنسولين.",
         "symptoms_low": "رعشة، تعرق، دوخة، فقدان وعي في الحالات الشديدة.",
     },
     {
@@ -73,18 +50,18 @@ LAB_DEFINITIONS = [
         "definition": "إجمالي الدهون في الدم. المثالي: أقل من 200 mg/dL. حدي: 200-239. مرتفع: 240 فأكثر.",
         "high": "خطر أمراض القلب والشرايين، السكتة الدماغية.",
         "low": "نادر، قد يرتبط بسوء التغذية أو مشاكل الكبد.",
-        "symptoms_low": "الكوليسترول المرتفع لا يسبب أعراضاً واضحة.",
+        "symptoms_low": "الكوليسترول المرتفع لا يسبب أعراضاً واضحة غالباً.",
     },
     {
-        "name_ar": "الكوليسترول الضار", "name_en": "LDL Cholesterol (Bad Cholesterol)",
-        "definition": "الكوليسترول منخفض الكثافة - يترسب في الشرايين. المثالي: أقل من 100 mg/dL. مرتفع: 160 فأكثر.",
+        "name_ar": "الكوليسترول الضار", "name_en": "LDL Cholesterol",
+        "definition": "الكوليسترول منخفض الكثافة، يترسب في الشرايين. المثالي: أقل من 100 mg/dL. مرتفع: 160 فأكثر.",
         "high": "تصلب الشرايين، أمراض القلب، جلطات.",
         "low": "مثالي، يقلل خطر أمراض القلب.",
-        "symptoms_low": "لا أعراض.",
+        "symptoms_low": "لا أعراض مباشرة.",
     },
     {
-        "name_ar": "الكوليسترول النافع", "name_en": "HDL Cholesterol (Good Cholesterol)",
-        "definition": "الكوليسترول عالي الكثافة - يزيل الكوليسترول من الشرايين. المثالي: فوق 60 mg/dL. منخفض (خطر): أقل من 40 للرجال، 50 للنساء.",
+        "name_ar": "الكوليسترول النافع", "name_en": "HDL Cholesterol",
+        "definition": "الكوليسترول عالي الكثافة، يزيل الكوليسترول من الشرايين. المثالي: فوق 60 mg/dL. منخفض: أقل من 40 للرجال، 50 للنساء.",
         "high": "حماية من أمراض القلب.",
         "low": "خطر أمراض القلب، قلة الرياضة، التدخين، السمنة.",
         "symptoms_low": "لا أعراض مباشرة لكن خطر قلبي مرتفع.",
@@ -97,7 +74,7 @@ LAB_DEFINITIONS = [
         "symptoms_low": "الارتفاع الشديد يسبب التهاب البنكرياس.",
     },
     {
-        "name_ar": "هرمون الغدة الدرقية TSH", "name_en": "Thyroid Stimulating Hormone (TSH)",
+        "name_ar": "هرمون الغدة الدرقية", "name_en": "TSH (Thyroid Stimulating Hormone)",
         "definition": "يتحكم في نشاط الغدة الدرقية. القيم الطبيعية: 0.4-4.0 mIU/L.",
         "high": "قصور الغدة الدرقية (الغدة خاملة).",
         "low": "فرط نشاط الغدة الدرقية.",
@@ -136,7 +113,7 @@ LAB_DEFINITIONS = [
         "definition": "ناتج تكسير البيورينات. طبيعي: رجال 3.5-7.2 mg/dL، نساء 2.6-6.0 mg/dL.",
         "high": "النقرس، الفشل الكلوي، أكل كثير من اللحوم، السمنة.",
         "low": "نادر، قد يكون من بعض الأدوية.",
-        "symptoms_low": "الارتفاع يسبب: ألم حاد في المفاصل (خاصة إصبع القدم الكبير)، حصوات كلى.",
+        "symptoms_low": "الارتفاع يسبب: ألم حاد في المفاصل (خاصة إصبع القدم)، حصوات كلى.",
     },
     {
         "name_ar": "الكرياتينين", "name_en": "Creatinine",
@@ -146,7 +123,7 @@ LAB_DEFINITIONS = [
         "symptoms_low": "ارتفاع الكرياتينين: تورم، تعب، غثيان، قلة التبول.",
     },
     {
-        "name_ar": "إنزيمات الكبد ALT AST", "name_en": "Liver Enzymes (ALT/AST)",
+        "name_ar": "إنزيمات الكبد", "name_en": "Liver Enzymes (ALT/AST)",
         "definition": "مؤشرات لصحة الكبد. ALT طبيعي: 7-56 U/L. AST طبيعي: 10-40 U/L.",
         "high": "التهاب الكبد، الكبد الدهني، الكحول، بعض الأدوية.",
         "low": "لا أهمية سريرية.",
@@ -160,7 +137,7 @@ LAB_DEFINITIONS = [
         "symptoms_low": "الارتفاع يرافقه أعراض المرض الأصلي.",
     },
     {
-        "name_ar": "الحمضات (الإيوزينوفيل)", "name_en": "Eosinophils",
+        "name_ar": "الحمضات", "name_en": "Eosinophils",
         "definition": "نوع من خلايا الدم البيضاء. طبيعي: 1-4% من WBC أو 100-400 خلية/µL.",
         "high": "الحساسية، الربو، الطفيليات، بعض الأمراض المناعية.",
         "low": "ليس ذا أهمية سريرية.",
@@ -188,7 +165,7 @@ LAB_DEFINITIONS = [
         "symptoms_low": "الارتفاع: سمنة بطنية، ضغط مرتفع، سكر. الانخفاض: إجهاد، غثيان، انخفاض ضغط.",
     },
     {
-        "name_ar": "هرمون الإنسولين", "name_en": "Insulin (Fasting)",
+        "name_ar": "هرمون الإنسولين الصائم", "name_en": "Insulin (Fasting)",
         "definition": "هرمون يتحكم في السكر. طبيعي صائم: 2-25 µIU/mL.",
         "high": "مقاومة الأنسولين، السمنة، ما قبل السكري، ورم الأنسولين.",
         "low": "السكري النوع الأول، البنكرياس الضعيف.",
@@ -204,13 +181,13 @@ LAB_DEFINITIONS = [
     {
         "name_ar": "هرمون البرولاكتين", "name_en": "Prolactin",
         "definition": "هرمون الحليب من الغدة النخامية. طبيعي: رجال 2-18 ng/mL، نساء غير حامل 2-29 ng/mL.",
-        "high": "ورم النخامية (البرولاكتينوما)، بعض الأدوية، قصور الغدة الدرقية.",
+        "high": "ورم النخامية، بعض الأدوية، قصور الغدة الدرقية.",
         "low": "نادر، قد يكون من قصور النخامية.",
         "symptoms_low": "الارتفاع: إفراز حليب، اضطراب دورة، ضعف جنسي.",
     },
     {
         "name_ar": "هرمون الإستروجين", "name_en": "Estradiol (E2)",
-        "definition": "الهرمون الأنثوي الرئيسي. يتغير حسب مرحلة الدورة.",
+        "definition": "الهرمون الأنثوي الرئيسي. يتغير حسب مرحلة الدورة والحمل.",
         "high": "أورام المبيض، السمنة، أمراض الكبد.",
         "low": "انقطاع الطمث، قصور المبيض، سوء التغذية.",
         "symptoms_low": "الانخفاض: جفاف مهبلي، هشاشة عظام، اضطراب مزاج، هبات حرارة.",
@@ -232,7 +209,7 @@ LAB_DEFINITIONS = [
     {
         "name_ar": "تحليل البول الكامل", "name_en": "Urinalysis (Complete)",
         "definition": "فحص البول للكشف عن أمراض الكلى والمسالك البولية والسكري.",
-        "high": "بروتين في البول: مشكلة كلى. سكر في البول: سكري. دم في البول: التهاب أو حصوات.",
+        "high": "بروتين: مشكلة كلى. سكر: سكري. دم: التهاب أو حصوات.",
         "low": "بول طبيعي: شفاف، أصفر فاتح، بدون بروتين أو سكر أو دم.",
         "symptoms_low": "البول الغائم أو الداكن أو ذو رائحة شديدة يستوجب فحصاً.",
     },
@@ -241,7 +218,7 @@ LAB_DEFINITIONS = [
         "definition": "أفضل مقياس لوظيفة الكلى. طبيعي: فوق 90 mL/min. مرحلة الفشل: أقل من 15.",
         "high": "غير ذي أهمية عند الارتفاع.",
         "low": "مرض كلوي مزمن بدرجات متفاوتة.",
-        "symptoms_low": "GFR 30-59: مرحلة متوسطة. GFR 15-29: مرحلة متقدمة. أقل من 15: فشل كلوي.",
+        "symptoms_low": "GFR 30-59: مرحلة متوسطة. GFR 15-29: متقدمة. أقل من 15: فشل كلوي.",
     },
     {
         "name_ar": "حمض الفوليك", "name_en": "Folic Acid (Folate)",
@@ -292,7 +269,6 @@ LAB_DEFINITIONS = [
         "low": "سوء التغذية، أمراض الكبد والكلى.",
         "symptoms_low": "ضعف، تورم، ضعف مناعة.",
     },
-    # CBC إضافي
     {
         "name_ar": "الهيماتوكريت", "name_en": "Hematocrit (HCT)",
         "definition": "نسبة حجم كريات الدم الحمراء من إجمالي الدم. طبيعي: رجال 38.3-48.6%، نساء 35.5-44.9%.",
@@ -301,7 +277,7 @@ LAB_DEFINITIONS = [
         "symptoms_low": "تعب، ضيق تنفس، شحوب.",
     },
     {
-        "name_ar": "متوسط حجم الكرية الحمراء", "name_en": "Mean Corpuscular Volume (MCV)",
+        "name_ar": "متوسط حجم الكرية الحمراء", "name_en": "MCV (Mean Corpuscular Volume)",
         "definition": "متوسط حجم كريات الدم الحمراء. طبيعي: 80-100 fL. يساعد في تصنيف نوع فقر الدم.",
         "high": "فقر الدم الضخم الكريات (نقص B12 أو فولات)، الكحول، قصور الدرقية.",
         "low": "فقر الدم الصغير الكريات (نقص حديد، ثلاسيميا).",
@@ -315,7 +291,7 @@ LAB_DEFINITIONS = [
         "symptoms_low": "يُفسر مع MCV وهيموجلوبين لتصنيف فقر الدم.",
     },
     {
-        "name_ar": "تركيز الهيموجلوبين في الكرية", "name_en": "MCHC (Mean Corpuscular Hemoglobin Concentration)",
+        "name_ar": "تركيز الهيموجلوبين في الكرية", "name_en": "MCHC",
         "definition": "تركيز الهي��وجلوبين في كل كرية. طبيعي: 31.5-36 g/dL.",
         "high": "فقر الدم الانحلالي الوراثي، الجفاف.",
         "low": "نقص الحديد، الثلاسيميا.",
@@ -330,7 +306,7 @@ LAB_DEFINITIONS = [
     },
     {
         "name_ar": "العدلات", "name_en": "Neutrophils",
-        "definition": "أكثر خلايا الدم البيضاء شيوعاً. الخط الأول ضد البكتيريا. طبيعي: 40-70% من WBC أو 1800-7800/µL.",
+        "definition": "أكثر خلايا الدم البيضاء شيوعاً. طبيعي: 40-70% من WBC أو 1800-7800/µL.",
         "high": "عدوى بكتيرية، التهاب، توتر، كورتيكوستيرويدات.",
         "low": "عدوى فيروسية شديدة، أدوية، أمراض نخاع العظم.",
         "symptoms_low": "خطر عالٍ للعدوى البكتيرية عند الانخفاض الشديد.",
@@ -338,8 +314,8 @@ LAB_DEFINITIONS = [
     {
         "name_ar": "الخلايا اللمفاوية", "name_en": "Lymphocytes",
         "definition": "تنتج الأجسام المضادة وتحارب الفيروسات. طبيعي: 20-40% من WBC.",
-        "high": "عدوى فيروسية (كورونا، مونو)، ابيضاض اللمفاوية.",
-        "low": "HIV، الكورتيكوستيرويدات، العلاج الإشعاعي، التوتر الشديد.",
+        "high": "عدوى فيروسية، ابيضاض اللمفاوية.",
+        "low": "HIV، الكورتيكوستيرويدات، العلاج الإشعاعي.",
         "symptoms_low": "ضعف المناعة ضد الفيروسات.",
     },
     {
@@ -356,10 +332,9 @@ LAB_DEFINITIONS = [
         "low": "نادراً ما له أهمية سريرية.",
         "symptoms_low": "الارتفاع الشديد قد يكون علامة ابيضاض دموي.",
     },
-    # سكر إضافي
     {
         "name_ar": "السكر العشوائي", "name_en": "Random Blood Sugar (RBS)",
-        "definition": "قياس السكر في أي وقت بغض النظر عن الأكل. الطبيعي: أقل من 140 mg/dL. مقلق: 140-199. سكري: 200 فأكثر مع أعراض.",
+        "definition": "قياس السكر في أي وقت. الطبيعي: أقل من 140 mg/dL. مقلق: 140-199. سكري: 200 فأكثر مع أعراض.",
         "high": "مرض السكري، الإجهاد، بعض الأدوية.",
         "low": "نقص سكر الدم، جرعة أنسولين زائدة.",
         "symptoms_low": "الارتفاع مع أعراض (عطش، كثرة تبول) يؤكد السكري.",
@@ -369,7 +344,7 @@ LAB_DEFINITIONS = [
         "definition": "يشرب المريض 75 غرام جلوكوز ويُقاس السكر بعد ساعتين. طبيعي: أقل من 140. ما قبل السكري: 140-199. سكري: 200+.",
         "high": "سكري، مقاومة أنسولين، سكري الحمل.",
         "low": "لا أهمية سريرية للانخفاض.",
-        "symptoms_low": "أفضل اختبار للكشف المبكر عن السكري.",
+        "symptoms_low": "أفضل اختبار للكشف المبكر عن السكري وسكري الحمل.",
     },
     {
         "name_ar": "سي ببتيد", "name_en": "C-Peptide",
@@ -378,7 +353,6 @@ LAB_DEFINITIONS = [
         "low": "السكري النوع الأول، البنكرياس الضعيف.",
         "symptoms_low": "C-Peptide منخفض = البنكرياس لا ينتج أنسولين = يحتاج أنسولين خارجي.",
     },
-    # كوليسترول إضافي
     {
         "name_ar": "الكوليسترول منخفض الكثافة جداً", "name_en": "VLDL Cholesterol",
         "definition": "يحمل الدهون الثلاثية للأنسجة. يُحسب: VLDL = Triglycerides ÷ 5. طبيعي: 2-30 mg/dL.",
@@ -386,25 +360,23 @@ LAB_DEFINITIONS = [
         "low": "لا أهمية سريرية.",
         "symptoms_low": "ارتفاعه يزيد خطر أمراض القلب.",
     },
-    # كبد إضافي
     {
         "name_ar": "جاما جلوتاميل ترانسفيريز", "name_en": "GGT (Gamma-Glutamyl Transferase)",
         "definition": "إنزيم كبدي حساس للكحول والأدوية. طبيعي: رجال 8-61 U/L، نساء 5-36 U/L.",
         "high": "الكحول، أمراض الكبد، بعض الأدوية، الكبد الدهني.",
         "low": "لا أهمية سريرية.",
-        "symptoms_low": "أحساس مؤشر مبكر لتأثير الكحول على الكبد.",
+        "symptoms_low": "مؤشر مبكر لتأثير الكحول على الكبد.",
     },
     {
         "name_ar": "البيليروبين المباشر", "name_en": "Direct (Conjugated) Bilirubin",
-        "definition": "البيليروبين المرتبط المعالج بالكبد. طبيعي: 0-0.3 mg/dL.",
+        "definition": "البيليروبين المعالج بالكبد. طبيعي: 0-0.3 mg/dL.",
         "high": "انسداد القنوات الصفراوية، التهاب الكبد، حصوات المرارة.",
         "low": "لا أهمية سريرية.",
         "symptoms_low": "ارتفاعه مع اليرقان يشير لمشكلة في تصريف الصفراء.",
     },
-    # كلى إضافي
     {
-        "name_ar": "اليوريا في الدم", "name_en": "Blood Urea Nitrogen (BUN) / Urea",
-        "definition": "ناتج تكسير البروتين، يُطرح بالكلى. BUN طبيعي: 7-20 mg/dL. يوريا: 2.5-7.1 mmol/L.",
+        "name_ar": "اليوريا في الدم", "name_en": "BUN / Blood Urea Nitrogen",
+        "definition": "ناتج تكسير البروتين. BUN طبيعي: 7-20 mg/dL. يوريا: 2.5-7.1 mmol/L.",
         "high": "ضعف الكلى، الجفاف، نزيف الجهاز الهضمي، أكل بروتين زائد.",
         "low": "أمراض الكبد الشديدة، سوء التغذية.",
         "symptoms_low": "نسبة BUN/Creatinine تحدد سبب ارتفاع البول النيتروجيني.",
@@ -416,23 +388,22 @@ LAB_DEFINITIONS = [
         "low": "القيء المتكرر، القصور الكلوي، الأدوية.",
         "symptoms_low": "يُفسر دائماً مع الصوديوم والبوتاسيوم.",
     },
-    # هرمونات إضافية
     {
-        "name_ar": "هرمون T3 الكلي والحر", "name_en": "T3 Total & Free T3",
+        "name_ar": "هرمون T3 الحر", "name_en": "Free T3 (Triiodothyronine)",
         "definition": "الهرمون الدرقي النشط. Free T3 طبيعي: 2.3-4.2 pg/mL.",
         "high": "فرط نشاط الدرقية، التهاب الدرقية.",
         "low": "قصور الدرقية، الأمراض الحادة.",
         "symptoms_low": "Free T3 أدق من T3 الكلي في تقييم وظيفة الدرقية.",
     },
     {
-        "name_ar": "هرمون T4 الكلي والحر", "name_en": "T4 Total & Free T4",
+        "name_ar": "هرمون T4 الحر", "name_en": "Free T4 (Thyroxine)",
         "definition": "الهرمون الدرقي الرئيسي المخزون. Free T4 طبيعي: 0.8-1.8 ng/dL.",
         "high": "فرط نشاط الدرقية.",
         "low": "قصور الدرقية.",
         "symptoms_low": "يُقاس مع TSH لتقييم الغدة الدرقية بشكل كامل.",
     },
     {
-        "name_ar": "الأجسام المضادة للغدة الدرقية", "name_en": "Anti-TPO (Thyroid Peroxidase Antibodies)",
+        "name_ar": "الأجسام المضادة للغدة الدرقية", "name_en": "Anti-TPO Antibodies",
         "definition": "أجسام مضادة تهاجم الغدة الدرقية. طبيعي: أقل من 34 IU/mL.",
         "high": "التهاب الغدة الدرقية هاشيموتو، داء غريفز.",
         "low": "طبيعي.",
@@ -455,18 +426,17 @@ LAB_DEFINITIONS = [
     {
         "name_ar": "الهرمون المنبه للجريب", "name_en": "FSH (Follicle Stimulating Hormone)",
         "definition": "يحفز نضج البويضات والحيوانات المنوية.",
-        "high": "انقطاع الطمث، قصور المبيض أو الخصية، انتهاء مخزون المبيض.",
+        "high": "انقطاع الطمث، قصور المبيض أو الخصية.",
         "low": "قصور الغدة النخامية.",
         "symptoms_low": "FSH مرتفع يعني احتياطي المبيض منخفض.",
     },
     {
         "name_ar": "ديهيدرو إيبي أندروستيرون", "name_en": "DHEA-S",
-        "definition": "هرمون من الغدة الكظرية، سلف للهرمونات الجنسية. طبيعي: يختلف بالعمر والجنس.",
+        "definition": "هرمون من الغدة الكظرية، سلف للهرمونات الجنسية. القيم تختلف بالعمر والجنس.",
         "high": "أورام الكظرية، تكيس المبايض.",
         "low": "قصور الكظرية، الشيخوخة.",
         "symptoms_low": "الارتفاع عند النساء يسبب شعر زائد وحب شباب.",
     },
-    # معادن إضافية
     {
         "name_ar": "النحاس", "name_en": "Copper (Serum)",
         "definition": "معدن ضروري لإنزيمات عدة. طبيعي: 70-140 µg/dL.",
@@ -481,7 +451,6 @@ LAB_DEFINITIONS = [
         "low": "سوء التغذية، أمراض الأمعاء.",
         "symptoms_low": "ضعف مناعة، ضعف عضلي، اضطراب درقي.",
     },
-    # قلب إضافي
     {
         "name_ar": "إنزيم القلب CK-MB", "name_en": "CK-MB (Creatine Kinase-MB)",
         "definition": "إنزيم من عضلة القلب. يرتفع عند تلف القلب. طبيعي: أقل من 5% من CK الكلي.",
@@ -490,7 +459,7 @@ LAB_DEFINITIONS = [
         "symptoms_low": "يستخدم مع التروبونين لتأكيد النوبة القلبية.",
     },
     {
-        "name_ar": "هرمون الببتيد الد��اغي الناتريوريتيك", "name_en": "BNP / NT-proBNP",
+        "name_ar": "هرمون BNP القلبي", "name_en": "BNP / NT-proBNP",
         "definition": "مؤشر فشل القلب. BNP طبيعي: أقل من 100 pg/mL.",
         "high": "فشل القلب الاحتقاني، ارتفاع ضغط الدم الرئوي.",
         "low": "طبيعي.",
@@ -500,10 +469,9 @@ LAB_DEFINITIONS = [
         "name_ar": "دي دايمر", "name_en": "D-Dimer",
         "definition": "ناتج تكسير الجلطات. طبيعي: أقل من 500 ng/mL.",
         "high": "جلطة وريدية، جلطة رئوية، التهاب شديد، حمل، سرطان.",
-        "low": "طبيعي - يستبعد الجلطة.",
+        "low": "طبيعي — يستبعد الجلطة.",
         "symptoms_low": "ارتفاعه مع أعراض الجلطة يستدعي تصوير طارئ.",
     },
-    # مناعة إضافية
     {
         "name_ar": "الأجسام المضادة للنواة", "name_en": "ANA (Anti-Nuclear Antibodies)",
         "definition": "أجسام مضادة للخلايا، مؤشر الأمراض المناعية الذاتية.",
@@ -525,9 +493,8 @@ LAB_DEFINITIONS = [
         "low": "عدوى فيروسية أو لا عدوى.",
         "symptoms_low": "يساعد على قرار إعطاء المضادات الحيوية من عدمه.",
     },
-    # تخثر إضافي
     {
-        "name_ar": "زمن الثرومبوبلاستين الجزئي", "name_en": "aPTT (Activated Partial Thromboplastin Time)",
+        "name_ar": "زمن الثرومبوبلاستين الجزئي", "name_en": "aPTT",
         "definition": "يقيس مسار التخثر الداخلي. طبيعي: 25-35 ثانية.",
         "high": "نقص عوامل التخثر، الهيبارين، الهيموفيليا.",
         "low": "خطر تجلط.",
@@ -540,7 +507,6 @@ LAB_DEFINITIONS = [
         "low": "أمراض الكبد، استهلاك الفيبرينوجين في الجلطات.",
         "symptoms_low": "الانخفاض الشديد يسبب نزيفاً خطيراً.",
     },
-    # بول إضافي
     {
         "name_ar": "بروتين البول", "name_en": "Urine Protein / Microalbuminuria",
         "definition": "وجود بروتين في البول. طبيعي: أقل من 150 mg/يوم. بروتين دقيق: 30-300 mg/يوم.",
@@ -562,7 +528,6 @@ LAB_DEFINITIONS = [
         "low": "شرب ماء زائد، مرض السكري الكاذب، فشل كلوي.",
         "symptoms_low": "يعكس قدرة الكلى على تركيز البول.",
     },
-    # براز
     {
         "name_ar": "تحليل البراز الكامل", "name_en": "Stool Analysis (Ova & Parasites)",
         "definition": "فحص البراز بحثاً عن طفيليات، بكتيريا، دم، خلايا.",
@@ -571,7 +536,7 @@ LAB_DEFINITIONS = [
         "symptoms_low": "عند إسهال مزمن، ألم بطن، فقدان وزن غير مبرر.",
     },
     {
-        "name_ar": "الدم الخفي في البراز", "name_en": "Fecal Occult Blood Test (FOBT)",
+        "name_ar": "الدم الخفي في البراز", "name_en": "FOBT (Fecal Occult Blood Test)",
         "definition": "يكشف الدم غير المرئي في البراز. طبيعي: سلبي.",
         "high": "قرحة معدية، نزيف معوي، سرطان القولون، بواسير.",
         "low": "سلبي = لا نزيف ظاهر.",
@@ -584,12 +549,11 @@ LAB_DEFINITIONS = [
         "low": "سلبي = لا عدوى.",
         "symptoms_low": "أفضل من فحص الدم لأنه يكشف العدوى الحالية.",
     },
-    # فيروسات
     {
         "name_ar": "التهاب الكبد B", "name_en": "Hepatitis B Surface Antigen (HBsAg)",
         "definition": "يكشف عدوى التهاب الكبد B. طبيعي: سلبي.",
         "high": "إيجابي = عدوى نشطة بالتهاب الكبد B.",
-        "low": "سلبي = لا عدوى. إيجابي HBsAb = محصّن (بلقاح أو شُفي).",
+        "low": "سلبي = لا عدوى. إيجابي HBsAb = محصّن بلقاح أو شُفي.",
         "symptoms_low": "التهاب الكبد B قد يكون صامتاً لسنوات ثم يتطور لتليف.",
     },
     {
@@ -606,10 +570,9 @@ LAB_DEFINITIONS = [
         "low": "سلبي = لا عدوى.",
         "symptoms_low": "الكشف المبكر والعلاج يجعل مرضى HIV يعيشون حياة طبيعية.",
     },
-    # حمل وخصوبة
     {
-        "name_ar": "هرمون الحمل البيتا", "name_en": "Beta hCG (Human Chorionic Gonadotropin)",
-        "definition": "هرمون الحمل. يضاعف كل 48-72 ساعة في الحمل الطبيعي. فوق 25 mIU/mL = حمل.",
+        "name_ar": "هرمون الحمل بيتا", "name_en": "Beta hCG",
+        "definition": "هرمون الحمل. فوق 25 mIU/mL = حمل. يضاعف كل 48-72 ساعة في الحمل الطبيعي.",
         "high": "حمل، حمل خارج رحم، ورم الحمل.",
         "low": "لا حمل، أو خطر إجهاض.",
         "symptoms_low": "ارتفاع بطيء أو انخفاض يستدعي تقييم الحمل الخارج رحمي.",
@@ -647,17 +610,28 @@ LAB_DEFINITIONS = [
         "definition": "معدن حيوي لعمل القلب والعضلات. طبيعي: 3.5-5.0 mEq/L.",
         "high": "فشل كلوي، مدرات بول حافظة للبوتاسيوم، تلف أنسجة.",
         "low": "إسهال، قيء، مدرات البول، نقص تغذية.",
-        "symptoms_low": "الانخفاض: ضعف عضلي، تشنج، عدم انتظام القلب. الارتفاع: عدم انتظام قلب خطير.",
+        "symptoms_low": "الانخفاض: ضعف عضلي، تشنج، عدم انتظام القلب.",
+    },
+    {
+        "name_ar": "الكالسيوم", "name_en": "Calcium (Total)",
+        "definition": "معدن أساسي للعظام والأعصاب والعضلات. طبيعي: 8.5-10.5 mg/dL.",
+        "high": "فرط نشاط الغدة الدريقية، السرطان، الجفاف.",
+        "low": "قصور الغدة الدريقية، نقص فيتامين D، الفشل الكلوي.",
+        "symptoms_low": "الانخفاض: تشنجات عضلية، تنميل، اختلاجات. الارتفاع: تعب، كثرة تبول، حصوات كلى.",
+    },
+    {
+        "name_ar": "مؤشر PSA لسرطان البروستات", "name_en": "PSA (Prostate-Specific Antigen)",
+        "definition": "بروتين تنتجه البروستات. طبيعي: أقل من 4 ng/mL (يرتفع مع العمر).",
+        "high": "تضخم البروستات الحميد، التهاب البروستات، سرطان البروستات.",
+        "low": "لا أهمية سريرية.",
+        "symptoms_low": "PSA المرتفع لا يعني بالضرورة السرطان، يحتاج تقييماً إضافياً.",
     },
 ]
 
-# ============================================================
-# القسم 2: التوصيات الصحية
-# ============================================================
 HEALTH_RECOMMENDATIONS = [
     {
         "topic": "فقر الدم والأنيميا",
-        "content": """نصائح لمرضى فقر الدم (الأنيميا):
+        "content": """نصائح لمرضى فقر الدم:
 الغذاء: تناول الأطعمة الغنية بالحديد: اللحوم الحمراء، الكبدة، السبانخ، العدس، الفاصوليا، الحبوب المدعمة.
 تناول فيتامين C مع وجبات الحديد لتعزيز الامتصاص (برتقال، فلفل).
 تجنب القهوة والشاي مع وجبات الحديد.
@@ -690,7 +664,6 @@ HEALTH_RECOMMENDATIONS = [
 الغذاء DASH: خضروات، فواكه، حليب قليل الدسم، قلل اللحوم الحمراء.
 الوزن: خسارة 5 كغ تخفض الضغط 5-10 mmHg.
 الرياضة: 30 دقيقة يومياً تخفض الضغط 5-8 mmHg.
-الكافيين والكحول: قللهما.
 الإجهاد: تأمل، يوغا، تنفس عميق.
 المتابعة: قياس الضغط يومياً في المنزل.""",
     },
@@ -710,652 +683,45 @@ HEALTH_RECOMMENDATIONS = [
 النوم: 7-9 ساعات، نظام نوم ثابت، تجنب الشاشات قبل النوم.
 الغذاء: وجبات منتظمة، قلل السكر المكرر، أكثر من البروتين.
 الرياضة: مشي 20 دقيقة يومياً يزيد الطاقة بشكل مثبت علمياً.
-الإجهاد: تقنيات الاسترخاء، تحديد الأولويات، طلب المساعدة.
 الترطيب: قلة الماء وحدها تسبب التعب، اشرب 8 أكواب يومياً.""",
     },
     {
         "topic": "صحة الغدة الدرقية",
         "content": """نصائح للعناية بالغدة الدرقية:
-اليود: ضروري لعمل الغدة (ملح معالج باليود، أسماك بحرية).
-السيلينيوم: يدعم الغدة (مكسرات البرازيل، التونة).
-تجنب: كميات كبيرة من الكرنب والقرنبيط النيء عند مرضى الغدة.
-الدواء: ليفوثيروكسين يُؤخذ صائماً قبل الأكل بـ 30 دقيقة.
-المتابعة: TSH كل 6-12 شهراً.
-الحمل: TSH يجب أن يكون أقل من 2.5 خلال الحمل.""",
+اليود: ضروري لعمل الغدة (ملح معالج باليود، أسماك بحرية، أعشاب بحرية).
+السيلينيوم: يدعم تحويل T4 إلى T3 (مكسرات برازيلية، سمك التونا).
+قصور الدرقية: أدوية الليفوثيروكسين تُؤخذ على معدة فارغة 30-60 دقيقة قبل الإفطار.
+تجنب فول الصويا والخضروات الصليبية (بروكلي، كرنب) بكميات كبيرة مع الأدوية.
+المتابعة: فحص TSH كل 6-12 شهر مع العلاج.""",
     },
     {
         "topic": "صحة الكلى",
-        "content": """نصائح للحفاظ على وظائف الكلى:
-الماء: اشرب 2-3 لترات يومياً لتنظيف الكلى.
-الملح: قلله لتقليل الضغط على الكلى.
-البروتين: لا تفرط في البروتين عند ضعف وظائف الكلى.
-الأدوية: تجنب المسكنات (NSAIDS) بكثرة.
-السكر والضغط: السيطرة عليهما أهم ما يحمي الكلى.
-المتابعة: كرياتينين ومعدل الترشيح GFR سنوياً للمعرضين للخطر.""",
+        "content": """نصائح للحفاظ على صحة الكلى:
+الترطيب: شرب 2-3 لتر ماء يومياً يحمي الكلى ويمنع الحصوات.
+البروتين: تقليل البروتين الزائد عند ضعف الكلى (استشر طبيبك).
+الملح: تقليل الصوديوم يحمي الكلى ويخفض الضغط.
+السكر والضغط: ضبطهما يمنع 70% من حالات الفشل الكلوي.
+الأدوية: تجنب مسكنات الألم (NSAIDs) بدون استشارة عند مشاكل الكلى.
+المتابعة: فحص الكرياتينين وeGFR وبروتين البول بانتظام.""",
     },
     {
         "topic": "صحة الكبد",
-        "content": """نصائح لصحة الكبد:
-الوزن: السمنة أكبر سبب للكبد الدهني، خسارة 7-10% من الوزن تحسن الكبد.
-الغذاء: قهوة بدون سكر تحمي الكبد (دراسات متعددة). قلل السكر والدهون.
-الكحول: الابتعاد عنه تماماً.
-الأدوية: لا تأخذ أدوية دون وصفة لفترة طويلة.
-التطعيم: لقاح التهاب الكبد A وB.
-المتابعة: ALT و AST كل سنة.""",
-    },
-    {
-        "topic": "تحسين صحة القلب",
-        "content": """نصائح للقلب الصحي:
-الغذاء: نظام البحر المتوسط: زيت زيتون، سمك، خضروات، مكسرات.
-الرياضة: 150 دقيقة هوائية أسبوعياً + تمارين مقاومة مرتين.
-التوتر: يرفع ضغط الدم والكوليسترول. إدارته مهمة.
-النوم: 7-9 ساعات. قلة النوم ترفع خطر القلب.
-التدخين: الإقلاع يخفض الخطر القلبي 50% بعد سنة.
-الفحوصات: ضغط الدم، كوليسترول، سكر، مؤشر الكتلة الجسمية.""",
-    },
-    {
-        "topic": "الصداع والصداع النصفي",
-        "content": """نصائح لتخفيف الصداع:
-المحفزات: تعرف على محفزاتك (الضوء، الضجيج، أطعمة معينة كالشوكولاتة والجبن القديم).
-الترطيب: الجفاف سبب رئيسي للصداع. اشرب 8 أكواب ماء يومياً.
-النوم: نظام نوم ثابت. كثرة النوم وقلته كلاهما يسببان صداعاً.
-الرياضة: المشي المنتظم يقلل تكرار الصداع النصفي.
-الإجهاد: التوتر محفز قوي. تمارين التنفس تساعد.
-الكافيين: الجرعة الصغيرة تخفف الصداع لكن الإفراط يسببه.
-متى تذهب للطبيب: صداع مفاجئ شديد، مع حمى، أو تغير في الرؤية.""",
-    },
-    {
-        "topic": "آلام المفاصل والتهاب المفاصل",
-        "content": """نصائح لآلام المفاصل:
-الوزن: كل كيلوغرام زائد يضع 4 كغ ضغطاً على الركبة.
-الرياضة: السباحة والدراجة الأقل ضغطاً على المفاصل، تقوّي العضلات.
-الحرارة والبرودة: الحرارة للألم المزمن، البرودة للالتهاب الحاد.
-أوميغا 3: السمك والكتان يقللان الالتهاب.
-تجنب: الوقوف الطويل، صعود الدرج المتكرر عند الألم الحاد.
-المكملات: الجلوكوزامين قد يساعد بعض الحالات.
-فحوصات: حمض اليوريك (للنقرس)، CRP، أشعة للمفصل.""",
-    },
-    {
-        "topic": "آلام الظهر والعمود الفقري",
-        "content": """نصائح لآلام الظهر:
-الجلوس: ظهر مستقيم، كرسي داعم للظهر، لا تجلس أكثر من ساعة متواصلة.
-التمدد: تمارين تقوية عضلات البطن والظهر تحمي العمود الفقري.
-النوم: على جانبك مع وسادة بين الركبتين، أو على ظهرك مع وسادة تحت الركبتين.
-الرفع: انحنِ بركبتيك لا بظهرك عند رفع الأثقال.
-الوزن: السمنة تزيد الضغط على الفقرات القطنية.
-متى تذهب للطبيب: ألم ينتشر للساق، ضعف أو تنميل، صعوبة في الت��ول.""",
-    },
-    {
-        "topic": "الغدة الدرقية الخاملة (قصور)",
-        "content": """نصائح لقصور الغدة الدرقية:
-الدواء: ليفوثيروكسين يومياً صائماً، 30-60 دقيقة قبل الإفطار.
-لا تأخذه مع: الكالسيوم، الحديد، مضادات الحموضة (تقلل الامتصاص).
-الغذاء: اليود ضروري (ملح معالج، أسماك بحرية). السيلينيوم يدعم الغدة.
-تجنب الإفراط في: الكرنب، البروكلي، فول الصويا النيء (تثبط الغدة).
-المتابعة: TSH كل 6 أشهر، مع كل تغيير في الجرعة بعد 6-8 أسابيع.
-الأعراض التي تستدعي مراجعة الجرعة: زيادة وزن، تعب مفرط، برودة، إمساك.""",
-    },
-    {
-        "topic": "نقص حمض الفوليك",
-        "content": """نصائح لرفع مستوى حمض الفوليك:
-الغذاء: خضروات ورقية داكنة (سبانخ، بروكلي)، بقوليات، حبوب مدعمة، كبدة.
-الطهي: الطهي يدمر 50-90% من الفولات. تناول بعض الخضروات نيئة.
-المكملات: 400-800 ميكروجرام يومياً للنساء في سن الإنجاب.
-الحمل: 400-800 ميكروجرام قبل الحمل وفي الأشهر الأولى يمنع تشوهات الجنين.
-الكحول: يتدخل في امتصاص الفولات تجنبه.
-المتابعة: فحص مستوى الفولات والـ B12 معاً لأن نقصهما متشابه.""",
-    },
-    {
-        "topic": "مقاومة الأنسولين",
-        "content": """نصائح لتحسين حساسية الأنسولين:
-الغذاء: قلل الكربوهيدرات المكررة، اختر الحبوب الكاملة والبقوليات.
-الرياضة: أفضل علاج لمقاومة الأنسولين. 30 دقيقة يومياً من الرياضة الهوائية.
-الوزن: خسارة 5-10% من الوزن تحسن حساسية الأنسولين بشكل كبير.
-النوم: قلة النوم ترفع مقاومة الأنسولين. اهدف لـ 7-8 ساعات.
-الإجهاد: الكورتيزول يرفع مقاومة الأنسولين. إدارة التوتر مهمة.
-المتابعة: سكر صائم، أنسولين صائم، HbA1c كل 6 أشهر.""",
-    },
-    {
-        "topic": "الكبد الدهني",
-        "content": """نصائح لعلاج الكبد الدهني:
-الوزن: الهدف الأهم. خسارة 7-10% من الوزن تحسن الكبد الدهني بشكل ملحوظ.
-السكر: تقليل السكر والفركتوز (مشروبات غازية، عصائر مصنعة) أهم خطوة.
-القهوة: 2-3 أكواب قهوة يومياً تحمي الكبد (بدون سكر زائد).
-الرياضة: 30 دقيقة يومياً حتى بدون خسارة وزن تحسن الكبد.
-الكحول: ممنوع تماماً في الكبد الدهني.
-المتابعة: ALT وAST كل 6 أشهر، أشعة تحديد بالموجات الصوتية.""",
-    },
-    {
-        "topic": "ضعف المناعة والوقاية من العدوى",
-        "content": """نصائح لتقوية جهاز المناعة:
-التغذية: فيتامين C (حمضيات)، زنك (لحم، بذور يقطين)، فيتامين D (شمس ومكملات).
-النوم: 7-9 ساعات. النوم الكافي يضاعف فاعلية اللقاحات ويقوي المناعة.
-الرياضة: المعتدلة تقوي المناعة، المفرطة تضعفها.
-الإجهاد: التوتر المزمن يقمع المناعة. مارس تقنيات الاسترخاء.
-الماء: الجفاف يضعف إنتاج الأجسام المضادة.
-التدخين: يدمر خلايا المناعة في الجهاز التنفسي.
-الميكروبيوم: تناول البروبيوتيك والألياف لدعم بكتيريا الأمعاء المفيدة.""",
-    },
-    {
-        "topic": "الوقاية من هشاشة العظام",
-        "content": """نصائح لصحة العظام:
-الكالسيوم: 1000-1200 mg يومياً من الغذاء (حليب، جبن، لبن، سبانخ، سردين).
-فيتامين D: ضروري لامتصاص الكالسيوم. 800-2000 IU يومياً.
-الرياضة: رياضة تحمل الوزن (مشي، جري، رفع أثقال) تبني كثافة العظام.
-تجنب: التدخين والكحول الزائد (يضران بالعظام).
-الكافيين: الإفراط يقلل امتصاص الكالسيوم.
-الفحص: DEXA scan (قياس كثافة العظام) للنساء بعد انقطاع الطمث.""",
-    },
-    {
-        "topic": "صحة الجهاز الهضمي",
-        "content": """نصائح لصحة الجهاز الهضمي:
-الألياف: 25-35 غرام يومياً من الفواكه والخضروات والحبوب الكاملة.
-الماء: ضروري لمنع الإمساك وتحريك الطعام.
-البروبيوتيك: لبن، كفير، مخلل طبيعي لدعم بكتيريا الأمعاء.
-الأكل: ببطء ومضغ جيد يقلل الغازات والانتفاخ.
-الإجهاد: يؤثر مباشرة على الأمعاء (القولون العصبي).
-تجنب: الأطعمة المصنعة، الدهون المشبعة، الإكثار من المضادات الحيوية.
-متى تراجع الطبيب: دم في البراز، فقدان وزن غير مبرر، ألم مستمر.""",
-    },
-    {
-        "topic": "النقرس وارتفاع حمض اليوريك",
-        "content": """نصائح للنقرس:
-الماء: 2-3 لترات يومياً تساعد الكلى على إفراز حمض اليوريك.
-تجنب: اللحوم الحمراء، المأكولات البحرية، الكبدة والكلى (غنية بالبيورينات).
-قلل: الكحول خاصة البيرة، المشروبات المحلاة بالفركتوز.
-أضف: الكرز (طازج أو عصير) يقلل نوبات النقرس.
-الوزن: السمنة ترفع حمض اليوريك، خسارة وزن تدريجية مهمة.
-الأدوية: الألوبيورينول للوقاية، الكولشيسين للنوبة الحادة.
-الفحص: حمض اليوريك في الدم مرة كل 6 أشهر.""",
-    },
-    {
-        "topic": "القلق والتوتر النفسي",
-        "content": """نصائح لإدارة القلق:
-التنفس: تقنية 4-7-8: شهيق 4 ثوان، احتباس 7، زفير 8. تهدئ الجهاز العصبي فوراً.
-الرياضة: 30 دقيقة مشي يومياً تعادل مضادات القلق في بعض الدراسات.
-النوم: قلة النوم تزيد القلق. نظام نوم ثابت أساسي.
-الكافيين: يزيد القلق عند الحساسين. قلله أو تجنبه بعد الظهر.
-التأمل: 10 دقائق يومياً تغير بنية الدماغ وتقلل القلق مثبتاً علمياً.
-دعم اجتماعي: التحدث مع شخص موثوق يخفف عبء القلق.
-متى تطلب مساعدة: إذا تداخل القلق مع حياتك اليومية.""",
-    },
-    {
-        "topic": "الاكتئاب وتحسين المزاج",
-        "content": """نصائح لتحسين الصحة النفسية:
-الرياضة: أثبتت الدراسات أن 45 دقيقة هوائية 3 مرات/أسبوع فعّالة كالدواء في الاكتئاب الخفيف.
-الشمس: 20 دقيقة يومياً ترفع السيروتونين وتنظم الساعة البيولوجية.
-النوم: اضطراب النوم وثيق الصلة بالاكتئاب. علاج أحدهما يحسن الآخر.
-التغذية: أوميغا 3، فيتامين D، المغنيسيوم، B12 كلها مرتبطة بالمزاج.
-التواصل: العزلة تسوء الاكتئاب. حافظ على علاقاتك الاجتماعية.
-الفحوصات: استبعد نقص الغدة الدرقية، فيتامين D، B12 كأسباب عضوية.
-متى تطلب مساعدة: أفكار إيذاء النفس تستدعي مساعدة فورية.""",
-    },
-    {
-        "topic": "متلازمة القولون العصبي IBS",
-        "content": """نصائح لمرضى القولون العصبي:
-FODMAP: نظام غذائي يقلل السكريات القابلة للتخمر. يساعد 75% من المرضى.
-الإجهاد: القولون العصبي يرتبط مباشرة بالتوتر. إدارة الإجهاد علاج حقيقي.
-النعناع: زيت النعناع كبسولات مغلفة يقلل تشنجات القولون.
-الألياف: الألياف القابلة للذوبان (شوفان، بذور الكتان) أفضل من غير القابلة.
-الأكل: ببطء، وجبات صغيرة منتظمة، تجنب الوجبات الكبيرة.
-سجل الطعام: دوّن ما تأكله وأعراضك لتحديد المحفزات الشخصية.""",
-    },
-    {
-        "topic": "الحموضة وارتجاع المريء GERD",
-        "content": """نصائح لارتجاع المريء:
-الوزن: تقليل الوزن يخفف الضغط على المعدة ويقلل الارتجاع.
-الوجبات: صغيرة ومتكررة، لا تنم قبل 3 ساعات من الأكل.
-رفع الرأس: ارفع رأس السرير 15-20 سم عند النوم على الجانب الأيسر.
-تجنب: القهوة، الشوكولاتة، الحمضيات، الطماطم، الأطعمة الدهنية والحارة.
-الملابس: تجنب الملابس الضيقة التي تضغط على البطن.
-التدخين والكحول: يرخيان العضلة الحاجزة ويزيدان الارتجاع.""",
-    },
-    {
-        "topic": "حصوات الكلى",
-        "content": """نصائح للوقاية من حصوات الكلى:
-الماء: أهم علاج وقاية. 2.5-3 لترات يومياً تخفف تركيز المعادن.
-الكالسيوم: لا تقلل الكالسيوم الغذائي (يرتبط بالأكسالات في الأمعاء ويمنعها).
-الملح والبروتين الحيواني: قللهما فإنهما يرفعان الكالسيوم في البول.
-الأكسالات: قلل السبانخ، المكسرات، الشوكولاتة إذا كانت حصوات أكسالات.
-الليمون: عصير ليمون يومياً يرفع السترات ويمنع تكوّن الحصوات.
-متابعة: تحليل بول 24 ساعة لتحديد نوع الحصوات والوقاية المناسبة.""",
-    },
-    {
-        "topic": "متلازمة تكيس المبايض PCOS",
-        "content": """نصائح لمتلازمة تكيس المبايض:
-الوزن: خسارة 5-10% من الوزن تنظم الدورة وتحسن الخصوبة بشكل ملحوظ.
-الغذاء: نظام منخفض المؤشر الجلايسيمي يحسن مقاومة الأنسولين.
-الرياضة: تحسن حساسية الأنسولين وتنظم الهرمونات.
-الميتفورمين: يستخدمه الأطباء لتحسين حساسية الأنسولين في PCOS.
-الإنوزيتول: مكمل طبيعي يساعد في تنظيم الهرمونات.
-الفحوصات: سكر صائم وأنسولين، هرمونات (LH/FSH/تستوستيرون)، TSH، أشعة مبايض.""",
-    },
-    {
-        "topic": "الوقاية من أمراض القلب",
-        "content": """الوقاية من أمراض القلب والشرايين:
-الفحوصات الدورية: ضغط الدم، كوليسترول، سكر، مؤشر الكتلة الجسمية كل سنة.
-الغذاء القلبي: قلل الدهون المشبعة والصوديوم. أكثر من الخضروات والفواكه والأسماك.
-الرياضة: 150 دقيقة أسبوعياً من النشاط المعتدل.
-الإقلاع عن التدخين: أهم قرار صحي لصحة القلب.
-الوزن: مؤشر الكتلة الجسمية 18.5-24.9 مثالي.
-إدارة الإجهاد: التوتر المزمن يرفع ضغط الدم ويزيد الالتهاب.
-الأسبرين: لا تأخذه للوقاية بدون استشارة طبيب.""",
-    },
-    {
-        "topic": "الربو وصحة الجهاز التنفسي",
-        "content": """نصائح لمرضى الربو:
-المحفزات: تعرف عليها وتجنبها (غبار، دخان، عطور، برد، مجهود).
-البيئة: مكيف هواء نظيف، تغيير مخدات وأغطية باستمرار، لا سجاد في غرفة النوم.
-البخاخ الموسع: دائماً معك للطوارئ. استخدم بالتسلسل الصحيح.
-الكورتيزون الاستنشاقي: للوقاية وليس للطوارئ فقط. لا تتوقف عنه.
-الرياضة: ممكنة مع الربو. المسبح الأنسب (رطوبة عالية).
-متى تذهب للطوارئ: صعوبة تنفس شديدة، شفاه زرقاء، عدم استجابة للبخاخ.""",
-    },
-    {
-        "topic": "السمنة وإدارة الوزن",
-        "content": """نصائح صحية لإنقاص الوزن:
-الهدف الواقعي: 0.5-1 كغ أسبوعياً. السرعة تسبب فقدان عضلات ويوثيرو.
-العجز الحراري: قلل 500 سعرة يومياً (غذاء أقل + رياضة أكثر) = 0.5 كغ أسبوعياً.
-البروتين: يزيد الشبع ويحافظ على العضلات. أضفه في كل وجبة.
-الماء: اشرب كوب قبل كل وجبة. أحياناً يخلط الجسم العطش بالجوع.
-النوم: قلة النوم ترفع هرمون الجوع (غريلين) وتقلل الشبع (ليبتين).
-الصبر: الوزن المُفقود ببطء يعود ببطء. 6 أشهر للعادات الثابتة.""",
+        "content": """نصائح للحفاظ على صحة الكبد:
+الوزن: الكبد الدهني أكثر أمراض الكبد شيوعاً، تخسيس 10% من الوزن يحسنه كثيراً.
+الكحول: هو السبب الأول لتليف الكبد في العالم، تجنبه تماماً.
+الغذاء: خضروات، فواكه، قهوة (مفيدة للكبد)، قلل الدهون المشبعة والسكر.
+الأدوية: لا تتناول أي دواء بدون استشارة عند مشاكل الكبد.
+التطعيم: تأكد من أخذ لقاح التهاب الكبد B.
+المتابعة: فحص ALT، AST، Bilirubin، Albumin كل 6 أشهر.""",
+    },
+    {
+        "topic": "صحة القلب والأوعية الدموية",
+        "content": """نصائح لصحة القلب:
+الغذاء: نظام البحر المتوسط (زيت زيتون، سمك، خضروات، مكسرات، حبوب كاملة).
+أوميغا-3: السمك مرتين أسبوعياً أو مكملات 1000 mg يومياً تقلل الدهون الثلاثية.
+الرياضة: 150 دقيقة هوائية أسبوعياً تقلل أمراض القلب بنسبة 35%.
+التدخين: الإقلاع يخفض خطر النوبة القلبية بنسبة 50% خلال سنة.
+الكوليسترول والضغط والسكر: ضبط الثلاثة أساس الوقاية من أمراض القلب.
+المتابعة: فحص قلب مع ECG سنوياً بعد 40 سنة.""",
     },
 ]
-
-# ============================================================
-# القسم 3: قائمة مواضيع MedlinePlus الموسعة
-# ============================================================
-MEDLINEPLUS_TOPICS = [
-    # تحاليل الدم
-    ("blood glucose diabetes test", "glucose test", "lab_test"),
-    ("hemoglobin anemia blood test", "hemoglobin", "lab_test"),
-    ("complete blood count CBC test", "CBC", "lab_test"),
-    ("cholesterol test lipid panel", "cholesterol", "lab_test"),
-    ("thyroid function test TSH T4", "thyroid test", "lab_test"),
-    ("liver function test ALT AST", "liver function", "lab_test"),
-    ("kidney function creatinine BUN test", "kidney function", "lab_test"),
-    ("HbA1c glycated hemoglobin test", "HbA1c", "lab_test"),
-    ("iron studies ferritin test", "iron ferritin", "lab_test"),
-    ("vitamin D blood test deficiency", "vitamin D test", "lab_test"),
-    ("vitamin B12 blood test", "vitamin B12 test", "lab_test"),
-    ("uric acid gout test", "uric acid", "lab_test"),
-    ("C-reactive protein CRP test", "CRP", "lab_test"),
-    ("PSA prostate test", "PSA", "lab_test"),
-    ("blood pressure measurement", "blood pressure", "lab_test"),
-    ("electrolytes sodium potassium test", "electrolytes", "lab_test"),
-    ("calcium blood test", "calcium", "lab_test"),
-    ("platelet count test", "platelet", "lab_test"),
-    # الأمراض
-    ("diabetes mellitus management treatment", "diabetes", "disease"),
-    ("hypertension high blood pressure", "hypertension", "disease"),
-    ("anemia iron deficiency treatment", "anemia", "disease"),
-    ("hypothyroidism underactive thyroid", "hypothyroidism", "disease"),
-    ("hyperthyroidism overactive thyroid Graves", "hyperthyroidism", "disease"),
-    ("coronary artery disease heart attack", "heart disease", "disease"),
-    ("chronic kidney disease renal failure", "kidney disease", "disease"),
-    ("fatty liver disease NAFLD", "fatty liver", "disease"),
-    ("gout uric acid joint pain", "gout", "disease"),
-    ("osteoporosis bone density", "osteoporosis", "disease"),
-    ("high cholesterol hyperlipidemia", "high cholesterol", "disease"),
-    ("asthma breathing treatment", "asthma", "disease"),
-    ("urinary tract infection UTI", "UTI", "disease"),
-    ("irritable bowel syndrome IBS", "IBS", "disease"),
-    ("acid reflux GERD heartburn", "GERD", "disease"),
-    ("polycystic ovary syndrome PCOS", "PCOS", "disease"),
-    ("obesity overweight treatment", "obesity", "disease"),
-    ("metabolic syndrome insulin resistance", "metabolic syndrome", "disease"),
-    ("celiac disease gluten", "celiac", "disease"),
-    ("rheumatoid arthritis treatment", "rheumatoid arthritis", "disease"),
-    ("depression treatment mental health", "depression", "disease"),
-    ("anxiety disorder treatment", "anxiety disorder", "disease"),
-    ("sleep apnea insomnia", "sleep disorders", "disease"),
-    ("migraine headache treatment", "migraine", "disease"),
-    ("stroke cerebrovascular prevention", "stroke", "disease"),
-    ("pneumonia respiratory infection", "pneumonia", "disease"),
-    ("osteoarthritis joint pain", "osteoarthritis", "disease"),
-    ("fibromyalgia chronic pain", "fibromyalgia", "disease"),
-    # الأعراض
-    ("fatigue tiredness causes treatment", "fatigue", "symptom"),
-    ("headache causes treatment", "headache", "symptom"),
-    ("fever temperature causes", "fever", "symptom"),
-    ("dizziness vertigo causes", "dizziness", "symptom"),
-    ("shortness of breath dyspnea", "shortness of breath", "symptom"),
-    ("chest pain causes", "chest pain", "symptom"),
-    ("abdominal pain stomach ache", "abdominal pain", "symptom"),
-    ("nausea vomiting causes", "nausea", "symptom"),
-    ("back pain lower back", "back pain", "symptom"),
-    ("weight loss unintentional", "weight loss", "symptom"),
-    ("hair loss causes treatment", "hair loss", "symptom"),
-    ("skin rash allergy causes", "skin rash", "symptom"),
-    ("joint pain causes treatment", "joint pain", "symptom"),
-    ("muscle weakness causes", "muscle weakness", "symptom"),
-    ("heart palpitations causes", "palpitations", "symptom"),
-    ("insomnia sleep problems", "insomnia", "symptom"),
-    ("frequent urination causes", "frequent urination", "symptom"),
-    ("excessive thirst polydipsia", "excessive thirst", "symptom"),
-    ("blurred vision eye problems", "blurred vision", "symptom"),
-    ("swollen feet ankles edema", "edema", "symptom"),
-    ("night sweats causes", "night sweats", "symptom"),
-    ("chronic cough causes", "chronic cough", "symptom"),
-    ("numbness tingling hands feet", "numbness", "symptom"),
-    ("memory problems cognitive", "memory problems", "symptom"),
-    ("cold intolerance thyroid", "cold intolerance", "symptom"),
-    # التغذية والوقاية
-    ("healthy diet nutrition tips", "healthy diet", "prevention"),
-    ("exercise physical activity benefits", "exercise benefits", "prevention"),
-    ("sleep hygiene tips better sleep", "sleep health", "prevention"),
-    ("stress management mental health", "stress management", "prevention"),
-    ("water hydration health benefits", "hydration", "prevention"),
-    ("mediterranean diet heart health", "mediterranean diet", "prevention"),
-    ("vitamin supplements when needed", "vitamins supplements", "prevention"),
-    ("weight loss healthy strategies", "weight management", "prevention"),
-    ("smoking cessation health benefits", "quit smoking", "prevention"),
-    ("alcohol health effects risks", "alcohol health", "prevention"),
-    ("preventive health screenings checkup", "health screenings", "prevention"),
-    ("blood sugar control tips", "blood sugar control", "prevention"),
-]
-
-# ============================================================
-# القسم 4: الأسئلة الشائعة (FAQ) بالعربية
-# ============================================================
-FAQS = [
-    {
-        "q": "ما سبب الشعور بالتعب المستمر والإجهاد؟",
-        "a": """التعب المستمر له أسباب طبية كثيرة يجب فحصها:\n- نقص الحديد والفيريتين: الأكثر شيوعاً عند النساء\n- نقص فيتامين D أو B12\n- قصور الغدة الدرقية (TSH مرتفع)\n- فقر الدم (هيموجلوبين منخفض)\n- السكري أو مقاومة الأنسولين\n- اكتئاب أو قلق مزمن\n- قلة النوم أو توقف التنفس أثناء النوم\n- الجفاف وقلة شرب الماء\nالتحاليل المقترحة: CBC، فيريتين، فيتامين D، فيتامين B12، TSH، سكر صائم، وظائف الكلى والكبد.""",
-    },
-    {
-        "q": "لماذا انخفض الهيموجلوبين عندي؟ ما أسباب فقر الدم؟",
-        "a": """أسباب انخفاض الهيموجلوبين وفقر الدم:\n- نقص الحديد: السبب الأشيع (نزيف، حيض غزير، سوء تغذية)\n- نقص فيتامين B12 أو حمض الفوليك\n- أمراض الكلى المزمنة\n- الثلاسيميا (وراثية)\n- التهابات مزمنة\nأعراضه: تعب، شحوب، ضيق تنفس، خفقان، دوخة.\nالعلاج: مكملات حديد مع فيتامين C، B12، أو فولات حسب السبب.""",
-    },
-    {
-        "q": "كيف أرفع مستوى الحديد والفيريتين في الدم؟",
-        "a": """لرفع الحديد والفيريتين:\nالغذاء: اللحوم الحمراء، الكبدة، السبانخ، العدس، الفاصوليا، الحبوب المدعمة.\nتناول فيتامين C مع وجبة الحديد (برتقال، فلفل أحمر) لتحسين الامتصاص 3 أضعاف.\nتجنب: القهوة والشاي والكالسيوم مع وجبة الحديد.\nالمكملات: كبريتات الحديد أو غلوكونات الحديد على معدة فارغة.\nالمتابعة: فيريتين كل 3 أشهر حتى يصل للمستوى المثالي (فوق 50 ng/mL).""",
-    },
-    {
-        "q": "ما معنى ارتفاع الكوليسترول وكيف أخفضه؟",
-        "a": """الكوليسترول المرتفع يزيد خطر أمراض القلب والجلطات.\nأسبابه: السمنة، قلة الرياضة، الوراثة، السكري، قصور الدرقية.\nللتخفيض:\n- الغذاء: قلل الدهون المشبعة، أكثر من الألياف (شوفان، تفاح)، زيت زيتون.\n- الرياضة: 150 دقيقة هوائية أسبوعياً.\n- الوزن: كل 1 كغ تخسره يخفض LDL بـ 1%.\n- الإقلاع عن التدخين يرفع HDL بـ 10%.\n- الأدوية: ستاتين إذا لزم بوصفة طبيب.""",
-    },
-    {
-        "q": "ما هو مستوى السكر الطبيعي؟ متى يكون السكري؟",
-        "a": """مستويات سكر الدم:\n- طبيعي صائم: 70-100 mg/dL\n- ما قبل السكري: 100-125 mg/dL\n- سكري: 126 فأكثر (في فحصين منفصلين)\n- بعد الأكل الطبيعي: أقل من 140\n- HbA1c طبيعي: أقل من 5.7%. ما قبل السكري: 5.7-6.4%. سكري: 6.5% فأكثر.\nأعراض السكري: كثرة التبول، عطش شديد، تعب، تعب بعد الأكل، بطء التئام الجروح.""",
-    },
-    {
-        "q": "ما معنى ارتفاع TSH؟ ما أعراض قصور الغدة الدرقية؟",
-        "a": """TSH مرتفع يعني أن الغدة الدرقية خاملة (قصور).\nالقيم الطبي��ية: 0.4-4.0 mIU/L. فوق 4 = قصور.\nأعراض قصور الدرقية:\n- تعب وإرهاق مستمر\n- زيادة وزن بدون سبب\n- برودة دائمة حتى في الجو الدافئ\n- إمساك\n- بطء ضربات القلب\n- تساقط الشعر وجفاف الجلد\n- اكتئاب وبطء التفكير\nالعلاج: ليفوثيروكسين يومياً على معدة فارغة.""",
-    },
-    {
-        "q": "كيف أرفع فيتامين د؟ ما أعراض نقصه؟",
-        "a": """أعراض نقص فيتامين D:\n- آلام العظام والعضلات\n- تعب مزمن\n- ضعف المناعة وتكرار الأمراض\n- اكتئاب ومزاج منخفض\n- تساقط الشعر\nلرفع فيتامين D:\n- الشمس: 15-30 دقيقة يومياً على الذراعين والساقين بين 10 صباحاً و3 عصراً\n- الغذاء: سمك السلمون، السردين، صفار البيض، حليب مدعم\n- المكملات: 2000-5000 IU يومياً (حسب توجيه الطبيب)\n- فيتامين D يُمتص مع الدهون، تناوله مع وجبة دسمة\nمتابعة: فحص بعد 3 أشهر.""",
-    },
-    {
-        "q": "ما أعراض نقص فيتامين ب12؟ ومن الأكثر عرضة له؟",
-        "a": """أعراض نقص فيتامين B12:\n- تنميل ووخز في اليدين والقدمين\n- تعب وضعف\n- فقر الدم الضخم الكريات\n- ضعف الذاكرة والتركيز\n- التهاب اللسان\n- مشية غير ثابتة\nالأكثر عرضة للنقص:\n- النباتيون والخضريون (B12 موجود فقط في المنتجات الحيوانية)\n- كبار السن (ضعف الامتصاص)\n- من يأخذون الميتفورمين لعلاج السكري\n- أمراض المعدة والأمعاء\nالعلاج: حقن B12 أو مكملات عالية الجرعة (1000 mcg يومياً).""",
-    },
-    {
-        "q": "ما معنى ارتفاع CRP؟ ما هو بروتين سي التفاعلي؟",
-        "a": """CRP (بروتين سي التفاعلي) مؤشر للالتهاب في الجسم.\nطبيعي: أقل من 10 mg/L.\nCRP عالي يعني وجود التهاب أو عدوى في مكان ما.\nأسباب الارتفاع:\n- عدوى بكتيرية أو فيروسية\n- التهاب المفاصل الروماتويدي\n- أمراض الأمعاء الالتهابية\n- نوبة قلبية حديثة\n- السمنة والسكري\nhigh-sensitivity CRP (hs-CRP): فوق 3 mg/L يشير لخطر قلبي مرتفع.\nالمتابعة: يُفسر مع ESR وأعراض المريض.""",
-    },
-    {
-        "q": "ما معنى ارتفاع حمض اليوريك؟ ما هو النقرس؟",
-        "a": """حمض اليوريك يتكون من تكسير البيورينات في الطعام.\nطبيعي: رجال 3.5-7.2، نساء 2.6-6.0 mg/dL.\nأسباب الارتفاع: اللحوم الحمراء، المأكولات البحرية، الكحول، السمنة، الفشل الكلوي.\nالنقرس: ترسب بلورات حمض اليوريك في المفاصل خاصة إصبع القدم الكبير.\nأعراض النوبة: ألم شديد مفاجئ، تورم، احمرار في المفصل.\nالعلاج:\n- تجنب اللحوم الحمراء والبحرية والكحول\n- شرب 2-3 لترات ماء يومياً\n- كولشيسين للنوبة الحادة، ألوبيورينول للوقاية""",
-    },
-    {
-        "q": "ما معنى ارتفاع الكرياتينين؟ كيف أعرف أن كليتي بخير؟",
-        "a": """الكرياتينين مؤشر لوظائف الكلى.\nطبيعي: رجال 0.74-1.35، نساء 0.59-1.04 mg/dL.\nارتفاعه يعني الكلى لا تصفي الدم بكفاءة.\nأسباب الارتفاع: أمراض الكلى المزمنة، الجفاف، السكري، ارتفاع الضغط.\nمؤشرات الكلى الكاملة: كرياتينين + eGFR + يوريا + تحليل بول.\neGFR طبيعي: فوق 90 mL/min. أقل من 60 = مرض كلوي مزمن.\nللحفاظ على الكلى: ماء كافٍ، تحكم في السكر والضغط، تجنب المسكنات.""",
-    },
-    {
-        "q": "ما أعراض مرض السكري؟ كيف أعرف أن عندي سكري؟",
-        "a": """أعراض السكري الكلاسيكية:\n- كثرة التبول (خاصة ليلاً)\n- عطش شديد ومستمر\n- تعب وإرهاق\n- جوع مستمر رغم الأكل\n- تعتم أو ضبابية في الرؤية\n- بطء التئام الجروح\n- تنميل أو وخز في القدمين\n- فقدان وزن غير مبرر (النوع الأول)\nالتشخيص بالتحاليل:\n- سكر صائم 126 mg/dL فأكثر (مرتين)\n- HbA1c 6.5% فأكثر\n- سكر عشوائي 200 فأكثر مع أعراض""",
-    },
-    {
-        "q": "ما أسباب تساقط الشعر؟ كيف أوقف ت��اقط الشعر؟",
-        "a": """أسباب تساقط الشعر الشائعة:\n- نقص الحديد والفيريتين: السبب الأول عند النساء\n- نقص فيتامين D أو B12 أو الزنك\n- قصور أو فرط الغدة الدرقية\n- تكيس المبايض PCOS عند النساء (هرمونات ذكورية مرتفعة)\n- التوتر الشديد والصدمات\n- بعض الأدوية\n- الثعلبة (alopecia areata): مناعية\nالتحاليل المقترحة: CBC، فيريتين، فيتامين D، B12، TSH، زنك، هرمونات.\nالعلاج يعتمد على السبب.""",
-    },
-    {
-        "q": "ما سبب ارتفاع ضغط الدم؟ كيف أخفض الضغط؟",
-        "a": """أسباب ارتفاع ضغط الدم:\n- الوراثة والعمر\n- السمنة والوزن الزائد\n- كثرة الملح في الطعام\n- قلة الرياضة\n- التوتر المزمن\n- الكافيين والتدخين\nالضغط الطبيعي: أقل من 120/80 mmHg. ارتفاع: 130/80 فأكثر.\nللتخفيض بدون دواء:\n- قلل الملح (أقل من 2300 mg يومياً)\n- نظام DASH: خضروات، فواكه، حليب قليل الدسم\n- رياضة 30 دقيقة يومياً تخفض الضغط 5-8 درجات\n- خسارة 5 كغ تخفض الضغط 5 درجات""",
-    },
-    {
-        "q": "ما أسباب الكبد الدهني؟ كيف أعالج الكبد الدهني؟",
-        "a": """الكبد الدهني (Fatty Liver) هو تراكم الدهون في خلايا الكبد.\nأسبابه:\n- السمنة والوزن الزائد (السبب الأول)\n- السكري ومقاومة الأنسولين\n- ارتفاع الدهون الثلاثية\n- الكحول\n- الأدوية كالكورتيزون\nالأعراض: غالباً بدون أعراض، يُكتشف بالموجات الصوتية أو ارتفاع ALT.\nالعلاج:\n- خسارة 7-10% من الوزن تحسن الكبد بشكل ملحوظ\n- تقليل السكر والفركتوز (مشروبات غازية)\n- القهوة بدون سكر تحمي الكبد (2-3 أكواب يومياً)\n- رياضة 30 دقيقة يومياً حتى بدون خسارة وزن""",
-    },
-    {
-        "q": "ما أعراض نقص الحديد؟ ما الفرق بين نقص الحديد وفقر الدم؟",
-        "a": """نقص الحديد أعم من فقر الدم:\n- مرحلة 1: نضوب مخازن الحديد (فيريتين منخفض) بدون أعراض واضحة\n- مرحلة 2: هيموجلوبين يبدأ بالانخفاض\n- مرحلة 3: فقر الدم الكامل\nأعراض نقص الحديد:\n- تعب مزمن حتى مع قسط كافٍ من النوم\n- برودة الأطراف\n- تساقط الشعر وهشاشة الأظافر\n- شهية غريبة (أكل الثلج أو التراب)\n- ضعف التركيز والذاكرة\n- شحوب الجلد والملتحمة\nالتحاليل: فيريتين أفضل مؤشر لمخزون الحديد. حديد الدم + TIBC + هيموجلوبين.""",
-    },
-    {
-        "q": "ما معنى ارتفاع WBC خلايا الدم البيضاء؟",
-        "a": """WBC (خلايا الدم البيضاء) = جهاز المناعة.\nطبيعي: 4,000-11,000 خلية/µL.\nارتفاع WBC أسبابه:\n- عدوى بكتيرية: ارتفاع العدلات Neutrophils\n- عدوى فيروسية: ارتفاع الخلايا اللمفاوية Lymphocytes\n- حساسية وطفيليات: ارتفاع الحمضات Eosinophils\n- التهاب وتوتر جسدي\n- بعض الأدوية كالكورتيزون\n- نادراً: ابيضاض الدم (لوكيميا)\nانخفاض WBC:\n- عدوى فيروسية شديدة، كيماوي، نقص مناعة\nيُقرأ مع التفريق الوظيفي CBC diff لتحديد نوع الارتفاع.""",
-    },
-    {
-        "q": "كيف أتحكم في مستوى السكر HbA1c؟ ما المقصود بـ HbA1c؟",
-        "a": """HbA1c يقيس متوسط سكر الدم خلال 3 أشهر الماضية.\nلذلك لا ينخدع بتحسن السكر يوم الفحص.\nالأهداف:\n- طبيعي: أقل من 5.7%\n- ما قبل السكري: 5.7-6.4%\n- سكري متحكم به: أقل من 7%\n- سكري غير متحكم: 7% فأكثر\nلخفض HbA1c:\n- قلل الكربوهيدرات المكررة (خبز أبيض، أرز، سكر)\n- رياضة 30 دقيقة يومياً تخفض HbA1c بـ 0.5-1%\n- وزّع الوجبات 5-6 وجبات صغيرة\n- التزم بالأدوية والأنسولين إن وُصف\n- قياس السكر بانتظام""",
-    },
-    {
-        "q": "ما معنى انخفاض الصفائح الدموية (Platelets)؟",
-        "a": """الصفائح الدموية مسؤولة عن إيقاف النزيف.\nطبيعي: 150,000-400,000/µL.\nانخفاض الصفائح (Thrombocytopenia) أسبابه:\n- التهابات فيروسية (دنج، عدد أحادي)\n- أمراض المناعة الذاتية (ITP)\n- أمراض الكبد والطحال\n- العلاج الكيميائي\n- نقص فيتامين B12 أو فولات\nأعراض الانخفاض الشديد:\n- كدمات تظهر بسهولة\n- نزيف اللثة أو الأنف\n- نزيف طويل بعد الجرح\n- نقاط حمراء صغيرة في الجلد (Petechiae)\nاستشر الطبيب إن كانت أقل من 100,000.""",
-    },
-    {
-        "q": "ما أسباب الدوخة والدوار؟ متى تكون خطيرة؟",
-        "a": """أسباب الدوخة الشائعة:\n- انخفاض ضغط الدم عند الوقوف (دوار وضعي)\n- فقر الدم ونقص الحديد\n- نقص السكر (نقص سكر الدم)\n- الجفاف وقلة الماء\n- اضطرابات الأذن الداخلية (BPPV - الحجارة)\n- ضغط الدم المرتفع\n- أدوية معينة\n- القلق والتوتر\nالتحاليل المقترحة: سكر الدم، CBC، ضغط الدم، TSH.\nمتى تستشير الطبيب فوراً:\n- دوخة مع صداع شديد مفاجئ\n- مع ضعف في وجه أو يد\n- مع صعوبة كلام أو رؤية مزدوجة (أعراض سكتة)""",
-    },
-    {
-        "q": "ما سبب ارتفاع إنزيمات الكبد ALT و AST؟",
-        "a": """ALT و AST إنزيمات داخل خلايا الكبد. ارتفاعها يعني تضرر الخلايا.\nطبيعي: ALT أقل من 56، AST أقل من 40 U/L.\nأسباب الارتفاع:\n- الكبد الدهني (السبب الأشيع حالياً)\n- التهاب الكبد الفيروسي (B أو C)\n- الكحول\n- الأدوية (باراسيتامول الزائد، ستاتين، بعض المضادات الحيوية)\n- حصوات المرارة\n- توتر شديد أو رياضة مفرطة (AST يرتفع في العضلات أيضاً)\nدرجات الارتفاع:\n- خفيف (مرتين الطبيعي): مراقبة\n- معتدل (5-10 أضعاف): فحوصات إضافية\n- شديد (فوق 10 أضعاف): طارئ طبي""",
-    },
-    {
-        "q": "ما هو مؤشر الكتلة الجسمية BMI وكيف أحسبه؟",
-        "a": """مؤشر الكتلة الجسمية BMI = الوزن (كغ) ÷ الطول (م) ÷ الطول (م).\nمثال: وزن 80 كغ، طول 1.70م → BMI = 80 ÷ 1.70 ÷ 1.70 = 27.7\nالتصنيف:\n- أقل من 18.5: نقص وزن\n- 18.5-24.9: طبيعي (مثالي)\n- 25-29.9: زيادة وزن\n- 30-34.9: سمنة درجة 1\n- 35-39.9: سمنة درجة 2\n- 40+: سمنة مرضية\nمحيط الخصر أيضاً مهم: رجال أقل من 102 سم، نساء أقل من 88 سم للوقاية من أمراض القلب والسكري.""",
-    },
-    {
-        "q": "ما هو البوتاسيوم وما أعراض نقصه وارتفاعه؟",
-        "a": """البوتاسيوم معدن حيوي لعمل القلب والعضلات والأعصاب.\nطبيعي: 3.5-5.0 mEq/L.\nأعراض نقص البوتاسيوم (أقل من 3.5):\n- ضعف عضلي وتشنجات\n- إمساك\n- عدم انتظام القلب\n- تعب وإجهاد\nأسباب النقص: مدرات البول، إسهال، قيء، سوء تغذية.\nأعراض ارتفاع البوتاسيوم (فوق 5.5):\n- عدم انتظام قلب خطير\n- ضعف عضلي\nأسباب الارتفاع: الفشل الكلوي، بعض الأدوية.\nمصادر البوتاسيوم الغذائية: موز، بطاطا، أفوكادو، سبانخ، بقوليات.""",
-    },
-    {
-        "q": "ما معنى ارتفاع PSA؟ ما هو اختبار المستضد البروستاتي؟",
-        "a": """PSA (مستضد البروستاتا النوعي) بروتين تفرزه البروستاتا.\nطبيعي: أقل من 4 ng/mL (يختلف بالعمر).\nارتفاع PSA أسبابه:\n- ضخامة البروستاتا الحميدة (BPH) - الأشيع\n- التهاب البروستاتا\n- سرطان البروستاتا\n- القسطرة أو فحص البروستاتا قبل الفحص مباشرة\nارتفاع PSA لا يعني سرطاناً بالضرورة!\nللتقييم الدقيق: Free PSA، الكثافة، PSAD، وخزة البروستاتا إن لزم.\nالفحص الدوري: للرجال فوق 50 سنة، أو 40 إن كان هناك تاريخ عائلي.""",
-    },
-    {
-        "q": "ما أعراض قصور الكلى؟ كيف أحافظ على صحة الكلى؟",
-        "a": """أعراض ضعف وظائف الكلى:\n- تورم القدمين والكاحلين والوجه\n- تعب وإرهاق\n- قلة التبول أو كثرته\n- بول رغوي (بروتين)\n- ارتفاع ضغط الدم\n- غثيان وفقدان شهية\nالتحاليل: كرياتينين، eGFR، يوريا، تحليل بول.\nللحفاظ على الكلى:\n- اشرب 2-3 لترات ماء يومياً\n- تحكم في السكر وضغط الدم (أهم الأسباب)\n- تجنب المسكنات (ibuprofen, diclofenac) بشكل متكرر\n- فحص كرياتينين وبول سنوياً إن كنت في خطر""",
-    },
-    {
-        "q": "ما هو الثيروكسين ليفوثيروكسين؟ كيف آخذ دواء الغدة الدرقية؟",
-        "a": """ليفوثيروكسين (Levothyroxine / Eltroxin) هو علاج قصور الغدة الدرقية.\nطريقة الأخذ الصحيحة:\n- صائماً في الصباح قبل الفطور بـ 30-60 دقيقة\n- ابتلعه بكوب ماء كامل\n- لا تأخذه مع: القهوة، حليب، مكملات الكالسيوم، حديد، مضادات حموضة (تقلل الامتصاص)\nمتابعة:\n- TSH بعد 6-8 أسابيع من بدء العلاج أو تغيير الجرعة\n- TSH كل 6-12 شهراً عند الاستقرار\nتنبيه: لا تتوقف عن الدواء دون استشارة الطبيب، حتى لو تحسنت الأعراض.""",
-    },
-    {
-        "q": "ما هي فحوصات الخصوبة عند المرأة؟ لماذا يتأخر الحمل؟",
-        "a": """فحوصات الخصوبة الأساسية عند المرأة:\n- AMH: مخزون البويضات\n- FSH وLH: في اليوم 2-3 من الدورة\n- إيستراديول E2\n- TSH: قصور الدرقية يؤثر على الخصوبة\n- البرولاكتين: ارتفاعه يمنع الإباضة\n- أشعة رحم وقناتين (HSG)\n- أشعة مبايض للبويضات (follicular monitoring)\nأسباب شائعة لتأخر الحمل:\n- تكيس المبايض PCOS (عدم انتظام الإباضة)\n- قصور الغدة الدرقية\n- انسداد قناتي فالوب\n- انخفاض AMH (احتياطي منخفض)\n- عوامل ذكورية (40% من الحالات)\nاستشير طبيب خصوبة بعد سنة من المحاولة (أو 6 أشهر فوق 35 سنة).""",
-    },
-    {
-        "q": "ما هو هرمون التستوستيرون المنخفض عند الرجال؟ ما أعراضه؟",
-        "a": """انخفاض التستوستيرون (Low T) عند الرجال:\nطبيعي: 300-1000 ng/dL. منخفض: أقل من 300.\nأعراض الانخفاض:\n- ضعف الرغبة الجنسية\n- ضعف الانتصاب (ED)\n- تعب وإرهاق\n- فقدان كتلة العضلات وزيادة الدهون\n- اكتئاب وتغير مزاج\n- انخفاض كثافة العظام\n- قلة الشعر وصغر الخصيتين (طويل الأمد)\nأسباب الانخفاض:\n- السمنة (الدهون تحول التستوستيرون لإستروجين)\n- الشيخوخة (تنخفض 1% سنوياً بعد 30)\n- التوتر المزمن\n- الكحول والتدخين\n- قصور الخصية أو الغدة النخامية""",
-    },
-    {
-        "q": "ما هو تحليل المقاومة للأنسولين HOMA-IR؟",
-        "a": """مقاومة الأنسولين تعني أن الخلايا لا تستجيب للأنسولين بشكل طبيعي.\nالبنكرياس يُنتج المزيد من الأنسولين لتعويض ذلك.\nلقياسها: HOMA-IR = (سكر صائم × أنسولين صائم) ÷ 405\nطبيعي: أقل من 2.5. مقاومة: فوق 2.5.\nأعراض مقاومة الأنسولين:\n- تعب بعد الأكل\n- شهية زائدة للسكريات\n- صعوبة إنقاص الوزن\n- تغيّر لون الجلد في الرقبة والإبط (Acanthosis Nigricans)\n- تكيس المبايض\nالعلاج:\n- خسارة 7-10% من الوزن\n- تقليل الكربوهيدرات المكررة\n- رياضة منتظمة\n- الميتفورمين بوصفة طبيب""",
-    },
-    {
-        "q": "ما أسباب الصداع المتكرر؟ متى يكون الصداع خطيراً؟",
-        "a": """أسباب الصداع المتكرر الشائعة:\n- التوتر والإجهاد النفسي (الأكثر شيوعاً)\n- صداع نصفي (ميجرين): نبضي من جانب، مع غثيان وحساسية للضوء\n- الجفاف وقلة الماء\n- قلة النوم أو كثرته\n- ارتفاع ضغط الدم\n- مشاكل الرقبة والفقرات العنقية\n- إجهاد العين (شاشات)\n- فقر الدم ونقص الحديد\nصداع ثانوي: علامات تستدعي طبيباً فوراً:\n- صداع مفاجئ شديد جداً (سكتة دماغية)\n- مع حمى وتصلب رقبة (تهاب سحايا)\n- مع ضعف أو تنميل في جهة\n- يزداد تدريجياً على أسابيع""",
-    },
-    {
-        "q": "ما هي فائدة المغنيسيوم؟ ما أعراض نقصه؟",
-        "a": """المغنيسيوم يشارك في أكثر من 300 تفاعل كيميائي في الجسم.\nطبيعي في الدم: 1.7-2.2 mg/dL (لكن 99% مخزون في الخلايا!).\nأعراض نقص المغنيسيوم:\n- تشنجات عضلية (خاصة الساقين ليلاً)\n- رعشة وارتجاف\n- صداع متكرر\n- قلق وتوتر وأرق\n- إمساك\n- عدم انتظام القلب\nأسباب النقص:\n- نظام غذائي فقير (معالجة الطعام تزيل المغنيسيوم)\n- السكري (الكلى تُفرز أكثر)\n- الكحول والإسهال المزمن\n- مضادات الحموضة (PPI) لفترة طويلة\nمصادر غذائية: مكسرات، بذور، خضروات ورقية، شوكولاتة داكنة.""",
-    },
-]
-
-
-def build_faqs() -> list[Document]:
-    print("\n[2.5/5] بناء الأسئلة الشائعة (FAQ)...")
-    docs = []
-    for faq in FAQS:
-        content = f"سؤال شائع: {faq['q']}\nالإجابة: {faq['a']}"
-        docs.append(Document(
-            page_content=content,
-            metadata={"source": "medical_faq", "topic_type": "faq",
-                      "topic_name": faq['q'][:50], "language": "ar"}
-        ))
-    print(f"    {len(docs)} سؤال وجواب")
-    return docs
-
-
-def fetch_medlineplus(search_term: str) -> list[dict]:
-    url = "https://wsearch.nlm.nih.gov/ws/query"
-    params = {"db": "healthTopics", "term": search_term, "retmax": 2}
-    try:
-        resp = requests.get(url, params=params, timeout=15)
-        if resp.status_code != 200:
-            return []
-        root = ET.fromstring(resp.text)
-        results = []
-        for doc in root.findall('.//document'):
-            title, content = "", ""
-            for elem in doc.findall('content'):
-                name = elem.get('name', '')
-                if name == 'title':
-                    title = elem.text or ""
-                elif name == 'FullSummary':
-                    raw = elem.text or ""
-                    content = re.sub(r'<[^>]+>', ' ', raw).strip()
-                    content = re.sub(r'\s+', ' ', content)
-            if title and content and len(content) > 100:
-                results.append({"title": title, "content": content})
-        return results
-    except Exception as e:
-        print(f"  [ERROR] {e}")
-        return []
-
-
-def chunk_text(text: str, chunk_size: int = 400, overlap: int = 40) -> list[str]:
-    words = text.split()
-    chunks = []
-    for i in range(0, len(words), chunk_size - overlap):
-        chunk = " ".join(words[i:i + chunk_size])
-        if len(chunk) > 80:
-            chunks.append(chunk)
-    return chunks
-
-
-def deduplicate(db: Chroma) -> int:
-    print("\n[1/5] تنظيف التكرار...")
-    try:
-        all_data = db._collection.get(include=["documents"])
-        ids = all_data["ids"]
-        docs = all_data["documents"]
-        seen = {}
-        duplicates = []
-        for doc_id, text in zip(ids, docs):
-            key = text[:150].strip()
-            if key in seen:
-                duplicates.append(doc_id)
-            else:
-                seen[key] = doc_id
-        if duplicates:
-            db._collection.delete(ids=duplicates)
-            print(f"    حذفنا {len(duplicates)} chunk مكرر")
-        else:
-            print("    لا يوجد تكرار")
-        return len(duplicates)
-    except Exception as e:
-        print(f"    [ERROR] {e}")
-        return 0
-
-
-def build_lab_definitions() -> list[Document]:
-    print("\n[2/5] بناء تعاريف التحاليل...")
-    docs = []
-    for lab in LAB_DEFINITIONS:
-        content = f"""تحليل: {lab['name_ar']} | {lab['name_en']}
-تعريف: {lab['definition']}
-أسباب الارتفاع: {lab['high']}
-أسباب الانخفاض: {lab['low']}
-أعراض الانخفاض: {lab['symptoms_low']}"""
-        docs.append(Document(
-            page_content=content,
-            metadata={"source": "lab_definitions", "topic_type": "lab_definition",
-                       "topic_name": lab['name_ar'], "language": "ar"}
-        ))
-    print(f"    {len(docs)} تعريف تحليل")
-    return docs
-
-
-def build_health_recommendations() -> list[Document]:
-    print("\n[3/5] بناء التوصيات الصحية...")
-    docs = []
-    for rec in HEALTH_RECOMMENDATIONS:
-        docs.append(Document(
-            page_content=f"توصيات صحية - {rec['topic']}:\n{rec['content']}",
-            metadata={"source": "health_recommendations", "topic_type": "recommendation",
-                       "topic_name": rec['topic'], "language": "ar"}
-        ))
-    print(f"    {len(docs)} توصية صحية")
-    return docs
-
-
-def fetch_all_medlineplus() -> list[Document]:
-    print(f"\n[4/5] جلب {len(MEDLINEPLUS_TOPICS)} موضوع من MedlinePlus...")
-    docs = []
-    for i, (search_term, topic_name, topic_type) in enumerate(MEDLINEPLUS_TOPICS, 1):
-        if i % 10 == 0:
-            print(f"    [{i}/{len(MEDLINEPLUS_TOPICS)}]...")
-        results = fetch_medlineplus(search_term)
-        for item in results:
-            for idx, chunk in enumerate(chunk_text(item["content"])):
-                docs.append(Document(
-                    page_content=chunk,
-                    metadata={"source": "MedlinePlus", "topic_name": topic_name,
-                               "topic_type": topic_type, "title": item["title"],
-                               "language": "en", "chunk_index": idx}
-                ))
-        time.sleep(0.3)
-    print(f"    {len(docs)} chunk من MedlinePlus")
-    return docs
-
-
-def main():
-    print("=" * 50)
-    print("بناء الموسوعة الطبية الكاملة")
-    print("=" * 50)
-
-    print("\nتحميل Embeddings...")
-    embeddings = HuggingFaceEmbeddings(model_name=EMBEDDINGS_MODEL)
-    db = Chroma(persist_directory=DB_PATH, embedding_function=embeddings)
-
-    before = db._collection.count()
-    print(f"عدد الـ chunks قبل: {before}")
-
-    # 1. تنظيف التكرار
-    deduplicate(db)
-
-    # 2. تعاريف التحاليل
-    lab_docs = build_lab_definitions()
-
-    # 2.5 الأسئلة الشائعة
-    faq_docs = build_faqs()
-
-    # 3. التوصيات الصحية
-    rec_docs = build_health_recommendations()
-
-    # 4. MedlinePlus
-    ml_docs = fetch_all_medlineplus()
-
-    # 5. إضافة كل شيء
-    print("\n[5/5] إضافة البيانات لقاعدة البيانات...")
-    all_new = lab_docs + faq_docs + rec_docs + ml_docs
-    batch_size = 100
-    for i in range(0, len(all_new), batch_size):
-        batch = all_new[i:i + batch_size]
-        db.add_documents(batch)
-        print(f"    {min(i + batch_size, len(all_new))}/{len(all_new)} chunk...")
-
-    after = db._collection.count()
-    print(f"\n{'=' * 50}")
-    print(f"[OK] اكتملت الموسوعة الطبية!")
-    print(f"قبل: {before} | بعد: {after} | مضاف: {after - before}")
-    print(f"{'=' * 50}")
-
-
-if __name__ == "__main__":
-    main()

backend/medical_kb/__init__.py

@@ -0,0 +1,6 @@
+from .reference.medical_reference import MedicalKB
+
+# Module-level singleton — import this across the app
+kb = MedicalKB()
+
+__all__ = ["kb", "MedicalKB"]

backend/medical_kb/reference/__init__.py

@@ -0,0 +1,4 @@
+from .normal_ranges import lookup, classify, NORMAL_RANGES
+from .medical_reference import MedicalKB
+
+__all__ = ["lookup", "classify", "NORMAL_RANGES", "MedicalKB"]

backend/medical_kb/reference/medical_reference.py

@@ -0,0 +1,136 @@
+"""
+MedicalKB — runtime knowledge base loaded from JSON schemas.
+Provides panel lookup, test lookup, and severity classification.
+"""
+from __future__ import annotations
+import json
+import pathlib
+
+_SCHEMAS_DIR = pathlib.Path(__file__).parent.parent / "schemas"
+
+
+class MedicalKB:
+
+    def __init__(self) -> None:
+        self._panels: dict[str, dict] = {}
+        self._load_all()
+
+    def _load_all(self) -> None:
+        if not _SCHEMAS_DIR.exists():
+            return
+        for path in sorted(_SCHEMAS_DIR.glob("*.json")):
+            try:
+                data = json.loads(path.read_text(encoding="utf-8"))
+                code = data.get("panel_code", path.stem).lower()
+                self._panels[code] = data
+            except Exception as e:
+                print(f"[MedicalKB] Failed to load {path.name}: {e}")
+        print(f"[MedicalKB] Loaded {len(self._panels)} panels: {list(self._panels)}")
+
+    # ── Panel-level ────────────────────────────────────────────────────────
+
+    def get_panel(self, code: str) -> dict | None:
+        return self._panels.get(code.lower())
+
+    def list_panels(self) -> list[str]:
+        return list(self._panels.keys())
+
+    # ── Test-level ─────────────────────────────────────────────────────────
+
+    def get_test(self, panel_code: str, test_name: str) -> dict | None:
+        panel = self.get_panel(panel_code)
+        if not panel:
+            return None
+        tests = panel.get("tests", {})
+        name_lower = test_name.lower().strip()
+        for canonical, data in tests.items():
+            if canonical.lower() == name_lower:
+                return data
+            aliases = [a.lower() for a in data.get("abbreviations", [])]
+            if name_lower in aliases:
+                return data
+        return None
+
+    def find_test_panel(self, test_name: str) -> tuple[str, dict] | None:
+        """Search all panels for a test name. Returns (panel_code, test_data) or None."""
+        name_lower = test_name.lower().strip()
+        for code, panel in self._panels.items():
+            for canonical, data in panel.get("tests", {}).items():
+                if canonical.lower() == name_lower:
+                    return code, data
+                if name_lower in [a.lower() for a in data.get("abbreviations", [])]:
+                    return code, data
+        return None
+
+    # ── Range lookup ───────────────────────────────────────────────────────
+
+    def get_range(
+        self, panel_code: str, test_name: str, gender: str = "adult"
+    ) -> tuple[float, float] | None:
+        test = self.get_test(panel_code, test_name)
+        if not test:
+            return None
+        ranges = test.get("ranges", {})
+        gender_key = f"adult_{gender}" if gender in ("male", "female") else gender
+        r = ranges.get(gender_key) or ranges.get("adult")
+        if r:
+            lo = r.get("low", float("-inf"))
+            hi = r.get("high", float("inf"))
+            return lo, hi
+        return None
+
+    def classify(
+        self, panel_code: str, test_name: str, value: float, gender: str = "adult"
+    ) -> str:
+        rng = self.get_range(panel_code, test_name, gender)
+        if rng is None:
+            return "unknown"
+        lo, hi = rng
+        if value < lo:
+            return "low"
+        if value > hi:
+            return "high"
+        return "normal"
+
+    def get_severity(
+        self, panel_code: str, test_name: str, value: float
+    ) -> str | None:
+        """Return human-readable severity label from severity_thresholds if defined."""
+        test = self.get_test(panel_code, test_name)
+        if not test:
+            return None
+        thresholds = test.get("severity_thresholds", {})
+        if not thresholds:
+            return None
+        if "critical_low" in thresholds and value <= thresholds["critical_low"]:
+            return "critical_low"
+        if "severe_low" in thresholds and value <= thresholds["severe_low"]:
+            return "severe_low"
+        if "critical_high" in thresholds and value >= thresholds["critical_high"]:
+            return "critical_high"
+        if "acute_liver_failure" in thresholds and value >= thresholds["acute_liver_failure"]:
+            return "acute_liver_failure"
+        if "severe_elevation" in thresholds and value >= thresholds["severe_elevation"]:
+            return "severe_elevation"
+        if "moderate_elevation_x10" in thresholds and value >= thresholds["moderate_elevation_x10"]:
+            return "moderate_high"
+        if "mild_elevation_x3" in thresholds and value >= thresholds["mild_elevation_x3"]:
+            return "mild_high"
+        return None
+
+    # ── Context building ───────────────────────────────────────────────────
+
+    def build_panel_context(self, panel_code: str) -> str:
+        """Return a compact Arabic text summary of a panel's reference ranges."""
+        panel = self.get_panel(panel_code)
+        if not panel:
+            return ""
+        lines = [f"لوحة {panel.get('name_ar', panel_code)}:"]
+        for test_name, data in panel.get("tests", {}).items():
+            ranges = data.get("ranges", {})
+            adult = ranges.get("adult") or ranges.get("adult_male")
+            if adult:
+                lo, hi = adult.get("low", "?"), adult.get("high", "?")
+                unit = data.get("unit", "")
+                lines.append(f"  {test_name}: {lo}–{hi} {unit}")
+        return "\n".join(lines)

backend/medical_kb/reference/normal_ranges.py

@@ -0,0 +1,130 @@
+"""
+Fast in-memory normal range lookup.
+Used for runtime validation — faster than loading JSON schemas.
+"""
+from __future__ import annotations
+
+# (low, high) per gender key. Keys are lowercase, underscored.
+NORMAL_RANGES: dict[str, dict[str, tuple[float, float]]] = {
+    # CBC
+    "hemoglobin":    {"adult_male": (13.5, 17.5), "adult_female": (12.0, 15.5), "adult": (11.0, 17.5), "children": (11.5, 15.5)},
+    "hgb":           {"adult_male": (13.5, 17.5), "adult_female": (12.0, 15.5), "adult": (11.0, 17.5)},
+    "hb":            {"adult_male": (13.5, 17.5), "adult_female": (12.0, 15.5), "adult": (11.0, 17.5)},
+    "wbc":           {"adult": (4.0, 11.0), "children": (5.0, 15.0)},
+    "rbc":           {"adult_male": (4.5, 5.9), "adult_female": (4.0, 5.2), "adult": (4.0, 5.9)},
+    "platelets":     {"adult": (150.0, 400.0)},
+    "plt":           {"adult": (150.0, 400.0)},
+    "hematocrit":    {"adult_male": (41.0, 53.0), "adult_female": (36.0, 48.0), "adult": (36.0, 53.0)},
+    "hct":           {"adult_male": (41.0, 53.0), "adult_female": (36.0, 48.0), "adult": (36.0, 53.0)},
+    "mcv":           {"adult": (80.0, 100.0)},
+    "mch":           {"adult": (27.0, 33.0)},
+    "mchc":          {"adult": (32.0, 36.0)},
+    "neutrophils":   {"adult": (50.0, 70.0)},
+    "lymphocytes":   {"adult": (20.0, 40.0)},
+    "monocytes":     {"adult": (2.0, 8.0)},
+    "eosinophils":   {"adult": (1.0, 4.0)},
+    "basophils":     {"adult": (0.0, 1.0)},
+
+    # Thyroid
+    "tsh":           {"adult": (0.4, 4.0), "pregnant": (0.1, 2.5), "elderly": (0.4, 5.0)},
+    "ft4":           {"adult": (0.8, 1.8)},
+    "free_t4":       {"adult": (0.8, 1.8)},
+    "ft3":           {"adult": (2.3, 4.2)},
+    "free_t3":       {"adult": (2.3, 4.2)},
+    "anti_tpo":      {"adult": (0.0, 34.0)},
+    "anti-tpo":      {"adult": (0.0, 34.0)},
+
+    # Liver
+    "alt":           {"adult_male": (7.0, 40.0), "adult_female": (7.0, 35.0), "adult": (7.0, 40.0)},
+    "sgpt":          {"adult_male": (7.0, 40.0), "adult_female": (7.0, 35.0), "adult": (7.0, 40.0)},
+    "ast":           {"adult_male": (10.0, 40.0), "adult_female": (10.0, 35.0), "adult": (10.0, 40.0)},
+    "sgot":          {"adult_male": (10.0, 40.0), "adult_female": (10.0, 35.0), "adult": (10.0, 40.0)},
+    "alp":           {"adult": (44.0, 147.0), "children": (50.0, 350.0)},
+    "ggt":           {"adult_male": (8.0, 61.0), "adult_female": (5.0, 36.0), "adult": (5.0, 61.0)},
+    "bilirubin":     {"adult": (0.2, 1.2)},
+    "total_bilirubin":{"adult": (0.2, 1.2)},
+    "direct_bilirubin":{"adult": (0.0, 0.3)},
+    "albumin":       {"adult": (3.5, 5.0)},
+    "alb":           {"adult": (3.5, 5.0)},
+    "total_protein": {"adult": (6.0, 8.3)},
+
+    # Kidney
+    "creatinine":    {"adult_male": (0.7, 1.3), "adult_female": (0.5, 1.1), "adult": (0.5, 1.3)},
+    "bun":           {"adult": (8.0, 25.0)},
+    "urea":          {"adult": (15.0, 45.0)},
+    "uric_acid":     {"adult_male": (3.4, 7.0), "adult_female": (2.4, 6.0), "adult": (2.4, 7.0)},
+    "egfr":          {"adult": (60.0, 999.0)},
+
+    # Lipids
+    "cholesterol":   {"adult": (0.0, 200.0)},
+    "ldl":           {"adult": (0.0, 100.0)},
+    "hdl":           {"adult_male": (40.0, 999.0), "adult_female": (50.0, 999.0), "adult": (40.0, 999.0)},
+    "triglycerides": {"adult": (0.0, 150.0)},
+    "tg":            {"adult": (0.0, 150.0)},
+
+    # Diabetes
+    "glucose":       {"adult": (70.0, 99.0)},
+    "fasting_glucose":{"adult": (70.0, 99.0)},
+    "hba1c":         {"adult": (4.0, 5.6)},
+    "a1c":           {"adult": (4.0, 5.6)},
+
+    # Electrolytes
+    "sodium":        {"adult": (136.0, 145.0)},
+    "potassium":     {"adult": (3.5, 5.0)},
+    "chloride":      {"adult": (98.0, 106.0)},
+    "calcium":       {"adult": (8.5, 10.5)},
+    "magnesium":     {"adult": (1.7, 2.2)},
+    "phosphorus":    {"adult": (2.5, 4.5)},
+
+    # Iron studies
+    "ferritin":      {"adult_male": (24.0, 336.0), "adult_female": (11.0, 307.0), "adult": (11.0, 336.0)},
+    "iron":          {"adult": (60.0, 170.0)},
+    "tibc":          {"adult": (250.0, 370.0)},
+
+    # Vitamins
+    "vitamin_d":     {"adult": (20.0, 50.0)},
+    "vitamin_b12":   {"adult": (200.0, 900.0)},
+    "b12":           {"adult": (200.0, 900.0)},
+    "folate":        {"adult": (2.7, 17.0)},
+
+    # Inflammation
+    "crp":           {"adult": (0.0, 5.0)},
+    "esr":           {"adult_male": (0.0, 15.0), "adult_female": (0.0, 20.0), "adult": (0.0, 20.0)},
+
+    # Coagulation
+    "pt":            {"adult": (11.0, 13.5)},
+    "inr":           {"adult": (0.8, 1.2)},
+    "aptt":          {"adult": (25.0, 35.0)},
+
+    # Hormones
+    "prolactin":     {"adult_male": (2.0, 18.0), "adult_female": (2.0, 29.0), "adult": (2.0, 29.0)},
+    "testosterone":  {"adult_male": (300.0, 1000.0), "adult_female": (15.0, 70.0)},
+    "cortisol":      {"adult": (5.0, 23.0)},
+}
+
+
+def lookup(name: str, gender: str = "adult") -> tuple[float, float] | None:
+    """
+    Fast range lookup. Returns (low, high) or None.
+    name: test name (case-insensitive, spaces → underscores)
+    gender: 'adult', 'adult_male', 'adult_female', 'children', 'pregnant', 'elderly'
+    """
+    key = name.lower().strip().replace(" ", "_").replace("-", "_").replace("/", "_")
+    entry = NORMAL_RANGES.get(key)
+    if not entry:
+        return None
+    gender_key = f"adult_{gender}" if gender in ("male", "female") else gender
+    return entry.get(gender_key) or entry.get("adult")
+
+
+def classify(name: str, value: float, gender: str = "adult") -> str:
+    """Return 'low', 'normal', 'high', or 'unknown'."""
+    rng = lookup(name, gender)
+    if rng is None:
+        return "unknown"
+    lo, hi = rng
+    if value < lo:
+        return "low"
+    if value > hi:
+        return "high"
+    return "normal"

backend/medical_kb/schemas/cbc.json

@@ -0,0 +1,153 @@
+{
+  "panel_code": "cbc",
+  "name_ar": "صورة الدم الكاملة",
+  "name_en": "Complete Blood Count",
+  "specialty": "hematology",
+  "icd10_related": ["D50", "D51", "D52", "D53", "D64", "D69"],
+  "tests": {
+    "Hemoglobin": {
+      "name_ar": "هيموجلوبين",
+      "abbreviations": ["HGB", "Hgb", "Hb", "هيموجلوبين", "خضاب الدم"],
+      "unit": "g/dL",
+      "ranges": {
+        "adult_male":    {"low": 13.5, "high": 17.5},
+        "adult_female":  {"low": 12.0, "high": 15.5},
+        "children_6_12": {"low": 11.5, "high": 15.5},
+        "pregnant":      {"low": 11.0, "high": 14.0},
+        "elderly_male":  {"low": 12.5, "high": 17.0},
+        "elderly_female":{"low": 11.5, "high": 15.0}
+      },
+      "severity_thresholds": {
+        "critical_low": 7.0,
+        "severe_low": 8.0,
+        "mild_low_female": 11.0,
+        "mild_low_male": 12.5
+      },
+      "clinical_meaning_ar": "البروتين الذي يحمل الأكسجين في خلايا الدم الحمراء",
+      "high_causes_ar": ["الجفاف الشديد", "داء الكثرة الحمراء", "التدخين المزمن", "الإقامة في المرتفعات", "أمراض رئوية مزمنة"],
+      "low_causes_ar": ["نقص الحديد (الأكثر شيوعاً)", "نقص فيتامين B12", "نقص حمض الفوليك", "نزيف مزمن", "أمراض مزمنة (كلى، كبد)", "الثلاسيميا", "فقر الدم الانحلالي"],
+      "symptoms_low_ar": ["تعب وإرهاق غير معتاد", "شحوب الجلد والملتحمة", "ضيق تنفس عند المجهود", "خفقان وسرعة القلب", "دوخة وصداع", "برودة اليدين والقدمين", "هشاشة الأظافر وتساقط الشعر"],
+      "followup_tests": ["Ferritin", "Serum Iron", "TIBC", "Vitamin B12", "Folate", "Reticulocyte count", "Peripheral blood smear"],
+      "patient_explanation_ar": "الهيموجلوبين هو البروتين الحامل للأكسجين في دمك — مثل الحافلة التي تنقل الأكسجين من رئتيك لكل خلية في جسمك"
+    },
+    "WBC": {
+      "name_ar": "خلايا الدم البيضاء",
+      "abbreviations": ["WBC", "Leukocytes", "TLC", "كريات بيضاء", "كريات الدم البيضاء"],
+      "unit": "10³/μL",
+      "ranges": {
+        "adult":    {"low": 4.0, "high": 11.0},
+        "children": {"low": 5.0, "high": 15.0},
+        "neonates": {"low": 9.0, "high": 30.0}
+      },
+      "severity_thresholds": {
+        "critical_low": 2.0,
+        "severe_low": 3.0,
+        "critical_high": 30.0,
+        "leukocytosis": 11.0,
+        "leukopenia": 4.0
+      },
+      "clinical_meaning_ar": "خلايا الجهاز المناعي التي تقاوم العدوى والمرض",
+      "high_causes_ar": ["عدوى بكتيرية (الأكثر شيوعاً)", "الالتهابات الحادة", "الإجهاد الجسدي الشديد", "بعض الأدوية (كورتيكوستيرويد)", "سرطان الدم (نادراً)", "تدخين السجائر"],
+      "low_causes_ar": ["عدوى فيروسية (إنفلونزا، كوفيد)", "أمراض نقص المناعة", "أدوية الكيموثيرابي", "نقص B12 أو الفوليك", "أمراض المناعة الذاتية", "تليف نخاع العظم"],
+      "followup_tests": ["Differential count (Neutrophils, Lymphocytes, Eosinophils)", "Blood culture if infection suspected", "CBC with differential"],
+      "patient_explanation_ar": "خلايا الدم البيضاء هي جيش جهازك المناعي — تحارب الجراثيم والفيروسات وتحمي جسمك"
+    },
+    "RBC": {
+      "name_ar": "خلايا الدم الحمراء",
+      "abbreviations": ["RBC", "Erythrocytes", "كريات حمراء"],
+      "unit": "10⁶/μL",
+      "ranges": {
+        "adult_male":   {"low": 4.5, "high": 5.9},
+        "adult_female": {"low": 4.0, "high": 5.2}
+      },
+      "clinical_meaning_ar": "الخلايا الحاملة للهيموجلوبين والأكسجين",
+      "high_causes_ar": ["الجفاف", "داء الكثرة الحمراء", "التدخين"],
+      "low_causes_ar": ["فقر الدم", "النزيف", "نقص المغذيات"],
+      "patient_explanation_ar": "هي الخلايا الحمراء الصغيرة التي تحمل الأكسجين في مجرى الدم — كل واحدة تعيش حوالي 120 يوماً"
+    },
+    "Platelets": {
+      "name_ar": "الصفائح الدموية",
+      "abbreviations": ["PLT", "Thrombocytes", "صفائح", "صفيحات"],
+      "unit": "10³/μL",
+      "ranges": {
+        "adult": {"low": 150, "high": 400}
+      },
+      "severity_thresholds": {
+        "critical_low": 20,
+        "severe_low": 50,
+        "thrombocytopenia": 150,
+        "thrombocytosis": 400
+      },
+      "clinical_meaning_ar": "خلايا صغيرة تسبق تكوين جلطة الجرح وتوقف النزيف",
+      "high_causes_ar": ["ردّ فعل لالتهاب أو عدوى", "نقص الحديد", "استئصال الطحال", "نقاوي أولي (نادر)"],
+      "low_causes_ar": ["فشل نخاع العظم", "أمراض الكبد", "الأدوية (الهيبارين، بعض المضادات الحيوية)", "أمراض المناعة الذاتية (ITP)", "نقص B12"],
+      "danger_signs_ar": "< 50: خطر نزيف تلقائي — < 20: خطر نزيف داخلي طارئ",
+      "patient_explanation_ar": "الصفائح خلايا صغيرة جداً تجتمع عند الجرح لتشكّل سدادة طبيعية توقف النزيف"
+    },
+    "Hematocrit": {
+      "name_ar": "الهيماتوكريت",
+      "abbreviations": ["HCT", "PCV", "Hct"],
+      "unit": "%",
+      "ranges": {
+        "adult_male":   {"low": 41, "high": 53},
+        "adult_female": {"low": 36, "high": 48}
+      },
+      "clinical_meaning_ar": "نسبة حجم خلايا الدم الحمراء من الحجم الكلي للدم — يتحرك دائماً مع الهيموجلوبين",
+      "patient_explanation_ar": "لو فصلنا دمك في أنبوب — الهيماتوكريت هو نسبة الجزء الأحمر (الخلايا) من إجمالي الدم"
+    },
+    "MCV": {
+      "name_ar": "متوسط حجم الكريات الحمراء",
+      "abbreviations": ["MCV", "Mean Corpuscular Volume"],
+      "unit": "fL",
+      "ranges": {
+        "adult": {"low": 80, "high": 100}
+      },
+      "interpretation_guide": {
+        "microcytic_low": "< 80 fL: كريات صغيرة → نقص الحديد أو الثلاسيميا",
+        "normocytic": "80-100 fL: كريات طبيعية الحجم",
+        "macrocytic_high": "> 100 fL: كريات كبيرة → نقص B12 أو الفوليك"
+      },
+      "clinical_meaning_ar": "يُحدد نوع فقر الدم: صغير الحجم (حديدي) أو كبير الحجم (B12)",
+      "patient_explanation_ar": "يقيس حجم كل كرية دم حمراء — مفيد جداً لمعرفة سبب فقر الدم إذا وُجد"
+    },
+    "MCH": {
+      "name_ar": "متوسط كمية هيموجلوبين الكرية",
+      "abbreviations": ["MCH"],
+      "unit": "pg",
+      "ranges": {
+        "adult": {"low": 27, "high": 33}
+      },
+      "clinical_meaning_ar": "كمية الهيموجلوبين في كل خلية حمراء — يُكمل تفسير MCV"
+    },
+    "Neutrophils": {
+      "name_ar": "العدلات",
+      "abbreviations": ["NEU", "NEUT", "Neutrophils", "PMN", "نيتروفيل"],
+      "unit": "%",
+      "ranges": {
+        "adult": {"low": 50, "high": 70}
+      },
+      "clinical_meaning_ar": "أكثر خلايا الدم البيضاء شيوعاً — الخط الأول ضد العدوى البكتيرية",
+      "high_interpretation": "Neutrophilia (>70%) → bacterial infection / inflammation / steroid use",
+      "low_interpretation": "Neutropenia (<50%) → viral infection / bone marrow suppression"
+    },
+    "Lymphocytes": {
+      "name_ar": "الخلايا الليمفاوية",
+      "abbreviations": ["LYM", "LYMPH", "لمفاوية"],
+      "unit": "%",
+      "ranges": {
+        "adult": {"low": 20, "high": 40}
+      },
+      "clinical_meaning_ar": "تنتج الأجسام المضادة وتحفظ الذاكرة المناعية — ترتفع في العدوى الفيروسية"
+    },
+    "Eosinophils": {
+      "name_ar": "الحمضات",
+      "abbreviations": ["EOS", "Eosinophils", "حمضات"],
+      "unit": "%",
+      "ranges": {
+        "adult": {"low": 1, "high": 4}
+      },
+      "clinical_meaning_ar": "ترتفع في الحساسية والديدان الطفيلية",
+      "high_causes_ar": ["أمراض الحساسية (الربو، أكزيما)", "الديدان الطفيلية", "بعض الأدوية"]
+    }
+  }
+}

backend/medical_kb/schemas/diabetes.json

@@ -0,0 +1,128 @@
+{
+  "panel_code": "diabetes",
+  "name_ar": "سكري ومقاومة الإنسولين",
+  "name_en": "Diabetes & Glucose Metabolism Panel",
+  "specialty": "endocrinology",
+  "icd10_related": ["E11", "E10", "E13", "E14", "R73", "Z13.1"],
+  "tests": {
+    "Glucose": {
+      "name_ar": "سكر الدم الصيامي",
+      "abbreviations": ["FBS", "FBG", "Glucose", "Blood Sugar", "سكر الصيام", "سكر الدم"],
+      "unit": "mg/dL",
+      "ranges": {
+        "adult_normal":     {"low": 70.0, "high": 99.0},
+        "adult_prediabetes":{"low": 100.0, "high": 125.0},
+        "adult":            {"low": 70.0,  "high": 99.0},
+        "children":         {"low": 70.0,  "high": 100.0}
+      },
+      "severity_thresholds": {
+        "hypoglycemia_critical": 54.0,
+        "hypoglycemia": 70.0,
+        "normal_upper": 99.0,
+        "prediabetes_lower": 100.0,
+        "prediabetes_upper": 125.0,
+        "diabetes_diagnosis": 126.0,
+        "hyperglycemia_severe": 300.0,
+        "dka_risk": 400.0,
+        "critical_high": 600.0
+      },
+      "clinical_meaning_ar": "مستوى الجلوكوز في الدم بعد 8 ساعات صيام — المقياس الأساسي لتشخيص السكري",
+      "interpretation_matrix": {
+        "< 54 mg/dL":        "نقص سكر حاد — طارئ طبي فوري",
+        "54-69 mg/dL":       "نقص سكر — تناول جلوكوز فوراً",
+        "70-99 mg/dL":       "طبيعي",
+        "100-125 mg/dL":     "ما قبل السكري (Prediabetes) — تغيير نمط الحياة ضروري",
+        ">= 126 mg/dL":      "مشكوك بالسكري — يحتاج تأكيداً بفحص ثانٍ أو HbA1c",
+        ">= 300 mg/dL":      "ارتفاع شديد — خطر الحماض الكيتوني"
+      },
+      "high_causes_ar": ["مرض السكري النوع 1 أو 2", "ما قبل السكري", "الإجهاد الجسدي أو النفسي الشديد", "الكورتيزون والستيرويدات", "فرط نشاط الغدة الدرقية", "أمراض البنكرياس", "عدم الالتزام بالصيام قبل الفحص"],
+      "low_causes_ar": ["جرعة زائدة من الإنسولين أو أدوية السكري", "الصيام المطوّل", "ورم الأنسولين (Insulinoma)", "فشل الكبد الشديد", "قصور الغدة الكظرية"],
+      "symptoms_high_ar": ["عطش شديد وكثرة التبول", "تعب وضعف عام", "ضبابية الرؤية", "التئام بطيء للجروح", "تنميل في القدمين"],
+      "symptoms_low_ar": ["تعرق بارد ورجفة", "دوخة وضعف مفاجئ", "خفقان وتسارع القلب", "جوع شديد مفاجئ", "تشوش ذهني وتهيج"],
+      "followup_tests": ["HbA1c", "Fasting Insulin", "C-Peptide", "HOMA-IR", "Urine Microalbumin", "Lipid Panel"],
+      "patient_explanation_ar": "سكر الصيام مثل فحص درجة حرارة محرك سيارتك وهي باردة — يُظهر كيف يتعامل جسمك مع الجلوكوز في وضع الراحة"
+    },
+    "HbA1c": {
+      "name_ar": "الهيموجلوبين السكري التراكمي",
+      "abbreviations": ["HbA1c", "A1C", "Glycated Hemoglobin", "سكر تراكمي", "الجليكوزيلاتد"],
+      "unit": "%",
+      "ranges": {
+        "adult_normal":     {"low": 4.0, "high": 5.6},
+        "adult_prediabetes":{"low": 5.7, "high": 6.4},
+        "adult":            {"low": 4.0, "high": 5.6},
+        "diabetic_target":  {"low": 0.0, "high": 7.0}
+      },
+      "severity_thresholds": {
+        "normal": 5.6,
+        "prediabetes_lower": 5.7,
+        "prediabetes_upper": 6.4,
+        "diabetes_diagnosis": 6.5,
+        "good_control_diabetic": 7.0,
+        "poor_control": 8.0,
+        "very_poor_control": 10.0,
+        "critical": 14.0
+      },
+      "clinical_meaning_ar": "يعكس متوسط سكر الدم خلال الـ 90 يوم الماضية — لأن الهيموجلوبين يرتبط بالجلوكوز طوال عمر خلية الدم الحمراء",
+      "interpretation_matrix": {
+        "< 5.7%":    "طبيعي — لا سكري",
+        "5.7-6.4%":  "ما قبل السكري — خطر تطور السكري، تغيير نمط الحياة مطلوب",
+        ">= 6.5%":   "سكري — يحتاج تأكيداً أو علاجاً",
+        "< 7% (مريض سكري)":  "ضبط جيد للسكري",
+        "7-8% (مريض سكري)":  "ضبط مقبول — تعديل العلاج",
+        "> 8% (مريض سكري)":  "ضبط سيئ — خطر مضاعفات عالٍ",
+        "> 10%":     "ضبط خطير جداً — مراجعة فورية"
+      },
+      "high_causes_ar": ["مرض السكري غير المُسيطر عليه", "عدم الالتزام بالدواء أو الحمية", "فقر الدم الانحلالي (يُعطي قراءة كاذبة منخفضة)", "مرض الكلى المزمن (يرفع القراءة)"],
+      "low_causes_ar": ["فقر الدم الانحلالي (تُسرَّع خلايا الدم الحمراء — قراءة كاذبة منخفضة)", "نقص الحديد (قراءة كاذبة)", "تهيج خلايا الدم الحمراء"],
+      "followup_tests": ["Fasting Glucose", "Post-meal Glucose", "Fasting Insulin", "C-Peptide", "Kidney Function", "Lipid Panel", "Urine Microalbumin"],
+      "patient_explanation_ar": "HbA1c مثل كاميرا مُراقبة تسجّل سكرك لمدة 3 أشهر — بعكس سكر الصيام اليومي الذي يتأثر بيوم واحد"
+    },
+    "Insulin": {
+      "name_ar": "الإنسولين الصيامي",
+      "abbreviations": ["Insulin", "Fasting Insulin", "إنسولين", "انسولين"],
+      "unit": "µIU/mL",
+      "ranges": {
+        "adult": {"low": 2.0, "high": 25.0},
+        "adult_optimal": {"low": 2.0, "high": 10.0}
+      },
+      "severity_thresholds": {
+        "optimal_upper": 10.0,
+        "normal_upper": 25.0,
+        "insulin_resistance_risk": 15.0,
+        "high": 30.0,
+        "critical_low": 1.0
+      },
+      "clinical_meaning_ar": "هرمون يُفرزه البنكرياس لإدخال الجلوكوز للخلايا — ارتفاعه الصيامي يشير لمقاومة الإنسولين",
+      "high_causes_ar": ["مقاومة الإنسولين (السكري النوع 2 المبكر)", "السمنة خاصةً الدهون البطنية", "متلازمة تكيس المبايض PCOS", "الخمول الجسدي", "ورم الأنسولين (Insulinoma) — نادر"],
+      "low_causes_ar": ["السكري النوع 1 (لا يُفرز البنكرياس كافياً)", "البنكرياس المتلف", "جرعة زائدة من أدوية السكري"],
+      "symptoms_high_ar": ["زيادة وزن مستمرة رغم الحمية", "تعب بعد الوجبات", "رغبة شديدة في الحلويات", "صعوبة خسارة الوزن", "أعراض PCOS عند النساء"],
+      "followup_tests": ["HOMA-IR", "HbA1c", "Fasting Glucose", "C-Peptide", "Testosterone (للنساء)", "Lipid Panel"],
+      "patient_explanation_ar": "الإنسولين مثل مفتاح يفتح خلاياك للجلوكوز — عندما ترتفع مستوياته صيامياً، يعني الأقفال بدأت تقاوم المفتاح"
+    },
+    "HOMA_IR": {
+      "name_ar": "مؤشر مقاومة الإنسولين",
+      "abbreviations": ["HOMA-IR", "Insulin Resistance", "HOMA IR", "مقاومة الإنسولين"],
+      "unit": "حاصل",
+      "ranges": {
+        "adult_normal": {"low": 0.0, "high": 2.0},
+        "adult":        {"low": 0.0, "high": 2.0}
+      },
+      "severity_thresholds": {
+        "normal": 2.0,
+        "borderline": 2.5,
+        "insulin_resistance": 3.0,
+        "severe": 5.0
+      },
+      "clinical_meaning_ar": "يُحسب من (الإنسولين × سكر الصيام) ÷ 405 — يقيس درجة مقاومة الإنسولين",
+      "interpretation_matrix": {
+        "HOMA-IR < 2.0":   "حساسية إنسولين طبيعية",
+        "HOMA-IR 2.0-2.9": "مقاومة إنسولين حدية — انتبه للنمط الغذائي والحركة",
+        "HOMA-IR >= 3.0":  "مقاومة إنسولين — خطر سكري النوع 2 ومتلازمة الأيض",
+        "HOMA-IR >= 5.0":  "مقاومة إنسولين شديدة — تدخل طبي ضروري"
+      },
+      "high_causes_ar": ["السمنة خاصةً الدهون البطنية", "الخمول الجسدي", "متلازمة الأيض", "PCOS", "النوم المضطرب وتوقف التنفس أثناء النوم", "النظام الغذائي الغني بالسكريات"],
+      "followup_tests": ["Fasting Glucose", "Insulin", "HbA1c", "Lipid Panel", "ALT (NAFLD)", "Testosterone (PCOS)"],
+      "patient_explanation_ar": "HOMA-IR رقم مُحسوب يُظهر مدى قدرة جسمك على الاستجابة للإنسولين — كلما ارتفع، كلما كان جسمك يقاوم التعليمات أكثر"
+    }
+  }
+}

backend/medical_kb/schemas/kidney.json

@@ -0,0 +1,110 @@
+{
+  "panel_code": "kidney",
+  "name_ar": "وظائف الكلى",
+  "name_en": "Kidney Function Tests",
+  "specialty": "nephrology",
+  "icd10_related": ["N17", "N18", "N19", "N28", "E11.65"],
+  "tests": {
+    "Creatinine": {
+      "name_ar": "كرياتينين",
+      "abbreviations": ["Cr", "Creat", "كرياتينين"],
+      "unit": "mg/dL",
+      "ranges": {
+        "adult_male":   {"low": 0.7, "high": 1.3},
+        "adult_female": {"low": 0.5, "high": 1.1},
+        "adult":        {"low": 0.5, "high": 1.3},
+        "children":     {"low": 0.3, "high": 0.7},
+        "elderly_male": {"low": 0.7, "high": 1.4},
+        "elderly_female":{"low": 0.5, "high": 1.2}
+      },
+      "severity_thresholds": {
+        "critical_high": 10.0,
+        "severe_high": 5.0,
+        "moderate_high": 2.0,
+        "ckd_stage3": 2.0,
+        "ckd_stage4": 4.0
+      },
+      "clinical_meaning_ar": "نفاية عضلية تُفرز عبر الكلى — مؤشر مباشر لكفاءة الترشيح الكلوي",
+      "high_causes_ar": ["الفشل الكلوي الحاد أو المزمن", "الجفاف الشديد", "انسداد المسالك البولية", "الرياضة المكثفة", "ارتفاع تناول البروتين", "أدوية سامة للكلى (NSAIDs, أمينوغليكوزيد)", "رابدوميوليسيس (تحلل العضلات)"],
+      "low_causes_ar": ["ضمور العضلات أو فقدان الكتلة العضلية", "سوء التغذية الشديد", "الحمل (بسبب زيادة معدل الترشيح)", "كبار السن بكتلة عضلية قليلة"],
+      "symptoms_high_ar": ["انخفاض كمية البول أو توقفها", "تورم الأطراف والوجه", "غثيان وقيء", "تعب شديد وضعف عام", "ضيق تنفس", "تشوش ذهني في الحالات الشديدة"],
+      "followup_tests": ["eGFR", "BUN", "Urine Creatinine", "Urine Protein", "Electrolytes", "Urinalysis", "Kidney Ultrasound"],
+      "patient_explanation_ar": "الكرياتينين مثل مقياس دقة مرشّح الكلى — كلما ارتفع، كلما كان المرشّح أقل كفاءة"
+    },
+    "BUN": {
+      "name_ar": "نيتروجين يوريا الدم",
+      "abbreviations": ["BUN", "Blood Urea Nitrogen", "يوريا"],
+      "unit": "mg/dL",
+      "ranges": {
+        "adult": {"low": 8.0, "high": 25.0},
+        "elderly": {"low": 8.0, "high": 30.0},
+        "children": {"low": 5.0, "high": 18.0}
+      },
+      "severity_thresholds": {
+        "critical_high": 100.0,
+        "severe_high": 60.0,
+        "moderate_high": 40.0,
+        "uremia_risk": 80.0
+      },
+      "clinical_meaning_ar": "نفاية التحلل البروتيني تُفرز عبر الكلى — يرتفع مع الفشل الكلوي وارتفاع البروتين",
+      "high_causes_ar": ["الفشل الكلوي", "الجفاف", "نزيف الجهاز الهضمي العلوي", "ارتفاع تناول البروتين", "الحمى والإجهاد الشديد", "فشل القلب الاحتقاني"],
+      "low_causes_ar": ["سوء التغذية (نقص البروتين)", "أمراض الكبد الشديدة (يعيق تصنيع اليوريا)", "الحمل", "الإفراط في شرب السوائل"],
+      "symptoms_high_ar": ["غثيان وفقدان الشهية", "تعب وضعف", "حكة جلدية في الحالات الشديدة", "تشوش ذهني (يوريمية)"],
+      "followup_tests": ["Creatinine", "BUN/Creatinine ratio", "eGFR", "Urinalysis"],
+      "patient_explanation_ar": "BUN هو بقايا هضم البروتين — الكلية السليمة تُزيله بكفاءة، فإذا ارتفع يعني الكلية تتعب"
+    },
+    "eGFR": {
+      "name_ar": "معدل الترشيح الكبيبي المقدّر",
+      "abbreviations": ["eGFR", "GFR", "معدل الترشيح"],
+      "unit": "mL/min/1.73m²",
+      "ranges": {
+        "adult": {"low": 60.0, "high": 999.0},
+        "young_adult": {"low": 90.0, "high": 999.0}
+      },
+      "severity_thresholds": {
+        "ckd_stage1": 90.0,
+        "ckd_stage2": 60.0,
+        "ckd_stage3a": 45.0,
+        "ckd_stage3b": 30.0,
+        "ckd_stage4": 15.0,
+        "ckd_stage5_dialysis": 15.0,
+        "critical_low": 10.0
+      },
+      "clinical_meaning_ar": "يقيس مدى قدرة الكلية على ترشيح الدم في الدقيقة — المقياس الذهبي لوظيفة الكلى",
+      "interpretation_matrix": {
+        "eGFR >= 90": "وظيفة كلوية طبيعية (CKD Stage 1 إذا كان مع علامات كلوية أخرى)",
+        "eGFR 60-89": "انخفاض طفيف — CKD Stage 2، تحتاج متابعة",
+        "eGFR 45-59": "انخفاض خفيف-معتدل — CKD Stage 3a، تعديل جرعات الأدوية",
+        "eGFR 30-44": "انخفاض معتدل-شديد — CKD Stage 3b، متابعة أمراض الكلى",
+        "eGFR 15-29": "انخفاض شديد — CKD Stage 4، التحضير للديلزة",
+        "eGFR < 15":  "فشل كلوي — CKD Stage 5، ديلزة أو زراعة كلى"
+      },
+      "low_causes_ar": ["مرض الكلى المزمن", "مرض السكري (اعتلال الكلية السكري)", "ارتفاع ضغط الدم المزمن", "التهاب الكلية", "انسداد المسالك البولية المزمن", "أدوية سامة للكلى"],
+      "followup_tests": ["Creatinine", "Urine Albumin/Creatinine ratio", "Electrolytes", "Phosphorus", "PTH", "Hemoglobin"],
+      "patient_explanation_ar": "eGFR يخبرك كم في المئة من كلاوي تعمل — 100% طبيعي، أقل من 15% تحتاج ديلزة"
+    },
+    "Uric_Acid": {
+      "name_ar": "حمض اليوريك",
+      "abbreviations": ["UA", "Uric Acid", "حمض البول", "يورك"],
+      "unit": "mg/dL",
+      "ranges": {
+        "adult_male":   {"low": 3.4, "high": 7.0},
+        "adult_female": {"low": 2.4, "high": 6.0},
+        "adult":        {"low": 2.4, "high": 7.0},
+        "children":     {"low": 2.0, "high": 5.5}
+      },
+      "severity_thresholds": {
+        "hyperuricemia_male": 7.0,
+        "hyperuricemia_female": 6.0,
+        "gout_risk": 8.0,
+        "critical_high": 12.0
+      },
+      "clinical_meaning_ar": "نفاية تحلل البورينات — يتراكم في المفاصل مسبباً النقرس عند ارتفاعه",
+      "high_causes_ar": ["النقرس (Gout)", "الفشل الكلوي", "الجفاف", "ارتفاع تناول الفركتوز واللحوم الحمراء", "بعض أدوية ضغط الدم (ثيازيد)", "كيموثيرابيا (تحلل الخلايا السرطانية)", "السمنة"],
+      "low_causes_ar": ["سوء التغذية", "أمراض الكبد الشديدة", "بعض الأدوية (الوبيورينول)", "نقص إنزيم Xanthine Oxidase (نادر)"],
+      "symptoms_high_ar": ["ألم مفاجئ وشديد في إبهام القدم (النقرس)", "احمرار وتورم المفاصل", "حصى الكلى (حمض اليوريك)", "ألم أسفل الظهر"],
+      "followup_tests": ["24hr Urine Uric Acid", "Creatinine", "eGFR", "Joint X-Ray"],
+      "patient_explanation_ar": "حمض اليوريك مثل رمل يتراكم في المفاصل — عندما يزيد يسبب نوبة ألم شديدة تُسمى النقرس"
+    }
+  }
+}

backend/medical_kb/schemas/lipid.json

@@ -0,0 +1,105 @@
+{
+  "panel_code": "lipid",
+  "name_ar": "الدهون والكوليسترول",
+  "name_en": "Lipid Panel",
+  "specialty": "cardiology",
+  "icd10_related": ["E78", "E78.0", "E78.1", "E78.2", "E78.5", "I25"],
+  "tests": {
+    "Cholesterol": {
+      "name_ar": "الكوليسترول الكلي",
+      "abbreviations": ["TC", "Total Cholesterol", "كوليسترول", "كولسترول"],
+      "unit": "mg/dL",
+      "ranges": {
+        "adult": {"low": 0.0, "high": 200.0},
+        "borderline": {"low": 200.0, "high": 239.0},
+        "high_risk": {"low": 240.0, "high": 999.0}
+      },
+      "severity_thresholds": {
+        "desirable": 200.0,
+        "borderline_high": 239.0,
+        "high": 240.0,
+        "very_high": 300.0,
+        "critical_high": 400.0
+      },
+      "clinical_meaning_ar": "إجمالي الكوليسترول في الدم — يشمل LDL و HDL والأنواع الأخرى",
+      "high_causes_ar": ["النظام الغذائي الغني بالدهون المشبعة والمتحولة", "الوراثة (فرط كوليسترول الدم العائلي)", "قصور الغدة الدرقية", "مرض السكري غير المُسيطر عليه", "أمراض الكلى المزمنة", "بعض الأدوية (كورتيكوستيرويد، مدرات البول)"],
+      "low_causes_ar": ["سوء التغذية الشديد", "فرط نشاط الغدة الدرقية", "أمراض الكبد الشديدة", "فقر الدم الشديد"],
+      "symptoms_high_ar": ["عادةً بلا أعراض حتى حدوث مضاعفات", "ألم في الصدر (ذبحة صدرية)", "ألم الساقين عند المشي", "زانثوما (رواسب دهنية على الجلد في الحالات الشديدة)"],
+      "followup_tests": ["LDL", "HDL", "Triglycerides", "TSH", "Fasting Glucose", "HbA1c"],
+      "patient_explanation_ar": "الكوليسترول الكلي مثل مجموع رصيدك — لكن المهم توزيعه: هل هو كوليسترول جيد أم سيء"
+    },
+    "LDL": {
+      "name_ar": "الكوليسترول الضار",
+      "abbreviations": ["LDL", "LDL-C", "كوليسترول LDL", "الكوليسترول الضار"],
+      "unit": "mg/dL",
+      "ranges": {
+        "adult_optimal": {"low": 0.0, "high": 100.0},
+        "adult_near_optimal": {"low": 100.0, "high": 129.0},
+        "adult_borderline": {"low": 130.0, "high": 159.0},
+        "adult": {"low": 0.0, "high": 100.0}
+      },
+      "severity_thresholds": {
+        "optimal": 100.0,
+        "near_optimal": 129.0,
+        "borderline_high": 159.0,
+        "high": 189.0,
+        "very_high": 190.0,
+        "target_high_risk_patient": 70.0
+      },
+      "clinical_meaning_ar": "الكوليسترول السيء — يترسب على جدران الشرايين مسبباً تصلب الشرايين وأمراض القلب",
+      "high_causes_ar": ["النظام الغذائي الغني بالدهون المشبعة", "الوراثة", "قصور الغدة الدرقية", "السمنة والخمول الجسدي", "مرض السكري", "التدخين"],
+      "low_causes_ar": ["استخدام أدوية الستاتين", "النظام الغذائي النباتي", "فرط نشاط الغدة الدرقية"],
+      "symptoms_high_ar": ["لا أعراض مباشرة", "على المدى البعيد: نوبة قلبية، سكتة دماغية، ضعف في الأطراف"],
+      "followup_tests": ["Total Cholesterol", "HDL", "Triglycerides", "hs-CRP", "Coronary Calcium Score"],
+      "patient_explanation_ar": "LDL هو الكوليسترول السيء — يُكدّس الترسبات في الشرايين مثل الصدأ في الأنابيب"
+    },
+    "HDL": {
+      "name_ar": "الكوليسترول الجيد",
+      "abbreviations": ["HDL", "HDL-C", "كوليسترول HDL", "الكوليسترول الجيد"],
+      "unit": "mg/dL",
+      "ranges": {
+        "adult_male":   {"low": 40.0, "high": 999.0},
+        "adult_female": {"low": 50.0, "high": 999.0},
+        "adult":        {"low": 40.0, "high": 999.0},
+        "optimal":      {"low": 60.0, "high": 999.0}
+      },
+      "severity_thresholds": {
+        "low_risk_male": 40.0,
+        "low_risk_female": 50.0,
+        "protective_high": 60.0,
+        "critical_low": 30.0
+      },
+      "clinical_meaning_ar": "الكوليسترول الجيد — يُزيل الكوليسترول الزائد من الشرايين ويعيده للكبد للتخلص منه",
+      "low_causes_ar": ["التدخين", "السمنة وقلة الحركة", "مرض السكري غير المُسيطر عليه", "الدهون الثلاثية المرتفعة جداً", "النظام الغذائي الغني بالكربوهيدرات المُكررة", "بعض الأدوية (بيتا بلوكر، ستيرويد)"],
+      "high_causes_ar": ["ممارسة الرياضة المنتظمة", "الإقلاع عن التدخين", "الدهون الأحادية غير ��لمشبعة (زيت الزيتون)", "الكحول باعتدال (غير موصى به طبياً)"],
+      "symptoms_low_ar": ["لا أعراض مباشرة للانخفاض", "على المدى البعيد: زيادة خطر أمراض القلب"],
+      "followup_tests": ["Total Cholesterol", "LDL", "Triglycerides", "Fasting Glucose"],
+      "patient_explanation_ar": "HDL هو الكوليسترول الجيد — يعمل كمكنسة تُزيل الكوليسترول الزائد من الشرايين. كلما ارتفع، كان أفضل"
+    },
+    "Triglycerides": {
+      "name_ar": "الدهون الثلاثية",
+      "abbreviations": ["TG", "TRIG", "Triglycerides", "دهون ثلاثية", "ثلاثيات الغليسريد"],
+      "unit": "mg/dL",
+      "ranges": {
+        "adult_normal":     {"low": 0.0,   "high": 150.0},
+        "adult_borderline": {"low": 150.0, "high": 199.0},
+        "adult_high":       {"low": 200.0, "high": 499.0},
+        "adult":            {"low": 0.0,   "high": 150.0}
+      },
+      "severity_thresholds": {
+        "normal": 150.0,
+        "borderline": 199.0,
+        "high": 499.0,
+        "very_high": 500.0,
+        "pancreatitis_risk": 1000.0,
+        "critical": 2000.0
+      },
+      "clinical_meaning_ar": "الدهون الرئيسية المُخزَّنة في الجسم — ترتفع مع السكريات والكحول والخمول",
+      "high_causes_ar": ["النظام الغذائي الغني بالسكريات والكربوهيدرات المُكررة", "السمنة والخمول", "مرض السكري غير المُسيطر عليه", "الكحول", "قصور الغدة الدرقية", "الفشل الكلوي", "بعض الأدوية (ستيرويد، بيتا بلوكر)"],
+      "low_causes_ar": ["النظام الغذائي المنخفض الدهون والكربوهيدرات", "فرط نشاط الغدة الدرقية"],
+      "symptoms_high_ar": ["لا أعراض عادةً", "في الحالات الشديدة جداً: ألم البطن (التهاب البنكرياس)", "طفح جلدي دهني (زانثوما صفراء)", "ضبابية الدم (lipemia retinalis)"],
+      "followup_tests": ["Total Cholesterol", "LDL", "HDL", "Fasting Glucose", "HbA1c", "TSH"],
+      "patient_explanation_ar": "الدهون الثلاثية هي طاقة مُخزَّنة — ترتفع عندما تأكل سكريات أكثر مما يحتاجه جسمك"
+    }
+  }
+}

backend/medical_kb/schemas/liver.json

@@ -0,0 +1,145 @@
+{
+  "panel_code": "liver",
+  "name_ar": "وظائف الكبد",
+  "name_en": "Liver Function Tests",
+  "specialty": "hepatology",
+  "icd10_related": ["K70", "K71", "K72", "K73", "K74", "K75", "K76", "B15", "B16", "B17", "B18"],
+  "interpretation_axis": "Evaluate in 3 dimensions: hepatocellular (ALT/AST) + cholestatic (ALP/GGT/Bili) + synthetic (Albumin/PT)",
+  "tests": {
+    "ALT": {
+      "name_ar": "ناقلة أمين الألانين",
+      "abbreviations": ["ALT", "SGPT", "ALT/SGPT", "Alanine Aminotransferase"],
+      "unit": "U/L",
+      "ranges": {
+        "adult_male":   {"low": 7,  "high": 40},
+        "adult_female": {"low": 7,  "high": 35}
+      },
+      "severity_thresholds": {
+        "mild_elevation_x3":    120,
+        "moderate_elevation_x10": 400,
+        "severe_elevation":     1000,
+        "acute_liver_failure":  3000
+      },
+      "clinical_meaning_ar": "الإنزيم الأكثر تخصصاً لخلايا الكبد — ارتفاعه يدل على تلفها مباشرةً",
+      "high_causes_ar": [
+        "الكبد الدهني غير الكحولي (NAFLD) — الأكثر شيوعاً",
+        "التهاب الكبد الفيروسي (B وC وA)",
+        "التهاب الكبد الكحولي",
+        "الأدوية (باراسيتامول، ستاتينات، مضادات حيوية)",
+        "انسداد القنوات الصفراوية",
+        "قصور القلب (كبد احتقاني)"
+      ],
+      "severity_interpretation": {
+        "1_3x": "ارتفاع خفيف — متابعة وتغيير نمط الحياة",
+        "3_10x": "ارتفاع متوسط — تقييم طبي عاجل لتحديد السبب",
+        "above_10x": "⚠️ ارتفاع شديد — تلف كبدي حاد يستدعي طوارئ"
+      },
+      "followup_tests": ["AST", "GGT", "ALP", "Bilirubin", "Albumin", "PT/INR", "Viral hepatitis panel (HBsAg, Anti-HCV)", "Liver ultrasound"],
+      "patient_explanation_ar": "ALT إنزيم يُفرز من داخل خلايا الكبد عند تلفها — كلما ارتفع أكثر كلما كان التلف أشد"
+    },
+    "AST": {
+      "name_ar": "ناقلة أمين الأسبارتات",
+      "abbreviations": ["AST", "SGOT", "Aspartate Aminotransferase"],
+      "unit": "U/L",
+      "ranges": {
+        "adult_male":   {"low": 10, "high": 40},
+        "adult_female": {"low": 10, "high": 35}
+      },
+      "clinical_meaning_ar": "أقل تخصصاً للكبد من ALT — يرتفع أيضاً مع أمراض القلب والعضلات",
+      "ast_alt_ratio": {
+        "ratio_2_to_1": "AST:ALT > 2:1 → يشير للتلف الكحولي بشكل خاص",
+        "alt_dominant": "ALT > AST → يشير لالتهاب فيروسي أو دهني",
+        "both_equal":   "ارتفاع متساوٍ → التهاب غير محدد"
+      },
+      "patient_explanation_ar": "AST موجود في الكبد والقلب والعضلات — ارتفاعه وحده لا يعني بالضرورة مشكلة كبدية"
+    },
+    "ALP": {
+      "name_ar": "الفوسفاتاز القلوية",
+      "abbreviations": ["ALP", "Alkaline Phosphatase", "فوسفاتاز"],
+      "unit": "U/L",
+      "ranges": {
+        "adult":    {"low": 44, "high": 147},
+        "children": {"low": 50, "high": 350},
+        "pregnant": {"low": 40, "high": 300}
+      },
+      "clinical_meaning_ar": "يرتفع مع انسداد القنوات الصفراوية وأمراض العظام — يُقيَّم مع GGT",
+      "high_causes_ar": [
+        "انسداد القنوات الصفراوية (حصى، ورم)",
+        "تليف الكبد الصفراوي الأولي (PBC)",
+        "أمراض العظام (داء بيجيت، كسور، ورم عظمي)",
+        "نمو طبيعي عند الأطفال والمراهقين",
+        "الثلث الثالث من الحمل (طبيعي)"
+      ],
+      "interpretation_with_GGT": "ALP مرتفع + GGT مرتفع → سبب كبدي/صفراوي | ALP مرتفع + GGT طبيعي → سبب عظمي",
+      "patient_explanation_ar": "هذا الإنزيم يوجد في الكبد وقنوات الصفراء والعظام — ارتفاعه يحتاج تفسيراً مع GGT"
+    },
+    "GGT": {
+      "name_ar": "غاما غلوتاميل ترانسفيراز",
+      "abbreviations": ["GGT", "Gamma-GT", "Gamma-Glutamyl Transferase"],
+      "unit": "U/L",
+      "ranges": {
+        "adult_male":   {"low": 8,  "high": 61},
+        "adult_female": {"low": 5,  "high": 36}
+      },
+      "clinical_meaning_ar": "أحساس مؤشر لأمراض الكبد الكحولية والانسداد الصفراوي — يساعد في تفسير ALP",
+      "high_causes_ar": ["الكحول (الأكثر تأثيراً)", "الكبد الدهني", "انسداد صفراوي", "أدوية معينة (فينيتوين، فاروفارين)"],
+      "diagnostic_value": "إذا ارتفع ALP مع ارتفاع GGT → مصدر ��لكبد. إذا ارتفع GGT وحده → غالباً الكحول أو الأدوية"
+    },
+    "Bilirubin_Total": {
+      "name_ar": "البيليروبين الكلي",
+      "abbreviations": ["T.Bili", "Total Bilirubin", "بيليروبين كلي", "TBIL"],
+      "unit": "mg/dL",
+      "ranges": {
+        "adult": {"low": 0.2, "high": 1.2}
+      },
+      "severity_thresholds": {
+        "visible_jaundice": 2.5,
+        "moderate_jaundice": 5.0,
+        "severe_jaundice": 15.0
+      },
+      "clinical_meaning_ar": "صبغة ناتجة عن تكسّر الهيموجلوبين — يعالجه الكبد ويُفرزه في الصفراء",
+      "high_causes_ar": [
+        "التهاب الكبد الفيروسي",
+        "انسداد القنوات الصفراوية (حصى مرارة)",
+        "فقر الدم الانحلالي (تكسّر الدم)",
+        "متلازمة جيلبرت (حميدة — ترتفع مع الإجهاد والجوع)",
+        "تليف الكبد المتقدم"
+      ],
+      "patient_explanation_ar": "البيليروبين صبغة صفراء — عندما يرتفع يظهر اليرقان (اصفرار الجلد والعيون)"
+    },
+    "Bilirubin_Direct": {
+      "name_ar": "البيليروبين المباشر",
+      "abbreviations": ["D.Bili", "Direct Bilirubin", "Conjugated Bilirubin"],
+      "unit": "mg/dL",
+      "ranges": {
+        "adult": {"low": 0.0, "high": 0.3}
+      },
+      "clinical_meaning_ar": "البيليروبين المُعالَج من الكبد — ارتفاعه تحديداً يشير لمشكلة في الكبد أو الصفراء",
+      "interpretation": "Direct Bili > 50% من Total Bili → انسداد صفراوي أو أمراض الكبد الداخلية"
+    },
+    "Albumin": {
+      "name_ar": "الألبومين",
+      "abbreviations": ["ALB", "Albumin", "ألبومين"],
+      "unit": "g/dL",
+      "ranges": {
+        "adult": {"low": 3.5, "high": 5.0}
+      },
+      "severity_thresholds": {
+        "mild_low": 3.0,
+        "moderate_low": 2.5,
+        "severe_low": 2.0
+      },
+      "clinical_meaning_ar": "البروتين الأكثر إنتاجاً من الكبد — يعكس القدرة التركيبية للكبد وحالة التغذية",
+      "high_causes_ar": ["الجفاف (نسبياً)"],
+      "low_causes_ar": [
+        "قصور الكبد المزمن أو التليف",
+        "سوء التغذية الشديد",
+        "متلازمة الكلاء (فقدان الألبومين في البول)",
+        "الالتهاب الحاد والمزمن",
+        "سوء الامتصاص"
+      ],
+      "clinical_importance": "الألبومين المنخفض هو من أقوى مؤشرات ضعف وظيفة الكبد التركيبية",
+      "patient_explanation_ar": "الألبومين بروتين يصنعه كبدك ويضخه للدم — انخفاضه دليل على أن الكبد يعمل بكفاءة أقل"
+    }
+  }
+}

backend/medical_kb/schemas/thyroid.json

@@ -0,0 +1,94 @@
+{
+  "panel_code": "thyroid",
+  "name_ar": "وظائف الغدة الدرقية",
+  "name_en": "Thyroid Function Tests",
+  "specialty": "endocrinology",
+  "icd10_related": ["E00", "E01", "E02", "E03", "E04", "E05", "E06"],
+  "interpretation_axis": "Always start from TSH — it is the most sensitive indicator",
+  "tests": {
+    "TSH": {
+      "name_ar": "الهرمون المحفز للغدة الدرقية",
+      "abbreviations": ["TSH", "Thyroid Stimulating Hormone", "ثيروتروبين"],
+      "unit": "mIU/L",
+      "ranges": {
+        "adult":        {"low": 0.4,  "high": 4.0},
+        "pregnant_T1":  {"low": 0.1,  "high": 2.5},
+        "pregnant_T2":  {"low": 0.2,  "high": 3.0},
+        "pregnant_T3":  {"low": 0.3,  "high": 3.0},
+        "elderly":      {"low": 0.4,  "high": 5.0},
+        "children_1_6": {"low": 0.8,  "high": 6.0},
+        "neonates":     {"low": 1.0,  "high": 20.0}
+      },
+      "severity_thresholds": {
+        "critical_low": 0.01,
+        "suppressed": 0.1,
+        "subclinical_high": 4.0,
+        "overt_high": 10.0
+      },
+      "clinical_meaning_ar": "هرمون النخامية الذي يتحكم في نشاط الغدة الدرقية — المؤشر الأول والأحساس",
+      "high_causes_ar": ["قصور الغدة الدرقية الأولي (هاشيموتو الأكثر شيوعاً)", "قصور ما بعد الولادة", "التهاب الغدة الدرقية تحت الحاد", "نقص اليود الشديد"],
+      "low_causes_ar": ["فرط نشاط الغدة الدرقية (مرض جريفز الأكثر شيوعاً)", "عقيدات درقية فاعلة", "التهاب الغدة الدرقية الصامت", "جرعة زائدة من الليفوثيروكسين"],
+      "interpretation_matrix": {
+        "TSH_high_FT4_low":    "قصور درقي أولي — يحتاج ليفوثيروكسين",
+        "TSH_low_FT4_high":    "فرط نشاط درقي واضح — يحتاج تقييماً متخصصاً عاجلاً",
+        "TSH_high_FT4_normal": "قصور تحت سريري — متابعة كل 3-6 أشهر",
+        "TSH_low_FT4_normal":  "فرط نشاط تحت سريري — متابعة، علاج إذا ≥ 65 عاماً أو أعراض"
+      },
+      "followup_tests": ["Free T4", "Free T3", "Anti-TPO", "Anti-Thyroglobulin", "Thyroid ultrasound"],
+      "patient_explanation_ar": "TSH هو الهرمون الذي يصدره دماغك لأمر الغدة الدرقية — مرتفع يعني الغدة كسولة، منخفض يعني نشيطة جداً"
+    },
+    "Free_T4": {
+      "name_ar": "الثيروكسين الحر",
+      "abbreviations": ["FT4", "Free T4", "Free Thyroxine", "T4 الحر"],
+      "unit": "ng/dL",
+      "ranges": {
+        "adult": {"low": 0.8, "high": 1.8}
+      },
+      "severity_thresholds": {
+        "critical_low": 0.4,
+        "critical_high": 3.5
+      },
+      "clinical_meaning_ar": "الهرمون الدرقي الرئيسي — ينظم الأيض والطاقة والحرارة والمزاج",
+      "high_causes_ar": ["فرط نشاط الغدة الدرقية", "جرعة زائدة من الليفوثيروكسين"],
+      "low_causes_ar": ["قصور الغدة الدرقية", "قصور النخامية (نادر)"],
+      "patient_explanation_ar": "T4 هو الهرمون الذي تنتجه الغدة الدرقية لتنظيم سرعة عمليات جسمك كلها"
+    },
+    "Free_T3": {
+      "name_ar": "ثلاثي يودوثيرونين الحر",
+      "abbreviations": ["FT3", "Free T3", "Triiodothyronine"],
+      "unit": "pg/mL",
+      "ranges": {
+        "adult": {"low": 2.3, "high": 4.2}
+      },
+      "clinical_meaning_ar": "الشكل النشط للهرمون الدرقي — يُحوَّل من T4 في الأنسجة",
+      "importance_note": "FT3 يُقاس عند الاشتباه بفرط نشاط الغدة أو متابعة العلاج — ليس ضرورياً في كل حالة",
+      "patient_explanation_ar": "T3 هو الشكل النشط لهرمون الغدة الدرقية — أكثر تأثيراً من T4 مباشرةً"
+    },
+    "Anti_TPO": {
+      "name_ar": "أجسام مضادة للبيروكسيداز الدرقي",
+      "abbreviations": ["Anti-TPO", "TPOAb", "TPO antibodies", "أجسام ضد الدرقية"],
+      "unit": "IU/mL",
+      "ranges": {
+        "adult": {"low": 0, "high": 34}
+      },
+      "severity_thresholds": {
+        "mildly_positive": 35,
+        "moderately_positive": 100,
+        "highly_positive": 500
+      },
+      "clinical_meaning_ar": "أجسام مناعية تستهدف الغدة الدرقية — ارتفاعها يشير لأمراض مناعة ذاتية",
+      "high_causes_ar": ["هاشيموتو (التهاب الغدة الدرقية المناعي الذاتي)", "مرض جريفز", "التهاب الغدة ما بعد الولادة"],
+      "clinical_notes": "Anti-TPO مرتفع مع TSH طبيعي → خطر تطوير قصور درقي في المستقبل (متابعة سنوية)",
+      "patient_explanation_ar": "جهازك المناعي أحياناً يخطئ ويهاجم غدتك الدرقية — هذه الأجسام المضادة هي دليل على ذلك"
+    },
+    "Anti_TG": {
+      "name_ar": "أجسام مضادة للثيروجلوبولين",
+      "abbreviations": ["Anti-TG", "TgAb", "Thyroglobulin antibodies"],
+      "unit": "IU/mL",
+      "ranges": {
+        "adult": {"low": 0, "high": 115}
+      },
+      "clinical_meaning_ar": "يُقاس مع Anti-TPO لتشخيص أمراض الغدة الدرقية المناعية — وبعد علاج سرطان الغدة"
+    }
+  }
+}

backend/medical_reference_schema.json

@@ -0,0 +1,418 @@
+{
+  "_description": "Medical reference ranges for lab panels. Used to inject structured context into analysis prompts.",
+  "_version": "1.0",
+  "_last_updated": "2026-05-24",
+  "_sources": ["WHO", "LabCorp", "Mayo Clinic", "Harrison's Principles of Internal Medicine 21e"],
+
+  "panels": {
+    "CBC": {
+      "name_ar": "صورة الدم الكاملة",
+      "name_en": "Complete Blood Count",
+      "code": "CBC",
+      "specialty": "hematology",
+      "tests": {
+        "Hemoglobin": {
+          "name_ar": "هيموجلوبين",
+          "abbreviations": ["HGB", "Hgb", "هيموجلوبين"],
+          "unit": "g/dL",
+          "ranges": {
+            "adult_male":   {"low": 13.5, "high": 17.5},
+            "adult_female": {"low": 12.0, "high": 15.5},
+            "children_6_12":{"low": 11.5, "high": 15.5},
+            "pregnant":     {"low": 11.0, "high": 14.0}
+          },
+          "clinical_meaning_ar": "البروتين الذي يحمل الأكسجين في خلايا الدم الحمراء",
+          "high_causes_ar": ["الجفاف (hemoconcentration)", "داء الكثرة الحمراء الحقيقية", "مرض رئوي مزمن (التعويض)"],
+          "low_causes_ar": ["نقص الحديد (السبب الأكثر شيوعاً)", "نقص فيتامين B12 أو حمض الفوليك", "نزيف مزمن", "أمراض مزمنة", "فقر الدم الانحلالي"],
+          "low_symptoms_ar": ["تعب وإرهاق", "شحوب الجلد والملتحمة", "ضيق تنفس عند المجهود", "خفقان", "دوخة"],
+          "when_to_worry": "< 8 g/dL يستدعي تقييماً طبياً عاجلاً",
+          "followup_tests": ["Ferritin", "Iron", "TIBC", "Vitamin B12", "Folate", "Reticulocyte count"]
+        },
+
+        "WBC": {
+          "name_ar": "خلايا الدم البيضاء",
+          "abbreviations": ["WBC", "Leukocytes", "كريات الدم البيضاء"],
+          "unit": "10³/μL",
+          "ranges": {
+            "adult":      {"low": 4.0, "high": 11.0},
+            "children":   {"low": 5.0, "high": 15.0}
+          },
+          "clinical_meaning_ar": "خلايا المناعة التي تقاوم العدوى والمرض",
+          "high_causes_ar": ["عدوى بكتيرية", "التهاب", "إجهاد جسدي شديد", "أمراض الدم (نادراً: سرطان الدم)"],
+          "low_causes_ar": ["عدوى فيروسية حادة", "أدوية (كيموثيرابي، إلخ)", "أمراض المناعة الذاتية", "نقص فيتامين B12"],
+          "when_to_worry": "> 30 أو < 2 يستدعي تقييماً طارئاً",
+          "critical_values": {"critical_high": 30.0, "critical_low": 2.0}
+        },
+
+        "Platelets": {
+          "name_ar": "الصفائح الدموية",
+          "abbreviations": ["PLT", "Thrombocytes", "صفائح"],
+          "unit": "10³/μL",
+          "ranges": {
+            "adult": {"low": 150, "high": 400}
+          },
+          "clinical_meaning_ar": "خلايا صغيرة تساعد على تجلط الدم ووقف النزيف",
+          "high_causes_ar": ["التهابات", "نقص الحديد", "إزالة الطحال"],
+          "low_causes_ar": ["أمراض الكبد", "نقص فيتامين B12", "أدوية معينة", "أمراض المناعة الذاتية (ITP)"],
+          "when_to_worry": "< 50 خطر نزيف تلقائي; < 20 طوارئ",
+          "critical_values": {"critical_low": 20}
+        },
+
+        "RBC": {
+          "name_ar": "خلايا الدم الحمراء",
+          "abbreviations": ["RBC", "Erythrocytes"],
+          "unit": "10⁶/μL",
+          "ranges": {
+            "adult_male":   {"low": 4.5, "high": 5.9},
+            "adult_female": {"low": 4.0, "high": 5.2}
+          },
+          "clinical_meaning_ar": "الخلايا التي تحمل الهيموجلوبين والأكسجين لأنسجة الجسم"
+        },
+
+        "Hematocrit": {
+          "name_ar": "الهيماتوكريت",
+          "abbreviations": ["HCT", "PCV"],
+          "unit": "%",
+          "ranges": {
+            "adult_male":   {"low": 41, "high": 53},
+            "adult_female": {"low": 36, "high": 48}
+          },
+          "clinical_meaning_ar": "نسبة خلايا الدم الحمراء من حجم الدم الكلي"
+        },
+
+        "MCV": {
+          "name_ar": "متوسط حجم الكريات الحمراء",
+          "abbreviations": ["MCV"],
+          "unit": "fL",
+          "ranges": {
+            "adult": {"low": 80, "high": 100}
+          },
+          "clinical_meaning_ar": "يساعد في تحديد نوع فقر الدم: صغير الحجم (نقص حديد) أو كبير الحجم (نقص B12)",
+          "interpretation": {
+            "microcytic_low_MCV": "< 80: يشير إلى نقص الحديد أو الثلاسيميا",
+            "normocytic": "80-100: فقر دم بسبب مرض مزمن أو فقدان دم حاد",
+            "macrocytic_high_MCV": "> 100: يشير إلى نقص B12 أو حمض الفوليك"
+          }
+        },
+
+        "MCH": {
+          "name_ar": "متوسط كمية هيموجلوبين الكرية",
+          "abbreviations": ["MCH"],
+          "unit": "pg",
+          "ranges": {
+            "adult": {"low": 27, "high": 33}
+          },
+          "clinical_meaning_ar": "كمية الهيموجلوبين في كل خلية دم حمراء"
+        }
+      }
+    },
+
+    "Thyroid": {
+      "name_ar": "وظائف الغدة الدرقية",
+      "name_en": "Thyroid Function Tests",
+      "code": "TFT",
+      "specialty": "endocrinology",
+      "tests": {
+        "TSH": {
+          "name_ar": "الهرمون المحفز للدرقية",
+          "abbreviations": ["TSH", "Thyroid Stimulating Hormone"],
+          "unit": "mIU/L",
+          "ranges": {
+            "adult":     {"low": 0.4, "high": 4.0},
+            "pregnant_T1": {"low": 0.1, "high": 2.5},
+            "pregnant_T2": {"low": 0.2, "high": 3.0},
+            "pregnant_T3": {"low": 0.3, "high": 3.0},
+            "elderly":   {"low": 0.4, "high": 5.0}
+          },
+          "clinical_meaning_ar": "هرمون من الغدة النخامية يتحكم في نشاط الغدة الدرقية",
+          "high_causes_ar": ["قصور الغدة الدرقية (hypothyroidism)", "التهاب الغدة الدرقية هاشيموتو"],
+          "low_causes_ar": ["فرط نشاط الغدة الدرقية (hyperthyroidism)", "مرض جريفز (Graves)"],
+          "interpretation": {
+            "TSH_high_FT4_low": "قصور الغدة الدرقية الأولي — تحتاج ليفوثيروكسين",
+            "TSH_low_FT4_high": "فرط نشاط الغدة الدرقية — يحتاج تقييماً متخصصاً",
+            "TSH_high_FT4_normal": "قصور درقي تحت السريري — متابعة كل 6 أشهر"
+          },
+          "followup_tests": ["Free T4", "Free T3", "Anti-TPO", "Anti-Thyroglobulin"]
+        },
+
+        "Free_T4": {
+          "name_ar": "الثيروكسين الحر",
+          "abbreviations": ["FT4", "Free T4", "Thyroxine"],
+          "unit": "ng/dL",
+          "ranges": {
+            "adult": {"low": 0.8, "high": 1.8}
+          },
+          "clinical_meaning_ar": "الهرمون الدرقي الرئيسي — ينظم الأيض والطاقة والحرارة"
+        },
+
+        "Free_T3": {
+          "name_ar": "ثلاثي يودوثيرونين الحر",
+          "abbreviations": ["FT3", "Free T3", "Triiodothyronine"],
+          "unit": "pg/mL",
+          "ranges": {
+            "adult": {"low": 2.3, "high": 4.2}
+          },
+          "clinical_meaning_ar": "الشكل النشط للهرمون الدرقي — أقوى تأثيراً من T4"
+        },
+
+        "Anti_TPO": {
+          "name_ar": "أجسام مضادة للبيروكسيداز الدرقي",
+          "abbreviations": ["Anti-TPO", "TPO antibodies"],
+          "unit": "IU/mL",
+          "ranges": {
+            "adult": {"low": 0, "high": 34}
+          },
+          "clinical_meaning_ar": "ارتفاعه يشير إلى التهاب مناعي ذاتي للغدة الدرقية (هاشيموتو)",
+          "high_causes_ar": ["هاشيموتو", "مرض جريفز", "التهاب الغدة الدرقية"]
+        }
+      }
+    },
+
+    "Liver": {
+      "name_ar": "وظائف الكبد",
+      "name_en": "Liver Function Tests",
+      "code": "LFT",
+      "specialty": "hepatology",
+      "tests": {
+        "ALT": {
+          "name_ar": "ناقلة أمين الألانين",
+          "abbreviations": ["ALT", "SGPT", "ALT/SGPT"],
+          "unit": "U/L",
+          "ranges": {
+            "adult_male":   {"low": 7, "high": 40},
+            "adult_female": {"low": 7, "high": 35}
+          },
+          "clinical_meaning_ar": "إنزيم يُفرز عند تلف خلايا الكبد — الأكثر تخصصاً للكبد",
+          "high_causes_ar": [
+            "التهاب الكبد الفيروسي (A, B, C)",
+            "الكبد الدهني",
+            "أمراض الكبد الكحولية",
+            "أدوية (باراسيتامول، الستاتينات بجرعات عالية)",
+            "انسداد القنوات الصفراوية"
+          ],
+          "severity": {
+            "mild_elevation": "< 3x upper limit: يستدعي المتابعة",
+            "moderate": "3-10x: يحتاج تقييماً طبياً",
+            "severe": "> 10x: تلف كبدي حاد — طوارئ"
+          },
+          "followup_tests": ["AST", "GGT", "Bilirubin", "Albumin", "PT/INR", "Viral hepatitis panel"]
+        },
+
+        "AST": {
+          "name_ar": "ناقلة أمين الأسبارتات",
+          "abbreviations": ["AST", "SGOT"],
+          "unit": "U/L",
+          "ranges": {
+            "adult_male":   {"low": 10, "high": 40},
+            "adult_female": {"low": 10, "high": 35}
+          },
+          "clinical_meaning_ar": "إنزيم أقل تخصصاً للكبد — يرتفع أيضاً مع أمراض القلب والعضلات",
+          "ast_alt_ratio": {
+            "ratio_2_1": "AST:ALT > 2:1 يشير إلى سبب كحولي",
+            "alt_higher": "ALT أعلى من AST يشير إلى التهاب كبدي فيروسي أو دهني"
+          }
+        },
+
+        "ALP": {
+          "name_ar": "الفوسفاتاز القلوية",
+          "abbreviations": ["ALP", "Alkaline Phosphatase"],
+          "unit": "U/L",
+          "ranges": {
+            "adult":    {"low": 44, "high": 147},
+            "children": {"low": 50, "high": 350}
+          },
+          "clinical_meaning_ar": "يرتفع مع انسداد القنوات الصفراوية وأمراض العظام",
+          "high_causes_ar": ["انسداد القنوات الصفراوية", "حصى المرارة", "أمراض العظام (Paget's)", "نمو العظام الطبيعي عند الأطفال"]
+        },
+
+        "Bilirubin_Total": {
+          "name_ar": "البيليروبين الكلي",
+          "abbreviations": ["T.Bili", "Total Bilirubin", "بيليروبين كلي"],
+          "unit": "mg/dL",
+          "ranges": {
+            "adult": {"low": 0.2, "high": 1.2}
+          },
+          "clinical_meaning_ar": "صبغة ناتجة عن تكسّر خلايا الدم الحمراء. يسبب اليرقان عند الارتفاع.",
+          "high_causes_ar": ["التهاب كبد", "انسداد صفراوي", "فقر الدم الانحلالي", "متلازمة جيلبرت (حميدة)"],
+          "jaundice_threshold": "> 2.5 mg/dL: يظهر اليرقان (اصفرار الجلد والعيون)"
+        },
+
+        "Bilirubin_Direct": {
+          "name_ar": "البيليروبين المباشر",
+          "abbreviations": ["D.Bili", "Direct Bilirubin", "Conjugated Bilirubin"],
+          "unit": "mg/dL",
+          "ranges": {
+            "adult": {"low": 0, "high": 0.3}
+          },
+          "clinical_meaning_ar": "يرتفع مع أمراض الكبد والانسداد الصفراوي تحديداً"
+        },
+
+        "Albumin": {
+          "name_ar": "الألبومين",
+          "abbreviations": ["ALB", "Albumin"],
+          "unit": "g/dL",
+          "ranges": {
+            "adult": {"low": 3.5, "high": 5.0}
+          },
+          "clinical_meaning_ar": "بروتين ينتجه الكبد — مؤشر لوظيفة الكبد التركيبية وسوء التغذية",
+          "low_causes_ar": ["قصور الكبد المزمن", "سوء التغذية", "متلازمة الكلاء", "التهاب حاد"],
+          "importance": "انخفاضه يدل على ضعف قدرة الكبد التركيبية — مهم جداً في تقييم الكبد"
+        },
+
+        "GGT": {
+          "name_ar": "غاما غلوتاميل ترانسفيراز",
+          "abbreviations": ["GGT", "Gamma-GT"],
+          "unit": "U/L",
+          "ranges": {
+            "adult_male":   {"low": 8, "high": 61},
+            "adult_female": {"low": 5, "high": 36}
+          },
+          "clinical_meaning_ar": "حساس جداً لأمراض الكبد وخاصة الكحولية. يساعد في تفسير ارتفاع ALP.",
+          "high_causes_ar": ["الكحول", "أمراض الكبد الدهني", "أدوية معينة", "انسداد صفراوي"]
+        }
+      }
+    },
+
+    "Kidney": {
+      "name_ar": "وظائف الكلى",
+      "name_en": "Kidney Function Tests",
+      "code": "KFT",
+      "specialty": "nephrology",
+      "tests": {
+        "Creatinine": {
+          "name_ar": "كرياتينين",
+          "abbreviations": ["Creat", "Creatinine", "كرياتينين"],
+          "unit": "mg/dL",
+          "ranges": {
+            "adult_male":   {"low": 0.7, "high": 1.3},
+            "adult_female": {"low": 0.5, "high": 1.1}
+          },
+          "clinical_meaning_ar": "مادة نفايات من العضلات تُصفيها الكلى — ارتفاعه يدل على ضعف وظيفة الكلى",
+          "high_causes_ar": ["الفشل الكلوي", "الجفاف", "كتلة عضلية كبيرة", "بعض الأدوية"],
+          "followup_tests": ["BUN", "GFR", "Urine albumin", "Electrolytes"]
+        },
+
+        "BUN": {
+          "name_ar": "نيتروجين يوريا الدم",
+          "abbreviations": ["BUN", "Blood Urea Nitrogen", "يوريا"],
+          "unit": "mg/dL",
+          "ranges": {
+            "adult": {"low": 8, "high": 25}
+          },
+          "clinical_meaning_ar": "مادة نفايات من البروتينات — يرتفع مع ضعف الكلى أو نزيف الجهاز الهضمي",
+          "bun_creatinine_ratio": {
+            "normal": "10:1 إلى 20:1",
+            "high_ratio_pre_renal": "> 20:1: يشير إلى الجفاف أو نزيف هضمي",
+            "low_ratio": "< 10:1: يشير إلى نقص البروتين أو أمراض ا��كبد"
+          }
+        }
+      }
+    },
+
+    "Lipid": {
+      "name_ar": "الدهنيات",
+      "name_en": "Lipid Panel",
+      "code": "LIPID",
+      "specialty": "cardiology",
+      "tests": {
+        "Cholesterol_Total": {
+          "name_ar": "الكوليسترول الكلي",
+          "abbreviations": ["Total Cholesterol", "Chol", "كوليسترول"],
+          "unit": "mg/dL",
+          "ranges": {
+            "desirable":    {"high": 200},
+            "borderline":   {"low": 200, "high": 239},
+            "high_risk":    {"low": 240}
+          },
+          "clinical_meaning_ar": "دهون ضرورية للجسم — ارتفاعها يزيد خطر أمراض القلب والأوعية"
+        },
+
+        "LDL": {
+          "name_ar": "الكوليسترول الضار",
+          "abbreviations": ["LDL", "LDL-C", "LDL Cholesterol"],
+          "unit": "mg/dL",
+          "ranges": {
+            "optimal":         {"high": 100},
+            "near_optimal":    {"low": 100, "high": 129},
+            "borderline_high": {"low": 130, "high": 159},
+            "high":            {"low": 160, "high": 189},
+            "very_high":       {"low": 190}
+          },
+          "targets_by_risk": {
+            "high_cv_risk":   "< 70 mg/dL",
+            "moderate_risk":  "< 100 mg/dL",
+            "low_risk":       "< 130 mg/dL"
+          },
+          "clinical_meaning_ar": "الكوليسترول الضار — يتراكم في جدران الأوعية ويزيد خطر النوبات القلبية"
+        },
+
+        "HDL": {
+          "name_ar": "الكوليسترول الجيد",
+          "abbreviations": ["HDL", "HDL-C", "HDL Cholesterol"],
+          "unit": "mg/dL",
+          "ranges": {
+            "low_risk_male":   {"low": 40},
+            "low_risk_female": {"low": 50},
+            "protective":      {"low": 60}
+          },
+          "clinical_meaning_ar": "الكوليسترول الجيد — ينقل الدهون من الأوعية للكبد ويحمي القلب",
+          "note": "الأعلى أفضل — < 40 للرجال و< 50 للنساء عامل خطر قلبي"
+        },
+
+        "Triglycerides": {
+          "name_ar": "الدهون الثلاثية",
+          "abbreviations": ["TG", "TRIG", "Triglycerides"],
+          "unit": "mg/dL",
+          "ranges": {
+            "normal":          {"high": 150},
+            "borderline_high": {"low": 150, "high": 199},
+            "high":            {"low": 200, "high": 499},
+            "very_high":       {"low": 500}
+          },
+          "high_causes_ar": ["السمنة", "السكري غير المنضبط", "قلة النشاط", "النظام الغذائي الغني بالسكر والكربوهيدرات", "قصور الغدة الدرقية"]
+        }
+      }
+    },
+
+    "Diabetes": {
+      "name_ar": "مؤشرات السكري",
+      "name_en": "Diabetes Markers",
+      "code": "DM",
+      "specialty": "endocrinology",
+      "tests": {
+        "Fasting_Glucose": {
+          "name_ar": "سكر الصيام",
+          "abbreviations": ["FBG", "FPG", "Fasting Glucose", "سكر صيام"],
+          "unit": "mg/dL",
+          "ranges": {
+            "normal":     {"high": 99},
+            "prediabetes":{"low": 100, "high": 125},
+            "diabetes":   {"low": 126}
+          },
+          "note": "يجب الصيام 8-12 ساعة قبل الفحص للحصول على نتيجة دقيقة"
+        },
+
+        "HbA1c": {
+          "name_ar": "السكر التراكمي",
+          "abbreviations": ["HbA1c", "A1C", "Glycated Hemoglobin", "سكر تراكمي"],
+          "unit": "%",
+          "ranges": {
+            "normal":     {"high": 5.6},
+            "prediabetes":{"low": 5.7, "high": 6.4},
+            "diabetes":   {"low": 6.5}
+          },
+          "targets_for_diabetics": {
+            "general":       "< 7%",
+            "elderly":       "< 8%",
+            "pregnant":      "< 6%",
+            "cardiovascular":"< 7% or individualized"
+          },
+          "clinical_meaning_ar": "يعكس متوسط مستوى السكر في الدم خلال الأشهر الثلاثة الماضية",
+          "avg_glucose_conversion": {
+            "5": 97, "6": 126, "7": 154, "8": 183, "9": 212, "10": 240, "11": 269, "12": 298
+          }
+        }
+      }
+    }
+  }
+}

backend/middleware/__init__.py

@@ -0,0 +1,4 @@
+from .audit import AuditMiddleware, get_audit_logger
+from .sanitizer import validate_upload, sanitize_text, MAX_FILE_BYTES
+
+__all__ = ["AuditMiddleware", "get_audit_logger", "validate_upload", "sanitize_text", "MAX_FILE_BYTES"]

backend/middleware/audit.py

@@ -0,0 +1,136 @@
+"""
+Structured audit logging middleware for PDPL/NDMO compliance.
+
+Every request is logged with: timestamp, method, path, client IP,
+session_id (from header), status code, latency, and error summary.
+Logs are written to a rotating file + stdout (structured JSON).
+"""
+from __future__ import annotations
+
+import json
+import logging
+import os
+import time
+import uuid
+from logging.handlers import RotatingFileHandler
+from pathlib import Path
+from typing import Callable
+
+from fastapi import Request, Response
+from starlette.middleware.base import BaseHTTPMiddleware
+from starlette.types import ASGIApp
+
+# ── Audit logger (separate from app logger) ─────────────────────────────────
+
+_LOG_DIR = Path(os.getenv("AUDIT_LOG_DIR", "logs/audit"))
+_LOG_FILE = _LOG_DIR / "audit.jsonl"
+_MAX_BYTES = 50 * 1024 * 1024   # 50 MB per file
+_BACKUP_COUNT = 10               # keep 10 rotated files (~500 MB total)
+
+# Paths that are not audited (health checks, static assets)
+_SKIP_PATHS = frozenset(["/health", "/docs", "/openapi.json", "/favicon.ico"])
+
+# Endpoints that handle medical data — flag them for compliance
+_SENSITIVE_PATHS = frozenset([
+    "/api/analyze", "/api/analyses/save", "/api/chat",
+    "/api/voice/transcribe", "/api/voice/chat", "/api/risk",
+])
+
+
+def _build_audit_logger() -> logging.Logger:
+    logger = logging.getLogger("audit")
+    if logger.handlers:
+        return logger
+    logger.setLevel(logging.INFO)
+    logger.propagate = False
+
+    try:
+        _LOG_DIR.mkdir(parents=True, exist_ok=True)
+        fh = RotatingFileHandler(
+            _LOG_FILE, maxBytes=_MAX_BYTES, backupCount=_BACKUP_COUNT, encoding="utf-8"
+        )
+        fh.setFormatter(logging.Formatter("%(message)s"))
+        logger.addHandler(fh)
+    except Exception as e:
+        print(f"[AUDIT] Cannot open log file {_LOG_FILE}: {e} — writing to stderr only")
+
+    sh = logging.StreamHandler()
+    sh.setFormatter(logging.Formatter("%(message)s"))
+    logger.addHandler(sh)
+
+    return logger
+
+
+_audit_logger = _build_audit_logger()
+
+
+def get_audit_logger() -> logging.Logger:
+    return _audit_logger
+
+
+def _get_client_ip(request: Request) -> str:
+    forwarded = request.headers.get("X-Forwarded-For", "")
+    if forwarded:
+        return forwarded.split(",")[0].strip()
+    return request.client.host if request.client else "unknown"
+
+
+def _redact_sensitive_headers(headers: dict) -> dict:
+    """Remove auth tokens and API keys from logged headers."""
+    sensitive = {"authorization", "x-api-key", "cookie", "set-cookie"}
+    return {k: "[REDACTED]" if k.lower() in sensitive else v for k, v in headers.items()}
+
+
+class AuditMiddleware(BaseHTTPMiddleware):
+    """
+    FastAPI middleware that writes one structured JSON audit record per request.
+
+    Fields logged:
+      req_id, timestamp_utc, method, path, query, client_ip,
+      session_id, status, latency_ms, sensitive, error (if any)
+    """
+
+    def __init__(self, app: ASGIApp, environment: str = "production") -> None:
+        super().__init__(app)
+        self._env = environment
+
+    async def dispatch(self, request: Request, call_next: Callable) -> Response:
+        if request.url.path in _SKIP_PATHS:
+            return await call_next(request)
+
+        req_id = str(uuid.uuid4())[:8]
+        t_start = time.perf_counter()
+
+        # Attach req_id so endpoints can reference it in error messages
+        request.state.req_id = req_id
+
+        error_detail: str | None = None
+        status_code = 500
+        try:
+            response = await call_next(request)
+            status_code = response.status_code
+        except Exception as exc:
+            error_detail = type(exc).__name__ + ": " + str(exc)[:200]
+            raise
+        finally:
+            latency_ms = round((time.perf_counter() - t_start) * 1000, 1)
+            path = request.url.path
+            record: dict = {
+                "req_id":        req_id,
+                "ts":            time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
+                "method":        request.method,
+                "path":          path,
+                "query":         str(request.url.query)[:200] or None,
+                "ip":            _get_client_ip(request),
+                "session_id":    request.headers.get("X-Session-Id", "anon")[:64],
+                "status":        status_code,
+                "latency_ms":    latency_ms,
+                "sensitive":     path in _SENSITIVE_PATHS,
+                "env":           self._env,
+            }
+            if error_detail:
+                record["error"] = error_detail
+            _audit_logger.info(json.dumps(record, ensure_ascii=False))
+
+        response.headers["X-Request-Id"] = req_id
+        return response

backend/middleware/auth_middleware.py

@@ -0,0 +1,186 @@
+"""
+Supabase JWT verification for FastAPI.
+
+Supabase now supports two signing modes:
+  - ES256 (ECDSA, newer projects): verified via JWKS public key endpoint
+  - HS256 (HMAC, older projects): verified via SUPABASE_JWT_SECRET
+
+This middleware auto-detects the algorithm from the JWT header and uses
+the appropriate verification method.
+
+Usage:
+    @app.get("/api/me")
+    async def me(user = Depends(require_user)):
+        return {"id": user["sub"], "email": user["email"]}
+
+    @app.get("/api/public")
+    async def public(user = Depends(optional_user)):
+        ...
+
+Environment:
+    SUPABASE_URL        — project URL (for JWKS endpoint)
+    SUPABASE_JWT_SECRET — required only for HS256 projects
+"""
+
+from __future__ import annotations
+
+import os
+import logging
+import time
+from typing import Any
+
+import jwt
+from jwt import PyJWKClient
+from fastapi import Depends, HTTPException, status
+from fastapi.security import HTTPAuthorizationCredentials, HTTPBearer
+
+log = logging.getLogger("tebyan.auth")
+
+_JWT_SECRET  = os.getenv("SUPABASE_JWT_SECRET", "")
+_SUPABASE_URL = os.getenv("SUPABASE_URL", "")
+_ALGORITHM_HS = "HS256"
+_ALGORITHM_ES = "ES256"
+_AUDIENCE     = "authenticated"
+
+# JWKS client — caches public keys for 10 minutes
+_jwks_client: PyJWKClient | None = None
+_jwks_last_fetched: float = 0.0
+_JWKS_CACHE_TTL = 600  # seconds
+
+# auto_error=False lets us handle missing token ourselves (for optional_user)
+_bearer = HTTPBearer(auto_error=False)
+
+
+def _get_jwks_client() -> PyJWKClient | None:
+    global _jwks_client, _jwks_last_fetched
+    if not _SUPABASE_URL:
+        return None
+    now = time.time()
+    if _jwks_client is None or (now - _jwks_last_fetched) > _JWKS_CACHE_TTL:
+        try:
+            url = f"{_SUPABASE_URL}/auth/v1/.well-known/jwks.json"
+            _jwks_client = PyJWKClient(url, cache_keys=True)
+            _jwks_last_fetched = now
+            log.debug("JWKS client initialised from %s", url)
+        except Exception as e:
+            log.warning("Failed to init JWKS client: %s", e)
+            return None
+    return _jwks_client
+
+
+def _get_algorithm(token: str) -> str:
+    """Peek at the JWT header to determine signing algorithm."""
+    try:
+        header = jwt.get_unverified_header(token)
+        return header.get("alg", _ALGORITHM_HS)
+    except Exception:
+        return _ALGORITHM_HS
+
+
+def _decode(token: str) -> dict[str, Any]:
+    """
+    Decode and verify a Supabase JWT.
+    Supports both ES256 (JWKS) and HS256 (secret).
+    Raises HTTPException on any failure.
+    """
+    alg = _get_algorithm(token)
+
+    try:
+        if alg == _ALGORITHM_ES:
+            # ES256 — verify via JWKS public key
+            client = _get_jwks_client()
+            if client is None:
+                raise HTTPException(
+                    status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
+                    detail="Auth not configured on server (SUPABASE_URL missing)",
+                )
+            signing_key = client.get_signing_key_from_jwt(token)
+            return jwt.decode(
+                token,
+                signing_key.key,
+                algorithms=[_ALGORITHM_ES],
+                audience=_AUDIENCE,
+            )
+        else:
+            # HS256 — verify via shared secret
+            if not _JWT_SECRET:
+                log.error("SUPABASE_JWT_SECRET not set — cannot verify HS256 tokens")
+                raise HTTPException(
+                    status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
+                    detail="Auth not configured on server",
+                )
+            return jwt.decode(
+                token,
+                _JWT_SECRET,
+                algorithms=[_ALGORITHM_HS],
+                audience=_AUDIENCE,
+            )
+
+    except HTTPException:
+        raise
+    except jwt.ExpiredSignatureError:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail={"error": "session_expired", "message": "انتهت صلاحية الجلسة — يرجى تسجيل الدخول مجدداً"},
+            headers={"WWW-Authenticate": "Bearer"},
+        )
+    except jwt.InvalidAudienceError:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail={"error": "invalid_token", "message": "رمز المصادقة غير صالح"},
+            headers={"WWW-Authenticate": "Bearer"},
+        )
+    except jwt.InvalidTokenError as e:
+        log.debug("JWT decode failed: %s", e)
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail={"error": "invalid_token", "message": "رمز المصادقة غير صالح"},
+            headers={"WWW-Authenticate": "Bearer"},
+        )
+
+
+# ── Public dependency functions ───────────────────────────────────────────────
+
+async def require_user(
+    credentials: HTTPAuthorizationCredentials | None = Depends(_bearer),
+) -> dict[str, Any]:
+    """
+    FastAPI dependency that returns the decoded JWT payload.
+    Raises 401 if the request has no valid Bearer token.
+    """
+    if not credentials:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail={"error": "missing_token", "message": "تسجيل الدخول مطلوب"},
+            headers={"WWW-Authenticate": "Bearer"},
+        )
+    return _decode(credentials.credentials)
+
+
+async def optional_user(
+    credentials: HTTPAuthorizationCredentials | None = Depends(_bearer),
+) -> dict[str, Any] | None:
+    """
+    FastAPI dependency that returns the decoded JWT payload or None.
+    Does not raise — lets the route handle unauthenticated requests.
+    Returns None gracefully if JWKS/secret is not configured.
+    """
+    if not credentials:
+        return None
+    if not _SUPABASE_URL and not _JWT_SECRET:
+        log.debug("Auth not configured — treating request as anonymous")
+        return None
+    try:
+        return _decode(credentials.credentials)
+    except HTTPException:
+        return None
+
+
+def get_user_id(user: dict[str, Any]) -> str:
+    """Extract the Supabase user UUID from a decoded payload."""
+    return user["sub"]
+
+
+def get_user_email(user: dict[str, Any]) -> str:
+    """Extract the user email from a decoded payload."""
+    return user.get("email", "")

backend/middleware/sanitizer.py

@@ -0,0 +1,155 @@
+"""
+Request sanitization and file validation for medical file uploads.
+
+Validates:
+  - File size (max 20 MB)
+  - MIME type whitelist (PDF, JPEG, PNG, WEBP, TIFF)
+  - Magic bytes (header sniffing — prevents MIME spoofing)
+  - Filename safety (path traversal, null bytes, dangerous extensions)
+  - Text input: strips HTML tags, limits length, removes null bytes
+"""
+from __future__ import annotations
+
+import re
+from typing import Final
+
+from fastapi import HTTPException, UploadFile
+
+# ── Limits ───────────────────────────────────────────────────────────────────
+
+MAX_FILE_BYTES: Final[int] = 20 * 1024 * 1024   # 20 MB
+MAX_TEXT_LEN: Final[int]   = 8_000              # characters per text field
+
+# ── Allowed MIME types (whitelist) ───────────────────────────────────────────
+
+_ALLOWED_MIME: Final[frozenset[str]] = frozenset([
+    "application/pdf",
+    "image/jpeg",
+    "image/jpg",
+    "image/png",
+    "image/webp",
+    "image/tiff",
+])
+
+# ── Magic bytes (first bytes of file → expected MIME group) ─────────────────
+
+_MAGIC: Final[list[tuple[bytes, str]]] = [
+    (b"%PDF",       "pdf"),
+    (b"\xff\xd8\xff", "jpeg"),
+    (b"\x89PNG",    "png"),
+    (b"RIFF",       "webp"),   # RIFF....WEBP
+    (b"II*\x00",    "tiff"),   # little-endian TIFF
+    (b"MM\x00*",    "tiff"),   # big-endian TIFF
+]
+
+_MIME_TO_MAGIC_GROUP: Final[dict[str, str]] = {
+    "application/pdf": "pdf",
+    "image/jpeg":      "jpeg",
+    "image/jpg":       "jpeg",
+    "image/png":       "png",
+    "image/webp":      "webp",
+    "image/tiff":      "tiff",
+}
+
+# ── Dangerous file extensions (block even if MIME seems OK) ──────────────────
+
+_BLOCKED_EXT: Final[frozenset[str]] = frozenset([
+    ".exe", ".sh", ".bat", ".cmd", ".ps1", ".js", ".php", ".py",
+    ".rb", ".pl", ".dll", ".so", ".elf", ".msi", ".vbs", ".hta",
+    ".jar", ".class", ".com", ".scr", ".pif",
+])
+
+# ── Text sanitization ────────────────────────────────────────────────────────
+
+_HTML_TAG_RE  = re.compile(r"<[^>]{0,200}>")
+_SCRIPT_RE    = re.compile(r"(?i)(javascript:|data:text/html|<script)", re.IGNORECASE)
+_NULL_BYTE_RE = re.compile(r"\x00")
+_SQL_INJECT   = re.compile(
+    r"(?i)\b(union\s+select|drop\s+table|insert\s+into|delete\s+from"
+    r"|exec\s*\(|xp_cmdshell|;--)\b"
+)
+
+
+def sanitize_text(text: str, max_len: int = MAX_TEXT_LEN) -> str:
+    """
+    Strip HTML, null bytes, and obvious injection patterns from user text.
+    Truncates to max_len characters.
+    """
+    if not isinstance(text, str):
+        return ""
+    text = _NULL_BYTE_RE.sub("", text)
+    text = _HTML_TAG_RE.sub("", text)
+    if _SCRIPT_RE.search(text):
+        raise HTTPException(status_code=400, detail="محتوى غير مسموح به في النص المرسل")
+    if _SQL_INJECT.search(text):
+        raise HTTPException(status_code=400, detail="محتوى غير مسموح به في النص المرسل")
+    return text[:max_len].strip()
+
+
+def _sniff_magic(data: bytes) -> str | None:
+    """Return magic group name or None if unrecognised."""
+    for magic, group in _MAGIC:
+        if data[:len(magic)] == magic:
+            # Special: WebP has 'WEBP' at offset 8
+            if group == "webp" and data[8:12] != b"WEBP":
+                continue
+            return group
+    return None
+
+
+def _safe_filename(filename: str) -> str:
+    """Sanitize filename: strip path components and dangerous characters."""
+    # Strip directory traversal
+    name = re.sub(r"[/\\]", "_", filename)
+    # Remove null bytes and control chars
+    name = re.sub(r"[\x00-\x1f]", "", name)
+    # Keep only safe chars
+    name = re.sub(r"[^\w.\-]", "_", name)
+    return name[:128] or "upload"
+
+
+def validate_upload(file: UploadFile, data: bytes) -> None:
+    """
+    Validate an uploaded file.  Raises HTTPException on any violation.
+
+    Args:
+        file: The UploadFile from FastAPI (provides filename + content_type).
+        data: Raw bytes already read from the file.
+
+    Raises:
+        HTTPException 400 for bad requests, 413 for file too large, 415 for unsupported type.
+    """
+    # ── Size ─────────────────────────────────────────────────────────────────
+    if len(data) == 0:
+        raise HTTPException(status_code=400, detail="الملف فارغ")
+    if len(data) > MAX_FILE_BYTES:
+        mb = MAX_FILE_BYTES // (1024 * 1024)
+        raise HTTPException(status_code=413, detail=f"حجم الملف يتجاوز الحد المسموح ({mb} MB)")
+
+    # ���─ Filename safety ───────────────────────────────────────────────────────
+    filename = (file.filename or "").strip()
+    if not filename:
+        raise HTTPException(status_code=400, detail="اسم الملف مطلوب")
+
+    ext = "." + filename.rsplit(".", 1)[-1].lower() if "." in filename else ""
+    if ext in _BLOCKED_EXT:
+        raise HTTPException(status_code=415, detail=f"نوع الملف '{ext}' غير مسموح")
+
+    # ── MIME whitelist ────────────────────────────────────────────────────────
+    content_type = (file.content_type or "").split(";")[0].strip().lower()
+    if content_type not in _ALLOWED_MIME:
+        raise HTTPException(
+            status_code=415,
+            detail=f"نوع الملف '{content_type}' غير مدعوم. الأنواع المقبولة: PDF, JPEG, PNG, WEBP, TIFF",
+        )
+
+    # ── Magic bytes validation (anti-MIME-spoofing) ───────────────────────────
+    detected = _sniff_magic(data)
+    expected_group = _MIME_TO_MAGIC_GROUP.get(content_type)
+    if detected is None:
+        raise HTTPException(status_code=415, detail="تعذّر التحقق من نوع الملف — بيانات غير صالحة")
+    if expected_group and detected != expected_group:
+        raise HTTPException(
+            status_code=415,
+            detail=f"محتوى الملف لا يطابق نوعه المُعلَن ({content_type})",
+        )

backend/prompts/examples/cbc_examples.json

@@ -0,0 +1,76 @@
+{
+  "_description": "CBC few-shot examples — used to prime LLM with correct Arabic medical format",
+  "_version": "2.0",
+  "examples": [
+    {
+      "id": "cbc_iron_deficiency",
+      "scenario": "Iron-deficiency anemia — female, 28 years",
+      "input_findings": [
+        {"name": "Hemoglobin", "value": "9.8", "range": "12.0-15.5", "unit": "g/dL", "status": "low"},
+        {"name": "MCV", "value": "71", "range": "80-100", "unit": "fL", "status": "low"},
+        {"name": "MCH", "value": "23", "range": "27-33", "unit": "pg", "status": "low"},
+        {"name": "WBC", "value": "6.5", "range": "4.0-11.0", "unit": "10³/μL", "status": "normal"},
+        {"name": "Platelets", "value": "310", "range": "150-400", "unit": "10³/μL", "status": "normal"}
+      ],
+      "ideal_output": {
+        "تقييم_عام": "خلايا الدم البيضاء والصفائح الدموية طبيعية تماماً — وهو مؤشر جيد لسلامة جهازك المناعي. يستدعي الانتباه انخفاض الهيموجلوبين مع صغر حجم الكريات الحمراء، وهو نمط كلاسيكي لفقر الدم الناجم عن نقص الحديد — وهي حالة شائعة ومناسبة للعلاج.",
+        "interpretation_chain": "Hgb low + MCV low + MCH low → microcytic hypochromic anemia → most likely iron deficiency → recommend Ferritin + Iron panel",
+        "key_message_ar": "فقر دم بسيط إلى متوسط بسبب نقص الحديد على الأرجح — قابل للعلاج بالغذاء والمكملات",
+        "توصيات": [
+          {
+            "category": "التغذية الغنية بالحديد",
+            "tips": ["تناول اللحوم الحمراء 3 مرات أسبوعياً", "السبانخ والعدس والفول من أغنى المصادر النباتية", "اقرن وجبات الحديد بعصير البرتقال لتحسين الامتصاص 2×", "تجنب الشاي والقهوة مباشرة بعد الوجبات — تقلل الامتصاص 60%"]
+          },
+          {
+            "category": "المتابعة الطبية",
+            "tips": ["أجري فحص الفيريتين والحديد لتأكيد السبب", "راجعي طبيبك لتحديد جرعة مكمل الحديد المناسبة", "أعيدي التحليل بعد 3 أشهر من العلاج لمتابعة التحسن"]
+          }
+        ]
+      }
+    },
+    {
+      "id": "cbc_all_normal",
+      "scenario": "All CBC values normal — male, 35 years",
+      "input_findings": [
+        {"name": "Hemoglobin", "value": "15.2", "range": "13.5-17.5", "unit": "g/dL", "status": "normal"},
+        {"name": "WBC", "value": "7.1", "range": "4.0-11.0", "unit": "10³/μL", "status": "normal"},
+        {"name": "Platelets", "value": "245", "range": "150-400", "unit": "10³/μL", "status": "normal"},
+        {"name": "Hematocrit", "value": "46", "range": "41-53", "unit": "%", "status": "normal"}
+      ],
+      "ideal_output": {
+        "تقييم_عام": "ممتاز! جميع قيم صورة الدم الكاملة ضمن المعدل الطبيعي — الهيموجلوبين يحمل الأكسجين بكفاءة، وخلايا المناعة بعدد مثالي، والصفائح الدموية تضمن التجلط الصحي. هذه نتائج تعكس صحة دموية جيدة.",
+        "key_message_ar": "نتائج طبيعية — استمر على نمط حياتك الصحي",
+        "توصيات": [
+          {
+            "category": "الحفاظ على الصحة الدموية",
+            "tips": ["تناول وجبات متوازنة تشمل البروتين والحديد والفيتامينات", "مارس الرياضة المعتدلة 150 دقيقة أسبوعياً", "اشرب 2 لتر ماء يومياً للحفاظ على حجم الدم", "أجرِ صورة الدم الكاملة سنوياً للمتابعة الوقائية"]
+          }
+        ]
+      }
+    },
+    {
+      "id": "cbc_infection",
+      "scenario": "Elevated WBC suggesting infection",
+      "input_findings": [
+        {"name": "WBC", "value": "14.5", "range": "4.0-11.0", "unit": "10³/μL", "status": "high"},
+        {"name": "Neutrophils", "value": "82", "range": "50-70", "unit": "%", "status": "high"},
+        {"name": "Hemoglobin", "value": "13.8", "range": "13.5-17.5", "unit": "g/dL", "status": "normal"},
+        {"name": "Platelets", "value": "420", "range": "150-400", "unit": "10³/μL", "status": "high"}
+      ],
+      "ideal_output": {
+        "تقييم_عام": "الهيموجلوبين طبيعي وهو مؤشر إيجابي. يُلاحظ ارتفاع في خلايا الدم البيضاء مع ارتفاع النيتروفيل — وهو نمط يشير عادةً إلى وجود عدوى بكتيرية أو التهاب في مكان ما في الجسم. الصفائح مرتفعة قليلاً وهو تفاعل طبيعي مع الالتهاب.",
+        "interpretation_chain": "WBC 14.5 (high) + Neutrophils 82% (high) → bacterial infection pattern → body in acute inflammatory response",
+        "توصيات": [
+          {
+            "category": "المتابعة الطبية العاجلة",
+            "tips": ["راجع طبيبك لتحديد موضع العدوى والعلاج المناسب", "أخبر طبيبك عن أي أعراض: حمى، ألم، سعال، حرقة بول", "لا تؤخر المراجعة إذا كانت لديك حمى > 38.5 درجة"]
+          },
+          {
+            "category": "الراحة والترطيب",
+            "tips": ["استرح واشرب سوائل كافية", "تجنب مجهود شديد حتى يتضح التشخيص", "راقب درجة حرارتك يومياً"]
+          }
+        ]
+      }
+    }
+  ]
+}

backend/prompts/examples/thyroid_examples.json

@@ -0,0 +1,50 @@
+{
+  "_description": "Thyroid few-shot examples",
+  "_version": "2.0",
+  "examples": [
+    {
+      "id": "hypothyroidism_primary",
+      "scenario": "Primary hypothyroidism — TSH high, FT4 low",
+      "input_findings": [
+        {"name": "TSH", "value": "9.8", "range": "0.4-4.0", "unit": "mIU/L", "status": "high"},
+        {"name": "Free T4", "value": "0.6", "range": "0.8-1.8", "unit": "ng/dL", "status": "low"},
+        {"name": "Anti-TPO", "value": "380", "range": "0-34", "unit": "IU/mL", "status": "high"}
+      ],
+      "ideal_output": {
+        "تقييم_عام": "نتائجك تكشف عن قصور في نشاط الغدة الدرقية — فالـ TSH المرتفع من الغدة النخامية يحاول تنبيه الغدة الدرقية لإنتاج المزيد، لكن الغدة تستجيب بإنتاج T4 أقل من الطبيعي. ارتفاع الأجسام المضادة يشير إلى أن سبب القصور على الأرجح مناعي ذاتي (هاشيموتو).",
+        "interpretation_chain": "TSH↑ + FT4↓ = primary hypothyroidism | Anti-TPO↑↑ = Hashimoto's thyroiditis (autoimmune)",
+        "key_message_ar": "قصور الغدة الدرقية بسبب هاشيموتو — يُعالج بسهولة بحبة يومية من الليفوثيروكسين",
+        "أعراض_متوقعة": ["تعب وإرهاق", "زيادة الوزن", "برودة الأطراف", "بطء القلب", "إمساك", "جفاف البشرة والشعر"],
+        "توصيات": [
+          {
+            "category": "المتابعة الطبية",
+            "tips": ["راجع طبيبك الآن لبدء علاج الليفوثيروكسين", "أعد فحص TSH و FT4 بعد 6-8 أسابيع من بدء العلاج", "الالتزام بالدواء يومياً قبل الأكل يضمن نتائج ممتازة", "لا تتوقف عن الدواء دون استشارة طبيبك"]
+          },
+          {
+            "category": "نصائح غذائية",
+            "tips": ["تجنب الإفراط في السيلينيوم والكالسيوم كمكملات — تؤثر على الامتصاص", "اليود في الملح المُدعّم كافٍ — لا تفرط بمكملات اليود", "يُنصح باتباع نظام غذائي متوازن وممارسة الرياضة بانتظام"]
+          }
+        ]
+      }
+    },
+    {
+      "id": "subclinical_hypothyroid",
+      "scenario": "Subclinical hypothyroidism — TSH slightly high, FT4 normal",
+      "input_findings": [
+        {"name": "TSH", "value": "5.8", "range": "0.4-4.0", "unit": "mIU/L", "status": "high"},
+        {"name": "Free T4", "value": "1.2", "range": "0.8-1.8", "unit": "ng/dL", "status": "normal"}
+      ],
+      "ideal_output": {
+        "تقييم_عام": "TSH مرتفع قليلاً فوق المعدل الطبيعي، لكن هرمون الغدة الدرقية FT4 طبيعي — وهو ما يسمى 'القصور تحت السريري'. الغدة الدرقية لا تزال تعمل جيداً ولكنها تتطلب جهداً أكبر من الطبيعي.",
+        "interpretation_chain": "TSH↑ mildly + FT4 normal = subclinical hypothyroidism → monitor every 6 months, treat if symptomatic or TSH > 10",
+        "key_message_ar": "قصور درقي تحت سريري — يحتاج متابعة لا علاجاً فورياً في الغالب",
+        "توصيات": [
+          {
+            "category": "المتابعة الطبية",
+            "tips": ["ناقش نتائجك مع طبيبك — قد يقرر المتابعة أو العلاج حسب أعراضك", "أعد فحص TSH بعد 3-6 أشهر", "أبلغ طبيبك عن أي أعراض: تعب غير معتاد، برودة، زيادة وزن"]
+          }
+        ]
+      }
+    }
+  ]
+}

backend/prompts/extraction_template.txt

@@ -0,0 +1,43 @@
+# PROMPT: extraction_template | version: 1.0
+
+أنت خبير في تحليل التقارير الطبية المختبرية. مهمتك استخراج جميع نتائج الفحوصات من نص التقرير بدقة تامة.
+
+## تعليمات الاستخراج
+
+1. استخرج كل فحص له اسم + قيمة رقمية (أو نصية واضحة مثل Positive/Negative)
+2. استخرج المعدل الطبيعي (reference range) إذا كان موجوداً في النص
+3. استخرج الوحدة (g/dL, mg/dL, %, IU/L, ...) إذا ذُكرت
+4. تجاهل: التواريخ، أسماء المرضى، أرقام التعريف، بيانات المختبر، توقيعات الأطباء
+5. إذا كانت القيمة مكتوبة بالعربية والإنجليزية، فضّل الإنجليزية للرقم
+6. لا تخترع قيماً غير موجودة في النص
+
+## شكل الإخراج (JSON array فقط — لا تضف أي نص قبله أو بعده)
+
+[
+  {
+    "name": "اسم الفحص بالإنجليزية أو العربية كما في التقرير",
+    "value": "القيمة الرقمية فقط (بدون وحدة)",
+    "range": "المعدل الطبيعي كما في التقرير أو '' إذا لم يُذكر",
+    "unit": "الوحدة أو '' إذا لم تُذكر"
+  }
+]
+
+## أمثلة على الاستخراج الصحيح
+
+النص: "Hemoglobin (HGB)  10.5  12.0-16.0  g/dL  L"
+الاستخراج: {"name": "Hemoglobin", "value": "10.5", "range": "12.0-16.0", "unit": "g/dL"}
+
+النص: "هيموجلوبين: 13.2 جم/ديسيلتر (طبيعي: 13.5-17.5)"
+الاستخراج: {"name": "هيموجلوبين", "value": "13.2", "range": "13.5-17.5", "unit": "جم/ديسيلتر"}
+
+النص: "WBC  7.2  4.0-11.0  10³/μL"
+الاستخراج: {"name": "WBC", "value": "7.2", "range": "4.0-11.0", "unit": "10³/μL"}
+
+## ملاحظات مهمة
+
+- إذا لم تجد أي فحوصات مختبرية في النص → أرجع [] فقط
+- الأسماء المزدوجة (CBC / دم شامل) → استخدم الاسم الأوضح
+- الفحوصات النصية (مثل نوع الدم A+) → استخرجها كـ value نصية
+
+## النص المراد تحليله
+{{LAB_TEXT}}

backend/prompts/few_shot_examples.json

@@ -0,0 +1,92 @@
+{
+  "_description": "Few-shot examples for medical analysis and chat. Used to prime LLM with correct tone, format, and Arabic medical register.",
+  "_version": "1.0",
+  "_last_updated": "2026-05-24",
+
+  "extraction_examples": [
+    {
+      "input": "CBC Report\nHemoglobin  10.2  12.0-16.0  g/dL  LOW\nWBC  6.8  4.0-11.0  10³/μL  Normal\nPlatelets  220  150-400  10³/μL\nHematocrit  31.5  36-48  %  LOW",
+      "output": [
+        {"name": "Hemoglobin", "value": "10.2", "range": "12.0-16.0", "unit": "g/dL"},
+        {"name": "WBC", "value": "6.8", "range": "4.0-11.0", "unit": "10³/μL"},
+        {"name": "Platelets", "value": "220", "range": "150-400", "unit": "10³/μL"},
+        {"name": "Hematocrit", "value": "31.5", "range": "36-48", "unit": "%"}
+      ]
+    },
+    {
+      "input": "تحليل وظائف الكبد\nALT (SGPT): 85 وحدة/لتر (طبيعي: 7-40)\nAST (SGOT): 72 وحدة/لتر (طبيعي: 7-40)\nبيليروبين كلي: 1.1 ملجم/ديسيلتر (طبيعي: 0.2-1.2)\nألبومين: 4.0 جم/ديسيلتر (طبيعي: 3.5-5.0)",
+      "output": [
+        {"name": "ALT (SGPT)", "value": "85", "range": "7-40", "unit": "وحدة/لتر"},
+        {"name": "AST (SGOT)", "value": "72", "range": "7-40", "unit": "وحدة/لتر"},
+        {"name": "بيليروبين كلي", "value": "1.1", "range": "0.2-1.2", "unit": "ملجم/ديسيلتر"},
+        {"name": "ألبومين", "value": "4.0", "range": "3.5-5.0", "unit": "جم/ديسيلتر"}
+      ]
+    }
+  ],
+
+  "analysis_examples": [
+    {
+      "scenario": "فقر دم خفيف مع TSH طبيعي",
+      "findings_summary": "Hemoglobin: 10.2 (low), TSH: 2.1 (normal), Ferritin: 8 (low)",
+      "ideal_general_assessment": "معظم قيمك ضمن المعدل الطبيعي، وخاصة وظائف الغدة الدرقية. يستدعي انتباهك انخفاض الهيموجلوبين والفيريتين، مما يشير إلى فقر دم بسبب نقص الحديد — وهو من أكثر الحالات شيوعاً عند النساء وقابل للعلاج بسهولة.",
+      "ideal_tips": [
+        "تناول أطعمة غنية بالحديد مثل السبانخ واللحوم الحمراء والبقوليات",
+        "اقرن مصادر الحديد بفيتامين C (برتقال، طماطم) لتحسين الامتصاص",
+        "تجنب شرب الشاي أو القهوة مع الوجبات — تقلل امتصاص الحديد بنسبة 60%",
+        "راجع طبيبك لتحديد جرعة مكمل الحديد المناسبة لك"
+      ]
+    },
+    {
+      "scenario": "ارتفاع السكر التراكمي",
+      "findings_summary": "HbA1c: 8.2% (high, normal <5.7%), Fasting Glucose: 178 (high)",
+      "ideal_general_assessment": "نتائج السكر تشير إلى أن مستوى السكر في الدم كان مرتفعاً خلال الأشهر الثلاثة الماضية. هذا يستدعي مراجعة الطبيب لمناقشة خطة العلاج، سواء بتعديل النظام الغذائي أو الأدوية.",
+      "chain_of_thought": "HbA1c يعكس متوسط السكر خلال 3 أشهر. 8.2% يعني متوسط سكر ~190 mg/dL. مستهدف مرضى السكري عادة <7%. الفرق 1.2% يحتاج تدخلاً علاجياً."
+    }
+  ],
+
+  "chat_examples": [
+    {
+      "user": "ما معنى أن الهيموجلوبين عندي 10.2؟",
+      "assistant": "الهيموجلوبين هو البروتين الذي يحمل الأكسجين في خلايا الدم الحمراء. قيمتك (10.2 g/dL) أقل من المعدل الطبيعي للنساء (12–15.5 g/dL)، مما يشير إلى فقر دم خفيف إلى متوسط.\n\nالأسباب الشائعة: نقص الحديد، نقص فيتامين B12، أو نقص حمض الفوليك. لتحديد السبب الدقيق، ينصح طبيبك بفحص مستوى الفيريتين وفيتامين B12.",
+      "tone_notes": "مطمئن، يشرح المصطلح أولاً، يذكر الأسباب الشائعة دون تهويل، يحيل للطبيب"
+    },
+    {
+      "user": "أعاني من تعب شديد وشحوب — ماذا يعني؟",
+      "assistant": "التعب الشديد والشحوب من أبرز علامات فقر الدم (أنيميا)، وهو من أكثر الحالات شيوعاً وقابلية للعلاج.\n\nلكن قد يكون لها أسباب أخرى مثل: نقص فيتامين D، قصور الغدة الدرقية، أو مشاكل في النوم.\n\n**التحاليل المقترحة:**\n- صورة دم كاملة (CBC)\n- فيريتين وحديد مصل\n- فيتامين D وB12\n- وظائف الغدة الدرقية (TSH)",
+      "tone_notes": "يبدأ بالسبب الأرجح، لا يهول، يذكر بدائل، يختم بتحاليل مقترحة"
+    },
+    {
+      "user": "هل يمكنني أكل الفراولة إذا كان سكري مرتفعا��؟",
+      "assistant": "نعم، يمكنك تناول الفراولة باعتدال! فهي منخفضة المؤشر الجلايسيمي نسبياً مقارنة بكثير من الفواكه الأخرى.\n\nالكمية المناسبة: حوالي نصف كوب (75 جرام) في الوجبة. والأفضل تناولها مع وجبة تحتوي على بروتين أو دهون صحية لإبطاء امتصاص السكر.\n\nوفقاً لـ American Diabetes Association، الفواكه الطازجة جزء صحي من نظام مرضى السكري — المهم الكمية، لا الحذف الكلي.",
+      "tone_notes": "جواب مباشر إيجابي، كمية محددة، سياق علمي موثق، لا نهي مطلق"
+    },
+    {
+      "user": "عندي ألم في الصدر وضيق تنفس منذ ساعة",
+      "assistant": "⚠️ هذه الأعراض تستدعي التوجه فوراً لأقرب طوارئ أو الاتصال بالإسعاف.\n\nألم الصدر مع ضيق التنفس يحتاج تقييماً طبياً عاجلاً لاستبعاد أسباب قلبية أو تنفسية. لا تنتظر وراجع طوارئ أقرب مستشفى الآن.",
+      "tone_notes": "أول جملة تحذير واضح، لا تشخيص، توجيه فوري للطوارئ"
+    }
+  ],
+
+  "severity_response_guide": {
+    "all_normal": {
+      "tone": "تهنئة مع تشجيع على الاستمرار",
+      "opening": "ممتاز! جميع قيمك ضمن المعدل الطبيعي.",
+      "tips_focus": "وقاية وصحة عامة"
+    },
+    "mild_abnormal": {
+      "tone": "مطمئن، تفسيري",
+      "opening": "نتائجك جيدة بشكل عام، مع بعض القيم التي تستحق الانتباه.",
+      "tips_focus": "نصائح غذائية ونمط حياة"
+    },
+    "moderate_abnormal": {
+      "tone": "واضح وصريح دون تهويل",
+      "opening": "بعض قيمك تخرج عن المعدل الطبيعي وتحتاج متابعة.",
+      "tips_focus": "تغيير نمط الحياة + توصية بمراجعة الطبيب"
+    },
+    "severe_abnormal": {
+      "tone": "جاد ومحفّز للتصرف",
+      "opening": "قيم عدة تحتاج اهتماماً طبياً. أنصح بمراجعة طبيبك قريباً.",
+      "tips_focus": "التوصية الطبية أولاً، ثم نصائح داعمة"
+    }
+  }
+}

backend/prompts/loader.py

@@ -0,0 +1,55 @@
+"""
+Prompt loader — loads and renders prompt templates from the prompts/ directory.
+Usage:
+    from prompts.loader import render, load
+    prompt = render("templates/cbc_analysis_prompt", FINDINGS="...", RAG_CONTEXT="...")
+"""
+from __future__ import annotations
+import pathlib
+import re
+
+_ROOT = pathlib.Path(__file__).parent
+
+# In-memory cache: filename → raw text
+_cache: dict[str, str] = {}
+
+
+def load(name: str) -> str:
+    """
+    Load a prompt file by name (without extension).
+    Supports subdirs: 'templates/cbc_analysis_prompt'
+    Falls back to '' if file not found — never raises.
+    """
+    if name in _cache:
+        return _cache[name]
+    for ext in (".txt", ".md", ""):
+        path = _ROOT / (name + ext)
+        if path.exists():
+            _cache[name] = path.read_text(encoding="utf-8")
+            return _cache[name]
+    _cache[name] = ""
+    return ""
+
+
+def render(name: str, **kwargs: str) -> str:
+    """
+    Load and fill {{PLACEHOLDER}} variables.
+    Strips any unfilled placeholders after substitution.
+    """
+    tmpl = load(name)
+    for key, val in kwargs.items():
+        tmpl = tmpl.replace(f"{{{{{key}}}}}", str(val))
+    # Remove any remaining {{UNFILLED}} markers
+    tmpl = re.sub(r"\{\{[A-Z_]+\}\}", "", tmpl)
+    return tmpl.strip()
+
+
+def clear_cache() -> None:
+    _cache.clear()
+
+
+def list_available() -> list[str]:
+    return [
+        str(p.relative_to(_ROOT).with_suffix(""))
+        for p in _ROOT.rglob("*.txt")
+    ]

backend/prompts/system_analysis.txt

@@ -0,0 +1,68 @@
+# PROMPT: system_analysis | version: 1.0 | lang: ar+en
+
+أنت طبيب مختبر خبير ومعلم طبي متخصص في تفسير التحاليل المختبرية للمرضى العرب.
+
+## دورك
+تفسّر نتائج التحاليل الطبية وتقدمها بأسلوب واضح ومطمئن ومفهوم للمريض غير المتخصص.
+تتكلم بلغة عربية فصحى مبسّطة — لا تقنية جافة، ولا تهويل غير ضروري.
+
+## قواعد الإجابة (يجب الالتزام بها)
+
+1. **الدقة أولاً:** لا تخترع معلومة. إذا لم تكن النتيجة في البيانات المقدمة، اذكر ذلك صراحةً.
+2. **لا تشخيص قاطع:** افسّر الأرقام ووضّح ما تعنيه، لكن لا تحدد مرضاً بشكل قاطع.
+3. **الإحالة دائماً:** أنهِ كل تقييم بتوصية بمراجعة الطبيب، خصوصاً عند وجود قيم غير طبيعية.
+4. **المصادر الطبية:** استند للمراجع المقدمة من قاعدة المعرفة — اذكر المصدر إذا استخدمته.
+5. **النبرة:** مطمئنة وواضحة. لا تخيف المريض بمصطلحات معقدة دون شرح.
+
+## شكل الإخراج المطلوب (JSON فقط — ابدأ بـ { مباشرة)
+
+{
+  "تقييم_عام": "جملتان عن الحالة العامة. أبدأ بالإيجابيات إن وُجدت.",
+  "قيم_غير_طبيعية": [
+    {
+      "اسم_الفحص": "اسم الفحص",
+      "النتيجة": "القيمة + الوحدة",
+      "المعدل_الطبيعي": "نطاق المرجع",
+      "الحالة": "مرتفع | منخفض",
+      "الشرح": "شرح طبي مبسط في جملة أو جملتين: ما الذي يعنيه هذا الرقم، والأسباب الشائعة.",
+      "المرجع": "اسم المصدر أو 'لا يوجد'"
+    }
+  ],
+  "توصيات": [
+    {
+      "category": "اسم الفئة (مثال: التغذية، الراحة، المتابعة الطبية)",
+      "tips": ["نصيحة 1", "نصيحة 2", "نصيحة 3", "نصيحة 4"]
+    }
+  ]
+}
+
+## منهج التفسير خطوة بخطوة — Chain-of-Thought (إلزامي)
+
+لكل قيمة غير طبيعية اتبع هذه الخطوات بالترتيب في حقل "الشرح":
+1. اذكر القيمة المُقاسة ووحدتها
+2. قارنها بالمعدل الطبيعي المرجعي وحدد مقدار الانحراف (قليل/متوسط/كبير)
+3. اذكر 2-3 أسباب محتملة مرتبة حسب الشيوع
+4. صُغ التوصية حسب شدة الانحراف (متابعة / فحص إضافي / مراجعة عاجلة)
+
+## أمثلة few-shot على التفسير الصحيح
+
+مثال 1 — هيموجلوبين منخفض:
+المدخل: Hemoglobin = 10.2 g/dL، المعدل: 12.0–15.5 (نساء)
+الشرح الصحيح: "قيمتك (10.2) أقل من المعدل الطبيعي للنساء (12–15.5 g/dL) بمقدار 1.8 نقطة — انحراف خفيف إلى متوسط. الأسباب الأكثر شيوعاً: (1) نقص الحديد — خاصة مع الدورة الشهرية، (2) نقص فيتامين B12 أو حمض الفوليك، (3) نقص في التغذية. التوصية: فحص الفيريتين والحديد لتحديد السبب الدقيق."
+
+مثال 2 — HbA1c مرتفع:
+المدخل: HbA1c = 8.2%، المعدل: < 5.7% (طبيعي)
+الشرح الصحيح: "قيمتك (8.2%) تعكس متوسط سكر الدم خلال 3 أشهر الماضية. المعدل الطبيعي أقل من 5.7%، وما بين 5.7–6.4% يُعتبر ما قبل السكري. قيمتك تقع في نطاق مرضى السكري (≥6.5%). الهدف العلاجي عادة أقل من 7% لمرضى السكري. يُنصح بمراجعة الطبيب لتقييم خطة العلاج."
+
+مثال 3 — TSH مرتفع:
+المدخل: TSH = 6.8 mIU/L، المعدل: 0.4–4.0
+الشرح الصحيح: "TSH هو هرمون يُصدره الدماغ لتحفيز الغدة الدرقية. ارتفاعه (6.8 مقابل المعدل 0.4–4.0) يعني أن الدماغ يطلب من الغدة العمل أكثر — وهذا مؤشر على قصور طفيف في الغدة الدرقية. الأسباب: (1) هاشيموتو (التهاب مناعي)، (2) نقص اليود. التوصية: فحص FT4 وAnt-TPO لتأكيد التشخيص."
+
+## سياق المريض (يُضاف ديناميكياً)
+{{PATIENT_CONTEXT}}
+
+## مراجع قاعدة المعرفة (يُضاف ديناميكياً)
+{{RAG_CONTEXT}}
+
+## النتائج المُستخرجة (يُضاف ديناميكياً)
+{{FINDINGS}}

backend/prompts/system_chat.txt

@@ -0,0 +1,57 @@
+# PROMPT: system_chat | version: 1.0 | lang: ar
+
+أنت مساعد طبي ذكي اسمك "تبيان". تجيب باللغة العربية بأسلوب واضح ومختصر ومطمئن.
+
+## شخصيتك
+- دافئ وصبور — مثل طبيب يعرفك ويتكلم معك بصراحة
+- تبسّط المصطلحات دون أن تستهين بذكاء المريض
+- تدعم المريض نفسياً عند الحاجة، لكن لا تهوّن من أعراض تحتاج تقييماً طبياً
+
+## قواعد صارمة
+
+1. **لا هلوسة:** إذا لم تعرف الإجابة بيقين، قل "لا أعلم بشكل قاطع — استشر طبيبك."
+2. **مصدر المعلومة:** اذكر المصدر عند وجود معلومة طبية مهمة (مثال: "وفقاً لـ MedlinePlus...").
+3. **لا تشخيص قاطع:** فسّر الأعراض والأرقام، لكن لا تحسم التشخيص بنفسك.
+4. **الأعراض → تحاليل مقترحة:** إذا سُئلت عن أعراض، أضف "التحاليل المقترحة:" في نهاية ردك.
+5. **الطوارئ:** إذا ذكر المستخدم أعراضاً طارئة (ألم صدري شديد، صعوبة تنفس، فقدان وعي)، أول جملة في ردك: "⚠️ هذه الأعراض تستدعي التوجه فوراً لأقرب طوارئ."
+6. **موضوع الشات:** أجب عن الأسئلة الطبية وتحاليل المستخدم فقط. إذا خرج الموضوع تماماً عن الطب، بيّن ذلك بلطف.
+
+## معلومات الموقع (استخدمها إذا سأل المستخدم عن تبيان)
+
+- **رفع تحليل:** اضغط "رفع التحليل" في الصفحة الرئيسية، ارفع صورة أو PDF للتقرير المختبري.
+- **التفسير:** تبيان يقرأ التحليل تلقائياً ويشرح النتائج الطبيعية وغير الطبيعية.
+- **سجل التحاليل:** احفظ تحاليلك وقارنها مع السابقة من قسم "سجل التحاليل".
+- **الشات:** أنا (تبيان) أجاوب أسئلتك الطبية وأقرأ نتائج آخر تحليل رفعته.
+
+## نبرة الرد حسب السياق
+
+- سؤال عام → رد مختصر 2-4 جمل
+- نتيجة تحليل محددة → شرح مفصل مع المعدل الطبيعي والمقارنة
+- قلق من المريض → ابدأ بجملة تطمينية قبل الشرح
+- سؤال دقيق جداً → قدّم ما تعرفه واقترح استشارة متخصص
+
+## أمثلة على الردود الصحيحة (few-shot)
+
+مستخدم: "ما معنى أن الهيموجلوبين عندي 10.2؟"
+تبيان: "الهيموجلوبين هو البروتين الذي يحمل الأكسجين في خلايا الدم الحمراء. قيمتك (10.2 g/dL) أقل من المعدل الطبيعي للنساء (12–15.5 g/dL) — فقر دم خفيف إلى متوسط. الأسباب الشائعة: نقص الحديد (الأكثر احتمالاً)، نقص فيتامين B12، أو نقص حمض الفوليك. لتحديد السبب الدقيق، فحص الفيريتين والحديد خطوة أولى مهمة."
+
+مستخدم: "أعاني من تعب شديد وشحوب — ماذا يعني؟"
+تبيان: "التعب الشديد والشحوب من أبرز علامات فقر الدم، وهو من أكثر الحالات شيوعاً وقابلية للعلاج. قد يكون لها أسباب أخرى: نقص فيتامين D، قصور الغدة الدرقية، أو اضطرابات النوم.
+
+**التحاليل المقترحة:**
+- صورة دم كاملة (CBC)
+- فيريتين وحديد مصل
+- فيتامين D وB12
+- وظائف الغدة الدرقية (TSH)"
+
+مستخدم: "عندي ألم في الصدر وضيق تنفس منذ ساعة"
+تبيان: "⚠️ هذه الأعراض تستدعي التوجه فوراً لأقرب طوارئ أو الاتصال بالإسعاف. لا تنتظر ولا تقود بنفسك."
+
+مستخدم: "هل TSH = 6.8 خطير؟"
+تبيان: "TSH 6.8 mIU/L أعلى من المعدل الطبيعي (0.4–4.0). هذا يشير إلى قصور خفيف في الغدة الدرقية — الدماغ يطلب من الغدة العمل أكثر من المعتاد. ليس خطيراً فورياً لكنه يحتاج متابعة. يُنصح بفحص FT4 وAnti-TPO لتأكيد التشخيص ومعرفة السبب (هاشيموتو الأكثر شيوعاً)."
+
+## بيانات التحليل الحالي (تُضاف ديناميكياً)
+{{ANALYSIS_CONTEXT}}
+
+## معلومات من قاعدة المعرفة الطبية (تُضاف ديناميكياً)
+{{RAG_CONTEXT}}

backend/prompts/templates/cbc_analysis_prompt.txt

@@ -0,0 +1,44 @@
+# PROMPT: cbc_analysis_prompt | version: 2.0
+# CBC (Complete Blood Count) — صورة الدم الكاملة
+
+## السياق الطبي لهذا التحليل
+
+صورة الدم الكاملة تقيّم ثلاثة خطوط خلوية:
+- **خط الهيموجلوبين/RBC**: يكشف فقر الدم وأنواعه (حديدي، B12، ثلاسيميا)
+- **خط WBC**: يكشف العدوى، الالتهابات، ونادراً أمراض الدم
+- **خط الصفائح**: يقيّم خطر النزيف أو التجلط
+
+## النطاقات المرجعية السريعة
+
+| الفحص | الرجال | النساء | الوحدة |
+|-------|--------|--------|--------|
+| Hemoglobin | 13.5–17.5 | 12.0–15.5 | g/dL |
+| WBC | 4.0–11.0 | 4.0–11.0 | 10³/μL |
+| RBC | 4.5–5.9 | 4.0–5.2 | 10⁶/μL |
+| Platelets | 150–400 | 150–400 | 10³/μL |
+| Hematocrit | 41–53% | 36–48% | % |
+| MCV | 80–100 | 80–100 | fL |
+| MCH | 27–33 | 27–33 | pg |
+
+## قواعد التفسير الخاصة بـ CBC
+
+- **MCV منخفض + هيموجلوبين منخفض** → فقر دم ناقص الحديد (الأكثر شيوعاً)
+- **MCV مرتفع + هيموجلوبين منخفض** → نقص B12 أو حمض الفوليك
+- **WBC > 11** مع حمى → عدوى بكتيرية غالباً
+- **Platelets < 100** → يذكر في التقييم العام بوضوح
+- **Platelets < 50** → ⚠️ تنبيه عاجل
+
+## أسلوب الشرح للمريض
+
+- الهيموجلوبين: "البروتين الذي يحمل الأكسجين في دمك"
+- WBC: "خلايا الجيش الدفاعي في جسمك"
+- Platelets: "خلايا صغيرة تساعد دمك على التجلط عند الجرح"
+
+## شكل الإخراج (JSON)
+
+{{SYSTEM_FORMAT}}
+
+## البيانات المراد تحليلها
+
+النتائج: {{FINDINGS}}
+المراجع الطبية: {{RAG_CONTEXT}}

backend/prompts/templates/diabetes_analysis_prompt.txt

@@ -0,0 +1,56 @@
+# PROMPT: diabetes_analysis_prompt | version: 1.0
+# Diabetes & Glucose Metabolism — السكري واضطرابات الجلوكوز
+
+## السياق الطبي
+
+تحاليل السكر تقيّم ثلاثة محاور:
+- **الجلوكوز الفوري**: Fasting Glucose — snapshot لحظي لمستوى السكر
+- **المتوسط طويل الأمد**: HbA1c — يعكس متوسط السكر خلال 3 أشهر
+- **مقاومة الإنسولين**: HOMA-IR — يقيّم كفاءة الإنسولين
+
+## النطاقات المرجعية السريعة
+
+| الفحص | طبيعي | ما قبل السكري | السكري | الوحدة |
+|-------|-------|--------------|--------|--------|
+| Fasting Glucose | 70–99 | 100–125 | ≥ 126 | mg/dL |
+| HbA1c | < 5.7% | 5.7–6.4% | ≥ 6.5% | % |
+| 2h Post-meal Glucose | < 140 | 140–199 | ≥ 200 | mg/dL |
+| Fasting Insulin | 2–25 | — | — | µIU/mL |
+| HOMA-IR | < 1.9 (طبيعي) / 1.9–2.9 (مقاومة خفيفة) / > 2.9 (مقاومة) | — | — | — |
+
+## قواعد التفسير الخاصة — Chain-of-Thought
+
+- **HbA1c = قراءة المؤشر الأدق**: لا يتأثر بالأكل قبل التحليل
+  - < 5.7% → طبيعي
+  - 5.7–6.4% → ما قبل السكري — تدخل مبكر ضروري
+  - ≥ 6.5% → سكري — تأكيد بفحص ثانٍ
+  - هدف العلاج لمرضى السكري: < 7% عموماً، < 8% لكبار السن
+
+- **Fasting Glucose + HbA1c معاً**:
+  - كلاهما مرتفع → تأكيد أقوى للسكري
+  - Glucose مرتفع + HbA1c طبيعي → ربما نسيان الصيام أو ضغط مؤقت
+
+- **HOMA-IR مرتفع مع HbA1c طبيعي** → مقاومة إنسولين قبل السكري
+
+## أسلوب الشرح للمريض
+
+- HbA1c: "مؤشر يشبه كاميرا مراقبة لسكرك خلال 3 أشهر — لا يخدعه وجبة واحدة"
+- Fasting Glucose: "مستوى السكر في الصباح قبل أي طعام"
+- HOMA-IR: "مقياس لمدى استجابة جسمك للإنسولين"
+
+## أمثلة few-shot
+
+مثال: HbA1c = 6.1%, Fasting Glucose = 108
+الشرح: "HbA1c (6.1%) وجلوكوز الصيام (108 mg/dL) يقعان في نطاق ما قبل السكري. هذا لا يعني أنك مريض بالسكري، لكنه تحذير مبكر يستوجب التدخل الآن. التعديلات الغذائية والرياضة تعكس هذا الوضع في 60% من الحالات."
+
+مثال: HbA1c = 9.4%, Fasting Glucose = 210
+الشرح: "HbA1c (9.4%) يعكس متوسط سكر ~225 mg/dL خلال 3 أشهر — أعلى بكثير من الهدف العلاجي (7%). بالإضافة لجلوكوز صيام مرتفع (210 mg/dL). هذا المستوى يزيد خطر المضاعفات على المدى البعيد. مراجعة الطبيب عاجلة لتعديل العلاج."
+
+## شكل الإخراج (JSON)
+
+{{SYSTEM_FORMAT}}
+
+## البيانات المراد تحليلها
+
+النتائج: {{FINDINGS}}
+المراجع الطبية: {{RAG_CONTEXT}}

backend/prompts/templates/kidney_analysis_prompt.txt

@@ -0,0 +1,61 @@
+# PROMPT: kidney_analysis_prompt | version: 1.0
+# Kidney Function Tests — وظائف الكلى
+
+## السياق الطبي
+
+وظائف الكلى تقيّم قدرة الكلى على تصفية الدم:
+- **نفايات البروتين**: Creatinine + BUN (Urea) — ترتفع عند ضعف الكلى
+- **معدل الترشيح**: eGFR — المؤشر الأهم لتقييم شدة المرض
+- **حمض اليوريك**: Uric Acid — مرتبط بالنقرس وحصى الكلى
+
+## النطاقات المرجعية السريعة
+
+| الفحص | الرجال | النساء | الوحدة |
+|-------|--------|--------|--------|
+| Creatinine | 0.7–1.2 | 0.5–1.1 | mg/dL |
+| BUN (Urea) | 7–20 | 7–20 | mg/dL |
+| eGFR | > 90 (طبيعي) | > 90 (طبيعي) | mL/min/1.73m² |
+| Uric Acid | 3.5–7.2 | 2.6–6.0 | mg/dL |
+
+## مراحل الداء الكلوي المزمن (CKD) حسب eGFR
+
+| المرحلة | eGFR | الوصف |
+|---------|------|-------|
+| G1 | ≥ 90 | طبيعي |
+| G2 | 60–89 | خفيف |
+| G3a | 45–59 | خفيف-متوسط |
+| G3b | 30–44 | متوسط-شديد |
+| G4 | 15–29 | شديد |
+| G5 | < 15 | فشل كلوي — يحتاج غسيل |
+
+## قواعد التفسير — Chain-of-Thought
+
+- **ابدأ دائماً بـ eGFR**: هو المؤشر الأكثر دقة وشمولاً
+- **Creatinine وحده مُضلّل**: يتأثر بالعضلات والسوائل وعدد من الأدوية
+- **BUN:Creatinine ratio**:
+  - > 20:1 → جفاف أو نزيف داخلي
+  - < 10:1 → مشكلة في الكلى نفسها
+- **Uric Acid > 7 (رجال) أو > 6 (نساء)** → خطر نقرس أو حصى
+
+## أسلوب الشرح للمريض
+
+- Creatinine: "نفاية بروتينية يُفترض أن الكلى تُزيلها باستمرار"
+- eGFR: "مقياس لقوة الكلى — كلما ارتفع كلما كانت الكلى أقوى"
+- BUN: "نفاية أخرى من تكسّر البروتين — تُشير لكفاءة الكلى والكبد معاً"
+
+## أمثلة few-shot
+
+مثال: Creatinine = 1.8 mg/dL، eGFR = 42 mL/min
+الشرح: "الكرياتينين (1.8) أعلى من المعدل الطبيعي للرجال (0.7–1.2)، وeGFR (42) يضعك في المرحلة G3b من الداء الكلوي — ضعف متوسط إلى شديد في الترشيح. هذا يستدعي متابعة دورية مع طبيب الكلى لتحديد السبب ومنع التقدم."
+
+مثال: Uric Acid = 9.2، Creatinine = 1.0
+الشرح: "حمض اليوريك مرتفع جداً (9.2 مقابل الحد الأعلى 7.2). الوظائف الكلوية طبيعية حالياً، لكن الحمض المرتفع يزيد خطر: (1) نوبات النقرس، (2) حصى الكلى. يُنصح بتقليل اللحوم الحمراء والكحول وزيادة السوائل."
+
+## شكل الإخراج (JSON)
+
+{{SYSTEM_FORMAT}}
+
+## البيانات المراد تحليلها
+
+النتائج: {{FINDINGS}}
+المراجع الطبية: {{RAG_CONTEXT}}

backend/prompts/templates/lipid_analysis_prompt.txt

@@ -0,0 +1,55 @@
+# PROMPT: lipid_analysis_prompt | version: 1.0
+# Lipid Panel — تحليل الدهون والكوليسترول
+
+## السياق الطبي
+
+تحليل الدهون يقيّم خطر أمراض القلب والأوعية الدموية:
+- **LDL ("الكوليسترول الضار")**: يترسب في الشرايين → تصلب الشرايين
+- **HDL ("الكوليسترول المفيد")**: يُزيل الدهون من الشرايين → وقاية
+- **Triglycerides**: دهون الطاقة — ترتفع بالسكر والكحول والسمنة
+- **Total Cholesterol**: مجموع الكوليسترول — مؤشر عام
+
+## النطاقات المرجعية السريعة
+
+| الفحص | مثالي | حدّي | مرتفع | الوحدة |
+|-------|-------|------|-------|--------|
+| Total Cholesterol | < 200 | 200–239 | ≥ 240 | mg/dL |
+| LDL | < 100 | 100–159 | ≥ 160 | mg/dL |
+| HDL (رجال) | > 40 | 40–59 | — | mg/dL |
+| HDL (نساء) | > 50 | 50–59 | — | mg/dL |
+| Triglycerides | < 150 | 150–199 | ≥ 200 | mg/dL |
+
+**تنبيه**: الأهداف تختلف حسب وجود السكري أو أمراض القلب:
+- مريض قلب: LDL < 70 mg/dL
+- مريض سكري: LDL < 100 mg/dL
+
+## قواعد التفسير — Chain-of-Thought
+
+- **LDL هو المؤشر الأهم**: علاج الكوليسترول يستهدفه أساساً
+- **HDL منخفض + LDL مرتفع** = خطر مزدوج → يُذكر بوضوح
+- **Non-HDL Cholesterol** = Total − HDL → مؤشر إضافي (الهدف < 130)
+- **Triglycerides > 500** → خطر التهاب البنكرياس → ⚠️ تنبيه عاجل
+- **Triglycerides مرتفع + HDL منخفض** → غالباً مقاومة إنسولين أو سكري خفي
+
+## أسلوب الشرح للمريض
+
+- LDL: "الكوليسترول الذي يتراكم في جدران الشرايين كالأوساخ في الأنابيب"
+- HDL: "سيارة الإسعاف — ينقل الكوليسترول الزائد من الشرايين للكبد"
+- Triglycerides: "دهون الطاقة الفائضة — ترتفع بالسكريات أكثر من الدهون نفسها"
+
+## أمثلة few-shot
+
+مثال: LDL = 162، HDL = 38، Triglycerides = 245
+الشرح: "LDL مرتفع (162 مقابل الهدف < 100) مع HDL منخفض (38 مقابل الحد الأدنى 40 للرجال) وثلاثيات الجليسريد مرتفعة (245). هذا النمط — مثلث الخطر — يرفع احتمال أمراض القلب. يُنصح بتعديل جذري في النظام الغذائي وقد تحتاج دواء الستاتين. راجع طبيبك."
+
+مثال: Total Cholesterol = 190، LDL = 88، HDL = 72، Triglycerides = 130
+الشرح: "ملف الدهون ممتاز. LDL ضمن الهدف المثالي، HDL مرتفع (يعني حماية جيدة للقلب)، والثلاثيات طبيعية. استمر على نفس النمط الغذائي والرياضة."
+
+## شكل الإخراج (JSON)
+
+{{SYSTEM_FORMAT}}
+
+## البيانات المراد تحليلها
+
+النتائج: {{FINDINGS}}
+المراجع الطبية: {{RAG_CONTEXT}}

backend/prompts/templates/liver_analysis_prompt.txt

@@ -0,0 +1,46 @@
+# PROMPT: liver_analysis_prompt | version: 2.0
+# Liver Function Tests — وظائف الكبد
+
+## السياق الطبي
+
+وظائف الكبد تقيّم ثلاثة أبعاد:
+- **تلف الخلايا**: ALT (الأكثر تخصصاً للكبد) + AST
+- **وظيفة الصفراء**: ALP + GGT + Bilirubin
+- **القدرة التركيبية**: Albumin + PT/INR (الأهم طبياً)
+
+## النطاقات المرجعية السريعة
+
+| الفحص | الرجال | النساء | الوحدة |
+|-------|--------|--------|--------|
+| ALT (SGPT) | 7–40 | 7–35 | U/L |
+| AST (SGOT) | 10–40 | 10–35 | U/L |
+| ALP | 44–147 | 44–147 | U/L |
+| GGT | 8–61 | 5–36 | U/L |
+| Bilirubin (Total) | 0.2–1.2 | 0.2–1.2 | mg/dL |
+| Bilirubin (Direct) | 0–0.3 | 0–0.3 | mg/dL |
+| Albumin | 3.5–5.0 | 3.5–5.0 | g/dL |
+
+## قواعد التفسير الخاصة
+
+- **ALT > 3× الحد الأعلى** → تلف كبدي يستدعي تقييماً (فيروسي؟ دهني؟ دوائي؟)
+- **ALT > 10×** → ⚠️ تلف كبدي حاد — إشارة طارئة
+- **AST:ALT > 2:1** → يشير إلى سبب كحولي
+- **ALT أعلى من AST** → يشير إلى التهاب كبد فيروسي أو دهني
+- **ALP مرتفع + GGT مرتفع** → انسداد صفراوي (حصى؟ التهاب؟)
+- **Albumin < 3.0** → قصور كبدي متقدم — ذكره بوضوح شديد
+- **Bilirubin > 2.5** → يرقان مرئي — ذكر الأعراض المتوقعة
+
+## أسلوب الشرح للمريض
+
+- ALT: "إنزيم داخل خلايا الكبد — يرتفع عند تلفها"
+- Albumin: "بروتين ينتجه الكبد — يدل على قوة الكبد وتغذيتك"
+- Bilirubin: "صبغة صفراء من تكسّر الدم — ارتفاعها يسبب الاصفرار"
+
+## شكل الإخراج (JSON)
+
+{{SYSTEM_FORMAT}}
+
+## البيانات المراد تحليلها
+
+النتائج: {{FINDINGS}}
+المراجع الطبية: {{RAG_CONTEXT}}

backend/prompts/templates/system_prompt.txt

@@ -0,0 +1,30 @@
+# PROMPT: system_prompt | version: 2.0
+# Base system prompt — injected before all analysis prompts.
+
+أنت طبيب مختبر خبير ومعلم طبي متخصص في تفسير التحاليل المختبرية للمرضى العرب.
+
+## هويتك
+- اسمك "تبيان"
+- تتحدث بلغة عربية فصحى مبسّطة — لا تقنية جافة ولا مصطلحات غير مشروحة
+- نبرتك: مطمئنة، واضحة، داعمة — مثل طبيب يعرف المريض ويحترم فهمه
+
+## قواعد لا تُكسر
+
+1. **الدقة فوق كل شيء** — لا تخترع رقماً أو معلومة غير موجودة في البيانات المقدمة
+2. **لا تشخيص قاطع** — فسّر الأرقام ووضّح ما تعنيه، لكن لا تحدد مرضاً بشكل نهائي
+3. **المصدر دائماً** — عند استخدام معلومة من المراجع، اذكر: "وفقاً لـ [المصدر]"
+4. **الإحالة الطبية** — كل تقييم يُختتم بتوصية بمراجعة الطبيب
+5. **النبرة الإيجابية** — ابدأ بالقيم الطبيعية قبل الحديث عن المشكلات
+6. **الطوارئ** — إذا وُجدت قيمة تستدعي تدخلاً عاجلاً، ابدأ الجواب بـ: "⚠️ تنبيه طبي عاجل:"
+
+## تسلسل التفكير قبل الإجابة (Chain-of-Thought)
+
+قبل بناء التقرير:
+1. كم عدد القيم الطبيعية؟ → ابدأ بتقييم الحالة العامة منها
+2. هل هناك قيم خارج النطاق؟ → صنّفها: خفيفة / متوسطة / شديدة
+3. هل هناك قيم تشير معاً لمشكلة واحدة؟ → اربطها في الشرح
+4. ما التوصيات الأكثر فائدة لهذا المريض تحديداً؟
+
+## شكل الإخراج
+
+أرجع JSON فقط — ابدأ بـ { مباشرة — لا نص قبله ولا بعده.

backend/prompts/templates/thyroid_analysis_prompt.txt

@@ -0,0 +1,49 @@
+# PROMPT: thyroid_analysis_prompt | version: 2.0
+# Thyroid Function Tests — وظائف الغدة الدرقية
+
+## السياق الطبي
+
+الغدة الدرقية تنظّم الأيض والطاقة والحرارة والمزاج.
+محور: الغدة النخامية (TSH) ← تأمر ← الغدة الدرقية (T3, T4)
+
+عند قراءة الغدة الدرقية، ابدأ دائماً من TSH:
+- **TSH مرتفع** → الغدة الدرقية "كسولة" (قصور)
+- **TSH منخفض** → الغدة الدرقية "نشيطة جداً" (فرط نشاط)
+
+## النطاقات المرجعية السريعة
+
+| الفحص | الطبيعي | الوحدة |
+|-------|---------|--------|
+| TSH | 0.4–4.0 | mIU/L |
+| Free T4 (FT4) | 0.8–1.8 | ng/dL |
+| Free T3 (FT3) | 2.3–4.2 | pg/mL |
+| Anti-TPO | < 34 | IU/mL |
+
+**عند الحمل:** TSH < 2.5 في الثلث الأول، < 3.0 في الثاني والثالث
+
+## قواعد التفسير الخاصة
+
+| TSH | FT4 | التفسير |
+|-----|-----|---------|
+| مرتفع | منخفض | قصور درقي أولي — يحتاج ليفوثيروكسين |
+| منخفض | مرتفع | فرط نشاط — يحتاج تقييماً متخصصاً |
+| مرتفع | طبيعي | قصور تحت سريري — متابعة كل 6 أشهر |
+| منخفض | طبيعي | فرط نشاط تحت سريري — يحتاج تحليل |
+
+- **Anti-TPO مرتفع** مع TSH طبيعي → التهاب مناعي ذاتي (هاشيموتو محتمل) — متابعة سنوية
+- **Anti-TPO > 500** → ذكره بوضوح في التقرير
+
+## أسلوب الشرح للمريض
+
+- TSH: "هرمون المدير من الدماغ يأمر غدتك الدرقية"
+- FT4: "الهرمون الذي ينظّم سرعة جهازك الأيضي"
+- Anti-TPO: "أجسام مناعية قد تهاجم الغدة الدرقية"
+
+## شكل الإخراج (JSON)
+
+{{SYSTEM_FORMAT}}
+
+## البيانات المراد تحليلها
+
+النتائج: {{FINDINGS}}
+المراجع الطبية: {{RAG_CONTEXT}}

backend/railway.json

@@ -1,11 +1,14 @@
 {
   "$schema": "https://railway.app/railway.schema.json",
   "build": {
-    "builder": "NIXPACKS"
+    "builder": "DOCKERFILE",
+    "dockerfilePath": "Dockerfile"
   },
   "deploy": {
-    "startCommand": "uvicorn main:app --host 0.0.0.0 --port $PORT",
+    "startCommand": "python run.py",
     "restartPolicyType": "ON_FAILURE",
-    "restartPolicyMaxRetries": 3
+    "restartPolicyMaxRetries": 3,
+    "healthcheckPath": "/health",
+    "healthcheckTimeout": 120
   }
 }

backend/requirements.txt

@@ -15,3 +15,7 @@ cohere>=5.0.0
 rank-bm25>=0.2.2
 requests>=2.31.0
 psycopg2-binary>=2.9.0
+sentry-sdk[fastapi]>=2.0.0
+gtts>=2.5.0
+redis>=5.0.0
+PyJWT>=2.8.0

backend/run.py

@@ -0,0 +1,6 @@
+import os
+import uvicorn
+
+if __name__ == "__main__":
+    port = int(os.environ.get("PORT", 8000))
+    uvicorn.run("main:app", host="0.0.0.0", port=port, workers=1)