壓測指引2

Gemini 回答 好的,作為一個資深的系統架構師與 AP 性能調校專家,我會為您提供一份在這次壓力測試中,從頭到尾、由外到內需要關注的參數設定與調校檢查清單。 我們的目標非常明確:在 50 個併發用戶(Concurrent Users)持續加壓一小時的條件下,確保 95% 的請求(95th Percentile)回應時間在 3 秒以內。 這是一個系統性的工程,我們需要從壓力來源、作業系統、應用伺服器、一直到資料庫,逐層分析與調校。 核心調校哲學 建立基準 (Establish Baseline): 在進行任何調校之前,先用預設設定跑一次縮短版的壓力測試(例如 10-15 分鐘)。這個數據是你的黃金標準,所有的後續調校都必須跟這個基準線做比較,才能判斷是改善還是惡化。 一次只改一個參數 (Change One Thing at a Time): 這是最重要的原則。如果你一次改了三個參數,效能變好了,你不會知道是哪個參數起了作用。反之,如果效能變差,你也不知道是誰的錯。 監控是你的眼睛 (Monitoring is Key): 如果沒有監控,調校就如同矇著眼睛開車。你必須能夠即時看到 CPU、記憶體、網路、I/O、GC、執行緒等關鍵指標的變化。 第一層:壓力來源 (JMeter) 確保壓力測試工具本身不是瓶頸。 參數/項目 建議與說明 啟動模式 絕對要使用命令列模式 (CLI Mode) 進行正式壓測,不要使用 GUI 模式。GUI 模式會消耗大量客戶端資源,影響測試準確性。指令範例:jmeter -n -t your_test_plan.jmx -l results.jtl JVM Heap Size 修改 jmeter.bat 或 jmeter.sh,調整 JMeter 的 JVM 堆疊大小。如果請求或回應的資料量大,預設的 1G 可能不夠。建議至少設為 HEAP="-Xms2g -Xmx2g" 或更高,避免 JMeter 本身 OutOfMemory。 監聽器 (Listeners) 在正式壓測時,禁用或刪除所有 GUI 上的監聽器,如 “View Results Tree”、“Summary Report” 等。它們非常消耗資源。測試結束後,再用 results.jtl 檔來產生報告。 思考時間 (Think Time) 在請求之間加入合理的思考時間 (e.g., Uniform Random Timer),模擬真實用戶行為。完全沒有思考時間的壓測會對伺服器造成不切實際的瞬間衝擊,可能無法反映真實場景的效能瓶頸。 分散式壓測 如果單台 JMeter 機器無法產生足夠的壓力(CPU/網路滿載),應考慮使用主從式 (Master-Slave) 的分散式架構來發動壓測。 第二層:作業系統 (AIX) AIX 有其獨特的監控與調校工具,是穩定運行的基礎。 ...

October 31, 2025 · 7 min · 1478 words · Eric Cheng

安全程式碼指引

安全程式碼指引 企業標準技術白皮書|版本 v3.0|2026-10-08 適用範圍:以 Java/Spring Boot、Python、Node.js 為後端,以 Vue、Angular、React、HTML 與 Tailwind CSS 為前端,以 PostgreSQL、Oracle、SQL Server、Db2 為資料庫(含預存程序)的企業應用系統。本指引規範「寫程式時」必須做到的安全要求:每一條規則都說明要寫成什麼樣子、附有正確與錯誤的範例,並說明審查者要用什麼工具或方法確認。 v3.0 全面改寫 v2.0:依 OWASP Top 10:2025、OWASP ASVS 5.0、OWASP API Security Top 10 2023、OWASP Top 10 for LLM Applications 2025、CWE Top 25(2025)、NIST SP 800-218 SSDF、NIST SP 800-63B-4、ISO/IEC 27002:2022 等國際標準重新組織內容。每條規則都附有範例與「驗證方式」,每節結尾都有「🔍 審查與驗證」,讓審查者能判斷 AI 或同事產出的程式碼是否安全。範例均經工具實測(見 附錄 F)。威脅建模與安全架構請見 架構設計指引 與 系統設計指引,安全測試的規劃請見 測試與品質保證指引;本文聚焦在「程式碼層級」。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術基準版本 0.3 規範等級與規則格式 0.4 與其他指引的關係 0.5 如何閱讀本指引 0.6 例外與豁免流程 1. 安全開發生命週期與國際標準 1.1 國際標準與本指引的對應 1.2 安全開發流程:在哪裡發現問題 1.3 依風險選定 ASVS 等級 1.4 AI 輔助開發的責任 2. 通用安全原則 2.1 最小權限與預設拒絕 2.2 輸入驗證 2.3 輸出編碼 2.4 失敗安全與資源上限 2.5 業務邏輯與並行安全 3. 身分驗證與工作階段 3.1 密碼儲存與密碼政策 3.2 多因子驗證與通行金鑰 3.3 工作階段(Session)管理 3.4 權杖、JWT 與 OAuth 2.0 3.5 帳號復原與重設密碼 4. 存取控制 4.1 物件層級授權 4.2 功能層級與屬性層級授權 4.3 多租戶隔離 4.4 授權測試 5. 密碼學與秘密管理 5.1 演算法與模式的選擇 5.2 安全亂數 5.3 金鑰與秘密管理 5.4 傳輸層安全(TLS) 5.5 密碼敏捷性與後量子遷移 6. Java/Spring Boot 6.1 命令、運算式與 LDAP 注入 6.2 不安全的反序列化 6.3 XML 外部實體(XXE) 6.4 Spring Boot 的安全設定 7. Python 7.1 命令執行與動態程式碼 7.2 反序列化、XML 與正規表示式 7.3 Web 框架與網路存取 8. JavaScript/TypeScript/Node.js 8.1 命令、動態程式碼與路徑 8.2 原型污染與正規表示式阻斷服務 8.3 TypeScript 的型別不是驗證 8.4 Node.js 伺服器設定 9. 前端框架與瀏覽器安全 9.1 HTML 與瀏覽器安全機制 9.2 Vue 9.3 Angular 9.4 React 9.5 Tailwind CSS 10. SQL 與資料存取 10.1 參數化查詢 10.2 識別字、排序與 LIKE 10.3 查詢資源與其他查詢語言 11. 預存程序 11.1 預存程序中的動態 SQL 11.2 執行權限與最小權限 11.3 錯誤處理、稽核與危險功能 12. API 安全 12.1 OWASP API Security Top 10 對照 12.2 輸入、輸出與錯誤格式 12.3 敏感業務流程與第三方 API 12.4 速率限制 12.5 GraphQL 與 WebSocket 13. 檔案、壓縮檔與外部資源 13.1 檔案上傳 13.2 路徑穿越與壓縮檔 13.3 伺服器端請求偽造(SSRF) 14. 安全記錄與錯誤處理 14.1 安全事件記錄 14.2 例外處理與失敗安全 15. 相依套件與軟體供應鏈 15.1 相依套件的弱點與鎖定 15.2 新增相依套件與安裝腳本 15.3 CI/CD 管線與建置產物 16. AI/LLM 應用與 AI 產生的程式碼 16.1 LLM 應用的安全 16.2 AI 程式碼助理與代理的使用 17. 設定與部署相關的程式碼 17.1 HTTP 安全標頭 17.2 環境設定與預設值 17.3 容器與 Kubernetes 清單 18. 國際標準對照 18.1 OWASP Top 10:2025 18.2 OWASP ASVS 5.0 18.3 CWE Top 25(2025) 18.4 其他標準與法規 19. 常見錯誤與反例 19.1 密碼與憑證處理錯誤 19.2 SQL 查詢錯誤 19.3 檔案上傳錯誤 19.4 前端 XSS 錯誤 19.5 權限控制錯誤 19.6 API 設計錯誤 19.7 配置錯誤 20. 審查流程與檢查清單 20.1 每日開發檢查項目 20.2 Pull Request 檢查項目 20.3 部署前檢查項目 20.4 AI 產出的審查流程 20.5 弱點與資安事件的開發者責任 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 工具設定 B.1 Semgrep 自訂規則 B.2 SpotBugs+FindSecBugs(Maven) B.3 ESLint(TypeScript、React、Vue) B.4 Bandit 與 Ruff(Python) B.5 Spectral(OpenAPI 契約) B.6 GitHub Actions、容器與秘密掃描 B.7 規則與工具對照 附錄 C 術語表 附錄 D 參考資料 D.1 國際標準與框架 D.2 語言與框架的官方安全文件 D.3 工具 D.4 學習資源 D.5 公司內部資源 附錄 E v2.0 與 v3.0 章節對照 附錄 F 修訂紀錄與查證紀錄 F.1 v2.0 的錯誤與修正 F.2 範例與工具的實測紀錄 F.3 待追蹤事項 F.4 版本紀錄 0. 文件資訊 0.1 文件目的與讀者 撰寫安全的程式碼是每位開發者的基本職責。資安事件的根源多半不是高深的攻擊手法,而是可以預防的寫作錯誤:字串串接的 SQL、沒有檢查擁有者的查詢、寫死在程式碼裡的金鑰、直接輸出到頁面的使用者輸入。2025 年版 CWE Top 25 的前四名依序是跨站腳本(CWE-79)、SQL 注入(CWE-89)、跨站請求偽造(CWE-352)與缺少授權檢查(CWE-862),全部都能在寫程式與審查程式時發現並避免。 ...

