系統架構設計範本

系統架構設計範本 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

系統設計階段標準範本清單(樹狀結構版)

📂 系統設計階段標準範本清單(樹狀結構版) 文件目錄 (Document Templates) 1.1 系統設計總規劃書 (System Design Document, SDD) 1.2 系統架構設計書 (System Architecture Design) 1.3 資料庫設計書 (Database Design Document, DDD) 1.4 模組設計規格書 (Module Design Specification) 1.5 介面設計規格書 (Interface Design Specification, API/Batch) 1.6 UI/UX 設計文件 (Wireframe, Mockup, Prototype) 1.7 輸入/輸出設計文件 (I/O Design, Report Spec) 1.8 流程設計文件 (DFD, Activity Diagram, Sequence Diagram, State Diagram) 1.9 安全性設計規格書 (Security Design Spec, RBAC/ABAC) 1.10 例外處理/錯誤處理設計書 (Error & Exception Handling Spec) 1.11 批次處理設計文件 (Batch Job Design Spec, Schedule Spec) 1.12 系統整合設計書 (Integration Design, API Gateway, MQ, SFTP) 1.13 測試設計準則 (Test Design Basis, Traceability Matrix) ...

October 31, 2025 · 2 min · 245 words · Eric Cheng

系統設計階段標準範本清單OOD(含文件目錄、流程、工作項目)

系統設計階段標準範本清單OOD(含文件目錄、流程、工作項目) 文件目錄 (Deliverables) 系統設計總覽文件 (System Design Specification, SDS) 設計目標與範疇 架構原則與設計考量 系統邊界與外部介面 架構設計文件 (Architecture Design Document, ADD) 系統整體架構圖 (Logical / Physical) 分層架構 (Layered Architecture) 模組/子系統劃分與責任定義 技術棧與設計決策紀錄 (ADR) 資料設計文件 (Data Design Document, DDD) 資料模型 (ERD) 類別圖 (Class Diagram) 資料表設計與正規化說明 交易與一致性設計 物件導向設計文件 (Object-Oriented Design Document) 類別與責任 (CRC 卡片) 類別圖 / 物件圖 繼承、多型設計 設計模式應用 介面設計文件 (Interface Design Specification, IDS) API 設計 (REST/GraphQL) 資料交換格式 (JSON, XML) UI/UX Wireframe、螢幕設計稿 流程與行為設計文件 (Behavioral Design Specification) Use Case Realization Sequence Diagram State Diagram Activity Diagram 安全設計文件 (Security Design Document) 認證與授權設計 資料加密與存取控制 威脅模型 (Threat Modeling) 基礎設施與部署設計文件 (Deployment Design) 系統拓撲圖 伺服器/容器配置 CI/CD 流程設計 系統設計流程 (Workflow, OOD) 輸入:系統分析成果 (SRS, Use Case, 需求模型) ...

October 31, 2025 · 1 min · 199 words · Eric Cheng

統一建模語言(UML)教學

