1Ticket：實作書籍收藏功能
2
3變更範圍：
4- lib/ui/pages/book_detail_page.dart       (Layer 1)
5- lib/application/controllers/book_detail_controller.dart  (Layer 2)
6- lib/usecases/add_book_to_favorite_usecase.dart  (Layer 3)
7- lib/domain/entities/favorite.dart        (Layer 5)

 1需求/問題產生
 2    |
 3    v
 4建立 Ticket (/ticket create)
 5    |
 6    v
 7Ticket 狀態: pending
 8    |
 9    v
10認領 Ticket (/ticket track claim)
11    |
12    v
13Ticket 狀態: in_progress
14    |
15    +-- 正常完成 --> /ticket track complete --> 狀態: completed
16    |
17    +-- 無法繼續 --> /ticket track release --> 狀態: blocked
18    |                                              |
19    |                                              v
20    |                                         升級到 PM 處理
21    |
22    v
23完成

 1============================================================
 2[任務鏈後續步驟建議]
 3============================================================
 4
 5已完成: 0.31.0-W4-007.1
 6        [實作 track P0 功能]
 7
 8任務鏈進度: 1/3 completed
 9   Root: 0.31.0-W4-007
10
11建議下一步:
12   1. 0.31.0-W4-007.2
13      [實作 track P1 功能]
14      原因: 阻塞已解除（blockedBy 0.31.0-W4-007.1 已完成）
15      狀態: pending → 可認領

10.31.0-W3-002              # ticket-handoff 功能（根）
2├── 0.31.0-W3-002.1        # chain_analyzer 模組
3│   ├── 0.31.0-W3-002.1.1  # 問題修復
4│   └── 0.31.0-W3-002.1.2  # 測試補充
5├── 0.31.0-W3-002.2        # handoff_executor 模組
6└── 0.31.0-W3-002.3        # 文件更新

1chain:
2  root: "0.31.0-W3-002"
3  parent: null
4  depth: 0
5  sequence: [2]

1chain:
2  root: "0.31.0-W3-002"
3  parent: "0.31.0-W3-002.1"
4  depth: 2
5  sequence: [2, 1, 1]

 1任務層級判斷
 2    |
 3    v
 4這個任務是否因為執行現有 Ticket 而產生？
 5    |
 6    +-- 是 → 來源 Ticket 是什麼？
 7    |       |
 8    |       └── 確定來源 Ticket ID → 建立該 Ticket 的子任務
 9    |           ├── 來源: 010.4 → 子任務 ID: 010.4.x
10    |           ├── 來源: 010.4.1 → 子任務 ID: 010.4.1.x
11    |           └── 來源: 010 → 子任務 ID: 010.x
12    |
13    └-- 否 → 建立新任務鏈（新的 Wx-00n）

 1---
 2id: {版本}-W{波次}-{序號}
 3title: {動詞} {目標}
 4type: IMP/RES/ANA/INV/DOC
 5status: pending
 6priority: P0/P1/P2
 7assignee: pending
 8created: {日期}
 9---
10
11# {Ticket ID}: {標題}
12
13## 目標
14
15{目標描述}
16
17## 驗收條件
18
19- [ ] {條件1}
20- [ ] {條件2}

1## Acceptance Criteria
2
3| #   | 項目       | 來源       | 確認方法   | 狀態 |
4| --- | ---------- | ---------- | ---------- | ---- |
5| 1   | {項目描述} | {來源引用} | {確認方法} | [ ]  |
6| 2   | {項目描述} | {來源引用} | {確認方法} | [ ]  |

 1認領 Ticket
 2    |
 3    v
 4執行對應階段工作
 5    |
 6    v
 7更新工作日誌
 8    |
 9    v
10驗證驗收條件
11    |
12    +-- 全部通過 --> 完成 Ticket
13    +-- 部分通過 --> 繼續處理或升級
14    +-- 無法完成 --> 釋放 Ticket

1Ticket 設計派工方法論 (主方法論)
2├── Ticket 拆分標準方法論 ← 你正在閱讀
3│   └── 提供量化拆分標準和決策樹
4├── Code Smell 品質閘門檢測方法論
5│   └── 提供設計階段的品質檢測
6├── Ticket 生命週期管理方法論
7│   └── 提供 Ticket 執行流程管理
8└── 即時 Review 機制方法論
9    └── 提供執行過程中的 Review 機制

 1範例任務：實作書籍評分功能
 2
 3職責識別：
 41. 定義 Rating Value Object（數值範圍驗證）      ← 職責 1
 52. 定義 Rating Entity（包含評分和評論）         ← 職責 2
 63. 實作 IRatingRepository 介面                  ← 職責 3
 74. 實作評分儲存邏輯                              ← 職責 4
 85. 處理無效評分錯誤                              ← 職責 5
 96. 處理資料庫錯誤                                ← 職責 6
10
11總計：6 個職責 → 超過 5 個，必須拆分

1任務：定義 SelectionManager 介面方法簽名
2
3職責分析：
4職責 1：定義 toggleSelection、clearSelection、getSelectedIds 三個方法簽名
5
6總計：1 個職責
7判定：簡單 Ticket

1任務：實作 SelectionManager 基礎功能
2
3職責分析：
4職責 1：實作 toggleSelection 方法
5職責 2：實作 clearSelection 方法
6職責 3：實作 ChangeNotifier 通知機制
7
8總計：3 個職責
9判定：中等 Ticket（可接受）

 1任務：實作完整的 BookRepository
 2
 3職責分析：
 4職責 1：實作 getBookByIsbn CRUD 方法
 5職責 2：實作 saveBook CRUD 方法
 6職責 3：實作 Data Mapper 轉換
 7職責 4：實作錯誤處理
 8職責 5：實作 Cache 管理
 9
10總計：5 個職責
11判定：複雜 Ticket（建議拆分為 2-3 個 Ticket）

 1任務：實作書籍評分完整功能（包含 UI、UseCase、Repository）
 2
 3職責分析：
 4職責 1：定義 Rating Value Object
 5職責 2：定義 Rating Entity
 6職責 3：建立 RatingWidget UI
 7職責 4：實作 RateBookUseCase
 8職責 5：定義 IRatingRepository
 9職責 6：實作 SQLiteRatingRepository
10職責 7：處理各種異常情境
11職責 8：撰寫完整測試
12
13總計：8 個職責
14判定：God Ticket 必須拆分

1拆分為 4 個 Ticket：
2
3- Ticket 1: 定義 Rating Domain 模型（職責 1, 2）
4- Ticket 2: 實作 RatingRepository（職責 5, 6）
5- Ticket 3: 實作 RateBookUseCase（職責 4, 7）
6- Ticket 4: 實作 RatingWidget UI（職責 3, 8）

 1# 統計修改行數
 2git diff --stat
 3
 4# 範例輸出
 5lib/domain/entities/book.dart        | 25 +++++++++++++
 6lib/domain/repositories/i_repo.dart  | 15 ++++++--
 7test/unit/domain/book_test.dart      | 40 ++++++++++++++++++++
 83 files changed, 78 insertions(+), 2 deletions(-)
 9
