85 lines
1.8 KiB
Markdown
85 lines
1.8 KiB
Markdown
# 📊 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 |