Entity-Relationship Model (ER Model) 教學手冊

Entity-Relationship Model (ER Model) 教學手冊 作者:資料架構與系統分析團隊 更新日期:2026 年 10 月 12 日 版本:v3.0 適用對象:系統分析師、資料庫設計人員、後端工程師、技術主管、設計審查者 技術基準:Chen (1976) ER 模型、ISO/IEC/IEEE 31320-2:2012 (IDEF1X97)、ISO/IEC 9075:2023 (SQL:2023)、PostgreSQL 18.6、Oracle AI Database 26ai (23.26.3)、SQL Server 2025、Db2 12.1.5、Mermaid 11 目錄 0. 文件資訊與使用方式 0.1 文件資訊 0.2 如何使用本手冊 0.3 指引條目的格式與編號 0.4 範例程式碼慣例與自行驗證方式 1. 學習目標與學習路徑 1.1 學完本手冊應具備的能力 1.2 建議學習路徑 1.3 學習方法建議 2. 資料建模基礎 2.1 什麼是 ER Model 2.2 概念、邏輯、實體三層資料模型 2.3 ANSI/SPARC 三層綱要與資料獨立性 2.4 ER 模型與其他模型的關係 2.5 何時需要畫 ER 模型 3. ER 核心概念 3.1 實體、實體型別與實體集合 3.2 屬性的種類 3.3 關係、度數與角色 3.4 鍵的種類 3.5 強實體與弱實體 4. 結構限制:基數與參與 4.1 基數比 4.2 參與限制 4.3 (min,max) 表示法與「看哪一端」的差異 4.4 Mermaid Crow’s Foot 符號對照 4.5 結構限制如何落實到資料庫 5. ERD 表示法 5.1 Chen 表示法 5.2 Crow’s Foot(Information Engineering)表示法 5.3 Barker 表示法 5.4 IDEF1X 表示法 5.5 Mermaid erDiagram 語法完整說明 5.6 PlantUML 的 IE 表示法 5.7 以 UML 類別圖表示資料模型 5.8 表示法對照與選用建議 6. 延伸 ER 模型(EER) 6.1 超型別與子型別 6.2 特化與一般化 6.3 特化的限制 6.4 類別(Union Type) 6.5 聚合(Aggregation) 7. 建模流程:從需求到 ER 模型 7.1 流程總覽 7.2 萃取業務規則 7.3 名詞與動詞分析 7.4 實體精煉與屬性識別 7.5 資料字典 7.6 命名規範 7.7 情境走查與樣本資料驗證 8. 從 ER 模型映射到關聯綱要 8.1 映射演算法總覽 8.2 步驟 1~2:一般實體與弱實體 8.3 步驟 3~5:二元關係 8.4 步驟 6:多值屬性 8.5 步驟 7:n 元關係 8.6 步驟 8:特化與一般化的四種方案 8.7 步驟 9:類別(union type) 8.8 參照動作與四種資料庫的差異 8.9 識別欄位與四種資料庫的 DDL 差異 9. 函數相依與正規化 9.1 為什麼需要正規化:資料異常 9.2 函數相依、Armstrong 公理與屬性閉包 9.3 第一正規形式(1NF) 9.4 第二正規形式(2NF) 9.5 第三正規形式(3NF) 9.6 Boyce-Codd 正規形式(BCNF) 9.7 第四與第五正規形式 9.8 無損分解與相依保存 9.9 正規化實務流程與檢查表 10. 實體設計與反正規化 10.1 資料型別的選擇原則 10.2 主鍵策略 10.3 反正規化與一致性保證 10.4 索引設計要點 10.5 條件式唯一 10.6 時態資料:有效時間與交易時間 10.7 系統版本時態表 11. 常用設計模式與反模式 11.1 稽核欄位與 Party 模式 11.2 軟刪除 11.3 歷史快照與版本 11.4 階層資料 11.5 代碼表與 CHECK 約束 11.6 反模式:多型關聯與 EAV 12. 常見設計錯誤與連結陷阱 12.1 連結陷阱:Fan Trap 12.2 連結陷阱:Chasm Trap 12.3 查詢時的扇出重複計算 12.4 常見錯誤速查表 13. 完整案例 13.1 案例一:圖書館借閱系統 13.2 案例二:電商訂單與出貨 13.3 案例三:銀行帳戶與複式記帳 13.4 案例四:醫院門診掛號 14. 資料模型治理與變更管理 14.1 模型生命週期 14.2 設計審查流程 14.3 以系統目錄自動檢查模型品質 14.4 綱要變更的安全做法 14.5 逆向工程與模型同步 15. 安全與個人資料保護 15.1 在模型中標示敏感資料 15.2 資料最小化與分離 15.3 加密、遮罩與列層級存取 15.4 測試資料與保存期限 16. 建模工具 16.1 工具分類與選擇準則 16.2 圖表即程式碼工具比較 16.3 開發環境整合 17. AI 輔助資料建模 17.1 適合與不適合交給 AI 的工作 17.2 建議的工作流程 18. 認證與能力評量 18.1 與資料建模相關的認證 18.2 選擇題(每題 3 分,共 20 題) 18.3 實作題(每題 8 分,共 5 題) 18.4 自我評量配分與標準 19. 檢查清單 19.1 概念模型檢查清單 19.2 邏輯模型檢查清單 19.3 實體模型與 DDL 檢查清單 19.4 安全與治理檢查清單 19.5 交付文件檢查清單 20. 參考資料 20.1 原始論文與標準 20.2 教科書與專書 20.3 官方文件 附錄 A 指引總表 附錄 B 表示法符號速查 附錄 C 四種資料庫的型別對照 附錄 D v2.0 至 v3.0 章節對照 附錄 E 修正紀錄 附錄 F 驗證紀錄 F.1 驗證環境 F.2 驗證方法 F.3 驗證結果 F.4 驗證過程中發現的問題 F.5 待確認事項 附錄 G 版本歷程 0. 文件資訊與使用方式 0.1 文件資訊 項目 內容 文件名稱 Entity-Relationship Model (ER Model) 教學手冊 版本 v3.0(全面改版,章節對照見附錄 D,修正內容見附錄 E) 更新日期 2026-10-12 作者 資料架構與系統分析團隊 適用對象 系統分析師、資料庫設計人員、後端工程師、技術主管、設計審查者 文件定位 企業內部技術白皮書等級的教學手冊。目標是教會讀者「畫出正確的 ER 模型」,也教會讀者「審查與驗證別人的 ER 模型是否正確」 前置知識 基本 SQL(SELECT、CREATE TABLE)。不需要事先學過資料庫理論 本版技術基準:本文所有標示方言的 SQL 範例,都在下表的資料庫版本實際執行過,結果見附錄 F。 ...

