Integration Test

---
doc_type: "integration-test"
variant: "light"
status: "draft"
owner: "<your-name>"
last_updated: "YYYY-MM-DD"
upstream:
  required: ["openapi-spec", "consumer-list"]
  optional: ["slo-definition"]
---

# Integration Test Plan: <api-or-service-name>

**Status:** Draft v0.X · **Owner:** <QA Lead> · **Last updated:** YYYY-MM-DD

> [!IMPORTANT]
> **AI 填寫規則：** 本範本 6 段（編號 1, 2, 4, 5, 9, 12），全部必填——刻意沿用完整版的章節編號讓兩版可對照。每 test case 行內加 `（依據：spec endpoint / consumer §X / SLO §Y）`；每 case 帶 `[H]/[M]/[L]` confidence badge；缺資料寫 `_TODO: 需要 XXX_` 不編造；**每個 unhappy path 必須有對應 detection（log / metric / trace）**，沒 detection 等於沒測；輕量版至少覆蓋 happy + 4xx + 5xx 三類。

---

## 1. Executive Summary

<!-- ai-fill: 3-5 行，QA/Dev 30 秒讀完。內容：N 個 contract、happy/unhappy case 數、最高風險整合點 -->

<3-5 行說明>

> **TL;DR:** <一句話：這份 plan 驗證哪個契約邊界>

---

## 2. Contracts

<!-- ai-rule: 每條必含 consumer / provider / spec ref / version -->

| ID | Consumer | Provider | Spec ref | Version | Confidence |
|---|---|---|---|---|---|
| CT-001 | <service A> | <service B> | `/api/v2/orders POST` | v1.3 | **[H]** |

---

## 4. Happy Paths

<!-- ai-rule: 每個 endpoint 至少 1 條 happy path，含 input / expected status / p99 budget -->

| ID | Endpoint | Input | Expected status | p99 budget | Confidence |
|---|---|---|---|---|---|
| HP-001 | `POST /orders` | `{...}` | 201 | < 500ms | **[H]** |

---

## 5. Unhappy Paths

<!-- ai-rule: 必含 4xx / 5xx / timeout 三類至少各 1 條，每條附 detection signal -->

### 4xx

| ID | Scenario | Expected status | Detection |
|---|---|---|---|
| UH-4xx-01 | missing required field | 400 | client → user message |

### 5xx

| ID | Scenario | Injection | Expected client behavior |
|---|---|---|---|
| UH-5xx-01 | provider DB down | chaos / stub | circuit breaker open + fallback |

### Timeout

| ID | Threshold | Expected behavior |
|---|---|---|
| UH-TO-01 | <from SLO p99 + 20%> | retry 2 次 → fail with 504 |

---

## 9. Risks（top 3）

<!-- ai-rule: 每條格式：失效模式 + Mitigation + Owner 三件齊 -->

> **R1:** <風險描述> — **Mitigation:** <如何降低> — **Owner:** <誰負責>
>
> **R2:** ...
>
> **R3:** ...

---

## 12. Confidence & Sources & TODO

- **整份 plan 最低 confidence 欄位：** <列出所有 [L] 與 [M]>
- **Fabricated assumptions（推測但 input 未明說）：**
  - <假設 1>
- **Highest-value next input:** <下一份最該補的 incident postmortem / consumer 真實流量畫像>

### TODO（缺資料）

- _TODO: 需要 SLO p99 數值校準 timeout threshold_

---

> [!CAUTION]
> **輸出前 AI 自檢：**
> - [ ] 6 段 H2 章節齊全（編號 1, 2, 4, 5, 9, 12，刻意不連號）
> - [ ] 每個 test case 帶 inline `[H/M/L]` badge + source
> - [ ] Unhappy paths 覆蓋 4xx + 5xx + timeout 三類
> - [ ] 每個 unhappy path 有 detection signal
> - [ ] Risks 每條格式：失效模式 + Mitigation + Owner
> - [ ] 無 YAML / JSON schema 輸出（plan 是給人讀的 markdown）