---
document_type: "operation_doc"
service: "MOMENTRY_CORE"
title: "維護紀錄管理目錄"
date: "2026-03-27"
version: "V1.0"
status: "active"
owner: "Warren"
created_by: "OpenCode"
tags:
  - "維護紀錄管理目錄"
ai_query_hints:
  - "查詢 維護紀錄管理目錄 的內容"
  - "維護紀錄管理目錄 的主要目的是什麼？"
  - "如何操作或實施 維護紀錄管理目錄？"
---

# 維護紀錄管理目錄

| 項目 | 內容 |
|------|------|
| 建立者 | OpenCode |
| 建立時間 | 2026-03-27 |
| 文件版本 | V1.0 |

---

## 版本歷史

| 版本 | 日期 | 目的 | 操作人 | 工具/模型 |
|------|------|------|--------|-----------|
| V1.0 | 2026-03-27 | 創建目錄說明文件 | OpenCode | deepseek-reasoner |

---

## 目錄概述

本目錄用於集中管理 Momentry 系統的所有運維相關紀錄，包括事件報告、根本原因分析、變更紀錄和維護計畫等。文件結構和模板經過 AI 優化設計，支持 AI Agent 高效查詢和自動化處理。

---

## 目錄結構

### 主要子目錄

| 目錄 | 用途 | 文件範例 | 保留期限 |
|------|------|----------|----------|
| [`rca/`](./rca/) | 根本原因分析 (Root Cause Analysis) | `RCA_WORDPRESS_*.md` | 2 年 |
| [`incidents/`](./incidents/) | 事件報告與處理紀錄 | `INCIDENT_POSTGRESQL_*.md` | 1 年 |
| [`changes/`](./changes/) | 系統變更與配置更新 | `CHANGE_DATABASE_*.md` | 3 年 |
| [`plans/`](./plans/) | 維護計畫與排程 | `MAINTENANCE_MONTHLY_*.md` | 1 年 |
| [`templates/`](./templates/) | 各類文件模板 | `TEMPLATE_RCA.md` | 永久 |

### 生命周期管理目錄

每個主要文檔類型（RCA、事件、變更、維護計畫）都有獨立的生命周期目錄：

| 目錄 | 用途 | 示例路徑 |
|------|------|----------|
| `_active/` | 進行中項目 | `rca/_active/`、`incidents/_active/` |
| `_completed/` | 已完成項目 | `rca/_completed/`、`incidents/_completed/` |
| `_archived/` | 已歸檔項目 | `rca/_archived/`、`incidents/_archived/` |

**AI 優化設計**：此結構支持 AI Agent 高效查詢和自動化文件移動。

---

## 文件命名規範

### 文件前綴

| 前綴 | 用途 | 範例 |
|------|------|------|
| `RCA_` | 根本原因分析 | `RCA_WORDPRESS_TIMEOUT_2026_03_27.md` |
| `INCIDENT_` | 事件報告 | `INCIDENT_DATABASE_CONNECTION_2026_03_26.md` |
| `CHANGE_` | 變更紀錄 | `CHANGE_API_ENDPOINT_2026_03_25.md` |
| `MAINTENANCE_` | 維護計畫 | `MAINTENANCE_MONTHLY_2026_04.md` |
| `TEMPLATE_` | 文件模板 | `TEMPLATE_RCA.md` |

### 命名規則

1. **前綴**：使用上述定義的前綴
2. **服務名稱**：使用大寫英文，如 `WORDPRESS`、`POSTGRESQL`
3. **問題簡述**：使用大寫英文和下劃線，如 `TIMEOUT_EXTERNAL_ACCESS`
4. **日期**：格式為 `YYYY_MM_DD`
5. **副檔名**：統一使用 `.md`

**完整範例**：
```
RCA_WORDPRESS_TIMEOUT_EXTERNAL_ACCESS_2026_03_27.md
```

---

## 文件生命周期管理

### 狀態流程

```
新創建 → [類型/_active/] → 處理完成 → [類型/_completed/] → 超過保留期限 → [類型/_archived/]
```

### 狀態說明

| 狀態 | 目錄（相對於文檔類型） | 處理要求 | 時間限制 |
|------|------------------------|----------|----------|
| ⏳ 進行中 | `_active/` | 需要定期更新進度 | 依事件等級而定 |
| ✅ 已完成 | `_completed/` | 需要最終驗證和簽核 | 保留 30 天 |
| 🗄️ 已歸檔 | `_archived/` | 只讀，供歷史參考 | 依保留期限 |

**注意**：每個文檔類型（RCA、事件、變更、維護計畫）都有獨立的生命周期目錄，例如 `rca/_active/`、`incidents/_completed/`。

### 保留政策

