Epics 目錄

本目錄包含所有 Epic 層級的詳細文檔。

什麼是 Epic？

Epic 是一個大型的功能主體，通常包含多個 User Stories。它代表一個戰略主題或業務領域。

---

Epic 列表

Epic ID	名稱	狀態	文檔
Epic 0	平台基礎設施與橫切關注點	🟡 規劃中	epic-0-platform-infrastructure.md
Epic 1	產品與作品集管理	📝 文檔完成	epic-1-product-management.md
Epic 2	端到端訂單生命週期管理	🟢 進行中	epic-2-order-lifecycle.md
Epic 3	客戶與企業帳戶系統 (CRM)	🟡 規劃中	epic-3-customer-management.md
Epic 4	進階發票與支付管理	🟡 規劃中	epic-4-invoicing-payment.md（待建立）
Epic 5	數位資產與簽收工作流程	🟡 規劃中	epic-5-digital-assets.md（待建立）

---

Epic 文檔模板

創建新的 Epic 文檔時，請使用以下模板：

# Epic N: {Epic 名稱}

## 業務目標 (Business Goal)
（為什麼要做這個 Epic？解決什麼問題？帶來什麼價值？）

## 成功指標 (Success Metrics)
（如何衡量 Epic 的成功？列出 2-5 個可量化的指標）

- 指標 1: 具體數值目標
- 指標 2: 具體數值目標
- ...

## 功能範疇 (Scope)
（Epic 包含哪些主要功能？使用列表或分類描述）

### 核心功能
- 功能 1
- 功能 2

### 進階功能（可選）
- 功能 3

## User Stories 列表
（鏈接到 ../user-stories/epic-N/ 目錄中的 User Stories）

- [US-N01: User Story 標題](../user-stories/epic-N/US-N01-description.md)
- [US-N02: User Story 標題](../user-stories/epic-N/US-N02-description.md)
- ...

## 技術依賴 (Technical Dependencies)
（依賴其他 Epic 或外部系統）

- 依賴 Epic X: 原因說明
- 依賴外部系統 Y: 原因說明

## 多租戶考量 (Multi-Tenancy Considerations)
（Multi-tenancy 設計要點）

- 數據隔離策略
- Tenant ID 使用方式
- 跨租戶限制

## 安全性考量 (Security Considerations)
（如有特殊安全需求）

- 權限控制要點
- 敏感數據處理
- 審計要求

## 非功能性需求 (Non-Functional Requirements)
（效能、可用性、擴展性等）

- 效能目標
- 可用性要求
- 擴展性考量

## 參考資料 (References)
（相關的路線圖章節、外部文檔等）

- [產品路線圖](../roadmap.md#section-reference)
- 外部參考文檔鏈接

---

命名規範

• 檔案名稱: epic-{編號}-{kebab-case-描述}.md
• 範例: epic-2-order-lifecycle.md
• Epic ID: 使用 0-5 的編號（對應路線圖中的 Epic）

---

撰寫指南

1. 從路線圖提取內容

參考 roadmap.md 第三節的 Epic 描述，並進行詳細化。

2. 業務目標要明確

• ✅ 好的範例: "讓店員能在 2 分鐘內完成訂單創建，減少 50% 的人工錯誤"
• ❌ 不好的範例: "改善訂單處理流程"

3. 成功指標要可量化

• ✅ 好的範例: "平均訂單處理時間 < 24 小時"
• ❌ 不好的範例: "提升訂單處理效率"

4. User Stories 應遵循 INVEST 原則

拆分 Epic 為 User Stories 時，確保每個 User Story 是：

• Independent: 獨立的
• Negotiable: 可協商的
• Valuable: 有價值的
• Estimable: 可估算的
• Small: 小的（1-2 Sprint 可完成）
• Testable: 可測試的

5. 多租戶意識

所有 Epic 都應考慮多租戶隔離：

• 數據如何隔離？
• API 如何驗證租戶身份？
• 如何防止跨租戶數據洩漏？

---

審查檢查清單

提交 Epic 文檔前，請確認：

• 業務目標清晰且與路線圖一致
• 成功指標可量化且可驗證
• User Stories 列表完整且有正確鏈接
• 技術依賴已明確列出
• 多租戶考量已說明
• 文檔格式符合模板規範
• Markdown 鏈接正確無誤

---

最後更新: 2025-12-03