dramaling-app/docs/02_design/content-management-specs.md

# 內容管理規格文件

## 概述
基於 05_views 實際設計，定義簡化的學習內容管理架構。

## 挑戰關卡系統

### 關卡結構設計
基於 UI_ChallengeLevel_Map.png 和相關介面，採用簡化的關卡進度系統：

#### 劇本內容架構 *(更新基於最新規格)*
```json
{
  "script_id": "S001",
  "script_name": "午餐吃什麼",
  "scene_description": {
    "english": "Two friends sit on a park bench under a shady tree...",
    "chinese": "兩位朋友坐在樹蔭下的公園長椅上..."
  },
  "plot_outline": "兩位朋友在公園長椅上討論午餐選擇...",
  "opening_dialogue": [
    {
      "character": "Alex",
      "english": "Jamie, I can't decide! What do you feel like eating?",
      "chinese": "Jamie，我不知道該選什麼！你想吃什麼？",
      "user_role": true
    },
    {
      "character": "Jamie", 
      "english": "I'm not sure either. Maybe something light, like salad?",
      "chinese": "我也不確定，也許吃點清淡的，比如沙拉？",
      "user_role": false
    }
  ],
  "plot_tasks": [
    {
      "task_description": "說服 Jamie 吃自己喜歡的食物，並舉出理由",
      "example_english": "My friend recommended this place too, said it's the best [food name] they've ever had.",
      "example_chinese": "我朋友也超推薦這家，說是他吃過最好吃的 [食物名稱]。"
    }
  ],
  "required_vocabulary": [
    {
      "word": "Decide",
      "chinese": "決定",
      "variations": ["decide", "decided", "deciding", "decision"],
      "quiz_options": ["deceive", "besides", "decided", "disease"]
    },
    {
      "word": "Light", 
      "chinese": "清淡的",
      "variations": ["light", "lighter", "lightly"],
      "quiz_options": ["right", "fight", "sight", "slight"]
    }
  ],
  "time_limit": 300,
  "completion_criteria": {
    "tasks_required": true,
    "vocabulary_required": true,
    "scoring_thresholds": {
      "semantic_score": 60,
      "grammar_errors": 0,
      "fluency_score": 60
    }
  }
}
```

#### 關卡設計原則  
- [ ] **簡潔目標**: 每關卡有明確的對話練習目標
- [ ] **鑽石消費**: 統一關卡消費機制 (300鑽石/關)
- [ ] **解鎖系統**: 循序解鎖的關卡進度
- [ ] **完成獎勵**: 統一的三項成就獎勵系統

### 場景內容分類

#### 簡化場景系統
基於實際 UI 設計的簡化分類：

- [ ] **日常對話場景**: 基本生活情境對話練習
- [ ] **挑戰關卡**: 進階的目標導向對話任務
- [ ] **語法訂正**: 專注語法改進的練習內容  
- [ ] **流暢度訓練**: 專注表達流暢度的練習內容

## 詞彙學習內容管理系統 *(新增功能模組)*

### 詞彙關卡內容架構
基於最新規格的詞彙學習關卡設計：

#### 詞彙內容數據結構
```json
{
  "script_vocabulary": {
    "script_id": "S001",
    "script_name": "買菜小冒險",
    "vocabulary_set": [
      {
        "type": "word",
        "english": "market",
        "chinese": "市場",
        "pronunciation": "/ˈmɑːrkɪt/",
        "example_sentence": "I go to the market every Saturday.",
        "example_translation": "我每個星期六都去市場。",
        "image_url": "images/market.jpg",
        "quiz_options": ["market", "garden", "school", "hospital"]
      },
      {
        "type": "phrase", 
        "english": "ask for a discount",
        "chinese": "詢問折扣",
        "example_sentence": "Can I ask for a discount on this?",
        "example_translation": "我可以要求這個打折嗎？",
        "context_usage": "用於購物砍價的情境"
      },
      {
        "type": "slang",
        "english": "a steal",
        "chinese": "超便宜的好東西",
        "example_sentence": "This shirt is a steal at $10!",
        "example_translation": "這件襯衫10美元真是超值！",
        "cultural_note": "美式英語中表示價格很划算"
      }
    ]
  }
}
```