統一建模語言(UML)教學手冊 作者:系統架構師團隊 更新日期:2026 年 10 月 13 日 版本:v2.0 適用對象:新進開發同仁、系統分析師、架構師、測試工程師、Code Reviewer 技術基準:OMG UML 2.5.1(ISO/IEC 19505:2012 對應 UML 2.4.1)、OCL 2.4、PlantUML 1.2026.8、Mermaid 11、Java 25、JUnit 6.1 目錄 0. 文件資訊與使用方式 0.1 文件資訊 0.2 適用對象與學習路徑 0.3 與其他手冊的分工 0.4 指引條目的格式與編號 0.5 範例的驗證方式 0.6 圖例與記法慣例 1. UML 概論與標準體系 1.1 什麼是 UML 1.2 發展歷程 1.3 標準體系與版本現況 UML-GEN-001 引用 UML 時標明規格版本 1.4 模型、圖與後設模型 1.5 14 種圖的分類 1.6 建模的目的與抽象層級 UML-GEN-002 每張圖都要標明目的、讀者與抽象層級 UML-GEN-003 一張圖只表達一個主題並控制元素數量 1.7 常見誤解 1.8 練習題 2. 共通記法元素 2.1 名稱與命名空間 2.2 可見性 2.3 多重性 UML-GEN-004 多重性使用 UML 標準語法 2.4 型別、資料型別與列舉 2.5 註解、約束、關鍵字與構造型 UML-GEN-005 構造型限用團隊登錄清單 UML-GEN-006 重要業務規則以約束表達並可轉成測試 2.6 依賴與抽象關係 2.7 練習題 3. 類別圖 3.1 用途與觀點 3.2 類別的記法 3.3 介面與抽象類別 3.4 關聯 UML-CLS-001 關聯兩端都要標示多重性 UML-CLS-002 導航方向只在設計與實作觀點標示 3.5 聚合與組合 UML-CLS-003 組合與聚合的菱形畫在整體端 UML-CLS-004 只在生命週期確實綁定時使用組合 3.6 泛化與泛化集合 UML-CLS-005 泛化只表達 is-a 關係 3.7 依賴與實現在類別圖中的使用 3.8 同一模型的三種觀點 3.9 常見錯誤 3.10 審查清單 3.11 練習題 4. 物件圖 4.1 用途 4.2 記法 4.3 以物件圖驗證類別圖 UML-OBJ-001 物件以「名稱 : 類別」表示,連結不標多重性 UML-OBJ-002 以邊界情境的物件圖驗證多重性與約束 4.4 審查清單與練習 5. 套件圖 5.1 用途 5.2 記法 5.3 依賴規則與循環依賴 UML-PKG-001 套件之間不可有循環依賴 UML-PKG-002 套件圖與程式套件一致並以架構測試守護 5.4 Mermaid 的近似畫法 5.5 審查清單與練習 6. 組合結構圖 6.1 用途 6.2 記法 6.3 協作 UML-CSD-001 連接器兩端的埠必須介面相容 6.4 練習 7. 元件圖 7.1 用途與元件的定義 7.2 記法 7.3 黑箱與白箱視圖 UML-CMP-001 元件之間只透過介面相依 UML-CMP-002 元件圖不畫類別層級的細節 7.4 Mermaid 的近似畫法與 C4 模型 7.5 審查清單與練習 8. 部署圖 8.1 用途 8.2 記法 8.3 元件、成品與節點的關係 UML-DEP-001 明確區分節點、執行環境與成品 UML-DEP-002 通訊路徑標示協定、埠號與安全邊界 UML-DEP-003 標示軟體版本時確認仍在支援期 8.4 雲端與容器環境的對應 8.5 Mermaid 的近似畫法 8.6 審查清單與練習 9. Profile 圖 9.1 用途 9.2 記法 UML-PRF-001 自訂構造型必須定義在 Profile 並附說明 9.3 練習 10. Use Case 圖 10.1 用途 10.2 記法 10.3 Use Case 的粒度 UML-UC-001 Use Case 以「動詞+受詞」命名並代表使用者目標 UML-UC-002 Actor 與 Use Case 以無箭頭的實線關聯 UML-UC-003 include 由基礎指向被包含者,extend 由擴充指向基礎 UML-UC-004 登入不畫成被 include 的 Use Case 10.4 Use Case 規格 UML-UC-005 每個 Use Case 都有文字規格 10.5 Mermaid 的近似畫法 10.6 審查清單與練習 11. 活動圖 11.1 用途與語意 11.2 記法 11.3 範例:選課流程 UML-ACT-001 決策節點的守衛條件必須互斥且完整 UML-ACT-002 fork 與 join 成對,且 join 只結合並行路徑 UML-ACT-003 區分活動終點與流程終點 UML-ACT-004 泳道代表負責的角色或系統 11.4 進階元素 11.5 審查清單與練習 12. 狀態機圖 12.1 用途 12.2 記法 12.3 範例:選課紀錄的生命週期 UML-STM-001 轉換標示遵循「觸發 [守衛] / 效果」語法 UML-STM-002 同一狀態、同一事件的多條轉換,守衛必須互斥 UML-STM-003 每個狀態都可到達,每個非最終狀態都可離開 12.4 從狀態機圖到程式與測試 UML-STM-004 狀態機圖必須轉成轉換表與測試 UML-STM-005 狀態以形容詞或過去分詞命名,事件以動詞或名詞片語命名 12.5 進階元素 12.6 審查清單與練習 13. 循序圖 13.1 用途 13.2 記法 13.3 範例:選修課程的設計循序圖 UML-SEQ-001 訊息箭頭依同步、非同步、回覆正確區分 UML-SEQ-002 生命線以「角色 : 型別」命名並維持同一抽象層級 UML-SEQ-003 組合片段的守衛條件必須明確 13.4 組合片段 UML-SEQ-004 一張循序圖描述一個情境,長流程以 ref 拆分 13.5 以測試驗證循序圖 UML-SEQ-005 關鍵的呼叫順序以 InOrder 測試守護 13.6 審查清單與練習 14. 通訊圖 14.1 用途 14.2 記法 UML-COM-001 通訊圖的訊息以階層式序號表示順序 14.3 練習 15. 時序圖 15.1 用途 15.2 記法 UML-TIM-001 時間約束必須標示單位與起訖事件 15.3 練習 16. 互動概觀圖 16.1 用途 16.2 記法 UML-IOV-001 每個 ref 都必須能找到對應的互動 16.3 練習 17. OCL 實務 17.1 為什麼需要 OCL 17.2 基本語法 17.3 範例:選課約束 UML-OCL-001 OCL 約束必須有 context 與名稱 17.4 從 OCL 到程式與測試 17.5 約束追溯表 UML-OCL-002 每條 OCL 約束都要對應程式檢查與測試 18. 模型與程式碼的對應 18.1 類別圖元素與 Java 的對應 18.2 範例:組合與多重性的實作 UML-MAP-001 組合在程式中必須體現生命週期擁有 UML-MAP-002 多重性必須對應型別與驗證 18.3 架構圖與程式的自動比對 UML-MAP-003 架構圖以可執行的規則守護 18.4 類別圖與 ER 模型的差異 18.5 練習 19. 工具鏈與 Docs-as-Code 19.1 工具比較 19.2 PlantUML 安裝與使用 UML-TOOL-001 圖以文字原始碼納入版本控制 UML-TOOL-002 機敏的圖不使用公開的線上渲染服務 19.3 Mermaid、PlantUML 與 UML 標準的差異 UML-TOOL-003 以非標準記法近似時必須在圖上註明 19.4 Docs-as-Code 目錄與設定 19.5 自動檢查:check_uml.py 19.6 CI 自動驗證 UML-TOOL-004 CI 中的繪圖工具與 Action 固定版本 20. 生命週期、團隊協作與審查流程 20.1 專案生命週期中的 UML 20.2 依專案類型選擇的最小圖組 20.3 敏捷開發中的建模 UML-PRC-001 建模深度依風險與變更頻率決定 20.4 與不同角色溝通 20.5 圖的審查流程 UML-PRC-002 圖與程式在同一個 Pull Request 中依清單審查 UML-PRC-003 每張正式圖都有負責人與最後驗證日期 20.6 練習 21. 綜合案例 21.1 學生選課系統:從需求到程式的模型鏈 21.2 追溯矩陣 21.3 其他領域的精簡範例 21.4 跨領域的共同模式 21.5 練習 22. AI 輔助建模 22.1 適合與不適合的用途 22.2 AI 產出的典型錯誤 22.3 建議的工作流程 UML-AI-001 AI 產生的圖必須通過工具驗證與人工審查 UML-AI-002 不把機敏資訊提供給未核准的 AI 工具 23. OCUP 2 認證準備 23.1 認證概述 23.2 Foundation 考試範圍 23.3 Intermediate 與 Advanced 考試範圍 23.4 模擬題與解析 23.5 準備計畫與資源 24. 審查與驗證清單總表 24.1 每張圖的共通檢查 24.2 各圖的重點檢查 24.3 模型與程式一致性檢查 24.4 專案階段檢查 24.5 團隊協作檢查 附錄 A 指引總表 附錄 B 符號速查 附錄 C v1.0 至 v2.0 章節對照 附錄 D 修正紀錄 附錄 E 驗證紀錄 附錄 F 待確認事項 附錄 G 參考文獻 附錄 H 版本歷程 0. 文件資訊與使用方式 0.1 文件資訊 項目 內容 文件名稱 統一建模語言(UML)教學手冊 版本 v2.0(2026-10-13) 前一版 v1.0(2025-09-01 內容,2025-10-31 發布) 文件性質 企業標準技術白皮書:記法規範、審查準則與教學 規範基準 OMG UML 2.5.1(formal/17-12-05);國際標準引用 ISO/IEC 19505-1/19505-2:2012 輔助規範 OCL 2.4、XMI 2.5.1、fUML 1.5、Alf 1.1、PSSM 1.0 驗證工具 PlantUML 1.2026.8、mermaid-cli 11(網站載入 mermaid@11)、Java 25、JUnit 6.1、ArchUnit 1.5、Python 3 指引條目 58 條(必須 35 條),總表見附錄 A 本手冊是公司內部 UML 記法的權威文件:圖該怎麼畫、每個符號代表什麼、怎麼審查一張圖是否正確,都以本手冊為準。 ...

