現代軟體測試與 AI 實戰 (5)：AI 輔助整合測試實戰，從 Markdown 到真實程式碼

# Node.js / TypeScript 專案
npm install --save-dev testcontainers @testcontainers/postgresql

# C# / .NET 專案
dotnet add package Testcontainers.PostgreSql

# Python 專案
pip install testcontainers[postgres]

我需要為登入 API 撰寫整合測試。
請閱讀 @test-cases.md 中的所有情境，並參考 @LoginController 的實作邏輯。

請幫我產出測試檔案，並遵循以下規範：

1. 請使用 (xUnit / Jest / pytest，依你的專案填寫)。
2. 必須使用 Testcontainers 啟動一個全新的 PostgreSQL 實例，作為測試環境資料庫。
3. 每個測試執行前 (Setup)，請插入必要的假資料 (Seed Data)；執行後 (Teardown) 確保資源獨立。
4. 測試命名請使用「方法名_測試情境_預期結果」的格式。

請直接實作所有 Happy Path 與 Negative Cases 的程式碼。

// login.integration.test.ts
// 由 Cursor 根據 test-cases.md + LoginService.ts 自動生成

import {
  PostgreSqlContainer,
  StartedPostgreSqlContainer,
} from '@testcontainers/postgresql';
import { Client } from 'pg';
import { loginUser } from '../services/LoginService';

let container: StartedPostgreSqlContainer;
let dbClient: Client;

// Setup：測試開始前自動啟動一個全新 PostgreSQL 容器
beforeAll(async () => {
  container = await new PostgreSqlContainer('postgres:15-alpine').start();

  dbClient = new Client({ connectionString: container.getConnectionUri() });
  await dbClient.connect();

  // 建立 schema 與 Seed Data
  await dbClient.query(`
    CREATE TABLE users (
      id SERIAL PRIMARY KEY,
      email TEXT UNIQUE NOT NULL,
      password_hash TEXT NOT NULL,
      failed_attempts INT DEFAULT 0,
      locked_at TIMESTAMPTZ
    )
  `);
  await dbClient.query(`
    INSERT INTO users (email, password_hash)
    VALUES ('test@example.com', '$2b$10$hashedpassword')
  `);
}, 60000); // 等待 Docker pull，給 60 秒

// Teardown：測試結束後銷毀容器，完全不留髒資料
afterAll(async () => {
  await dbClient.end();
  await container.stop();
});

// Happy Path
test('Login_ValidCredentials_ReturnsJwtToken', async () => {
  const result = await loginUser(
    'test@example.com',
    'correctPassword',
    dbClient,
  );
  expect(result.token).toBeDefined();
  expect(result.status).toBe(200);
});

// Negative Case：失敗 5 次鎖定（AI 自動用迴圈寫好）
test('Login_FailFiveTimes_AccountIsLocked', async () => {
  for (let i = 0; i < 5; i++) {
    await loginUser('test@example.com', 'wrongPassword', dbClient);
  }
  const result = await loginUser('test@example.com', 'wrongPassword', dbClient);
  expect(result.status).toBe(423); // 423 Locked
  expect(result.message).toContain('帳號已鎖定');
});