dramaling-app/docs/design/gamification-mechanics.md

# 遊戲化機制設計規格

## 概述
定義 Drama Ling 應用中的完整遊戲化系統，包含排行榜、成就系統、闖關機制等，提升用戶學習動機和留存率。

## 排行榜競爭機制

### 排行榜類型
- [ ] **全球排行榜**: 所有用戶的總體排名
- [ ] **週排行榜**: 每週重置的短期競爭
- [ ] **月排行榜**: 月度學習成就排名  
- [ ] **好友排行榜**: 僅顯示好友間的排名比較
- [ ] **等級分組排行榜**: 依語言程度分組競爭
- [ ] **地區排行榜**: 基於地理位置的本地競爭

### 積分計算規則
#### 基礎積分來源 (總分 = 基礎分 × 難度係數 × 連擊加成)

**對話練習積分**
- [ ] **完成對話**: 10分/次
- [ ] **使用目標詞彙**: +5分/個詞彙
- [ ] **達成任務目標**: +15分/任務
- [ ] **流暢完成對話**: +10分 (無需AI提示)

**評分積分轉換**
- [ ] **語法評分**: 0.3 × 語法分數
- [ ] **語意評分**: 0.3 × 語意分數  
- [ ] **流暢度評分**: 0.4 × 流暢度分數
- [ ] **綜合優秀**: 三維度均 > 85分時 +50分獎勵

**特殊活動積分**
- [ ] **限時挑戰完成**: 基礎分 × 1.5倍
- [ ] **首次嘗試新場景**: +25分
- [ ] **連續學習天數**: +5分/天 (上限 +100分)
- [ ] **幫助其他用戶**: +20分 (回答問題、分享經驗)

#### 難度係數設定
- [ ] **初級場景 (A1-A2)**: 1.0倍
- [ ] **中級場景 (B1-B2)**: 1.3倍  
- [ ] **高級場景 (C1-C2)**: 1.6倍
- [ ] **專業場景 (商務、醫療等)**: 1.8倍
- [ ] **即興對話場景**: 2.0倍

#### 連擊加成機制
- [ ] **連續成功對話**: 2-5次 (+10%), 6-10次 (+20%), 11+次 (+30%)
- [ ] **每日連擊**: 連續天數 × 2% 加成 (上限 +60%)
- [ ] **完美表現**: 當日所有對話評分 > 90分時 +50% 加成
- [ ] **挑戰連擊**: 連續完成限時挑戰 +25% 加成/次

### 排行榜更新機制
- [ ] **即時更新**: 積分變化立即反映
- [ ] **排名快取**: 5分鐘更新一次排名顯示
- [ ] **歷史記錄**: 保存每日/週/月排名變化
- [ ] **排名爭議處理**: 異常分數檢測和處理機制

## 成就系統設計

### 成就分類

#### 學習里程碑類
- [ ] **初學者**: 完成首次對話
- [ ] **勤奮學習者**: 連續學習 7/30/100 天
- [ ] **場景探索家**: 完成 5/15/50 個不同場景
- [ ] **詞彙大師**: 掌握 100/500/2000 個詞彙
- [ ] **對話達人**: 完成 50/200/1000 次對話練習
- [ ] **完美主義者**: 獲得 10/50/200 次滿分評價

#### 技能提升類  
- [ ] **語法專家**: 語法評分達到 90+ 分 10/50/200 次
- [ ] **語意高手**: 語意評分達到 90+ 分 10/50/200 次
- [ ] **流暢達人**: 流暢度評分達到 90+ 分 10/50/200 次
- [ ] **全能選手**: 三維度同時達到 85+ 分 5/20/100 次
- [ ] **快速反應**: 限時挑戰中 10/50/200 次快速完成

#### 社交互動類
- [ ] **樂於助人**: 幫助其他用戶 10/50/200 次
- [ ] **人氣王**: 獲得 50/200/1000 個好友讚賞
- [ ] **分享達人**: 分享學習成果 20/100/500 次
- [ ] **導師**: 指導新用戶學習 5/20/100 次
- [ ] **社群領袖**: 在討論區發表優質內容 30/150/500 次

#### 挑戰征服類
- [ ] **勇敢嘗試**: 嘗試高難度場景 5/20/100 次
- [ ] **速度之王**: 在時限內完成對話 20/100/500 次
- [ ] **堅持不懈**: 從失敗中重新挑戰 10/50/200 次
- [ ] **創新思維**: 使用創意表達方式 15/75/300 次
- [ ] **極限挑戰**: 完成最高難度場景 1/5/20 次

