dramaling-app/docs/02_design/gamification-mechanics.md

# 遊戲化機制設計規格

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

## 排行榜競爭機制

### 排行榜類型
基於 UI_SocialRanking_Main.png 的實際設計，採用簡化的好友排行榜系統：

- [ ] **好友排行榜**: 主要排行榜功能，顯示好友間的閃電能量比較
- [ ] **排名顯示**: 1-7名好友排列，每位顯示頭像、姓名和閃電總數
- [ ] **個人突顯**: 第4名使用紫色背景突顯當前用戶位置

### 成就獎勵系統
基於 UI_LevelResult_ScoreSummary.png 的實際設計，採用簡化的三項成就機制：

#### 核心成就系統 *(更新)*
- [ ] **過關獎勵** (通關寶箱)
  - 完成對話場景即可獲得
  - 獎勵: +10 鑽石 + 10 閃電能量
  
- [ ] **完美語法** 
  - 語法評分達到優秀標準
  - 獎勵: +10 鑽石 + 10 閃電能量
  
- [ ] **表達流利**
  - 流暢度評分達到優秀標準  
  - 獎勵: +10 鑽石 + 10 閃電能量

#### 雙重通關條件成就 *(新增核心功能)*
- [ ] **劇情大師**
  - 成功完成劇情任務且表現優秀
  - 觸發條件: 完成所有劇情任務要素且邏輯連貫
  - 獎勵: +15 鑽石 + 15 閃電能量 + 劇情成就徽章
  
- [ ] **詞彙專家** 
  - 正確且自然地使用所有指定詞彙
  - 觸發條件: 使用指定詞彙且符合語境和自然度要求
  - 獎勵: +12 鑽石 + 12 閃電能量 + 詞彙成就徽章
  
- [ ] **完美對話**
  - 同時滿足劇情任務和指定詞彙雙重條件
  - 觸發條件: 劇情任務完成 + 詞彙正確使用 + 整體評分≥90
  - 獎勵: +25 鑽石 + 25 閃電能量 + 雙重成就特殊徽章 + 1個回覆提示道具

#### 輔助功能成就 *(新增功能)*
- [ ] **智慧學習者**
  - 首次使用回覆輔助功能並成功完成對話
  - 觸發條件: 使用回覆提示道具完成對話
  - 獎勵: +5 鑽石 + 2個回覆提示道具

- [ ] **獨立進步**  
  - 在同一場景中，先使用輔助後能獨立完成類似對話
  - 觸發條件: 同場景使用輔助後，下次對話無需輔助且分數≥85
  - 獎勵: +15 鑽石 + 15 閃電能量

- [ ] **翻譯達人**
  - 累計使用中翻英功能50次
  - 觸發條件: 中翻英功能使用次數達標
  - 獎勵: +20 鑽石 + 5個回覆提示道具

#### 獎勵貨幣系統
- [ ] **鑽石** (💎): 主要遊戲貨幣，用於購買道具和解鎖內容
- [ ] **閃電能量** (⚡): 用於加時、提示等輔助功能  
- [ ] **回覆提示道具** (💡): 專用於回覆卡關輔助功能 *(新增)*
- [ ] **限時挑戰門票** (🎫): 專用於300秒限時挑戰入場 *(新增)*
- [ ] **時間道具** (⏰): 時間暫停和加成道具 *(新增)*
- [ ] **統一獎勵**: 核心成就固定 +10/+10 獎勵，雙重通關和限時成就有特殊獎勵 *(更新)*

### 關卡進度系統 *(新增基於最新規格)*
基於13階段學習架構的完整進度管理：

#### 階段化進度機制
- [ ] **學習路徑**: 第x階段 → 第x劇本 → 詞彙認識 → 詞彙熟悉 → 對話訓練
- [ ] **總體架構**: 13個學習階段，每階段20+劇本
- [ ] **順序解鎖**: 必須按照順序完成，不可跳關
- [ ] **通關標準**: 成功完成即解鎖下一關（即使0星）

#### 命條生命系統
- [ ] **命條機制**: 新用戶預設5命條，上限5條
- [ ] **命條消耗**: 
  - 詞彙認識答錯 -1命條
  - 詞彙熟悉答錯 -1命條  
  - 對話訓練失敗 -1命條