October 31, 2025 · 134 min · 28515 words · Eric Cheng

後端開發指引

後端開發指引 企業標準技術白皮書|版本 v2.0|2026-10-09 適用範圍:以 Java 25 與 Spring Boot 4.1 開發的企業後端服務(REST API、批次、訊息消費者)。內容涵蓋分層與模組化、專案結構、命名、Java 語言慣例、API 設計、錯誤處理、輸入驗證、資料存取、交易、安全實作、外部整合、訊息、非同步與排程、快取、效能、可觀測性、設定、國際化、API 文件、測試、建置交付,以及如何審查 AI 產生的後端程式碼。 v2.0 全面改寫 v1:技術基準由 Spring Boot 3.2/Java 17 更新為 Spring Boot 4.1.1/Java 25,移除已停止維護的 Spring Cloud Sleuth、RestTemplate 與 jjwt 自行簽發權杖等做法,並依 RFC 9457、RFC 9110、OpenAPI 3.1、OWASP ASVS 5.0、OWASP API Security Top 10 2023、NIST SP 800-218 SSDF 等國際標準重新整理。每條規則都有編號、範例與「驗證方式」,每節結尾都有「🔍 審查與驗證」,讓審查者能判斷 AI 或同事產出的程式碼是否正確。所有 Java 範例都在 JDK 25 + Spring Boot 4.1.1 實際編譯並執行測試(見 附錄 F)。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術基準版本 0.3 規範等級與規則格式 0.4 與其他指引的關係 0.5 如何閱讀本指引 0.6 例外與豁免 0.7 範例專案與如何自行驗證 1. 分層與模組化 1.1 分層架構與依賴方向 1.2 以功能切分模組與模組邊界 1.3 以測試驗證架構規則 1.4 依賴注入與元件設計 2. 專案結構與版本控制 2.1 Maven 專案目錄結構 2.2 資源檔與設定檔配置 2.3 版本控制、分支與提交訊息 3. 命名規範 3.1 套件與類別命名 3.2 方法與變數命名 3.3 API、JSON 與資料庫命名 4. Java 語言慣例 4.1 Record、不可變物件與值物件 4.2 Null 處理與 Optional 4.3 列舉、sealed 類型與 switch 4.4 Lombok 與程式碼產生 4.5 虛擬執行緒與並行 5. REST API 設計與實作 5.1 資源、URL 與 HTTP 方法 5.2 請求與回應格式 5.3 分頁、排序與篩選 5.4 API 版本管理與棄用 5.5 冪等與並行控制 5.6 Controller 的責任 6. 錯誤處理 6.1 錯誤回應格式(RFC 9457 Problem Details) 6.2 例外階層與錯誤碼 6.3 全域例外處理器 6.4 例外的捕捉、轉換與傳遞 7. 輸入驗證 7.1 Bean Validation 基本規則 7.2 自訂約束與跨欄位驗證 7.3 業務規則驗證放在領域層 7.4 輸出編碼而非輸入淨化 8. 資料存取 8.1 實體設計 8.2 Repository 與查詢 8.3 N+1 查詢與抓取策略 8.4 大量資料、鍵集分頁與批次寫入 8.5 資料庫遷移 8.6 連線池 9. 交易管理 9.1 交易邊界 9.2 交易中的外部呼叫與事件 9.3 傳播、隔離與鎖定 9.4 資料庫與訊息的一致性(交易性發件匣) 10. 安全實作 10.1 安全過濾鏈與預設拒絕 10.2 身分驗證:OAuth 2.0 資源伺服器 10.3 授權:功能層級與物件層級 10.4 密碼與敏感資料 10.5 CORS、限流與 SSRF 11. 外部整合與韌性 11.1 HTTP 用戶端 11.2 重試與逾時預算 11.3 斷路器與隔艙 12. 訊息與事件 12.1 事件設計 12.2 發送事件 12.3 消費事件:冪等、重試與死信 12.4 訊息的測試 13. 非同步、批次與排程 13.1 非同步執行 13.2 排程與分散式鎖 13.3 批次處理與優雅關閉 14. 快取 14.1 快取的使用時機、鍵與存活時間 14.2 Spring Cache 與 Redis 14.3 快取擊穿、穿透與雪崩 15. 效能與擴展性 15.1 效能目標與量測 15.2 無狀態與水平擴展 15.3 大量資料的串流輸出 15.4 過載保護 15.5 JVM 與容器 16. 日誌與可觀測性 16.1 日誌框架與結構化日誌 16.2 日誌內容:記什麼、不記什麼 16.3 指標 16.4 分散式追蹤 16.5 健康檢查與 Actuator 17. 設定與機密管理 17.1 設定外部化與 Profile 17.2 型別安全的設定類別 17.3 機密管理 17.4 功能開關 18. 國際化與時區 18.1 訊息國際化 18.2 時間與時區 18.3 與語系有關的文字處理 19. API 文件與契約 19.1 OpenAPI 文件的產生 19.2 契約納入版本控制與一致性檢查 19.3 破壞性變更偵測 20. 後端測試 20.1 測試的層次 20.2 Web 層測試 20.3 整合測試與 Testcontainers 20.4 穩定的測試 20.5 覆蓋率與變異測試 21. 建置、相依與交付 21.1 相依管理 21.2 軟體物料清單與可重現建置 21.3 CI 管線 21.4 容器映像 21.5 應用程式在部署與復原中的責任 21.6 從 Spring Boot 3.5 遷移到 4.x 22. AI 協作與審查 22.1 AI 產出的審查流程 22.2 給 AI 的專案規範 22.3 AI 常見錯誤對照表 22.4 審查實例 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 審查檢核清單 B.1 後端 Pull Request 審查清單 B.2 Pull Request 範本 附錄 C 工具設定 C.1 pom.xml C.2 Checkstyle C.3 Error Prone 在 JDK 25 的 JVM 參數 C.4 專案慣例的 ArchUnit 規則 C.5 Semgrep 自訂規則 C.6 SpotBugs 排除設定 附錄 D 名詞解釋 附錄 E 參考資料 E.1 國際標準與規範 E.2 框架與工具文件 E.3 本系列相關指引 附錄 F 修訂紀錄與查證紀錄 F.1 v1 章節對照 F.2 v1 的更正紀錄 F.3 查證紀錄 F.4 待確認事項 F.5 版本歷史 0. 文件資訊 0.1 文件目的與讀者 本指引定義後端程式的實作標準:在架構與詳細設計決定之後,後端工程師要怎麼把服務寫出來,寫到什麼程度才算合格,以及審查者要怎麼驗證。它回答的問題是「這個 Controller、Service、Repository、設定檔應該長什麼樣子」。 ...