October 31, 2025 · 100 min · 21132 words · Eric Cheng

Hexagonal Architecture設計教學

Hexagonal Architecture 設計教學手冊 📚 文件說明 本教學手冊旨在幫助新進同仁快速理解和應用 Hexagonal Architecture(六邊形架構)。透過循序漸進的方式,從基礎概念到實務應用,讓團隊成員能夠有效地運用這種架構模式進行軟體開發。 🎯 學習目標 理解 Hexagonal Architecture 的核心概念與設計理念 掌握 Ports & Adapters 模式的實作技巧 學會在實際專案中導入六邊形架構 提升程式碼的可測試性與可維護性 建立與團隊協作的共同語言 📖 目錄 Part 1. 基礎概念 認識 Hexagonal Architecture(六邊形架構) 1.1 Hexagonal 的由來與核心理念 1.2 與傳統分層架構的比較 1.3 Ports & Adapters 模式的核心概念 Hexagonal Architecture 的設計目標 2.1 解耦業務邏輯與基礎設施 2.2 減少技術債務與提升可測試性 2.3 支援 Domain-Driven Design 的角色 Hexagonal 與其他架構模式的關係 3.1 與 Clean Architecture 的異同 3.2 與 Onion Architecture 的異同 3.3 適用場景與限制 Part 2. 核心組件與實作模式 Ports & Adapters 詳解 4.1 定義與職責 4.2 輸入 Port / 輸出 Port 4.3 主動 Adapter / 被動 Adapter Domain 層的角色 ...

October 31, 2025 · 89 min · 18939 words · Eric Cheng

Microservices Architecture 設計教學

Microservices Architecture 設計教學手冊 版本: 1.0 更新日期: 2025年9月20日 適用對象: 新進開發同仁 編寫者: 系統架構師團隊 📖 手冊簡介 本手冊是為新進開發同仁設計的微服務架構(Microservices Architecture)實務教學文件。透過系統性的學習路徑,幫助開發人員從零基礎逐步掌握微服務設計與實作技能。 🎯 學習目標 完成本手冊學習後,您將能夠: 理解微服務架構的核心概念與設計原則 掌握微服務拆分與邊界劃分技巧 熟練應用各種微服務設計模式 具備實際專案開發與維護能力 通過相關技術認證考試 🚀 使用方式 循序漸進:按照章節順序學習,每章都有前置知識 理論實作並重:理解概念後立即進行實作練習 檢查清單驗證:每章結束使用檢查清單自我驗證 團隊討論:與同事分享學習心得,加深理解 📚 目錄 Part I. 基礎認識 1. 微服務架構簡介 1.1 為什麼需要微服務 1.2 單體架構 vs. 微服務架構 1.3 微服務的核心特徵 1.4 適用與不適用場景 2. 微服務與業界標準 2.1 SOA 與微服務的差異 2.2 Cloud Native 與微服務 2.3 與 Microservices Architecture 認證的關聯 Part II. 微服務設計原則 3. 微服務設計的基本原則 3.1 單一職責原則 (SRP) 3.2 高內聚、低耦合 3.3 獨立部署與擴展 3.4 容錯與恢復能力 4. 微服務邊界劃分 4.1 領域驅動設計 (DDD) 基礎 4.2 限界上下文 (Bounded Context) 4.3 服務拆分策略 Part III. 技術架構 5. 微服務通訊模式 5.1 同步通訊 5.2 非同步通訊 5.3 事件驅動架構 6. 資料管理策略 7. 配置與服務發現 Part IV. 微服務設計模式 8. 分解模式 8.1 Database per Service Pattern 8.2 Strangler Fig Pattern 8.3 Self-Contained Service Pattern 9. 通訊模式 9.1 API Gateway Pattern 9.2 Backend for Frontend (BFF) Pattern 10. 資料管理模式 10.1 Saga Pattern 10.2 CQRS Pattern 10.3 Event Sourcing Pattern 11. 可靠性模式 11.1 Circuit Breaker Pattern 11.2 Retry Pattern 11.3 Bulkhead Pattern Part V. 跨領域關注點 12. 安全性架構 12.1 身份驗證與授權 12.2 資料保護與加密 13. 監控與可觀察性 13.1 分散式追蹤 13.2 指標收集與監控 13.3 健康檢查與服務探測 14. 配置管理 14.1 集中化配置管理 14.2 功能開關 (Feature Toggles) Part VI. DevOps 與微服務 15. CI/CD 流水線 16. 容器化與 Kubernetes 17. Infrastructure as Code Part VII. 實戰指南 18. 微服務專案規劃 19. 實作步驟與最佳實務 20. 測試策略 21. 效能調優 Part VIII. 總結與資源 總結 最佳實務摘要 延伸學習資源 Part I. 基礎認識 1. 微服務架構簡介 1.1 為什麼需要微服務 🔍 單體架構的挑戰 在傳統的單體架構(Monolithic Architecture)中,整個應用程式被打包成一個單一的部署單元。隨著業務成長,會面臨以下問題: ...