10# 計算方式
11總行數 = 新增行數 + 修改行數 + 刪除行數
12      = 25 + 15 + 40 = 80 行

 1// 任務：定義 IBookRepository 介面
 2// lib/domain/repositories/i_book_repository.dart
 3
 4abstract class IBookRepository {
 5  /// 根據 ISBN 取得書籍
 6  Future<Book?> getBookByIsbn(String isbn);
 7
 8  /// 儲存書籍
 9  Future<void> saveBook(Book book);
10
11  /// 刪除書籍
12  Future<void> deleteBook(String isbn);
13}
14
15// 預估行數：~20 行（含註解）
16// 判定：簡單 Ticket

 1// 任務：實作 Rating Value Object
 2// lib/domain/value_objects/rating.dart + test
 3
 4// rating.dart (~40 行)
 5class Rating {
 6  final int value;
 7
 8  Rating(this.value) {
 9    if (value < 1 || value > 5) {
10      throw ValidationException.invalidRating(value);
11    }
12  }
13
14  // ... 其他方法（equals, hashCode, toString）
15}
16
17// rating_test.dart (~25 行)
18void main() {
19  test('建立有效評分', () { ... });
20  test('評分過低拋出異常', () { ... });
21  test('評分過高拋出異常', () { ... });
22}
23
24// 總計：~65 行
25// 判定：中等 Ticket

 1// 任務：實作完整的 BookRepository
 2// lib/infrastructure/repositories/sqlite_book_repository.dart + test
 3
 4// repository.dart (~80 行)
 5class SQLiteBookRepository implements IBookRepository {
 6  // ... 建構子和欄位定義
 7
 8  @override
 9  Future<Book?> getBookByIsbn(String isbn) async {
10    // ... SQL 查詢邏輯（~15 行）
11    // ... Data Mapper 轉換（~10 行）
12    // ... 錯誤處理（~5 行）
13  }
14
15  @override
16  Future<void> saveBook(Book book) async {
17    // ... SQL 插入/更新邏輯（~20 行）
18    // ... Data Mapper 轉換（~10 行）
19    // ... 錯誤處理（~5 行）
20  }
21
22  @override
23  Future<void> deleteBook(String isbn) async {
24    // ... SQL 刪除邏輯（~10 行）
25    // ... 錯誤處理（~5 行）
26  }
27}
28
29// repository_test.dart (~80 行)
30// ... 8 個測試案例
31
32// 總計：~160 行
33// 判定：超過 100 行，必須拆分

1拆分為 3 個 Ticket：
2
3- Ticket 1: 定義 IBookRepository 介面（~20 行）
4- Ticket 2: 實作 getBookByIsbn + 測試（~60 行）
5- Ticket 3: 實作 saveBook + deleteBook + 測試（~80 行）

1# 統計修改檔案數
2git diff --name-only | grep -v '_test\.dart$' | wc -l
3
4# 範例輸出
5lib/domain/entities/book.dart
6lib/domain/repositories/i_book_repository.dart
7lib/infrastructure/repositories/sqlite_book_repository.dart
8
9# 結果：3 個檔案（不含測試）

1任務：建立 Rating Value Object
2
3涉及檔案：
4lib/domain/value_objects/rating.dart
5
6總計：1 個檔案
7判定：簡單 Ticket

1任務：更新 Book Entity 增加評分欄位
2
3涉及檔案：
4lib/domain/entities/book.dart         （修改）
5lib/domain/value_objects/rating.dart  （新增）
6
7總計：2 個檔案
8判定：中等 Ticket

 1任務：實作完整的書籍評分功能
 2
 3涉及檔案：
 4lib/domain/entities/rating.dart
 5lib/domain/entities/book.dart
 6lib/domain/repositories/i_rating_repository.dart
 7lib/infrastructure/repositories/sqlite_rating_repository.dart
 8lib/infrastructure/mappers/rating_mapper.dart
 9
10總計：5 個檔案
11判定：複雜 Ticket（建議拆分）

 1任務：實作評分功能（含 UI、UseCase、Repository）
 2
 3涉及檔案：
 4lib/presentation/widgets/rating_widget.dart
 5lib/presentation/controllers/rating_controller.dart
 6lib/application/use_cases/rate_book_use_case.dart
 7lib/domain/entities/rating.dart
 8lib/domain/entities/book.dart
 9lib/domain/repositories/i_rating_repository.dart
10lib/infrastructure/repositories/sqlite_rating_repository.dart
11lib/infrastructure/mappers/rating_mapper.dart
12
13總計：8 個檔案
14判定：God Ticket，必須拆分

1按 Clean Architecture 分層拆分為 4 個 Ticket：
2
3- Ticket 1: Domain 層（檔案 4, 5, 6）             - 3 個檔案
4- Ticket 2: Infrastructure 層（檔案 7, 8）        - 2 個檔案
5- Ticket 3: Application 層（檔案 3）              - 1 個檔案
6- Ticket 4: Presentation 層（檔案 1, 2）          - 2 個檔案

 1// 計算測試方法數
 2void main() {
 3  group('Rating Value Object', () {
 4    test('建立有效評分', () { ... });           // 測試 1
 5    test('評分過低拋出異常', () { ... });        // 測試 2
 6    test('評分過高拋出異常', () { ... });        // 測試 3
 7    test('相同評分視為相等', () { ... });        // 測試 4
 8  });
 9}
10
11// 總計：4 個測試

 1// 任務：定義 Rating Value Object
 2
 3void main() {
 4  group('Rating Value Object', () {
 5    test('建立有效評分', () {
 6      final rating = Rating(4);
 7      expect(rating.value, 4);
 8    });
 9
10    test('評分過低拋出異常', () {
11      expect(() => Rating(0), throwsA(isA<ValidationException>()));
12    });
13
14    test('評分過高拋出異常', () {
15      expect(() => Rating(6), throwsA(isA<ValidationException>()));
16    });
17  });
18}
19
20// 總計：3 個測試
21// 判定：簡單 Ticket

 1// 任務：實作 BookRepository.getBookByIsbn
 2
 3void main() {
 4  group('BookRepository.getBookByIsbn', () {
 5    test('成功取得存在的書籍', () { ... });          // 測試 1
 6    test('書籍不存在回傳 null', () { ... });          // 測試 2
 7    test('無效 ISBN 拋出 ValidationException', () { ... }); // 測試 3
 8    test('資料庫錯誤拋出 StorageException', () { ... });    // 測試 4
 9    test('資料庫連線失敗拋出 NetworkException', () { ... }); // 測試 5
10  });
11}
12
13// 總計：5 個測試
14// 判定：中等 Ticket

 1// 任務：實作完整的 BookRepository CRUD
 2
 3void main() {
 4  group('BookRepository CRUD', () {
 5    // getBookByIsbn 測試
 6    test('取得存在的書籍', () { ... });              // 測試 1
 7    test('書籍不存在回傳 null', () { ... });         // 測試 2
 8
 9    // saveBook 測試
10    test('新增書籍成功', () { ... });                // 測試 3
11    test('更新書籍成功', () { ... });                // 測試 4
12    test('儲存時資料庫錯誤', () { ... });            // 測試 5
13
14    // deleteBook 測試
15    test('刪除存在的書籍', () { ... });              // 測試 6
16    test('刪除不存在的書籍', () { ... });            // 測試 7
17    test('刪除時資料庫錯誤', () { ... });            // 測試 8
18
19    // Data Mapper 測試
20    test('Entity 轉 DTO 正確', () { ... });          // 測試 9
21    test('DTO 轉 Entity 正確', () { ... });          // 測試 10
22  });
23}
24
25// 總計：10 個測試
26// 判定：複雜 Ticket（達上限，建議拆分）

