專案風險管理指引

專案風險管理指引 目錄 1. 專案風險管理的定義與重要性 1.1 定義 1.2 風險管理的核心概念 1.3 為什麼風險管理很重要 1.4 金融 IT 專案的風險特性 1.5 實務案例 2. 風險分類 2.1 技術風險 2.2 管理風險 2.3 外部風險 2.4 合規風險 2.5 實務案例 3. 風險識別方法 3.1 概述 3.2 訪談法 3.3 檢核表法 3.4 歷史資料分析法 3.5 其他識別方法 3.6 風險識別的組織與文件化 3.7 實務案例 4. 風險評估 4.1 風險評估概述 4.2 風險機率評估 4.3 風險影響評估 4.4 風險優先級矩陣 4.5 定量風險分析 4.6 風險評估工具與技術 4.7 風險評估文件化 4.8 實務案例 5. 風險應對策略 5.1 風險應對策略概述 5.2 規避策略 5.3 轉移策略 5.4 減輕策略 5.5 接受策略 5.6 風險應對計畫制定 5.7 風險應對策略選擇原則 5.8 實務案例 6. 風險監控與更新流程 6.1 風險監控概述 6.2 風險監控機制 6.3 風險監控工具 6.4 風險更新流程 6.5 風險溝通管理 6.6 風險學習與改善 6.7 實務案例 7. 附錄:風險登錄表模板與範例 7.1 風險登錄表模板 7.2 不同風險類型範例 7.3 風險評估工作表 7.4 風險應對計畫範本 8. 風險管理工具與技術 9. 風險管理最佳實務 10. 常見問題與解答 參考資料 1. 專案風險管理的定義與重要性 1.1 定義 專案風險管理是指在專案生命週期中,系統性地識別、分析、評估、應對和監控可能影響專案目標達成的不確定性事件或條件的管理過程。 ...

October 31, 2025 · 11 min · 2295 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

敏捷專案管理指引

敏捷專案管理指引 目錄 前言 敏捷專案管理核心原則 常用敏捷方法 敏捷專案管理流程 敏捷工具與實務應用 敏捷專案管理在銀行系統的特別注意事項 常見問題與解決策略(FAQ) 結論與建議 參考資料 前言 敏捷專案管理的定義與重要性 敏捷專案管理(Agile Project Management)是一種以人為本、迭代式、增量式的專案管理方法論。它強調: 適應變化:擁抱需求變更,而非抗拒變化 快速交付:透過短週期迭代,頻繁交付可用的軟體或產品 客戶協作:與客戶密切合作,持續獲得回饋 團隊自主:授權團隊自我組織和決策 為什麼敏捷專案管理很重要? 市場快速變化:現今金融科技環境瞬息萬變,傳統瀑布式開發無法及時回應 客戶期望提升:客戶期待更快的上市時間和更高的產品品質 技術複雜度增加:現代系統整合度高,需要靈活的開發方式 法規環境變動:金融業法規頻繁更新,需要敏捷的回應機制 與傳統瀑布式開發的差異 比較項目 瀑布式開發 敏捷開發 開發流程 線性、順序性 迭代式、增量式 需求變更 後期變更成本高昂 擁抱變更,持續調整 客戶參與 專案初期和結尾 整個開發過程 交付頻率 專案結束時一次交付 每2-4週交付一次 風險管控 後期才發現問題 早期發現,快速調整 文件重點 詳盡的文件 可用的軟體 團隊結構 階層化管理 自我組織團隊 實務案例 某銀行數位轉型專案原採瀑布式開發,18個月後才發現市場需求已改變。改採敏捷開發後,每3週展示一次成果,第6個月就推出MVP(最小可行產品),成功搶占市場先機。 敏捷專案管理核心原則 Agile Manifesto 四大價值 敏捷宣言(Agile Manifesto)於2001年發布,奠定了敏捷開發的核心價值觀: 1. 個體與互動 重於 流程與工具 重點:人是專案成功的關鍵,良好的溝通比完美的工具更重要 實務應用: 每日站會面對面溝通 建立開放的工作環境 鼓勵團隊成員直接對話 2. 可用的軟體 重於 詳盡的文件 重點:以交付可用的產品為目標,而非完美的文件 實務應用: 專注於核心功能的實現 文件簡潔明瞭,以必要為準 透過實際產品驗證需求 3. 客戶協作 重於 合約談判 重點:與客戶建立夥伴關係,共同創造價值 實務應用: 客戶參與每次Sprint回顧 定期收集客戶回饋 調整產品方向以符合客戶真實需求 4. 回應變化 重於 遵循計劃 重點:靈活回應市場和需求變化 實務應用: 定期評估和調整專案優先級 建立彈性的開發架構 預留緩衝時間應對變更 敏捷十二項原則 最高優先級:透過早期和持續交付有價值的軟體來滿足客戶 歡迎需求變更:即使在開發後期也歡迎需求變更 頻繁交付:頻繁地交付可用的軟體,從幾週到幾個月 協同工作:業務人員和開發者必須在整個專案中每天協同工作 激發個體:圍繞被激發的個體構建專案,給他們所需的環境和支持 面對面溝通:在開發團隊中最有效的溝通方式是面對面的交談 可用軟體:可用的軟體是衡量進度的主要標準 可持續發展:敏捷流程提倡可持續的開發速度 技術卓越:持續關注技術卓越和良好設計會增強敏捷性 簡潔:簡潔——最大化未完成工作量的技藝——至關重要 自組織團隊:最好的架構、需求和設計來自自組織團隊 定期調整:團隊定期反思如何能變得更有效,然後調整行為 在金融/銀行專案中的適用性說明 適用場景 數位化轉型專案:線上銀行、行動APP開發 法規遵循系統:需要快速回應法規變更 客戶體驗改善:根據客戶回饋持續優化 創新產品開發:新金融商品或服務的探索 注意事項 法規要求:某些文件和審查流程不可省略 安全考量:資安測試和稽核需要充分時間 風險管控:金融業對風險敏感,需要適當的控制點 合規性:確保敏捷實踐符合內控制度 實務案例 某區域銀行開發客戶關係管理系統,採用Scrum方法: ...

