跳至主要内容

AppFuse WebApp 開發方法論

本目錄提供使用 AppFuse 框架開發應用程式的完整方法論與指南，涵蓋從 Prototype 到生產環境的完整流程。

文檔定位​

┌─────────────────────────────────────────────────────────────────┐
│  appfuse-docs/                                                  │
│                                                                 │
│  docs-methodology/  開發方法論與指南 (本目錄)                      │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │  - 提供通用的開發流程指引                                   │  │
│  │  - 提供文檔撰寫規範與範本                                   │  │
│  │  - 可獨立存在，供任何使用框架的團隊參考                      │  │
│  └───────────────────────────────────────────────────────────┘  │
│                              ↓ 實際案例                         │
│  docs-specs/florist/  應用規格（所有模組共用）                     │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │  - 花店管理系統的產品規格                                   │  │
│  │  - 展示方法論的具體應用                                     │  │
│  │  - 包含完整的 Epic、User Stories、SBE、API 規格            │  │
│  └───────────────────────────────────────────────────────────┘  │
│                              ↓ 框架文檔                         │
│  docs-web/  前端框架文檔          docs-server/  後端框架文檔      │
│  ┌──────────────────────────┐  ┌──────────────────────────┐   │
│  │  - 元件使用指南            │  │  - 模組使用指南            │   │
│  │  - 設計概念與 ADR          │  │  - 設計指南與 ADR          │   │
│  └──────────────────────────┘  └──────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

文檔索引​

核心指南​

文檔說明
開發流程指南Step 1–4 開發流程、US 四階段追蹤模型
規格撰寫指南各類文檔（Epic、US、SBE 等）的撰寫規範、範本與建議目錄結構
Claude Code Skills 總覽17 個 Skill 快速參考索引
AI 協助規格撰寫蘇格拉底式閉環、AI Skill 使用指南

技術指南​

文檔說明
部署指南生產環境部署說明
yalc 工作流程框架本地測試流程（特殊場景用）

決策記錄​

ADR說明
ADR-001: AI 協助規格撰寫策略採用蘇格拉底式閉環模式的決策與權衡

實際案例​

位置說明
花店管理系統規格產品規格：Roadmap、Epic、US、SBE、API 規格、ADR
前端框架文檔元件使用指南、設計概念與 ADR
後端框架文檔模組使用指南、設計指南與 ADR

開發流程總覽​

本框架採用 SCRUM + SBE 方法論，分四個階段將功能從 Prototype 推進到生產環境：

  1. Step 1 — Prototype 開發（app-web-mockup + MSW Mock API）
  2. Step 2 — 程式碼同步（app-web-mockup → app-web）
  3. Step 3 — 後端開發 + 漸進式整合（app-web ↔ app-server）
  4. Step 4 — 完全整合與生產部署

每個 User Story 在 Sprint 內以 🔲 → P.E2E → P.UAT → I.E2E → ✅ 五個階段追蹤進度。

詳細流程與圖表請參閱 開發流程指南。

文檔層級架構​

使用本框架開發應用程式時，建議按 Roadmap → Epic → US → SBE 的層級建立文檔結構。

完整的目錄模板與各類文檔的撰寫規範請參閱 規格撰寫指南。

快速開始​

  1. 閱讀核心指南 — 開發流程指南 了解做事的順序，規格撰寫指南 了解產出物的規範
  2. 參考實際案例 — 瀏覽花店管理系統規格了解具體應用
  3. 建立專案文檔 — 根據 規格撰寫指南 中的目錄模板與範本撰寫文檔

相關資源​

方法論參考​

BDD / Given-When-Then​

最後更新: 2026-02-11