讓所有 AI 呼叫都走同一道門，讓不可信的檔案只在隔離室裡拆

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
flowchart LR
  FE["前端"] --> API["guidant-api<br/>（API 行程）"]
  subgraph API_IN["API 行程內"]
    BOT["小幫手<br/>直接 Anthropic SDK"]
    DASH["儀表板<br/>三支 AI client"]
    BATCH["分類批次<br/>開執行緒等結果"]
  end
  API --> BOT
  API --> DASH
  API --> BATCH
  BATCH -- "檔案＋金鑰＋token" --> CLS["guidant-classifier 容器<br/>拆檔＋打 AI＋寫狀態"]
  BOT --> EXT["外部 AI 供應商"]
  DASH --> EXT
  CLS --> EXT
  DASH -. "prompt 明文" .-> LOG["app.log"]

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
flowchart LR
  FE["前端<br/>AI 聲明＋「AI 建議」標記【自寫】"] --> API["guidant-api"]
  API --> BOT["小幫手"]
  API --> DASH["儀表板"]
  API -- "建工作單、回 202" --> Q[("background_jobs<br/>工作佇列表")]
  subgraph WK["guidant-worker（同 BE image，RUN_MODE=worker）"]
    H["分類 handler【自寫】"]
  end
  Q --> H
  H -- "POST /v1/extract" --> SB1
  subgraph SB["ai-sandbox 容器：無金鑰、無 DB、不出網"]
    SB1["拆檔【pypdf／LibreOffice】"]
    SB2["藏字掃描【自寫】"]
    SB3["注入判讀【Prompt Guard 2】"]
    SB1 --> SB2 --> SB3
  end
  SB3 -- "內容塊＋藏字旗標" --> H
  subgraph GW["jedi-ai-gateway 套件（api 與 worker 行程內載入）"]
    direction TB
    G1["① 入口守門<br/>機敏【Presidio】＋注入【Prompt Guard 2】"]
    G2["② 提示強化【自寫 Segment 契約】"]
    G3["③ 金鑰解析【自寫 IKeyResolver】"]
    G4["④ 供應商轉接【LiteLLM completion()】"]
    G5["⑤ 出口守門【pydantic】＋原文檢查【自寫】"]
    G6["⑥ 稽核【LiteLLM callback → 自寫落表】"]
    G7["⑦ 配額【自寫 ITenantPolicy】（第三階段）"]
    G1 --> G2 --> G3 --> G4 --> G5 --> G6 --> G7
  end
  BOT --> G1
  DASH --> G1
  H --> G1
  G4 --> EXT["外部 AI 供應商<br/>Anthropic／OpenAI／Google／Azure"]
  G4 --> OLL["客戶自架 Ollama"]
  G6 --> AL[("ai_call_log")]
  G6 -. "DEV only" .-> LF["Langfuse<br/>（只在 DEV，出貨不含）"]
  H -- "進度" --> SIO["guidant-socketio"] --> FE

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
sequenceDiagram
    participant FE as 前端
    participant API as guidant-api
    participant BOT as ai-bot 服務
    participant GW as ai-gateway
    participant AI as Anthropic
    participant R as Redis

    FE->>API: 送出問題
    API->>BOT: JWT 驗身分
    BOT->>BOT: 驗 session_id 格式
    BOT->>R: 讀對話歷史
    BOT->>GW: complete（instruction 角色鎖定 / data 歷史 / untrusted 使用者句）
    GW->>GW: ① Presidio 掃機敏→遮罩或擋下
    GW->>GW: ① Prompt Guard 2 判注入＋離題白名單
    GW->>GW: ② 提示強化：Segment 分開包裝、加分隔標記（自寫）
    GW->>GW: ③ 金鑰解析（IKeyResolver）
    GW->>AI: ④ LiteLLM completion()
    AI-->>GW: 回覆
    GW->>GW: ⑤ 出口守門：Presidio 再掃一次
    GW->>GW: ⑥ LiteLLM callback→ai_call_log（預設只存 hash）
    GW-->>BOT: 結果＋遮蔽處數
    BOT->>R: 寫回對話歷史
    BOT-->>FE: 純文字顯示＋AI 聲明

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
sequenceDiagram
    participant FE as 前端
    participant API as guidant-api
    participant D as ai-dashboard 服務
    participant GW as ai-gateway
    participant AI as AI 供應商

    FE->>API: 輸入想看的報表描述
    API->>D: 開始產生
    D->>GW: 階段 1 complete（instruction 選 API 規則 / data 可用查詢目錄 / untrusted prompt, schema）
    Note over GW: ① Presidio 掃機敏→遮罩<br/>Prompt Guard 2 判注入
    GW->>AI: ④ LiteLLM completion()
    AI-->>GW: 選定的查詢
    GW-->>D: ⑤ pydantic 驗 schema<br/>⑥ LiteLLM callback→ai_call_log
    D->>D: 階段 2 呼叫 BE 內部查詢（無參數）
    D->>D: 階段 3 統計
    D->>GW: 階段 4 complete（instruction 版面規則 / data 統計＋樣本 / untrusted prompt, schema）
    Note over GW: ① Presidio＋Prompt Guard 2
    GW->>AI: ④ LiteLLM completion()
    AI-->>GW: 版面設計
    GW-->>D: ⑤ pydantic 驗 schema<br/>⑥ LiteLLM callback→ai_call_log
    D->>D: 階段 5 組 JSON
    D-->>FE: 顯示儀表板＋AI 聲明
    Note over D,GW: prompt 只記 hash；刪掉套件內兩處 logger 明文

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
sequenceDiagram
    participant FE as 前端
    participant API as guidant-api
    participant Q as 工作佇列表
    participant W as worker
    participant SB as ai-sandbox
    participant GW as ai-gateway
    participant AI as AI 供應商
    participant SIO as socketio

    FE->>API: 送出分類批次
    API->>Q: 建工作單
    API-->>FE: 202 已受理
    W->>Q: 撿工作單
    W->>W: 從儲存後端取檔
    W->>SB: POST /v1/extract
    Note over SB: pypdf／LibreOffice 拆檔<br/>自寫藏字掃描＋Prompt Guard 2 判注入
    SB-->>W: 內容塊＋藏字旗標
    alt 藏字或注入旗標命中
        W->>W: 標「待人審」，不送 AI
    else 正常
        W->>GW: complete（instruction 分類規則＋內容非指令 / data catalog / untrusted 內容塊, schema）
        Note over GW: ① Presidio 只標記不遮罩（分類規則集）<br/>② Segment 分開包裝
        GW->>AI: ④ LiteLLM completion()
        AI-->>GW: 分類結果
        GW->>GW: ⑤ pydantic 驗 schema、part_id 回對、reasoning 去原文（自寫）
        GW->>GW: ⑥ LiteLLM callback→ai_call_log
        GW-->>W: 結果
    end
    W->>W: 寫 DB
    W->>SIO: 推進度
    SIO-->>FE: 更新進度
    W->>W: 清工作目錄
    FE->>FE: 結果標「AI 建議」

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
flowchart LR
  B1["棒 1<br/>worker 最小版"] --> B5["棒 5<br/>沙箱＋分類改走閘道"]
  B2["棒 2<br/>閘道骨架"] --> B3["棒 3<br/>小幫手"]
  B2 --> B4["棒 4<br/>儀表板"]
  B2 --> B5
  B3 --> B6["棒 6<br/>前端揭露"]
  B4 --> B6
  B5 --> B6