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

181 lines
5.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 共同業務規則
## 📋 概述
**文檔名稱**: 跨平台共同業務規則
**建立日期**: 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 | 高級功能 |
## 🔐 權限控制系統
### 用戶角色
```typescript
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端功能規格