1拆分為 3 個 Ticket：
2
3- Ticket 1: getBookByIsbn + 測試（2 個測試）    
4- Ticket 2: saveBook + 測試（3 個測試）         
5- Ticket 3: deleteBook + Mapper + 測試（5 個測試）

1Ticket 複雜度 = max(職責複雜度, 行數複雜度, 檔案數複雜度, 測試數複雜度)
2
3where 複雜度等級：
4  簡單 = 1
5  中等 = 2
6  複雜 = 3
7  必須拆分 = 4

 1任務：定義 Rating Value Object
 2
 3指標評估：
 4
 5- 職責數量：1 個職責 → 簡單
 6- 程式碼行數：25 行 → 簡單
 7- 涉及檔案：1 個檔案 → 簡單
 8- 測試用例：3 個測試 → 簡單
 9
10最終判定：簡單 Ticket（最理想狀態）

 1任務：實作 Rating Value Object
 2
 3指標評估：
 4
 5- 職責數量：2 個職責（建立、驗證）→ 中等
 6- 程式碼行數：45 行 → 中等
 7- 涉及檔案：1 個檔案 → 簡單
 8- 測試用例：5 個測試 → 中等
 9
10最終判定：中等 Ticket（可接受）

 1任務：實作 BookRepository.getBookByIsbn
 2
 3指標評估：
 4
 5- 職責數量：3 個職責（查詢、轉換、異常處理）→ 複雜
 6- 程式碼行數：65 行 → 中等
 7- 涉及檔案：2 個檔案 → 中等
 8- 測試用例：6 個測試 → 複雜
 9
10最終判定：複雜 Ticket（建議拆分）

 1任務：實作完整的書籍評分功能
 2
 3指標評估：
 4
 5- 職責數量：8 個職責 → 必須拆分
 6- 程式碼行數：180 行 → 必須拆分
 7- 涉及檔案：7 個檔案 → 必須拆分
 8- 測試用例：15 個測試 → 必須拆分
 9
10最終判定：God Ticket 必須立即拆分

1步驟 1：計算 4 個指標
2    ↓
3步驟 2：取最高複雜度等級
4    ↓
5    ├─ 簡單 → 可直接建立 Ticket
6    ├─ 中等 → 可直接建立 Ticket（可選：評估是否拆分為更小 Ticket）
7    ├─ 複雜 → 強烈建議拆分（可選：無法拆分時勉強接受）
8    └─ 必須拆分 → 阻止建立，必須先拆分再重新評估

1□ 已計算 4 個指標的值
2□ 已確定每個指標的複雜度等級
3□ 已取最高複雜度等級作為最終判定
4□ 如為「必須拆分」，已執行拆分並重新評估
5□ 如為「複雜」，已評估是否可拆分為更小 Ticket

 1步驟 1: 初步評估（基於任務描述）
 2    ↓
 3    計算 4 個指標的預估值
 4    ↓
 5步驟 2: 複雜度確認（取最高等級）
 6    ↓
 7    取 4 個指標中最高的複雜度等級
 8    ↓
 9步驟 3: 拆分決策（基於等級決定）
10    ↓
11    ├─ Level 1-2 → 可直接建立 Ticket
12    ├─ Level 3 → 評估是否可拆分
13    └─ Level 4 → 必須拆分

 1範例任務：實作 Book Entity
 2
 3步驟 1-1：估算職責數量
 4- 分析任務描述，列出所有需要完成的功能點
 5- 功能點 1：定義 Entity 欄位
 6- 功能點 2：實作 equals/hashCode
 7- 功能點 3：實作 toString
 8- 功能點 4：撰寫測試
 9→ 預估：4 個職責
10
11步驟 1-2：估算程式碼行數
12- 根據類似任務經驗估算
13- Entity 定義：~30 行
14- equals/hashCode：~15 行
15- toString：~5 行
16- 測試：~40 行
17→ 預估：~90 行
18
19步驟 1-3：估算檔案數量
20- 列出需要建立/修改的檔案
21- lib/domain/entities/book.dart（新增）
22- test/unit/domain/entities/book_test.dart（新增）
23→ 預估：2 個檔案（1 個生產 + 1 個測試）
24
25步驟 1-4：估算測試數量
26- 根據驗收條件估算測試案例
27- 測試 Entity 建立
28- 測試 equals（相等/不等）
29- 測試 hashCode
30- 測試 toString
31→ 預估：5 個測試

1對應 4 個指標到複雜度等級：
2
3職責數量：4 個 → Level 3（複雜）
4程式碼行數：90 行 → Level 3（複雜）
5檔案數量：2 個（1 生產 + 1 測試）→ Level 2（中等）
6測試數量：5 個 → Level 2（中等）
7
8取最高等級：Level 3（複雜）

1□ 已計算所有 4 個指標
2□ 已對應每個指標到複雜度等級
3□ 已確定最高複雜度等級
4□ 已記錄評估依據

 1Level 1-2 → 可直接建立 Ticket
 2    ├─ 無需拆分
 3    └─ 直接進入 Phase 2（測試設計）
 4
 5Level 3 → 評估是否可拆分
 6    ├─ 可拆分為 Level 1-2 → 執行拆分
 7    └─ 無法拆分 → 勉強接受，加強 Review
 8
 9Level 4 → 必須拆分
10    ├─ 阻止建立 Ticket
11    ├─ 執行拆分（使用第三章拆分策略）
12    └─ 重新評估每個拆分後的子 Ticket

 1範例：實作 Book Entity（Level 3）
 2
 3拆分評估：
 41. 是否可拆分為更小 Ticket？
 5   → 是，可拆分為兩個 Ticket
 6
 72. 如何拆分？
 8   Ticket A: 定義 Book Entity 欄位和基礎方法
 9   - 職責：定義欄位 + equals/hashCode
10   - 行數：~45 行
11   - 檔案：1 個
12   - 測試：3 個
13   → Level 2（中等）
14
15   Ticket B: 補充 Book Entity 完整功能
16   - 職責：toString + 完整測試
17   - 行數：~45 行
18   - 檔案：1 個（修改）
19   - 測試：2 個
20   → Level 1（簡單）
21
223. 拆分後依賴關係？
23   → Ticket B 依賴 Ticket A（B 在 A 完成後執行）
24
254. 拆分價值評估？
26   → 降低風險：兩個 Level 1-2 比一個 Level 3 更易管理
27   → 易於 Review：分兩次 Review，每次範圍更小
28   → 成本：增加一個 Ticket，但風險降低值得
29
30結論：建議拆分

 1範例：實作完整書籍評分功能（Level 4）
 2
 3當前狀態：
 4
 5- 職責：8 個 → Level 4
 6- 行數：180 行 → Level 4
 7- 檔案：7 個 → Level 4
 8- 測試：15 個 → Level 4
 9
10拆分決策：必須拆分（無選項）
11
12拆分方式：使用「基於 Clean Architecture 分層拆分策略」（詳見第三章）

 1[開始評估]
 2    ↓
 3[計算 4 個指標]
 4    ↓
 5[取最高複雜度等級]
 6    ↓
 7    ├─ Level 1（簡單）
 8    │   ↓
 9    │   [可直接建立 Ticket]