October 31, 2025 · 85 min · 18012 words · Eric Cheng

自動化測試範本

自動化測試範本 Prompt 目標 指導 AI 建立完整的自動化測試框架,包含各層級的自動化測試實作。 角色設定 你是一位資深自動化測試工程師,具備豐富的測試框架設計和實作經驗,熟悉各種自動化測試工具和最佳實務。 任務描述 請協助我為 {專案名稱} 建立完整的自動化測試框架和測試案例。 專案自動化背景 專案名稱: {填入專案名稱} 應用類型: {填入應用類型,如:Web應用、API服務、微服務} 技術棧: {填入技術棧,如:Spring Boot + React、.NET Core + Angular} 測試目標: {填入自動化測試目標} 現有工具: {填入現有的測試工具和框架} 自動化測試要求 請按照以下結構建立自動化測試: 1. 測試框架設計 框架架構設計 工具選型評估 專案結構規劃 配置管理設計 2. 單元測試自動化 測試類別設計 Mock 策略規劃 測試資料準備 斷言策略設計 3. 整合測試自動化 API 測試框架 資料庫測試設計 外部服務模擬 契約測試實作 4. UI 測試自動化 Page Object 模式 元素定位策略 測試資料驅動 跨瀏覽器測試 5. CI/CD 整合 測試執行策略 報告生成機制 失敗處理流程 測試結果分析 6. 維護和擴展 測試程式碼品質 框架擴展性設計 效能最佳化 文檔和培訓 輸出格式 # {專案名稱} 自動化測試框架 ## 1. 框架架構設計 ### 1.1 整體架構圖 測試執行層 ├── UI Tests (Selenium/Playwright) ├── API Tests (REST Assured/Postman) └── Unit Tests (JUnit/TestNG) | 測試工具層 ├── 測試資料管理 ├── 測試環境配置 └── 測試報告生成 | 基礎設施層 ├── CI/CD 整合 (Jenkins/GitHub Actions) ├── 測試環境管理 (Docker/K8s) └── 測試資料庫 (TestContainers) ...

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