October 31, 2025 · 84 min · 17877 words · Eric Cheng

Object-Relational Mapping (ORM) 物件關聯對映教學

Object-Relational Mapping (ORM) 物件關聯對映教學手冊 作者:應用架構與資料存取團隊 更新日期:2026 年 10 月 13 日 版本:v2.0 適用對象:後端工程師、技術主管、架構師、程式碼審查者、測試工程師 技術基準:Jakarta Persistence 3.2、Hibernate ORM 7.4.5、Spring Boot 4.1.1(Spring Data JPA 2026.0.1)、Java 25;SQLAlchemy 2.1.4、Alembic 1.20.0、Python 3.14;PostgreSQL 18.6、Oracle AI Database 26ai(23.26.3)、SQL Server 2025、Db2 12.1.5 目錄 0. 文件資訊與閱讀指引 0.1 文件目的與範圍 0.2 適用讀者與學習路徑 0.3 技術基準與版本 0.4 規則格式與等級 0.5 本手冊範例如何被驗證 0.6 與其他手冊的關係 1. ORM 核心概念 1.1 什麼是 ORM 1.2 物件與關聯的阻抗不匹配 1.3 企業應用架構模式(PoEAA) 1.4 ORM 適用與不適用的情境 1.5 ORM 與 SQL 的關係 1.6 小結 2. 標準與規格 2.1 Jakarta Persistence 3.2 2.2 Jakarta Persistence 4.0 動向 2.3 Hibernate ORM 7 2.4 Python:PEP 249 與 SQLAlchemy 2.5 SQL 標準與交易隔離 2.6 標準 API 使用規則 ORM-STD-001 服務層只依賴 Jakarta Persistence 標準 API,Hibernate 專屬功能集中在持久層 3. ORM 框架與選型 3.1 Java 生態系 3.2 Python 生態系 3.3 其他語言概覽(未於本手冊執行) 3.4 框架比較 3.5 選型考量因素 3.6 選型規則 ORM-SEL-001 ORM 與 SQL-first 並用:交易性存取用 ORM,報表與彙總用 SQL-first 4. 環境建置與設定 4.1 Java:Spring Boot 4.1 + Hibernate 7.4 4.2 建議的 application.yml 4.3 Python:SQLAlchemy 2.1 4.4 環境規則 ORM-ENV-001 不手動指定 Hibernate 方言,移除過時的方言類別 ORM-ENV-002 正式環境的 schema 只驗證、不修改(ddl-auto: validate 或 none) ORM-ENV-003 關閉 Open Session in View(spring.jpa.open-in-view: false) ORM-ENV-004 明確設定連線池大小與逾時,且使用正確的單位 ORM-ENV-005 SQL 日誌以標準 logger 控制,綁定值只在開發環境輸出 ORM-ENV-006 每個行程只建立一個 EntityManagerFactory / Engine 4.5 小結 5. 實體與基本對映 5.1 Entity 的基本結構 5.2 主鍵 ORM-MAP-001 主鍵優先使用 SEQUENCE(pooled),保留 JDBC 批次寫入能力 ORM-MAP-002 對外公開或分散產生的識別碼使用 UUIDv7,不使用隨機 UUIDv4 作為主鍵 5.3 識別與相等 ORM-MAP-003 equals/hashCode 不可依賴會改變的產生式主鍵 5.4 基本型別 ORM-MAP-004 列舉以名稱或穩定代碼儲存,不可使用序數(ORDINAL) ORM-MAP-005 時間點使用 Instant / OffsetDateTime(或 UTC 正規化),不使用 LocalDateTime 與 java.util.Date ORM-MAP-006 字串欄位明確長度;可能含非 ASCII 字元的欄位明確指定 Unicode 型別 ORM-MAP-007 金額與精確數值使用 BigDecimal / Decimal,並明確 precision 與 scale 5.5 值物件、JSON 與命名 ORM-MAP-008 值物件以 Embeddable(record)建模,並在建構時檢查不變條件 ORM-MAP-009 JSON 欄位只存半結構化、不作查詢條件的屬性,並確保變更可被追蹤 ORM-MAP-010 表名與欄位名避開 SQL 保留字 ORM-MAP-011 明確指定命名策略或欄位名稱,確保各執行環境產生相同的 schema ORM-MAP-012 Python 使用 SQLAlchemy 2.x 型別化宣告(DeclarativeBase、Mapped、mapped_column) 5.6 小結 6. Persistence Context 與 Session 生命週期 6.1 實體的狀態 6.2 Flush 的時機 6.3 Persistence Context 規則 ORM-CTX-001 了解自動髒檢查:交易內修改 managed 物件就會寫回,唯讀情境使用 DTO 或唯讀查詢 ORM-CTX-002 新物件用 persist,分離物件用 merge 並使用其回傳值 ORM-CTX-003 一個 EntityManager / Session 對應一個工作單元,不跨請求、不跨執行緒共用 ORM-CTX-004 大量處理時定期 flush + clear,避免 Persistence Context 無限成長 ORM-CTX-005 Python:commit 後屬性會過期,回傳給外部前先轉成 DTO 6.4 小結 7. 關聯對映 7.1 關聯類型與擁有端 7.2 雙向關聯與擁有端 ORM-REL-001 雙向關聯必須同時維護兩端,並以擁有端寫入外鍵 ORM-REL-002 @ManyToOne 與 @OneToOne 一律明確宣告 FetchType.LAZY 7.3 Cascade 與孤兒刪除 ORM-REL-003 Cascade 只用在聚合內的組合關係,不對共用的參照物件 cascade ORM-REL-004 組合關係啟用 orphanRemoval / delete-orphan 7.4 多對多 ORM-REL-005 @ManyToMany 使用 Set,不使用 List ORM-REL-006 關聯本身有屬性時,升格為中介實體 7.5 一對一 ORM-REL-007 一對一優先使用單向 + 共用主鍵(@MapsId),避免雙向一對一的反向端 7.6 小結 8. 繼承對映 8.1 三種策略比較 8.2 繼承規則 ORM-INH-001 依查詢型態選擇繼承策略,預設 SINGLE_TABLE 或 JOINED,避免 TABLE_PER_CLASS ORM-INH-002 只為共用欄位而繼承時,使用 @MappedSuperclass ORM-INH-003 SINGLE_TABLE 的子類別欄位不可宣告 NOT NULL,依類型必填的規則改用 CHECK 約束 8.3 小結 9. 查詢 9.1 查詢方式總覽 9.2 查詢規則 ORM-QRY-001 唯讀與列表查詢使用投影(DTO / 介面 / Row),不載入整個實體 ORM-QRY-002 分頁查詢必須有決定性的排序(最後加上唯一鍵) ORM-QRY-003 集合 fetch join 搭配分頁時,必須確認分頁發生在資料庫(依 Hibernate 版本處理) ORM-QRY-004 深分頁與無限捲動使用 keyset(seek)分頁 ORM-QRY-005 批次 UPDATE / DELETE 之後,Persistence Context 必須同步 ORM-QRY-006 篩選、排序、彙總在資料庫完成;動態條件以 Criteria / Specification 組合 9.3 小結 10. 載入策略與 N+1 問題 10.1 Lazy 與 Eager 10.2 N+1 問題 10.3 載入規則 ORM-FET-001 依使用情境以 fetch join、Entity Graph 或 selectinload 一次載入所需關聯 ORM-FET-002 以 batch fetch(Java)與 raiseload(Python)作為 N+1 的安全網 ORM-FET-003 不可同時 fetch join 兩個以上的 List(bag)集合 ORM-FET-004 不以 enable_lazy_load_no_trans 或 EAGER「解決」LazyInitializationException 10.4 小結 11. 交易與並行控制 11.1 交易邊界 11.2 交易規則 ORM-TX-001 交易邊界放在服務層,查詢方法使用 readOnly ORM-TX-002 不在同一個類別內自我呼叫 @Transactional 方法 ORM-TX-003 會被並行修改的實體使用樂觀鎖(@Version / version_id_col) ORM-TX-004 悲觀鎖必須設定逾時,並了解各資料庫的實際行為 ORM-TX-005 只重試可重試的錯誤,重試整個交易並設上限 ORM-TX-006 依資料庫實際的隔離等級語意設計並行邏輯 11.3 小結 12. Schema 演進與遷移 12.1 遷移流程 12.2 遷移規則 ORM-MIG-001 Schema 變更一律以版本化遷移腳本管理,DDL 草稿須人工審查後才納入 ORM-MIG-002 自動產生的遷移必須人工審查,特別是「改名」 ORM-MIG-003 不停機部署採 Expand / Contract:先擴充、後收斂,同一版不刪除或改名舊欄位 ORM-MIG-004 已套用的遷移腳本不可修改,修正一律以新版本進行 12.3 小結 13. 效能 13.1 效能問題的來源 13.2 效能規則 ORM-PERF-001 開啟 JDBC 批次寫入並排序 INSERT / UPDATE ORM-PERF-002 大量修改使用批次 UPDATE / DELETE,不逐筆載入 ORM-PERF-003 大量讀寫使用 StatelessSession / 串流,並設定 fetch size ORM-PERF-004 二級快取只用於讀多寫極少、且只由本應用程式修改的參考資料 13.3 小結 14. 安全 14.1 ORM 相關的安全風險 14.2 安全規則 ORM-SEC-001 JPQL / HQL / 原生 SQL / text() 一律參數綁定,不串接使用者輸入 ORM-SEC-002 排序欄位、表名等識別字以白名單對應,不可直接使用使用者輸入 ORM-SEC-003 請求資料先綁定到 DTO,不直接綁定成 Entity(防止大量指派) ORM-SEC-004 日誌與錯誤訊息不得洩漏資料值(綁定參數、約束錯誤詳細內容) ORM-SEC-005 多租戶資料隔離由 ORM / 資料庫層強制,而不是靠每個查詢記得加條件 ORM-SEC-006 應用程式的資料庫帳號只授予 DML 權限,DDL 由遷移帳號執行 14.3 小結 15. 測試策略 15.1 ORM 程式的測試層次 15.2 測試規則 ORM-TST-001 持久層測試使用與正式環境相同的資料庫引擎與主要版本,不以 H2 代替 ORM-TST-002 以查詢次數斷言防止 N+1 與效能回歸 ORM-TST-003 驗證資料庫約束的測試必須明確 flush ORM-TST-004 Python 持久層測試以外層交易 + SAVEPOINT 隔離,結束時 rollback 15.3 小結 16. 架構整合 16.1 ORM 在分層架構中的位置 16.2 架構規則 ORM-ARC-001 Entity 不直接作為 API 請求或回應,於交易內轉為 DTO ORM-ARC-002 聚合之間以 ID 參照,不以物件關聯跨越聚合邊界 ORM-ARC-003 軟刪除使用框架機制(Hibernate @SoftDelete),不要手寫刪除旗標 ORM-ARC-004 稽核欄位由框架自動填寫 ORM-ARC-005 複雜讀取以唯讀的讀模型對映(@Immutable、檢視表、投影),不使用可寫的 Entity 16.3 小結 17. 錯誤處理與排錯 17.1 例外的層次 17.2 錯誤處理規則 ORM-ERR-001 把資料存取例外轉譯為領域例外,不依賴驅動專屬類別與原始訊息 ORM-ERR-002 例外發生後丟棄該交易與 EntityManager / Session,不可吞掉例外繼續使用 17.3 常見錯誤速查 17.4 小結 18. AI 輔助 ORM 開發 18.1 AI 產生 ORM 程式碼的常見問題 18.2 AI 使用規則 ORM-AI-001 AI 產生的 ORM 程式碼必須通過與人工程式碼相同的自動化檢查,才可合併 ORM-AI-002 提供給 AI 的上下文只包含結構,不包含真實資料、連線字串與密碼 18.3 AI 審查提示詞範本 18.4 小結 19. 能力認證與自我評量 19.1 認證現況(2026-10 查證) 19.2 能力等級 19.3 自我評量題 19.4 實作練習 19.5 學習計畫(8 週參考) 20. 檢查清單 20.1 新專案啟動 20.2 實體設計審查 20.3 Pull Request 審查(程式碼) 20.4 上線前 20.5 維運 20.6 故障排除 21. 參考資料 21.1 規格與標準 21.2 官方文件 21.3 書籍 21.4 本手冊的姊妹文件 附錄 A 規則總表 附錄 B 四種資料庫差異對照(實測) B.1 型別對映 B.2 識別字與保留字 B.3 悲觀鎖與鎖定逾時 B.4 交易隔離 B.5 唯一約束與 NULL B.6 Schema 變更 B.7 Python 驅動與方言的已知限制(實測) 附錄 C v1.0 → v2.0 章節對照 附錄 D 勘誤與修正紀錄 D.1 v1.0 內容修正 D.2 撰寫 v2.0 時自行發現並修正的錯誤 附錄 E 驗證紀錄 E.1 驗證環境 E.2 程式範例驗證結果 E.3 文件驗證結果 E.4 驗證過程中的主要發現 E.5 重現方式 附錄 F 待確認事項 附錄 G 版本歷史 0. 文件資訊與閱讀指引 0.1 文件目的與範圍 本手冊是企業內部使用 ORM(Object-Relational Mapping,物件關聯對映)的技術白皮書與實作規範。目標有三個: ...

