dramaling-app/ISSUES.md

📋 待處理問題

🔥 緊急問題

• API模組化文檔中有7個待建立的模組

⚠️ 重要問題

• 資料庫schema設計未確定
• 用戶認證流程細節模糊
• System Design有40個UI但User Flow沒有，存在大量設計缺漏（比預期更嚴重）
  • 📊 綜合分析: UI設計缺漏嚴重性評估
  • 📊 基礎報告: UI一致性分析報告
  • 📊 功能分類: 缺失UI功能分類分析
  • 📋 實施計劃: 第1週-核心功能(17個)，第2週-重要功能(13個)，第4週-次要功能(10個)
  • ⚠️ 緊急建議: 暫停非核心功能開發，優先補全對話糾正和學習結果系統
• User Flow有7個UI但System Design沒有，可能是實作時新增的UI
  • 📊 相關報告: UI一致性分析報告
  • 📋 後續行動: 需確認這7個UI是否為必要功能

📝 一般問題

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

🤖 與 Claude 協作提醒

• Claude 必須優先使用 ./drama report 而非手動創建報告
• Claude 必須使用 ./drama issue 而非直接編輯 ISSUES.md
• 定期運行 ./drama compliance 檢查系統合規性
• 如果 Claude 發現規格不確定或衝突，立即記錄到對應優先級區域
• Claude 實作功能時發現的技術難題也要記錄
• 請 Claude 在完成任務後總結發現的問題

🚨 強制性工作流程

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

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

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

---

📚 已完成歷史

2025-09-07 完成項目

🔥 緊急問題 - 已解決

• 對話糾正系統缺失完整User Flow，影響核心學習功能（9個UI）

  • 📊 詳細分析: UI設計缺漏嚴重性評估
  • 📋 User Flow設計: 對話糾正系統流程設計
  • ✅ 解決狀態: 已完成完整對話糾正系統User Flow設計並整合到官方文檔

• System Design與User Flow的UI名稱不一致

  • 📊 分析報告: UI一致性分析報告
  • ✅ 解決狀態: 已修正命名錯誤和特殊字符，39個缺漏UI待補充

📝 一般問題 - 已解決

• UI名稱包含特殊字符（如UI_ChallengeLevel_ChoosePopup-1有連字號）
• UI命名不一致（UI_PresonalCenter_dd_Detail有拼寫錯誤）

🤖 Claude 協作 - 已完成

• 建立 Claude 工作指南文件 (CLAUDE.md)
• 在系統工具中加入操作提醒和防護機制
• 建立合規性檢查系統 (./drama compliance)
• 建立問題追蹤系統

---

💡 問題維護機制

📝 新增問題

推薦方式: 使用 ./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 設計缺漏、功能需求不明確

📝 一般問題

• 定義: 可以延後處理的改進
• 處理時間: 有空閒時
• 範例: 文檔格式、命名規範

📚 歷史記錄

• 用途: 了解最近完成的工作
• 組織: 按完成日期分組
• 保留: 解決方案和相關連結