# INCIDENT_<服務名稱>_<事件類型>_<日期>.md

<!-- 
AI AGENT METADATA (YAML Frontmatter)
AI Agent 應優先讀取此區塊的結構化數據
-->
---
document_type: "incident"
service: "<服務名稱>"
problem: "<事件簡述>"
date: "<YYYY-MM-DD>"
severity: "P0"  # P0/P1/P2/P3/P4
status: "active"  # active/completed/archived
current_state: "pending"  # pending/investigating/resolving/resolved/closed
owner: "<負責人姓名>"
created_by: "<創建者姓名>"
created_at: "<YYYY-MM-DD HH:MM>"
version: "1.0"
incident_type: "服務中斷"  # 服務中斷/性能問題/安全事件/數據問題/配置錯誤
detection_method: "監控警報"  # 監控警報/用戶報告/系統日誌/例行檢查
impact_level: "高"  # 高/中/低
affected_users: "<受影響用戶數量或範圍>"
downtime: "<停機時間(分鐘)>"
tags:
- "incident"
- "<服務標籤>"
- "<事件類型>"
related_documents:
- "RCA_<相關分析>.md"
- "CHANGE_<相關變更>.md"
ai_query_hints:
- "如何查詢所有 P0/P1 級別的事件？"
- "如何找到過去 7 天內未解決的事件？"
- "如何更新事件狀態和時間線？"
---

<!-- 
HUMAN READABLE SECTION (Markdown Tables)
人類可讀的表格部分，AI Agent 也可解析但優先使用上述 YAML
-->
| 項目 | 內容 |
|------|------|
| 報告者 | (填寫報告人員姓名) |
| 報告時間 | (YYYY-MM-DD HH:MM) |
| 嚴重等級 | P0/P1/P2/P3/P4 |
| 當前狀態 | ⏳ 待處理 / 🔍 調查中 / 🔧 處理中 / ✅ 已解決 / 📁 已關閉 |
| 受影響服務 | (服務列表) |
| 負責人 | (指派負責人) |

---

## AI Agent 操作指南

### 快速查詢示例

```yaml
# 查詢所有 P0/P1 級別的事件
查找: document_type: "incident" AND (severity: "P0" OR severity: "P1")

# 查詢特定服務的未解決事件
查找: document_type: "incident" AND service: "n8n" AND current_state: "investigating"

# 查詢過去 24 小時內的事件
查找: document_type: "incident" AND date: ">=2026-03-26"
```

### 自動化操作

1. **狀態更新**：當事件狀態變更時，更新 `current_state` 和 `status`
2. **目錄移動**：根據狀態自動移動文件到相應目錄 (`_active/`, `_completed/`, `_archived/`)
3. **通知觸發**：根據嚴重等級和影響級別自動發送通知
4. **時間線追蹤**：自動記錄狀態變更時間和操作人員

### 數據提取

```python
# Python 示例：提取事件元數據
import yaml
import re

def extract_incident_metadata(file_path):
    with open(file_path, 'r') as f:
        content = f.read()
    
    # 提取 YAML frontmatter
    yaml_match = re.search(r'^---\n(.*?)\n---\n', content, re.DOTALL)
    if yaml_match:
        metadata = yaml.safe_load(yaml_match.group(1))
        return metadata
    
    # 備用：解析 Markdown 表格
    # ... 表格解析邏輯
```

---

## 版本歷史

| 版本 | 日期 | 目的 | 操作人 | 工具/模型 |
|------|------|------|--------|-----------|
| V1.0 | (日期) | 創建事件報告 | (姓名) | (工具) |

---

## 事件詳情

### 基本資訊

| 項目 | 內容 |
|------|------|
| **事件標題** | (簡短描述事件) |
| **事件類型** | 服務中斷 / 性能問題 / 安全事件 / 數據問題 / 配置錯誤 |
| **發現時間** | YYYY-MM-DD HH:MM |
| **發現方式** | 監控警報 / 用戶報告 / 系統日誌 / 例行檢查 |
| **影響範圍** | (受影響的用戶數量、服務、功能) |
| **業務影響** | 高/中/低 - (具體影響描述) |

### 事件描述

#### 問題現象
(描述用戶或系統觀察到的具體現象)

#### 預期行為  
(正常情況下應有的行為)

#### 實際行為
(實際觀察到的異常行為)

#### 重現步驟
1. (步驟1)
2. (步驟2)
3. (步驟3)

### 影響評估

