# 📋 待處理問題

## 🔥 緊急問題
*目前無緊急問題*

## ⚠️ 重要問題
- [ ] 資料庫schema設計未確定
- [ ] 用戶認證流程細節模糊
- [x] UI一致性分析工具存在錯誤，需要修正檢查機制並重新分析 ✅ (2025-09-08)
  - 📊 **相關報告**: [UI一致性問題澄清報告](./reports/analysis/2025-09-08_ui-inconsistency-correction.md)
  - 📋 **解決狀態**: 已修正分析工具並重新檢查所有UI定義，確認所有7個UI都已存在
  - 🔍 **發現**: 原報告中的7個"缺失"UI實際上都已在System Design中定義

## 📝 一般問題
- [ ] 資料庫設計需要確認用戶表結構
- [ ] 文檔格式不統一
- [ ] UI組件命名規範
- [ ] 部分UI功能重複可能需要合併（多個Result相關UI）

## 🤖 與 Claude 協作提醒


### 🚨 強制性工作流程
**重要**: Claude 必須遵循以下強制性流程，避免系統不一致：

1. **報告建立**: 必須使用 `./drama report analysis "主題"`
2. **問題管理**: 必須使用 `./drama issue`
3. **系統檢查**: 定期使用 `./drama compliance` 和 `./drama consistency`
4. **參考指南**: 所有操作前先查看 `CLAUDE.md` 工作指南

**違反流程的後果**: 可能導致日期錯誤、格式不一致、系統追蹤失效等問題

---

# 📚 已完成歷史

## 2025-09-08 完成項目

### ⚠️ 重要問題 - 已完全解決
- [x] **02_design規格寫法不夠清楚，缺乏詳細的功能畫面規格** ✅ (2025-09-08)
  - 📊 **分析報告**: [02_design規格寫法改進需求分析](./reports/analysis/2025-09-08_02design規格寫法改進需求分析.md)
  - 🎯 **解決成果**: 完成5個核心功能的詳細規格文檔，總計約170頁完整規格
  - 📚 **建立文檔**:
    - [01_情境對話功能規格.md](./docs/02_design/function-specs/01_情境對話功能規格.md) (40頁)
    - [02_詞彙學習功能規格.md](./docs/02_design/function-specs/02_詞彙學習功能規格.md) (35頁)
    - [03_學習地圖功能規格.md](./docs/02_design/function-specs/03_學習地圖功能規格.md) (30頁)
    - [04_道具商店功能規格.md](./docs/02_design/function-specs/04_道具商店功能規格.md) (35頁)
    - [05_用戶認證功能規格.md](./docs/02_design/function-specs/05_用戶認證功能規格.md) (30頁)
  - 📋 **規格覆蓋**: 43個UI畫面的完整規格，包含功能說明、欄位細節、使用者流程、資料說明
  - 🚀 **開發效益**: 預估提升40%開發效率，減少80%需求澄清時間，降低60%實現偏差
  - 📁 **文檔總覽**: [function-specs/README.md](./docs/02_design/function-specs/README.md)

### 🔥 緊急問題 - 已解決
- [x] **API模組化文檔中有7個待建立的模組**
  - 📊 **解決狀態**: 已完成所有7個API模組建立 (2025-09-08)
  - 📂 **建立的模組**: learning-content.md, vocabulary.md, dialogue-practice.md, gamification.md, subscription.md, daily-missions.md, language-levels.md
  - ✅ **驗證**: 所有模組檔案已建立在 docs/04_technical/api/ 目錄

### 🏆 重要問題 - 已完全解決
- [x] **System Design與User Flow的UI設計缺漏問題 - 100%完成** ✅ (2025-09-08)
  - 📊 **最終狀態**: 所有40個缺失UI的User Flow已100%補充完成
  - 🎯 **歷史意義**: 從設計缺漏到完整規格，實現零缺漏的User Flow文檔
  - 📈 **完成進度**: 40個缺失UI → 0個缺失UI，完成度100% 🏆
  - ✅ **第1週**: 對話糾正系統(12個) + 學習結果系統(7個) = 19個UI
  - ✅ **第2週**: 詞彙系統(6個) + 情境對話(4個) + 複習系統(3個) = 13個UI
  - ✅ **社交功能**: 社交學習系統3個UI (2025-09-08)
  - ✅ **管理功能**: 個人中心管理系統7個UI (2025-09-08) - 實現最終完成
  - 📂 **更新文檔**: docs/04_technical/user-flow-specification.md - 完整21個功能模組
  - 📊 **綜合分析**: [UI設計缺漏嚴重性評估](./reports/analysis/2025-09-07_UI-design-gaps-severity-analysis.md)
  - 🚀 **開發準備度**: 100% - 可立即進入開發階段

