From cb621ca5d0957117c036c32ba3952b3fc959417a Mon Sep 17 00:00:00 2001
From: "reza.g" <rezagoli.1385@gmail.com>
Date: Sun, 25 Oct 2026 22:02:40 +0330
Subject: [PATCH] =?UTF-8?q?feat(monitoring):=20multi-model=20dashboard=20v?=
 =?UTF-8?q?2.1=20=E2=80=94=20tabs,=20per-model=20records,=20voice=20playba?=
 =?UTF-8?q?ck=20+=20MinIO=20dual-write?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Problem: the dashboard was Jev-centric; NLU/arbiter/fallback DeepSeek, STT
providers and the audio-enhancer were barely visible, and stored texts/voices
had no real access path.

Bot (additive; reply path untouched):
- nlu.result now records latency_ms + the DeepSeek usage tokens
- matching.arbitration/fallback.result fill the model + latency_ms columns
  (payload unchanged; SQL coalesces column/payload so old rows still count)
- storage.py: MinIO dual-write layer — every voice (raw + denoised) and user
  attachment is mirrored fire-and-forget into bucket bot-media; the blocking
  minio SDK runs via asyncio.to_thread (senior-engineer review) so the event
  loop is never stalled; empty MINIO_* env = layer off; bucket auto-created
- requirements: minio>=7.2

Backend (admin-gated, read-only):
- GET /bot-metrics/models — one record per model (jev, deepseek-nlu,
  deepseek-arbiter, deepseek-fallback, audio-enhancer + dynamic per-provider
  STT) with calls/ok-rate/p50/p95/tokens/last-seen + version-drift vs the pin
- GET /bot-metrics/models/{id}/daily — per-model daily calls/fails/tokens/p50
- GET /bot-metrics/stages — every stage tagged with its Persian pipeline
  section (صوت/درک پیام/تطبیق/ابهام و انتخاب/پیش‌نویس)
- /traces now carries input_kind + a 120-char text excerpt (consensus →
  input.text → first STT transcript)
- media serving: POST /media-url mints a short-lived HMAC URL (audio/a tags
  cannot send Authorization); GET /media streams from MinIO bot-media with
  the read-only ./bot/data mount as fallback for pre-MinIO files; hard ref
  validation (voices|attachments only, no .., extension whitelist)
- router exempted from the global Bearer dependency (files.py pattern) —
  every endpoint keeps its own require_role('admin')

Frontend /bot-monitor (RTL, recharts):
- four tabs: نمای کلی / مدل‌ها (records table + per-model expandable daily
  charts: calls/fails, tokens, p50) / بخش‌ها (sections grouped) / پیام‌ها
- message drawer rebuilt: inline <audio controls> for raw + denoised voice,
  download links, every STT transcript + consensus side-by-side, user
  attachments, then the event timeline
- terminology: «ترس» → «پرونده‌ی پیام» with tooltips + a one-line legend

Grafana: bot-observability gains a «کارکرد مدل‌ها» table (stage→model
mapping for legacy rows); the explorer gains a message text column.

Seed: real (tiny) ogg files written + mirrored to MinIO, NLU usage tokens,
column-level model/latency on matching events.

Verified locally: /models returns all 7 records incl. per-STT and NLU tokens;
media 200 via signed URL (MinIO) and 401 without; ../ and .py rejected (400);
disk fallback serves a legacy file; pm-role 403 on every new endpoint;
bucket auto-created with 14 mirrored objects; tsc + vite build clean;
Grafana re-provisions 24 panels.
---
 .env.example                                  |    3 +
 backend/app/config.py                         |    3 +
 backend/app/main.py                           |    6 +
 backend/app/routers/bot_metrics.py            |  357 +++++-
 bot/app/config.py                             |    8 +
 bot/app/fallback_matcher.py                   |    9 +-
 bot/app/nlu.py                                |   24 +-
 bot/app/observability.py                      |   21 +
 bot/app/storage.py                            |  105 +-
 bot/docs/DEPLOY-AND-MONITORING.md             |   15 +-
 bot/requirements.txt                          |    1 +
 bot/tools/seed_observability_demo.py          |   17 +-
 docker-compose.yml                            |   12 +
 frontend/src/lib/api.ts                       |   47 +
 .../src/pages/BotMonitor/BotMonitorPage.tsx   | 1118 +++++++++++------
 monitoring/README.md                          |   10 +-
 .../grafana/dashboards/bot-observability.json |  724 +++++++++--
 .../dashboards/bot-trace-explorer.json        |   91 +-
 18 files changed, 2028 insertions(+), 543 deletions(-)

diff --git a/.env.example b/.env.example
index 260695f..b25c223 100644
--- a/.env.example
+++ b/.env.example
@@ -64,6 +64,9 @@ GRAFANA_ROOT_URL=http://localhost:3001/
 # (empty = role skipped; datasource then can't connect).
 PROCUREMENT_BOT_OBS_READER_PASSWORD=
 OBS_READER_USER=obs_reader
+# Bot media second copy in MinIO (bucket is auto-created; empty endpoint = off)
+BOT_MINIO_ENDPOINT=minio:9000
+BOT_MINIO_BUCKET=bot-media
 # OpenPanel (product analytics) — client id/secret from the OpenPanel project
 OPENPANEL_API_URL=http://openpanel-api:3333
 OPENPANEL_CLIENT_ID=
diff --git a/backend/app/config.py b/backend/app/config.py
index fb3a4bd..a1200f1 100644
--- a/backend/app/config.py
+++ b/backend/app/config.py
@@ -39,6 +39,9 @@ class Settings(BaseSettings):
     MINIO_SECRET_KEY: str = "minioadmin"
     MINIO_BUCKET: str = "procurement-files"
     MINIO_SECURE: bool = False
+    # Second bucket the BOT dual-writes its media into (voices/attachments);
+    # the admin bot-media endpoint streams from here first, disk as fallback.
+    BOT_MEDIA_BUCKET: str = "bot-media"
 
     # Security token for standalone wizard review URL (must match bot)
     DRAFT_TOKEN_SECRET: str = "procurement-draft-secret-change-in-prod-v7"
diff --git a/backend/app/main.py b/backend/app/main.py
index 94cba30..522a4e2 100644
--- a/backend/app/main.py
+++ b/backend/app/main.py
@@ -236,6 +236,10 @@ from app.routers.auth import router as _auth_router  # noqa: E402
 # routes accept a short-lived signed ?t= token as well as a Bearer session.
 from app.routers.files import router as _files_router  # noqa: E402
 from app.routers.drafts import router as _drafts_router  # noqa: E402
+# bot-metrics: every endpoint carries its own require_role("admin"); the media
+# GET additionally accepts the short-lived signed ?t= token (same reason as
+# files) so <audio>/<a> tags can load it without an Authorization header.
+from app.routers.bot_metrics import router as _bot_metrics_router  # noqa: E402
 
 for router in ROUTERS:
     if router is _auth_router:
@@ -244,6 +248,8 @@ for router in ROUTERS:
         app.include_router(router, prefix=API_V1_PREFIX)
     elif router is _drafts_router:
         app.include_router(router, prefix=API_V1_PREFIX)
+    elif router is _bot_metrics_router:
+        app.include_router(router, prefix=API_V1_PREFIX)
     else:
         app.include_router(router, prefix=API_V1_PREFIX, dependencies=[Depends(get_current_user)])
 
diff --git a/backend/app/routers/bot_metrics.py b/backend/app/routers/bot_metrics.py
index caebc3f..227d8cb 100644
--- a/backend/app/routers/bot_metrics.py
+++ b/backend/app/routers/bot_metrics.py
@@ -4,13 +4,28 @@ Reads the bot's own tables (bot_traces / bot_trace_events — owned and written
 by the Bale bot container) with plain SELECTs only. Admin-gated. Calibration,
 demo and test traffic (source != 'bale' / chat_id = 0) is excluded from the
 aggregates; the traces endpoint can show everything with ?include_synthetic=1.
+
+v2.1: per-MODEL and per-SECTION records (/models, /stages), message text
+excerpts on /traces, and media serving (voice/attachment playback+download)
+streamed from the bot's MinIO bucket with an on-disk fallback, via a
+short-lived signed URL — <audio>/<a> tags cannot send Authorization headers.
 """
-from fastapi import APIRouter, Depends, Query
+import hashlib
+import hmac
+import os
+import re
+import time
+from pathlib import Path
+
+from fastapi import APIRouter, Depends, Query, Request, Response
+from fastapi.responses import FileResponse
 from sqlalchemy import text
 from sqlalchemy.ext.asyncio import AsyncSession
 
-from app.auth import require_role
+from app.auth import get_optional_user, require_role
+from app.config import settings
 from app.db.engine import get_db
+from app.utils.errors import NotFoundError, UnauthorizedError, ValidationError
 
 router = APIRouter(prefix="/bot-metrics", tags=["bot-metrics"])
 
@@ -230,6 +245,191 @@ async def stt_health(
     return {"data": {"providers": providers, "enhance": enhance[0] if enhance else None}}
 
 
+# ---------------------------------------------------------------------------
+# per-MODEL records (v2.1) — one row per AI model / engine in the pipeline
+# ---------------------------------------------------------------------------
+# result stage(s) per model; latency lives in the latency_ms column with the
+# payload copy as fallback for pre-v2.1 rows; tokens in payload->'usage'.
+MODEL_DEFS: list[dict] = [
+    {"id": "jev", "name": "Jev (تطبیق موجودیت)", "kind": "matching",
+     "stages": ["jev.request", "jev.result", "jev.failure"], "result_stage": "jev.result",
+     "model_stages": ["jev.result"], "pinned": "jev-1.13.0"},  # the bot's pinned version (calibrated)
+    {"id": "deepseek-nlu", "name": "DeepSeek — درک پیام (NLU)", "kind": "llm",
+     "stages": ["nlu.request", "nlu.result"], "result_stage": "nlu.result",
+     "model_stages": ["nlu.result"], "pinned": None},
+    {"id": "deepseek-arbiter", "name": "DeepSeek — داور تطبیق", "kind": "llm",
+     "stages": ["matching.arbitration.result", "matching.arbitration.failure"], "result_stage": "matching.arbitration.result",
+     "model_stages": [], "pinned": None},
+    {"id": "deepseek-fallback", "name": "DeepSeek — فالبک بحرانی", "kind": "llm",
+     "stages": ["matching.fallback.result", "matching.fallback.failure"], "result_stage": "matching.fallback.result",
+     "model_stages": [], "pinned": None},
+    {"id": "audio-enhancer", "name": "پیش‌پردازش صدا (Denoise)", "kind": "audio",
+     "stages": ["audio.enhance.result"], "result_stage": "audio.enhance.result",
+     "model_stages": ["audio.enhance.result"], "pinned": None},
+]
+
+_STAGE_SECTION = {
+    "audio.enhance.result": ("صوت", "پیش‌پردازش و نویززدایی"),
+    "stt.run": ("صوت", "اجرای STT"),
+    "stt.result": ("صوت", "تبدیل گفتار به متن"),
+    "nlu.request": ("درک پیام", "درخواست NLU"),
+    "nlu.result": ("درک پیام", "پاسخ NLU"),
+    "entities.extracted": ("درک پیام", "موجودیت‌های استخراج‌شده"),
+    "jev.request": ("تطبیق", "درخواست Jev"),
+    "jev.result": ("تطبیق", "امتیازدهی Jev"),
+    "jev.failure": ("تطبیق", "خطای Jev"),
+    "routing.decision": ("تطبیق", "تصمیم مسیریابی"),
+    "matching.arbitration.result": ("تطبیق", "داوری DeepSeek"),
+    "matching.arbitration.failure": ("تطبیق", "خطای داوری"),
+    "matching.fallback.result": ("تطبیق", "فالبک بحرانی"),
+    "matching.fallback.failure": ("تطبیق", "خطای فالبک"),
+    "ambiguity.sent": ("ابهام و انتخاب", "ارسال پرسش ابهام"),
+    "ambiguity.user_choice": ("ابهام و انتخاب", "انتخاب کاربر"),
+    "user_choice.pick": ("ابهام و انتخاب", "دکمه‌ی گزینه"),
+    "draft.render": ("پیش‌نویس", "نمایش پیش‌نویس"),
+    "draft.edit": ("پیش‌نویس", "ویرایش پیش‌نویس"),
+    "draft.commit": ("پیش‌نویس", "ثبت نهایی"),
+    "draft.cancel": ("پیش‌نویس", "لغو"),
+}
+
+_LAT = "coalesce(e.latency_ms, nullif(e.payload->>'latency_ms','')::int)"
+_TOK = "(e.payload->'usage'->>'input_tokens')::bigint"
+_TOK_OUT = "(e.payload->'usage'->>'output_tokens')::bigint"
+
+
+async def _model_rows(db: AsyncSession, days: int, stage: str) -> list[dict]:
+    return await _rows(db, f"""
+        SELECT count(*)::int AS calls,
+               count(*) FILTER (WHERE e.ok)::int AS ok,
+               coalesce(round(percentile_cont(0.5) WITHIN GROUP (ORDER BY {_LAT})),0)::int AS p50,
+               coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY {_LAT})),0)::int AS p95,
+               coalesce(sum({_TOK}),0)::bigint AS tokens_in,
+               coalesce(sum({_TOK_OUT}),0)::bigint AS tokens_out,
+               max(e.created_at)::text AS last_seen
+        FROM bot_trace_events e WHERE {REAL} AND e.stage = :stage
+          AND e.created_at >= now() - (:days * interval '1 day')
+    """, {"stage": stage, "days": days})
+
+
+async def _models_seen(db: AsyncSession, days: int, stages: list[str]) -> list[dict]:
+    return await _rows(db, f"""
+        SELECT DISTINCT ON (coalesce(e.model,'?')) coalesce(e.model,'?') AS model,
+               count(*) OVER (PARTITION BY coalesce(e.model,'?'))::int AS n
+        FROM bot_trace_events e
+        WHERE {REAL} AND e.stage = ANY(:stages)
+          AND e.created_at >= now() - (:days * interval '1 day')
+    """, {"stages": stages, "days": days})
+
+
+@router.get("/models")
+async def models(
+    days: int = Query(7, ge=1, le=90),
+    db: AsyncSession = Depends(get_db),
+    _ctx=Depends(require_role("admin")),
+):
+    """One record per model in the pipeline (incl. dynamic STT providers)."""
+    out: list[dict] = []
+    for d in MODEL_DEFS:
+        agg = (await _model_rows(db, days, d["result_stage"]))[0]
+        versions: list[str] = []
+        if d["model_stages"]:
+            versions = [r["model"] for r in await _models_seen(db, days, d["model_stages"])
+                        if r["model"] != "?"]
+        out.append({
+            "id": d["id"], "name": d["name"], "kind": d["kind"],
+            "stages": d["stages"], **agg,
+            "versions": versions,
+            "drift": bool(d["pinned"] and any(v != d["pinned"] for v in versions)),
+            "pinned": d["pinned"],
+        })
+    # dynamic STT models — one record per provider/model id in stt.result
+    stt_rows = await _rows(db, f"""
+        SELECT coalesce(e.model, e.payload->>'provider', 'stt') AS model,
+               count(*)::int AS calls,
+               count(*) FILTER (WHERE e.ok)::int AS ok,
+               coalesce(round(percentile_cont(0.5) WITHIN GROUP (ORDER BY {_LAT})),0)::int AS p50,
+               coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY {_LAT})),0)::int AS p95,
+               0::bigint AS tokens_in, 0::bigint AS tokens_out,
+               max(e.created_at)::text AS last_seen
+        FROM bot_trace_events e
+        WHERE {REAL} AND e.stage = 'stt.result'
+          AND e.created_at >= now() - (:days * interval '1 day')
+        GROUP BY 1 ORDER BY calls DESC
+    """, {"days": days})
+    for r in stt_rows:
+        out.append({"id": f"stt:{r['model']}",
+                    "name": f"STT — {r['model']}", "kind": "stt",
+                    "stages": ["stt.result"], **r,
+                    "versions": [], "drift": False, "pinned": None})
+    return {"data": out, "days": days}
+
+
+def _model_def(model_id: str) -> dict | None:
+    for d in MODEL_DEFS:
+        if d["id"] == model_id:
+            return d
+    return None
+
+
+@router.get("/models/{model_id}/daily")
+async def model_daily(
+    model_id: str,
+    days: int = Query(7, ge=1, le=90),
+    db: AsyncSession = Depends(get_db),
+    _ctx=Depends(require_role("admin")),
+):
+    """Daily calls / failures / tokens / latency for one model."""
+    if model_id.startswith("stt:"):
+        stage, model_val = "stt.result", model_id[4:]
+        extra = " AND coalesce(e.model, e.payload->>'provider') = :mv"
+        params: dict = {"mv": model_val}
+    else:
+        d = next((x for x in MODEL_DEFS if x["id"] == model_id), None)
+        if d is None:
+            raise NotFoundError("مدل یافت نشد")
+        stage, model_val, extra = d["result_stage"], None, ""
+        params = {}
+    rows = await _rows(db, f"""
+        SELECT to_char(date_trunc('day', e.created_at), 'YYYY-MM-DD') AS day,
+               count(*)::int AS calls,
+               count(*) FILTER (WHERE NOT e.ok)::int AS fails,
+               coalesce(round(percentile_cont(0.5) WITHIN GROUP (ORDER BY {_LAT})),0)::int AS p50,
+               coalesce(sum({_TOK}),0)::bigint AS tokens_in,
+               coalesce(sum({_TOK_OUT}),0)::bigint AS tokens_out
+        FROM bot_trace_events e
+        WHERE {REAL} AND e.stage = :stage{extra}
+          AND e.created_at >= now() - (:days * interval '1 day')
+        GROUP BY 1 ORDER BY 1
+    """, {"stage": stage, "days": days, **params})
+    return {"data": rows, "model": model_id, "days": days}
+
+
+@router.get("/stages")
+async def stages(
+    days: int = Query(7, ge=1, le=90),
+    db: AsyncSession = Depends(get_db),
+    _ctx=Depends(require_role("admin")),
+):
+    """One record per pipeline stage, tagged with its Persian section."""
+    rows = await _rows(db, f"""
+        SELECT e.stage,
+               count(*)::int AS n,
+               count(*) FILTER (WHERE NOT e.ok)::int AS fails,
+               coalesce(round(percentile_cont(0.5) WITHIN GROUP (ORDER BY {_LAT})),0)::int AS p50,
+               coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY {_LAT})),0)::int AS p95,
+               coalesce(sum({_TOK}),0)::bigint AS tokens_in,
+               coalesce(sum({_TOK_OUT}),0)::bigint AS tokens_out
+        FROM bot_trace_events e
+        WHERE {REAL} AND e.created_at >= now() - (:days * interval '1 day')
+        GROUP BY 1 ORDER BY n DESC
+    """, {"days": days})
+    for r in rows:
+        sec = _STAGE_SECTION.get(r["stage"])
+        r["section"] = sec[0] if sec else "سایر"
+        r["stage_fa"] = sec[1] if sec else r["stage"]
+    return {"data": rows, "days": days}
+
+
 @router.get("/traces")
 async def traces(
     limit: int = Query(50, ge=1, le=200),
@@ -238,12 +438,25 @@ async def traces(
     db: AsyncSession = Depends(get_db),
     _ctx=Depends(require_role("admin")),
 ):
-    """Latest traces for the explorer table (oldest events come from /traces/{id})."""
+    """Latest message records («پرونده‌ی پیام») with a text excerpt + media flag."""
     sql = """
         SELECT t.id::text AS id, t.created_at::text AS created_at,
                coalesce(t.source,'bale') AS source, t.chat_id::text AS chat_id,
                t.kind, coalesce(t.status,'open') AS status,