#### 詞彙認識關卡管理
- [ ] **詞彙展示內容**:
  - 詞彙本身、中文意思、音標
  - 例句和中文翻譯
  - 相關示意圖或插圖
  - 詞彙類型標識（單字/片語/俚語）
- [ ] **選擇題設計**:
  - 4選1的單選題形式
  - 根據示意圖選出正確英文詞彙
  - 選項設計避免過於明顯的錯誤答案
  - 錯誤答案在最後重新測試

#### 詞彙熟悉關卡管理
- [ ] **例句重組內容**:
  - 提供示意圖作為提示
  - 將完整例句拆分為單字選取區
  - 用戶需重新組合出正確句子
  - 支援拖拽或點擊操作
- [ ] **詞彙配對內容**:
  - 左側顯示示意圖
  - 右側顯示多個詞彙選項
  - 支援一對一配對操作
  - 全部配對正確才算完成

### 間隔複習內容管理系統
基於遺忘曲線的智慧複習機制：

#### 複習數據結構
```json
{
  "vocabulary_review": {
    "user_id": "U001",
    "vocabulary_id": "V001", 
    "first_learned_date": "2024-03-04",
    "review_count": 2,
    "next_review_date": "2024-03-10",
    "last_review_result": "correct",
    "retention_strength": 0.85,
    "review_history": [
      {
        "review_date": "2024-03-04",
        "result": "correct", 
        "response_time": 3.2
      },
      {
        "review_date": "2024-03-06",
        "result": "correct",
        "response_time": 2.8
      }
    ]
  }
}
```

#### 複習排程算法
- [ ] **間隔計算公式**: 下次複習時間 = 當前日期 + (2^複習次數)天
- [ ] **複習觸發條件**: 
  - 詞彙認識、詞彙熟悉、對話訓練通關後自動加入
  - 避免重複加入相同詞彙
  - 當日即為第一次複習時間
- [ ] **延遲複習處理**:
  - 過期未複習的詞彙持續標記為待複習
  - 延遲複習時以實際複習日期重新計算間隔
  - 例如：應3/10複習但3/11才複習，下次時間為3/11+2³=3/19

#### 複習進度管理
- [ ] **中途離開保存**:
  - 記錄當前複習位置和已完成題數
  - 保存答題結果和錯誤記錄
  - 給予已完成部分的經驗值
- [ ] **複習完成機制**:
  - 所有待複習詞彙都答對才算完成
  - 答錯題目複製到最後重新測試
  - 完成後給予完整經驗值獎勵
  - 更新複習次數和下次複習時間

## 情境對話內容管理系統 *(新增功能)*

### 劇情任務管理系統
基於最新規格的結構化任務內容管理：

#### 任務定義架構
- [ ] **任務層級管理**:
  - 主要任務目標 (如：預約餐廳、購買商品)
  - 子任務要素 (如：時間確認、數量說明、付款方式)
  - 隱藏任務線索 (如：禮貌用語、文化適應性)
- [ ] **任務完成檢測**:
  - 關鍵對話元素的識別規則
  - 任務邏輯性和完整性的驗證機制
  - 情節一致性的品質控制標準
- [ ] **任務進度追蹤**:
  - 即時完成狀態的更新機制
  - 部分完成vs完整達成的差異化記錄
  - 任務完成品質的評分系統

#### 任務內容品質標準
- [ ] **情境真實性**: 確保任務反映真實生活場景
- [ ] **難度適配性**: 根據用戶語言水平調整任務複雜度
- [ ] **文化適應性**: 考量目標語言的文化背景和表達習慣
- [ ] **學習目標性**: 每項任務都對應明確的語言學習目標