October 31, 2025 · 89 min · 18894 words · Eric Cheng

Onion Architecture 設計教學

Onion Architecture 設計教學手冊 版本:1.0 日期:2025年9月20日 適用對象:Java 開發新進同仁 目標:學習 Onion Architecture 設計與認證準備 📚 目錄 第 1 章:緒論 1.1 教學手冊的目的與對象 1.2 為什麼需要 Onion Architecture 1.3 與傳統分層架構、Hexagonal Architecture、Clean Architecture 的比較 1.4 如何透過本手冊準備 Onion Architecture 認證 第 2 章:Onion Architecture 基礎概念 2.1 Onion Architecture 的核心理念 2.2 各層級設計原則 2.3 依賴反轉原則 (Dependency Inversion Principle) 2.4 Onion Architecture 的優點與限制 第 3 章:分層解析 3.1 Domain Layer - 實體與商業規則 3.2 Application Layer - 用例與服務 3.3 Infrastructure Layer - 技術支援與外部資源 3.4 Presentation Layer - 使用者介面與 API 3.5 層與層之間的互動與依賴管理 第 4 章:實作指南 ...

October 31, 2025 · 77 min · 16380 words · Eric Cheng

Refactoring重構教學

Refactoring(重構)教學手冊 文件版本:v2.0(2026-10-13) 作者:資深軟體架構師團隊 適用對象:Java/TypeScript 開發人員、Tech Lead、程式碼審查者、使用 AI 程式助理的工程師 技術基準:Java 25 LTS、JUnit 6、Maven 3.9、TypeScript 6/7、IntelliJ IDEA 2026.2(詳見 0.3) 定位:教學手冊——以「把人教會」為目標,每個觀念都有逐步操作、可執行的範例與練習;規則以 RFT-* 編號,可直接當作審查 AI 產出的檢核依據 目錄 0. 文件資訊與學習指南 0.1 為什麼要學重構 0.2 讀者與學習路徑 0.3 技術基準版本 0.4 規則格式與驗證圖示 0.5 範例的閱讀方式 0.6 與其他文件的關係 0.7 名詞約定 1. 重構基本概念 1.1 什麼是重構 1.2 可觀察行為的界定 1.3 重構的目標與效益 1.4 重構與其他變更的區別 1.5 國際標準與業界參考 1.6 實務案例:一次「不是重構」的重構 2. 重構的基本原則 2.1 兩頂帽子 2.2 小步前進與每步驗證 2.3 重構的時機 2.4 何時不該重構 2.5 安全重構的流程 2.6 Tidy First:整理的經濟學 2.7 實務注意事項 3. 識別壞味道(Code Smells) 3.1 什麼是程式碼壞味道 3.2 Fowler 第二版的 24 種壞味道 3.3 膨脹類壞味道 3.3.1 過長函式(Long Function) 3.3.2 過長參數列(Long Parameter List) 3.3.3 過大類別(Large Class) 3.3.4 資料泥團與基本型別偏執(Data Clumps/Primitive Obsession) 3.4 阻礙修改類壞味道 3.5 耦合類壞味道 3.6 可有可無類壞味道與註解 3.7 資料與狀態類壞味道 3.8 壞味道的量化指標 3.9 壞味道識別工具 3.9.1 靜態分析工具 3.9.2 IDE 內建工具 4. 基本重構手法 4.1 提煉函式與內聯函式(Extract Function/Inline Function) 4.2 提煉變數與內聯變數(Extract Variable/Inline Variable) 4.3 改名(Rename Variable/Rename Field) 4.4 改變函式宣告(Change Function Declaration) 4.5 引入參數物件(Introduce Parameter Object) 4.6 封裝變數、以查詢取代暫存變數與拆分變數 4.7 搬移語句與拆分迴圈(Slide Statements/Split Loop) 4.8 以具名常數取代魔術字面值(Replace Magic Literal) 4.9 拆分階段與函式組合(Split Phase/Combine Functions into Class) 4.10 以命令取代函式(Replace Function with Command) 4.11 重構方法選擇流程 4.11.1 重構決策樹 4.11.2 重構優先順序指南 5. 搬移特性與組織資料 5.1 搬移函式(Move Function) 5.2 搬移欄位(Move Field) 5.3 提煉類別與內聯類別(Extract Class/Inline Class) 5.4 隱藏委託與移除中間人(Hide Delegate/Remove Middle Man) 5.5 以物件取代基本型別(Replace Primitive with Object) 5.6 移除無用程式碼(Remove Dead Code) 5.7 封裝集合與封裝記錄(Encapsulate Collection/Encapsulate Record) 5.8 值物件與參照物件、以查詢取代衍生變數 6. 簡化條件邏輯 6.1 分解條件式(Decompose Conditional) 6.2 合併條件式(Consolidate Conditional Expression) 6.3 以衛述句取代巢狀條件式(Replace Nested Conditional with Guard Clauses) 6.4 以多型取代條件式(Replace Conditional with Polymorphism) 6.5 引入特例(Introduce Special Case) 6.6 引入斷言與以 break 取代控制旗標 7. API 與繼承重構 7.1 將查詢與修改分離(Separate Query from Modifier) 7.2 移除旗標參數與函式參數化(Remove Flag Argument/Parameterize Function) 7.3 保留完整物件與以查詢取代參數(Preserve Whole Object/Replace Parameter with Query) 7.4 以工廠函式取代建構式(Replace Constructor with Factory Function) 7.5 以例外取代錯誤碼(Replace Error Code with Exception) 7.6 繼承結構重構:上移、下移、提煉父類別與摺疊階層 7.7 以委託取代繼承(Replace Superclass/Subclass with Delegate) 7.8 公開函式庫的相容性檢查 8. 重構與測試:建立安全網 8.1 重構的安全網:為什麼測試是前提 8.2 特性測試(Characterization Test) 8.3 核准測試(Approval Test) 8.4 覆蓋率與變異測試 8.4.1 覆蓋率的意義與限制 8.4.2 用變異測試檢查安全網 8.5 重構友善的測試設計 8.6 等價性驗證:同一組測試驗證重構前後 8.7 重構測試檢查清單 9. TDD 與重構 9.1 紅燈—綠燈—重構循環詳解 9.2 實際 TDD 重構範例 9.3 重構測試程式碼 10. 遺留程式碼的重構 10.1 遺留程式碼變更演算法 10.2 接縫(Seam) 10.3 Sprout 與 Wrap:讓新程式碼保持可測試 10.4 打破相依的常用手法 10.5 Mikado 方法 10.6 探索性重構(Scratch Refactoring) 11. 大型與架構層級的重構 11.1 漸進式重構與大爆炸重寫 11.2 Strangler Fig 與平行執行 11.3 Branch by Abstraction 11.4 架構守護:用 ArchUnit 把規則寫成測試 11.5 功能旗標的生命週期 12. 資料庫與 API 的演進式重構 12.1 為什麼不能一次改名 12.2 擴充—遷移—收縮(Expand–Migrate–Contract) 12.3 API 的演進 12.4 事件與訊息格式的演進 13. Java 現代化重構 13.1 現代化的原則 13.2 sealed 型別與模式比對 switch 13.3 以 record 取代資料類別 13.4 以管線取代迴圈(Replace Loop with Pipeline) 13.5 Optional 的使用 13.6 文字區塊與其他語法 13.7 用 OpenRewrite 自動化現代化 14. 前端 TypeScript 重構 14.1 TypeScript 重構的安全網 14.2 以可辨識聯集取代型別碼 14.3 || 與 ??、&& 與 ?. 的差異 14.4 Promise 鏈改寫為 async/await 14.5 以 unknown 取代 any 14.6 以 codemod 進行大量修改 15. 重構工具與自動化 15.1 IDE 的自動化重構 15.2 靜態分析與品質門檻 15.3 CI 中的重構守護 15.4 編譯器警告與棄用追蹤 15.5 RefactoringMiner:在審查時辨識重構 15.6 工具選擇與配置 16. 效能與重構 16.1 重構與效能的關係 16.2 用 JMH 量測 16.3 效能監控與回歸 16.4 重構常見的效能退化 17. 團隊規範與最佳實務 17.1 重構的責任分配與協作 17.2 提交與 PR 的規範 17.3 程式碼審查中的重構 17.3.1 審查檢查清單 17.3.2 審查技巧:辨識搬移的程式碼 17.4 重構標準與約定 17.4.1 命名規範 17.4.2 程式碼組織約定 17.5 持續重構的團隊文化 17.5.1 重構意識培養 17.5.2 工具與流程整合 17.5.3 團隊重構最佳實務 17.6 重構培訓計畫 17.6.1 新人重構訓練 17.6.2 技能評估標準 18. AI 輔助重構 18.1 AI 輔助重構的機會與風險 18.2 給 AI 的重構提示 18.3 專案層級的 AI 指示檔 18.4 驗證 AI 產出的流程 18.5 AI 常見的重構錯誤 18.6 AI 代理的批次重構 19. 技術債管理與重構的度量 19.1 技術債與技術債象限 19.2 技術債登錄 19.3 熱點分析:決定先重構哪裡 19.4 重構的時機與投資配置 19.4.1 主動重構與被動重構 19.4.2 重構優先順序矩陣 19.4.3 容量配置 19.5 重構效益的評估與度量 20. 重構的反模式與常見陷阱 20.1 流程上的反模式 20.2 程式碼上的反模式 20.3 測試上的反模式 20.4 AI 協作的反模式 21. 綜合案例:活動票券對帳單 21.1 起點:需求與現有程式碼 21.2 建立安全網 21.3 重構步驟 21.4 重構後的程式碼 21.5 加入新功能 22. 練習與自我評量 22.1 能力評量架構 22.1.1 觀念能力 22.1.2 實作能力 22.2 觀念選擇題 22.3 情境分析題 22.4 程式碼重構實作題 22.4.1 Kata 1:會員點數(Java) 22.4.2 Kata 2:價格標籤(TypeScript) 22.5 AI 產出審查演練 22.6 綜合演練 22.7 評分基準 22.8 學習建議 23. 檢查清單 23.1 重構前檢查清單 23.1.1 環境準備 23.1.2 範圍評估 23.2 重構執行檢查清單 23.2.1 執行原則 23.2.2 常見重構步驟 23.3 重構後檢查清單 23.3.1 功能驗證 23.3.2 品質檢查 23.3.3 交付準備 23.4 緊急應對檢查清單 23.4.1 問題發現 23.4.2 修復策略 23.5 持續改善檢查清單 23.5.1 定期檢視 23.5.2 工具和流程優化 23.6 AI 產出審查檢查清單 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 手法速查表 B.1 Fowler 第二版重構目錄對照 B.2 依壞味道查手法 B.3 IDE 快捷鍵速查 附錄 C 設定檔與腳本 C.1 範例專案的 pom.xml C.2 PMD 規則集 C.3 Checkstyle 設定 C.4 GitHub Actions:重構型 PR 的守護流程 C.5 equivalence-check.sh C.6 refactor-guard.sh C.7 重構提案範本 附錄 D 名詞對照 附錄 E 參考資料 E.1 延伸閱讀:書籍 E.2 國際標準與規範 E.3 研究報告 E.4 線上資源 E.5 工具推薦 附錄 F 修訂紀錄與查證紀錄 F.1 v1.0 章節對照 F.2 v1.0 內容更正紀錄 F.3 查證紀錄 F.4 待確認事項 F.5 技術版本紀錄 0. 文件資訊與學習指南 0.1 為什麼要學重構 重構(refactoring)是「在不改變軟體可觀察行為的前提下,改善其內部結構」的一連串小步驟。它是每位工程師每天都在做的事,卻也最容易做錯: ...