October 31, 2025 · 134 min · 28415 words · Eric Cheng

架構設計指引

系統架構設計指引 企業標準技術白皮書|版本 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 文件目的與讀者 本指引定義企業應用系統的架構決策標準:哪些事情必須這樣做、為什麼、做到什麼程度才算合格,以及如何驗證。它回答的是「系統應該長什麼樣子」,而不是「某一行程式碼怎麼寫」。程式碼層級的規範請見 程式寫作指引。 ...

October 31, 2025 · 131 min · 27770 words · Eric Cheng

測試與品質保證指引

測試與品質保證指引 企業標準技術白皮書|版本 v2.0|2026-10-08 適用範圍:以 Java / Spring Boot 為後端、以 Web 前端為使用介面的企業應用系統,從需求到上線後的完整測試與品質保證活動。內容涵蓋 QA 治理、測試策略與流程、測試設計技術、單元/整合/API/契約/微服務/E2E/跨瀏覽器/無障礙/效能/安全測試、測試資料與環境、CI/CD 品質閘門、靜態測試、缺陷管理、品質指標、驗收與發布、AI 輔助測試與持續改進。 v2.0 全面改寫 v1(2025-08-27):依 ISO/IEC/IEEE 29119 系列、ISTQB CTFL 4.0.1、ISO/IEC 25010:2023、ISO/IEC 20246:2017、OWASP Top 10:2025、OWASP ASVS 5.0、WCAG 2.2、ISO/IEC TS 42119-2:2025 等國際標準重新組織內容。每條規則都附有範例與「驗證方式」,每節結尾都有「🔍 審查與驗證」,讓審查者能判斷 AI 或同事產出的測試是否正確。範例均經工具實測(見 附錄 F)。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術基準版本 0.3 規範等級與規則格式 0.4 與其他指引的關係 0.5 如何使用本指引審查 AI 產出 0.6 例外與豁免 1. 品質保證治理與角色 1.1 品質保證、品質控制與測試 1.2 角色與責任 1.3 測試獨立性 1.4 品質目標與品質模型 2. 測試原則與策略 2.1 測試的七項原則 2.2 風險導向測試 2.3 測試層級與測試類型 2.4 測試組合:金字塔、獎盃與蜂巢 2.5 左移與右移 2.6 測試方法:TDD、BDD、ATDD 與探索式測試 3. 測試流程、計畫與監控 3.1 測試流程模型 3.2 測試計畫 3.3 進入、退出、暫停與恢復準則 3.4 測試估算 3.5 測試監控與控制 3.6 測試完成與測試完成報告 4. 測試設計技術 4.1 等價類劃分 4.2 邊界值分析 4.3 決策表 4.4 狀態轉移測試 4.5 組合測試與分類樹 4.6 白箱覆蓋與性質測試 4.7 經驗導向技術與探索式測試 4.8 選擇測試設計技術 5. 測試案例、追溯與 BDD 5.1 測試案例的結構 5.2 需求追溯 5.3 驗收條件與 BDD 5.4 關鍵字驅動測試 5.5 測試案例的維護 6. 單元測試 6.1 單元的範圍與 FIRST 原則 6.2 結構與命名 6.3 斷言 6.4 測試替身 6.5 參數化測試 6.6 測試的穩定性與隔離 7. 整合與元件測試 7.1 整合測試的範圍與分流 7.2 Spring Boot 4 的測試切片 7.3 以 Testcontainers 測試資料庫 7.4 以 WireMock 測試外部 HTTP 服務 7.5 測試資料的隔離與清理 8. API 與契約測試 8.1 API 測試的範圍 8.2 Web 層的驗證與錯誤格式測試 8.3 服務層級的 API 測試 8.4 消費者驅動的契約測試 8.5 API 規格的相容性檢查 9. 微服務、事件與韌性測試 9.1 微服務的測試策略 9.2 非同步訊息的測試 9.3 並行與資料一致性 9.4 韌性測試與混沌工程 10. 端到端與 UI 測試 10.1 E2E 測試的範圍 10.2 Playwright 的設定 10.3 定位器、斷言與等待 10.4 視覺回歸測試 11. 跨瀏覽器、行動與無障礙測試 11.1 支援矩陣 11.2 行動裝置與響應式測試 11.3 雲端測試服務 11.4 無障礙測試 12. 效能測試 12.1 效能測試的類型與時機 12.2 效能需求與工作負載模型 12.3 以 k6 撰寫負載測試 12.4 效能測試環境與執行 12.5 結果分析與報告 12.6 元件層級的基準測試與 JVM 設定 13. 安全測試 13.1 安全測試的類型與管線位置 13.2 依 OWASP Top 10:2025 規劃測試 13.3 認證與授權測試 13.4 注入與加密的驗證 13.5 濫用案例、安全記錄與滲透測試 14. 測試資料與隱私保護 14.1 測試資料策略 14.2 合成資料與 Test Data Builder 14.3 遮罩與去識別化 14.4 測試資料的生命週期與法規遵循 15. 測試環境與服務虛擬化 15.1 環境層級與一致性 15.2 以容器建立可重現的本機與 CI 環境 15.3 服務虛擬化 15.4 環境就緒與冒煙測試 16. 自動化架構與 CI/CD 品質閘門 16.1 測試自動化架構 16.2 流水線中的測試分層 16.3 品質閘門 16.4 不穩定測試的管理 16.5 執行效率 17. 靜態測試與審查 17.1 審查的類型與流程 17.2 需求的可測試性審查 17.3 程式碼審查 17.4 靜態分析 17.5 審查的量測與改進 18. 缺陷管理 18.1 缺陷生命週期 18.2 嚴重度與優先度 18.3 缺陷報告 18.4 分級會議 18.5 根本原因分析與缺陷預防 19. 品質量測與指標 19.1 指標的設計原則 19.2 覆蓋率與變異測試 19.3 缺陷相關指標 19.4 交付績效:DORA 指標 19.5 測試執行指標與報告 19.6 品質儀表板 20. 驗收、回歸與發布 20.1 驗收測試的種類 20.2 使用者驗收測試 20.3 回歸測試策略 20.4 發布就緒與上線後驗證 20.5 緊急修正 21. 其他非功能品質測試 21.1 可靠性與服務水準目標 21.2 災難復原與備份還原演練 21.3 相容性與升級測試 21.4 互動能力(可用性)測試 21.5 資料轉置與平行測試 21.6 可維護性與彈性 22. AI 輔助測試與 AI 系統測試 22.1 AI 在測試中的角色與風險 22.2 審查 AI 產生的測試 22.3 AI 輔助測試的治理 22.4 測試含有 AI 的系統 23. 成本效益、能力發展與持續改進 23.1 品質成本與測試投資 23.2 自動化的投資決策 23.3 測試流程改進 23.4 團隊協作與溝通 23.5 能力發展與新進成員 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 測試與品質審查檢核清單 B.1 需求可測試性檢核 B.2 測試策略與測試計畫檢核 B.3 測試程式審查檢核(含 AI 產出) B.4 發布就緒檢核 B.5 正式環境事件處理檢核 B.6 開發階段檢核 附錄 C 範本與工具 C.1 文件範本 C.2 本指引提供的設定與腳本 附錄 D 術語表 附錄 E 參考資料 E.1 國際標準與知識體系 E.2 安全、無障礙與法規 E.3 工具文件 附錄 F 修訂紀錄與查證紀錄 F.1 v1 與 v2 章節對照 F.2 v1 內容更正 F.3 查證紀錄 F.4 待查證與後續事項 F.5 版本紀錄 0. 文件資訊 0.1 文件目的與讀者 本指引是企業內部的測試與品質保證標準,目的有三: ...

