15 KiB

Raw Blame History

遊戲化機制設計規格

📋 文檔狀態更新 (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 的實際設計，採用簡化的好友排行榜系統：

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

成就獎勵系統

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

核心成就系統 ✅ (已實現)

過關獎勵 (通關寶箱) ✅ (已實現於 api/daily-missions.md)
- 完成對話場景即可獲得
- 獎勵: 請參考/Users/jettcheng1018/code/dramaling-app/docs/02_design/function-specs/common/business-rules.md
完美語法 ✅ (已實現於成就系統)
- 語法評分達到優秀標準
- 獎勵: 請參考/Users/jettcheng1018/code/dramaling-app/docs/02_design/function-specs/common/business-rules.md
表達流利 ✅ (已實現於成就系統)
- 流暢度評分達到優秀標準
- 獎勵: +10 鑽石 + 10 閃電能量

雙重通關條件成就 ✅ (已實現於系統邏輯)

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

輔助功能成就 (新增功能)

智慧學習者
- 首次使用回覆輔助功能並成功完成對話
- 觸發條件: 使用回覆提示道具完成對話
- 獎勵: +5 鑽石 + 2個回覆提示道具
獨立進步
- 在同一場景中，先使用輔助後能獨立完成類似對話
- 觸發條件: 同場景使用輔助後，下次對話無需輔助且分數≥85
- 獎勵: +15 鑽石 + 15 閃電能量
翻譯達人
- 累計使用中翻英功能50次
- 觸發條件: 中翻英功能使用次數達標
- 獎勵: +20 鑽石 + 5個回覆提示道具

獎勵貨幣系統 ✅ (已實現)

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

關卡進度系統 (新增基於最新規格)

基於13階段學習架構的完整進度管理：

階段化進度機制 ✅ (已實現)

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

命條生命系統 ✅ (已實現於 `api/gamification.md`)

詳細規格請參閱 → 共同業務規則 - 命條系統

命條機制: 依用戶等級不同命條上限和恢復速度 ✅ (已實現於 Life Points API)
命條消耗: 關卡啟動時消耗(1、2、3關) ✅ (已實現於遊戲邏輯)
命條回復: 依用戶等級自動回復 ✅ (已實現於自動回復系統)
命條購買: 1命條=100鑽石，5命條=400鑽石 ✅ (已實現於購買系統)

連續學習獎勵系統 ✅ (已實現於用戶進度系統)

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

詞彙學習成就系統 (新增功能)

基於詞彙學習關卡的專屬成就：

詞彙掌握成就

詞彙新手
- 完成第一個詞彙認識關卡
- 獎勵: +50經驗值 + 詞彙學習徽章
詞彙達人
- 累計完成50個詞彙熟悉關卡
- 獎勵: +200經驗值 + 詞彙達人徽章 + 50鑽石
複習專家
- 連續30天完成詞彙複習
- 獎勵: +300經驗值 + 複習專家徽章 + 100鑽石

關卡完成成就

三星收集者
- 在單一劇本中獲得全部三顆星（詞彙認識+詞彙熟悉+對話訓練）
- 獎勵: +100經驗值 + 完美劇本徽章
階段征服者
- 完成整個學習階段的所有劇本
- 獎勵: +500經驗值 + 階段征服徽章 + 200鑽石

時光關卡系統 ✅ (已實現於 `api/gamification.md` TimeWarp API)

基於時光卷的特殊關卡挑戰：

時光關卡機制 ✅ (已完整實現)

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

時光卷獲得途徑 ✅ (已完整實現)

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

排行榜更新機制 ✅ (已實現於 `api/gamification.md`)

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

成就系統設計

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

核心成就機制

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

闖關系統設計

關卡結構

主線關卡 (情境導向)

第一章: 日常生活 (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規格文檔中實現：

核心系統 - 已完成

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

技術實現 - 大部分完成

資料存儲架構 → 實現於 database-schema.md
效能優化基礎設計 → 實現於API規格中

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

高優先級遺漏

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

中優先級遺漏

個性化推薦算法 - 基於學習數據的個性化內容推薦系統
競賽活動規則 - 定期競賽活動的舉辦機制和規則設計

低優先級補充

心理學原理應用研究 - 遊戲化機制的心理學基礎研究
外部平台整合 - 與其他學習平台的積分兌換機制

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

15 KiB Raw Blame History Unescape Escape