jim800121chen
9031153553
feat(adr-019): 影片/圖片/批次上傳走同機 localhost 直連 local-agent
實作 ADR-019 混合路徑：影片/圖片/批次的檔案上傳改由瀏覽器同機直連
local-agent localhost endpoint（繞過雲端 tunnel），控制面 + MJPEG 結果 +
推論 WS 仍走 tunnel。解決大檔頻寬雙倍 + nginx 100M + 300s timeout。
三條 stream（全數過 reviewer + security code-level 複審 APPROVED）：
local-agent（Go）:
- CORS 雲端 origin 完整精確比對 + Allow-Credentials:false + HostGuard(loopback)
+ PNA header（middleware.go）
- 新 route /api/local/media/upload/*（一律要 token、不看 Origin，關 C1 後門）
- one-time token store（crypto/rand、TTL 120s、綁 deviceId、single-flight consume、
上限 32→429；200 goroutine -race 綠）
- GET /api/local/hello（回 salted SHA-256 serialHashes、最小揭露）
+ POST /api/local/issue-token（Host-based）
- LocalUploadGuard（token+size 驗證放 FormFile 前）；video≤500MB / batch 合計 80MB
→ 413；stopActivePipeline + batch 生命週期 temp 檔清理
cloud（visionA-backend）:
- POST /api/devices/:serial/local-upload-ticket（OIDC + 裝置歸屬 + 經 tunnel
轉發 issue-token；IDOR-safe、錯誤不洩漏）
frontend（visionA-frontend）:
- lib/local-agent.ts（port 探測 3721-3740 並發+快取、Web Crypto serial hash 比對
同機判定、uploadToLocalAgent 通用函式）
- validateBatchFiles 合計大小檢查（MAX_BATCH_TOTAL_BYTES=80MB，消 50×19MB 撞 413 地雷）
回歸：ADR-019 相關 270 測試全綠、既有 tunnel 路徑未被打斷、無 regression。
既有 tunnel（無 Origin）不要求 token（C1 route 分離相容性保證）。
Refs: ADR-019。WP-0(PNA 實機)/WP-4(影片分頁接線)下一批。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-30 12:32:26 +08:00
..
2026-07-30 12:32:26 +08:00
2026-05-01 11:22:01 +08:00
2026-05-01 11:22:01 +08:00
2026-05-01 11:22:01 +08:00
2026-07-16 11:40:35 +08:00
2026-07-10 09:31:51 +08:00
2026-05-01 11:22:01 +08:00
2026-05-01 11:22:01 +08:00
2026-05-01 11:22:01 +08:00