- [ ] **命條回復**: 每5小時自動回復1命條
- [ ] **命條購買**: 1命條=100鑽石，5命條=400鑽石

#### 連續學習獎勵系統
- [ ] **天數追蹤**: 記錄用戶連續學習天數
- [ ] **學習判定**: 當日完成至少1個關卡即計為學習
- [ ] **階段性獎勵**:
  - 7天連續: +100經驗值 + 特殊徽章
  - 14天連續: +200經驗值 + 2命條補充
  - 30天連續: +500經驗值 + 特殊成就徽章 + 100鑽石

### 詞彙學習成就系統 *(新增功能)*
基於詞彙學習關卡的專屬成就：

#### 詞彙掌握成就
- [ ] **詞彙新手**
  - 完成第一個詞彙認識關卡
  - 獎勵: +50經驗值 + 詞彙學習徽章

- [ ] **詞彙達人**  
  - 累計完成50個詞彙熟悉關卡
  - 獎勵: +200經驗值 + 詞彙達人徽章 + 50鑽石

- [ ] **複習專家**
  - 連續30天完成詞彙複習
  - 獎勵: +300經驗值 + 複習專家徽章 + 100鑽石

#### 關卡完成成就  
- [ ] **三星收集者**
  - 在單一劇本中獲得全部三顆星（詞彙認識+詞彙熟悉+對話訓練）
  - 獎勵: +100經驗值 + 完美劇本徽章

- [ ] **階段征服者**
  - 完成整個學習階段的所有劇本
  - 獎勵: +500經驗值 + 階段征服徽章 + 200鑽石

### 時光關卡系統 *(新增機制)*
基於時光卷的特殊關卡挑戰：

#### 時光關卡機制
- [ ] **關卡選擇**: 依序挑選前階段未玩過的對話訓練關卡
- [ ] **隨機機制**: 若前階段都已完成則隨機挑選關卡
- [ ] **消費機制**: 點擊「我要挑戰」消耗1張時光卷
- [ ] **獎勵機制**: 成功通關的詞彙加入複習清單，獲得正常獎勵

#### 時光卷獲得途徑
- [ ] **失敗安慰**: 各類關卡失敗時獲得1張時光卷
- [ ] **每日獎勵**: 連續學習獎勵中包含時光卷
- [ ] **成就獎勵**: 特定成就達成時獲得時光卷
- [ ] **購買機制**: 可使用鑽石購買時光卷（待定價格）

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

## 成就系統設計

基於實際 UI 設計，採用簡化的即時成就系統：

### 核心成就機制
- [ ] **過關獎勵**: 完成任何對話場景獲得寶箱獎勵
- [ ] **完美語法**: 語法表現優秀時獲得額外獎勵
- [ ] **表達流利**: 流暢度表現優秀時獲得額外獎勵
- [ ] **輔助功能成就** *(新增)*: 智慧使用回覆輔助功能的學習進步獎勵

## 300秒限時挑戰系統 *(新增核心功能)*

### 限時挑戰機制設計
基於最新規格的競技式學習系統：

#### 倒數計時系統
- [ ] **精準計時**: 300秒（5分鐘）的精確倒數顯示
- [ ] **視覺化時間**: 動態進度條和數字倒數的雙重顯示
- [ ] **時間警告**: 剩餘60秒和30秒時的視覺和音效提醒
- [ ] **自動結算**: 時間歸零時自動觸發結算流程

#### 限時挑戰獎勵機制
- [ ] **時間效率獎勵**:
  - 180秒內完成: 1.5x 基礎獎勵倍數
  - 120秒內完成: 2.0x 基礎獎勵倍數  
  - 60秒內完成: 2.5x 基礎獎勵倍數
- [ ] **雙重條件加成**: 限時環境下達成雙重通關額外 +50 鑽石
- [ ] **壓力挑戰獎勵**: 最後30秒內完成額外 +25 鑽石壓力獎勵
- [ ] **完美限時成就**: 限時內達成完美對話獲得特殊限時徽章

