jim800121chen d9d8f03fba chore: visionA Cloud monorepo 根目錄設定（Makefile + README + .gitignore）

- Makefile：top-level convenience targets（呼叫各子專案的 Makefile）
- README.md：擴充為 monorepo 索引（local-tool / visionA-backend /
  visionA-frontend / local-agent 各組件說明 + dev-with-mc / stage 部署 quickstart）
- .gitignore：
  - .env.dev / .env.dev.generated / .env.stage 排除（dev 與 stage 環境檔不進 git）
  - .autoflow/ 整包 ignore（個人/per-branch 工作目錄；progress.md 與 review 報告
    皆 ignored；共享產品文件已搬到 docs/ 進 git）
  - graphify-out/ 排除

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-01 11:22:57 +08:00

2.6 KiB

Raw Blame History

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（內部使用）

2.6 KiB Raw Blame History Unescape Escape