# 📊 Drama Ling 報告管理系統

## 📁 目錄結構

```
reports/
├── analysis/           # 問題分析報告
├── decisions/         # 技術決策記錄  
├── templates/         # 報告模板
├── archive/          # 已歸檔報告
└── README.md         # 本文件
```

## 🔄 報告與問題系統整合

每個分析報告都會在 `ISSUES.md` 中建立對應的問題追蹤項目，包含：
- 問題描述
- 報告連結
- 解決狀態
- 後續行動

## 📝 報告命名規範

### 分析報告 (analysis/)
格式：`YYYY-MM-DD_[問題類型]-analysis.md`

範例：
- `2025-09-07_UI-consistency-analysis.md`
- `2024-12-15_API-modules-analysis.md`
- `2024-12-22_database-schema-analysis.md`

### 決策記錄 (decisions/)
格式：`YYYY-MM-DD_[決策主題]-decision.md`

範例：
- `2024-12-08_UI-naming-standards-decision.md`
- `2024-12-15_tech-stack-decision.md`

## 🎯 報告生命週期

1. **建立階段**
   - 在 analysis/ 目錄建立報告
   - 在 ISSUES.md 中建立對應問題項目
   - 連結報告到問題

2. **追蹤階段**  
   - 定期更新問題狀態
   - 記錄解決進度
   - 更新後續行動

3. **完成階段**
   - 標記問題為已解決
   - 將重要決策記錄移到 decisions/
   - 將過時報告移到 archive/

## 🛠️ 報告管理工具

### 快速建立報告
```bash
./create_report.sh analysis "UI consistency check"
./create_report.sh decision "Tech stack selection"
```

### 檢查報告狀態
```bash
./check_reports.sh
```

### 歸檔舊報告
```bash
./archive_reports.sh 30  # 歸檔30天前的報告
```

## 📋 報告模板

### 分析報告模板
- [analysis-template.md](./templates/analysis-template.md)

### 決策記錄模板  
- [decision-template.md](./templates/decision-template.md)

---

**維護團隊**: Drama Ling 開發團隊  
**更新日期**: 2024-12-08