設計指南 (Design Guidelines)
本目錄包含 AppFuse Server 框架的參考設計文檔，提供建構應用程式的最佳實踐與設計原則。
📚 文檔索引
| 文檔 | 說明 |
|---|---|
| feature-slices.md | Feature slice 的三層定位、設計不變量與 /feature 使用方式 |
| authority-model.md | 權限模型設計指南 |
| business-calendar.md | 營業行事曆與日期可選性 |
| concurrency.md | 併發更新策略（樂觀鎖） |
| database-design.md | 資料層設計指南 |
| entity-field-types.md | 跨資料庫的 JPA Entity 欄位型別規範 |
| entity-audit.md | Optional Entity 歷程、changeset actor 與 Envers adapter |
| file-handling.md | 檔案處理設計指南（前後端整合） |
| file-storage.md | 檔案儲存設計（後端儲存架構） |
| multi-tenancy.md | 多租戶設計指南 |
| reference-data.md | Reference Data 設計指南 |
🔗 相關資源
架構決策記錄 (ADR)
設計指南說明「如何做」(How)，而 ADR 記錄「為什麼這樣做」(Why)。
- ADR-001: 多租戶數據隔離策略
- ADR-027: JSON 欄位處理策略
- ADR-028: Entity 關聯設計策略
- ADR-014: Capability 與 core slice 對偶
- ADR-024: Capability／Feature／參考實作定位
其他指南
文檔維護者: Development Team + AI Assistant