October 31, 2025 · 136 min · 28863 words · Eric Cheng

程式寫作指引

程式寫作指引 企業標準技術白皮書|版本 v2.1|2026-10-06 適用範圍:Java / Spring Boot、TypeScript、HTML、CSS / Tailwind CSS、Vue、Angular、React、SQL 與 Stored Procedure(Oracle、SQL Server、PostgreSQL)之程式撰寫。 v2.1 為每條規則加上「驗證方式」與程式碼範例,並在每個規則小節提供「🔍 審查與驗證」,讓審查者能判斷 AI 或同事產出的程式碼是否符合規範;所有工具設定與宣稱都經過實測(見 附錄 D)。v2.1 的修正見 附錄 C.3,舊版(v1.x)各章去向見 附錄 C.2。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術基準版本 0.3 規範等級定義 0.4 規範例外與豁免流程 0.5 與其他指引的關係 0.6 如何閱讀本指引 1. 前言與核心原則 1.1 為什麼需要程式寫作標準 1.2 七項核心原則 1.3 規範優先順序 2. 通用寫作原則 2.1 命名原則 2.2 函式與類別設計 2.3 SOLID 與常見設計守則 2.4 不可變性與副作用 2.5 魔術數字與設定外部化 2.6 檔案格式與 EditorConfig 2.7 程式碼異味速查 3. Java 寫作規範 3.1 原始檔結構與格式 3.2 命名規範 3.3 現代語言特性(Java 17–25) 3.4 var 使用界線 3.5 Null 處理與 JSpecify 3.6 集合、Stream 與 Lambda 3.7 金額、時間與字串 3.8 並行與 Virtual Threads 3.9 資源管理與例外 3.10 類別設計 3.11 實務注意事項 4. Spring Boot 程式碼慣例 4.1 Spring Boot 4 的重要變化 4.2 依賴注入 4.3 設定與 @ConfigurationProperties 4.4 Web 層:Controller、驗證與 ProblemDetail 4.5 HTTP 客戶端 4.6 API Versioning 4.7 交易管理 4.8 Spring Data JPA 寫法 4.9 實務注意事項 5. TypeScript 寫作規範 5.1 版本策略:TypeScript 6.0 與 7.0 5.2 tsconfig 標準設定 5.3 型別系統 5.4 Enum 與常數 5.5 命名規範 5.6 函式、非同步與錯誤處理 5.7 模組與匯入 5.8 新語言特性採用建議 5.9 實務注意事項 6. HTML 寫作規範 6.1 文件結構與格式 6.2 語意化標籤 6.3 表單 6.4 圖片與多媒體 6.5 無障礙(WCAG 2.2 AA)重點 6.6 安全相關屬性 7. CSS 與 Tailwind CSS 寫作規範 7.1 樣式方案選擇 7.2 CSS 撰寫規則 7.3 Tailwind CSS v4 設定(CSS-first) 7.4 Tailwind 使用規則 7.5 Tailwind v4 版本差異與遷移要點 8. Vue 3 寫作規範 8.1 基本原則與 API 選擇 8.2 命名與檔案(Style Guide A / B) 8.3 Props、Emits 與 v-model 8.4 樣板規則 8.5 響應式與 Composables 8.6 Pinia 狀態管理 8.7 樣式(Style Guide A / D) 8.8 Vue 實務注意事項 9. Angular 寫作規範 9.1 Angular 22 的重要變化 9.2 命名與專案結構 9.3 元件撰寫 9.4 樣板規則 9.5 Service、DI 與 HTTP 9.6 表單:Signal Forms 9.7 Angular 實務注意事項 10. React 寫作規範 10.1 Rules of React(必須遵守) 10.2 元件撰寫 10.3 Hooks 與 Effect 10.4 React Compiler 與記憶化 10.5 Server Components、Actions 與表單 10.6 狀態管理 10.7 React 19.x 新功能採用建議 10.8 React 實務注意事項 11. SQL 撰寫規範 11.1 格式規範 11.2 命名規範 11.3 參數化查詢與動態 SQL 11.4 查詢撰寫 11.5 分頁 11.6 NULL、型別與字元集 11.7 交易與鎖定 11.8 方言對照表 11.9 資料庫變更腳本(Migration) 12. Stored Procedure 撰寫規範 12.1 何時使用 Stored Procedure 12.2 命名與結構 12.3 錯誤處理與交易 12.4 安全與動態 SQL 12.5 效能 12.6 Oracle PL/SQL 標準範本 12.7 SQL Server T-SQL 標準範本 12.8 PostgreSQL PL/pgSQL 標準範本 12.9 SP 的測試與審查 13. 註解與文件 13.1 註解原則 13.2 JavaDoc 13.3 TSDoc / JSDoc 13.4 前端元件文件 13.5 API 文件(OpenAPI) 13.6 專案文件 14. 錯誤處理與日誌 14.1 例外設計(Java) 14.2 前端錯誤處理 14.3 日誌規範 14.4 可觀測性 15. 測試程式寫作 15.1 通用原則 15.2 Java 測試(JUnit 6) 15.3 前端測試(Vitest / Testing Library / Playwright) 16. 安全寫作要點 16.1 OWASP Top 10:2025 對照 16.2 秘密管理 16.3 注入攻擊防護 16.4 XSS 與輸出編碼 16.5 存取控制 16.6 認證與工作階段 16.7 加密 16.8 安全設定 16.9 軟體供應鏈 16.10 OWASP ASVS 5.0 對照 17. 效能寫作要點 17.1 後端(Java / Spring) 17.2 前端 17.3 資料庫 18. 版本控制與 Code Review 18.1 分支策略 18.2 Commit 規範(Conventional Commits) 18.3 Pull Request 規範 18.4 .gitignore 與儲存庫衛生 19. 工具鏈與自動化 19.1 工具總覽 19.2 Java 工具鏈 19.3 TypeScript / 前端工具鏈 19.4 SQL 工具鏈 19.5 Git Hooks 19.6 CI 品質門檻 20. AI 輔助開發寫作規範 20.1 基本立場 20.2 使用規範 20.3 專案指令檔 20.4 AI 產出的審查與風險 21. 檢查清單 21.1 通用(所有 PR) 21.2 Java / Spring Boot 21.3 前端(TypeScript / Vue / Angular / React) 21.4 HTML 與無障礙 21.5 SQL 與 Stored Procedure 附錄 A 規則速查表 A.1 依領域統計 A.2 規則索引 A.3 驗證方式與範例覆蓋統計 附錄 B 參考資源 B.1 官方風格指引與規範 B.2 安全 B.3 工具 B.4 同系列指引 附錄 C 版本紀錄 C.1 版本歷程 C.2 v1.x → v2.0 修正與去向對照 C.3 v2.0 → v2.1 修正 附錄 D 查證紀錄 D.1 查證範圍與方法 D.2 版本查證 D.3 範例實測結果 D.4 實測中發現並修正的問題 D.5 待確認項目 附錄 E 術語表 0. 文件資訊 0.1 文件目的與讀者 本指引是企業內部的程式撰寫標準(Coding Standard),用來回答「程式碼應該怎麼寫」。它不負責系統架構、部署流程或專案管理,那些主題由其他指引處理(見 0.5)。 ...

