Class Diagram · 類別圖

---
doc_type: "class-diagram"
variant: "light"
status: "draft"
owner: "<your-name>"
last_updated: "YYYY-MM-DD"
upstream:
  required: ["data-model", "use-case"]
  optional: ["module-design", "api-spec"]
---

# Class Diagram: <domain-name>

**Status:** Draft · **Owner:** <SD> · **Last updated:** YYYY-MM-DD

> [!IMPORTANT]
> **AI 填寫規則：** 本範本 5 段（編號 1, 2, 3, 9, 12），全部必填——刻意沿用完整版的章節編號讓兩版可對照。每結論行內加 `（依據：data-model §XXX / use-case §YYY）`；每欄位帶 `[H]/[M]/[L]` confidence badge；缺資料寫 `_TODO: 需要 XXX_` 不編造類別或關聯；**核心紀律：模型領域，不模型 boilerplate；組合優先於繼承**；**每條 relationship 必標多重度（如 "1" / "*"）**；類別不可只有 getter/setter（anemic model 不接受），至少帶 1 個有行為的方法。

---

## 1. Executive Summary

<!-- ai-fill: 3-5 行說明本圖涵蓋的 domain、含幾個類別、aggregate root 是誰、最關鍵的 invariant -->

<3-5 行說明：本圖建哪個領域模型、aggregate root、最關鍵 invariant>

> **TL;DR:** <一句話：Order aggregate root + LineItem composition + Customer association，核心 invariant 是 total = Σ line items>

---

## 2. Class Diagram

```mermaid
classDiagram
    class Customer {
        +CustomerId id
        +string name
        +Email email
        +placeOrder(cart) Order
    }
    class Order {
        +OrderId id
        +OrderStatus status
        +Money total
        +addLineItem(product, qty) void
        +confirm() void
        +recalcTotal() Money
    }
    class LineItem {
        +ProductId productId
        +int quantity
        +Money unitPrice
        +subtotal() Money
    }
    Customer "1" --> "*" Order : places
    Order "1" *-- "1..*" LineItem : contains
```

---

## 3. Class Responsibilities

| Class | Responsibility | Key invariants | Confidence |
|---|---|---|---|
| Customer | 帳戶身分 + 下單入口 | email 唯一且已驗證 | **[H]** |
| Order | aggregate root；訂單狀態與金額一致性 | total = Σ lineItem.subtotal；至少 1 個 LineItem | **[H]** |
| LineItem | 單一商品行；數量 × 單價 | quantity ≥ 1；unitPrice ≥ 0 | **[H]** |

---

## 9. Design Risks

<!-- ai-rule: 至少列 3 個（anemic domain model / god class / inheritance-over-composition） -->

> **R1:** <e.g. Order 若只剩 getter/setter，金額一致性散到 service = anemic domain model> — **Mitigation:** invariant 收進 Order.recalcTotal()
>
> **R2:** <e.g. Order 同時管狀態機 + 金額 + 出貨 = god class> — **Mitigation:** 拆出 ShippingPolicy 值物件
>
> **R3:** <e.g. 用繼承表達 OrderType 變體導致深繼承樹> — **Mitigation:** 組合優先於繼承，用 strategy

---

## 12. Confidence & Sources & TODO

- **整份文件最低 confidence 欄位：** <列出所有 [L] 與 [M]>
- **Fabricated assumptions（推測但 input 未明說）：**
  - <假設 1：例：假設 Order 為 aggregate root（data-model 未明示邊界）>
- **Highest-value next input:** <下一份最該補的：完整 use case 例外流程 / DBA ORM mapping 確認>

### TODO（缺資料）

- _TODO: 需要 Architect 確認 Order / Customer 是否屬同一 aggregate_

---

> [!CAUTION]
> **輸出前 AI 自檢：**
> - [ ] 5 段 H2 章節齊全（編號 1, 2, 3, 9, 12，刻意不連號）
> - [ ] Class Diagram 含 mermaid classDiagram（屬性帶型別、方法帶行為）
> - [ ] 每條 relationship 標多重度（"1" / "*" / "1..*"）
> - [ ] 無 anemic-model-only 類別（每類別至少 1 個有行為方法）
> - [ ] aggregate root 已標明
> - [ ] 無 YAML / JSON schema 輸出（schema 屬 data-model 卡）