October 31, 2025 · 8 min · 1531 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

系統分析指引

專案系統分析指引 企業標準技術白皮書|版本 v3.0|2026-10-08 適用範圍:企業應用系統從「業務需求」到「系統分析文件(需求規格書 SRS 與系統分析文件 SAD)」的系統分析階段。內容涵蓋分析流程與國際標準、角色、需求擷取、需求撰寫品質、業務流程與業務規則、功能需求、資料與領域分析、行為建模、非功能需求、介面與整合需求、安全隱私與合規需求、使用者體驗與無障礙、國際化、需求驗證、優先級、追溯與變更管理、敏捷模式、AI 輔助分析,以及分析交付物與審查。 v3.0 全面改寫 v2.0:依 ISO/IEC/IEEE 29148:2018(並參考 2026 年進入 DIS 階段的新版草案)、IIBA BABOK Guide v3、IREB CPRE Foundation Level 3.x、ISO/IEC 25010:2023、ISO/IEC 25019:2023、OWASP ASVS 5.0、WCAG 2.2(ISO/IEC 40500: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 系統範圍與脈絡 2. 角色與職責 2.1 分析團隊的角色 2.2 責任分派矩陣(RACI) 2.3 利害關係人識別與分析 3. 需求來源與需求擷取 3.1 需求來源與擷取技術的選擇 3.2 現行系統與資料分析 3.3 擷取紀錄與確認 4. 需求撰寫品質 4.1 良好需求的特性 4.2 需求句型:EARS 4.3 需求屬性與編號 4.4 模糊用語與常見缺陷 4.5 需求的驗證方法 5. 業務分析與流程建模 5.1 業務問題與目標 5.2 業務流程建模 5.3 業務規則與決策表 5.4 差距分析與轉換需求 6. 功能需求建模 6.1 使用案例 6.2 使用者故事與故事地圖 6.3 驗收條件與 Gherkin 6.4 系統功能清單 7. 資料與領域分析 7.1 詞彙表與通用語言 7.2 概念資料模型 7.3 資料字典與資料品質需求 7.4 事件風暴與領域事件 7.5 資料生命週期、保存與轉置範圍 8. 行為建模 8.1 活動圖與資料流程圖 8.2 狀態模型 8.3 系統循序圖 8.4 分析模型之間的一致性 9. 非功能需求 9.1 ISO/IEC 25010:2023 品質模型 9.2 品質情境 9.3 效能與容量需求 9.4 可用性、可靠性與營運持續需求 9.5 可維護性、彈性與營運需求 10. 介面與整合需求 10.1 介面清單 10.2 線上介面需求(API 與事件) 10.3 檔案與批次介面需求 10.4 介面協議與責任分工 11. 安全、隱私與合規需求 11.1 安全需求的來源與等級 11.2 濫用案例與威脅導出的需求 11.3 個人資料保護需求 11.4 法規與標準合規需求 11.5 稽核軌跡需求 12. 使用者體驗與無障礙需求 12.1 原型與畫面需求 12.2 無障礙需求 12.3 可用性需求與使用品質 12.4 訊息與使用者協助 13. 國際化與地區化需求 13.1 語系與文字 13.2 時區、日期、數字與幣別 13.3 字元、姓名與地址 14. 需求驗證與確認 14.1 驗證與確認的區別 14.2 需求審查 14.3 以原型、情境走查與測試案例確認需求 14.4 需求的核准與基準化 15. 優先級、範圍與估算 15.1 優先順序方法 15.2 範圍控管與版本規劃 15.3 估算的基礎 16. 需求追溯與變更管理 16.1 追溯矩陣 16.2 需求的版本控制 16.3 變更控制流程 16.4 需求健康度指標 17. 敏捷與混合模式下的系統分析 17.1 敏捷中的需求工程 17.2 產品待辦清單與就緒定義 17.3 混合模式:固定範圍合約與敏捷交付 18. AI 輔助系統分析與人工審查 18.1 AI 適合與不適合的分析工作 18.2 提示的輸入與脈絡 18.3 AI 產出的審查與查證 18.4 資料保護與 AI 治理 18.5 系統本身包含 AI 功能時的需求 19. 交付物與分析審查 19.1 交付清單 19.2 分析審查與結論 19.3 交接給設計與測試 19.4 上線後的效益確認 附錄 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 SRS 範本 C.2 SAD 範本 C.3 使用案例規格範本 C.4 使用者故事與驗收條件範本 C.5 品質情境範本 C.6 介面需求範本 C.7 SRS 檢查工具 check_srs.py C.8 需求登錄與追溯檢查工具 check_trace.py C.9 需求變更申請單範本 附錄 D 名詞解釋 附錄 E 參考資料 E.1 國際標準 E.2 知識體系、規格與方法 E.3 我國法規與主管機關指引 E.4 本系列相關指引 附錄 F 修訂紀錄與查證紀錄 F.1 v2.0 與 v3.0 章節對照 F.2 v2.0 內容更正紀錄 F.3 查證紀錄 F.4 待確認事項 F.5 版本歷程 0. 文件資訊 0.1 文件目的與讀者 本指引定義系統分析階段的標準:從業務構想與利害關係人的需要出發,產出哪些分析成果、每項成果要做到什麼程度才算合格,以及審查者要如何驗證。它回答的是「系統必須做什麼、做到多好、受到哪些限制」,而不是「系統要怎麼做」。後者屬於架構與設計。 ...

October 31, 2025 · 98 min · 20823 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

資料庫設計指引

銀行大型共用平台 - 資料庫設計指引 企業標準技術白皮書 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

金融專案合規要求手冊

金融專案合規要求手冊 版本資訊 版本: 1.1 發布日期: 2025年8月29日 適用對象: 新進專案經理、資深專案經理、系統開發團隊 審核狀態: 更新版 目錄 金融專案中常見的合規要求概述 主要法規與標準(國內/國際) 專案生命周期各階段的合規檢查清單 專案文件與紀錄保存要求 風險管理與稽核應對 案例示例與常見錯誤 新興技術與合規挑戰 跨部門協作與溝通機制 合規成本管理與效益分析 數位轉型專案特殊考量 附錄:合規檢查清單 附錄:合規工具與模板 1. 金融專案中常見的合規要求概述 1.1 合規的重要性 金融專案合規不僅是法律要求,更是維護機構聲譽、降低營運風險的核心要素。在當今嚴格的監管環境下,任何合規疏失都可能導致: 法律責任:罰款、制裁、執照撤銷 聲譽損失:客戶信任度下降、市場競爭力削弱 財務損失:營運中斷、客戶流失、投資人信心下滑 營運影響:系統重建、流程重新設計 1.2 金融專案特有的合規挑戰 1.2.1 資料敏感性 個人資料保護:客戶身分資料、財務資訊 交易資料:金流記錄、投資組合資訊 內部資料:風險模型、定價策略 1.2.2 跨境監管 多國法規:GDPR(歐盟)、CCPA(加州)、個資法(台灣) 國際標準:Basel III、FATF建議、ISO 27001 監管機構:金管會、央行、銀行局 1.2.3 技術複雜性 系統整合:核心銀行系統、風控系統、報表系統 資料治理:資料品質、資料血緣、資料安全 技術債務:舊系統維護、新舊系統共存 1.3 合規框架概念 1.3.1 三道防線模型 (Three Lines of Defense) 第一道防線:業務單位與營運管理 日常風險管理 內控制度執行 前線合規檢查 第二道防線:風險管理與合規單位 政策制定 風險監控 合規查核 第三道防線:內部稽核 獨立驗證 有效性評估 改善建議 1.3.2 專案合規責任分工 角色 主要責任 合規職責 專案經理 專案整體管控 確保合規要求納入專案範圍 業務分析師 需求分析 識別業務流程中的合規點 系統架構師 技術架構設計 確保技術方案符合合規要求 開發團隊 系統開發 落實合規控制點的程式實作 測試團隊 系統測試 執行合規功能測試與驗證 合規專員 合規諮詢 提供法規解釋與合規指導 1.4 大型專案 vs 中小型專案差異 1.4.1 大型專案特點 專案規模:預算超過1億台幣、團隊超過50人、開發期程超過2年 合規複雜度:涉及多項法規、跨國營運、多系統整合 管理要求: 設立專門的合規委員會 聘請外部合規顧問 建立完整的合規治理架構 定期向董事會報告 1.4.2 中小型專案特點 專案規模:預算5千萬台幣以下、團隊20人以下、開發期程1年以內 合規複雜度:主要聚焦核心法規、單一系統或功能 管理要求: 指派合規聯絡人 使用標準化合規檢查清單 定期合規狀態報告 重點關注關鍵合規節點 1.5 常見合規領域 1.5.1 資料保護與隱私 適用法規:GDPR、個資法、銀行法 關鍵要求: 資料收集同意機制 資料處理目的限制 資料保存期限管理 資料跨境傳輸控制 1.5.2 反洗錢與打擊資恐 (AML/CFT) 適用法規:洗錢防制法、資恐防制法、FATF建議 關鍵要求: 客戶盡職調查 (CDD) 加強客戶盡職調查 (EDD) 疑似洗錢交易申報 (STR) 制裁名單篩檢 1.5.3 網路安全 適用法規:資通安全管理法、個資法、銀行法 關鍵要求: 資訊安全管理制度 事件應變機制 定期安全評估 員工安全教育訓練 2. 主要法規與標準(國內/國際) 2.1 台灣金融法規 🇹🇼 2.1.1 核心法規 銀行法 主管機關:金融監督管理委員會 適用對象:銀行業、信用合作社 關鍵條文: 第33條:銀行業務限制 第45條:資本適足性要求 第48條:業務查核與申報 專案影響:系統功能設計須符合業務範圍限制 個人資料保護法 施行日期:2012年10月1日 適用範圍:所有處理個人資料的公務機關及非公務機關 關鍵要求: 告知義務(第8條) 資料正確性維護(第11條) 安全維護措施(第27條) 罰則:新台幣2萬元以上20萬元以下罰鍰 洗錢防制法 最新修正:2018年11月7日 主要內容: 金融機構防制洗錢辦法 客戶盡職調查程序 疑似洗錢交易申報 系統要求: 即時篩檢功能 交易監控系統 報告產製機制 2.1.2 監管指引 金管會相關函令 銀行業內部控制及稽核制度實施辦法 金融機構防制洗錢辦法 銀行業公司治理實務守則 中央銀行規定 外匯收支或交易申報辦法 銀行業辦理外匯業務管理辦法 2.2 國際法規與標準 2.2.1 歐盟法規 GDPR (General Data Protection Regulation) 生效日期:2018年5月25日 適用範圍: 歐盟境內的資料處理 向歐盟提供商品或服務 監控歐盟境內個人行為 關鍵原則: 合法性、公平性、透明性 目的限制 資料最小化 正確性 保存期限限制 完整性與機密性 個人權利: 存取權 (Right of Access) 更正權 (Right to Rectification) 刪除權 (Right to Erasure) 資料可攜權 (Right to Data Portability) 罰款:營業額4%或2,000萬歐元,取較高者 PSD2 (Payment Services Directive 2) 目的:促進歐盟支付服務創新與競爭 關鍵要求: 強客戶驗證 (SCA) 開放銀行 API 第三方支付服務提供者 (TPP) 規範 2.2.2 美國法規 SOX Act (Sarbanes-Oxley Act) 適用對象:美國上市公司 關鍵要求: 財務報告內控制度 管理層證明責任 外部稽核獨立性 CCPA (California Consumer Privacy Act) 生效日期:2020年1月1日 適用範圍:處理加州居民個人資訊的企業 消費者權利: 知情權 刪除權 選擇退出權 不歧視權 2.2.3 國際標準 Basel III 發布機構:巴塞爾銀行監理委員會 (BCBS) 主要內容: 資本適足性要求 流動性覆蓋率 (LCR) 淨穩定資金比率 (NSFR) 槓桿比率 實施時程:2019-2027年分階段實施 ISO 27001 標準名稱:資訊安全管理系統要求事項 認證效益: 提升客戶信任 符合法規要求 降低安全風險 關鍵流程: PDCA循環 風險評估 控制措施選擇 持續改善 FATF 40項建議 發布機構:金融行動工作組織 涵蓋範圍: AML/CFT政策與協調 洗錢與資恐犯罪化 預防措施 透明度與實質受益人 權責機關權力 國際合作 2.3 新興法規趨勢 2.3.1 數位資產相關 歐盟 MiCA (Markets in Crypto-Assets Regulation) 美國數位資產框架 台灣虛擬通貨管理規範 2.3.2 人工智慧與演算法 歐盟 AI Act 演算法透明度要求 AI偏見防制 2.3.3 ESG與永續金融 歐盟永續金融披露規則 (SFDR) 氣候相關財務揭露 (TCFD) 台灣永續分類標準 3. 專案生命周期各階段的合規檢查清單 3.1 專案啟動階段 (Project Initiation) 3.1.1 合規評估要點 法規適用性分析 識別適用法規:依據專案性質、地理範圍、客戶類型確認適用法規清單 法規影響評估:評估各項法規對專案範圍、時程、成本的影響 合規成本估算:預估合規相關的人力、系統、流程成本 利害關係人識別 監管機構:金管會、央行、銀行局等主管機關 內部合規單位:法令遵循處、風險管理處、稽核處 外部顧問:法律事務所、會計師事務所、合規顧問 業務單位:相關業務部門、營運單位 3.1.2 必要文件準備 專案章程 (Project Charter) # 專案合規聲明範例 ## 合規目標 本專案承諾遵循以下法規要求: - 個人資料保護法 - 洗錢防制法 - 銀行法相關規定 - ISO 27001 資訊安全標準 ## 合規責任 - 專案經理:整體合規監督 - 合規專員:專業合規指導 - 開發團隊:落實合規控制點 ## 合規里程碑 - 需求分析階段:完成合規需求識別 - 設計階段:完成合規控制點設計 - 開發階段:完成合規功能開發 - 測試階段:完成合規測試驗證 初步風險評估 合規風險清單:識別潛在的合規風險點 風險等級評估:高/中/低風險分級 初步應對策略:風險規避、降低、轉移、接受 3.2 需求分析階段 (Requirements Analysis) 3.2.1 合規需求收集 功能性合規需求 資料保護功能 ...

October 31, 2025 · 16 min · 3299 words · Eric Cheng