October 31, 2025 · 177 min · 37663 words · Eric Cheng

系統架構設計範本

系統架構設計範本 Prompt 目標 指導 AI 進行完整的系統架構設計,產生技術架構文檔和設計決策說明。 角色設定 你是一位資深系統架構師,具備豐富的大型系統設計經驗,熟悉各種架構模式、設計原則和最佳實務。 任務描述 請協助我完成 {專案名稱} 的系統架構設計工作。 專案技術背景 專案名稱: {填入專案名稱} 系統類型: {填入系統類型,如:Web應用、微服務、分散式系統} 預期使用者規模: {填入使用者數量級,如:1000、10萬、100萬} 效能要求: {填入關鍵效能指標} 技術棧偏好: {填入偏好的技術棧,如:Java/Spring、.NET、Python/Django} 部署環境: {填入部署方式,如:雲端、地端、混合雲} 架構設計要求 請按照以下結構進行系統架構設計: 1. 系統概覽 系統邊界定義 主要組件識別 系統上下文圖 利害關係人視圖 2. 架構風格選擇 架構風格評估 設計原則定義 品質屬性分析 技術決策記錄 3. 邏輯架構設計 分層架構設計 組件劃分 介面定義 資料流設計 4. 物理架構設計 部署拓撲 基礎設施規劃 網路設計 安全架構 5. 技術選型 框架和函式庫選擇 資料庫技術選型 中介軟體選擇 工具和平台決策 6. 品質屬性設計 可用性設計 效能最佳化 安全性設計 可維護性考量 輸出格式 # {專案名稱} 系統架構設計文檔 ## 1. 系統概覽 ### 1.1 系統目標 **主要目標:** [系統主要目標描述] **次要目標:** [次要目標列表] **成功標準:** [可測量的成功指標] ### 1.2 系統邊界 **包含範圍:** - [功能模組1] - [功能模組2] - [功能模組3] **排除範圍:** - [不包含的功能1] - [不包含的功能2] ### 1.3 系統上下文圖 [使用者] –> [系統] –> [外部系統A] | v [外部系統B] ...