#### 特殊節日類
- [ ] **新年決心**: 新年期間連續學習 7 天
- [ ] **情人節浪漫**: 完成浪漫場景對話 10 次
- [ ] **萬聖節驚奇**: 完成恐怖/驚悚場景 5 次
- [ ] **聖誕精神**: 12月完成 25 次學習任務
- [ ] **生日慶祝**: 生日當天完成特殊挑戰

### 成就獎勵機制
- [ ] **徽章收藏**: 每個成就對應獨特徽章設計
- [ ] **積分獎勵**: 不同等級成就給予 50/200/500 積分獎勵  
- [ ] **稱號系統**: 解鎖專屬稱號在排行榜顯示
- [ ] **內容解鎖**: 解鎖新場景、新功能或專屬內容
- [ ] **實體獎勵**: 高級成就獲得實體紀念品 (限量版)

### 成就進度追蹤
- [ ] **視覺化進度條**: 清楚顯示完成進度
- [ ] **階段性提醒**: 接近完成時的推送通知  
- [ ] **成就預告**: 即將解鎖的成就提示
- [ ] **統計面板**: 個人成就完成統計概覽
- [ ] **好友比較**: 與好友的成就完成度比較

## 闖關系統設計

### 關卡結構

#### 主線關卡 (情境導向)
- [ ] **第一章: 日常生活** (10關)
  - 自我介紹、購物、餐廳、交通等基礎場景
  - 解鎖條件: 無 (新手引導)
  - 完成獎勵: 100積分 + 基礎徽章

- [ ] **第二章: 社交互動** (12關)  
  - 朋友聚會、約會、工作會議、電話對話等
  - 解鎖條件: 第一章通過率 ≥ 80%
  - 完成獎勵: 150積分 + 社交徽章

- [ ] **第三章: 應急處理** (15關)
  - 醫療急救、車禍處理、投訴申訴、緊急求助等  
  - 解鎖條件: 第二章通過率 ≥ 75% + 總積分 ≥ 1000
  - 完成獎勵: 200積分 + 危機處理徽章

- [ ] **第四章: 專業場景** (18關)
  - 商務談判、學術討論、技術交流、面試等
  - 解鎖條件: 第三章通過率 ≥ 70% + 連續學習 ≥ 30天
  - 完成獎勵: 300積分 + 專業徽章

#### 支線關卡 (技能導向)
- [ ] **語法強化關**: 專注語法訓練的特殊關卡
- [ ] **詞彙擴展關**: 大量新詞彙學習關卡
- [ ] **發音矯正關**: 語音識別和發音練習關卡  
- [ ] **文化理解關**: 目標語言文化背景學習關卡
- [ ] **考試準備關**: 針對語言檢定考試的專門關卡

#### 每日挑戰關
- [ ] **每日一題**: 精選對話場景每日更新
- [ ] **週題挑戰**: 週末特殊難題挑戰  
- [ ] **月度任務**: 整月累積完成的大型任務
- [ ] **季節活動**: 配合節日的限時特殊關卡
- [ ] **突發事件**: 隨機出現的緊急情境關卡

### 關卡評價系統
- [ ] **三星評級**: 基於綜合表現的 1-3 星評價
  - ⭐ 通過: 綜合評分 ≥ 60分
  - ⭐⭐ 良好: 綜合評分 ≥ 80分  
  - ⭐⭐⭐ 優秀: 綜合評分 ≥ 95分

- [ ] **完成條件**:
  - 達成主要對話目標
  - 使用指定關鍵詞彙 (如有)
  - 在時間限制內完成 (如有)
  - 維持角色扮演一致性

- [ ] **重複挑戰**: 允許重複挑戰提升星級評價
- [ ] **額外目標**: 每關設定 2-3 個額外挑戰目標

### 解鎖機制
- [ ] **順序解鎖**: 主線關卡需按順序完成
- [ ] **條件解鎖**: 滿足特定條件才能解鎖新內容
- [ ] **付費解鎖**: 部分高級內容需要付費或達到VIP等級  
- [ ] **社交解鎖**: 邀請好友或達到社交成就解鎖
- [ ] **時間解鎖**: 某些內容在特定時間開放

