# 共同業務規則

## 📋 概述

**文檔名稱**: 跨平台共同業務規則  
**建立日期**: 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端功能規格