資料庫設計指引範本

資料庫設計指引範本 Prompt 目標 指導 AI 進行資料庫設計,建立結構化、高效能且可維護的資料庫架構。 角色設定 你是一位資深資料庫設計師,具備豐富的資料庫設計經驗,熟悉正規化理論、效能優化和資料安全設計。 任務描述 請協助我完成 {專案名稱} 的資料庫設計工作。 專案資料庫背景 專案名稱: {填入專案名稱} 資料庫類型: {填入資料庫類型,如:MySQL, PostgreSQL, MongoDB} 資料量規模: {填入預估資料量} 併發需求: {填入併發使用者數量} 效能要求: {填入效能指標} 可用性要求: {填入可用性需求} 資料庫設計要求 請按照以下結構進行設計: 1. 概念模型設計 實體識別 屬性定義 關係建立 業務規則定義 2. 邏輯模型設計 正規化設計 資料類型選擇 約束條件定義 索引策略規劃 3. 實體模型設計 表格結構設計 主鍵和外鍵設計 觸發器和預存程序 權限和安全設計 4. 效能優化設計 索引最佳化 查詢優化 分割策略 快取策略 5. 資料安全設計 存取控制 資料加密 稽核記錄 備份恢復 輸出格式 # {專案名稱} 資料庫設計文件 ## 1. 資料庫概述 ### 1.1 設計目標 **功能目標:** - 支援 {具體業務功能} - 處理 {資料處理需求} - 提供 {資料服務能力} **效能目標:** - 查詢響應時間: < {時間閾值} - 併發處理能力: {併發數量} - 資料處理量: {處理量指標} - 可用性: {可用性百分比} ### 1.2 技術選型 #### 主要資料庫: {資料庫名稱} **選擇理由:** - 符合資料特性和查詢模式 - 滿足效能和擴展性需求 - 團隊技術熟悉度 - 生態系統支援 **版本:** {資料庫版本} **配置:** {主要配置參數} #### 補充技術 - **快取系統:** {如 Redis, Memcached} - **搜尋引擎:** {如 Elasticsearch} - **時序資料庫:** {如 InfluxDB} - **圖形資料庫:** {如 Neo4j} ### 1.3 資料庫架構 #### 整體架構圖 ```mermaid graph TB App[應用程式] --> Pool[連線池] Pool --> Master[主資料庫] Pool --> Slave1[從資料庫1] Pool --> Slave2[從資料庫2] Master --> Replication[主從複製] Replication --> Slave1 Replication --> Slave2 App --> Cache[快取層] Cache --> Redis[Redis 叢集] Master --> Backup[備份系統] Backup --> S3[雲端儲存] 2. 概念模型設計 2.1 實體識別 核心實體清單 實體1: {實體名稱} ...