10    │   ↓
11    │   [進入 Phase 2：測試設計]
12    │
13    ├─ Level 2（中等）
14    │   ↓
15    │   [可直接建立 Ticket]
16    │   ↓
17    │   [（可選）評估是否拆分為更小 Ticket]
18    │   ↓
19    │   [進入 Phase 2：測試設計]
20    │
21    ├─ Level 3（複雜）
22    │   ↓
23    │   [評估是否可拆分]
24    │   ↓
25    │   ├─ 可拆分？
26    │   │   ├─ Yes → [執行拆分]
27    │   │   │           ↓
28    │   │   │       [重新評估子 Ticket]
29    │   │   │           ↓
30    │   │   │       [確保所有子 Ticket 為 Level 1-2]
31    │   │   │
32    │   │   └─ No → [勉強接受]
33    │   │              ↓
34    │   │          [標記為高風險 Ticket]
35    │   │              ↓
36    │   │          [加強 Review 機制]
37    │   │              ↓
38    │   │          [進入 Phase 2]
39    │
40    └─ Level 4（超標）
41        ↓
42        [禁止建立 Ticket]
43        ↓
44        [阻止進入 Phase 2]
45        ↓
46        [必須拆分（使用第三章策略）]
47        ↓
48        [重新評估所有子 Ticket]
49        ↓
50        [確保所有子 Ticket ≤ Level 3]

 1問題：此 Ticket 是否可拆分為更小 Ticket？
 2
 3評估準則：
 41. 職責是否可分離？
 5   - 是否包含多個獨立功能點？
 6   - 是否可按照 Clean Architecture 分層拆分？
 7
 82. 拆分後是否降低複雜度？
 9   - 拆分後每個子 Ticket 是否 ≤ Level 2？
10   - 是否減少單一 Ticket 的風險？
11
123. 拆分成本是否合理？
13   - 增加的管理成本 vs 降低的風險
14   - 是否需要額外的整合測試？
15
16決策：
17
18- 滿足 1 且 2 → 建議拆分
19- 不滿足 1 或 2，但 3 成本高 → 勉強接受 Level 3

 1Level 4 無需評估，必須拆分
 2
 3拆分方法（按優先順序）：
 41. 優先：按 Clean Architecture 分層拆分（詳見第三章 3.1-3.4）
 52. 次之：按職責拆分（每個職責獨立 Ticket）
 63. 最後：按檔案拆分（每個檔案獨立 Ticket）
 7
 8拆分要求：
 9
10- 所有子 Ticket 必須 ≤ Level 3
11- 建議所有子 Ticket ≤ Level 2
12- 理想所有子 Ticket = Level 1
13
14拆分後驗證：
15□ 所有子 Ticket 都已重新評估
16□ 所有子 Ticket 都 ≤ Level 3
17□ 子 Ticket 依賴關係明確
18□ 子 Ticket 總和涵蓋原始 Ticket 所有功能

 1任務：定義 IBookRepository 介面
 2
 3步驟 1：初步評估
 4- 職責數量：1 個（定義介面方法簽名）
 5- 程式碼行數：~20 行
 6- 涉及檔案：1 個（i_book_repository.dart）
 7- 測試數量：0 個（Interface 不需測試）
 8
 9步驟 2：複雜度確認
10- 職責：1 個 → Level 1
11- 行數：20 行 → Level 1
12- 檔案：1 個 → Level 1
13- 測試：0 個 → Level 1
14→ 最高等級：Level 1
15
16步驟 3：拆分決策
17- Level 1 → 可直接建立 Ticket
18- 無需拆分
19- 進入 Phase 2

 1任務：實作 Rating Value Object
 2
 3步驟 1：初步評估
 4- 職責數量：2 個（建立 + 驗證）
 5- 程式碼行數：~50 行（含測試）
 6- 涉及檔案：1 個（rating.dart）
 7- 測試數量：5 個
 8
 9步驟 2：複雜度確認
10- 職責：2 個 → Level 2
11- 行數：50 行 → Level 2
12- 檔案：1 個 → Level 1
13- 測試：5 個 → Level 2
14→ 最高等級：Level 2
15
16步驟 3：拆分決策
17- Level 2 → 可直接建立 Ticket
18- 評估：可選拆分，但不必要（職責內聚性高）
19- 進入 Phase 2

 1任務：實作 BookRepository CRUD
 2
 3步驟 1：初步評估
 4- 職責數量：5 個（get + save + delete + mapper + 錯誤處理）
 5- 程式碼行數：~160 行（含測試）
 6- 涉及檔案：2 個（repository.dart + mapper.dart）
 7- 測試數量：10 個
 8
 9步驟 2：複雜度確認
10- 職責：5 個 → Level 3
11- 行數：160 行 → Level 4（超過 100 行）
12- 檔案：2 個 → Level 2
13- 測試：10 個 → Level 3
14→ 最高等級：Level 4（行數超標）
15
16步驟 3：拆分決策
17- Level 4 → 必須拆分
18- 拆分方式：按 CRUD 方法拆分
19
20  Ticket A: 實作 getBookByIsbn
21  - 職責：2 個（查詢 + 轉換）
22  - 行數：~50 行
23  - 檔案：2 個
24  - 測試：3 個
25  → Level 2
26
27  Ticket B: 實作 saveBook
28  - 職責：2 個（儲存 + 錯誤處理）
29  - 行數：~60 行
30  - 檔案：1 個（修改 repository.dart）
31  - 測試：4 個
32  → Level 2
33
34  Ticket C: 實作 deleteBook
35  - 職責：2 個（刪除 + 錯誤處理）
36  - 行數：~50 行
37  - 檔案：1 個（修改 repository.dart）
38  - 測試：3 個
39  → Level 2
40
41結果：拆分為 3 個 Level 2 Ticket

 1任務：實作完整書籍評分功能（UI + UseCase + Repository）
 2
 3步驟 1：初步評估
 4- 職責數量：8 個（UI + Controller + UseCase + Entity + Repository + Mapper + 測試 + 整合）
 5- 程式碼行數：~300 行
 6- 涉及檔案：8 個（跨 4 個架構層級）
 7- 測試數量：20 個
 8
 9步驟 2：複雜度確認
