%% 機構設計整合部 AI Agent 系統 - Use Case Diagram
%% 渲染工具：https://mermaid.live / VS Code Mermaid Preview

flowchart LR
    %% ===== Actors =====
    RD(["👤 研發同仁(R&D Engineer)"])
    ADMIN(["👑 系統管理員(Admin)"])
    ENG(["🔧 整合部工程師(Integration Engineer)"])

    %% ===== System Boundary =====
    subgraph SYS ["🖥️ 機構設計 AI Agent 系統"]
        direction TB

        subgraph CHAT_UC ["💬 對話功能"]
            UC1(["自然語言問答"])
            UC2(["多輪上下文對話"])
            UC3(["上傳圖片詢問(多模態輸入)"])
            UC4(["查詢 CAD 指令& 快捷鍵"])
            UC5(["引用文件來源顯示回答依據"])
        end

        subgraph DOC_UC ["📄 文件管理"]
            UC6(["上傳技術文件(PDF/Word/MD)"])
            UC7(["批次匯入整個資料夾"])
            UC8(["查詢文件向量化狀態"])
            UC9(["刪除文件"])
        end

        subgraph ADMIN_UC ["⚙️ 系統管理"]
            UC10(["管理使用者帳號"])
            UC11(["查看系統狀態(Ollama/DB)"])
            UC12(["管理 MCP 工具"])
            UC13(["查看稽核日誌"])
        end

        subgraph MCP_UC ["🔩 MCP 工具開發"]
            UC14(["開發 CAD 指令資料庫"])
            UC15(["部署 MCP Server"])
            UC16(["更新工具定義"])
        end
    end

    %% ===== Actor → Use Case Associations =====
    RD --> UC1
    RD --> UC2
    RD --> UC3
    RD --> UC4
    RD --> UC5

    ADMIN --> UC6
    ADMIN --> UC7
    ADMIN --> UC8
    ADMIN --> UC9
    ADMIN --> UC10
    ADMIN --> UC11
    ADMIN --> UC12
    ADMIN --> UC13

    ENG --> UC14
    ENG --> UC15
    ENG --> UC16

    %% ===== Include / Extend =====
    UC1 -.->|"<<include>>"| UC2
    UC3 -.->|"<<include>>"| UC1
    UC4 -.->|"<<extend>>"| UC1
    UC1 -.->|"<<extend>>"| UC5
    UC7 -.->|"<<include>>"| UC6
    UC12 -.->|"<<include>>"| UC15