-               (SELECT count(*) FROM bot_trace_events e WHERE e.trace_id=t.id)::int AS events
+               (SELECT count(*) FROM bot_trace_events e WHERE e.trace_id=t.id)::int AS events,
+               CASE WHEN EXISTS (SELECT 1 FROM bot_trace_events e
+                                  WHERE e.trace_id=t.id AND e.stage='input.voice')
+                    THEN 'voice' ELSE 'text' END AS input_kind,
+               left(coalesce((SELECT e.payload->>'consensus_text' FROM bot_trace_events e
+                               WHERE e.trace_id=t.id AND e.stage='nlu.result'
+                               ORDER BY e.created_at LIMIT 1),
+                             (SELECT e.payload->>'text' FROM bot_trace_events e
+                               WHERE e.trace_id=t.id AND e.stage='input.text'
+                               ORDER BY e.created_at LIMIT 1),
+                             (SELECT e.payload->>'text' FROM bot_trace_events e
+                               WHERE e.trace_id=t.id AND e.stage='stt.result' AND e.ok
+                               ORDER BY e.created_at LIMIT 1),
+                             ''), 120) AS text_excerpt
         FROM bot_traces t
         WHERE (:include_synthetic
                OR (coalesce(t.source,'bale') NOT IN ('calibration','demo') AND coalesce(t.chat_id,0) <> 0))