| 文件類型 | 活躍期 | 完成保留期 | 歸檔保留期 | 總保留期 |
|----------|--------|------------|------------|----------|
| RCA 文件 | P0: 7天<br>P1: 14天<br>P2-4: 30天 | 30 天 | 23 個月 | 2 年 |
| 事件報告 | P0: 3天<br>P1: 7天<br>P2-4: 14天 | 30 天 | 11 個月 | 1 年 |
| 變更紀錄 | 實施期間 | 90 天 | 33 個月 | 3 年 |
| 維護計畫 | 計畫期間 | 30 天 | 11 個月 | 1 年 |

---

## 事件嚴重等級

### 等級定義

| 等級 | 代碼 | 影響描述 | 處理時間目標 | 文件要求 |
|------|------|----------|--------------|----------|
| P0 | 緊急 | 服務完全中斷，影響所有用戶 | 立即處理，1小時內解決 | 必須創建 RCA |
| P1 | 高 | 主要功能不可用，影響多數用戶 | 2小時內開始處理，4小時內解決 | 建議創建 RCA |
| P2 | 中 | 次要功能問題，影響部分用戶 | 4小時內開始處理，8小時內解決 | 可選創建 RCA |
| P3 | 低 | 輕微問題，不影響核心功能 | 1個工作日內處理 | 事件報告即可 |
| P4 | 資訊 | 諮詢、建議或非緊急問題 | 3個工作日內回應 | 簡單紀錄 |

### 狀態標記

在文件頂部資訊表中使用以下標記：

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

---

## 文件模板

### 可用模板

| 模板文件 | 用途 | 位置 |
|----------|------|------|
| `TEMPLATE_RCA.md` | 根本原因分析模板 | [`templates/TEMPLATE_RCA.md`](./templates/TEMPLATE_RCA.md) |
| `TEMPLATE_INCIDENT.md` | 事件報告模板 | [`templates/TEMPLATE_INCIDENT.md`](./templates/TEMPLATE_INCIDENT.md) |
| `TEMPLATE_CHANGE.md` | 變更紀錄模板 | [`templates/TEMPLATE_CHANGE.md`](./templates/TEMPLATE_CHANGE.md) |

### 使用模板

1. 複製模板文件到目標目錄
2. 修改文件名稱符合命名規範
3. 填寫相關內容
4. 更新狀態和進度

---

## 操作流程

### 1. 報告新事件

```bash
# 1. 複製事件模板
cp templates/TEMPLATE_INCIDENT.md incidents/_active/INCIDENT_<服務>_<問題>_<日期>.md

# 2. 編輯文件內容
# 3. 更新狀態為 ⏳ 待處理
```

### 2. 升級為 RCA 分析

```bash
# 當事件需要深入分析時
cp templates/TEMPLATE_RCA.md rca/_active/RCA_<服務>_<問題>_<日期>.md

# 連結相關事件報告
# 在 RCA 文件中引用事件報告
```

### 3. 完成處理

```bash
# 1. 更新文件狀態為 ✅ 已解決
# 2. 移動到 _completed/ 目錄
mv rca/_active/RCA_*.md rca/_completed/
```

### 4. 定期歸檔

```bash
# 每月執行歸檔腳本
# 檢查 _completed/ 中的文件是否超過保留期限
# 移動過期文件到 _archived/
```

---

## 相關文件

| 文件 | 用途 | 位置 |
|------|------|------|
| DOCS_STANDARD.md | 文件創建規範 | `../DOCS_STANDARD.md` |
| DOCS_STANDARD_IMPROVEMENT_PROPOSAL_*.md | 規範改善建議 | `../DOCS_STANDARD_IMPROVEMENT_PROPOSAL_*.md` |
| SERVICES.md | 服務管理總覽 | `../SERVICES.md` |
| INCIDENT_RESPONSE_PROCEDURE.md | 事件處理流程 (SOP) | `../INCIDENT_RESPONSE_PROCEDURE.md` |
| AI_AGENT_DOCUMENTATION_GUIDE.md | AI Agent 使用指南 | `../AI_AGENT_DOCUMENTATION_GUIDE.md` |
| MIGRATION_PLAN.md | 運維文件遷移計畫 | `./MIGRATION_PLAN.md` |

---

## 聯繫與支援

### 負責人員

| 角色 | 姓名 | 聯繫方式 | 負責範圍 |
|------|------|----------|----------|
| 運維管理員 | Warren | (待補充) | 整體運維流程 |
| 文件管理員 | (待指定) | (待補充) | 文件規範與維護 |

### 問題回報

1. **文件規範問題**：更新 `DOCS_STANDARD_IMPROVEMENT_PROPOSAL_*.md`
2. **流程問題**：創建 `CHANGE_MAINTENANCE_PROCESS_*.md`
3. **技術問題**：創建相應的 `INCIDENT_*.md`

---

## 更新紀錄

| 日期 | 版本 | 變更內容 | 操作人 |
|------|------|----------|--------|
| 2026-03-27 | V1.0 | 創建目錄說明文件 | OpenCode |

---

**文件結束** - 最後更新: 2026-03-27
