dramaling-app/docs/02_design/function-specs/common/business-rules.md

5.9 KiB
Raw Blame History

共同業務規則

📋 概述

文檔名稱: 跨平台共同業務規則
建立日期: 2025-09-09
適用平台: Mobile App / Web App
負責團隊: 產品/設計/開發

本文檔定義了Drama Ling語言學習系統中跨平台通用的業務規則和邏輯。

🎮 命條系統 (Life Points System)

基本規則

  • 初始命條: 新用戶獲得5個命條
  • 最大命條: 普通用戶5個訂閱用戶10個
  • 恢復機制: 每30分鐘自動恢復1個命條
  • 命條消耗: 答錯題目扣除1個命條

消耗場景

場景 命條消耗 說明
答錯選擇題 1個 詞彙學習、對話練習
跳過題目 1個 視為答錯處理
對話失敗 2個 情境對話完全失敗
挑戰失敗 3個 特殊挑戰任務失敗

獲得命條方式

  • 自動恢復: 每30分鐘恢復1個
  • 廣告觀看: 觀看廣告恢復1個命條 (每日3次)
  • 道具購買: 使用鑽石購買命條補充包
  • 訂閱獎勵: 訂閱用戶命條上限提升至10個

💎 經濟系統 (Economy System)

貨幣類型

  1. 鑽石 (Diamonds): 高級貨幣,可購買道具和服務
  2. 經驗值 (XP): 學習進度貨幣,用於解鎖內容
  3. 學習幣 (Learning Coins): 日常活動貨幣,購買基礎道具

經驗值獲得規則

活動類型 經驗值獲得 條件
完成詞彙學習 50-100 XP 根據準確率調整
完成對話練習 100-200 XP 根據對話質量調整
連續學習 額外20% XP 連續學習天數獎勵
完美通關 雙倍 XP 全部答對且用時短
每日任務 50 XP 完成每日學習目標

鑽石獲得與消費

獲得方式:

  • 每日登入獎勵: 2鑽石
  • 完成成就: 10-50鑽石
  • 觀看廣告: 1鑽石 (每日5次)
  • 內購: 實際貨幣購買

消費項目:

  • 命條補充包 (5個): 20鑽石
  • 時光卷道具: 10鑽石
  • 提示道具: 5鑽石
  • 解鎖高級內容: 100-500鑽石

📈 學習進度系統

掌握度分級

  • 初識 (Beginner): 0-25% 掌握度
  • 熟悉 (Familiar): 26-60% 掌握度
  • 應用 (Applied): 61-85% 掌握度
  • 掌握 (Mastered): 86-100% 掌握度

難度自適應算法

新難度 = 基礎難度 + 表現調整係數
表現調整係數 = (正確率 - 0.7) × 0.5 + (平均反應時間調整)

若正確率 > 85%: 提升一個難度級別
若正確率 < 40%: 降低一個難度級別  
若連續3次滿分: 跳過下一個同類題目

間隔複習機制

基於艾賓浩斯遺忘曲線:

  • 第1次複習: 學習後1小時
  • 第2次複習: 學習後1天
  • 第3次複習: 學習後3天
  • 第4次複習: 學習後7天
  • 第5次複習: 學習後15天
  • 後續複習: 每30天一次

🏆 成就與獎勵系統

成就類型

  1. 學習里程碑: 累計學習天數、掌握詞彙數量
  2. 技能成就: 對話流暢度、發音準確度
  3. 挑戰成就: 連續答對、完美通關次數
  4. 社交成就: 分享學習成果、邀請好友

獎勵機制

成就等級 鑽石獎勵 經驗值獎勵 特殊獎勵
青銅 10鑽石 100 XP 稱號
白銀 25鑽石 250 XP 頭像框
黃金 50鑽石 500 XP 特殊主題
鉑金 100鑽石 1000 XP 高級功能

🔐 權限控制系統

用戶角色

enum UserRole {
  FREE_USER = "free_user",      // 免費用戶
  SUBSCRIBER = "subscriber",    // 訂閱用戶
  ADMIN = "admin"              // 管理員
}

功能權限矩陣

功能 免費用戶 訂閱用戶 管理員
基礎對話練習 3次/日 無限制 無限制
高級對話功能
詞彙學習 基礎詞庫 完整詞庫 完整詞庫
AI分析報告 簡化版 詳細版 完整版
離線模式
數據匯出
管理功能

防作弊機制

答題時間檢查

  • 最短答題時間: 1秒 (防止機器人)
  • 合理答題時間: 3-60秒 (根據題目類型)
  • 超時處理: 超過60秒視為跳過

連續操作限制

  • 連續答對上限: 同一題目類型連續答對50次觸發人機驗證
  • 學習頻率限制: 每小時最多完成20個學習單元
  • 異常行為偵測: IP異常、設備異常自動標記

學習數據驗證

  • 學習時間合理性: 每日學習時間不可超過12小時
  • 進度跳躍檢查: 難度提升過快觸發審核
  • 成績異常檢測: 突然大幅提升觸發人工檢查

🌐 多語言支援

支援語言

  • 界面語言: 中文(繁體/簡體)、英文、日文、韓文
  • 學習語言: 英文、日文、韓文、西班牙文、法文
  • 音頻語言: 支援所有學習語言的標準發音

本地化規則

  • 日期格式: 根據用戶地區自動調整
  • 數字格式: 支援不同地區的數字分隔符
  • 貨幣顯示: 根據用戶所在地區顯示本地貨幣
  • 時區處理: 自動根據用戶時區調整時間顯示

📊 數據分析規則

學習分析維度

  1. 學習效率: 單位時間掌握詞彙數/對話完成數
  2. 知識保持率: 間隔複習中的正確率變化
  3. 學習偏好: 用戶偏愛的學習模式和時間
  4. 難點識別: 用戶容易犯錯的知識點

隱私保護

  • 數據匿名化: 個人識別信息在分析前移除
  • 本地計算: 敏感數據優先在本地處理
  • 用戶同意: 數據使用需要用戶明確同意
  • 數據保留: 學習數據保留期限不超過2年

文檔狀態: 🟢 已完成
最後更新: 2025-09-09
版本: v1.0
相關文檔:

  • 數據模型.md - 數據結構定義
  • API規格.md - API接口設計
  • mobile/ - 移動端功能規格
  • web/ - Web端功能規格