| 影響維度 | 評估等級 | 詳細說明 |
|----------|----------|----------|
| **服務可用性** | 完全中斷 / 部分中斷 / 降級 | (影響描述) |
| **用戶影響** | 所有用戶 / 部分用戶 / 單一用戶 | (用戶群體) |
| **數據影響** | 數據丟失 / 數據損壞 / 無影響 | (數據影響細節) |
| **財務影響** | 高 / 中 / 低 | (估計損失或成本) |
| **聲譽影響** | 高 / 中 / 低 | (品牌或客戶信任影響) |

---

## 處理進度

### 時間線追蹤

| 時間 | 事件/操作 | 操作人員 | 狀態更新 | 備註 |
|------|----------|----------|----------|------|
| (時間) | 事件發現 | (姓名) | ⏳ 待處理 | (發現方式) |
| (時間) | 初步評估 | (姓名) | 🔍 調查中 | (初步結論) |
| (時間) | 根本原因分析 | (姓名) | 🔍 調查中 | (發現原因) |
| (時間) | 實施修復 | (姓名) | 🔧 處理中 | (修復措施) |
| (時間) | 驗證測試 | (姓名) | ✅ 已解決 | (驗證結果) |
| (時間) | 事件關閉 | (姓名) | 📁 已關閉 | (關閉原因) |

### 當前狀態

| 項目 | 狀態 | 詳細資訊 |
|------|------|----------|
| **調查進度** | 0-100% | (完成百分比) |
| **修復狀態** | 未開始 / 進行中 / 已完成 | (具體狀態) |
| **驗證狀態** | 待驗證 / 驗證中 / 已驗證 | (驗證結果) |
| **溝通狀態** | 內部通知 / 用戶通知 / 公開公告 | (溝通情況) |

### 臨時措施

| 措施 | 描述 | 實施時間 | 效果 | 負責人 |
|------|------|----------|------|--------|
| (措施1) | (詳細描述) | (時間) | ✅/⚠️/❌ | (姓名) |
| (措施2) | (詳細描述) | (時間) | ✅/⚠️/❌ | (姓名) |

### 根本原因分析 (初步)

| 可能原因 | 可能性 | 證據 | 調查方向 |
|----------|--------|------|----------|
| (原因1) | 高/中/低 | (支持證據) | (進一步調查) |
| (原因2) | 高/中/低 | (支持證據) | (進一步調查) |

---

## 溝通記錄

### 內部溝通

| 時間 | 溝通對象 | 溝通方式 | 內容摘要 | 發送人 |
|------|----------|----------|----------|--------|
| (時間) | 技術團隊 | Slack/Email | (摘要) | (姓名) |
| (時間) | 管理層 | 會議/報告 | (摘要) | (姓名) |

### 外部溝通 (如需要)

| 時間 | 溝通對象 | 溝通方式 | 內容摘要 | 狀態 |
|------|----------|----------|----------|------|
| (時間) | 客戶/用戶 | Email/公告 | (摘要) | 已發送/待發送 |

### 升級路徑

| 等級 | 觸發條件 | 通知對象 | 通知時限 |
|------|----------|----------|----------|
| L1 | 事件發現 | 技術團隊 | 立即 |
| L2 | P1/P0 事件 | 技術負責人 | 30分鐘內 |
| L3 | 業務影響重大 | 管理層 | 1小時內 |
| L4 | 公開影響 | 公關團隊 | 2小時內 |

---

## 資源分配

### 人員分配

| 角色 | 人員 | 聯繫方式 | 職責 |
|------|------|----------|------|
| 事件負責人 | (姓名) | (電話/郵件) | 協調處理全過程 |
| 技術調查 | (姓名) | (電話/郵件) | 調查根本原因 |
| 修復實施 | (姓名) | (電話/郵件) | 實施解決方案 |
| 溝通協調 | (姓名) | (電話/郵件) | 內外部溝通 |
| 驗證測試 | (姓名) | (電話/郵件) | 驗證修復效果 |

### 工具與資源

| 資源類型 | 名稱/路徑 | 用途 | 權限 |
|----------|-----------|------|------|
| 監控工具 | (工具名稱) | 問題診斷 | (權限) |
| 日誌系統 | (路徑) | 調查分析 | (權限) |
| 配置管理 | (系統) | 配置檢查 | (權限) |
| 備份系統 | (系統) | 數據恢復 | (權限) |

---

## 後續行動

### 立即行動 (24小時內)

| 行動項 | 描述 | 負責人 | 截止時間 | 狀態 |
|--------|------|--------|----------|------|
| (行動1) | (詳細描述) | (姓名) | (時間) | ⏳/✅ |
| (行動2) | (詳細描述) | (姓名) | (時間) | ⏳/✅ |

### 短期行動 (1-7天)