10- 職責：8 個 → Level 4
11- 行數：300 行 → Level 4
12- 檔案：8 個 → Level 4
13- 測試：20 個 → Level 4
14→ 最高等級：Level 4（所有指標都超標）
15
16步驟 3：拆分決策
17- Level 4 → 必須拆分（God Ticket）
18- 拆分方式：使用 Clean Architecture 分層拆分策略
19
20  Ticket 1: Domain 層實作（Layer 5）
21  - Rating Entity + Rating Value Object
22  - 職責：2 個
23  - 行數：~60 行
24  - 檔案：2 個
25  - 測試：6 個
26  → Level 2
27
28  Ticket 2: Repository 層實作（Layer 4-5 Interface + Infra）
29  - IRatingRepository + SQLiteRatingRepository + Mapper
30  - 職責：3 個
31  - 行數：~90 行
32  - 檔案：3 個
33  - 測試：8 個
34  → Level 3（可接受）
35
36  Ticket 3: UseCase 層實作（Layer 3）
37  - RateBookUseCase
38  - 職責：2 個
39  - 行數：~60 行
40  - 檔案：1 個
41  - 測試：4 個
42  → Level 2
43
44  Ticket 4: Presentation 層實作（Layer 1-2）
45  - RatingWidget + RatingController
46  - 職責：2 個
47  - 行數：~90 行
48  - 檔案：2 個
49  - 測試：4 個（Widget 測試）
50  → Level 2
51
52結果：拆分為 4 個 Ticket（3 個 Level 2 + 1 個 Level 3）
53依賴順序：Ticket 1 → Ticket 2 → Ticket 3 → Ticket 4

 13.1 Clean Architecture 五層架構回顧
 2    └── 快速回顧五層架構和依賴規則
 33.2 四種標準拆分策略
 4    ├── 策略 1: Interface 定義 Ticket
 5    ├── 策略 2: 具體實作 Ticket
 6    ├── 策略 3: 測試驗證 Ticket
 7    └── 策略 4: 整合連接 Ticket
 83.3 分層拆分決策指引
 9    └── 如何選擇合適的拆分策略
103.4 分層拆分實務案例
11    └── 完整的書籍評分功能拆分範例

 1Layer 1 (UI - 最外層)
 2├── 職責: 使用者介面元件
 3├── 路徑: lib/presentation/widgets/, lib/presentation/pages/
 4├── 依賴: Layer 2 (Behavior)
 5└── 不依賴: Layer 3-5
 6
 7Layer 2 (Behavior)
 8├── 職責: UI 行為控制（State Management）
 9├── 路徑: lib/presentation/controllers/, lib/presentation/providers/
10├── 依賴: Layer 3 (UseCase)
11└── 不依賴: Layer 1, 4-5
12
13Layer 3 (UseCase)
14├── 職責: 業務用例協調
15├── 路徑: lib/application/use_cases/, lib/application/services/
16├── 依賴: Layer 4-5 (Domain)
17└── 不依賴: Layer 1-2
18
19Layer 4 (Domain Events/Interfaces)
20├── 職責: 領域事件和介面定義
21├── 路徑: lib/domain/events/, lib/domain/repositories/ (介面)
22├── 依賴: Layer 5 (Domain Implementation)
23└── 不依賴: Layer 1-3
24
25Layer 5 (Domain Implementation - 最內層)
26├── 職責: 領域模型實作和基礎設施
27├── 路徑: lib/domain/entities/, lib/domain/value_objects/, lib/infrastructure/
28├── 依賴: 無（核心層）
29└── 不依賴: 任何層

1外層 → 內層 允許
2內層 → 外層 禁止
3
4範例：
5
6- Layer 2 (Behavior) → Layer 3 (UseCase)
7- Layer 3 (UseCase) → Layer 2 (Behavior)

 1## Ticket #NNN: 定義 {Interface 名稱} 介面
 2
 3### 業務需求
 4[引用業務需求編號，如 REQ-001]
 5
 6### 目標
 7建立 `{Interface 名稱}` 介面，定義 {業務功能} 的契約
 8
 9### 步驟
101. 在 `lib/domain/repositories/` 建立 `{interface_file}.dart`
112. 定義 `{method1}` 方法簽名
123. 定義 `{method2}` 方法簽名
134. 撰寫文檔註解（含需求編號）
14
15### 驗收條件
16- [ ] Interface 檔案建立在正確位置
17- [ ] 所有方法簽名完整且明確
18- [ ] 輸入輸出類型定義清楚
19- [ ] 包含完整的文檔註解（含需求編號）
20- [ ] dart analyze 0 錯誤

 1## Ticket #101: 定義 IBookRepository 介面
 2
 3### 業務需求
 4REQ-LIB-001: 書籍資料存取功能
 5
 6### 目標
 7建立 `IBookRepository` 介面，定義書籍資料存取的契約
 8
 9### 步驟
101. 在 `lib/domain/repositories/` 建立 `i_book_repository.dart`
112. 定義 `getBookByIsbn` 方法簽名
12   ```dart
13   /// [REQ-LIB-001.1] 根據 ISBN 查詢書籍
14   ///
15   /// 參數:
16   /// - isbn: 書籍 ISBN 編號
17   ///
18   /// 回傳:
19   /// - Book 物件（存在）或 null（不存在）
20   Future<Book?> getBookByIsbn(String isbn);

 1
 2---
 3
 4#### 策略 2：具體實作 Ticket
 5
 6**定義**: 實作一個類別的核心邏輯。
 7
 8**適用層級**:
 9- Layer 5 (Domain Implementation): Entity, Value Object
10- Layer 5 (Infrastructure): Repository 實作, Service 實作
11
12**職責範圍**:
13- 實作類別邏輯
14- 實現介面方法
15- 處理異常
16- 撰寫單元測試
17
18**禁止包含**:
19- UI 元件
20- 跨層整合（如直接呼叫 UseCase）
21- 測試以外的其他層修改
22
23**Ticket 範本**:
24
25```markdown
26## Ticket #NNN: 實作 {類別名稱}
27
28### 業務需求
29[引用業務需求編號]
30
31### 目標
32實作 `{類別名稱}`，提供 {業務功能} 的具體實現
33
34### 依賴 Ticket
35- Ticket #XXX: 定義 {Interface 名稱} 介面（必須先完成）
36
37### 步驟
381. 建立 `{類別名稱}` 類別（實作 `{Interface}`）
392. 實作 `{method1}` 方法
403. 實作 `{method2}` 方法
414. 處理異常情況
425. 撰寫單元測試（正常流程 + 異常處理）
436. 確保所有測試通過
44
45### 驗收條件
46- [ ] 實作所有 Interface 方法
47- [ ] 異常處理完整
48- [ ] 單元測試 100% 通過
49- [ ] 測試覆蓋正常流程和異常處理
50- [ ] dart analyze 0 錯誤

 1## Ticket #102: 實作 SQLiteBookRepository
 2
 3### 業務需求
 4REQ-LIB-001: 書籍資料存取功能
 5
 6### 目標
 7實作 `SQLiteBookRepository`，提供書籍資料的 SQLite 儲存
 8
 9### 依賴 Ticket
10- Ticket #101: 定義 IBookRepository 介面（必須先完成）
11
12### 步驟
131. 在 `lib/infrastructure/repositories/` 建立 `sqlite_book_repository.dart`
142. 實作 `getBookByIsbn` 方法
15   - SQL 查詢邏輯
16   - Data Mapper 轉換（DTO → Entity）
17   - 錯誤處理（Database Exception）
183. 實作 `saveBook` 方法
19   - SQL 插入/更新邏輯
20   - Data Mapper 轉換（Entity → DTO）
21   - 錯誤處理
224. 實作 `deleteBook` 方法
235. 撰寫單元測試
24   - 正常流程：CRUD 操作成功
25   - 異常處理：資料庫錯誤、資料不存在
266. 確保所有測試通過
27
28### 驗收條件
29- [ ] 實作所有 IBookRepository 方法
30- [ ] 異常處理完整（DatabaseException, ValidationException）
31- [ ] 單元測試 100% 通過（至少 6 個測試案例）
32- [ ] dart analyze 0 錯誤
33
34### 指標評估
35- 職責: 3 個（CRUD 實作、Mapper、異常處理）
36- 行數: ~80 行（含測試）
37- 檔案: 1 個
38- 測試: 6 個
39→ Level 2（中等）

 1## Ticket #NNN: 撰寫 {功能} 測試
 2
 3### 業務需求
 4[引用業務需求編號]
 5
 6### 目標
 7撰寫 `{類別名稱}` 的完整測試用例，確保 {業務功能} 正確性
 8
 9### 依賴 Ticket
