子需求：FR-058.7 SonarQube 上傳檔案掃描（scan 模式取源擴充）

任務摘要

FR-058.7 的端到端驗收，照 design.md §5.12 T-7.4 驗收清單逐項走完。正向：抽屜發起執行時上傳 zip → 掃描 succeeded → 171 出現專案 → agent workspace 已刪 → tenant 儲存壓縮包保留。沿用：不上傳直接重掃＝沿用舊檔跑通；上傳新檔替換後舊檔仍在（歷史保留，D29）。格式：上傳 .tar.gz 跑通（tar 系家族，D27）。負向：磁碟不足模擬跳「agent 磁碟空間不足」錯誤；超額壓縮包（解壓炸彈計量）被擋。設定化：環境變數調限額生效（D27）。另含部署驗證：上版環境 nginx client_max_body_size 實際限制（D27 待辦）。

關鍵約束

• 驗收需 DEV agent image 重建部署，只動 DEV，STG / POC agent 不動（環境異動鐵律）
• 前置：T-7.1、7.2、7.3 全數完成
• 磁碟不足錯誤必須可辨識為 agent 環境問題（非掃描失敗）；超額被擋後 workspace 已清
• FE 執行紀錄顯示檔名非裸 UUID（D31，連動 T-7.3）

design.md 座標

驗收清單全文見 §5.12 T-7.4；端到端流程見 §4.8；相關決策見 §2 D27、D28、D29。

驗收條件摘要

驗收清單全項通過：① 上傳 zip 掃描跑通；② .tar.gz 跑通；③ 沿用舊檔重掃跑通；④ 替換後歷史保留；⑤ agent workspace 掃後已刪；⑥ 磁碟不足明確報錯；⑦ 超額壓縮包被擋；⑧ 環境變數調限額生效；⑨ nginx client_max_body_size 部署驗證。

✅ 已完成修正（2026-08-01 收尾補記）

決策者 2026-08-01 驗收通過（與 FR-059 同輪測試）。DEV 全鏈路實測：上傳 zip / tar.gz 掃描、沿用舊檔重掃、替換後歷史保留、負向路徑（無檔 400、裸 .gz 400、查無檔案 404）全數通過，171 實際長出 Guidant-AI-soybean-ui（2 files / 16 ncloc，實證掃的是上傳檔）。四個未驗項決策者裁示：磁碟不足與解壓炸彈接受單元測試涵蓋、環境變數調限額不另實測、nginx client_max_body_size 列上版必驗項。