面向物件高層設計與低層設計：架構視圖、子系統劃分、類別詳細設計與復用原則

高層設計 (架構設計)

核心目標

• 建立系統整體結構模型：子系統、模組、層次、介面、資料流、部署拓撲。
• 識別在具體運算環境下解決問題所需的技術概念：資料庫、訊息佇列、快取、認證、日誌、監控等基礎設施類別。
• 最小化子系統間通訊複雜度，將高度互動的類別邏輯分組。

典型架構視圖 (4+1 視圖模型簡化)

• 邏輯視圖：類別圖、套件圖 — 核心領域模型、服務介面。
• 實作視圖：元件圖 — 組件、程式庫、DLL、微服務邊界。
• 部署視圖：節點圖 — 伺服器、容器、雲端資源、網路拓撲。
• 程序視圖：序列圖、活動圖 — 關鍵用例流程、併發、同步。
• 資料視圖：ER 圖、Schema — 持久化模型、遷移策略。

高層設計決策清單

低層設計 (詳細設計)

核心目標

• 形成單一概念模型：一個類別代表一個概念。
• 設計構件具備可復用性與可靠性。
• 套用資訊隱藏、高內聚低耦合、SOLID 原則。

類別設計檢核表

復用策略

• 組合優於繼承：策略模式、裝飾者、組合模式。
• 框架/函式庫復用：NuGet 套件、內部共用元件。
• 生成器/原始碼產生：Source Generators、T4、Roslyn 分析器。
• 避免複製貼上：提取共用邏輯至基類別/擴充方法/服務。

從高層到低層的可追溯性

1. 架構決策記錄 (ADR) 文件化關鍵選擇。
2. 子系統介面契約 (OpenAPI/gRPC proto) 定義邊界。
3. 類別圖標註對應用例/需求 ID。
4. 程式碼註解連結設計文件 (如 // See ADR-003)。