October 31, 2025 · 4 min · 665 words · Eric Cheng

系統設計指引

專案系統設計指引 企業標準技術白皮書|版本 v2.0|2026-10-08 適用範圍:以 Java / Spring Boot 為後端、以 Web 前端為使用介面的企業應用系統,從系統分析文件(SAD)轉換為系統設計文件(SDD)的詳細設計階段。內容涵蓋設計流程與文件、物件導向與領域模型、元件與介面、資料、行為、錯誤處理、安全、整合與批次、非功能、部署、可測試性、國際化、法規遵循、使用者體驗、API 治理、設計演進與設計審查。 v2.0 全面改寫 v1.x:依 ISO/IEC/IEEE 12207:2026、ISO/IEC/IEEE 42010:2022、IEEE 1016-2009、ISO/IEC 25010:2023、OWASP Top 10:2025 等國際標準重新組織內容。每條規則都附有範例與「驗證方式」,每節結尾都有「🔍 審查與驗證」,讓審查者能判斷 AI 或同事產出的設計是否正確。範例均經工具實測(見 附錄 F)。架構層級的決策(架構風格、平台、維運)請見 架構設計指引,本文聚焦在「架構決定之後,如何把每個元件設計到可以開發、可以審查、可以驗證」。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術基準版本 0.3 規範等級與規則格式 0.4 與其他指引的關係 0.5 如何閱讀本指引 0.6 例外與豁免流程 1. 系統設計流程與國際標準 1.1 國際標準與設計流程 1.2 需求與設計的雙向追溯 1.3 設計替代方案與設計決策 1.4 設計審查 1.5 AI 輔助設計與人工審查 2. 系統設計文件與設計視圖 2.1 SDD 的結構與設計視點 2.2 設計圖表的繪製規範 2.3 文件即程式碼(Docs-as-Code) 2.4 文件維護 3. 物件導向設計原則 3.1 SOLID 原則 3.2 責任分配:GRASP 與迪米特法則 3.3 不可變性與型別設計 3.4 簡潔原則:KISS、YAGNI 與 DRY 4. 設計模式應用 4.1 模式的選用準則 4.2 結構與行為模式 4.3 應避免的反模式 5. 領域模型與戰術設計 5.1 通用語言與領域模型 5.2 聚合、實體與值物件 5.3 領域事件、儲存庫與領域服務 6. 分層與元件設計 6.1 分層與依賴方向 6.2 應用服務與交易邊界 6.3 資料傳輸物件與映射 6.4 元件規格與組態 7. 介面設計 7.1 介面清單 7.2 契約先行的 REST API 設計 7.3 冪等性設計 7.4 事件介面 7.5 內部埠介面與檔案介面 8. 資料設計 8.1 資料模型與資料字典 8.2 多資料庫支援與結構演進 8.3 物件關聯映射與資料存取 8.4 讀寫分離與資料分割 8.5 資料分級、加密、遮罩與保存 9. 行為與流程設計 9.1 互動設計:循序圖 9.2 狀態設計:狀態機 9.3 資料流設計 9.4 長流程、演算法與並行 10. 錯誤處理、交易與一致性 10.1 錯誤分類與錯誤碼 10.2 逾時與重試 10.3 交易邊界與資料一致性 11. 安全設計 11.1 威脅建模 11.2 身分驗證 11.3 授權 11.4 輸入處理與 API 保護 11.5 秘密管理、加密與稽核 11.6 安全標準對照與驗收 12. 整合、批次與檔案傳輸設計 12.1 企業整合模式 12.2 批次作業設計 12.3 排程設計 12.4 檔案傳輸設計 13. 非功能設計 13.1 從品質情境到設計手段 13.2 容量估算與延遲預算 13.3 快取設計 13.4 連線池、執行緒與並行上限 13.5 可觀測性設計 13.6 高可用與災難復原設計 13.7 永續性與智慧維運 14. 部署與執行環境設計 14.1 部署視圖與執行期設計 14.2 健康檢查、資源與生命週期 14.3 交付流程與部署策略 15. 可測試性與測試設計 15.1 每個設計元素的驗證方式 15.2 整合測試與測試資料 15.3 契約測試與驗收條件 15.4 效能測試設計 16. 國際化與地區化設計 16.1 文字與語系 16.2 時間、數字與幣別 16.3 字元編碼、多語系資料與排序 17. 法規遵循設計 17.1 合規需求盤點 17.2 個人資料保護設計 17.3 金融業與稽核要求 18. 使用者體驗與無障礙設計 18.1 無障礙設計 18.2 效能體驗與畫面狀態 19. API 治理與演進 19.1 API 生命週期與目錄 19.2 版本策略與破壞性變更 19.3 棄用與退場 20. 技術債與設計演進 20.1 技術債的登錄與分類 20.2 品質閘門與適應度函數 20.3 設計演進與決策更新 21. 交付物與設計審查 21.1 交付清單 21.2 審查角色與評分 21.3 審查發現與完工回填 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 設計審查檢核清單 B.1 流程與文件 B.2 物件、領域與元件 B.3 行為與錯誤 B.4 介面與資料 B.5 安全 B.6 非功能與部署 B.7 測試與演進 B.8 法規、國際化與無障礙 附錄 C 系統設計文件範本 C.1 SDD 章節範本 C.2 相關文件範本 C.3 SDD 章節檢查腳本 附錄 D 術語與縮寫 附錄 E 參考標準與資源 E.1 國際標準 E.2 IETF 規格 E.3 安全標準與資源 E.4 設計方法與規格 E.5 技術文件 E.6 台灣法規與主管機關 E.7 企業內部相關指引 附錄 F 修訂紀錄與查證紀錄 F.1 v1.x 章節去向對照 F.2 v1.x 主要更正 F.3 查證紀錄 F.4 待查項目 F.5 版本紀錄 結語 0. 文件資訊 0.1 文件目的與讀者 本指引定義系統詳細設計的標準:拿到系統分析文件(SAD)與架構決策之後,設計者要產出哪些設計、每項設計要做到什麼程度才算合格,以及審查者要如何驗證。它回答的是「每個元件、介面、資料與流程應該怎麼設計」,介於「系統應該長什麼樣子」(架構)與「某一行程式碼怎麼寫」(程式碼)之間。 ...

October 31, 2025 · 141 min · 29826 words · Eric Cheng

設計指引範本