10- Ticket #XXX: 實作 {類別名稱}（必須先完成）
11
12### 步驟
131. 建立測試檔案 `{class}_test.dart`
142. 撰寫正常流程測試
153. 撰寫邊界條件測試
164. 撰寫異常處理測試
175. 確保所有測試通過
18
19### 驗收條件
20- [ ] 測試檔案建立在正確位置
21- [ ] 至少 N 個測試用例
22- [ ] 覆蓋正常流程、邊界條件和異常處理
23- [ ] 所有測試 100% 通過

 1## Ticket #103: 撰寫 BookRepository 整合測試
 2
 3### 業務需求
 4REQ-LIB-001: 書籍資料存取功能
 5
 6### 目標
 7撰寫 `BookRepository` 的整合測試，驗證資料庫操作正確性
 8
 9### 依賴 Ticket
10- Ticket #102: 實作 SQLiteBookRepository（必須先完成）
11
12### 步驟
131. 建立測試檔案 `test/integration/repositories/book_repository_test.dart`
142. 撰寫 `getBookByIsbn` 測試
15   - 測試 1: 成功取得存在的書籍
16   - 測試 2: 書籍不存在回傳 null
17   - 測試 3: 無效 ISBN 拋出異常
183. 撰寫 `saveBook` 測試
19   - 測試 4: 新增書籍成功
20   - 測試 5: 更新現有書籍成功
214. 撰寫 `deleteBook` 測試
22   - 測試 6: 刪除存在的書籍
23   - 測試 7: 刪除不存在的書籍無異常
245. 確保所有測試通過
25
26### 驗收條件
27- [ ] 測試檔案建立在 `test/integration/repositories/`
28- [ ] 至少 7 個整合測試案例
29- [ ] 覆蓋正常流程和異常處理
30- [ ] 所有測試 100% 通過
31
32### 指標評估
33- 職責: 1 個（撰寫測試）
34- 行數: ~60 行（純測試）
35- 檔案: 1 個（測試檔案）
36- 測試: 7 個
37→ Level 2（中等）

 1## Ticket #NNN: 整合 {UseCase} 到 {Repository}
 2
 3### 業務需求
 4[引用業務需求編號]
 5
 6### 目標
 7將 `{Repository}` 整合到 `{UseCase}`，實現 {業務功能} 完整流程
 8
 9### 依賴 Ticket
10- Ticket #XXX: 定義 {Interface}（必須先完成）
11- Ticket #YYY: 實作 {Repository}（必須先完成）
12
13### 步驟
141. 修改 `{UseCase}` 注入 `{Interface}`
152. 在 `execute` 方法中呼叫 Repository 方法
163. 處理 Repository 異常
174. 撰寫整合測試驗證端到端流程
185. 確保所有測試通過
19
20### 驗收條件
21- [ ] `{UseCase}` 正確注入 `{Interface}`
22- [ ] 端到端流程正常運作
23- [ ] 整合測試 100% 通過
24- [ ] 異常處理完整

 1## Ticket #104: 整合 BookRepository 到 GetBookUseCase
 2
 3### 業務需求
 4REQ-LIB-001: 書籍查詢功能
 5
 6### 目標
 7將 `BookRepository` 整合到 `GetBookUseCase`，實現完整書籍查詢流程
 8
 9### 依賴 Ticket
10- Ticket #101: 定義 IBookRepository 介面（必須先完成）
11- Ticket #102: 實作 SQLiteBookRepository（必須先完成）
12
13### 步驟
141. 修改 `GetBookInteractor` 注入 `IBookRepository`
15   ```dart
16   class GetBookInteractor implements GetBookUseCase {
17     final IBookRepository _repository;
18
19     GetBookInteractor(this._repository);
20
21     @override
22     Future<Book?> execute(String isbn) async {
23       // 呼叫 Repository
24     }
25   }

 1
 2---
 3
 4### 3.3 分層拆分決策指引
 5
 6**決策流程圖**:
 7
 8```text
 9[分析 Ticket 涉及的架構層級]
10    ↓
11    ├─ 單層修改？
12    │   ├─ Yes → 選擇對應策略
13    │   │   ├─ Layer 4 Interface → 策略 1: Interface 定義
14    │   │   ├─ Layer 5 Implementation → 策略 2: 具體實作
15    │   │   └─ 補充測試 → 策略 3: 測試驗證
16    │   │
17    │   └─ No → 跨層修改？
18    │       ├─ 相鄰兩層整合 → 策略 4: 整合連接
19    │       └─ 跨越超過 2 層 → 必須拆分為多個 Ticket

1問題: Ticket 是否只修改單一架構層級？
2
3- Yes → 選擇策略 1-3（Interface / 實作 / 測試）
4- No → 評估是否可拆分為多個單層 Ticket

 1問題: 是否為相鄰兩層的整合？
 2
 3範例：
 4
 5- Layer 3 (UseCase) + Layer 4-5 (Repository) 可接受
 6- Layer 2 (Controller) + Layer 3 (UseCase) 可接受
 7- Layer 1 (UI) + Layer 5 (Domain) 禁止（跨越太多層）
 8
 9決策：
10
11- 相鄰兩層整合 → 策略 4: 整合連接
12- 跨越超過 2 層 → 必須拆分為多個 Ticket

1原則: Interface 定義必須先於實作
2
3範例拆分順序：
41. Ticket A: 定義 IBookRepository（策略 1）
52. Ticket B: 實作 SQLiteBookRepository（策略 2）
63. Ticket C: 整合到 GetBookUseCase（策略 4）
7
8依賴關係: Ticket C 依賴 B，B 依賴 A

1問題: 測試應該獨立 Ticket 還是整合到實作 Ticket？
2
3決策：
4
5- 實作 Ticket < Level 2 → 整合測試到實作 Ticket
6- 實作 Ticket = Level 2-3 → 可選擇獨立測試 Ticket
7- 測試案例 > 10 個 → 必須獨立測試 Ticket（策略 3）

1原始任務: 實作完整書籍評分功能（UI + UseCase + Repository）
2
3指標評估:
4- 職責: 8 個
5- 行數: ~300 行
6- 檔案: 8 個
7- 測試: 20 個
8→ Level 4（所有指標都超標）必須拆分

 1## Ticket #201: 定義 Rating Value Object
 2
 3### 層級: Layer 5 (Domain Implementation)
 4### 策略: 策略 2（具體實作）
 5
 6### 業務需求
 7REQ-RATING-001: 書籍評分功能
 8
 9### 目標