### 指定詞彙庫管理系統
基於最新規格的智慧詞彙檢測和管理：

#### 詞彙庫架構設計
```json
{
  "vocab_entry": {
    "primary_word": "reservation",
    "word_forms": {
      "noun": ["reservation", "reservations"],
      "verb": ["reserve", "reserved", "reserving"],
      "adjective": ["reserved"]
    },
    "synonyms": ["booking", "appointment", "arrangement"],
    "context_patterns": [
      "make a reservation",
      "book a table", 
      "reserve a spot"
    ],
    "difficulty_level": "A2",
    "usage_frequency": "high",
    "cultural_notes": "常用於餐廳和飯店場景"
  }
}
```

#### 詞彙檢測機制
- [ ] **形式變化識別**: 支援詞彙的各種語法形式變化
- [ ] **同義詞檢測**: 識別語意相近的替代詞彙
- [ ] **語境相關性**: 確保詞彙使用符合對話情境
- [ ] **自然度評估**: 評估詞彙使用的自然性和適切性

#### 詞彙學習進度管理
- [ ] **掌握度追蹤**: 記錄用戶對各詞彙的掌握程度
- [ ] **使用品質分析**: 分析詞彙使用的準確性和自然度
- [ ] **重複學習機制**: 基於遺忘曲線的詞彙複習排程
- [ ] **情境應用記錄**: 追蹤詞彙在不同情境下的使用經驗

### 300秒限時挑戰內容管理 *(新增功能)*
基於最新規格的限時挑戰內容設計：

#### 限時挑戰內容架構
- [ ] **快節奏對話設計**: 適合時間壓力下的對話節奏和內容複雜度
- [ ] **即時反饋機制**: 時間緊迫情況下的簡潔有效反饋系統
- [ ] **壓力測試內容**: 測試用戶在時間壓力下的語言表現能力
- [ ] **效率優化提示**: 針對限時環境的對話策略和技巧指導

#### 限時內容管理標準
- [ ] **時間分配設計**: 確保300秒內可以完成有意義的對話練習
- [ ] **難度平衡控制**: 避免時間壓力下的過度困難或過度簡單
- [ ] **成就感設計**: 在限制時間內創造明確的成就感和進步感
- [ ] **競技性內容**: 適合排行榜競爭的對話挑戰設計

## 回覆卡關輔助內容管理

### 引導內容結構設計
基於手寫規格的三層輔助架構：

#### 意圖分析內容庫
- [ ] **情境意圖模板**: 預建不同情境下的常見對話意圖
- [ ] **情感識別標籤**: 友好、正式、急迫、詢問等情感色彩分類
- [ ] **文化背景考量**: 針對中文使用者的文化理解差異調整
- [ ] **更新機制**: 基於用戶互動數據優化意圖識別準確度

#### 回應思維引導庫
- [ ] **思考路徑模板**: 不同情境下的標準思考流程
- [ ] **多元回應策略**: 積極、中性、詢問、說明等多種回應風格
- [ ] **難度分級**: A1-C2不同等級的思維複雜度調整
- [ ] **情境適配**: 根據對話場景提供相應的思維引導

#### 回覆範例內容庫
- [ ] **分級範例庫**: 按語言水平提供適當複雜度的回覆範例
- [ ] **風格多樣性**: 正式、非正式、友善、專業等不同風格選項
- [ ] **情境相關性**: 確保範例符合具體對話情境和角色設定
- [ ] **學習漸進性**: 從模仿到自主表達的學習路徑設計

### 中翻英輔助功能管理
基於Google翻譯整合的智慧翻譯系統：

#### 翻譯品質優化
- [ ] **情境調整**: 根據對話場景調整翻譯的正式度和用詞選擇
- [ ] **語言等級適配**: 將翻譯結果調整至使用者的目標語言水平
- [ ] **文化適應**: 考量中英文化差異，提供更自然的表達方式
- [ ] **學習引導**: 在翻譯結果中標註重要語法點和詞彙選擇

