jim800121chen
d9d8f03fba
- 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>
62 lines
2.6 KiB
Markdown
62 lines
2.6 KiB
Markdown
# visionA
|
||
|
||
Innovedus visionA monorepo — Edge AI 開發平台（離線版 + 雲端版）。
|
||
|
||
## 開發環境快速啟動
|
||
|
||
```bash
|
||
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`](./docs/DEV-SETUP.md)。
|
||
其他 target：`make help`。
|
||
|
||
## 子專案
|
||
|
||
| 專案 | 角色 | 狀態 |
|
||
|------|------|------|
|
||
| [`local-tool/`](./local-tool/README.md) | **離線版** 桌面工具（Wails + Go + Next.js） | 穩定維護 |
|
||
| [`visionA-frontend/`](./visionA-frontend/README.md) | 雲端版 web 前端（Next.js） | ✅ Phase 0 雛形 |
|
||
| [`visionA-backend/`](./visionA-backend/README.md) | 雲端版後端（Go，雙 binary：api-server + remote-proxy） | ✅ Phase 0 雛形 |
|
||
| [`local-agent/`](./local-agent/README.md) | **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 獨立安裝、不衝突）。
|
||
|
||
## 產品線原則
|
||
|
||
1. **local-tool 不動**，需要時 fork
|
||
2. **雲端 vs 本機差異只在前端部署位置**
|
||
3. **雲端 agent 的 server ≈ local-tool 的 server**（差別在沒本機操作 UI）
|
||
4. **雲端 web UI 先抄 local-tool**，之後再加新功能
|
||
|
||
## 文件
|
||
|
||
完整產品文件見 [`.autoflow/`](./.autoflow/README.md)：
|
||
|
||
- 產品需求：[`.autoflow/02-prd/PRD.md`](./.autoflow/02-prd/PRD.md)
|
||
- 設計規格：[`.autoflow/03-design/design-spec.md`](./.autoflow/03-design/design-spec.md)
|
||
- 架構總覽：[`.autoflow/04-architecture/design-doc.md`](./.autoflow/04-architecture/design-doc.md)
|
||
- 交付總結：[`.autoflow/07-delivery/project-summary.md`](./.autoflow/07-delivery/project-summary.md)
|
||
|
||
## License
|
||
|
||
TBD（內部使用）
|