定版交付：主系統與 Agent 各自更新

%%{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
  autonumber
  participant P as 管理員（更新中心）
  participant M as 主系統 api／worker
  participant U as 更新站＋R2
  participant H as 主機 systemd
  P->>M: 立即檢查（另有每日排程）
  M->>U: /v1/check product=host
  U-->>M: 新版、簽好的清單、三段說明
  P->>M: 更新到 X
  Note over P: 全頁遮罩，只顯示進度
  M->>U: /v1/download-url（15 分鐘預簽網址）
  M->>U: 下載包與 ops 小檔（背景工作、可續傳）
  M->>M: 用本機公鑰驗章、比對雜湊
  M->>H: 寫更新單 upgrade/orders/<job>.json
  H->>H: guidant-upgrade-order.path 撿單 → 重驗包與章
  H->>H: 0 換維運指令 → 1 預檢 → 2 等工作做完 → 3 複製資料庫
  H->>H: 4 在複本套新版 → 5 健康檢查 → 6 換成新版 → 7 清理
  Note over H: 2～6 前門顯示維護頁；任一步失敗自動退回
  H-->>M: 進度檔每步更新
  M-->>P: 八步進度；完成後回更新中心

%%{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
  autonumber
  participant P as 管理員（更新中心 Agent 區）
  participant M as 主系統
  participant U as 更新站＋R2
  participant A as Agent 容器
  participant H as Agent 主機 systemd
  P->>M: 勾選 N 台，更新選取的 N 台到 X
  alt 手上的包不是最新（沒有包，或比更新站查到的舊）
    M->>U: 下載 Agent X（背景工作，畫面有進度、可取消）
    M->>M: 驗 agent_release_manifest 章、雜湊，存 agent-bundles/X/
    Note over M: 下載中再有人按，併入待推清單
  end
  M->>M: 建推送列：先 1 台，成功再推其餘
  M->>A: 直推 POST /update {版號, sha256, 大小}（mTLS＋60 秒 JWT）
  Note over A: 進入維護模式：停收新工作
  A->>M: GET /agents/update/bundle 下載包（可續傳）
  A-->>M: 事件 update_download
  A->>A: 核大小與雜湊，寫升級單 agent-upgrade-order.json
  H->>H: guidant-agent-upgrade-order.path 撿單
  H->>H: 用舊版 Agent 驗新版程式樹的章 → 跑升級步驟
  A-->>M: 事件 update_step（每步）
  H->>H: 換新容器、健康檢查
  A-->>M: 事件 update_result＋上傳升級紀錄
  M-->>P: 每台八步進度與結果；成功清用不到的包

%%{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
  autonumber
  participant O as 操作者（Agent 主控台 8444）
  participant A as Agent
  participant M as 主系統
  participant U as 更新站
  O->>A: 立即檢查
  A->>M: POST /agents/update/check（通行證＋DPoP）
  M->>U: 查 Agent 線（全機 5 分鐘節流）
  A->>M: GET /agents/update/available
  M-->>A: 有新版 X（手上沒包也照報）
  O->>A: 更新到 X
  Note over O: 按下當下整頁鎖住
  A->>M: POST /agents/update/request（操作者名稱）
  M->>M: 手上不是最新 → 排下載，記「agent-console:操作者」
  M->>A: 下載完直推 POST /update（之後同圖 2 第 7 步起）