jim800121chen
dab13ed984
致命發現（grep MC + FAA source 確認）：
- MC source 沒有 issue delegated download token endpoint
- MC source 沒有 validate delegated download token endpoint
- FAA MemberCenterDelegatedDownloadTokenValidator.cs 假設的 MC introspection endpoint 不存在
- ADR-014 §2 從 5/2 寫完到現在這條鏈一直是斷的、只是因為從未實際 e2e 跑通過所以沒被發現
使用者拍板硬約束：不動 MC + 不動 FAA
新增 ADR-016：
- visionA download 改用 converter GET /api/v1/jobs/{id}/result（新 endpoint）
- visionA backend 用既有 ConverterAPIKey 認證（不需新增 secret）
- 維持 T4 已實作的 stream proxy 結構（io.CopyN + Content-Disposition + size cap）
- promote 仍 PUT FAA（converter 內部用自己的 OAuth、與 visionA 無關）
- 不需動 MC + FAA + warrenchen
- 6 個替代方案逐一說明排除理由
修訂既有文件：
- ADR-014 v1.1 → v1.2：§2 download flow 標註被 ADR-016 部分 supersede
- ADR-015 v2.0 → v2.1：§2 visionA → FAA delegated token 設計（v2.0 從 v1.x 撤回的設計）再次撤回；§9 env 表撤回 v2.0 加回的 OIDC ServiceClient* / TenantID / FAABaseURL；visionA 端 server-to-server 只剩 ConverterAPIKey 一把
- conversion.md v0.5 → v0.6：§1 sequence diagram 重畫（移除 MC node）、§2 模組設計（mc_token_client.go 整檔刪除確認、faa_client.go 改名 converter_result_client.go）、§3.2 visionA → FAA 整段標撤回、§4.1 download handler 改 converter.GetResult、§6 錯誤碼撤回 mc/faa 三個 code 加 result_not_found / result_expired
- api-conversion.md v0.5 → v0.6：檔頭 Auth 段落改寫、§4 download endpoint 改述、error code 表撤回 mc_token_unavailable / download_token_failed
- oidc-tdd.md v0.3 → v0.4：§13.1 環境變數表 OIDC ServiceClient* / TenantID / FAABaseURL 從「重新啟用」改回「再次廢棄」、§13.1.1 stage env 範例移除 service client / tenant_id / FAA URL、§13.1.3 改寫為「v0.4 單線設計」說明
整體影響：
- 不需復活 mc_token_client.go（commit 86b7175 砍除狀態維持）
- 不需復活 OIDCConfig.ServiceClientID/Secret/TenantID（commit 86b7175 移除狀態維持）
- visionA backend faa_client.go 要改名為 converter_result_client.go、改呼叫 converter.GetResult
- visionA backend flow.go DownloadStream / PromoteToModels 改用 converter.GetResult
- jimchen 跨 repo 任務：converter scheduler 加 GET /api/v1/jobs/{id}/result endpoint
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
visionA
Innovedus visionA monorepo — Edge AI 開發平台（離線版 + 雲端版）。
開發環境快速啟動
make dev-up # 起 backend + Member Center（OIDC）+ Postgres
make frontend-dev # 另開 terminal：起 frontend dev server（pnpm dev）
# 開瀏覽器 http://localhost:3000
完整流程（含 OAuth client 手動註冊、port 對照、疑難排解）見 docs/DEV-SETUP.md。
其他 target：make help。
子專案
| 專案 | 角色 | 狀態 |
|---|---|---|
local-tool/ |
離線版 桌面工具（Wails + Go + Next.js） | 穩定維護 |
visionA-frontend/ |
雲端版 web 前端（Next.js） | ✅ Phase 0 雛形 |
visionA-backend/ |
雲端版後端（Go，雙 binary：api-server + remote-proxy） | ✅ Phase 0 雛形 |
local-agent/ |
visionA Agent — 雲端版 local 端代理（Wails + Go + Next.js） | ✅ Phase 0.5 雛形 |
架構關係
離線模式（local-tool 單獨）
使用者瀏覽器 → localhost:3721 (local-tool server) → Kneron 裝置
雲端模式（visionA 雲端版 + visionA Agent）
使用者瀏覽器 → visionA-frontend (CDN) → visionA-backend (api-server)
↓ internal HTTP
visionA-backend (remote-proxy)
↓ WebSocket + yamux tunnel
使用者電腦上的 visionA Agent
↓ 本機 HTTP
Agent 的內部 server → Kneron 裝置
兩種模式可在同一台電腦共存（local-tool 和 visionA Agent 獨立安裝、不衝突）。
產品線原則
- local-tool 不動，需要時 fork
- 雲端 vs 本機差異只在前端部署位置
- 雲端 agent 的 server ≈ local-tool 的 server（差別在沒本機操作 UI）
- 雲端 web UI 先抄 local-tool，之後再加新功能
文件
完整產品文件見 .autoflow/：
- 產品需求：
.autoflow/02-prd/PRD.md - 設計規格：
.autoflow/03-design/design-spec.md - 架構總覽：
.autoflow/04-architecture/design-doc.md - 交付總結：
.autoflow/07-delivery/project-summary.md
License
TBD（內部使用）