@@ -280,3 +493,139 @@ async def trace_detail(
         FROM bot_traces WHERE id::text = :tid
     """, {"tid": trace_id})
     return {"data": {"trace": head[0] if head else None, "events": events}}
+
+
+# ---------------------------------------------------------------------------
+# media serving (v2.1) — inline playback + download of voices / user files
+# ---------------------------------------------------------------------------
+# <audio controls> and <a download> cannot attach an Authorization header, so
+# the admin page first mints a short-lived signed URL (same idea as the quote
+# preview tokens); the GET below accepts that token OR an admin session and
+# streams the file from the bot's MinIO bucket, falling back to the read-only
+# ./bot/data mount for pre-MinIO files.
+
+_MEDIA_TTL_SECONDS = 600
+_MEDIA_RE = re.compile(r"^(voices|attachments)/[A-Za-z0-9_\-./]+$")
+_MEDIA_EXT = {".ogg", ".wav", ".m4a", ".mp3", ".pdf", ".png", ".jpg", ".jpeg", ".webp"}
+_MEDIA_MIME = {
+    ".ogg": "audio/ogg", ".wav": "audio/wav", ".m4a": "audio/mp4",
+    ".mp3": "audio/mpeg", ".pdf": "application/pdf", ".png": "image/png",
+    ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".webp": "image/webp",
+}
+
+
+def _check_ref(ref: str) -> str:
+    """Validate a media ref (path under ./bot/data, doubles as the MinIO key)."""
+    ref = (ref or "").strip()
+    if not _MEDIA_RE.match(ref) or ".." in ref or ref.endswith("."):
+        raise ValidationError("مسیر فایل نامعتبر است")
+    if os.path.splitext(ref)[1].lower() not in _MEDIA_EXT:
+        raise ValidationError("نوع فایل پشتیبانی نمی‌شود")
+    return ref
+
+
+def _media_secret() -> bytes:
+    base = (settings.CASDOOR_CLIENT_SECRET or settings.MINIO_SECRET_KEY
+            or "procurement-preview-fallback")
+    return base.encode("utf-8")
+
+
+def _media_sign(ref: str, expiry: int) -> str:
+    return hmac.new(_media_secret(), f"bot-media:{ref}:{expiry}".encode(),
+                    hashlib.sha256).hexdigest()
+
+
+def _media_token(ref: str, ttl: int = _MEDIA_TTL_SECONDS) -> str:
+    expiry = int(time.time()) + ttl
+    return f"{expiry}.{_media_sign(ref, expiry)}"
+
+
+def _verify_media_token(token: str, ref: str) -> bool:
+    if not token or "." not in token:
+        return False
+    expiry_raw, sig = token.split(".", 1)
+    try:
+        expiry = int(expiry_raw)
+    except ValueError:
+        return False
+    if expiry < int(time.time()):
+        return False
+    return hmac.compare_digest(_media_sign(ref, expiry), sig)
+
+
+from pydantic import BaseModel  # noqa: E402  (kept next to its only use)
+
+
+class MediaUrlRequest(BaseModel):
+    ref: str
+
+
+@router.post("/media-url")
+async def media_url(
+    body: MediaUrlRequest,
+    _ctx=Depends(require_role("admin")),
+):
+    """Mint a short-lived signed URL for inline playback / download."""
+    ref = _check_ref(body.ref)
+    from urllib.parse import quote
+    return {"data": {
+        "url": f"/api/v1/bot-metrics/media?ref={quote(ref)}&t={_media_token(ref)}",
+        "expires_in": _MEDIA_TTL_SECONDS,
+    }}
+
+
+@router.get("/media")
+async def media(
+    request: Request,
+    ref: str,
+    t: str | None = None,
+    db: AsyncSession = Depends(get_db),
+):
+    """Stream one bot media file (admin session OR signed ?t= token).
+
+    Prefers the MinIO copy (bucket bot-media, key = ref); falls back to the
+    read-only disk mount for files saved before MinIO mirroring existed.
+    """
+    ref = _check_ref(ref)
+    allowed = False
+    if request.headers.get("authorization"):
+        user = await get_optional_user(request, db)
+        if user is not None and user.role == "admin":
+            allowed = True
+    if not allowed and t and _verify_media_token(t, ref):
+        allowed = True
+    if not allowed:
+        raise UnauthorizedError("دسترسی به این فایل مجاز نیست")
+
+    name = os.path.basename(ref)
+    mime = _MEDIA_MIME.get(os.path.splitext(ref)[1].lower(), "application/octet-stream")
+
+    # 1) MinIO copy (the bot dual-writes everything here)
+    try:
+        import asyncio
+
+        from app.services.storage import get_client as _minio_client
+
+        def _fetch() -> bytes:
+            resp = _minio_client().get_object(settings.BOT_MEDIA_BUCKET, ref)
+            try:
+                return resp.read()
+            finally:
+                resp.close()
+                resp.release_conn()
+
+        content = await asyncio.to_thread(_fetch)
+        return Response(content, media_type=mime, headers={
+            "Content-Disposition": f'inline; filename="{name}"',
+            "Cache-Control": "private, max-age=300",
+        })
+    except Exception:
+        pass  # not in MinIO (old file) or MinIO down → disk fallback
+
+    # 2) disk fallback (read-only mount of ./bot/data)
+    path = (Path("/srv/bot/data") / ref).resolve()
+    data_root = Path("/srv/bot/data").resolve()
+    if data_root not in path.parents or not path.is_file():
+        raise NotFoundError("فایل یافت نشد")
+    return FileResponse(path, media_type=mime, filename=name,
+                        headers={"Cache-Control": "private, max-age=300"})
diff --git a/bot/app/config.py b/bot/app/config.py
index 0dab949..e0b5fc0 100644
--- a/bot/app/config.py
+++ b/bot/app/config.py
@@ -152,6 +152,14 @@ class Settings(BaseSettings):
     # postgres user instead). Rotating = change env + restart the bot.
     OBS_READER_PASSWORD: str = ""
 
+    # Second copy of every bot media file in the ERP's existing MinIO
+    # (dual-write with the on-disk archive; empty endpoint = mirroring off).
+    MINIO_ENDPOINT: str = ""          # e.g. "minio:9000" inside the compose network
+    MINIO_ACCESS_KEY: str = ""
+    MINIO_SECRET_KEY: str = ""
+    MINIO_BUCKET: str = "bot-media"
+    MINIO_SECURE: bool = False
+
     # Jev (TypeSafe) entity matching — phases 2-5. Model version is PINNED
     # (phase 0 resolved jev-1.13.0) so upstream updates cannot silently change
     # decisions; every response's actual model is recorded for drift detection.
diff --git a/bot/app/fallback_matcher.py b/bot/app/fallback_matcher.py
index e7d0408..f678be2 100644
--- a/bot/app/fallback_matcher.py
+++ b/bot/app/fallback_matcher.py
@@ -333,8 +333,10 @@ async def match_with_deepseek(
         for v in variants:
             results_map[normalize_text(v)] = entry
 
-    # Observability: matching.fallback.result
-    await obs.event(trace_id, "matching.fallback.result", ok=True, payload={
+    # Observability: matching.fallback.result (model/latency also as columns so
+    # per-model dashboards aggregate like jev.result's do; payload unchanged)
+    await obs.event(trace_id, "matching.fallback.result", ok=True,
+                    model=settings.LLM_MODEL, latency_ms=latency_ms, payload={
         "latency_ms": latency_ms,
         "usage": usage,
         "statuses": statuses_count,
@@ -540,7 +542,8 @@ async def adjudicate_with_deepseek(
             results_map[normalize_text(v)] = entry
 
     # Observability: matching.arbitration.result
-    await obs.event(trace_id, "matching.arbitration.result", ok=True, payload={
+    await obs.event(trace_id, "matching.arbitration.result", ok=True,
+                    model=settings.LLM_MODEL, latency_ms=latency_ms, payload={
         "latency_ms": latency_ms,
         "usage": usage,
         "actions": actions_count,
diff --git a/bot/app/nlu.py b/bot/app/nlu.py
index 5c5827b..7ee75a1 100644
--- a/bot/app/nlu.py
+++ b/bot/app/nlu.py
@@ -8,6 +8,7 @@ import hashlib
 import json
 import logging
 import re
+import time
 
 import httpx
 
@@ -220,6 +221,7 @@ async def understand(settings: Settings, text: str | list[dict], draft_summary:
     })
 
     try:
+        t0 = time.perf_counter()
         async with httpx.AsyncClient(timeout=settings.LLM_TIMEOUT_SECONDS) as client:
             resp = await client.post(
                 f"{settings.AI_BASE_URL.rstrip('/')}/chat/completions",
@@ -234,29 +236,35 @@ async def understand(settings: Settings, text: str | list[dict], draft_summary:
                     "response_format": {"type": "json_object"},
                 },
             )
+        latency_ms = int((time.perf_counter() - t0) * 1000)
         if resp.status_code != 200:
             logger.error("LLM HTTP %s: %s", resp.status_code, resp.text[:300])
             await obs.event(trace_id, "nlu.result", ok=False, model=settings.LLM_MODEL,
+                            latency_ms=latency_ms,
                             payload={"error": f"HTTP {resp.status_code}", "body": resp.text[:300]})
             raise NLUFailureError(f"HTTP {resp.status_code}")
-        content = ((resp.json() or {}).get("choices") or [{}])[0].get("message", {}).get("content", "")
+        resp_json = resp.json() or {}
+        content = ((resp_json.get("choices") or [{}])[0].get("message", {}) or {}).get("content", "")
         parsed = _extract_json(content)
         if not parsed or parsed.get("intent") not in INTENTS:
             logger.warning("unparseable LLM output: %r", content[:200])
             await obs.event(trace_id, "nlu.result", ok=False, model=settings.LLM_MODEL,
+                            latency_ms=latency_ms,
                             payload={"error": "unparseable", "raw": content[:500]})
             raise NLUFailureError("unparseable LLM output")
         parsed.setdefault("patch", {})
         parsed["entity_mentions"] = sanitize_mentions(parsed.get("entity_mentions"))
         if not parsed.get("consensus_text"):
             parsed["consensus_text"] = first_text
-        await obs.event(trace_id, "nlu.result", ok=True, model=settings.LLM_MODEL, payload={
-            "intent": parsed.get("intent"),
-            "confidence": parsed.get("confidence"),
-            "patch": parsed.get("patch"),
-            "consensus_text": parsed.get("consensus_text"),
-            "entity_mentions": parsed.get("entity_mentions"),
-        })
+        await obs.event(trace_id, "nlu.result", ok=True, model=settings.LLM_MODEL,
+                        latency_ms=latency_ms, payload={
+                            "intent": parsed.get("intent"),
+                            "confidence": parsed.get("confidence"),
+                            "patch": parsed.get("patch"),
+                            "consensus_text": parsed.get("consensus_text"),
+                            "entity_mentions": parsed.get("entity_mentions"),
+                            "usage": resp_json.get("usage"),
+                        })
         return parsed
     except Exception as exc:
         if isinstance(exc, NLUFailureError):
diff --git a/bot/app/observability.py b/bot/app/observability.py
index 34467fc..cd34b3b 100644
--- a/bot/app/observability.py
+++ b/bot/app/observability.py
@@ -200,6 +200,7 @@ def save_voice(trace_id: str | None, message_id: int, content: bytes,
         base.mkdir(parents=True, exist_ok=True)     # الزام سخت‌سازی: مسیر همیشه ساخته می‌شود
         path = base / f"{trace_id}_{message_id}{ext}"
         path.write_bytes(content)
+        _mirror_bg(path, "audio/ogg")
         return str(path)
     except Exception:
         logger.warning("obs: save_voice failed for trace %s", trace_id, exc_info=True)
@@ -217,7 +218,27 @@ def save_enhanced_voice(trace_id: str | None, message_id: int, content: bytes,
             ext = f".{ext}"
         path = base / f"{trace_id}_{message_id}_enhanced{ext or '.ogg'}"
         path.write_bytes(content)
+        _mirror_bg(path, "audio/ogg")
         return str(path)
     except Exception:
         logger.warning("obs: save_enhanced_voice failed for trace %s", trace_id, exc_info=True)
         return None
+
+
+async def _mirror(path: Path, content_type: str) -> None:
+    """Second copy in MinIO (fire-and-forget; see app/storage.py)."""
+    try:
+        from app import storage
+        ref = storage.media_ref(path)
+        if ref:
+            await storage.mirror_to_minio(ref, path, content_type)
+    except Exception:
+        pass
+
+
+def _mirror_bg(path: Path, content_type: str) -> None:
+    """Sync-context wrapper around the MinIO mirror (never raises)."""
+    try:
+        asyncio.get_running_loop().create_task(_mirror(path, content_type))
+    except RuntimeError:
+        pass
diff --git a/bot/app/storage.py b/bot/app/storage.py
index 4450aca..ee4f569 100644
--- a/bot/app/storage.py
+++ b/bot/app/storage.py
@@ -1,11 +1,24 @@
-"""Persistent storage for draft attachments (proforma files)."""
+"""Persistent storage for draft attachments (proforma files) + MinIO mirroring.
+
+Dual-write policy (senior-engineer review 2026-10-25): every file the bot
+persists (voices, enhanced voices, proforma/user attachments) stays on disk
+under ./bot/data (primary copy, "archive — never delete") and is ALSO
+uploaded fire-and-forget to the ERP's existing MinIO under bucket `bot-media`
+with the SAME key as its path relative to the data dir, e.g.
+`voices/20261025/<trace>_<msg>.ogg` — the dashboard's media endpoint derives
+the object key from that relative path, so nothing extra is stored in payloads.
+"""
 from datetime import datetime, timezone
+import asyncio
 import logging
 import os
 from pathlib import Path
 import re
+import threading
 from uuid import UUID, uuid4
 
+from app.config import settings
+
 logger = logging.getLogger("bot.storage")
 
 
@@ -42,12 +55,102 @@ async def save_proforma_file(
     target_path.write_bytes(content)
     logger.info("Persisted proforma (%d bytes) to %s", len(content), target_path)
 
+    # Second copy in MinIO (never blocks/fails the bot; disabled when unset)
+    rel = media_ref(target_path)
+    if rel:
+        await mirror_to_minio(rel, target_path,
+                              content_type=mime_type or "application/octet-stream")
+
     return {
         "file_name": clean_name,
         "saved_filename": saved_filename,
         "saved_path": str(target_path.resolve()),
         "relative_path": str(target_path.as_posix()),
+        "media_ref": rel,
         "size_bytes": len(content),
         "mime_type": mime_type or "application/octet-stream",
         "saved_at": datetime.now(timezone.utc).isoformat(),
     }
+
+
+# ---------------------------------------------------------------------------
+# MinIO mirror — second copy of every bot media file
+# ---------------------------------------------------------------------------
+# The official `minio` Python client is synchronous/blocking; every SDK call
+# therefore runs in a worker thread (asyncio.to_thread) and the whole upload
+# is fire-and-forget so a MinIO outage can never stall the reply path.
+
+DATA_DIR = Path("data")  # ./bot/data inside the container (compose volume)
+
+_client = None
+_client_lock = threading.Lock()
+_bg: set = set()
+
+
+def media_ref(path: str | Path) -> str | None:
+    """Relative ref of a file under ./bot/data ('voices/.../x.ogg'), else None.
+
+    This ref doubles as the MinIO object key and as the dashboard's media
+    identifier — files outside the data dir are simply not mirrored/servable.
+    """
+    try:
+        rel = Path(path).resolve().relative_to((DATA_DIR).resolve()).as_posix()
+        return rel if rel and ".." not in rel else None
+    except ValueError:
+        return None
+
+
+def _get_client():
+    """Lazily build the blocking MinIO client (None when unconfigured)."""
+    global _client
+    if not (settings.MINIO_ENDPOINT and settings.MINIO_ACCESS_KEY and settings.MINIO_SECRET_KEY):
+        return None
+    if _client is not None:
+        return _client
+    with _client_lock:
+        if _client is not None:
+            return _client
+        try:
+            from minio import Minio  # imported only when configured
+
+            _client = Minio(settings.MINIO_ENDPOINT,
+                            access_key=settings.MINIO_ACCESS_KEY,
+                            secret_key=settings.MINIO_SECRET_KEY,
+                            secure=settings.MINIO_SECURE)
+        except Exception:
+            logger.exception("storage: minio client init failed — mirroring disabled")
+            _client = None
+    return _client
+
+
+def _upload_sync(key: str, path: Path, content_type: str) -> None:
+    client = _get_client()
+    if client is None:
+        return
+    if not client.bucket_exists(settings.MINIO_BUCKET):
+        client.make_bucket(settings.MINIO_BUCKET)
+        logger.info("storage: created bucket %s", settings.MINIO_BUCKET)
+    client.fput_object(settings.MINIO_BUCKET, key, str(path), content_type=content_type)
+
+
+async def mirror_to_minio(key: str, path: str | Path,
+                          content_type: str = "audio/ogg") -> None:
+    """Fire-and-forget upload of an already-saved disk file (never raises)."""
+    try:
+        p = Path(path)
+        if not p.is_file():
+            logger.warning("storage: mirror skipped — missing file %s", p)
+            return
+
+        async def _run() -> None:
+            try:
+                await asyncio.to_thread(_upload_sync, key, p, content_type)
+                logger.info("storage: mirrored %s -> %s/%s", p.name, settings.MINIO_BUCKET, key)
+            except Exception:
+                logger.warning("storage: minio mirror failed for %s", p.name, exc_info=True)
+
+        task = asyncio.get_running_loop().create_task(_run())
+        _bg.add(task)
+        task.add_done_callback(_bg.discard)
+    except RuntimeError:
+        pass  # no running loop (sync unit tests) — skip silently
diff --git a/bot/docs/DEPLOY-AND-MONITORING.md b/bot/docs/DEPLOY-AND-MONITORING.md
index 2e5e925..d52b938 100644
--- a/bot/docs/DEPLOY-AND-MONITORING.md
+++ b/bot/docs/DEPLOY-AND-MONITORING.md
@@ -59,13 +59,20 @@
 4. راستی‌آزمایی پایش: `docker compose exec bot python tools/monitor.py --days 1`
    → قیف باید پر شود و رخدادهای همان پیام‌ها در `bot_trace_events` باشد.
 5. چک سهمیه: `usage` در `jev.result` (توکن ورودی/خروجی) + latency p95.
-6. **داشبوردها (۲۰۲۶-۱۰-۲۴):** `PROCUREMENT_BOT_OBS_READER_PASSWORD` را در `.env` ست کنید و
+6. **داشبوردها (به‌روز ۲۰۲۶-۱۰-۲۵، v2.1):** `PROCUREMENT_BOT_OBS_READER_PASSWORD` را در `.env` ست کنید و
    یک بار بات را restart کنید تا نقش فقط‌خواندنی `obs_reader` ساخته شود؛ سپس گرفانا را
    (ری)استارت کنید — دیتاسورس `BotPostgres` و دو داشبورد «بات — Observability خط لوله» و
-   «بات — اکسپلورر ترس‌ها» خودکار provision می‌شوند (جزئیات در `monitoring/README.md`).
-   صفحه‌ی فارسی داخل ERP هم روی مسیر `/bot-monitor` (فقط ادمین) است.
+   «بات — اکسپلورر پیام‌ها» خودکار provision می‌شوند (جزئیات در `monitoring/README.md`).
+   صفحه‌ی فارسی داخل ERP روی `/bot-monitor` (فقط ادمین) چهار تب دارد: نمای کلی،
+   **مدل‌ها** (رکورد و روند زمانی هر مدل: Jev، DeepSeek-NLU، داور، فالبک، هر STT، بهبود صدا)،
+   **بخش‌ها** (مراحل به تفکیک بخش خط‌لوله) و **پیام‌ها** (پرونده‌ی هر پیام با پخش/دانلود ویس و
+   ترنسکریپت همه‌ی موتورها کنار هم).
+   **رسانه (v2.1):** فایل‌های بات دو-نویسی می‌شوند — دیسک (آرشیو) + باکت MinIO `bot-media`
+   (env: `BOT_MINIO_ENDPOINT/BOT_MINIO_BUCKET`؛ خالی = خاموش). سرو پخش/دانلود از MinIO با
+   fallback به دیسک از `/api/v1/bot-metrics/media` با لینک امضاشده‌ی کوتاه‌مدت انجام می‌شود؛
+   سرویس api ولوم فقط‌خواندنی `./bot/data` دارد (ولیم جدید = `up -d --build api` برای recreate).
    برای دیدن همه‌ی پنل‌ها روی نصب تازه: `docker compose exec bot python tools/seed_observability_demo.py --days 7`
-   (داده‌ها با `source='demo'` از آمار ترافیک واقعی جدا می‌مانند).
+   (داده‌ها با `source='demo'` از آمار ترافیک واقعی جدا می‌مانند و در MinIO هم آینه می‌شوند).
 
 ## د) Rollback (بدون دیپلوی — فقط env + restart)
 
diff --git a/bot/requirements.txt b/bot/requirements.txt
index 30aba64..ea9f9bc 100644
--- a/bot/requirements.txt
+++ b/bot/requirements.txt
@@ -3,3 +3,4 @@ sqlalchemy[asyncio]>=2.0.30
 asyncpg>=0.29.0
 pydantic>=2.7.0
 pydantic-settings>=2.2.0
+minio>=7.2.0
diff --git a/bot/tools/seed_observability_demo.py b/bot/tools/seed_observability_demo.py
index 030387a..6e63a35 100644
--- a/bot/tools/seed_observability_demo.py
+++ b/bot/tools/seed_observability_demo.py
@@ -82,8 +82,19 @@ async def one_trace(s, chat_id: int, t0: datetime, kind: str) -> None:
     m = 0.0
     # ---- input
     if kind == "voice":
+        # a real (tiny, silent) ogg so the media player/download path has bytes
+        day = t0.strftime("%Y%m%d")
+        vdir = Path("data/voices") / day
+        vdir.mkdir(parents=True, exist_ok=True)
+        vpath = vdir / f"{tid}_{rng.randrange(1000, 99999)}.ogg"
+        vpath.write_bytes(bytes.fromhex("4f6767530002000000000000000000000001") + b"\x00" * 3000)
         await ev("input.voice", minutes=m, payload={
-            "path": f"data/voices/demo/{tid}.ogg", "size": 21400, "mime": "audio/ogg"})
+            "path": vpath.as_posix(), "size": vpath.stat().st_size, "mime": "audio/ogg"})
+        try:  # second copy in MinIO exactly like the live bot does
+            from app import storage
+            await storage.mirror_to_minio(storage.media_ref(vpath) or "", vpath, "audio/ogg")
+        except Exception:
+            pass
         # audio enhancement (new in 787824a)
         ok_enh = rng.random() < 0.85
         await ev("audio.enhance.result", minutes=(m := m + 0.1), ok=ok_enh,
@@ -111,7 +122,9 @@ async def one_trace(s, chat_id: int, t0: datetime, kind: str) -> None:
     mentions = _mentions(rng.randint(3, 6))
     await ev("nlu.result", minutes=(m := m + 0.9), latency=rng.randrange(1500, 3600),
              model="deepseek-chat", payload={
-                 "intent": "register_quote", "consensus_text": payload_text})
+                 "intent": "register_quote", "consensus_text": payload_text,
+                 "usage": {"input_tokens": rng.randint(600, 2200),
+                           "output_tokens": rng.randint(150, 900)}})
     await ev("entities.extracted", minutes=(m := m + 0.02), payload={"entity_mentions": mentions})
 
     # ---- Jev scoring + arbitration/fallback (two-stage, 787824a)
diff --git a/docker-compose.yml b/docker-compose.yml
index dabd254..822ef6a 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -214,12 +214,18 @@ services:
       dockerfile: Dockerfile
     container_name: procurement-api
 
+    volumes:
+      # Bot media archive (voices/attachments) — READ-ONLY fallback for the
+      # admin media endpoint when an object is not (yet) in MinIO.
+      - ./bot/data:/srv/bot/data:ro
+
     environment:
       PROCUREMENT_DATABASE_URL: postgresql+asyncpg://postgres:${POSTGRES_PASSWORD:-postgres}@postgres:5432/procurement
       PROCUREMENT_MINIO_ENDPOINT: minio:9000
       PROCUREMENT_MINIO_ACCESS_KEY: ${MINIO_ROOT_USER:-minioadmin}
       PROCUREMENT_MINIO_SECRET_KEY: ${MINIO_ROOT_PASSWORD:-minioadmin}
       PROCUREMENT_MINIO_BUCKET: procurement-files
+      PROCUREMENT_BOT_MEDIA_BUCKET: ${BOT_MINIO_BUCKET:-bot-media}
       PROCUREMENT_MINIO_SECURE: "false"
       # "dev" enables the local defaults; "prod" turns on the fail-fast
       # startup checks (no wildcard CORS, no default credentials).
@@ -337,6 +343,12 @@ services:
       PROCUREMENT_BOT_ADMIN_CHAT_IDS: ${BALE_ADMIN_CHAT_IDS:-1461166742,1839839922}
       PROCUREMENT_BOT_SERVICE_TOKEN: ${BALE_SERVICE_TOKEN:-}
       PROCUREMENT_BOT_FRONTEND_URL: ${APP_HOST:-http://localhost}
+      # Second copy of bot media in the ERP MinIO (empty user/key = off)
+      PROCUREMENT_BOT_MINIO_ENDPOINT: ${BOT_MINIO_ENDPOINT:-minio:9000}
+      PROCUREMENT_BOT_MINIO_ACCESS_KEY: ${MINIO_ROOT_USER:-minioadmin}
+      PROCUREMENT_BOT_MINIO_SECRET_KEY: ${MINIO_ROOT_PASSWORD:-minioadmin}
+      PROCUREMENT_BOT_MINIO_BUCKET: ${BOT_MINIO_BUCKET:-bot-media}
+      PROCUREMENT_BOT_MINIO_SECURE: "false"
 
     depends_on:
       postgres:
diff --git a/frontend/src/lib/api.ts b/frontend/src/lib/api.ts
index 8adf788..d2cf851 100644
--- a/frontend/src/lib/api.ts
+++ b/frontend/src/lib/api.ts
@@ -1654,6 +1654,43 @@ export interface BotTraceRow {
   kind: string;
   status: string;
   events: number;
+  input_kind: "voice" | "text";
+  text_excerpt: string | null;
+}
+export interface BotModelRecord {
+  id: string;
+  name: string;
+  kind: string;
+  stages: string[];
+  calls: number;
+  ok: number;
+  p50: number;
+  p95: number;
+  tokens_in: number;
+  tokens_out: number;
+  last_seen: string | null;
+  versions: string[];
+  drift: boolean;
+  pinned: string | null;
+}
+export interface BotModelDaily {
+  day: string;
+  calls: number;
+  fails: number;
+  p50: number;
+  tokens_in: number;
+  tokens_out: number;
+}
+export interface BotStageRecord {
+  stage: string;
+  stage_fa: string;
+  section: string;
+  n: number;
+  fails: number;
+  p50: number;
+  p95: number;
+  tokens_in: number;
+  tokens_out: number;
 }
 export interface BotTraceDetail {
   trace: {
@@ -1894,5 +1931,15 @@ export const apiV26 = {
     },
     traceDetail: (traceId: string) =>
       getData<BotTraceDetail>(`/bot-metrics/traces/${encodeURIComponent(traceId)}`),
+    models: (days: number) => getData<BotModelRecord[]>(`/bot-metrics/models?days=${days}`),
+    modelDaily: (modelId: string, days: number) =>
+      getData<BotModelDaily[]>(
+        `/bot-metrics/models/${encodeURIComponent(modelId)}/daily?days=${days}`,
+      ),
+    stages: (days: number) => getData<BotStageRecord[]>(`/bot-metrics/stages?days=${days}`),
+    // Short-lived signed URL so <audio>/<a> tags (no Authorization header)
+    // can load the file — minted per file right before rendering.
+    mediaUrl: (ref: string) =>
+      postData<{ url: string; expires_in: number }>("/bot-metrics/media-url", { ref }),
   },
 };
diff --git a/frontend/src/pages/BotMonitor/BotMonitorPage.tsx b/frontend/src/pages/BotMonitor/BotMonitorPage.tsx
index df5aac5..34c1695 100644
--- a/frontend/src/pages/BotMonitor/BotMonitorPage.tsx
+++ b/frontend/src/pages/BotMonitor/BotMonitorPage.tsx
@@ -1,6 +1,6 @@
-import { useState } from "react";
+import { Fragment, useMemo, useState } from "react";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
-import { Bot, X } from "lucide-react";
+import { Bot, X, ChevronDown, ChevronUp, AudioLines, MessageSquareText, Paperclip } from "lucide-react";
 import {
   ResponsiveContainer,
   BarChart,
@@ -12,88 +12,87 @@ import {
   PieChart,
   Pie,
   Cell,
+  LineChart,
+  Line,
 } from "recharts";
 import { Header, PageLayout } from "../../components/layout/Header";
 import { EmptyState } from "../../components/EmptyState";
 import { AppSwitcherMenu } from "../../components/AppSwitcherMenu";
 import { inventorySubheader } from "../Inventory/panelMenu";
 import { useAuthStore } from "../../store/auth";
-import { apiV26, type BotTraceRow, type BotTraceDetail } from "../../lib/api";
+import {
+  apiV26,
+  type BotTraceRow,
+  type BotTraceDetail,
+  type BotModelRecord,
+  type BotStageRecord,
+} from "../../lib/api";
 import { faNum, fmtDateTime } from "../../lib/formatters";
 
-// داشبورد مانیتورینگ بات بله (فقط ادمین) — خواندنی از bot-metrics.
-// داده: همان جدول‌های Observability بات؛ گرفانا همان اطلاعات را بیرون از ERP
-// نشان می‌دهد، این صفحه نسخه‌ی فارسی/RTL داخل خود سیستم است.
-// آمار فقط ترافیک واقعی را می‌شمارد (calibration/demo/test حذف می‌شوند).
+// داشبورد مانیتورینگ بات بله (فقط ادمین) — نسخه ۲.۱:
+// تب «نمای کلی» + تب «مدل‌ها» (رکورد و جزئیات هر مدل) + تب «بخش‌ها» (مراحل
+// خط‌لوله به تفکیک بخش) + تب «پیام‌ها» (پرونده‌ی هر پیام با پخش/دانلود ویس و
+// ترنسکریپت‌ها کنار هم). آمار تجمیعی فقط ترافیک واقعی را می‌شمارد؛
+// calibration/demo فقط در تب «پیام‌ها» و با کلید نمایش آزمایشی دیده می‌شوند.
 
 const DAY_OPTIONS = [1, 7, 30, 90] as const;
+type TabKey = "overview" | "models" | "sections" | "messages";
+
+const TABS: { key: TabKey; label: string; hint: string }[] = [
+  { key: "overview", label: "نمای کلی", hint: "خلاصه‌ی کل خط‌لوله" },
+  { key: "models", label: "مدل‌ها", hint: "عملکرد هر مدل هوش مصنوعی" },
+  { key: "sections", label: "بخش‌ها", hint: "مراحل خط‌لوله به تفکیک بخش" },
+  { key: "messages", label: "پیام‌ها", hint: "پرونده‌ی کامل هر پیام" },
+];
 
 const STATUS_LABELS: Record<string, string> = {
   exact: "اتصال دقیق",
   ambiguity: "ابهام (پرسش از کاربر)",
   new: "موجودیت جدید",
 };
-
 const STATUS_COLORS: Record<string, string> = {
   exact: "#16a34a",
   ambiguity: "#d97706",
   new: "#64748b",
 };
-
-const STAGE_LABELS: Record<string, string> = {
-  "jev.request": "درخواست Jev",
-  "jev.result": "پاسخ Jev",
-  "jev.failure": "خطای Jev",
-  "matching.arbitration.result": "داور DeepSeek",
-  "matching.fallback.result": "فالبک بحرانی",
-  "draft.render": "نمایش پیش‌نویس",
-  "draft.commit": "ثبت نهایی",
-  "draft.cancel": "لغو",
-  "ambiguity.sent": "ارسال ابهام",
+const KIND_LABELS: Record<string, string> = {
+  llm: "مدل زبانی",
+  matching: "تطبیق",
+  stt: "گفتار→متن",
+  audio: "صوت",
+};
+const KIND_COLORS: Record<string, string> = {
+  llm: "#3b82f6",
+  matching: "#8b5cf6",
+  stt: "#16a34a",
+  audio: "#d97706",
 };
 
-function Card({
-  label,
-  value,
-  hint,
-  tone = "default",
-}: {
-  label: string;
-  value: string;
-  hint?: string;
-  tone?: "default" | "warn" | "good";
-}) {
-  const toneCls =
-    tone === "warn"
-      ? "border-red-500/25 bg-red-500/5"
-      : tone === "good"
-        ? "border-emerald-500/25 bg-emerald-500/5"
-        : "border-line bg-panel";
-  return (
-    <div className={`rounded-xl border px-3.5 py-3 ${toneCls}`}>
-      <div className="text-[11px] text-muted">{label}</div>
-      <div className="mt-1 text-xl font-bold tabular-nums">{value}</div>
-      {hint ? <div className="mt-0.5 text-[10.5px] text-muted">{hint}</div> : null}
-    </div>
-  );
-}
-
-function Panel({
-  title,
-  children,
-  className = "",
-}: {
-  title: string;
-  children: React.ReactNode;
-  className?: string;
-}) {
-  return (
-    <section className={`rounded-xl border border-line bg-panel p-3.5 ${className}`}>
-      <h3 className="mb-3 text-[13px] font-bold">{title}</h3>
-      {children}
-    </section>
-  );
-}
+const STAGE_FA: Record<string, string> = {
+  "input.text": "متن ورودی",
+  "input.voice": "ویس ورودی",
+  "stt.run": "اجرای STT",
+  "stt.result": "گفتار→متن",
+  "audio.enhance.result": "پیش‌پردازش صدا",
+  "nlu.request": "درخواست درک پیام",
+  "nlu.result": "درک پیام (NLU)",
+  "entities.extracted": "استخراج موجودیت‌ها",
+  "jev.request": "درخواست Jev",
+  "jev.result": "امتیازدهی Jev",
+  "jev.failure": "خطای Jev",
+  "routing.decision": "تصمیم مسیریابی",
+  "matching.arbitration.result": "داوری DeepSeek",
+  "matching.arbitration.failure": "خطای داوری",
+  "matching.fallback.result": "فالبک بحرانی",
+  "matching.fallback.failure": "خطای فالبک",
+  "ambiguity.sent": "ارسال پرسش ابهام",
+  "ambiguity.user_choice": "انتخاب کاربر در ابهام",
+  "user_choice.pick": "دکمه‌ی گزینه",
+  "draft.render": "نمایش پیش‌نویس",
+  "draft.edit": "ویرایش پیش‌نویس",
+  "draft.commit": "ثبت نهایی",
+  "draft.cancel": "لغو",
+};
 
 const tooltipStyle = {
   backgroundColor: "var(--color-panel, #111827)",
@@ -102,12 +101,100 @@ const tooltipStyle = {
   fontSize: 12,
 };
 
+/** convert a stored bot path to a media ref (key under ./bot/data == MinIO key) */
+function toMediaRef(path: unknown): string | null {
+  if (typeof path !== "string" || !path) return null;
+  let p = path.replace(/\\/g, "/").trim();
+  const i = p.indexOf("/srv/bot/data/");
+  if (i >= 0) p = p.slice(i + "/srv/bot/data/".length);
+  if (p.startsWith("data/")) p = p.slice(5);
+  if (/^(voices|attachments)\//.test(p) && !p.includes("..")) return p;
+  return null;
+}
+
+function Card({ label, value, hint, tone = "default", title }: {
+  label: string; value: string; hint?: string; tone?: "default" | "warn" | "good"; title?: string;
+}) {
+  const toneCls =
+    tone === "warn" ? "border-red-500/25 bg-red-500/5"
+    : tone === "good" ? "border-emerald-500/25 bg-emerald-500/5"
+    : "border-line bg-panel";
+  return (
+    <div className={`rounded-xl border px-3.5 py-3 ${toneCls}`} title={title}>
+      <div className="text-[11px] text-muted">{label}</div>
+      <div className="mt-1 text-xl font-bold tabular-nums">{value}</div>
+      {hint ? <div className="mt-0.5 text-[10.5px] text-muted">{hint}</div> : null}
+    </div>
+  );
+}
+
+function Panel({ title, hint, children, className = "" }: {
+  title: string; hint?: string; children: React.ReactNode; className?: string;
+}) {
+  return (
+    <section className={`rounded-xl border border-line bg-panel p-3.5 ${className}`}>
+      <h3 className="mb-1 text-[13px] font-bold">
+        {title}
+        {hint ? <span className="mr-2 font-normal text-[10.5px] text-muted">{hint}</span> : null}
+      </h3>
+      {children}
+    </section>
+  );
+}
+
+/** پخش‌کننده + دانلود برای یک فایل رسانه‌ای (لینک امضاشده‌ی کوتاه‌مدت) */
+function MediaBlock({ ref: mediaRef, label, isAdmin }: {
+  ref: string; label: string; isAdmin: boolean;
+}) {
+  const url = useQuery({
+    queryKey: ["bot-media-url", mediaRef],
+    queryFn: () => apiV26.botMetrics.mediaUrl(mediaRef),
+    enabled: isAdmin && !!mediaRef,
+    staleTime: 4 * 60 * 1000,
+  });
+  const isAudio = /\.(ogg|wav|m4a|mp3)$/i.test(mediaRef);
+  if (!isAdmin) return null;
+  return (
+    <div className="rounded-lg border border-line bg-slate-bg px-3 py-2">
+      <div className="mb-1.5 flex items-center justify-between gap-2">
+        <span className="flex items-center gap-1.5 text-[11.5px] text-muted">
+          <AudioLines className="h-3.5 w-3.5" />
+          {label}
+        </span>
+        {url.data ? (
+          <a
+            href={url.data.url}
+            download={mediaRef.split("/").pop()}
+            className="text-[11px] font-bold text-blue-400 hover:underline"
+          >
+            دانلود
+          </a>
+        ) : (
+          <span className="text-[10.5px] text-muted">{url.isError ? "فایل در دسترس نیست" : "…"}</span>
+        )}
+      </div>
+      {url.data ? (
+        isAudio ? (
+          // eslint-disable-next-line jsx-a11y/media-has-caption
+          <audio controls preload="none" src={url.data.url} className="w-full" />
+        ) : (
+          <a href={url.data.url} target="_blank" rel="noreferrer" className="text-[11.5px] text-blue-400 hover:underline">
+            مشاهده‌ی فایل ↗
+          </a>
+        )
+      ) : null}
+    </div>
+  );
+}
+
 export function BotMonitorPage() {
   const user = useAuthStore((s) => s.user);
   const isAdmin = user?.role === "admin";
   const [days, setDays] = useState<number>(7);
+  const [tab, setTab] = useState<TabKey>("overview");
   const [showSynthetic, setShowSynthetic] = useState(false);
   const [openTrace, setOpenTrace] = useState<string | null>(null);
+  const [openModel, setOpenModel] = useState<string | null>(null);
   const qc = useQueryClient();
 
   const summary = useQuery({
@@ -120,25 +207,25 @@ export function BotMonitorPage() {
     queryFn: () => apiV26.botMetrics.routing(days),
     enabled: isAdmin,
   });
-  const quality = useQuery({
-    queryKey: ["bot-metrics", "quality", days],
-    queryFn: () => apiV26.botMetrics.quality(days),
-    enabled: isAdmin,
+  const models = useQuery({
+    queryKey: ["bot-metrics", "models", days],
+    queryFn: () => apiV26.botMetrics.models(days),
+    enabled: isAdmin && (tab === "overview" || tab === "models"),
   });
-  const jev = useQuery({
-    queryKey: ["bot-metrics", "jev", days],
-    queryFn: () => apiV26.botMetrics.jev(days),
-    enabled: isAdmin,
+  const stages = useQuery({
+    queryKey: ["bot-metrics", "stages", days],
+    queryFn: () => apiV26.botMetrics.stages(days),
+    enabled: isAdmin && (tab === "overview" || tab === "sections"),
   });
-  const stt = useQuery({
-    queryKey: ["bot-metrics", "stt", days],
-    queryFn: () => apiV26.botMetrics.stt(days),
-    enabled: isAdmin,
+  const modelDaily = useQuery({
+    queryKey: ["bot-metrics", "model-daily", openModel, days],
+    queryFn: () => apiV26.botMetrics.modelDaily(openModel!, days),
+    enabled: isAdmin && !!openModel && tab === "models",
   });
   const traces = useQuery({
     queryKey: ["bot-metrics", "traces", showSynthetic],
     queryFn: () => apiV26.botMetrics.traces({ limit: 50, include_synthetic: showSynthetic }),
-    enabled: isAdmin,
+    enabled: isAdmin && tab === "messages",
   });
   const traceDetail = useQuery({
     queryKey: ["bot-metrics", "trace", openTrace],
@@ -165,15 +252,8 @@ export function BotMonitorPage() {
 
   const k = summary.data?.kpis;
   const pieData = (routing.data?.statuses ?? []).map((s) => ({
-    name: STATUS_LABELS[s.metric] ?? s.metric,
-    value: s.n,
-    key: s.metric,
+    name: STATUS_LABELS[s.metric] ?? s.metric, value: s.n, key: s.metric,
   }));
-  const actions = routing.data?.actions;
-  const top = quality.data?.picks.find((p) => p.pick === "top")?.n ?? 0;
-  const other = quality.data?.picks.find((p) => p.pick === "other")?.n ?? 0;
-  const pinnedModel = "jev-1.13.0";
-  const drifted = (jev.data?.models ?? []).some((m) => m.model !== "?" && m.model !== pinnedModel);
   const loading = summary.isLoading || routing.isLoading;
 
   return (
@@ -203,6 +283,7 @@ export function BotMonitorPage() {
             <button
               onClick={() => void qc.invalidateQueries({ queryKey: ["bot-metrics"] })}
               className="btn-line-file cursor-pointer"
+              title="به‌روزرسانی همه‌ی داده‌ها"
             >
               🔄
             </button>
@@ -210,278 +291,73 @@ export function BotMonitorPage() {
         }
       />
       <PageLayout className="flex flex-col gap-3">
-        {loading ? (
+        <div className="rounded-lg border border-line bg-panel px-3 py-2 text-[11px] leading-5 text-muted">
+          «پرونده‌ی پیام» = تمام مراحل پردازش یک پیام کاربر (متن یا ویس) از ورود تا ثبت یا لغو.
+          آمار تب‌ها فقط <b>ترافیک واقعی</b> را می‌شمارد؛ داده‌های آزمایشی/کالیبراسیون جدا نگه داشته می‌شوند.
+        </div>
+
+        {/* تب‌ها */}
+        <div className="flex flex-wrap gap-1.5" role="tablist">
+          {TABS.map((t) => (
+            <button
+              key={t.key}
+              role="tab"
+              aria-selected={tab === t.key}
+              onClick={() => setTab(t.key)}
+              title={t.hint}
+              className={`cursor-pointer rounded-lg border px-3.5 py-1.5 text-[12.5px] ${
+                tab === t.key
+                  ? "border-blue/40 bg-blue/10 font-bold"
+                  : "border-line bg-panel text-muted hover:text-ink"
+              }`}
+            >
+              {t.label}
+            </button>
+          ))}
+        </div>
+
+        {loading && tab === "overview" ? (
           <div className="py-6 text-center text-[12.5px] text-muted">در حال بارگذاری…</div>
-        ) : (
+        ) : null}
+
+        {tab === "overview" && !loading ? <OverviewTab {...{ k, pieData, summary, models: models.data ?? [], stages: stages.data ?? [] }} /> : null}
+        {tab === "models" ? (
+          <ModelsTab
+            rows={models.data ?? []}
+            loading={models.isLoading}
+            openModel={openModel}
+            setOpenModel={setOpenModel}
+            daily={modelDaily.data ?? []}
+            dailyLoading={modelDaily.isLoading}
+          />
+        ) : null}
+        {tab === "sections" ? <SectionsTab rows={stages.data ?? []} loading={stages.isLoading} /> : null}
+        {tab === "messages" ? (
           <>
-            {/* ردیف KPI */}
-            <div className="grid grid-cols-2 gap-2.5 md:grid-cols-4 xl:grid-cols-7">
-              <Card label="روندها" value={faNum(k?.traces ?? 0)} hint="ترافیک واقعی" />
-              <Card label="رخدادها" value={faNum(k?.events ?? 0)} />
-              <Card
-                label="خطای Jev / فالبک"
-                value={faNum(k?.errors ?? 0)}
-                tone={(k?.errors ?? 0) > 0 ? "warn" : "good"}
+            <label className="flex w-fit cursor-pointer items-center gap-1.5 text-[11.5px] text-muted">
+              <input
+                type="checkbox"
+                checked={showSynthetic}
+                onChange={(e) => setShowSynthetic(e.target.checked)}
+                className="accent-blue-500"
               />
-              <Card label="p95 تأخیر Jev" value={`${faNum(k?.jev_p95_ms ?? 0)} ms`} />
-              <Card
-                label="توکن مصرفی"
-                value={faNum((k?.tokens_in ?? 0) + (k?.tokens_out ?? 0))}
-                hint={`ورودی ${faNum(k?.tokens_in ?? 0)} / خروجی ${faNum(k?.tokens_out ?? 0)}`}
-              />
-              <Card label="ثبت نهایی" value={faNum(k?.commits ?? 0)} tone="good" />
-              <Card
-                label="نسخه مدل Jev"
-                value={drifted ? "⚠️ انحراف" : pinnedModel}
-                tone={drifted ? "warn" : "default"}
-              />
-            </div>
-
-            {/* نمودارها */}
-            <div className="grid grid-cols-1 gap-3 lg:grid-cols-2">
-              <Panel title={`رخداد در روز (${faNum(days)} روز اخیر)`}>
-                {(summary.data?.daily ?? []).length === 0 ? (
-                  <EmptyState emoji="📭" text="در این بازه траافیکی ثبت نشده است." />
-                ) : (
-                  <div className="h-56" dir="ltr">
-                    <ResponsiveContainer width="100%" height="100%">
-                      <BarChart data={summary.data!.daily}>
-                        <CartesianGrid strokeDasharray="3 3" stroke="rgba(148,163,184,.15)" />
-                        <XAxis dataKey="day" tick={{ fontSize: 10 }} />
-                        <YAxis tick={{ fontSize: 10 }} width={38} />
-                        <Tooltip contentStyle={tooltipStyle} />
-                        <Bar dataKey="events" name="رخداد" fill="#3b82f6" radius={[4, 4, 0, 0]} />
-                      </BarChart>
-                    </ResponsiveContainer>
-                  </div>
-                )}
-              </Panel>
-
-              <Panel title="وضعیت نهایی mentionها (تطبیق موجودیت)">
-                {pieData.length === 0 || pieData.every((p) => p.value === 0) ? (
-                  <EmptyState emoji="🔍" text="هنوز داده‌ی تطبیقی ثبت نشده است." />
-                ) : (
-                  <div className="flex h-56 items-center gap-4">
-                    <div className="h-full w-1/2" dir="ltr">
-                      <ResponsiveContainer width="100%" height="100%">
-                        <PieChart>
-                          <Pie
-                            data={pieData}
-                            dataKey="value"
-                            nameKey="name"
-                            innerRadius="52%"
-                            outerRadius="85%"
-                            paddingAngle={2}
-                          >
-                            {pieData.map((d) => (
-                              <Cell key={d.key} fill={STATUS_COLORS[d.key] ?? "#94a3b8"} />
-                            ))}
-                          </Pie>
-                          <Tooltip contentStyle={tooltipStyle} />
-                        </PieChart>
-                      </ResponsiveContainer>
-                    </div>
-                    <ul className="flex-1 space-y-1.5 text-[12px]">
-                      {pieData.map((d) => (
-                        <li key={d.key} className="flex items-center justify-between gap-2">
-                          <span className="flex items-center gap-1.5">
-                            <span
-                              className="inline-block h-2.5 w-2.5 rounded-full"
-                              style={{ background: STATUS_COLORS[d.key] ?? "#94a3b8" }}
-                            />
-                            {d.name}
-                          </span>
-                          <span className="tabular-nums font-bold">{faNum(d.value)}</span>
-                        </li>
-                      ))}
-                    </ul>
-                  </div>
-                )}
-              </Panel>
-            </div>
-
-            <div className="grid grid-cols-1 gap-3 lg:grid-cols-3">
-              {/* داور و کیفیت */}
-              <Panel title="داور DeepSeek روی پیشنهادهای Jev">
-                <table className="w-full text-[12px]">
-                  <tbody className="[&_td]:py-1.5 [&_td:last-child]:text-left">
-                    <tr className="border-b border-line">
-                      <td>تأیید پیشنهاد Jev</td>
-                      <td className="font-bold tabular-nums">{faNum(actions?.endorsed_jev ?? 0)}</td>
-                    </tr>
-                    <tr className="border-b border-line">
-                      <td>وتو → ساخت جدید</td>
-                      <td className="font-bold tabular-nums">{faNum(actions?.vetoed_to_new ?? 0)}</td>
-                    </tr>
-                    <tr className="border-b border-line">
-                      <td>تنزل → ابهام</td>
-                      <td className="font-bold tabular-nums">{faNum(actions?.demoted_to_ambiguity ?? 0)}</td>
-                    </tr>
-                    <tr>
-                      <td>فراخوانی داور</td>
-                      <td className="font-bold tabular-nums">{faNum(actions?.invocations ?? 0)}</td>
-                    </tr>
-                  </tbody>
-                </table>
-              </Panel>
-
-              <Panel title="انتخاب کاربر (A/B واقعی)">
-                <div className="space-y-2 text-[12px]">
-                  <div className="flex items-center justify-between">
-                    <span>گزینه‌ی اول (پیشنهاد مدل)</span>
-                    <span className="font-bold tabular-nums text-emerald-500">{faNum(top)}</span>
-                  </div>
-                  <div className="flex items-center justify-between">
-                    <span>گزینه‌ی غیراول</span>
-                    <span className="font-bold tabular-nums text-amber-500">{faNum(other)}</span>
-                  </div>
-                  {(quality.data?.ambiguities ?? []).map((a, i) => (
-                    <div
-                      key={i}
-                      className="flex items-center justify-between border-t border-line pt-1.5 text-muted"
-                    >
-                      <span>
-                        {a.action === "pick" ? "انتخاب کاندیدا" : a.action === "new" ? "«هیچ‌کدام»" : a.action}
-                        {a.arg !== "-" ? ` (${a.arg})` : ""}
-                      </span>
-                      <span className="tabular-nums">{faNum(a.n)}</span>
-                    </div>
-                  ))}
-                </div>
-              </Panel>
-
-              <Panel title="سلامت STT و پیش‌پردازش صدا">
-                <table className="w-full text-[12px]">
-                  <thead className="text-[11px] text-muted">
-                    <tr className="border-b border-line">
-                      <th className="pb-1 text-right">پرووایدر</th>
-                      <th className="pb-1">موفق</th>
-                      <th className="pb-1">p50</th>
-                    </tr>
-                  </thead>
-                  <tbody className="[&_td]:py-1.5 [&_td:not(:first-child)]:tabular-nums [&_td:not(:first-child)]:text-left">
-                    {(stt.data?.providers ?? []).map((p) => (
-                      <tr key={p.provider} className="border-b border-line last:border-0">
-                        <td>{p.provider}</td>
-                        <td className={p.ok < p.total ? "text-amber-500" : ""}>
-                          {faNum(p.ok)}/{faNum(p.total)}
-                        </td>
-                        <td>{p.p50_ms ? `${faNum(p.p50_ms)}ms` : "—"}</td>
-                      </tr>
-                    ))}
-                    {stt.data?.enhance ? (
-                      <tr>
-                        <td>پیش‌پردازش صدا</td>
-                        <td className={stt.data.enhance.ok < stt.data.enhance.total ? "text-amber-500" : ""}>
-                          {faNum(stt.data.enhance.ok)}/{faNum(stt.data.enhance.total)}
-                        </td>
-                        <td>{stt.data.enhance.p50_ms ? `${faNum(stt.data.enhance.p50_ms)}ms` : "—"}</td>
-                      </tr>
-                    ) : null}
-                  </tbody>
-                </table>
-              </Panel>
-            </div>
-
-            <div className="grid grid-cols-1 gap-3 lg:grid-cols-2">
-              <Panel title="تأخیر مراحل (p50 / p95 میلی‌ثانیه)">
-                <table className="w-full text-[12px]">
-                  <tbody className="[&_td]:py-1.5 [&_td:not(:first-child)]:tabular-nums [&_td:not(:first-child)]:text-left">
-                    {(jev.data?.latency ?? []).map((l) => (
-                      <tr key={l.stage} className="border-b border-line last:border-0">
-                        <td>{STAGE_LABELS[l.stage] ?? l.stage}</td>
-                        <td>{faNum(l.p50)} / {faNum(l.p95)}</td>
-                        <td className="text-muted">{faNum(l.n)}×</td>
-                      </tr>
-                    ))}
-                    {(jev.data?.latency ?? []).length === 0 ? (
-                      <tr>
-                        <td className="text-muted">داده‌ای ثبت نشده</td>
-                      </tr>
-                    ) : null}
-                  </tbody>
-                </table>
-              </Panel>
-
-              <Panel title={`توکن مصرفی در روز${drifted ? " — ⚠️ مدل متفاوت از پین دیده شده" : ""}`}>
-                {(jev.data?.tokens_daily ?? []).length === 0 ? (
-                  <EmptyState emoji="🪙" text="هنوز مصرف توکنی ثبت نشده است." />
-                ) : (
-                  <div className="h-48" dir="ltr">
-                    <ResponsiveContainer width="100%" height="100%">
-                      <BarChart data={jev.data!.tokens_daily}>
-                        <CartesianGrid strokeDasharray="3 3" stroke="rgba(148,163,184,.15)" />
-                        <XAxis dataKey="day" tick={{ fontSize: 10 }} />
-                        <YAxis tick={{ fontSize: 10 }} width={52} />
-                        <Tooltip contentStyle={tooltipStyle} />
-                        <Bar dataKey="tokens_in" name="ورودی" stackId="t" fill="#3b82f6" />
-                        <Bar dataKey="tokens_out" name="خروجی" stackId="t" fill="#8b5cf6" radius={[4, 4, 0, 0]} />
-                      </BarChart>
-                    </ResponsiveContainer>
-                  </div>
-                )}
-              </Panel>
-            </div>
-
-            {/* جدول ترس‌ها */}
-            <Panel title="آخرین ترس‌ها (برای جزئیات کلیک کنید)">
-              <label className="mb-2 flex cursor-pointer items-center gap-1.5 text-[11.5px] text-muted">
-                <input
-                  type="checkbox"
-                  checked={showSynthetic}
-                  onChange={(e) => setShowSynthetic(e.target.checked)}
-                  className="accent-blue-500"
-                />
-                نمایش ترافیک آزمایشی (calibration/demo)
-              </label>
-              {traces.isLoading ? (
-                <div className="py-3 text-center text-[12px] text-muted">در حال بارگذاری…</div>
-              ) : (traces.data ?? []).length === 0 ? (
-                <EmptyState emoji="🗂" text="تریسی ثبت نشده است." />
-              ) : (
-                <div className="max-h-96 overflow-auto rounded-lg border border-line">
-                  <table className="w-full text-[12px]">
-                    <thead className="sticky top-0 bg-slate-bg text-[11px] text-muted">
-                      <tr className="border-b border-line">
-                        <th className="p-2 text-right">زمان</th>
-                        <th className="p-2 text-right">منبع</th>
-                        <th className="p-2">چت</th>
-                        <th className="p-2">نوع</th>
-                        <th className="p-2">وضعیت</th>
-                        <th className="p-2">رخداد</th>
-                      </tr>
-                    </thead>
-                    <tbody>
-                      {(traces.data ?? []).map((t: BotTraceRow) => (
-                        <tr
-                          key={t.id}
-                          onClick={() => setOpenTrace(t.id)}
-                          className="cursor-pointer border-b border-line last:border-0 hover:bg-slate-bg"
-                          title={t.id}
-                        >
-                          <td className="p-2 text-muted">{fmtDateTime(t.created_at)}</td>
-                          <td className="p-2">{t.source}</td>
-                          <td className="p-2 text-center tabular-nums">{t.chat_id}</td>
-                          <td className="p-2 text-center">{t.kind}</td>
-                          <td className="p-2 text-center">{t.status}</td>
-                          <td className="p-2 text-center tabular-nums">{faNum(t.events)}</td>
-                        </tr>
-                      ))}
-                    </tbody>
-                  </table>
-                </div>
-              )}
-            </Panel>
+              شامل ترافیک آزمایشی (calibration/demo)
+            </label>
+            <MessagesTable
+              rows={traces.data ?? []}
+              loading={traces.isLoading}
+              onOpen={setOpenTrace}
+            />
           </>
-        )}
+        ) : null}
       </PageLayout>
 
-      {/* درایور جزئیات ترس */}
       {openTrace ? (
-        <TraceDrawer
+        <MessageDrawer
           traceId={openTrace}
           detail={traceDetail.data ?? null}
           loading={traceDetail.isLoading}
+          isAdmin={isAdmin}
           onClose={() => {
             setOpenTrace(null);
             void qc.removeQueries({ queryKey: ["bot-metrics", "trace"] });
@@ -492,30 +368,415 @@ export function BotMonitorPage() {
   );
 }
 
-function TraceDrawer({
-  traceId,
-  detail,
-  loading,
-  onClose,
-}: {
+/* ------------------------------------------------------------------ نمای کلی */
+
+function OverviewTab({ k, pieData, summary, models, stages }: {
+  k: ReturnType<typeof Object> | any;
+  pieData: { name: string; value: number; key: string }[];
+  summary: { data?: { daily?: { day: string; events: number; traces: number }[] } };
+  models: BotModelRecord[];
+  stages: BotStageRecord[];
+}) {
+  const sections = useMemo(() => {
+    const m = new Map<string, number>();
+    for (const s of stages) m.set(s.section, (m.get(s.section) ?? 0) + s.n);
+    return [...m.entries()].sort((a, b) => b[1] - a[1]);
+  }, [stages]);
+
+  return (
+    <div className="flex flex-col gap-3">
+      <div className="grid grid-cols-2 gap-2.5 md:grid-cols-4 xl:grid-cols-7">
+        <Card label="پرونده‌های پیام" value={faNum(k?.traces ?? 0)} hint="ترافیک واقعی" title="هر پیام کاربر یک پرونده است" />
+        <Card label="رخدادها" value={faNum(k?.events ?? 0)} title="مجموع رکوردهای ثبت‌شده در تمام مراحل" />
+        <Card label="خطای مدل‌ها" value={faNum(k?.errors ?? 0)} tone={(k?.errors ?? 0) > 0 ? "warn" : "good"} title="خطای Jev/داور/فالبک" />
+        <Card label="p95 تأخیر Jev" value={`${faNum(k?.jev_p95_ms ?? 0)} ms`} />
+        <Card label="توکن مصرفی" value={faNum((k?.tokens_in ?? 0) + (k?.tokens_out ?? 0))} hint={`ورودی ${faNum(k?.tokens_in ?? 0)} / خروجی ${faNum(k?.tokens_out ?? 0)}`} />
+        <Card label="ثبت نهایی" value={faNum(k?.commits ?? 0)} tone="good" title="پیش‌نویس‌هایی که به استعلام تبدیل شدند" />
+        <Card
+          label="مدل‌های فعال"
+          value={faNum(models.filter((m) => m.calls > 0).length)}
+          hint={models.some((m) => m.drift) ? "⚠️ انحراف نسخه!" : "بدون انحراف نسخه"}
+          tone={models.some((m) => m.drift) ? "warn" : "default"}
+        />
+      </div>
+
+      <div className="grid grid-cols-1 gap-3 lg:grid-cols-2">
+        <Panel title="رخداد در روز" hint="ترافیک واقعی">
+          {(summary.data?.daily ?? []).length === 0 ? (
+            <EmptyState emoji="📭" text="در این بازه ترافیکی ثبت نشده است." />
+          ) : (
+            <div className="h-52" dir="ltr">
+              <ResponsiveContainer width="100%" height="100%">
+                <BarChart data={summary.data!.daily}>
+                  <CartesianGrid strokeDasharray="3 3" stroke="rgba(148,163,184,.15)" />
+                  <XAxis dataKey="day" tick={{ fontSize: 10 }} />
+                  <YAxis tick={{ fontSize: 10 }} width={38} />
+                  <Tooltip contentStyle={tooltipStyle} />
+                  <Bar dataKey="events" name="رخداد" fill="#3b82f6" radius={[4, 4, 0, 0]} />
+                </BarChart>
+              </ResponsiveContainer>
+            </div>
+          )}
+        </Panel>
+
+        <Panel title="وضعیت نهایی تطبیق موجودیت‌ها" hint="دکمه‌ی «مدل‌ها» برای جزئیات">
+          {pieData.length === 0 || pieData.every((p) => p.value === 0) ? (
+            <EmptyState emoji="🔍" text="هنوز داده‌ی تطبیقی ثبت نشده است." />
+          ) : (
+            <div className="flex h-52 items-center gap-4">
+              <div className="h-full w-1/2" dir="ltr">
+                <ResponsiveContainer width="100%" height="100%">
+                  <PieChart>
+                    <Pie data={pieData} dataKey="value" nameKey="name" innerRadius="52%" outerRadius="85%" paddingAngle={2}>
+                      {pieData.map((d) => (
+                        <Cell key={d.key} fill={STATUS_COLORS[d.key] ?? "#94a3b8"} />
+                      ))}
+                    </Pie>
+                    <Tooltip contentStyle={tooltipStyle} />
+                  </PieChart>
+                </ResponsiveContainer>
+              </div>
+              <ul className="flex-1 space-y-1.5 text-[12px]">
+                {pieData.map((d) => (
+                  <li key={d.key} className="flex items-center justify-between gap-2">
+                    <span className="flex items-center gap-1.5">
+                      <span className="inline-block h-2.5 w-2.5 rounded-full" style={{ background: STATUS_COLORS[d.key] ?? "#94a3b8" }} />
+                      {d.name}
+                    </span>
+                    <span className="tabular-nums font-bold">{faNum(d.value)}</span>
+                  </li>
+                ))}
+              </ul>
+            </div>
+          )}
+        </Panel>
+      </div>
+
+      <div className="grid grid-cols-1 gap-3 lg:grid-cols-2">
+        <Panel title="مدل‌ها در یک نگاه" hint="جزئیات کامل در تب «مدل‌ها»">
+          <div className="max-h-64 overflow-auto">
+            <table className="w-full text-[12px]">
+              <thead className="sticky top-0 bg-panel text-[11px] text-muted">
+                <tr className="border-b border-line">
+                  <th className="p-1.5 text-right">مدل</th>
+                  <th className="p-1.5">فراخوانی</th>
+                  <th className="p-1.5">موفق</th>
+                  <th className="p-1.5">p95</th>
+                </tr>
+              </thead>
+              <tbody>
+                {models.map((m) => (
+                  <tr key={m.id} className="border-b border-line last:border-0">
+                    <td className="p-1.5">
+                      <span className="ml-1.5 inline-block h-2 w-2 rounded-full align-middle" style={{ background: KIND_COLORS[m.kind] ?? "#94a3b8" }} />
+                      {m.name}
+                      {m.drift ? <span className="mr-1 text-red-400" title={`نسخه‌ی متفاوت از پین ${m.pinned}`}>⚠️</span> : null}
+                    </td>
+                    <td className="p-1.5 text-center tabular-nums">{faNum(m.calls)}</td>
+                    <td className="p-1.5 text-center tabular-nums">
+                      {m.calls ? `${faNum(Math.round((100 * m.ok) / m.calls))}٪` : "—"}
+                    </td>
+                    <td className="p-1.5 text-center tabular-nums">{faNum(m.p95)}ms</td>
+                  </tr>
+                ))}
+                {models.length === 0 ? (
+                  <tr><td colSpan={4} className="p-3 text-center text-muted">داده‌ای نیست</td></tr>
+                ) : null}
+              </tbody>
+            </table>
+          </div>
+        </Panel>
+
+        <Panel title="بخش‌های خط‌لوله" hint="جزئیات کامل در تب «بخش‌ها»">
+          <ul className="space-y-2">
+            {sections.map(([sec, n]) => (
+              <li key={sec} className="flex items-center justify-between text-[12.5px]">
+                <span>{sec}</span>
+                <span className="tabular-nums font-bold">{faNum(n)}</span>
+              </li>
+            ))}
+            {sections.length === 0 ? <li className="text-muted">داده‌ای نیست</li> : null}
+          </ul>
+        </Panel>
+      </div>
+    </div>
+  );
+}
+
+/* --------------------------------------------------------------------- مدل‌ها */
+
+function ModelsTab({ rows, loading, openModel, setOpenModel, daily, dailyLoading }: {
+  rows: BotModelRecord[];
+  loading: boolean;
+  openModel: string | null;
+  setOpenModel: (v: string | null) => void;
+  daily: { day: string; calls: number; fails: number; p50: number; tokens_in: number; tokens_out: number }[];
+  dailyLoading: boolean;
+}) {
+  return (
+    <div className="flex flex-col gap-3">
+      <Panel title="رکورد عملکرد مدل‌ها" hint="روی هر ردیف کلیک کنید تا روند زمانی‌اش باز شود">
+        {loading ? (
+          <div className="py-4 text-center text-[12px] text-muted">در حال بارگذاری…</div>
+        ) : (
+          <div className="overflow-auto rounded-lg border border-line">
+            <table className="w-full text-[12px]">
+              <thead className="bg-slate-bg text-[11px] text-muted">
+                <tr className="border-b border-line">
+                  <th className="p-2 text-right">مدل</th>
+                  <th className="p-2">نوع</th>
+                  <th className="p-2">فراخوانی</th>
+                  <th className="p-2">نرخ موفقیت</th>
+                  <th className="p-2">p50 / p95</th>
+                  <th className="p-2">توکن (ورود/خروج)</th>
+                  <th className="p-2">آخرین اجرا</th>
+                </tr>
+              </thead>
+              <tbody>
+                {rows.map((m) => (
+                  <Fragment key={m.id}>
+                    <tr
+                      onClick={() => setOpenModel(openModel === m.id ? null : m.id)}
+                      className={`cursor-pointer border-b border-line hover:bg-slate-bg ${openModel === m.id ? "bg-slate-bg" : ""}`}
+                    >
+                      <td className="p-2">
+                        <span className="ml-1.5 inline-flex items-center gap-1.5">
+                          {openModel === m.id ? <ChevronUp className="h-3 w-3" /> : <ChevronDown className="h-3 w-3" />}
+                          <span className="inline-block h-2 w-2 rounded-full" style={{ background: KIND_COLORS[m.kind] ?? "#94a3b8" }} />
+                          {m.name}
+                        </span>
+                        {m.drift ? (
+                          <span className="mr-1.5 text-[10px] text-red-400" title={`نسخه‌ی دیده‌شده ≠ پین ${m.pinned}`}>
+                            ⚠️ انحراف نسخه ({m.versions.join(", ")})
+                          </span>
+                        ) : null}
+                      </td>
+                      <td className="p-2 text-center">{KIND_LABELS[m.kind] ?? m.kind}</td>
+                      <td className="p-2 text-center tabular-nums">{faNum(m.calls)}</td>
+                      <td className="p-2 text-center tabular-nums">
+                        {m.calls ? (
+                          <span className={m.ok < m.calls ? "text-amber-500" : "text-emerald-500"}>
+                            {faNum(Math.round((100 * m.ok) / m.calls))}٪
+                          </span>
+                        ) : "—"}
+                      </td>
+                      <td className="p-2 text-center tabular-nums">{faNum(m.p50)} / {faNum(m.p95)} ms</td>
+                      <td className="p-2 text-center tabular-nums">
+                        {m.tokens_in || m.tokens_out ? `${faNum(m.tokens_in)} / ${faNum(m.tokens_out)}` : "—"}
+                      </td>
+                      <td className="p-2 text-center text-muted">{m.last_seen ? fmtDateTime(m.last_seen) : "—"}</td>
+                    </tr>
+                    {openModel === m.id ? (
+                      <tr key={`${m.id}-detail`} className="border-b border-line bg-slate-bg">
+                        <td colSpan={7} className="p-3">
+                          {dailyLoading ? (
+                            <div className="py-3 text-center text-[12px] text-muted">در حال بارگذاری روند…</div>
+                          ) : daily.length === 0 ? (
+                            <EmptyState emoji="📈" text="در این بازه داده‌ای برای این مدل ثبت نشده است." />
+                          ) : (
+                            <div className="grid grid-cols-1 gap-3 md:grid-cols-2">
+                              <div className="h-44" dir="ltr">
+                                <div className="mb-1 text-[11px] text-muted">فراخوانی و خطا در روز</div>
+                                <ResponsiveContainer width="100%" height="100%">
+                                  <BarChart data={daily}>
+                                    <CartesianGrid strokeDasharray="3 3" stroke="rgba(148,163,184,.15)" />
+                                    <XAxis dataKey="day" tick={{ fontSize: 9 }} />
+                                    <YAxis tick={{ fontSize: 9 }} width={30} />
+                                    <Tooltip contentStyle={tooltipStyle} />
+                                    <Bar dataKey="calls" name="فراخوانی" stackId="a" fill="#3b82f6" />
+                                    <Bar dataKey="fails" name="خطا" stackId="a" fill="#ef4444" radius={[4, 4, 0, 0]} />
+                                  </BarChart>
+                                </ResponsiveContainer>
+                              </div>
+                              <div className="h-44" dir="ltr">
+                                <div className="mb-1 text-[11px] text-muted">توکن مصرفی در روز</div>
+                                <ResponsiveContainer width="100%" height="100%">
+                                  <BarChart data={daily}>
+                                    <CartesianGrid strokeDasharray="3 3" stroke="rgba(148,163,184,.15)" />
+                                    <XAxis dataKey="day" tick={{ fontSize: 9 }} />
+                                    <YAxis tick={{ fontSize: 9 }} width={44} />
+                                    <Tooltip contentStyle={tooltipStyle} />
+                                    <Bar dataKey="tokens_in" name="ورودی" stackId="t" fill="#8b5cf6" />
+                                    <Bar dataKey="tokens_out" name="خروجی" stackId="t" fill="#22d3ee" radius={[4, 4, 0, 0]} />
+                                  </BarChart>
+                                </ResponsiveContainer>
+                              </div>
+                              <div className="h-36 md:col-span-2" dir="ltr">
+                                <div className="mb-1 text-[11px] text-muted">تأخیر میانه (p50) در روز</div>
+                                <ResponsiveContainer width="100%" height="100%">
+                                  <LineChart data={daily}>
+                                    <CartesianGrid strokeDasharray="3 3" stroke="rgba(148,163,184,.15)" />
+                                    <XAxis dataKey="day" tick={{ fontSize: 9 }} />
+                                    <YAxis tick={{ fontSize: 9 }} width={38} />
+                                    <Tooltip contentStyle={tooltipStyle} />
+                                    <Line type="monotone" dataKey="p50" name="p50 (ms)" stroke="#16a34a" strokeWidth={2} dot={false} />
+                                  </LineChart>
+                                </ResponsiveContainer>
+                              </div>
+                            </div>
+                          )}
+                        </td>
+                      </tr>
+                    ) : null}
+                  </Fragment>
+                ))}
+                {rows.length === 0 ? (
+                  <tr><td colSpan={7} className="p-3 text-center text-muted">مدلی ثبت نشده است</td></tr>
+                ) : null}
+              </tbody>
+            </table>
+          </div>
+        )}
+      </Panel>
+    </div>
+  );
+}
+
+/* --------------------------------------------------------------------- بخش‌ها */
+
+const SECTION_ORDER = ["صوت", "درک پیام", "تطبیق", "ابهام و انتخاب", "پیش‌نویس", "سایر"];
+
+function SectionsTab({ rows, loading }: { rows: BotStageRecord[]; loading: boolean }) {
+  const grouped = useMemo(() => {
+    const m = new Map<string, BotStageRecord[]>();
+    for (const r of rows) {
+      const key = m.has(r.section) ? r.section : "سایر";
+      m.set(key, [...(m.get(key) ?? []), r]);
+    }
+    return [...m.entries()].sort(
+      (a, b) =>
+        (SECTION_ORDER.indexOf(a[0]) + 100) % 200 - (SECTION_ORDER.indexOf(b[0]) + 100) % 200,
+    );
+  }, [rows]);
+
+  if (loading) return <div className="py-4 text-center text-[12px] text-muted">در حال بارگذاری…</div>;
+  if (rows.length === 0) return <EmptyState emoji="🧩" text="هنوز داده‌ای ثبت نشده است." />;
+
+  return (
+    <div className="grid grid-cols-1 gap-3 lg:grid-cols-2">
+      {grouped.map(([section, items]) => (
+        <Panel key={section} title={section} hint={`${faNum(items.reduce((a, b) => a + b.n, 0))} رخداد`}>
+          <table className="w-full text-[12px]">
+            <thead className="text-[11px] text-muted">
+              <tr className="border-b border-line">
+                <th className="pb-1 text-right">مرحله</th>
+                <th className="pb-1">تعداد</th>
+                <th className="pb-1">خطا</th>
+                <th className="pb-1">p50/p95</th>
+                <th className="pb-1">توکن</th>
+              </tr>
+            </thead>
+            <tbody>
+              {items.map((s) => (
+                <tr key={s.stage} className="border-b border-line last:border-0">
+                  <td className="py-1.5">
+                    {s.stage_fa}
+                    <span className="mr-1.5 font-mono text-[9.5px] text-muted" dir="ltr">{s.stage}</span>
+                  </td>
+                  <td className="py-1.5 text-center tabular-nums">{faNum(s.n)}</td>
+                  <td className={`py-1.5 text-center tabular-nums ${s.fails ? "text-amber-500" : "text-muted"}`}>{faNum(s.fails)}</td>
+                  <td className="py-1.5 text-center tabular-nums">{s.p50 || s.p95 ? `${faNum(s.p50)}/${faNum(s.p95)}` : "—"}</td>
+                  <td className="py-1.5 text-center tabular-nums">
+                    {s.tokens_in || s.tokens_out ? faNum(s.tokens_in + s.tokens_out) : "—"}
+                  </td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </Panel>
+      ))}
+    </div>
+  );
+}
+
+/* -------------------------------------------------------------------- پیام‌ها */
+
+function MessagesTable({ rows, loading, onOpen }: {
+  rows: BotTraceRow[]; loading: boolean; onOpen: (id: string) => void;
+}) {
+  if (loading) return <div className="py-4 text-center text-[12px] text-muted">در حال بارگذاری…</div>;
+  if (rows.length === 0) return <EmptyState emoji="🗂" text="پرونده‌ای ثبت نشده است." />;
+  return (
+    <Panel title="پرونده‌های پیام" hint="برای متن، ویس، ترنسکریپت‌ها و همه‌ی رویدادها کلیک کنید">
+      <div className="max-h-[32rem] overflow-auto rounded-lg border border-line">
+        <table className="w-full text-[12px]">
+          <thead className="sticky top-0 bg-slate-bg text-[11px] text-muted">
+            <tr className="border-b border-line">
+              <th className="p-2 text-right">زمان</th>
+              <th className="p-2">ورودی</th>
+              <th className="p-2 text-right">متن/گزیده</th>
+              <th className="p-2">منبع</th>
+              <th className="p-2">وضعیت</th>
+              <th className="p-2">رویداد</th>
+            </tr>
+          </thead>
+          <tbody>
+            {rows.map((t) => (
+              <tr
+                key={t.id}
+                onClick={() => onOpen(t.id)}
+                className="cursor-pointer border-b border-line last:border-0 hover:bg-slate-bg"
+                title={`پرونده ${t.id}`}
+              >
+                <td className="p-2 whitespace-nowrap text-muted">{fmtDateTime(t.created_at)}</td>
+                <td className="p-2 text-center" title={t.input_kind === "voice" ? "پیام صوتی" : "پیام متنی"}>
+                  {t.input_kind === "voice" ? "🎤" : "💬"}
+                </td>
+                <td className="max-w-[22rem] truncate p-2">{t.text_excerpt || "—"}</td>
+                <td className="p-2 text-center">{t.source}</td>
+                <td className="p-2 text-center">{t.status}</td>
+                <td className="p-2 text-center tabular-nums">{faNum(t.events)}</td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      </div>
+    </Panel>
+  );
+}
+
+/* ------------------------------------------------------------------- درایور */
+
+function MessageDrawer({ traceId, detail, loading, isAdmin, onClose }: {
   traceId: string;
   detail: BotTraceDetail | null;
   loading: boolean;
+  isAdmin: boolean;
   onClose: () => void;
 }) {
+  const events = detail?.events ?? [];
+  const inputText = events.find((e) => e.stage === "input.text")?.payload?.text as string | undefined;
+  const voicePath = events.find((e) => e.stage === "input.voice")?.payload?.path as string | undefined;
+  const enhanced = events.find((e) => e.stage === "audio.enhance.result" && e.ok)?.payload?.path as string | undefined;
+  const transcripts = events
+    .filter((e) => e.stage === "stt.result" && e.ok && (e.payload?.text as string | undefined))
+    .map((e) => ({
+      provider: (e.payload?.provider as string) ?? e.model ?? "?",
+      text: e.payload!.text as string,
+    }));
+  const consensus = events.find((e) => e.stage === "nlu.result")?.payload?.consensus_text as string | undefined;
+  const attachments = events
+    .map((e) => {
+      const p = e.payload as Record<string, unknown> | undefined;
+      const ref =
+        toMediaRef(p?.media_ref) ?? toMediaRef(p?.relative_path) ?? toMediaRef(p?.saved_path) ?? toMediaRef(p?.path);
+      return ref && !ref.startsWith("voices/") && e.stage !== "input.voice" && e.stage !== "audio.enhance.result"
+        ? { ref, name: (p?.file_name as string) ?? ref.split("/").pop()! }
+        : null;
+    })
+    .filter((x): x is { ref: string; name: string } => !!x);
+
   return (
     <div className="fixed inset-0 z-50 flex" onClick={onClose}>
       <div className="flex-1 bg-black/40" />
       <aside
-        className="flex h-full w-full max-w-xl flex-col border-r border-line bg-bg shadow-2xl"
+        className="flex h-full w-full max-w-2xl flex-col border-r border-line bg-bg shadow-2xl"
         onClick={(e) => e.stopPropagation()}
       >
         <div className="flex items-center justify-between border-b border-line px-4 py-3">
           <div>
-            <div className="text-[13px] font-bold">جزئیات ترس</div>
-            <div className="mt-0.5 font-mono text-[10px] text-muted" dir="ltr">
-              {traceId}
-            </div>
+            <div className="text-[13px] font-bold">پرونده‌ی پیام</div>
+            <div className="mt-0.5 font-mono text-[10px] text-muted" dir="ltr">{traceId}</div>
           </div>
           <button
             onClick={onClose}
@@ -525,65 +786,118 @@ function TraceDrawer({
             <X className="h-4 w-4" />
           </button>
         </div>
+
         <div className="flex-1 overflow-auto p-4">
           {loading ? (
             <div className="py-6 text-center text-[12.5px] text-muted">در حال بارگذاری…</div>
           ) : !detail?.trace ? (
-            <EmptyState emoji="❓" text="تریسی با این شناسه یافت نشد." />
+            <EmptyState emoji="❓" text="پرونده‌ای با این شناسه یافت نشد." />
           ) : (
-            <>
-              <div className="mb-3 grid grid-cols-2 gap-2 text-[12px] sm:grid-cols-4">
+            <div className="flex flex-col gap-4">
+              <div className="grid grid-cols-2 gap-2 text-[12px] sm:grid-cols-4">
                 <Card label="زمان" value={fmtDateTime(detail.trace.created_at)} />
                 <Card label="منبع" value={detail.trace.source} />
-                <Card label="وضعیت" value={detail.trace.status} />
-                <Card label="رخدادها" value={faNum(detail.events.length)} />
+                <Card label="وضعیت" value={detail.trace.status} title="open=در جریان، committed=ثبت‌شده، cancelled=لغو‌شده" />
+                <Card label="رویدادها" value={faNum(events.length)} />
               </div>
               {detail.trace.committed_quote_id ? (
-                <div className="mb-3 rounded-lg border border-emerald-500/25 bg-emerald-500/5 px-3 py-2 text-[11.5px]">
-                  استعلام ثبت‌شده:{" "}
-                  <span className="font-mono" dir="ltr">
-                    {detail.trace.committed_quote_id}
-                  </span>
+                <div className="rounded-lg border border-emerald-500/25 bg-emerald-500/5 px-3 py-2 text-[11.5px]">
+                  استعلام ثبت‌شده: <span className="font-mono" dir="ltr">{detail.trace.committed_quote_id}</span>
                 </div>
               ) : null}
-              <ol className="space-y-1.5">
-                {detail.events.map((e, i) => (
-                  <li
-                    key={i}
-                    className={`rounded-lg border px-3 py-2 text-[11.5px] ${
-                      e.ok ? "border-line bg-panel" : "border-red-500/30 bg-red-500/5"
-                    }`}
-                  >
-                    <div className="flex flex-wrap items-center gap-x-3 gap-y-1">
-                      <span className="font-bold">{STAGE_LABELS[e.stage] ?? e.stage}</span>
-                      <span className="font-mono text-[10px] text-muted" dir="ltr">
-                        {e.stage}
-                      </span>
-                      {!e.ok ? <span className="text-red-400">✗ خطا</span> : null}
-                      {e.latency_ms != null ? (
-                        <span className="tabular-nums text-muted">{faNum(e.latency_ms)}ms</span>
-                      ) : null}
-                      {e.model ? <span className="text-muted">{e.model}</span> : null}
-                      {e.field ? <span className="text-muted">فیلد: {e.field}</span> : null}
-                      <span className="mr-auto text-muted">{fmtDateTime(e.created_at)}</span>
+
+              {/* ① متن، صدا و ترنسکریپت‌ها */}
+              <Panel title="پیام کاربر و ترنسکریپت‌ها" hint="متن اصلی، هر موتور STT و متن اجماع — کنار هم">
+                <div className="flex flex-col gap-2">
+                  {voicePath ? (
+                    <MediaBlock ref={toMediaRef(voicePath) ?? ""} label="ویس خام کاربر" isAdmin={isAdmin} />
+                  ) : null}
+                  {enhanced ? (
+                    <MediaBlock ref={toMediaRef(enhanced) ?? ""} label="ویس پس از پیش‌پردازش (نویززدایی)" isAdmin={isAdmin} />
+                  ) : null}
+                  {inputText ? (
+                    <div className="rounded-lg border border-line bg-slate-bg px-3 py-2 text-[12px] leading-6">
+                      <div className="mb-1 flex items-center gap-1.5 text-[11px] text-muted">
+                        <MessageSquareText className="h-3.5 w-3.5" /> متن پیام
+                      </div>
+                      {inputText}
                     </div>
-                    {Object.keys(e.payload ?? {}).length > 0 ? (
-                      <details className="mt-1.5">
-                        <summary className="cursor-pointer text-[10.5px] text-muted">
-                          نمایش جزئیات
-                        </summary>
-                        <pre
-                          className="mt-1 max-h-56 overflow-auto rounded bg-slate-bg p-2 font-mono text-[10px] leading-5"
-                          dir="ltr"
-                        >
-                          {JSON.stringify(e.payload, null, 2)}
-                        </pre>
-                      </details>
-                    ) : null}
-                  </li>
-                ))}
-              </ol>
-            </>
+                  ) : null}
+                  {transcripts.length > 0 ? (
+                    <div className="grid grid-cols-1 gap-2">
+                      {transcripts.map((t, i) => (
+                        <div key={i} className="rounded-lg border border-line bg-slate-bg px-3 py-2 text-[12px] leading-6">
+                          <div className="mb-1 text-[11px] font-bold text-muted">
+                            ترنسکریپت {t.provider}
+                          </div>
+                          {t.text}
+                        </div>
+                      ))}
+                    </div>
+                  ) : null}
+                  {consensus && (transcripts.length > 0 || voicePath) ? (
+                    <div className="rounded-lg border border-emerald-500/25 bg-emerald-500/5 px-3 py-2 text-[12px] leading-6">
+                      <div className="mb-1 text-[11px] font-bold text-emerald-400">متن اجماع (ورودی NLU)</div>
+                      {consensus}
+                    </div>
+                  ) : null}
+                  {!voicePath && !inputText && transcripts.length === 0 ? (
+                    <div className="text-[11.5px] text-muted">متن/ویسی برای این پرونده ذخیره نشده است.</div>
+                  ) : null}
+                </div>
+              </Panel>
+
+              {/* ② پیوست‌های کاربر */}
+              {attachments.length > 0 ? (
+                <Panel title="فایل‌های ارسالی کاربر" hint="پیوست‌های ذخیره‌شده (پیش‌فاکتور و…)">
+                  <ul className="space-y-2">
+                    {attachments.map((a) => (
+                      <li key={a.ref} className="flex items-center gap-2 text-[12px]">
+                        <Paperclip className="h-3.5 w-3.5 text-muted" />
+                        <span className="flex-1 truncate">{a.name}</span>
+                      </li>
+                    ))}
+                  </ul>
+                  <div className="mt-2 flex flex-col gap-2">
+                    {attachments.map((a) => (
+                      <MediaBlock key={a.ref} ref={a.ref} label={a.name} isAdmin={isAdmin} />
+                    ))}
+                  </div>
+                </Panel>
+              ) : null}
+
+              {/* ③ خط زمان رویدادها */}
+              <Panel title="خط زمان رویدادها" hint="همه‌ی مراحل پردازش این پیام">
+                <ol className="space-y-1.5">
+                  {events.map((e, i) => (
+                    <li
+                      key={i}
+                      className={`rounded-lg border px-3 py-2 text-[11.5px] ${
+                        e.ok ? "border-line bg-panel" : "border-red-500/30 bg-red-500/5"
+                      }`}
+                    >
+                      <div className="flex flex-wrap items-center gap-x-3 gap-y-1">
+                        <span className="font-bold">{STAGE_FA[e.stage] ?? e.stage}</span>
+                        <span className="font-mono text-[10px] text-muted" dir="ltr">{e.stage}</span>
+                        {!e.ok ? <span className="text-red-400">✗ خطا</span> : null}
+                        {e.latency_ms != null ? <span className="tabular-nums text-muted">{faNum(e.latency_ms)}ms</span> : null}
+                        {e.model ? <span className="text-muted">{e.model}</span> : null}
+                        {e.field ? <span className="text-muted">فیلد: {e.field}</span> : null}
+                        <span className="mr-auto text-muted">{fmtDateTime(e.created_at)}</span>
+                      </div>
+                      {Object.keys(e.payload ?? {}).length > 0 ? (
+                        <details className="mt-1.5">
+                          <summary className="cursor-pointer text-[10.5px] text-muted">نمایش جزئیات</summary>
+                          <pre className="mt-1 max-h-56 overflow-auto rounded bg-slate-bg p-2 font-mono text-[10px] leading-5" dir="ltr">
+                            {JSON.stringify(e.payload, null, 2)}
+                          </pre>
+                        </details>
+                      ) : null}
+                    </li>
+                  ))}
+                </ol>
+              </Panel>
+            </div>
           )}
         </div>
       </aside>
diff --git a/monitoring/README.md b/monitoring/README.md
index ba8ac49..4982f85 100644
--- a/monitoring/README.md
+++ b/monitoring/README.md
@@ -120,7 +120,15 @@ tools/seed_observability_demo.py --days 7` (marked `source='demo'`).
 
 The same data is also available inside the ERP itself (admin-only, Persian
 RTL): **/bot-monitor** — served by `GET /api/v1/bot-metrics/*`
-(`backend/app/routers/bot_metrics.py`).
+(`backend/app/routers/bot_metrics.py`). The page is tabbed: نمای کلی
+(overview) / **مدل‌ها** (a record per model — Jev, DeepSeek-NLU, DeepSeek
+arbiter, DeepSeek crisis fallback, every STT provider, audio-enhancer — with
+per-model daily charts) / **بخش‌ها** (pipeline stages grouped by section) /
+**پیام‌ها** (message records with inline voice playback, download and every
+STT transcript side-by-side; media is streamed from the bot's MinIO bucket
+`bot-media` with the on-disk archive as fallback, via short-lived signed
+URLs). Grafana's bot-observability dashboard carries a matching
+«کارکرد مدل‌ها» table.
 
 ## Alerting
 
diff --git a/monitoring/grafana/dashboards/bot-observability.json b/monitoring/grafana/dashboards/bot-observability.json
index c65693f..db628a8 100644
--- a/monitoring/grafana/dashboards/bot-observability.json
+++ b/monitoring/grafana/dashboards/bot-observability.json
@@ -1,144 +1,662 @@
 {
-  "annotations": { "list": [] },
+  "annotations": {
+    "list": []
+  },
   "editable": true,
   "graphTooltip": 1,
   "refresh": "5m",
   "schemaVersion": 41,
-  "tags": ["erp", "bot"],
-  "time": { "from": "now-7d", "to": "now" },
+  "tags": [
+    "erp",
+    "bot"
+  ],
+  "time": {
+    "from": "now-7d",
+    "to": "now"
+  },
   "timezone": "browser",
   "title": "بات — Observability خط لوله",
   "uid": "bot-observability",
   "version": 1,
   "panels": [
-    { "type": "row", "title": "نمای کلی", "gridPos": { "h": 1, "w": 24, "x": 0, "y": 0 }, "id": 100 },
     {
-      "type": "stat", "title": "روندها (ترافیک واقعی)", "id": 1,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 4, "w": 4, "x": 0, "y": 1 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT count(*) AS value FROM bot_traces WHERE coalesce(source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(created_at)" }],
-      "fieldConfig": { "defaults": { "color": { "mode": "thresholds" }, "thresholds": { "steps": [ { "color": "green", "value": null } ] } }, "overrides": [] }
+      "type": "row",
+      "title": "نمای کلی",
+      "gridPos": {
+        "h": 1,
+        "w": 24,
+        "x": 0,
+        "y": 0
+      },
+      "id": 100
     },
     {
-      "type": "stat", "title": "رخدادها", "id": 2,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 4, "w": 4, "x": 4, "y": 1 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT count(*) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at)" }]
+      "type": "stat",
+      "title": "روندها (ترافیک واقعی)",
+      "id": 1,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 4,
+        "w": 4,
+        "x": 0,
+        "y": 1
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT count(*) AS value FROM bot_traces WHERE coalesce(source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(created_at)"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "color": {
+            "mode": "thresholds"
+          },
+          "thresholds": {
+            "steps": [
+              {
+                "color": "green",
+                "value": null
+              }
+            ]
+          }
+        },
+        "overrides": []
+      }
     },
     {
-      "type": "stat", "title": "خطای Jev / فالبک", "id": 3,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 4, "w": 4, "x": 8, "y": 1 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT count(*) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE (e.stage='jev.failure' OR (e.stage='jev.result' AND NOT e.ok) OR e.stage LIKE 'matching.%.failure') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at)" }],
-      "fieldConfig": { "defaults": { "color": { "mode": "thresholds" }, "thresholds": { "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 1 } ] } }, "overrides": [] }
+      "type": "stat",
+      "title": "رخدادها",
+      "id": 2,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 4,
+        "w": 4,
+        "x": 4,
+        "y": 1
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT count(*) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at)"
+        }
+      ]
     },
     {
-      "type": "stat", "title": "p95 تأخیر Jev (ms)", "id": 4,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 4, "w": 4, "x": 12, "y": 1 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY e.latency_ms)),0) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='jev.result' AND e.latency_ms IS NOT NULL AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at)" }],
-      "fieldConfig": { "defaults": { "unit": "ms" }, "overrides": [] }
+      "type": "stat",
+      "title": "خطای Jev / فالبک",
+      "id": 3,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 4,
+        "w": 4,
+        "x": 8,
+        "y": 1
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT count(*) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE (e.stage='jev.failure' OR (e.stage='jev.result' AND NOT e.ok) OR e.stage LIKE 'matching.%.failure') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at)"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "color": {
+            "mode": "thresholds"
+          },
+          "thresholds": {
+            "steps": [
+              {
+                "color": "green",
+                "value": null
+              },
+              {
+                "color": "red",
+                "value": 1
+              }
+            ]
+          }
+        },
+        "overrides": []
+      }
     },
     {
-      "type": "stat", "title": "ثبت نهایی پیش‌نویس", "id": 5,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 4, "w": 4, "x": 16, "y": 1 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT count(*) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='draft.commit' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at)" }]
+      "type": "stat",
+      "title": "p95 تأخیر Jev (ms)",
+      "id": 4,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 4,
+        "w": 4,
+        "x": 12,
+        "y": 1
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY e.latency_ms)),0) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='jev.result' AND e.latency_ms IS NOT NULL AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at)"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "unit": "ms"
+        },
+        "overrides": []
+      }
     },
     {
-      "type": "stat", "title": "رخداد این ماه (گارد آرشیو ۱۰۰k)", "id": 6,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 4, "w": 4, "x": 20, "y": 1 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT count(*) AS value FROM bot_trace_events WHERE created_at >= date_trunc('month', now())" }],
-      "fieldConfig": { "defaults": { "color": { "mode": "thresholds" }, "thresholds": { "steps": [ { "color": "green", "value": null }, { "color": "orange", "value": 50000 }, { "color": "red", "value": 100000 } ] } }, "overrides": [] }
-    },
-
-    { "type": "row", "title": "حجم و تأخیر", "gridPos": { "h": 1, "w": 24, "x": 0, "y": 5 }, "id": 101 },
-    {
-      "type": "timeseries", "title": "رخداد در روز (ترافیک واقعی)", "id": 10,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 8, "w": 12, "x": 0, "y": 6 },
-      "targets": [{ "refId": "A", "format": "time_series", "rawSql": "SELECT $__timeGroupAlias(e.created_at,'1d'), count(*) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 ORDER BY 1" }],
-      "fieldConfig": { "defaults": { "custom": { "drawStyle": "bars", "fillOpacity": 60, "lineWidth": 1 } }, "overrides": [] }
+      "type": "stat",
+      "title": "ثبت نهایی پیش‌نویس",
+      "id": 5,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 4,
+        "w": 4,
+        "x": 16,
+        "y": 1
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT count(*) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='draft.commit' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at)"
+        }
+      ]
     },
     {
-      "type": "timeseries", "title": "تأخیر p50/p95 به تفکیک مرحله", "id": 11,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 8, "w": 12, "x": 12, "y": 6 },
-      "targets": [{ "refId": "A", "format": "time_series", "rawSql": "SELECT $__timeGroupAlias(e.created_at,'1h'), round(percentile_cont(0.5) WITHIN GROUP (ORDER BY e.latency_ms)) AS p50, round(percentile_cont(0.95) WITHIN GROUP (ORDER BY e.latency_ms)) AS p95, e.stage AS metric FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('jev.result','nlu.result','stt.result','audio.enhance.result','matching.arbitration.result') AND e.latency_ms IS NOT NULL AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1, e.stage ORDER BY 1" }],
-      "fieldConfig": { "defaults": { "unit": "ms" }, "overrides": [] }
-    },
-
-    { "type": "row", "title": "تطبیق موجودیت (Jev + داور DeepSeek)", "gridPos": { "h": 1, "w": 24, "x": 0, "y": 14 }, "id": 102 },
-    {
-      "type": "piechart", "title": "وضعیت نهایی mentionها (exact/ambiguity/new)", "id": 20,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 8, "w": 8, "x": 0, "y": 15 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT 'exact' AS metric, sum(coalesce((e.payload->'statuses'->>'exact')::int,0)) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('matching.arbitration.result','matching.fallback.result') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) UNION ALL SELECT 'ambiguity', sum(coalesce((e.payload->'statuses'->>'ambiguity')::int,0)) FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('matching.arbitration.result','matching.fallback.result') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) UNION ALL SELECT 'new', sum(coalesce((e.payload->'statuses'->>'new')::int,0)) FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('matching.arbitration.result','matching.fallback.result') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) UNION ALL SELECT m->>'status', count(*) FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id, jsonb_array_elements(e.payload->'mentions') m WHERE e.stage='routing.decision' AND e.payload->>'source'='jev' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1" }],
-      "fieldConfig": { "defaults": {}, "overrides": [] },
-      "options": { "pieType": "donut", "legend": { "displayMode": "table", "placement": "right" } }
+      "type": "stat",
+      "title": "رخداد این ماه (گارد آرشیو ۱۰۰k)",
+      "id": 6,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 4,
+        "w": 4,
+        "x": 20,
+        "y": 1
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT count(*) AS value FROM bot_trace_events WHERE created_at >= date_trunc('month', now())"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "color": {
+            "mode": "thresholds"
+          },
+          "thresholds": {
+            "steps": [
+              {
+                "color": "green",
+                "value": null
+              },
+              {
+                "color": "orange",
+                "value": 50000
+              },
+              {
+                "color": "red",
+                "value": 100000
+              }
+            ]
+          }
+        },
+        "overrides": []
+      }
     },
     {
-      "type": "table", "title": "اقدامات داور DeepSeek روی پیشنهاد Jev", "id": 21,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 8, "w": 8, "x": 8, "y": 15 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT coalesce(e.payload->'actions'->>'endorsed_jev','0')::int AS \"تأیید Jev\", coalesce(e.payload->'actions'->>'vetoed_to_new','0')::int AS \"وتو → جدید\", coalesce(e.payload->'actions'->>'demoted_to_ambiguity','0')::int AS \"تنزل → ابهام\", coalesce(e.payload->'actions'->>'other','0')::int AS \"سایر\", count(*) OVER () AS \"فراخوانی‌ها\" FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='matching.arbitration.result' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at)" }],
-      "fieldConfig": { "defaults": {}, "overrides": [] }
+      "type": "row",
+      "title": "حجم و تأخیر",
+      "gridPos": {
+        "h": 1,
+        "w": 24,
+        "x": 0,
+        "y": 5
+      },
+      "id": 101
     },
     {
-      "type": "timeseries", "title": "توکن مصرفی در زمان (ورودی/خروجی)", "id": 22,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 8, "w": 8, "x": 16, "y": 15 },
-      "targets": [{ "refId": "A", "format": "time_series", "rawSql": "SELECT $__timeGroupAlias(e.created_at,'1d'), sum(coalesce((e.payload->'usage'->>'input_tokens')::bigint,0)) AS input, sum(coalesce((e.payload->'usage'->>'output_tokens')::bigint,0)) AS output FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('jev.result','matching.arbitration.result','matching.fallback.result') AND e.payload->'usage' IS NOT NULL AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 ORDER BY 1" }],
-      "fieldConfig": { "defaults": { "custom": { "drawStyle": "bars", "fillOpacity": 50 } }, "overrides": [] }
+      "type": "timeseries",
+      "title": "رخداد در روز (ترافیک واقعی)",
+      "id": 10,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 8,
+        "w": 12,
+        "x": 0,
+        "y": 6
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "time_series",
+          "rawSql": "SELECT $__timeGroupAlias(e.created_at,'1d'), count(*) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 ORDER BY 1"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "custom": {
+            "drawStyle": "bars",
+            "fillOpacity": 60,
+            "lineWidth": 1
+          }
+        },
+        "overrides": []
+      }
     },
     {
-      "type": "table", "title": "نسخه مدل Jev دیده‌شده (پین: jev-1.13.0)", "id": 23,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 6, "w": 8, "x": 0, "y": 23 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT coalesce(e.model,'?') AS \"مدل\", count(*) AS \"تعداد\", max(e.created_at)::text AS \"آخرین بار\" FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='jev.result' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 ORDER BY 2 DESC" }]
+      "type": "timeseries",
+      "title": "تأخیر p50/p95 به تفکیک مرحله",
+      "id": 11,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 8,
+        "w": 12,
+        "x": 12,
+        "y": 6
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "time_series",
+          "rawSql": "SELECT $__timeGroupAlias(e.created_at,'1h'), round(percentile_cont(0.5) WITHIN GROUP (ORDER BY e.latency_ms)) AS p50, round(percentile_cont(0.95) WITHIN GROUP (ORDER BY e.latency_ms)) AS p95, e.stage AS metric FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('jev.result','nlu.result','stt.result','audio.enhance.result','matching.arbitration.result') AND e.latency_ms IS NOT NULL AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1, e.stage ORDER BY 1"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "unit": "ms"
+        },
+        "overrides": []
+      }
     },
     {
-      "type": "timeseries", "title": "فراخوانی مراحل تطبیق (Jev/داور/فالبک)", "id": 24,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 6, "w": 8, "x": 8, "y": 23 },
-      "targets": [{ "refId": "A", "format": "time_series", "rawSql": "SELECT $__timeGroupAlias(e.created_at,'1d'), count(*) AS value, e.stage AS metric FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('jev.request','matching.arbitration.result','matching.fallback.result') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1, e.stage ORDER BY 1" }],
-      "fieldConfig": { "defaults": { "custom": { "drawStyle": "bars", "fillOpacity": 40, "stacking": { "mode": "normal" } } }, "overrides": [] }
+      "type": "row",
+      "title": "تطبیق موجودیت (Jev + داور DeepSeek)",
+      "gridPos": {
+        "h": 1,
+        "w": 24,
+        "x": 0,
+        "y": 14
+      },
+      "id": 102
     },
     {
-      "type": "stat", "title": "حجم Observability (گارد آرشیو ۵GB)", "id": 25,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 6, "w": 8, "x": 16, "y": 23 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT (pg_total_relation_size('bot_trace_events') + pg_total_relation_size('bot_traces')) AS value" }],
-      "fieldConfig": { "defaults": { "unit": "bytes", "color": { "mode": "thresholds" }, "thresholds": { "steps": [ { "color": "green", "value": null }, { "color": "orange", "value": 3000000000 }, { "color": "red", "value": 5000000000 } ] } }, "overrides": [] }
-    },
-
-    { "type": "row", "title": "کیفیت و ورودی", "gridPos": { "h": 1, "w": 24, "x": 0, "y": 29 }, "id": 103 },
-    {
-      "type": "table", "title": "انتخاب کاربر (A/B واقعی)", "id": 30,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 8, "w": 8, "x": 0, "y": 30 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT payload->>'action' AS \"اقدام\", coalesce(payload->>'arg','-') AS \"آرگومان\", count(*) AS \"تعداد\" FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='ambiguity.user_choice' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1,2 UNION ALL SELECT CASE WHEN (payload->>'idx')::int = 0 THEN 'انتخاب: گزینه اول (پیشنهاد مدل)' ELSE 'انتخاب: گزینه غیراول' END, '-', count(*) FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='user_choice.pick' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1" }]
+      "type": "piechart",
+      "title": "وضعیت نهایی mentionها (exact/ambiguity/new)",
+      "id": 20,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 8,
+        "w": 8,
+        "x": 0,
+        "y": 15
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT 'exact' AS metric, sum(coalesce((e.payload->'statuses'->>'exact')::int,0)) AS value FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('matching.arbitration.result','matching.fallback.result') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) UNION ALL SELECT 'ambiguity', sum(coalesce((e.payload->'statuses'->>'ambiguity')::int,0)) FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('matching.arbitration.result','matching.fallback.result') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) UNION ALL SELECT 'new', sum(coalesce((e.payload->'statuses'->>'new')::int,0)) FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('matching.arbitration.result','matching.fallback.result') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) UNION ALL SELECT m->>'status', count(*) FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id, jsonb_array_elements(e.payload->'mentions') m WHERE e.stage='routing.decision' AND e.payload->>'source'='jev' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {},
+        "overrides": []
+      },
+      "options": {
+        "pieType": "donut",
+        "legend": {
+          "displayMode": "table",
+          "placement": "right"
+        }
+      }
     },
     {
-      "type": "table", "title": "سلامت STT به تفکیک پرووایدر", "id": 31,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 8, "w": 8, "x": 8, "y": 30 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT coalesce(e.payload->>'provider','?') AS \"پرووایدر\", count(*) FILTER (WHERE e.ok) AS \"موفق\", count(*) AS \"کل\", round(100.0*count(*) FILTER (WHERE e.ok)/greatest(count(*),1),1)::text || '%' AS \"نرخ موفقیت\", coalesce(round(percentile_cont(0.5) WITHIN GROUP (ORDER BY e.latency_ms))::text,'—') AS \"p50 (ms)\" FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='stt.result' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 ORDER BY 2 DESC" }]
+      "type": "table",
+      "title": "اقدامات داور DeepSeek روی پیشنهاد Jev",
+      "id": 21,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 8,
+        "w": 8,
+        "x": 8,
+        "y": 15
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT coalesce(e.payload->'actions'->>'endorsed_jev','0')::int AS \"تأیید Jev\", coalesce(e.payload->'actions'->>'vetoed_to_new','0')::int AS \"وتو → جدید\", coalesce(e.payload->'actions'->>'demoted_to_ambiguity','0')::int AS \"تنزل → ابهام\", coalesce(e.payload->'actions'->>'other','0')::int AS \"سایر\", count(*) OVER () AS \"فراخوانی‌ها\" FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='matching.arbitration.result' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at)"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {},
+        "overrides": []
+      }
     },
     {
-      "type": "timeseries", "title": "پیش‌پردازش صدا (audio.enhance)", "id": 32,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 8, "w": 8, "x": 16, "y": 30 },
-      "targets": [{ "refId": "A", "format": "time_series", "rawSql": "SELECT $__timeGroupAlias(e.created_at,'1d'), count(*) FILTER (WHERE e.ok) AS value, 'موفق' AS metric FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='audio.enhance.result' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 UNION ALL SELECT $__timeGroupAlias(e.created_at,'1d'), count(*) FILTER (WHERE NOT e.ok), 'ناموفق (بازگشت به صدای خام)' FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='audio.enhance.result' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1" }],
-      "fieldConfig": { "defaults": { "custom": { "drawStyle": "bars", "fillOpacity": 50, "stacking": { "mode": "normal" } } }, "overrides": [] }
+      "type": "timeseries",
+      "title": "توکن مصرفی در زمان (ورودی/خروجی)",
+      "id": 22,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 8,
+        "w": 8,
+        "x": 16,
+        "y": 15
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "time_series",
+          "rawSql": "SELECT $__timeGroupAlias(e.created_at,'1d'), sum(coalesce((e.payload->'usage'->>'input_tokens')::bigint,0)) AS input, sum(coalesce((e.payload->'usage'->>'output_tokens')::bigint,0)) AS output FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('jev.result','matching.arbitration.result','matching.fallback.result') AND e.payload->'usage' IS NOT NULL AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 ORDER BY 1"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "custom": {
+            "drawStyle": "bars",
+            "fillOpacity": 50
+          }
+        },
+        "overrides": []
+      }
     },
     {
-      "type": "table", "title": "چرخه‌ی پیش‌نویس", "id": 33,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 5, "w": 24, "x": 0, "y": 38 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT e.stage AS \"مرحله\", count(*) AS \"تعداد\" FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('draft.render','draft.commit','draft.cancel','ambiguity.sent') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 ORDER BY 2 DESC" }]
+      "type": "table",
+      "title": "نسخه مدل Jev دیده‌شده (پین: jev-1.13.0)",
+      "id": 23,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 6,
+        "w": 8,
+        "x": 0,
+        "y": 23
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT coalesce(e.model,'?') AS \"مدل\", count(*) AS \"تعداد\", max(e.created_at)::text AS \"آخرین بار\" FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='jev.result' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 ORDER BY 2 DESC"
+        }
+      ]
+    },
+    {
+      "type": "timeseries",
+      "title": "فراخوانی مراحل تطبیق (Jev/داور/فالبک)",
+      "id": 24,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 6,
+        "w": 8,
+        "x": 8,
+        "y": 23
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "time_series",
+          "rawSql": "SELECT $__timeGroupAlias(e.created_at,'1d'), count(*) AS value, e.stage AS metric FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('jev.request','matching.arbitration.result','matching.fallback.result') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1, e.stage ORDER BY 1"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "custom": {
+            "drawStyle": "bars",
+            "fillOpacity": 40,
+            "stacking": {
+              "mode": "normal"
+            }
+          }
+        },
+        "overrides": []
+      }
+    },
+    {
+      "type": "stat",
+      "title": "حجم Observability (گارد آرشیو ۵GB)",
+      "id": 25,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 6,
+        "w": 8,
+        "x": 16,
+        "y": 23
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT (pg_total_relation_size('bot_trace_events') + pg_total_relation_size('bot_traces')) AS value"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "unit": "bytes",
+          "color": {
+            "mode": "thresholds"
+          },
+          "thresholds": {
+            "steps": [
+              {
+                "color": "green",
+                "value": null
+              },
+              {
+                "color": "orange",
+                "value": 3000000000
+              },
+              {
+                "color": "red",
+                "value": 5000000000
+              }
+            ]
+          }
+        },
+        "overrides": []
+      }
+    },
+    {
+      "type": "row",
+      "title": "کیفیت و ورودی",
+      "gridPos": {
+        "h": 1,
+        "w": 24,
+        "x": 0,
+        "y": 29
+      },
+      "id": 103
+    },
+    {
+      "type": "table",
+      "title": "انتخاب کاربر (A/B واقعی)",
+      "id": 30,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 8,
+        "w": 8,
+        "x": 0,
+        "y": 30
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT payload->>'action' AS \"اقدام\", coalesce(payload->>'arg','-') AS \"آرگومان\", count(*) AS \"تعداد\" FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='ambiguity.user_choice' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1,2 UNION ALL SELECT CASE WHEN (payload->>'idx')::int = 0 THEN 'انتخاب: گزینه اول (پیشنهاد مدل)' ELSE 'انتخاب: گزینه غیراول' END, '-', count(*) FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='user_choice.pick' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1"
+        }
+      ]
+    },
+    {
+      "type": "table",
+      "title": "سلامت STT به تفکیک پرووایدر",
+      "id": 31,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 8,
+        "w": 8,
+        "x": 8,
+        "y": 30
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT coalesce(e.payload->>'provider','?') AS \"پرووایدر\", count(*) FILTER (WHERE e.ok) AS \"موفق\", count(*) AS \"کل\", round(100.0*count(*) FILTER (WHERE e.ok)/greatest(count(*),1),1)::text || '%' AS \"نرخ موفقیت\", coalesce(round(percentile_cont(0.5) WITHIN GROUP (ORDER BY e.latency_ms))::text,'—') AS \"p50 (ms)\" FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='stt.result' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 ORDER BY 2 DESC"
+        }
+      ]
+    },
+    {
+      "type": "timeseries",
+      "title": "پیش‌پردازش صدا (audio.enhance)",
+      "id": 32,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 8,
+        "w": 8,
+        "x": 16,
+        "y": 30
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "time_series",
+          "rawSql": "SELECT $__timeGroupAlias(e.created_at,'1d'), count(*) FILTER (WHERE e.ok) AS value, 'موفق' AS metric FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='audio.enhance.result' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 UNION ALL SELECT $__timeGroupAlias(e.created_at,'1d'), count(*) FILTER (WHERE NOT e.ok), 'ناموفق (بازگشت به صدای خام)' FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage='audio.enhance.result' AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "custom": {
+            "drawStyle": "bars",
+            "fillOpacity": 50,
+            "stacking": {
+              "mode": "normal"
+            }
+          }
+        },
+        "overrides": []
+      }
+    },
+    {
+      "type": "table",
+      "title": "چرخه‌ی پیش‌نویس",
+      "id": 33,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 5,
+        "w": 24,
+        "x": 0,
+        "y": 38
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT e.stage AS \"مرحله\", count(*) AS \"تعداد\" FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE e.stage IN ('draft.render','draft.commit','draft.cancel','ambiguity.sent') AND coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) GROUP BY 1 ORDER BY 2 DESC"
+        }
+      ]
+    },
+    {
+      "type": "row",
+      "title": "کارکرد مدل‌ها",
+      "gridPos": {
+        "h": 1,
+        "w": 24,
+        "x": 0,
+        "y": 45
+      },
+      "id": 110
+    },
+    {
+      "type": "table",
+      "title": "رکورد عملکرد مدل‌ها (فراخوانی/موفق/p95/توکن)",
+      "id": 111,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 9,
+        "w": 24,
+        "x": 0,
+        "y": 46
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT 'Jev (تطبیق)' AS metric, count(*)::int AS value0, count(*) FILTER (WHERE e.ok)::int AS ok, coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY coalesce(e.latency_ms, nullif(e.payload->>'latency_ms','')::int))),0)::int AS p95, coalesce(sum((e.payload->'usage'->>'input_tokens')::bigint),0)::bigint AS tin, coalesce(sum((e.payload->'usage'->>'output_tokens')::bigint),0)::bigint AS tout FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) AND e.stage = 'jev.result' UNION ALL SELECT 'داور DeepSeek' AS metric, count(*)::int AS value0, count(*) FILTER (WHERE e.ok)::int AS ok, coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY coalesce(e.latency_ms, nullif(e.payload->>'latency_ms','')::int))),0)::int AS p95, coalesce(sum((e.payload->'usage'->>'input_tokens')::bigint),0)::bigint AS tin, coalesce(sum((e.payload->'usage'->>'output_tokens')::bigint),0)::bigint AS tout FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) AND e.stage = 'matching.arbitration.result' UNION ALL SELECT 'فالبک DeepSeek' AS metric, count(*)::int AS value0, count(*) FILTER (WHERE e.ok)::int AS ok, coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY coalesce(e.latency_ms, nullif(e.payload->>'latency_ms','')::int))),0)::int AS p95, coalesce(sum((e.payload->'usage'->>'input_tokens')::bigint),0)::bigint AS tin, coalesce(sum((e.payload->'usage'->>'output_tokens')::bigint),0)::bigint AS tout FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) AND e.stage = 'matching.fallback.result' UNION ALL SELECT 'NLU (DeepSeek)' AS metric, count(*)::int AS value0, count(*) FILTER (WHERE e.ok)::int AS ok, coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY coalesce(e.latency_ms, nullif(e.payload->>'latency_ms','')::int))),0)::int AS p95, coalesce(sum((e.payload->'usage'->>'input_tokens')::bigint),0)::bigint AS tin, coalesce(sum((e.payload->'usage'->>'output_tokens')::bigint),0)::bigint AS tout FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) AND e.stage = 'nlu.result' UNION ALL SELECT 'پیش‌پردازش صدا' AS metric, count(*)::int AS value0, count(*) FILTER (WHERE e.ok)::int AS ok, coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY coalesce(e.latency_ms, nullif(e.payload->>'latency_ms','')::int))),0)::int AS p95, coalesce(sum((e.payload->'usage'->>'input_tokens')::bigint),0)::bigint AS tin, coalesce(sum((e.payload->'usage'->>'output_tokens')::bigint),0)::bigint AS tout FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) AND e.stage = 'audio.enhance.result' UNION ALL SELECT coalesce(e.model, e.payload->>'provider','stt') || ' (STT)' AS metric, count(*)::int, count(*) FILTER (WHERE e.ok)::int, coalesce(round(percentile_cont(0.95) WITHIN GROUP (ORDER BY coalesce(e.latency_ms, nullif(e.payload->>'latency_ms','')::int))),0)::int, 0::bigint, 0::bigint FROM bot_trace_events e JOIN bot_traces t ON e.trace_id=t.id WHERE coalesce(t.source,'bale') NOT IN ('calibration','demo') AND $__timeFilter(e.created_at) AND e.stage='stt.result' GROUP BY 1 ORDER BY 2 DESC"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "custom": {
+            "align": "auto"
+          }
+        },
+        "overrides": []
+      }
     }
   ],
-  "templating": { "list": [] }
-}
+  "templating": {
+    "list": []
+  }
+}
\ No newline at end of file
diff --git a/monitoring/grafana/dashboards/bot-trace-explorer.json b/monitoring/grafana/dashboards/bot-trace-explorer.json
index 3c7ba98..40a0b6b 100644
--- a/monitoring/grafana/dashboards/bot-trace-explorer.json
+++ b/monitoring/grafana/dashboards/bot-trace-explorer.json
@@ -1,29 +1,86 @@
 {
-  "annotations": { "list": [] },
+  "annotations": {
+    "list": []
+  },
   "editable": true,
   "graphTooltip": 1,
   "refresh": "30s",
   "schemaVersion": 41,
-  "tags": ["erp", "bot"],
-  "time": { "from": "now-24h", "to": "now" },
+  "tags": [
+    "erp",
+    "bot"
+  ],
+  "time": {
+    "from": "now-24h",
+    "to": "now"
+  },
   "timezone": "browser",
   "title": "بات — اکسپلورر ترس‌ها",
   "uid": "bot-trace-explorer",
   "version": 1,
   "panels": [
     {
-      "type": "table", "title": "آخرین ترس‌ها", "id": 1,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 12, "w": 24, "x": 0, "y": 0 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT t.id::text AS \"trace_id\", t.created_at AS \"زمان\", coalesce(t.source,'bale') AS \"منبع\", t.chat_id AS \"چت\", t.kind AS \"نوع\", coalesce(t.status,'—') AS \"وضعیت\", (SELECT count(*) FROM bot_trace_events e WHERE e.trace_id=t.id) AS \"رخدادها\" FROM bot_traces t WHERE ($trace_id = '' OR t.id::text = $trace_id) AND $__timeFilter(t.created_at) ORDER BY t.created_at DESC LIMIT 100" }],
-      "fieldConfig": { "defaults": { "custom": { "align": "auto" } }, "overrides": [] }
+      "type": "table",
+      "title": "آخرین ترس‌ها",
+      "id": 1,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 12,
+        "w": 24,
+        "x": 0,
+        "y": 0
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT t.id::text AS \"trace_id\", t.created_at AS \"زمان\", coalesce(t.source,'bale') AS \"منبع\", t.chat_id AS \"چت\", t.kind AS \"نوع\", coalesce(t.status,'—') AS \"وضعیت\", (SELECT count(*) FROM bot_trace_events e WHERE e.trace_id=t.id) AS \"رخدادها\", , left(coalesce((SELECT e2.payload->>'consensus_text' FROM bot_trace_events e2 WHERE e2.trace_id=t.id AND e2.stage='nlu.result' LIMIT 1), (SELECT e2.payload->>'text' FROM bot_trace_events e2 WHERE e2.trace_id=t.id AND e2.stage='input.text' LIMIT 1), ''), 90) AS \"متن/گزیده\"\n        FROM bot_traces t WHERE ($trace_id = '' OR t.id::text = $trace_id) AND $__timeFilter(t.created_at) ORDER BY t.created_at DESC LIMIT 100"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "custom": {
+            "align": "auto"
+          }
+        },
+        "overrides": []
+      }
     },
     {
-      "type": "table", "title": "رویدادهای ترس انتخاب‌شده (به ترتیب زمان)", "id": 2,
-      "datasource": { "type": "postgres", "uid": "bot-postgres" },
-      "gridPos": { "h": 14, "w": 24, "x": 0, "y": 12 },
-      "targets": [{ "refId": "A", "format": "table", "rawSql": "SELECT e.created_at AS \"زمان\", e.stage AS \"مرحله\", e.ok AS \"ok\", coalesce(e.latency_ms::text,'—') AS \"تأخیر (ms)\", coalesce(e.model,'—') AS \"مدل\", coalesce(e.field,'—') AS \"فیلد\", left(e.payload::text, 700) AS \"payload\" FROM bot_trace_events e WHERE e.trace_id::text = $trace_id ORDER BY e.created_at ASC LIMIT 500" }],
-      "fieldConfig": { "defaults": { "custom": { "align": "auto", "cellOptions": { "type": "text" } } }, "overrides": [] }
+      "type": "table",
+      "title": "رویدادهای ترس انتخاب‌شده (به ترتیب زمان)",
+      "id": 2,
+      "datasource": {
+        "type": "postgres",
+        "uid": "bot-postgres"
+      },
+      "gridPos": {
+        "h": 14,
+        "w": 24,
+        "x": 0,
+        "y": 12
+      },
+      "targets": [
+        {
+          "refId": "A",
+          "format": "table",
+          "rawSql": "SELECT e.created_at AS \"زمان\", e.stage AS \"مرحله\", e.ok AS \"ok\", coalesce(e.latency_ms::text,'—') AS \"تأخیر (ms)\", coalesce(e.model,'—') AS \"مدل\", coalesce(e.field,'—') AS \"فیلد\", left(e.payload::text, 700) AS \"payload\" FROM bot_trace_events e WHERE e.trace_id::text = $trace_id ORDER BY e.created_at ASC LIMIT 500"
+        }
+      ],
+      "fieldConfig": {
+        "defaults": {
+          "custom": {
+            "align": "auto",
+            "cellOptions": {
+              "type": "text"
+            }
+          }
+        },
+        "overrides": []
+      }
     }
   ],
   "templating": {
@@ -33,11 +90,15 @@
         "label": "شناسه ترس",
         "type": "textbox",
         "hide": 0,
-        "current": { "selected": false, "text": "", "value": "" },
+        "current": {
+          "selected": false,
+          "text": "",
+          "value": ""
+        },
         "options": [],
         "query": "",
         "description": "trace_id را از جدول بالا کپی و اینجا بچسبانید"
       }
     ]
   }
-}
+}
\ No newline at end of file