dramaling-app/reports/analysis/2025-09-07_UI-consistency-analysis.md

System Design 與 User Flow UI 名稱不一致分析報告

📊 檢查結果總覽

數據統計

• System Design UI 總數: 100個
• User Flow UI 總數: 68個
• 共同 UI 數量: 61個
• System Design 獨有: 39個
• User Flow 獨有: 7個

問題嚴重性評估

🔴 嚴重問題: System Design 有39個UI在 User Flow 中未定義，占39% 🟡 中等問題: User Flow 有7個UI在 System Design 中未定義，占10.3% 🟢 命名問題: 發現拼寫錯誤和格式不一致

🔍 詳細差異分析

1. System Design 獨有的UI (39個)

帳戶管理相關

• UI_Account_List - 帳戶列表
• UI_Account_Option - 帳戶選項

對話糾正系統

• UI_Correction_Fluency_Practice - 流暢度練習
• UI_Correction_Grammar_Retry - 語法重試
• UI_Correction_Pass_Result - 通過結果
• UI_Correction_Retry_Result - 重試結果
• UI_DialogCorrection_FluencyExplanation_Play - 流暢度解釋播放
• UI_DialogCorrection_FluencyPass_Result - 流暢度通過結果
• UI_DialogCorrection_FluencyRetry_Play - 流暢度重試播放

等級結果系統

• UI_LevelResult_CorrectionResult - 糾正結果
• UI_LevelResult_DialogScoreSummary - 對話分數總結
• UI_LevelResult_FailResult2 - 失敗結果2
• UI_LevelResult_RewardConfirm - 獎勵確認
• UI_LevelResult_ScoreSummary - 分數總結
• UI_LevelResult_ScoreSummary2 - 分數總結2
• UI_LevelResult_SmallReward - 小獎勵
• UI_LevelResult_SuccessResult2 - 成功結果2

複習系統

• UI_ReviewCards - 複習卡片
• UI_ReviewProgress - 複習進度
• UI_ReviewSchedule - 複習排程

社交功能

• UI_Social_Friends - 社交朋友
• UI_Social_Profile - 社交檔案
• UI_Social_Search - 社交搜尋

詞彙系統結果

• UI_VocabFluency_MatchImageResult - 詞彙流暢度圖片匹配結果
• UI_VocabFluency_SentenceResult - 詞彙流暢度句子結果
• UI_VocabIntro_ChoiceResult - 詞彙介紹選擇結果
• UI_Vocab_Choice_Results - 詞彙選擇結果
• UI_Vocab_Fluency_Results - 詞彙流暢度結果
• UI_Vocab_Sentence_Results - 詞彙句子結果

2. User Flow 獨有的UI (7個)

成本確認

• UI_Cost_Confirm_Popup - 成本確認彈窗

資源不足

• UI_Insufficient_Resources - 資源不足

等級結果

• UI_LevelResult_SuccessResult - 成功結果

生命點數

• UI_LifePoints_Display - 生命點數顯示

商店確認

• UI_Shop_Item_Confirm - 商店項目確認

訂閱成功

• UI_Subscription_Success - 訂閱成功

時光系統

• UI_TimeWarp_Cards - 時光卡片

🚨 發現的問題

拼寫錯誤

1. UI_PresonalCenter_dd_Detail → 應為 UI_PersonalCenter_dd_Detail

命名格式不一致

1. UI_ChallengeLevel_ChoosePopup-1 - 包含連字號
2. UI_ChallengeLevel_ChoosePopup-2 - 包含連字號

功能重複可能性

1. 多個 LevelResult_* UI 可能功能重複
2. 多個 Vocab_*_Results UI 可能可以合併

💡 統一建議

短期解決方案 (立即執行)

1. 修正拼寫錯誤

// 在 system_structure_design.json 中
"UI_PresonalCenter_dd_Detail" → "UI_PersonalCenter_dd_Detail"

2. 統一命名格式

// 移除特殊字符
"UI_ChallengeLevel_ChoosePopup-1" → "UI_ChallengeLevel_ChoosePopup1"
"UI_ChallengeLevel_ChoosePopup-2" → "UI_ChallengeLevel_ChoosePopup2"

3. 在 User Flow 中補充缺失的重要UI

優先補充以下核心功能UI：

• 對話糾正系統 (9個UI)
• 等級結果系統 (8個UI)
• 複習系統 (3個UI)

中期解決方案 (1-2週內)

1. 建立UI命名規範

• 格式：UI_[Module]_[Function]_[Type]
• 類型：Main, Popup, Modal, Result, Detail
• 避免特殊字符和數字後綴

2. UI功能重複檢查

• 合併相似的Result UI
• 統一Popup命名方式
• 檢查功能重疊的UI

3. 補全User Flow定義

• 為所有System Design中的UI撰寫用戶流程
• 確保每個UI都有明確的觸發條件和導航路徑

長期解決方案 (1個月內)

1. 建立UI庫管理系統

• 建立統一的UI組件清單
• 定期同步檢查兩個文檔
• 建立UI變更審核流程

2. 自動化檢查工具

• 將UI一致性檢查加入CI/CD流程
• 建立UI命名檢查腳本
• 定期生成差異報告

🎯 執行優先級

🔥 緊急 (本週內)

1. 修正拼寫錯誤
2. 統一命名格式
3. 補充核心功能UI的用戶流程

⚠️ 重要 (2週內)

1. 建立UI命名規範
2. 檢查並合併重複UI
3. 補全所有缺失的User Flow定義

📝 一般 (1個月內)

1. 建立UI庫管理系統
2. 實施自動化檢查
3. 定期維護和更新

📋 後續追蹤

檢查清單

• 修正 UI_PresonalCenter_dd_Detail 拼寫
• 移除UI名稱中的特殊字符
• 為39個缺失UI撰寫User Flow
• 建立UI命名規範文檔
• 實施定期檢查機制

成功指標

• UI一致性率達到95%以上
• 命名規範遵循率100%
• 新增UI都有對應的用戶流程定義

---

報告生成時間: 2024-12-08
下次檢查時間: 2024-12-15