jim800121chen
dc6ca211ae
推論工作區後端塊2：實作 WS forward，讓 local agent 的推論結果 WS （inference:<deviceId>）經 tunnel 推回雲端瀏覽器 canvas overlay。照 edge-ai-platform POC relay/server.go proxyWebSocket 移植（唯讀參考）。 - forwarder.go ForwardWebSocket：OpenStream→寫 upgrade→讀 101→WebSocketConn （新增 WebSocketConn/wsUpgradeError/AsWSUpgradeError） - proxy.go newWebSocketProxyHandler：hijack browser→回寫 101→雙向 io.Copy cross-close（無 goroutine leak）+ copyWebSocketUpgradeHeaders（保留 Sec-WebSocket-*、剝 Authorization/Origin） - camera.go registerWebSocketRoutes：GET /ws/devices/:id/inference - api.go wsAuthGroup（/ws + AuthMiddleware）：same-origin cookie 認證， 無 token-in-URL（security 定案） - stubs.go：移除 WS inference 501 stub、更新過時 doc comment（Mi-1/2） 架構差異：POC 單 binary，visionA api-server(auth)+remote-proxy 雙 binary， remote-proxy raw byte pipe 透明穿過 WS upgrade bytes。local agent 端未動。 認證/授權（security 定案 + S1/S2）：same-origin cookie、剝 Auth/Origin、 WS 不套 300s timeout、走 pickActiveSessionToken（帶別人 deviceId 也只打到 自己 tunnel；多租戶嚴格綁定屬 Phase 1 M2 debt）。 Reviewer 0C/1M/3Mi 通過（修後）。Major-1 已修：收窄 all_endpoints_require_auth_test 的 /ws/ 白名單，讓 authed inference WS 納入「無 cookie 應 401」回歸檢查 （附守得住證明：移除 auth 測試即 FAIL）。+forwarder 5 test + camera_ws 端到端四層真連線雙向 pipe。build/vet/全回歸綠。 Co-Authored-By: Claude Opus 4.8 (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（內部使用）