闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
[memo]PlantUML
Use Case 圖 — 功能/需求初步視覺化
Sequence 圖 — 顯示系統內流程與物件互動
Class 圖 — 類別結構草圖,幫助模組拆解
UML圖完全指南:10分鐘掌握14種UML圖 - ProcessOn
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
「UML」「系統分析與設計」
「UML 三圖教學」
《UML 精華:標準物件模型語言簡明指南》
《UML 實戰與應用》
臺灣清華大學 陳鍾誠 UML 系列
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
額外 C4 Model
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
學習上是先UML再C4 Model,但實作時順序反過來
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
需求分析 & 系統設計(SA)
↓(使用 PlantUML 畫圖)
產出完整 UML 圖(.puml)
↓(自動或半自動轉換)
生成 Mermaid 語法(.md / .mmd)

內嵌 GitHub Wiki 展示
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
[PlantUML Sequence Diagram]

[語法轉換器]
↙ ↘
[Mermaid Sequence] [Mermaid Flowchart]
→ GitHub Wiki → 對外簡報/需求分析
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
| 類別 | 規範說明 | 原因 |
| -|- | --- |
| 語言 | 統一以繁體中文為主,角色/類別/方法名可用英文 | 保留語意清晰,兼顧國際化代碼習慣 |
| 命名風格 | 使用 CamelCase,避免空格(使用者登入使用者登入UseCase) | 方便程式判斷、後續轉換 |
| 註解 | 使用 note 搭配標記,如 public, internal, ignore | 協助轉成 Flowchart 或篩選圖內容 |
| 檔名約定 | 檔名加圖型前綴,如 UC_登入.puml, SEQ_登入流程.puml, CLS_使用者類別.puml | 系統化分類便於管理與轉換 |
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
↑通用規則(適用所有圖型)
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
補充:標記語意使用範例(支援轉換用途)
| 標記 | 用途 | 說明 |
| ----||- |
| public | 轉出 Flowchart 用 | 表示此資訊對非技術人員可見 |
| internal | 技術實作說明 | 僅開發參考,不轉到流程圖 |
| ignore | 排除項目 | 不進行任何轉換 |
| alias=XX | 轉換名稱對應用 | 轉換時使用不同名稱(如 class ➜ DB table) |
這些標記可放在 note 中,由轉換器程式擷取使用。
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
https://images.plurk.com/59E8zruXYSgYD28C1N46Kk.png https://images.plurk.com/5YWoC1XFkYSIFwa2u9CFLP.png https://images.plurk.com/1gvBv99TsBC7B44A6l094r.png
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
1. UC https://images.plurk.com/4UtK9xTIWBmRUIvte3O7Zb.png https://images.plurk.com/4Cq2iaojyCpnEU8W52KeZu.png
2. Seq https://images.plurk.com/7xOehOuyWzBm0vV9w62RAU.png https://images.plurk.com/1AG6WfOKCvQqF4iDdeeaRR.png
3. Class https://images.plurk.com/5g1cwmfZLylP409RNfuzhk.png https://images.plurk.com/6q5FH4h73fQvqfXEOrFstv.png
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
通用 https://images.plurk.com/7kxOFY50dUUTz4vfQLstVE.png https://images.plurk.com/74VWE5UVlVXhuZtLM51naa.png
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
闇鍋羽翼⎝(゚ˊ_>ˋ)⎠
想想還是改用Mermaid好了
畢竟方便快速溝通,然後支援度不高導致可用手段少=限縮複雜性無法過高。
載入新的回覆