功能路線圖
當前版本: 0.0.2-SNAPSHOT
專案願景
AppFuse Server 是一個 Spring Boot 快速開發工具集，提供通用組件和工具，幫助開發者快速建構高品質的 RESTful API 應用程式。
核心目標
- 降低開發成本: 提供常用功能的開箱即用實作
- 保持彈性: 介面導向設計，支援替換底層實作
- 最佳實踐: 體現 Spring Boot 生態系統的最佳實踐
- 生產就緒: 提供完整的測試和文檔
版本規劃
Version 1.0.0 - 核心功能
預計發布: 2026 Q1
核心模組:
- 錯誤處理框架（ErrorResponse, ExceptionMappingRegistry）
- 雙層快取架構（DualLayerCache）
- Content 檔案類型檢測（ContentTypeDetector）
- Login Lockout 防暴力破解
- JWT 認證系統
- CSV 處理工具
- 分頁與排序工具
- 查詢過濾工具
發布標準:
- 所有核心模組功能完整
- 測試覆蓋率 > 80%
- 文檔完善
Version 1.1.0 - 數據處理增強
預計發布: 2026 Q2
新增功能:
- Excel 處理工具
- 資料導入/導出框架
- 審計日誌框架
- 批次處理工具
Version 1.2.0 - 整合與擴展
預計發布: 2026 Q3
新增功能:
- 郵件發送工具
- 簡訊發送工具
- 檔案儲存抽象層（S3/Azure Blob）
- 搜尋引擎整合
- 訊息佇列整合
Version 2.0.0 - 架構升級
預計發布: 2026 Q4+
新增功能:
- 微服務支援
- 事件驅動架構
- GraphQL 支援
- gRPC 支援
- 可觀測性增強
當前狀態
已完成功能
| 模組 | 功能 | 狀態 |
|---|---|---|
| Security | JWT 認證系統 | ✅ |
| Security | Login Lockout | ✅ |
| Security | Token 黑名單 | ✅ |
| Error | 錯誤處理框架 | ✅ |
| Cache | 雙層快取架構 | ✅ |
| Content | 類型檢測 | ✅ |
| HTTP | HTTP 客戶端 | ✅ |
| Link | HATEOAS 連結 | ✅ |
| Tenant | 多租戶支援 | ✅ |
| OAuth2 | Client Credentials | ✅ |
| CSV | CSV 處理 | ✅ |
進度指標
| 指標 | 目標 | 當前 |
|---|---|---|
| 核心模組完成度 | 100% | ~90% |
| 測試覆蓋率 | > 80% | ~60% |
| 文檔完整性 | 100% | ~90% |
優先級
P0 - 必須（v1.0.0）
- 錯誤處理框架
- 認證與安全
- 快取管理
- 多租戶支援
- 完整文檔
P1 - 重要（v1.1.0）
- Excel 處理
- 資料導入/導出
- 審計日誌
P2 - 期望（v1.2.0）
- 郵件/簡訊發送
- 檔案儲存抽象
P3 - 可選（v2.0.0）
- 微服務支援
- 事件驅動架構
需求來源
功能開發主要基於 app-server（參考實作）的實際需求：
開發原則:
- 先在 app-server 中實作和驗證
- 穩定後提取到 appfuse-server
- 確保通用性和可復用性