架構設計指引
系統架構設計指引 企業標準技術白皮書|版本 v2.0|2026-10-07 適用範圍:以 Java / Spring Boot 為後端、以 Web 前端為使用介面,部署在容器平台(Kubernetes)的企業應用系統,涵蓋架構治理、品質屬性、架構風格、整合、API、資料、效能、韌性、安全、可觀測性、部署平台與交付流程。 v2.0 全面改寫 v1.x:依 ISO/IEC/IEEE 42010:2022、ISO/IEC 25010:2023、OWASP Top 10:2025、NIST SP 800-207 等國際標準重新組織內容;每條規則都附有範例與「驗證方式」,每節結尾都有「🔍 審查與驗證」,讓審查者能判斷 AI 或同事產出的架構設計是否正確。範例均經工具實測(見 附錄 E)。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術基準版本 0.3 規範等級與規則格式 0.4 與其他指引的關係 0.5 如何閱讀本指引 0.6 例外與豁免流程 1. 架構治理與國際標準 1.1 國際標準與參考框架 1.2 架構原則 1.3 技術選型與技術雷達 1.4 架構決策紀錄 (ADR) 1.5 架構文件:arc42 與 C4 模型 1.6 架構審查流程 1.7 架構適應度函數 (Fitness Functions) 2. 品質屬性與非功能需求 2.1 ISO/IEC 25010:2023 品質模型 2.2 非功能需求的量化 2.3 品質情境與取捨分析 2.4 SLI、SLO 與錯誤預算 2.5 成本與永續性目標 3. 架構風格與系統拆分 3.1 架構風格的選擇 3.2 模組化單體與 Spring Modulith 3.3 領域驅動設計:戰略設計 3.4 微服務拆分準則 3.5 演進式遷移:Strangler Fig 4. 整合與通訊 4.1 同步與非同步通訊的選擇 4.2 API Gateway 與 Kubernetes Gateway API 4.3 服務網格 (Service Mesh) 4.4 可靠的訊息傳遞:Outbox 與冪等 4.5 分散式交易與 Saga 4.6 事件與 API 契約 5. API 設計 5.1 API 優先與 OpenAPI 規格 5.2 資源與 URL 設計 5.3 HTTP 狀態碼 5.4 錯誤回應:RFC 9457 Problem Details 5.5 分頁、排序與過濾 5.6 API 版本管理與棄用 5.7 速率限制與請求保護 5.8 API 文件 6. 前端架構 6.1 渲染策略的選擇 6.2 BFF 與瀏覽器端的權杖安全 6.3 微前端 6.4 響應式設計與無障礙 6.5 多語系與時區 7. 後端分層架構 7.1 Clean Architecture 與六角形架構 7.2 分層規則與依賴方向 7.3 套件結構 7.4 架構測試的導入策略 7.5 依賴注入與組態 7.6 交易邊界 8. 資料架構 8.1 資料儲存選型 8.2 資料擁有權與存取 8.3 CQRS 與讀取模型 8.4 讀寫分離與資料分割 8.5 資料庫結構演進 8.6 資料分級與生命週期 8.7 多資料庫支援策略 9. 效能與擴展性 9.1 效能設計原則 9.2 快取策略 9.3 CDN 與靜態資源 9.4 非同步處理與 Virtual Threads 9.5 水平擴展與負載平衡 9.6 效能測試與容量規劃 10. 韌性、高可用與災難復原 10.1 韌性模式 10.2 高可用部署 10.3 健康檢查 10.4 災難復原:RTO 與 RPO 10.5 業務連續性規劃 10.6 混沌工程與故障演練 11. 安全架構 11.1 安全設計與威脅建模 11.2 零信任架構 11.3 身分驗證 11.4 授權與物件層級存取控制 11.5 OWASP Top 10:2025 與 API Security Top 10 對照 11.6 機密管理與資料保護 11.7 Web 安全標頭 11.8 軟體供應鏈安全 11.9 稽核日誌與例外處理 12. 可觀測性 12.1 可觀測性架構 12.2 分散式追蹤 12.3 日誌 12.4 指標與 SLO 告警 12.5 儀表板與值班 13. 容器與部署平台 13.1 容器映像 13.2 JVM 的容器設定 13.3 工作負載設定 13.4 組態與機密管理 13.5 GitOps 與環境推進 13.6 准入政策與 Pod Security 13.7 部署設定的自動驗證 14. 持續整合與交付 14.1 交付流程設計 14.2 CI 管線 14.3 測試策略 14.4 漸進式交付與功能旗標 14.5 交付績效指標(DORA) 15. 微服務治理 15.1 服務發現 15.2 組態管理 15.3 排程工作與分散式鎖 15.4 事件與主題治理 15.5 平台工程與黃金路徑 16. AI 輔助架構設計與審查 16.1 AI 在架構工作中的定位 16.2 讓 AI 依指引產出:提示與專案指示檔 16.3 審查 AI 產出的五個步驟 16.4 AI 常見錯誤速查表 16.5 AI 使用的資料治理 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 架構審查檢核表 B.1 概念與設計審查 B.2 實作審查(抽查) B.3 上線審查 B.4 對照雲端 Well-Architected 支柱 附錄 C 範本 C.1 ADR 範本(MADR 4.0) C.2 arc42 架構文件大綱 C.3 品質情境與非功能需求規格 C.4 威脅模型範本 附錄 D 參考標準與資源 D.1 國際標準 D.2 IETF 規格 D.3 安全標準 D.4 架構方法與框架 D.5 技術文件 D.6 企業內部相關指引 附錄 E 修訂紀錄與查證紀錄 E.1 版本紀錄 E.2 v1.x 章節去向對照 E.3 v1.x 主要更正 E.4 查證紀錄 E.5 待查項目 結語 0. 文件資訊 0.1 文件目的與讀者 本指引定義企業應用系統的架構決策標準:哪些事情必須這樣做、為什麼、做到什麼程度才算合格,以及如何驗證。它回答的是「系統應該長什麼樣子」,而不是「某一行程式碼怎麼寫」。程式碼層級的規範請見 程式寫作指引。 ...