#### 限時挑戰排行榜
- [ ] **每日排行榜**: 每日限時挑戰最佳成績排名
- [ ] **每週冠軍賽**: 週末特殊限時挑戰競賽
- [ ] **好友競技**: 好友間的限時挑戰比較和挑戰
- [ ] **全球排名**: 全體用戶的限時挑戰成績排行

### 限時挑戰成就系統
基於時間壓力下的特殊成就機制：

#### 時間相關成就
- [ ] **閃電戰士**
  - 首次在180秒內完成限時挑戰
  - 獎勵: +30 鑽石 + 30 閃電能量 + 速度徽章
  
- [ ] **時間大師**
  - 累計完成10次限時挑戰且平均時間<4分鐘
  - 獎勵: +50 鑽石 + 50 閃電能量 + 時間掌控徽章
  
- [ ] **壓力之王**
  - 在最後30秒內完成5次限時挑戰
  - 獎勵: +75 鑽石 + 75 閃電能量 + 壓力專家徽章

#### 限時雙重通關成就
- [ ] **限時劇情大師**
  - 在限時挑戰中完成劇情任務且時間<4分鐘
  - 獎勵: +40 鑽石 + 40 閃電能量 + 限時劇情徽章
  
- [ ] **限時詞彙專家**
  - 在限時挑戰中正確使用所有指定詞彙且時間<3分鐘
  - 獎勵: +35 鑽石 + 35 閃電能量 + 限時詞彙徽章
  
- [ ] **限時完美對話**
  - 在限時挑戰中達成雙重通關且時間<2.5分鐘
  - 獎勵: +100 鑽石 + 100 閃電能量 + 限時完美徽章 + 3個回覆提示道具

### 獎勵統一標準  
- [ ] **統一獎勵**: 每項成就固定給予 +10 鑽石 + 10 閃電能量
- [ ] **即時反饋**: 完成對話後立即顯示獲得的成就
- [ ] **視覺化展示**: 使用寶箱和貨幣圖示清楚顯示獎勵

## 闖關系統設計

### 關卡結構

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

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

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

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

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

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

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

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

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

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

## 進度追蹤系統

### 簡化追蹤機制
基於實際 UI 設計的簡化追蹤系統：

- [ ] **闖關進度**: 完成的對話場景數量統計
- [ ] **貨幣累積**: 鑽石和閃電能量的當前持有量
- [ ] **好友排名**: 在好友圈中的閃電能量排名
- [ ] **成就記錄**: 獲得過關獎勵、完美語法、表達流利的次數統計

## 社交競爭機制

### 好友排行榜系統
基於 UI_SocialRanking_Main.png 的簡化社交功能：

- [ ] **好友邀請**: 基本的好友添加功能
- [ ] **排行榜比較**: 顯示好友間的閃電能量排名（1-7名）
- [ ] **個人位置突顯**: 使用紫色背景標示當前用戶排名
- [ ] **簡潔展示**: 每位好友顯示頭像、姓名和總閃電數

---

## 技術實現考量

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

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

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

---

## 待完成任務

### 高優先級 *(更新)*
1. [ ] 實現雙重通關條件的成就系統和獎勵機制 *(新增)*
2. [ ] 建立300秒限時挑戰的完整競技系統 *(新增)*
3. [ ] 設計限時挑戰排行榜和時間相關成就 *(新增)*
4. [ ] 建立雙重條件在限時環境下的特殊獎勵機制 *(新增)*
5. [ ] 確定積分計算的具體數值和平衡性
6. [ ] 設計成就系統的徽章視覺設計  
7. [ ] 實現回覆輔助功能的三項新成就系統 *(新增)*
8. [ ] 規劃關卡內容的具體場景劇本
9. [ ] 建立防作弊機制的技術方案
10. [ ] 設計回覆提示道具的獎勵平衡機制 *(新增)*

### 中優先級
1. [ ] 設計社交功能的互動介面
2. [ ] 建立輔助功能使用數據的分析追蹤 *(新增)*
3. [ ] 優化輔助功能成就的觸發時機和用戶體驗 *(新增)*
4. [ ] 規劃競賽活動的舉辦週期和規則
5. [ ] 建立學習數據的分析和建議算法
6. [ ] 設計個性化推薦系統

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

---

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