Rollback Plan · 回滾計畫

---
doc_type: "rollback-plan"
variant: "light"
status: "draft"
owner: "<your-name>"
last_updated: "YYYY-MM-DD"
upstream:
  required: ["deploy-steps", "slo-spec"]
  optional: ["migration-scripts"]
---

# Rollback Plan: <release-name>

**Status:** Draft v0.X · **Owner:** <DevOps + on-call SRE> · **Last updated:** YYYY-MM-DD

> [!IMPORTANT]
> **AI 填寫規則：** 本範本 6 段（編號 1, 2, 3, 5, 7, 10），全部必填——刻意沿用完整版的章節編號讓兩版可對照。每結論行內加 `（依據：deploy §XXX / slo §YYY）`；每量化欄位加 `[H]/[M]/[L]` confidence badge；rollback_steps 必須 ordered，每步附 `reversible: true/false` 與預估耗時；任何 irreversible step 必須在 Risk 段重述。

---

## 1. Executive Summary

<!-- ai-fill: 3-5 行，on-call 5 分鐘內讀完即可決策。寫「觸發條件、總耗時、最大不可逆風險」 -->

<3-5 行說明>

> **TL;DR:** <一句話：觸發 → 步驟 → 完成判定>

---

## 2. Triggers

<!-- ai-rule: 區分 SLO breach / error_rate / data_integrity 三類；每類含閾值 + 觀測窗口 -->

| Type | Signal | Threshold | Window | Confidence |
|---|---|---|---|---|
| SLO breach | error_rate | > 5% | 1 min | **[H]** |
| SLO breach | p95 latency | > baseline × 2 | 2 min | **[H]** |
| Data integrity | row count drift | > 1% | 5 min | **[M]** |

---

## 3. Rollback Steps（ordered）

<!-- ai-rule: 每步 ordered、附 reversible flag、預估耗時、owner。Irreversible step 用 [CAUTION] 標出 -->

| # | Action | Reversible? | Duration | Owner |
|---|---|---|---|---|
| 1 | Flip feature flag OFF | [YES] yes | 1 min | DevOps |
| 2 | Drain canary traffic to baseline | [YES] yes | 3 min | DevOps |
| 3 | Revert deployment to v<prev> | [YES] yes | 5 min | DevOps |
| 4 | [CAUTION] Run inverse migration (column rename) | [CAUTION] partial | 10 min | DBA |
| 5 | Verify health endpoints + smoke tests | [YES] yes | 2 min | SRE |

---

## 5. Data Compatibility & Irreversible Points

<!-- ai-rule: 標明 forward / backward / both；irreversible 必列補救方案（forward-only fix） -->

- **Compatibility direction:** backward (read old + new schema) **[H]**
- **Approach:** expand-contract
- **Irreversible points:**
  - <例：drop column users.legacy_id> — **Forward-only fix:** restore from backup + replay events

---

## 7. Comms & Decision Maker

<!-- ai-rule: 最少 2 個 channel（internal + external）；decision_maker 必填單一 role -->

- **Decision maker:** on-call SRE（半夜 3 點不需要 quorum）
- **Internal:** Slack #incidents — 觸發 + 完成各 1 則
- **External（若 user-facing）：** status page incident — 觸發 + ETA + 完成 3 則

---

## 10. Decision Log（key 1-2 條）

<!-- ai-rule: 每條必含 chosen + 至少 1 個 rejected option + 拒絕原因 -->

| Date | Decision | Options | Chosen | Rejected why | Confidence |
|---|---|---|---|---|---|
| YYYY-MM-DD | 自動 vs 手動觸發 | auto / manual / hybrid | hybrid | auto (false-positive 風險)、manual (半夜延遲) | **[H]** |

---

> [!CAUTION]
> **輸出前 AI 自檢：**
> - [ ] 6 段 H2 章節齊全（編號 1, 2, 3, 5, 7, 10）
> - [ ] Triggers 區分 SLO / error_rate / data_integrity
> - [ ] Rollback steps ordered + 每步 reversible flag + duration + owner
> - [ ] Irreversible step 用 [CAUTION] 標出且在 Data Compat 段列補救方案
> - [ ] Decision maker 是單一 role（不需 quorum）
> - [ ] Decision Log ≥ 1 條，含 rejected reason
> - [ ] 無 YAML / JSON schema 輸出