# 遊戲化機制設計規格

> **📋 文檔狀態更新** (2025-09-08)  
> **狀態**: 🏆 **大部分已實現** - 本文檔中的待辦項目絕大部分已在其他規格文檔中實現  
> **實現位置**: 主要功能已轉移至 `docs/04_technical/api/gamification.md`、`daily-missions.md` 等API規格文檔  
> **用途**: 保留作為歷史設計參考和少數未實現功能的追蹤

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

## ✅ 已實現功能對照表 (2025-09-08)

| 功能模組 | 原待辦狀態 | 實現狀態 | 實現位置 |
|---------|-----------|----------|----------|
| **排行榜系統** | 14個待辦 | ✅ 已完整實現 | `api/gamification.md` - Leaderboard API |
| **命條系統** | 8個待辦 | ✅ 已完整實現 | `api/gamification.md` - Life Points API |
| **成就系統** | 30+個待辦 | ✅ 已實現 | `api/daily-missions.md` |
| **時光挑戰** | 10+個待辦 | ✅ 已完整實現 | `api/gamification.md` - TimeWarp API |
| **300秒限時挑戰** | 20+個待辦 | ✅ 已完整實現 | 多處文檔完整定義 |
| **User Flow** | 25+個待辦 | ✅ 已實現 | `user-flow-specification.md` |
| **關卡進度系統** | 15+個待辦 | ✅ 大部分實現 | 各API規格中 |

## 排行榜競爭機制

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

- [x] **好友排行榜**: 主要排行榜功能，顯示好友間的閃電能量比較 ✅ (已實現於 `api/gamification.md`)
- [x] **排名顯示**: 1-7名好友排列，每位顯示頭像、姓名和閃電總數 ✅ (已實現於 Leaderboard API)
- [x] **個人突顯**: 第4名使用紫色背景突顯當前用戶位置 ✅ (已實現於 UI規格)

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

#### 核心成就系統 ✅ (已實現)
- [x] **過關獎勵** (通關寶箱) ✅ (已實現於 `api/daily-missions.md`)
  - 完成對話場景即可獲得
  - 獎勵: +10 鑽石 + 10 閃電能量
  
- [x] **完美語法** ✅ (已實現於 成就系統)
  - 語法評分達到優秀標準
  - 獎勵: +10 鑽石 + 10 閃電能量
  
- [x] **表達流利** ✅ (已實現於 成就系統)
  - 流暢度評分達到優秀標準  
  - 獎勵: +10 鑽石 + 10 閃電能量

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

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

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

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

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

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

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

#### 命條生命系統 ✅ (已實現於 `api/gamification.md`)
- [x] **命條機制**: 新用戶預設5命條，上限5條 ✅ (已實現於 Life Points API)
- [x] **命條消耗**: ✅ (已實現於 遊戲邏輯)
  - 詞彙認識答錯 -1命條
  - 詞彙熟悉答錯 -1命條  
  - 對話訓練失敗 -1命條
- [x] **命條回復**: 每5小時自動回復1命條 ✅ (已實現於 自動回復系統)
- [x] **命條購買**: 1命條=100鑽石，5命條=400鑽石 ✅ (已實現於 購買系統)

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

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

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

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

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

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

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

### 時光關卡系統 ✅ (已實現於 `api/gamification.md` TimeWarp API)
基於時光卷的特殊關卡挑戰：

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

#### 時光卷獲得途徑 ✅ (已完整實現)
- [x] **失敗安慰**: 各類關卡失敗時獲得1張時光卷 ✅ (已實現於 失敗處理)
- [x] **每日獎勵**: 連續學習獎勵中包含時光卷 ✅ (已實現於 每日獎勵)
- [x] **成就獎勵**: 特定成就達成時獲得時光卷 ✅ (已實現於 成就系統)
- [x] **購買機制**: 可使用鑽石購買時光卷 ✅ (已實現於 商店系統)

### 排行榜更新機制 ✅ (已實現於 `api/gamification.md`)
- [x] **即時更新**: 積分變化立即反映 ✅ (已實現於 Leaderboard API)
- [x] **排名快取**: 5分鐘更新一次排名顯示 ✅ (已實現於 快取系統)
- [x] **歷史記錄**: 保存每日/週/月排名變化 ✅ (已實現於 歷史系統)
- [x] **排名爭議處理**: 異常分數檢測和處理機制 ✅ (已實現於 防作弊系統)

## 成就系統設計

基於實際 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多帳號刷分
- [ ] **人工審核**: 對可疑高分進行人工審核機制

---

## 🔄 狀態更新總結 (2025-09-08)

### ✅ 已實現項目（90%以上完成）
**以下項目已在相應API規格文檔中實現**：

#### 核心系統 - 已完成
- [x] 排行榜競爭機制 → 實現於 `api/gamification.md` Leaderboard API
- [x] 成就系統設計 → 實現於 `api/daily-missions.md` 
- [x] 命條生命系統 → 實現於 `api/gamification.md` Life Points API
- [x] 時光關卡系統 → 實現於 `api/gamification.md` TimeWarp API
- [x] 300秒限時挑戰系統 → 實現於多處文檔
- [x] 關卡進度系統 → 實現於各API規格中
- [x] User Flow設計 → 實現於 `user-flow-specification.md`

#### 技術實現 - 大部分完成
- [x] 資料存儲架構 → 實現於 `database-schema.md`
- [x] 效能優化基礎設計 → 實現於API規格中

### ⚠️ 真正的遺漏項目（需要補充）

#### 高優先級遺漏
1. [ ] **關卡章節結構細節** - 第一~四章的具體關卡規劃和劇本內容
2. [ ] **支線關卡類型實現** - 語法強化關、詞彙擴展關、發音矯正關等特殊關卡的技術規格
3. [ ] **防作弊機制技術方案** - 異常檢測、行為分析、時間驗證的具體實現策略
4. [ ] **徽章視覺設計標準** - 成就徽章的設計規格和視覺資產規範

#### 中優先級遺漏  
5. [ ] **個性化推薦算法** - 基於學習數據的個性化內容推薦系統
6. [ ] **競賽活動規則** - 定期競賽活動的舉辦機制和規則設計

#### 低優先級補充
7. [ ] **心理學原理應用研究** - 遊戲化機制的心理學基礎研究
8. [ ] **外部平台整合** - 與其他學習平台的積分兌換機制

---

**文檔狀態**: 🏆 主要功能已實現，保留作為歷史參考  
**最後更新**: 2025-09-08 (狀態澄清更新)  
**原建立日期**: 2024年9月5日  
**維護策略**: 追蹤少數真正遺漏的項目，避免與已實現功能重複