#### 翻譯內容管理
- [ ] **常用片語庫**: 預建中英對照的常用對話片語
- [ ] **情境詞彙庫**: 不同場景下的專業詞彙中英對照
- [ ] **語法模式庫**: 常見中文思維模式的英文表達建議
- [ ] **錯誤修正庫**: 針對中文使用者常見的英文表達錯誤進行預防性修正

## 對話內容管理

### 簡化內容標準
基於實際應用需求的精簡內容管理：

#### 基本內容要求
- [ ] **對話目標**: 每個場景有明確的溝通目標
- [ ] **評分整合**: 內容配合三維度評分系統 (語法/語意/流暢度)
- [ ] **獎勵觸發**: 內容設計配合成就系統觸發機制
- [ ] **成本設定**: 統一的鑽石消費標準

#### 品質控制機制
- [ ] **基本準確性**: 確保對話內容語言正確性
- [ ] **適用性驗證**: 驗證內容符合學習目標
- [ ] **測試驗證**: 確保評分系統正常運作

## 技術實現要點

### 內容管理需求
基於實際應用的簡化管理需求：

#### 核心功能 *(更新)*
- [ ] **關卡內容**: 對話場景的基本內容管理
- [ ] **劇情任務管理**: 結構化任務目標和完成檢測的內容架構 *(新增)*
- [ ] **指定詞彙庫**: 智慧詞彙檢測和形式變化識別的內容管理 *(新增)*
- [ ] **限時挑戰內容**: 300秒限時對話的專門內容設計和管理 *(新增)*
- [ ] **評分配置**: 配合 AI 評分系統的內容標註
- [ ] **回覆輔助內容**: 意圖分析、思維引導、範例回覆的內容庫管理
- [ ] **翻譯內容庫**: 中翻英輔助的詞彙和片語管理
- [ ] **雙重獎勵設定**: 配合劇情任務和詞彙使用的複合獎勵機制 *(新增)*
- [ ] **消費設定**: 關卡鑽石消費、輔助道具和限時挑戰門票的統一管理

#### 基本品質控制
- [ ] **內容準確性**: 確保對話內容的語言正確性
- [ ] **系統整合**: 確保與評分和獎勵系統的正確整合
- [ ] **用戶測試**: 基本的用戶體驗驗證

---

## 待完成任務

### 高優先級 *(更新)*
1. [ ] 建立劇情任務管理系統的結構化內容架構 *(新增)*
2. [ ] 建立指定詞彙庫的智慧檢測和形式變化管理 *(新增)*
3. [ ] 設計300秒限時挑戰的專門內容管理系統 *(新增)*
4. [ ] 建立雙重通關條件的複合獎勵內容配置 *(新增)*
5. [ ] 建立基本的對話場景內容
6. [ ] 建立回覆輔助的三層內容庫(意圖分析、思維引導、範例回覆)
7. [ ] 配置關卡鑽石消費系統和回覆提示道具管理
8. [ ] 整合Google翻譯API和中翻英輔助內容庫
9. [ ] 整合 AI 評分與成就獎勵機制
10. [ ] 設定關卡解鎖條件

### 中優先級
1. [ ] 建立回覆輔助內容的品質測試流程
2. [ ] 優化翻譯結果的情境適應性
3. [ ] 建立內容品質測試流程
4. [ ] 驗證系統整合的正確性

### 新增功能優先級
1. [ ] 設計輔助內容的動態更新機制
2. [ ] 建立用戶使用輔助功能的學習效果追蹤
3. [ ] 優化多語言文化差異的內容適配
4. [ ] 建立輔助功能使用數據的分析機制

---

**最後更新**: 2024年9月5日  
**負責人**: 待分配  
**審查週期**: 每兩週檢討一次