%% Use Case 圖 — 離線 AI Agent 系統
%% 描述使用者與系統的互動關係

graph TB
    subgraph Actors
        Engineer["👤 研發工程師"]
        Admin["👤 系統管理員"]
        Integrator["👤 整合人員"]
        KM["📁 KM 系統"]
    end

    subgraph UC_DocMgmt["文件管理"]
        UC1["📄 批次上傳文件<br/>(PDF/圖片/ZIP)"]
        UC2["📊 查詢上傳進度"]
        UC3["📥 下載原始文件"]
        UC4["🔄 從 KM 系統匯入"]
    end

    subgraph UC_RAG["RAG 對話"]
        UC5["💬 發起 RAG 查詢"]
        UC6["🔍 檢視引用來源"]
        UC7["📜 查看對話歷史"]
        UC8["🖼️ 多模態查詢<br/>(含圖片)"]
    end

    subgraph UC_Skill["MCP / Skills"]
        UC9["🔧 執行 MCP 工具"]
        UC10["📋 查看可用 Skills"]
    end

    subgraph UC_Admin["系統管理"]
        UC11["👥 使用者管理"]
        UC12["🔑 API Token 管理"]
        UC13["📝 查看審計日誌"]
        UC14["⚙️ 系統健康檢查"]
        UC15["💾 資料備份"]
    end

    subgraph UC_Internal["系統內部處理"]
        UC16["📝 PDF 文字抽取"]
        UC17["🔠 OCR 掃描辨識"]
        UC18["✂️ 文本切片 Chunking"]
        UC19["🧮 Embedding 生成"]
        UC20["🗄️ 向量寫入 pgvector"]
        UC21["🔎 向量相似搜尋"]
        UC22["📊 Reranking"]
        UC23["🧠 LLM 推理"]
        UC24["📏 Context 管理"]
        UC25["✅ 答案驗證"]
    end

    %% 研發工程師的互動
    Engineer --> UC1
    Engineer --> UC2
    Engineer --> UC3
    Engineer --> UC5
    Engineer --> UC6
    Engineer --> UC7
    Engineer --> UC8

    %% 系統管理員的互動
    Admin --> UC11
    Admin --> UC12
    Admin --> UC13
    Admin --> UC14
    Admin --> UC15
    Admin --> UC1

    %% 整合人員的互動
    Integrator --> UC5
    Integrator --> UC1
    Integrator --> UC10

    %% KM 系統的互動
    KM --> UC4

    %% Include 關係
    UC1 -.->|include| UC16
    UC1 -.->|include| UC18
    UC1 -.->|include| UC19
    UC1 -.->|include| UC20
    UC16 -.->|extend| UC17
    UC5 -.->|include| UC19
    UC5 -.->|include| UC21
    UC5 -.->|include| UC23
    UC5 -.->|include| UC24
    UC5 -.->|extend| UC9
    UC5 -.->|extend| UC22
    UC5 -.->|extend| UC25
    UC4 -.->|include| UC1

    %% 樣式
    classDef actor fill:#E8F5E9,stroke:#4CAF50,stroke-width:2px
    classDef usecase fill:#E3F2FD,stroke:#2196F3,stroke-width:1px
    classDef internal fill:#FFF3E0,stroke:#FF9800,stroke-width:1px
    classDef admin fill:#FCE4EC,stroke:#E91E63,stroke-width:1px

    class Engineer,Admin,Integrator,KM actor
    class UC1,UC2,UC3,UC4,UC5,UC6,UC7,UC8 usecase
    class UC9,UC10 usecase
    class UC11,UC12,UC13,UC14,UC15 admin
    class UC16,UC17,UC18,UC19,UC20,UC21,UC22,UC23,UC24,UC25 internal