October 31, 2025 · 19 min · 4003 words · Eric Cheng

資料流程圖(DFD)教學

資料流程圖 (Data Flow Diagram, DFD) 教學手冊 作者:系統分析與架構團隊 更新日期:2026 年 10 月 12 日 版本:v2.0 適用對象:系統分析師、需求分析人員、後端與資料工程師、資安與個資人員、技術主管、設計審查者 技術基準:DeMarco/Yourdon/Gane-Sarson 結構化分析、IIBA BABOK v3、ISO/IEC/IEEE 29148:2018、STRIDE-per-element、Mermaid 11、Python 3.12(check_dfd.py) 目錄 0. 文件資訊與使用方式 0.1 文件資訊 0.2 如何使用本手冊 0.3 指引條目的格式與編號 0.4 本手冊的層次命名約定 1. 學習目標與能力等級 1.1 學完本手冊應具備的能力 1.2 能力自我檢核 1.3 建議學習時程 2. 基礎概念與發展歷史 2.1 什麼是資料流程圖 DFD-CON-001 資料流必須表達資料,不可表達控制訊號或執行順序 DFD-CON-002 資料流只能是資料,實體物品與金錢要轉成代表它的資料 2.2 DFD 的用途與價值 2.3 發展歷史與記法演進 2.4 DFD 與其他圖的比較與選用 DFD-CON-003 先寫出這張 DFD 要回答的問題,再選擇層次與範圍 2.5 DFD 在開發生命週期中的位置 3. DFD 元素、記法與命名 3.1 外部實體 DFD-NOT-001 團隊必須統一一套記法,並在文件開頭寫明 DFD-NOT-002 外部實體以「角色」命名,不以人名、職稱個人或技術元件命名 3.2 處理程序 DFD-NOT-003 處理程序以「動詞+受詞」命名,並有模型內唯一的編號 3.3 資料流 DFD-NOT-004 外部實體之間不可畫資料流 DFD-NOT-005 外部實體不可直接讀寫資料儲存 DFD-NOT-006 資料儲存之間不可直接流動 DFD-NOT-007 同名資料流在整個模型中代表相同內容,不同內容必須不同名 3.4 資料儲存 DFD-NOT-008 一張圖的處理程序數量控制在 7±2 個以內 DFD-NOT-009 雙向箭頭必須拆成兩條各自命名的單向資料流 3.5 三套常用記法對照 3.6 用 Mermaid 繪製 DFD DFD-NOT-010 Mermaid 圖以 classDef 標示元素類別,不以逐一 style 上色 3.7 版面與視覺規範 4. 分層、編號與平衡 4.1 分層分解的原理 DFD-LVL-001 文件開頭必須寫明層次命名約定 4.2 Context 圖 DFD-LVL-002 Context 圖只能有一個處理程序,且不可包含資料儲存 4.3 Level 0 圖 4.4 編號規則 DFD-LVL-003 子圖處理程序的編號必須以父處理程序編號為前綴 4.5 平衡:父子圖的資料守恆 DFD-LVL-004 子圖的淨輸入與淨輸出必須與父處理程序平衡 DFD-LVL-005 子圖拆分或合併父圖資料流時,組合關係必須寫在資料字典 4.6 資料儲存在分層中的位置 DFD-LVL-006 只被一個處理程序使用的資料儲存,應下移到該處理程序的子圖 4.7 何時停止分解 DFD-LVL-007 分解到功能基元即停止,每個功能基元都要有處理規格 5. 資料字典與處理規格 5.1 為什麼 DFD 一定要搭配資料字典 5.2 資料字典記法 DFD-DIC-001 每條資料流與資料儲存都必須在資料字典定義,並展開到資料元素 DFD-DIC-002 組合定義必須使用統一記法,且可以被工具解析 5.3 資料元素的定義 DFD-DIC-003 資料元素至少定義型別、格式或值域,以及是否為個資 5.4 處理規格:結構化英文 DFD-DIC-004 功能基元的處理規格以結構化英文、決策表或決策樹撰寫,並寫明輸入、輸出與前後置條件 5.5 處理規格:決策表與決策樹 DFD-DIC-005 決策表必須完整且互斥,並以工具或窮舉驗證 6. 繪製方法 6.1 需求蒐集與資料流識別 6.2 事件分割法 DFD-MTH-001 Level 0 圖以事件清單推導,事件清單與 Context 圖的邊界資料流必須一一對應 6.3 由外而內的八步驟繪製流程 6.4 從表單、報表與介面推導資料流 DFD-MTH-002 每份輸入表單、輸出報表與外部介面,都必須對應到 Context 圖的一條資料流 6.5 常見錯誤型錄 6.6 走查與確認 DFD-MTH-003 每條跨越系統邊界的資料流都要經業務代表走查確認,並留下紀錄 7. 邏輯與實體 DFD、現況與未來、現代架構 7.1 邏輯 DFD 與實體 DFD DFD-MTH-004 每張 DFD 都必須標示為邏輯或實體,邏輯 DFD 不得出現技術名詞 7.2 現況與未來 DFD-MTH-005 訊息佇列與事件主題依用途畫成資料儲存或資料流,不畫成處理程序 DFD-MTH-006 現況與未來分開建模,每個模型都要標示狀態 7.3 實體 DFD 的寫法 7.4 即時系統延伸:控制流與控制處理程序 7.5 在微服務、事件驅動與資料管線中使用 DFD 8. 品質審查與自動驗證 8.1 DFD 品質的三個層面 8.2 守恆檢查:黑洞、奇蹟與灰洞 DFD-QA-001 每個處理程序都必須有輸入與輸出,且輸出可由輸入、讀取的資料儲存或宣告的推導取得 8.3 自動驗證工具 check_dfd.py 8.4 其他檢查工具 8.5 資料儲存的使用完整性 DFD-QA-002 完整模型中的每個資料儲存都必須同時有寫入與讀取,外部維護的只讀儲存必須明確宣告 8.6 語意審查:層次一致與命名 DFD-QA-003 同一張圖上的處理程序必須處於相同的抽象層次 8.7 審查流程與紀錄 DFD-QA-004 審查意見必須引用指引編號,並附上工具檢查結果 9. 以 DFD 進行威脅建模 9.1 為什麼威脅建模使用 DFD 9.2 信任邊界 DFD-SEC-001 威脅建模必須使用實體 DFD,並標示所有信任邊界 9.3 STRIDE-per-element DFD-SEC-002 每個 DFD 元素都要依 STRIDE-per-element 評估,結果記錄在威脅登錄表 DFD-SEC-003 跨越信任邊界的資料流必須評估竄改、資訊洩漏與阻斷服務,並寫明防護方式 DFD-SEC-004 威脅模型必須與架構一起納入版本控制,架構變更時同步更新 9.4 威脅建模工具 9.5 隱私威脅:LINDDUN 10. 以 DFD 進行個資盤點與資料治理 10.1 為什麼個資盤點要用 DFD 10.2 DFD 與個資處理活動紀錄的對照 10.3 個資標記與自動追蹤 DFD-PRV-001 資料字典必須標示每個資料元素的個資等級,並以工具追蹤個資經過的元素 DFD-PRV-002 存放個資的資料儲存必須寫明蒐集目的、保存期限與刪除方式 DFD-PRV-003 送往外部實體的個資資料流必須寫明利用目的,跨境傳輸必須標示 DFD-PRV-004 資料流只能帶著接收方完成目的所需的個資欄位 10.4 資料血緣與資料治理 10.5 個資相關審查重點 11. 專案實務:文件、追溯、版本控制與團隊協作 11.1 DFD 在需求文件中的位置 11.2 需求追溯 DFD-PRJ-001 每個功能基元與每條邊界資料流都必須追溯到需求編號與測試案例 11.3 從 DFD 到設計與程式 DFD-PRJ-002 每個資料儲存都要有 CRUD 矩陣,確認寫入者與讀取者都已設計 11.4 版本控制與 CI DFD-PRJ-003 DFD 模型以文字格式納入版本控制,合併前由 CI 執行全部檢查 11.5 變更管理與影響分析 DFD-PRJ-004 變更 DFD 前先做影響分析,列出受影響的圖、介面、測試與文件 11.6 團隊角色與審查會議 11.7 敏捷開發中的 DFD 12. 與 ER 模型、UML、BPMN、C4 與 DDD 的整合 12.1 三種觀點互補 12.2 DFD 與 ER 模型 DFD-PRJ-005 資料儲存的資料字典定義必須與 ER 模型的屬性一致 12.3 DFD 與 UML 12.4 DFD 與 BPMN 12.5 DFD 與 C4 模型 12.6 DFD 與領域驅動設計(DDD) 12.7 跨模型對照總表 13. 繪圖與建模工具 13.1 選擇工具的原則 13.2 工具比較 13.3 Mermaid 繪製 DFD 的實務技巧 14. AI 輔助繪製與審查 14.1 AI 能做什麼、不能做什麼 14.2 建議的工作流程 14.3 AI 產出的檢查 DFD-AI-001 AI 產生的 DFD 必須轉成可檢查的模型,並通過工具檢查後才能進入審查 DFD-AI-002 AI 產生的每條資料流都必須標示需求來源,並由分析師逐條對照 DFD-AI-003 不得將個資、客戶機密或內部架構細節輸入未經組織核准的 AI 服務 15. 完整案例 15.1 案例一:ATM 提款系統 需求描述與範圍 事件清單 模型 驗證結果 資料字典 每日限額的決策表 本案例的學習重點 15.2 案例二:圖書館管理系統 需求與事件 15.3 案例三:學生選課系統 15.4 案例四:中小企業進銷存系統 15.5 練習題 練習 1:診所掛號與看診系統 練習 2:停車場自動繳費系統 練習 3:員工差旅報帳系統 16. 認證與自我評量 16.1 與 DFD 相關的認證 16.2 必備知識點與對應章節 16.3 自我評量:選擇題 16.4 自我評量:實作題 實作題 1:找出錯誤 實作題 2:補成平衡的子圖 實作題 3:決策表 16.5 參考解答與解析 17. 檢查清單 17.1 快速檢查表(Quick Checklist) 17.2 Context 圖 17.3 Level 0 圖與子圖 17.4 資料字典與處理規格 17.5 實體 DFD 與威脅建模 17.6 個資 17.7 文件、追溯與協作 17.8 AI 輔助 18. 參考資料 18.1 原始方法與教科書 18.2 標準與知識體系 18.3 威脅建模與隱私 18.4 工具與相關模型 18.5 本站相關手冊 附錄 A 指引總表 附錄 B 符號與模型格式速查 B.1 記法符號 B.2 資料字典記法 B.3 YAML 模型區段 B.4 工具檢查代碼 附錄 C v1.1 → v2.0 章節對照 附錄 D 修正說明 附錄 E 驗證紀錄 E.1 驗證環境 E.2 模型範例驗證 E.3 工具的自我測試 E.4 Mermaid 圖 E.5 程式範例 E.6 目錄與錨點 E.7 Markdown 格式 E.8 外部資訊查證 E.9 如何重現 附錄 F 待確認事項 附錄 G 版本歷史 0. 文件資訊與使用方式 0.1 文件資訊 項目 內容 文件名稱 資料流程圖 (Data Flow Diagram, DFD) 教學手冊 版本 v2.0(全面改版,章節對照見附錄 C,修正內容見附錄 D) 更新日期 2026-10-12 作者 系統分析與架構團隊 適用對象 新進系統分析師、需求分析人員、後端與資料工程師、資安人員(威脅建模)、個資管理人員、技術主管與設計審查者 文件定位 企業內部技術白皮書等級的教學手冊。目標是教會讀者「畫出正確的 DFD」,也教會讀者「審查與驗證別人畫的 DFD 是否正確」 前置知識 看得懂業務流程描述即可。第 8 章的檢查工具需要能執行 Python 3.10 以上版本 本版技術基準:下表是本手冊查證過的來源與版本(查證日 2026-10-12)。所有 YAML 模型範例都由第 8 章的 check_dfd.py 實際檢查過,所有 Mermaid 圖都以 mermaid-cli 11 實際渲染過,結果見附錄 E。 ...

October 31, 2025 · 122 min · 25854 words · Eric Cheng