# 10. 開發範圍與階段 — visionA Cloud

> 父文件：[PRD.md](PRD.md)

---

## 10.1 三階段總覽

```
┌─────────────────────────────────────────────────────────────────┐
│ Phase 0（本次）      Phase 1              Phase 2+              │
│ 雛形 / 骨架          MVP（外部早期採用）  產品化（商業化）       │
│ 2026 Q2              2026 Q3              2026 Q4+              │
│                                                                  │
│ • 跑得動             • 接真 Auth          • Billing              │
│ • 介面清楚           • 接真 DB            • 轉檔整合（真）        │
│ • 雙模式共存         • 接真 Storage       • 多租戶 / 團隊         │
│ • 內部 FAE 測試      • 叢集功能           • 多區域部署            │
│ • local-tool 不動    • 圖片/影片推論      • 公開 API              │
│ • Auth 是 stub       • 外部 ~100 用戶     • 正式上線              │
└─────────────────────────────────────────────────────────────────┘
```

---

## 10.2 Phase 0（本次雛形，2026 Q2）

### 10.2.1 目標

**一句話**：visionA Cloud 的架構骨架 + 基本頁面 + API Server + Remote Proxy 跑得動，使用者能在瀏覽器完成「註冊 → 配對 → 推論」流程，但 Auth / DB / Storage 都是 stub。

### 10.2.2 範圍（Scope）

**必做（P0）**：

- visionA-frontend 骨架 + P0 頁面（登入、註冊、首頁、裝置、模型、工作區、設定）
- visionA-backend `cmd/api-server`（對前端的 REST + WebSocket）
- visionA-backend `cmd/remote-proxy`（從 POC 搬 relay，升級 Pairing Token）
- Pairing 流程端到端（至少手動編輯 local-tool config 能跑通）
- Camera 推論端到端（透過 tunnel）
- 模型上傳（local fs 實作 ObjectStorage 介面）
- 會員系統 **stub**（in-memory AuthProvider）
- SessionStore **in-memory 實作**
- ConverterClient **stub 實作**（讓前端流程可走完）
- 前端 `/clusters` 頁面預留（可顯示「即將推出」）
- i18n 繁中 + English（沿用 local-tool）
- 基本的 CI（至少 unit test 跑得過）

**明確不做**：

- 真 Auth（JWT / OAuth / DB）
- 真 DB（PostgreSQL）
- 真 S3 / MinIO
- 叢集推論 API（只搬 `internal/cluster/` 模組）
- 儀表板時間軸與統計（只做快速開始版）
- 圖片 / 影片 / Batch 推論（只做 Camera）
- 轉檔 API 真實對接
- Billing
- Observability（Prometheus / Grafana / Tracing）
- 正式部署到雲端（dev 環境能跑就好）

### 10.2.3 里程碑

| 週 | 里程碑 | 產出 |
|---|-------|------|
| W1-2 | 三方文件完成 | PRD、Design Spec、TDD 全部通過三方審閱 |
| W3 | 骨架搭起來 | monorepo 結構建好、兩個 binary 能啟動、前端能打開登入頁 |
| W4 | Auth stub + 前端 P0 頁面切換 | 能註冊 → 登入 → 看到空 dashboard |
| W5-6 | Pairing 流程 + Tunnel 重搬 | 用 test local-tool（修改版 config）能 pairing 成功 |
| W7 | Camera 推論跑通 | 至少一位 FAE 能遠端看到 Camera + overlay |
| W8 | 模型管理 + 上傳 | ObjectStorage 介面完成，上傳 `.nef` 可用 |
| W9 | 內部 FAE 測試 | 5+ FAE 完成端到端推論 |
| W10 | 修 bug + Phase 0 驗收 | 達成所有驗收條件，進入 Phase 1 規劃 |

### 10.2.4 Phase 0 TODO 總清單（匯整）

所有 Phase 0 留下的 TODO，統一列在此處，交給 Orchestrator 追蹤：

**Auth 相關**：

- TODO-AUTH-01：換 JWTAuthProvider
- TODO-AUTH-02：DB schema（users / sessions）
- TODO-AUTH-03：Email 驗證流程
- TODO-AUTH-04：密碼重設流程
- TODO-AUTH-05：OAuth（Google / GitHub）
- TODO-AUTH-06：2FA
- TODO-AUTH-07：密碼強度規則
- TODO-AUTH-08：Rate limiting
- TODO-AUTH-09：Account 刪除
- TODO-AUTH-10：個人設定頁完整功能
- TODO-AUTH-11：Role / Permission
- TODO-AUTH-12：API Key 管理