設計指引範本 Prompt 目標 指導 AI 進行軟體設計,建立符合設計原則、易於維護且可擴展的軟體設計。 角色設定 你是一位資深軟體設計師,具備豐富的軟體設計經驗,熟悉設計模式、SOLID 原則和軟體工程最佳實務。 任務描述 請協助我完成 {專案名稱} 的軟體設計工作。 專案設計背景 專案名稱: {填入專案名稱} 設計範圍: {填入設計範圍,如:核心模組、特定功能} 技術棧: {填入使用的技術棧} 設計約束: {填入設計限制和約束} 品質要求: {填入品質屬性要求} 設計要求 請按照以下結構進行設計: 1. 領域建模 核心領域識別 實體和值物件設計 聚合設計 領域服務設計 2. 架構設計 分層架構設計 模組劃分 依賴關係設計 介面設計 3. 詳細設計 類別設計 方法設計 資料結構設計 演算法設計 4. 設計模式應用 創建型模式 結構型模式 行為型模式 架構模式 5. 設計原則遵循 SOLID 原則 DRY 原則 KISS 原則 YAGNI 原則 輸出格式 # {專案名稱} 軟體設計文件 ## 1. 設計概述 ### 1.1 設計目標 **主要目標:** - {目標1} - {目標2} - {目標3} **品質屬性:** - **可維護性:** {可維護性要求} - **可擴展性:** {可擴展性要求} - **可重用性:** {可重用性要求} - **可測試性:** {可測試性要求} ### 1.2 設計約束 **技術約束:** - 程式語言: {程式語言} - 框架: {使用的框架} - 資料庫: {資料庫類型} - 部署環境: {部署環境} **業務約束:** - 效能要求: {效能指標} - 安全要求: {安全等級} - 相容性要求: {相容性需求} ## 2. 領域建模 ### 2.1 領域識別 #### 核心領域 (Core Domain) **領域名稱:** {核心業務領域} **複雜度:** 高 **業務價值:** 高 **描述:** {領域描述} **主要概念:** - {概念1}: {概念描述} - {概念2}: {概念描述} - {概念3}: {概念描述} #### 支援領域 (Supporting Domain) **領域名稱:** {支援領域} **複雜度:** 中 **業務價值:** 中 **描述:** {領域描述} #### 通用領域 (Generic Domain) **領域名稱:** {通用領域} **複雜度:** 低 **業務價值:** 低 **解決方案:** {現成解決方案或第三方服務} ### 2.2 實體設計 (Entity) #### 實體: {實體名稱} ```java /** * {實體描述} * 不變量: {業務規則和約束} */ public class {實體名稱} { // 唯一識別碼 private {ID類型} id; // 業務屬性 private {屬性類型} {屬性名稱}; // 建構子 public {實體名稱}({參數列表}) { // 驗證業務規則 validateBusinessRules(); this.{屬性} = {值}; } // 業務方法 public {返回類型} {業務方法名稱}({參數列表}) { // 業務邏輯實作 return {結果}; } // 不變量驗證 private void validateBusinessRules() { if ({條件}) { throw new {例外類型}("{錯誤訊息}"); } } // equals 和 hashCode 基於 ID @Override public boolean equals(Object obj) { if (this == obj) return true; if (!(obj instanceof {實體名稱})) return false; {實體名稱} other = ({實體名稱}) obj; return Objects.equals(id, other.id); } @Override public int hashCode() { return Objects.hash(id); } } 2.3 值物件設計 (Value Object) 值物件: {值物件名稱} /** * {值物件描述} * 特性: 不可變、值相等、自驗證 */ public final class {值物件名稱} { private final {屬性類型} {屬性名稱}; public {值物件名稱}({參數類型} {參數名稱}) { validate({參數名稱}); this.{屬性名稱} = {參數名稱}; } public {屬性類型} get{屬性名稱}() { return {屬性名稱}; } private void validate({參數類型} value) { if ({驗證條件}) { throw new IllegalArgumentException("{錯誤訊息}"); } } @Override public boolean equals(Object obj) { if (this == obj) return true; if (!(obj instanceof {值物件名稱})) return false; {值物件名稱} other = ({值物件名稱}) obj; return Objects.equals({屬性名稱}, other.{屬性名稱}); } @Override public int hashCode() { return Objects.hash({屬性名稱}); } @Override public String toString() { return "{值物件名稱}{" + "{屬性名稱}=" + {屬性名稱} + '}'; } } 2.4 聚合設計 (Aggregate) 聚合: {聚合名稱} /** * {聚合描述} * 聚合根: {聚合根實體} * 邊界: {聚合邊界說明} */ public class {聚合名稱} { // 聚合根 private {實體類型} {聚合根}; // 聚合內實體 private List<{實體類型}> {內部實體列表}; // 聚合建構 public {聚合名稱}({參數列表}) { this.{聚合根} = new {實體類型}({參數}); this.{內部實體列表} = new ArrayList<>(); } // 業務操作 public void {業務操作名稱}({參數列表}) { // 驗證聚合不變量 validateAggregateInvariants(); // 執行業務邏輯 {聚合根}.{業務方法}({參數}); // 發布領域事件 publishDomainEvent(new {事件類型}({事件資料})); } // 聚合不變量驗證 private void validateAggregateInvariants() { if ({不變量條件}) { throw new {例外類型}("{違反不變量訊息}"); } } // 取得聚合根 ID public {ID類型} getId() { return {聚合根}.getId(); } } 2.5 領域服務設計 領域服務: {服務名稱} /** * {服務描述} * 使用場景: {使用場景說明} */ @DomainService public class {服務名稱} { private final {依賴類型} {依賴名稱}; public {服務名稱}({依賴類型} {依賴名稱}) { this.{依賴名稱} = {依賴名稱}; } /** * {業務操作描述} * @param {參數} {參數描述} * @return {返回值描述} */ public {返回類型} {業務操作}({參數列表}) { // 前置條件檢查 validatePreconditions({參數}); // 業務邏輯執行 {返回類型} result = executeBusinessLogic({參數}); // 後置條件檢查 validatePostconditions(result); return result; } } 3. 架構設計 3.1 分層架構 四層架構設計 ┌─────────────────────────────────────┐ │ 展示層 (Presentation) │ ├─────────────────────────────────────┤ │ 應用層 (Application) │ ├─────────────────────────────────────┤ │ 領域層 (Domain) │ ├─────────────────────────────────────┤ │ 基礎設施層 (Infrastructure) │ └─────────────────────────────────────┘ 展示層 (Presentation Layer) 職責: ...

October 31, 2025 · 13 min · 2739 words · Eric Cheng