## 進度追蹤系統

### 個人進度面板
- [ ] **整體進度**: 所有關卡完成百分比
- [ ] **各章節進度**: 每章節詳細完成情況
- [ ] **技能雷達圖**: 語法/語意/流暢度能力視覺化
- [ ] **學習軌跡**: 每日/週/月學習時間和強度變化
- [ ] **成長曲線**: 長期能力提升趨勢圖

### 統計資訊
- [ ] **累計學習時間**: 總學習時長統計
- [ ] **對話完成數**: 累計完成對話次數
- [ ] **詞彙掌握量**: 已學習和熟練掌握詞彙統計
- [ ] **場景體驗數**: 體驗過的不同情境場景統計  
- [ ] **AI互動次數**: 與AI分析系統的互動統計

### 學習建議
- [ ] **弱項分析**: 基於表現數據識別學習弱點
- [ ] **推薦關卡**: 個性化推薦適合的下一個關卡
- [ ] **學習計劃**: AI生成的個人化學習進度安排
- [ ] **複習提醒**: 基於遺忘曲線的複習內容建議
- [ ] **目標設定**: 協助用戶設定並追蹤學習目標

## 社交競爭機制

### 好友系統
- [ ] **好友邀請**: 通過ID、QR碼、聯絡人邀請好友
- [ ] **好友動態**: 查看好友的學習進度和成就
- [ ] **互相鼓勵**: 為好友的成就點讚和留言
- [ ] **學習PK**: 與好友進行一對一學習競賽
- [ ] **組隊學習**: 多人協作完成團體挑戰

### 學習群組
- [ ] **主題群組**: 按學習主題或程度分組
- [ ] **地區群組**: 同地區學習者交流群組  
- [ ] **學習夥伴**: 匹配相似程度的學習夥伴
- [ ] **導師制度**: 高級用戶指導初學者
- [ ] **學習俱樂部**: 定期舉辦線上/線下學習活動

### 競賽活動
- [ ] **週賽**: 每週主題競賽活動
- [ ] **月度錦標賽**: 月度大型競賽活動
- [ ] **季度總決賽**: 季度最高榮譽競賽
- [ ] **特殊賽事**: 節日或紀念日特別賽事
- [ ] **團體戰**: 群組間的團體競賽活動

---

## 技術實現考量

### 資料存儲
- [ ] **積分記錄**: 用戶積分變化歷史記錄
- [ ] **成就狀態**: 各項成就的完成狀態和進度
- [ ] **關卡進度**: 關卡完成狀態和評級記錄
- [ ] **排行榜快取**: 高效的排行榜查詢和更新機制
- [ ] **統計數據**: 各種學習統計數據的存儲結構

### 效能優化
- [ ] **排行榜快取策略**: Redis快取熱門排行榜數據  
- [ ] **積分批次更新**: 避免頻繁數據庫寫入
- [ ] **成就檢查優化**: 高效的成就觸發檢測機制
- [ ] **統計數據預計算**: 定期預計算複雜統計數據
- [ ] **分散式處理**: 大量用戶同時更新的處理策略

### 防作弊機制
- [ ] **異常檢測**: 識別異常高分或快速完成的可疑行為
- [ ] **行為分析**: 分析用戶學習行為模式的合理性
- [ ] **時間驗證**: 驗證完成任務的時間合理性
- [ ] **IP限制**: 防止同一IP多帳號刷分
- [ ] **人工審核**: 對可疑高分進行人工審核機制

---

## 待完成任務

### 高優先級
1. [ ] 確定積分計算的具體數值和平衡性
2. [ ] 設計成就系統的徽章視覺設計  
3. [ ] 規劃關卡內容的具體場景劇本
4. [ ] 建立防作弊機制的技術方案

### 中優先級
1. [ ] 設計社交功能的互動介面
2. [ ] 規劃競賽活動的舉辦週期和規則
3. [ ] 建立學習數據的分析和建議算法
4. [ ] 設計個性化推薦系統

### 低優先級  
1. [ ] 研究遊戲化的心理學原理應用
2. [ ] 探索AR/VR技術在闖關系統的應用
3. [ ] 建立與外部平台的積分兌換機制
4. [ ] 設計線下活動與線上系統的結合

---

**最後更新**: 2024年9月5日  
**負責人**: 待分配  
**審查週期**: 每兩週檢討一次