October 31, 2025 · 149 min · 31539 words · Eric Cheng

物件導向分析與設計 (OOAD) 教學

物件導向分析與設計 (OOAD) 教學手冊 作者:系統架構師團隊 更新日期:2026 年 10 月 12 日 版本:v3.0 適用對象:新進開發同仁、資深工程師、技術主管、Code Reviewer 技術基準:OMG UML 2.5.1、ISO/IEC 25010:2023、Java 25、JUnit 6.1、ArchUnit 1.5、Mermaid 11 目錄 0. 文件資訊與使用方式 0.1 文件資訊 0.2 如何使用本手冊 0.3 指引條目的格式與編號 0.4 範例的驗證方式 1. 前言與學習目標 1.1 為什麼要學習 OOAD 1.2 學習目標 1.3 學習路徑與建議時數 1.4 前置知識與環境準備 1.5 本章自我檢核 2. 物件導向基礎概念 2.1 物件與類別 2.2 封裝 2.3 抽象 2.4 繼承與組合 2.5 多型 2.6 值物件、實體與相等性 2.7 介面與抽象類別 2.8 實務案例:學生管理模型 2.9 練習題 2.10 章節小結 3. 設計原則:SOLID、GRASP 與契約式設計 3.1 單一職責原則(SRP) 3.2 開放封閉原則(OCP) 3.3 里氏替換原則(LSP) 3.4 介面隔離原則(ISP) 3.5 依賴反轉原則(DIP) 3.6 GRASP:職責指派的九個模式 3.7 迪米特法則、KISS 與 YAGNI 3.8 契約式設計 3.9 以自動化測試守護設計原則 3.10 練習題 3.11 章節小結 4. OOAD 開發流程 4.1 流程概覽:迭代與增量 4.2 需求分析 4.3 領域分析與領域模型 4.4 Use Case 分析 4.5 強健性分析 4.6 架構設計 4.7 詳細設計:從系統事件到物件互動 4.8 實作:從設計到程式碼 4.9 測試與驗證 4.10 追溯性 4.11 練習題 4.12 章節小結 5. UML 2.5.1 建模實務 5.1 UML 簡介與標準現況 5.2 UML 2.5.1 的 14 種圖形 5.3 Use Case 圖 5.4 類別圖 5.5 物件圖 5.6 套件圖 5.7 循序圖 5.8 通訊圖 5.9 活動圖 5.10 狀態機圖 5.11 元件圖與部署圖 5.12 其他圖形 5.13 OCL 基礎 5.14 Mermaid、PlantUML 與 UML 標準記法的差異 5.15 UML 工具選型 5.16 建模最佳實務與圖形審查清單 5.17 練習題 5.18 章節小結 6. 專案實務:大學選課系統 6.1 專案背景與需求 6.2 Use Case 6.3 領域模型與詞彙表 6.4 架構設計 6.5 設計類別圖 6.6 關鍵循序圖 6.7 實作 6.8 測試 6.9 已知限制與演進方向 6.10 章節小結 7. 領域驅動設計(DDD)戰術模式與 OOAD 的銜接 7.1 通用語言與限界上下文 7.2 實體與值物件 7.3 聚合 7.4 領域服務與應用服務 7.5 儲存庫 7.6 工廠 7.7 領域事件 7.8 練習題 7.9 章節小結 8. 設計模式實務 8.1 GoF 模式分類 8.2 Strategy 模式 8.3 Observer 模式與事件通知 8.4 Factory Method 與靜態工廠方法 8.5 Template Method 與 Strategy 的選擇 8.6 Decorator 模式 8.7 Adapter 模式 8.8 State 模式 8.9 Singleton 的風險 8.10 審查模式的使用 8.11 練習題 8.12 章節小結 9. 常見錯誤與最佳實務 9.1 分析階段常見錯誤 9.2 設計階段常見錯誤 9.3 實作階段常見錯誤 9.4 程式碼可讀性 9.5 安全設計 9.6 效能考量 9.7 練習題 9.8 章節小結 10. AI 輔助 OOAD 的實務與審查 10.1 適用與不適用的情境 10.2 AI 輔助的 OOAD 流程 10.3 結構化提示 10.4 資料保護與合規 10.5 AI 產出的程式碼 10.6 練習題 10.7 章節小結 11. UML 認證(OCUP 2)準備 11.1 認證概述 11.2 Foundation 考試範圍 11.3 Intermediate 與 Advanced 考試範圍 11.4 重點知識整理 11.5 模擬題與解析 11.6 準備計畫 11.7 學習資源 11.8 章節小結 12. 能力評量與成長路徑 12.1 能力模型與評量量表 12.2 知識與技能自我檢核 12.3 實作評量 12.4 成長路徑 12.5 學習紀錄範本 12.6 章節小結 13. 專案交付與審查檢查清單 13.1 需求分析檢查清單 13.2 設計審查檢查清單 13.3 實作檢查清單 13.4 Code Review 檢查清單 13.5 專案交付檢查清單 13.6 章節小結 14. 延伸閱讀與參考資料 14.1 OOAD 與 UML 經典書籍 14.2 設計原則、模式與領域驅動設計 14.3 架構與軟體工程 14.4 國際標準與規格 14.5 線上資源與工具 14.6 本站相關教學與指引 14.7 結語 附錄 A 指引總表 附錄 B v2.1 至 v3.0 章節對照 附錄 C 修正紀錄 附錄 D 驗證紀錄 附錄 E 待確認事項 附錄 F 版本歷程 0. 文件資訊與使用方式 0.1 文件資訊 項目 內容 文件名稱 物件導向分析與設計 (OOAD) 教學手冊 版本 v3.0(全面改版,變更內容見附錄 B與附錄 C) 更新日期 2026-10-12 作者 系統架構師團隊 適用對象 新進開發同仁、資深工程師、技術主管、Code Reviewer 文件定位 企業內部技術白皮書等級的教學手冊:教會「怎麼做」,也教會「怎麼審查與驗證別人做得對不對」 本版技術基準(所有程式範例皆以此基準實際編譯與執行,結果見附錄 D): ...

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

資料流程圖(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