資料庫設計指引

銀行大型共用平台 - 資料庫設計指引 企業標準技術白皮書 v3.0|適用於 Oracle、IBM Db2、Microsoft SQL Server、PostgreSQL 四種關聯式資料庫的實體設計與維運。本文共 185 條規則,每條規則都附有驗證方式與 ✅/❌ 範例,讓人能夠審查並驗證 AI 依本指引產出的 DDL 與 SQL。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術基準版本 0.3 規範等級與規則格式 0.4 範例慣例與如何執行範例 0.5 與其他指引的關係 0.6 例外與豁免流程 0.7 如何閱讀本指引 1. 設計流程與國際標準 1.1 三層資料模型 1.2 資料元素命名與定義(ISO/IEC 11179) 1.3 業務邏輯的位置 1.4 引用的國際標準與框架 1.5 審查重點與 AI 常見錯誤 2. 命名規範 2.1 識別字的字元、大小寫與長度 2.2 物件命名格式 2.3 欄位命名 2.4 縮寫與詞彙表 2.5 審查重點與 AI 常見錯誤 3. 資料型別與欄位設計 3.1 金額與數值 3.2 日期與時間 3.3 字元集與字串長度 3.4 布林、代碼與列舉 3.5 NULL、預設值與魔術值 3.6 半結構化資料(JSON) 3.7 審查重點與 AI 常見錯誤 4. 鍵與限制條件 4.1 主鍵與代理鍵 4.2 UUID 主鍵 4.3 外鍵 4.4 檢查限制條件與條件式唯一 4.5 未驗證的限制條件與可延遲限制條件 4.6 審查重點與 AI 常見錯誤 5. 正規化與反正規化 5.1 正規化原則 5.2 反正規化 5.3 審查重點與 AI 常見錯誤 6. 索引設計 6.1 索引設計原則 6.2 覆蓋索引與運算式索引 6.3 線上建立索引 6.4 索引維護與未使用索引 6.5 審查重點與 AI 常見錯誤 7. 交易、隔離等級與並行控制 7.1 交易邊界與隔離等級 7.2 遺失更新與樂觀鎖 7.3 鎖定、重試與工作佇列 7.4 冪等與批次交易 7.5 審查重點與 AI 常見錯誤 8. SQL 撰寫與查詢效能 8.1 安全與可維護的 SQL 8.2 讓查詢能使用索引 8.3 分頁與排序 8.4 執行計畫審查 8.5 審查重點與 AI 常見錯誤 9. 分區與分片 9.1 何時使用分區 9.2 分區鍵與分區修剪 9.3 分區維護與資料清除 9.4 分片 9.5 審查重點與 AI 常見錯誤 10. 時態資料、歷程與稽核欄位 10.1 稽核欄位 10.2 系統時間:自動保存歷程 10.3 業務時間:有效期間 10.4 軟刪除 10.5 審查重點與 AI 常見錯誤 11. 資料安全 11.1 帳號、角色與最小權限 11.2 連線與傳輸加密 11.3 靜態加密與欄位加密 11.4 資料遮蔽 11.5 資料列層級安全 11.6 稽核 11.7 密碼、機密與組態強化 11.8 審查重點與 AI 常見錯誤 12. Schema 變更與版本控管 12.1 Migration 管理 12.2 向後相容的變更:expand/contract 12.3 線上 DDL 與鎖 12.4 回復計畫與變更流程 12.5 審查重點與 AI 常見錯誤 13. 多租戶設計 13.1 隔離模式的選擇 13.2 共用 schema 的資料隔離 13.3 資源隔離與租戶生命週期 13.4 審查重點與 AI 常見錯誤 14. 高可用、備份與災難復原 14.1 復原目標與備份策略 14.2 備份驗證與還原演練 14.3 高可用架構 14.4 審查重點與 AI 常見錯誤 15. 容量規劃與資料生命週期 15.1 容量估算 15.2 空間監控與自動擴充 15.3 保存期限與資料清除 15.4 審查重點與 AI 常見錯誤 16. 監控與日常維運 16.1 監控指標與告警 16.2 慢查詢與查詢統計 16.3 鎖、阻擋與長時間交易 16.4 統計資訊與索引維護 16.5 日誌、可觀測性與連線池 16.6 審查重點與 AI 常見錯誤 17. 測試與驗證 17.1 以真實資料庫進行整合測試 17.2 並行測試 17.3 效能測試 17.4 資料一致性檢查 17.5 審查重點與 AI 常見錯誤 18. 雲端與 DevOps 18.1 基礎設施即程式碼與受管服務的安全基準 18.2 資料庫的 CI/CD 管線 18.3 在 Kubernetes 上執行資料庫 18.4 審查重點與 AI 常見錯誤 19. 資料治理、品質與資料字典 19.1 治理角色與資料分級 19.2 資料字典 19.3 資料品質 19.4 參考資料、血緣與敏感資料探索 19.5 審查重點與 AI 常見錯誤 20. 法規遵循 20.1 法規需求對照 20.2 個人資料保護 20.3 委外與雲端 20.4 持卡人資料(PCI DSS 4.0.1) 20.5 保存期限、GDPR 與財務資料控制 20.6 審查重點與 AI 常見錯誤 21. 升級與遷移 21.1 版本生命週期 21.2 升級方式與相容性測試 21.3 遷移、資料比對與切換 21.4 審查重點與 AI 常見錯誤 22. AI 輔助資料庫設計與審查 22.1 給 AI 的輸入 22.2 AI 工具的資料庫存取邊界 22.3 審查與驗收 AI 的產出 22.4 審查重點與 AI 常見錯誤 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 審查檢核表 B.1 邏輯模型審查(業務確認) B.2 實體設計審查(DBA) B.3 安全審查 B.4 變更審查(每一個 migration) B.5 上線前審查 B.6 定期檢查 附錄 C 範本 C.1 表格設計規格書 C.2 資料字典與一致性檢查查詢 C.3 資料庫變更申請單 C.4 範例驗證環境 附錄 D 術語 附錄 E 參考標準與資源 附錄 F 修訂紀錄與查證紀錄 F.1 v2 → v3 章節對照 F.2 v2 錯誤更正 F.3 查證紀錄 F.4 待確認與待辦事項 F.5 版本歷程 結語 0. 文件資訊 0.1 文件目的與讀者 本指引定義關聯式資料庫的實體設計與維運標準:資料表、欄位、鍵、索引、交易、安全、變更、備份與監控要怎麼設計,做到什麼程度才算合格,以及如何驗證。 ...

October 31, 2025 · 171 min · 36351 words · Eric Cheng