上傳檔案掃描：把源碼包交給平台掃

%%{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 U as 使用者 (FE)
    participant BE as BE
    participant TS as tenant 儲存空間
(local/minio/remote_agent)
    participant AG as agent
    participant SQ as SonarQube server (171)

    Note over U: 任務設定已存 scan_mode=upload
（設定表單裡沒有檔案欄位）
    rect rgb(246, 235, 213)
    Note over U,TS: 新造：任務抽屜發起執行時上傳（首次必上傳；重掃可沿用）
    U->>U: 抽屜執行對話框出現上傳區
已有檔案時顯示「目前檔案：xxx.zip（上傳於 M/D）」
    U->>BE: POST /file/upload（壓縮包，驗副檔名與大小上限）
    BE->>TS: upload_files_for_tenant() 存入 tenant 儲存
    BE-->>U: 回 file uid
    U->>BE: POST /jobs/<uid>/execute
（body 帶 source_file uid；沿用舊檔則不帶）
    end
    BE->>BE: start_execution：帶新 uid 則覆寫綁定的 sticky 參照
不帶則沿用；從 upload_files 權威取 file_name/size/sha256
寫 job_execution（scan_params 快照）+ agent_tasks
（params 夾 _source_file 參照）
    AG->>BE: 心跳（既有 mTLS 通道）
    BE-->>AG: 下發任務 payload（含 source_file 參照）
    rect rgb(246, 235, 213)
    Note over AG,TS: 新造：agent 取源段
    AG->>AG: shutil.disk_usage 磁碟檢查
不足 → 直接 fail「agent 磁碟空間不足」
    AG->>BE: GET /api/1.0/agents/files/<uid>（mTLS，串流）
    BE->>TS: 讀出 zip（依 storage_type）
    BE-->>AG: 串流回傳（BE 不落地）
    AG->>AG: sha256 驗證
    AG->>AG: 標準庫安全解壓進 scan workspace
（zipfile / tarfile filter=data；累計大小/檔數超限即中止清理）
    end
    Note over AG,SQ: 以下全複用 FR-058.6 scan 管線
    AG->>AG: sonar-scanner 掃描（_run_with_cancel）
    AG->>SQ: 推分析結果
    AG->>SQ: 輪詢 CE 處理佇列
    SQ-->>AG: 分析完成
    AG->>SQ: 拉 issues / 品質門檻
    AG->>AG: 組報告；finally: shutil.rmtree workspace
（既有機制，五路徑測試鎖約）
    AG->>BE: 回報 result（既有 mTLS 通道）
    Note over BE,TS: D29 定案：tenant 儲存上的壓縮包保留供重掃沿用
（不做終態刪檔；清理機制列 follow-up）
    BE-->>U: 執行紀錄顯示結果（檔名而非裸 UUID）

圖 1 · 端到端時序：發起執行時上傳（或沿用舊檔）→ tenant 儲存 → execute → 心跳下發 → mTLS 下載 → 驗證/解壓 → 掃描 → 回收 → agent workspace 清理（server 端壓縮包保留）

%%{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
    subgraph FEG["前端 FE"]
      FE["JobExecutionDrawer.vue
執行對話框加上傳區（改）
SurveyPreview 上傳範例移植"]
    end
    subgraph BEG["後端 BE"]
      UP["POST /file/upload
（既有）"]
      MFS["ManagedFileUploadService
（既有，upload 與讀取）"]
      EX["POST /jobs/<uid>/execute
收 source_file body（改）"]
      HB["心跳下發 _collect_pending_tasks
＋夾檔案參照（改）"]
      DL["GET /api/1.0/agents/files/<uid>
純 mTLS＋任務綁定驗證（新）"]
    end
    subgraph TSG["tenant 儲存空間"]
      LO["local"]
      MI["minio"]
      RA["remote_agent"]
    end
    subgraph AGG["agent（evidence-agent）"]
      GS["_get_stream mTLS 下載 client（新）"]
      DK["磁碟檢查 shutil.disk_usage（新）"]
      UZ["標準庫安全解壓（新）
zipfile / tarfile filter=data"]
      WS["scan workspace /tmp
掃完即刪（既有＋測試鎖約）"]
      SC["sonar-scanner CLI 7.3.0（既有）"]
    end
    SQ["SonarQube server
192.168.50.171"]

    FE -->|"發起執行時上傳 zip"| UP
    UP --> MFS
    MFS --> LO
    MFS --> MI
    MFS --> RA
    FE -->|"execute 帶 source_file"| EX
    EX --> HB
    HB -->|"心跳 payload（既有 mTLS）"| GS
    GS -->|"mTLS 串流下載（新）"| DL
    DL --> MFS
    GS --> DK
    DK --> UZ
    UZ --> WS
    WS --> SC
    SC -->|"推分析＋輪詢 CE＋拉報告"| SQ
    MFS -.->|"zip 保留供重掃沿用（D29）"| LO

圖 2 · 元件架構：FE / BE / tenant 儲存（三後端）/ agent / SonarQube server（171）