10建立 `Rating` Value Object，封裝評分規則（1-5 分）
11
12### 步驟
131. 建立 `lib/domain/value_objects/rating.dart`
142. 實作 Rating 類別
15   - 建構子驗證（1-5 分）
16   - equals / hashCode
17   - toString
183. 撰寫單元測試（正常、邊界、異常）
194. 確保測試通過
20
21### 驗收條件
22- [ ] Rating 類別實作完整
23- [ ] 驗證邏輯正確（1-5 分）
24- [ ] 單元測試 100% 通過（至少 5 個測試）
25- [ ] dart analyze 0 錯誤
26
27### 指標評估
28- 職責: 1 個
29- 行數: ~50 行
30- 檔案: 1 個
31- 測試: 5 個
32→ Level 2（中等）

 1## Ticket #202: 定義 Rating Entity
 2
 3### 層級: Layer 5 (Domain Implementation)
 4### 策略: 策略 2（具體實作）
 5### 依賴: Ticket #201（Rating Value Object）
 6
 7### 業務需求
 8REQ-RATING-001: 書籍評分功能
 9
10### 目標
11建立 `Rating` Entity，包含評分和評論資訊
12
13### 步驟
141. 建立 `lib/domain/entities/rating.dart`
152. 實作 Rating Entity
16   - 欄位: ratingValue (Rating VO), comment (String), userId, bookIsbn
17   - equals / hashCode
183. 撰寫單元測試
194. 確保測試通過
20
21### 驗收條件
22- [ ] Rating Entity 實作完整
23- [ ] 使用 Rating Value Object
24- [ ] 單元測試 100% 通過（至少 3 個測試）
25- [ ] dart analyze 0 錯誤
26
27### 指標評估
28- 職責: 1 個
29- 行數: ~40 行
30- 檔案: 1 個
31- 測試: 3 個
32→ Level 1（簡單）

 1## Ticket #203: 定義 IRatingRepository 介面
 2
 3### 層級: Layer 4 (Domain Interfaces)
 4### 策略: 策略 1（Interface 定義）
 5
 6### 業務需求
 7REQ-RATING-001: 書籍評分功能
 8
 9### 目標
10建立 `IRatingRepository` 介面，定義評分資料存取契約
11
12### 步驟
131. 建立 `lib/domain/repositories/i_rating_repository.dart`
142. 定義 `saveRating` 方法簽名
153. 定義 `getRatingsByBookIsbn` 方法簽名
164. 撰寫文檔註解
17
18### 驗收條件
19- [ ] Interface 檔案建立在正確位置
20- [ ] 2 個方法簽名完整
21- [ ] 文檔註解包含需求編號
22- [ ] dart analyze 0 錯誤
23
24### 指標評估
25- 職責: 1 個
26- 行數: ~20 行
27- 檔案: 1 個
28- 測試: 0 個
29→ Level 1（簡單）

 1## Ticket #204: 實作 SQLiteRatingRepository
 2
 3### 層級: Layer 5 (Infrastructure)
 4### 策略: 策略 2（具體實作）
 5### 依賴: Ticket #202, #203
 6
 7### 業務需求
 8REQ-RATING-001: 書籍評分功能
 9
10### 目標
11實作 `SQLiteRatingRepository`，提供評分資料的 SQLite 儲存
12
13### 步驟
141. 建立 `lib/infrastructure/repositories/sqlite_rating_repository.dart`
152. 實作 `saveRating` 方法
16   - SQL 插入邏輯
17   - Data Mapper 轉換
18   - 錯誤處理
193. 實作 `getRatingsByBookIsbn` 方法
204. 撰寫單元測試（CRUD + 異常）
215. 確保測試通過
22
23### 驗收條件
24- [ ] 實作所有 IRatingRepository 方法
25- [ ] 異常處理完整
26- [ ] 單元測試 100% 通過（至少 6 個測試）
27- [ ] dart analyze 0 錯誤
28
29### 指標評估
30- 職責: 3 個（CRUD、Mapper、異常）
31- 行數: ~90 行
32- 檔案: 1 個
33- 測試: 6 個
34→ Level 3（複雜）可接受

 1## Ticket #205: 實作 RateBookUseCase
 2
 3### 層級: Layer 3 (UseCase)
 4### 策略: 策略 4（整合連接）
 5### 依賴: Ticket #203, #204
 6
 7### 業務需求
 8REQ-RATING-001: 書籍評分功能
 9
10### 目標
11實作 `RateBookUseCase`，協調書籍評分業務流程
12
13### 步驟
141. 建立 `lib/application/use_cases/rate_book_use_case.dart`
152. 注入 `IRatingRepository`
163. 實作 `execute` 方法
17   - 建立 Rating Entity
18   - 呼叫 Repository 儲存
19   - 處理異常
204. 撰寫整合測試
215. 確保測試通過
22
23### 驗收條件
24- [ ] UseCase 正確注入 IRatingRepository
25- [ ] 業務流程完整
26- [ ] 整合測試 100% 通過（至少 4 個測試）
27- [ ] 異常處理完整
28- [ ] dart analyze 0 錯誤
29
30### 指標評估
31- 職責: 2 個（協調、整合）
32- 行數: ~60 行
33- 檔案: 1 個
34- 測試: 4 個
35→ Level 2（中等）

 1## Ticket #206: 實作 RatingWidget 和 RatingController
 2
 3### 層級: Layer 1 (UI) + Layer 2 (Behavior)
 4### 策略: 策略 2 + 策略 4（實作 + 整合）
 5### 依賴: Ticket #205
 6
 7### 業務需求
 8REQ-RATING-001: 書籍評分功能
 9
10### 目標
11實作評分 UI 元件和行為控制
12
13### 步驟
141. 建立 `lib/presentation/widgets/rating_widget.dart`
152. 實作 RatingWidget（5 星評分 UI）
163. 建立 `lib/presentation/controllers/rating_controller.dart`
174. 實作 RatingController
18   - 注入 RateBookUseCase
19   - 呼叫 UseCase 評分
20   - 狀態管理
215. 撰寫 Widget 測試
226. 確保測試通過
23
24### 驗收條件
25- [ ] RatingWidget UI 正確顯示
26- [ ] RatingController 正確整合 UseCase
27- [ ] Widget 測試 100% 通過（至少 4 個測試）
28- [ ] dart analyze 0 錯誤
29
30### 指標評估
31- 職責: 2 個（UI、Controller）
32- 行數: ~80 行
33- 檔案: 2 個
34- 測試: 4 個
35→ Level 2（中等）

 1Phase 1（可並行）:
 2├─ Ticket #201: Rating Value Object
 3└─ Ticket #202: Rating Entity （依賴 #201）
 4
 5Phase 2（可並行）:
 6├─ Ticket #203: IRatingRepository Interface
 7└─ Ticket #204: SQLiteRatingRepository （依賴 #202, #203）
 8
 9Phase 3:
10└─ Ticket #205: RateBookUseCase （依賴 #204）
11
12Phase 4:
13└─ Ticket #206: RatingWidget UI （依賴 #205）

 1## Ticket #1: 定義 IBookRepository 介面
 2
 3### 層級：Layer 4 (Domain Interfaces)
 4
 5### 業務需求
 6REQ-LIB-001: 書籍資料存取功能
 7
 8### 目標
 9建立 `IBookRepository` 介面，定義書籍資料存取的契約
