---

name: integration-testing description: 統合テスト設計・実装。コンポーネント間連携とデータフロー検証。

Integration Testing

トリガー

• コンポーネント連携の検証
• API境界のテスト
• データフロー確認

---

基本原則

境界を跨ぐ振る舞いを検証。内部実装は問わない。

---

テスト層の実行順序

Copy1. Database Layer
2. Repository/DAO Layer
3. Service Layer
4. API Layer
5. Frontend Integration

前の層が安定するまで次に進まない。

---

必須テスト対象

Database統合

API統合

外部サービス

---

テスト設計チェックリスト

作成前

• コンポーネント境界を特定したか?
• インターフェース契約を理解したか?
• Usefulness Score ≥12 か?
• Unitで十分でないか?

作成中

• 実DBを使用しているか? (インメモリ非推奨)
• テストデータは独立しているか?
• トランザクション分離は適切か?
• クリーンアップ処理があるか?

作成後

• 単独実行で成功するか?
• 並列実行で競合しないか?
• 失敗理由が特定可能か?

---

構造パターン

Copydescribe('Integration: [Component A] → [Component B]', () => {
  let db: Database;
  let service: Service;

  beforeAll(async () => {
    db = await createTestDatabase();
    service = new Service(db);
  });

  afterAll(async () => {
    await db.cleanup();
  });

  beforeEach(async () => {
    await db.truncateAll();
  });

  describe('正常系', () => {
    it('should [expected behavior]', async () => {
      // Arrange: テストデータ投入
      await db.insert('users', testUser);

      // Act: 境界を跨ぐ操作
      const result = await service.process(input);

      // Assert: 結果検証
      expect(result).toEqual(expected);

      // Assert: 副作用検証
      const dbState = await db.query('SELECT * FROM users');
      expect(dbState).toContain(expectedRecord);
    });
  });

  describe('異常系', () => {
    it('should handle [error case]', async () => {
      // エラー条件設定
      // 操作実行
      // エラー検証
    });
  });
});

---

モック戦略

原則: 境界内は実物、境界外はモック。

---

テスト環境

Copy# docker-compose.test.yml
services:
  db:
    image: postgres:16
    environment:
      POSTGRES_DB: test
    tmpfs: /var/lib/postgresql/data  # 高速化

---

禁止事項

• ❌ インメモリDB使用 (本番との乖離)
• ❌ モック過多 (統合テストの意味喪失)
• ❌ テスト間でのDB状態共有
• ❌ 固定IDのハードコード
• ❌ 8件超/境界

---

品質ゲート