| 行動項 | 描述 | 負責人 | 截止日期 | 狀態 |
|--------|------|--------|----------|------|
| (行動1) | (詳細描述) | (姓名) | (日期) | ⏳/✅ |
| (行動2) | (詳細描述) | (姓名) | (日期) | ⏳/✅ |

### RCA 追蹤

| 項目 | 狀態 | 預計完成 | 負責人 |
|------|------|----------|--------|
| 創建 RCA 文件 | ⏳ 待開始 | (日期) | (姓名) |
| 根本原因分析 | ⏳ 待開始 | (日期) | (姓名) |
| 預防措施制定 | ⏳ 待開始 | (日期) | (姓名) |

---

## 附件與參考

### 相關文件

| 文件 | 用途 | 位置 |
|------|------|------|
| (相關文件1) | (用途) | (路徑) |
| (相關文件2) | (用途) | (路徑) |

### 日誌摘錄

```
(關鍵日誌內容)
```

### 監控圖表

| 指標 | 正常範圍 | 事件期間 | 當前值 |
|------|----------|----------|--------|
| (指標1) | (範圍) | (異常值) | (當前值) |
| (指標2) | (範圍) | (異常值) | (當前值) |

### 配置快照

| 配置項 | 事件前 | 當前值 | 變更原因 |
|--------|--------|--------|----------|
| (配置1) | (值) | (值) | (原因) |
| (配置2) | (值) | (值) | (原因) |

---

## 簽核與批准

### 事件關閉審核

| 審核項目 | 審核標準 | 審核結果 | 審核人 | 日期 |
|----------|----------|----------|--------|------|
| 問題解決 | 根本原因已識別並修復 | ✅/❌ | (姓名) | (日期) |
| 影響消除 | 所有影響已恢復正常 | ✅/❌ | (姓名) | (日期) |
| 驗證通過 | 所有測試用例通過 | ✅/❌ | (姓名) | (日期) |
| 文檔完整 | 所有相關文檔已更新 | ✅/❌ | (姓名) | (日期) |
| 溝通完成 | 所有相關方已通知 | ✅/❌ | (姓名) | (日期) |

### 批准關閉

| 角色 | 姓名 | 部門 | 批准意見 | 簽核狀態 | 日期 |
|------|------|------|----------|----------|------|
| 事件負責人 | (姓名) | 技術部 | (意見) | ⏳/✅ | (日期) |
| 技術負責人 | (姓名) | 技術部 | (意見) | ⏳/✅ | (日期) |
| 受影響方代表 | (姓名) | (部門) | (意見) | ⏳/✅ | (日期) |

---

## 附錄

### 術語定義

| 術語 | 定義 |
|------|------|
| MTTR | 平均修復時間 (Mean Time To Repair) |
| MTBF | 平均故障間隔時間 (Mean Time Between Failures) |
| SLA | 服務水平協議 (Service Level Agreement) |
| SLO | 服務水平目標 (Service Level Objective) |

### 嚴重等級參考

| 等級 | 代碼 | 處理時間目標 | 通知要求 |
|------|------|--------------|----------|
| P0 | 緊急 | 立即處理，1小時內解決 | 立即通知所有相關人員 |
| P1 | 高 | 2小時內開始處理，4小時內解決 | 1小時內通知負責人 |
| P2 | 中 | 4小時內開始處理，8小時內解決 | 2小時內通知負責人 |
| P3 | 低 | 1個工作日內處理 | 工作日內通知 |
| P4 | 資訊 | 3個工作日內回應 | 無需緊急通知 |

### 狀態標記說明

| 狀態 | 標記 | 說明 |
|------|------|------|
| 新報告 | ⏳ 待處理 | 事件剛被報告，尚未分配 |
| 調查中 | 🔍 調查中 | 正在調查根本原因 |
| 處理中 | 🔧 處理中 | 正在實施解決方案 |
| 已解決 | ✅ 已解決 | 問題已解決，待驗證 |
| 已關閉 | 📁 已關閉 | 事件完全關閉 |
| 已歸檔 | 🗄️ 已歸檔 | 事件已歸檔 |

---

**文件狀態**: ⏳ 進行中 / ✅ 已完成 / 📁 已關閉

**下次審查時間**: (YYYY-MM-DD HH:MM)

---

**AI Agent 備註**

**最後更新**: 2026-03-27  
**AI 優化版本**: V1.0  
**兼容性**: 向後兼容現有模板

**注意**: 
- AI Agent 應優先讀取 YAML frontmatter 獲取結構化數據
- 人類用戶可閱讀 Markdown 表格部分
- 兩部分數據應保持同步
