# 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. 修正拼寫錯誤 ```json // 在 system_structure_design.json 中 "UI_PresonalCenter_dd_Detail" → "UI_PersonalCenter_dd_Detail" ``` #### 2. 統一命名格式 ```json // 移除特殊字符 "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