**Storage 相關**：

- TODO-STO-01：S3/MinIO 實作
- TODO-STO-02：Presigned URL 上傳
- TODO-STO-03：模型版本管理
- TODO-STO-04：檔案掃毒

**Session / Tunnel 相關**：

- TODO-SESS-01：Redis SessionStore 實作
- TODO-SESS-02：Session Token rotation
- TODO-SESS-03：Session 撤銷功能
- TODO-SESS-04：多節點 remote-proxy + consistent hashing
- TODO-SESS-05：Tunnel 斷線事件通知優化

**Pairing 相關**：

- TODO-PAIR-01：local-tool 內建 Pairing UI
- TODO-PAIR-02：QR code 生成
- TODO-PAIR-03：Pairing 成功後的使用者引導

**Converter 相關**：

- TODO-CONV-01：正式對接 converter API
- TODO-CONV-02：Webhook 簽章驗證
- TODO-CONV-03：轉檔進度 UX 優化
- TODO-CONV-04：支援格式擴充（初期只支援 ONNX）

**功能擴充**：

- TODO-FEAT-01：圖片 / 影片 / Batch 推論
- TODO-FEAT-02：叢集推論 API 實作與 UI
- TODO-FEAT-03：儀表板時間軸與統計
- TODO-FEAT-04：多 client 看同一推論的效能優化

**可觀測性**：

- TODO-OBS-01：Prometheus metrics
- TODO-OBS-02：Grafana dashboard
- TODO-OBS-03：OpenTelemetry tracing
- TODO-OBS-04：Log 聚合（ELK / Loki）

**部署**：

- TODO-DEP-01：真的雲端部署（staging + production）
- TODO-DEP-02：TLS 憑證
- TODO-DEP-03：DNS / Subdomain
- TODO-DEP-04：CDN（前端）
- TODO-DEP-05：CI/CD pipeline

**商業化（Phase 2）**：

- TODO-BIZ-01：Billing 介面 + Stripe 整合
- TODO-BIZ-02：定價方案設計
- TODO-BIZ-03：Terms / Privacy Policy
- TODO-BIZ-04：GDPR / 台灣個資法合規

---

## 10.3 Phase 1 MVP（2026 Q3，外部早期採用者）

### 10.3.1 目標

- 接真 Auth（JWT + DB）
- 接真 Storage（S3 或 MinIO）
- 完成 Pairing、叢集、儀表板功能
- 部署到真的雲端環境
- 對外開放給 ~100 位早期採用者

### 10.3.2 主要交付

- 替換所有 Phase 0 stub 為真實作
- 叢集推論 UI + API
- 圖片 / 影片 / Batch 推論
- 真實部署（staging + production）
- CI/CD
- 基本 Observability
- User Story US-14 ~ US-23 全部完成

### 10.3.3 成功標準

- WAD >= 30
- Pairing 轉換率 > 60%
- 推論延遲 P95 < 400ms
- 系統 uptime > 99%

---

## 10.4 Phase 2+（2026 Q4 起，產品化）

### 10.4.1 範圍

- 轉檔整合完成（converter API 真實對接）
- Billing（Stripe）
- 多租戶 / 團隊功能
- Multi-region 部署
- 公開 API（for Mike 這類獨立開發者）
- Mobile app（read-only，看裝置狀態）
- 合規文件（Terms / Privacy / GDPR）
- Marketing site 整合

### 10.4.2 成功標準

- MRR $5K+
- 付費用戶 50+
- NPS > 40

---

## 10.5 策略性路線圖（Now / Next / Later）

### Now（本季，Phase 0）

- 雛形架構跑得動
- 內部 FAE 測試通過
- 介面契約穩定

### Next（下季，Phase 1 MVP）

- 真實 Auth / DB / Storage
- 叢集推論產品化
- 部署到雲端

### Later（6-12 個月，Phase 2+）

- 商業化 Billing
- 轉檔整合
- Mobile + 公開 API
- 多區域

---

## 連結

- 上一章：[成功指標](success-metrics.md)
- 下一章：[風險與相依](risks.md)
- 跳回：[PRD 索引](PRD.md)