┌─────────────────────────────────────────────────────────────┐
│              測試完整性 = 8 個維度                            │
├─────────────────────────────────────────────────────────────┤
│  1. 正常路徑        正常預期行為                              │
│  2. 邊界條件        最小/最大值、限制                         │
│  3. 錯誤處理        無效輸入、例外狀況                        │
│  4. 授權驗證        角色存取控制                              │
│  5. 狀態變更        前後狀態驗證                              │
│  6. 驗證邏輯        格式、商業規則                            │
│  7. 整合測試        真實查詢驗證                              │
│  8. AI 生成品質     AI 生成測試的品質 (新增)                │
└─────────────────────────────────────────────────────────────┘

功能：___________________

□ 正常路徑
  □ 有效輸入產生預期成功
  □ 正確的資料被回傳/建立
  □ 預期的副作用發生

□ 邊界條件
  □ 最小有效值
  □ 最大有效值
  □ 空集合
  □ 單一項目集合
  □ 大型集合（如適用）

□ 錯誤處理
  □ 無效輸入格式
  □ 缺少必要欄位
  □ 重複/衝突情況
  □ 找不到資料情況
  □ 外部服務失敗（如適用）

□ 授權驗證
  □ 每個允許的角色已測試
  □ 每個拒絕的角色已測試
  □ 未認證存取已測試
  □ 跨邊界存取已測試

□ 狀態變更
  □ 初始狀態已驗證
  □ 最終狀態已驗證
  □ 所有有效的狀態轉換已測試

□ 驗證邏輯
  □ 格式驗證（電子郵件、電話等）
  □ 商業規則驗證
  □ 跨欄位驗證

□ 整合測試（如 UT 使用萬用字元）
  □ 查詢述詞已驗證
  □ 實體關聯已驗證
  □ 分頁已驗證
  □ 排序/過濾已驗證

[Fact]
public async Task CreateUser_WithValidData_ReturnsSuccess()
{
    // Arrange
    var request = new CreateUserRequest
    {
        Username = "newuser",
        Email = "user@example.com"
    };

    // Act
    var result = await _service.CreateUserAsync(request);

    // Assert
    result.Success.Should().BeTrue();
    result.Data.Username.Should().Be("newuser");
}

[Theory]
[InlineData(0, false)]      // 低於最小值
[InlineData(1, true)]       // 最小有效值
[InlineData(100, true)]     // 最大有效值
[InlineData(101, false)]    // 高於最大值
public void ValidateQuantity_BoundaryValues_ReturnsExpected(
    int quantity, bool expected)
{
    var result = _validator.IsValidQuantity(quantity);
    result.Should().Be(expected);
}

[Fact]
public async Task DeleteUser_AsAdmin_Succeeds()
{
    var adminContext = CreateContext(role: "Admin");
    var result = await _service.DeleteUserAsync(userId, adminContext);
    result.Success.Should().BeTrue();
}

[Fact]
public async Task DeleteUser_AsMember_ReturnsForbidden()
{
    var memberContext = CreateContext(role: "Member");
    var result = await _service.DeleteUserAsync(userId, memberContext);
    result.ErrorCode.Should().Be("FORBIDDEN");
}

[Fact]
public async Task DisableUser_UpdatesStateCorrectly()
{
    // Arrange
    var user = await CreateEnabledUser();
    user.IsEnabled.Should().BeTrue();  // 驗證初始狀態

    // Act
    await _service.DisableUserAsync(user.Id);

    // Assert
    var updatedUser = await _repository.GetByIdAsync(user.Id);
    updatedUser.IsEnabled.Should().BeFalse();  // 驗證最終狀態
}

## 測試完整性

我們使用 7 維度框架來確保測試覆蓋。

### 各功能類型需要的維度
- API 端點：全部 7 個維度
- 工具函式：維度 1, 2, 3, 6
- 背景作業：維度 1, 3, 5