183 lines
5.0 KiB
Markdown
183 lines
5.0 KiB
Markdown
# 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 |