10
11### 步驟
121. 在 `lib/domain/repositories/` 建立 `i_book_repository.dart`
132. 定義 `getBookByIsbn(String isbn)` 方法簽名
143. 定義 `saveBook(Book book)` 方法簽名
154. 定義 `deleteBook(String isbn)` 方法簽名
165. 撰寫文檔註解（含需求編號）
17
18### 驗收條件
19- [ ] Interface 檔案建立在 `lib/domain/repositories/`
20- [ ] 3 個方法簽名完整且明確
21- [ ] 輸入輸出類型定義清楚
22- [ ] 文檔註解包含需求編號 REQ-LIB-001
23- [ ] dart analyze 0 錯誤
24
25### 指標評估
26- 職責數量：1 個（定義介面契約）
27- 程式碼行數：~20 行
28- 涉及檔案：1 個
29- 測試用例：0 個（Interface 不需單元測試）
30→ Level 1（簡單）
31
32### 預估時間
3310-15 分鐘

 1## Ticket #2: 建立 Rating Value Object
 2
 3### 層級：Layer 5 (Domain Implementation)
 4
 5### 業務需求
 6REQ-RATING-001: 書籍評分功能
 7
 8### 目標
 9建立 `Rating` Value Object，封裝評分規則（1-5 分）
10
11### 步驟
121. 在 `lib/domain/value_objects/` 建立 `rating.dart`
132. 實作 Rating 類別
14   - 建構子驗證（1-5 分範圍）
15   - equals / hashCode
16   - toString
173. 撰寫單元測試
18   - 測試 1：建立有效評分
19   - 測試 2：評分過低拋出異常
20   - 測試 3：評分過高拋出異常
214. 確保所有測試通過
22
23### 驗收條件
24- [ ] Rating 類別實作完整
25- [ ] 驗證邏輯正確（1-5 分）
26- [ ] equals / hashCode / toString 實作正確
27- [ ] 單元測試 100% 通過（至少 3 個測試）
28- [ ] dart analyze 0 錯誤
29
30### 指標評估
31- 職責數量：1 個（實作 Value Object）
32- 程式碼行數：~25 行（含測試）
33- 涉及檔案：1 個
34- 測試用例：3 個
35→ Level 1（簡單）
36
37### 預估時間
3815-20 分鐘

 1## Ticket #3: 實作 Book Entity
 2
 3### 層級：Layer 5 (Domain Implementation)
 4
 5### 業務需求
 6REQ-LIB-001: 書籍資料模型
 7
 8### 目標
 9建立 `Book` Entity，封裝書籍核心資料
10
11### 步驟
121. 在 `lib/domain/entities/` 建立 `book.dart`
132. 定義 Entity 欄位
14   - isbn (String, required)
15   - title (String, required)
16   - author (String, required)
17   - publishDate (DateTime, optional)
183. 實作 equals / hashCode（基於 isbn）
194. 實作 toString
205. 撰寫單元測試
21   - 測試 1：建立有效 Book
22   - 測試 2：equals 正確比較（相同 ISBN）
23   - 測試 3：equals 正確比較（不同 ISBN）
24   - 測試 4：hashCode 一致性
256. 確保測試通過
26
27### 驗收條件
28- [ ] Book Entity 欄位定義完整
29- [ ] equals / hashCode 實作正確（基於 isbn）
30- [ ] toString 回傳清楚的字串表示
31- [ ] 單元測試 100% 通過（至少 4 個測試）
32- [ ] dart analyze 0 錯誤
33
34### 指標評估
35- 職責數量：3 個（欄位定義、equals/hashCode、toString）
36- 程式碼行數：~50 行（含測試）
37- 涉及檔案：1 個
38- 測試用例：4 個
39→ Level 2（中等）
40
41### 預估時間
4225-35 分鐘

 1## Ticket #4: 實作 GetBookUseCase
 2
 3### 層級：Layer 3 (UseCase)
 4
 5### 業務需求
 6REQ-LIB-001: 查詢書籍功能
 7
 8### 目標
 9實作 `GetBookUseCase`，協調書籍查詢業務流程
10
11### 依賴 Ticket
12- Ticket #1: 定義 IBookRepository 介面（必須先完成）
13
14### 步驟
151. 在 `lib/application/use_cases/` 建立 `get_book_use_case.dart`
162. 定義 `GetBookUseCase` 介面
173. 實作 `GetBookInteractor`
18   - 注入 `IBookRepository`
19   - 實作 `execute(String isbn)` 方法
20   - 處理 Repository 異常
214. 撰寫單元測試
22   - 測試 1：成功查詢書籍
23   - 測試 2：書籍不存在回傳 null
24   - 測試 3：無效 ISBN 拋出 ValidationException
25   - 測試 4：Repository 異常正確處理
265. 確保測試通過
27
28### 驗收條件
29- [ ] GetBookInteractor 正確注入 IBookRepository
30- [ ] execute 方法實作正確
31- [ ] 異常處理完整
32- [ ] 單元測試 100% 通過（至少 4 個測試）
33- [ ] dart analyze 0 錯誤
34
35### 指標評估
36- 職責數量：2 個（業務協調、異常處理）
37- 程式碼行數：~55 行（含測試）
38- 涉及檔案：1 個
39- 測試用例：4 個
40→ Level 2（中等）
41
42### 預估時間
4330-40 分鐘

 1## Ticket #5: 實作 SQLiteBookRepository CRUD
 2
 3### 層級：Layer 5 (Infrastructure)
 4
 5### 業務需求
 6REQ-LIB-001: 書籍資料存取功能
 7
 8### 目標
 9實作 `SQLiteBookRepository`，提供完整的 CRUD 操作
10
11### 依賴 Ticket
12- Ticket #1: 定義 IBookRepository 介面（必須先完成）
13
14### 複雜度警告
15此 Ticket 為 Level 3（複雜），建議拆分為 3 個 Level 2 Ticket：
16
17- Ticket A: 實作 getBookByIsbn + 測試
18- Ticket B: 實作 saveBook + 測試
19- Ticket C: 實作 deleteBook + Data Mapper + 測試
20
21### 步驟（如不拆分）
221. 在 `lib/infrastructure/repositories/` 建立 `sqlite_book_repository.dart`
232. 在 `lib/infrastructure/mappers/` 建立 `book_mapper.dart`
243. 實作 `getBookByIsbn` 方法
25   - SQL 查詢邏輯
26   - Data Mapper 轉換（DTO → Entity）
27   - 錯誤處理
284. 實作 `saveBook` 方法
29   - SQL 插入/更新邏輯
30   - Data Mapper 轉換（Entity → DTO）
31   - 錯誤處理
325. 實作 `deleteBook` 方法
336. 撰寫完整測試
34   - getBookByIsbn: 成功、不存在、異常（3 個測試）
35   - saveBook: 新增、更新、異常（3 個測試）
36   - deleteBook: 成功、不存在、異常（3 個測試）
377. 確保所有測試通過
38
39### 驗收條件
40- [ ] 實作所有 IBookRepository 方法
41- [ ] Data Mapper 轉換正確
42- [ ] 異常處理完整
43- [ ] 單元測試 100% 通過（至少 9 個測試）
44- [ ] dart analyze 0 錯誤
45
46### 指標評估
47- 職責數量：5 個（get、save、delete、mapper、異常處理）
48- 程式碼行數：~160 行（含測試）
49- 涉及檔案：2 個
50- 測試用例：9 個
51→ Level 3（複雜）建議拆分
52
53### 預估時間
5460-90 分鐘
55
56### 建議拆分方案
57拆分為 3 個 Ticket（詳見第五章決策樹）