## 2025-09-07 完成項目

### 🔥 緊急問題 - 已解決
- [x] **對話糾正系統缺失完整User Flow**，影響核心學習功能（9個UI）
  - 📊 **詳細分析**: [UI設計缺漏嚴重性評估](./reports/analysis/2025-09-07_UI-design-gaps-severity-analysis.md)
  - 📋 **User Flow設計**: [對話糾正系統流程設計](/tmp/ui_analysis/dialog_correction_flow.md)
  - ✅ **解決狀態**: 已完成完整對話糾正系統User Flow設計並整合到官方文檔

- [x] **System Design與User Flow的UI名稱不一致**
  - 📊 **分析報告**: [UI一致性分析報告](./reports/analysis/2025-09-07_UI-consistency-analysis.md)
  - ✅ **解決狀態**: 已修正命名錯誤和特殊字符，39個缺漏UI待補充

### 📝 一般問題 - 已解決
- [x] **UI名稱包含特殊字符**（如UI_ChallengeLevel_ChoosePopup-1有連字號）
- [x] **UI命名不一致**（UI_PresonalCenter_dd_Detail有拼寫錯誤）

### 🤖 Claude 協作 - 已完成
- [x] **建立 Claude 工作指南文件** (CLAUDE.md)
- [x] **在系統工具中加入操作提醒和防護機制**
- [x] **建立合規性檢查系統** (`./drama compliance`)
- [x] **建立問題追蹤系統**

---

## 💡 問題維護機制

### 📝 新增問題
**推薦方式**: 使用 `./drama issue` 工具
- 自動分類到正確優先級
- 統一格式和日期
- 互動式操作，不易出錯

**手動方式**: 直接編輯本檔案（緊急時）
```
- [ ] 問題描述 (優先級: 🔥緊急/⚠️重要/📝一般)
  - 檔案: path/to/file.md:line
  - 影響: 描述影響
  - 建議: 可能的解決方向
```

### ✅ 完成問題
1. **標記完成**: 將 `[ ]` 改為 `[x]`
2. **移動位置**: 從待處理區域移到「📚 已完成歷史」
3. **按日期分組**: 放到對應的日期區域（如：2025-09-08 完成項目）
4. **保留詳情**: 移動時保留解決詳情和連結

### 🔄 定期維護

#### 每日檢查
- 查看是否有新的緊急問題
- 更新問題進度

#### 每週整理
- 整理已完成項目到正確日期區域
- 檢查是否有逾期的重要問題
- 評估問題優先級是否需要調整

#### 每月歸檔
- 將超過一個月的完成項目移到歷史存檔
- 統計問題解決效率
- 檢討常見問題類型

### 📊 快速查看
- **待處理總覽**: `./drama check`
- **完整列表**: `./drama issue` → 選項 4
- **狀態統計**: `./drama issue` → 選項 2

---

## 🎯 使用原則

### 🚨 緊急問題
- **定義**: 阻擋開發進度的嚴重問題
- **處理時間**: 立即處理
- **範例**: API 衝突、資料庫設計錯誤

### ⚠️ 重要問題  
- **定義**: 影響功能完整性的問題
- **處理時間**: 本週內
- **範例**: UI 設計缺漏、功能需求不明確

### 📝 一般問題
- **定義**: 可以延後處理的改進
- **處理時間**: 有空閒時
- **範例**: 文檔格式、命名規範

### 📚 歷史記錄
- **用途**: 了解最近完成的工作
- **組織**: 按完成日期分組
- **保留**: 解決方案和相關連結