# 道具商店功能規格文檔

## 📋 功能概述

**功能名稱**: 道具商店系統  
**建立日期**: 2025-09-08  
**最後更新**: 2025-09-08  
**負責團隊**: 產品/設計/開發  

### 主要功能
- 鑽石貨幣系統：統一的虛擬貨幣購買和消費機制
- 多層次道具分類：學習輔助、生命管理、時間控制等道具類型
- 組合優惠策略：單買vs組合包的價格優勢設計
- 漸進式付費引導：從低門檻到高價值的轉換漏斗
- 即時生效機制：購買後立即可在遊戲中使用

### 適用場景
- 學習過程中遇到困難需要輔助工具
- 命條不足無法繼續學習時的補充需求
- 限時挑戰中需要額外時間或優勢
- 首次付費用戶的低門檻體驗入口

### 與其他功能的關聯
- **情境對話系統**: 回覆提示道具、加時道具的直接使用場景
- **命條系統**: 補命道具購買和消費的核心機制
- **學習地圖系統**: 道具購買入口和使用場景整合
- **訂閱系統**: 與VIP訂閱的差異化定位和互補
- **支付系統**: 鑽石購買和第三方支付整合

## 📱 涉及的UI畫面

### 主要畫面
1. **UI_Shop_Categories** - 道具商店分類主頁面
2. **UI_Shop_Item_Confirm** - 道具購買確認彈窗
3. **UI_Cost_Confirm_Popup** - 成本確認彈窗（使用道具時）
4. **UI_Insufficient_Resources** - 資源不足提示頁面

### 輔助畫面  
1. **UI_Subscription_Success** - 訂閱成功頁面（相關商業功能）
2. **UI_LifePoints_Display** - 生命點數顯示組件
3. **支付流程相關頁面** - 第三方支付整合介面

## 🎯 詳細畫面規格

### UI_Shop_Categories - 道具商店分類主頁面

#### 功能說明
- **畫面目的**: 展示所有可購買道具的分類和詳細資訊，引導用戶進行購買決策
- **進入條件**: 從主界面商店按鈕進入，或資源不足時系統引導進入
- **退出條件**: 完成道具購買，或用戶主動退出返回主功能

#### 畫面欄位細節

| 欄位名稱 | 資料類型 | 必填 | 預設值 | 驗證規則 | 顯示條件 |
|---------|---------|------|--------|----------|----------|
| 用戶鑽石餘額 | Number | 是 | 0 | ≥0 | 始終顯示 |
| 鑽石購買入口 | Button | 是 | - | - | 始終顯示 |
| 道具分類標籤 | Array | 是 | - | 分類陣列 | 始終顯示 |
| 當前選中分類 | String | 是 | "學習輔助" | 有效分類名 | 始終顯示 |
| 推薦道具區域 | Object | 否 | null | 推薦物件 | 有推薦時顯示 |
| 熱銷道具標記 | Boolean | 是 | false | true/false | 熱銷道具顯示 |
| 限時優惠標記 | Boolean | 否 | false | true/false | 有優惠時顯示 |
| 新用戶專享標記 | Boolean | 否 | false | true/false | 新用戶顯示 |

#### 道具分類結構

##### 🎯 學習輔助類道具
| 道具名稱 | 價格 | 組合包價格 | 功能說明 | 使用場景 |
|---------|------|------------|----------|----------|
| 回覆提示道具💡 | 30鑽石/個 | 250鑽石/10個 | 三層智慧引導：意圖分析+思維引導+回覆範例 | 對話卡關時使用 |
| 劇情任務提示 | 免費 | - | 顯示任務完成範例 | 任務未完成時免費使用 |
| 詞彙使用提示 | 免費 | - | 展示指定詞彙正確用法 | 詞彙學習中免費使用 |
| 中翻英翻譯 | 免費 | - | Google翻譯整合 | 回覆輔助中免費功能 |

##### ❤️ 生命管理類道具  
| 道具名稱 | 價格 | 組合包價格 | 功能說明 | 使用場景 |
|---------|------|------------|----------|----------|
| 補命道具 | 100鑽石/個 | 400鑽石/5個 | 補充1個命條，上限5個 | 命條不足時購買 |
| 生命保護罩 | 200鑽石/個 | 900鑽石/5個 | 一次闖關失敗不扣命條 | 重要挑戰前使用 |

##### ⏰ 時間控制類道具
| 道具名稱 | 價格 | 組合包價格 | 功能說明 | 使用場景 |
|---------|------|------------|----------|----------|
| 加時道具 | 300鑽石/個 | 1200鑽石/5個 | 對話訓練加時63秒 | 限時挑戰中使用 |
| 時間暫停卡 | 100鑽石/個 | 450鑽石/5個 | 暫停倒數計時30秒 | 緊急思考時使用 |

##### ✨ 特殊道具類
| 道具名稱 | 價格 | 獲得方式 | 功能說明 | 使用場景 |
|---------|------|----------|----------|----------|
| 時光卷 | 不可購買 | 失敗安慰獎勵 | 挑戰前階段關卡一次 | 失敗後重新挑戰 |
| 挑戰門票 | 50鑽石/張 | 每日首次免費 | 參與300秒限時挑戰 | 限時競技模式 |

#### 互動元素

| 元素名稱 | 元素類型 | 點擊行為 | 狀態變化 | 備註 |
|---------|---------|----------|----------|------|
| 道具購買按鈕 | 按鈕 | 開啟購買確認彈窗 | 正常->確認中 | 顯示道具詳細資訊 |
| 組合包購買按鈕 | 按鈕 | 開啟組合包確認彈窗 | 正常->確認中 | 顯示節省金額 |
| 道具詳情按鈕 | 按鈕 | 展開道具功能說明 | 收合->展開 | 提供使用場景說明 |
| 分類切換按鈕 | 標籤 | 切換道具分類顯示 | 未選->已選 | 高亮當前分類 |
| 鑽石購買按鈕 | 按鈕 | 跳轉到鑽石購買頁 | - | 餘額不足時重點提示 |
| 使用記錄按鈕 | 按鈕 | 查看道具使用歷史 | - | 了解使用效果 |
| 推薦道具卡片 | 卡片 | 直接進入購買流程 | - | 個人化推薦 |

### UI_Shop_Item_Confirm - 道具購買確認彈窗

#### 功能說明
- **畫面目的**: 在用戶購買道具前提供詳細確認資訊，降低誤購並提升購買信心
- **進入條件**: 從道具商店點擊購買按鈕
- **退出條件**: 確認購買完成付費，或取消購買關閉彈窗

#### 畫面欄位細節

| 欄位名稱 | 資料類型 | 必填 | 預設值 | 驗證規則 | 顯示條件 |
|---------|---------|------|--------|----------|----------|
| 道具名稱 | String | 是 | - | 5-50字 | 始終顯示 |
| 道具圖示 | Image URL | 是 | - | 有效圖片格式 | 始終顯示 |
| 道具功能描述 | String | 是 | - | 20-200字 | 始終顯示 |
| 購買數量 | Number | 是 | 1 | 1-10 | 始終顯示 |
| 單價 | Number | 是 | - | >0鑽石 | 始終顯示 |
| 總價格 | Number | 是 | - | >0鑽石 | 始終顯示 |
| 用戶當前鑽石 | Number | 是 | 0 | ≥0 | 始終顯示 |
| 購買後餘額 | Number | 是 | 0 | ≥0 | 始終顯示 |
| 組合優惠說明 | String | 否 | - | 10-100字 | 組合包時顯示 |
| 首次購買優惠 | String | 否 | - | 10-100字 | 首購用戶顯示 |
| 使用場景提示 | String | 是 | - | 20-150字 | 始終顯示 |

#### 互動元素

| 元素名稱 | 元素類型 | 點擊行為 | 狀態變化 | 備註 |
|---------|---------|----------|----------|------|
| 數量調整按鈕 | 按鈕 | 調整購買數量 | 數量變化 | 即時更新總價格 |
| 確認購買按鈕 | 按鈕 | 執行購買交易 | 正常->處理中 | 檢查餘額充足性 |
| 取消購買按鈕 | 按鈕 | 關閉確認彈窗 | 顯示->隱藏 | 返回商店頁面 |
| 餘額不足提示 | 連結 | 跳轉到鑽石購買 | - | 鑽石不足時顯示 |
| 功能示範按鈕 | 按鈕 | 播放道具使用示範 | - | 幫助理解功能 |

### UI_Insufficient_Resources - 資源不足提示頁面

#### 功能說明
- **畫面目的**: 當用戶嘗試使用道具但資源不足時，提供清楚的解決方案引導
- **進入條件**: 鑽石不足嘗試購買，或命條不足嘗試闖關
- **退出條件**: 完成資源購買，或選擇等待自然恢復

#### 畫面欄位細節

| 欄位名稱 | 資料類型 | 必填 | 預設值 | 驗證規則 | 顯示條件 |
|---------|---------|------|--------|----------|----------|
| 資源類型 | String | 是 | "鑽石" | "鑽石"/"命條" | 始終顯示 |
| 當前擁有數量 | Number | 是 | 0 | ≥0 | 始終顯示 |
| 需要數量 | Number | 是 | 0 | >0 | 始終顯示 |
| 不足數量 | Number | 是 | 0 | >0 | 始終顯示 |
| 建議購買方案 | Object | 是 | - | 方案物件 | 始終顯示 |
| 等待恢復時間 | Number | 否 | 0 | ≥0小時 | 命條不足時顯示 |
| 免費獲得方式 | Array | 否 | [] | 方式陣列 | 有免費方式時顯示 |

#### 互動元素

| 元素名稱 | 元素類型 | 點擊行為 | 狀態變化 | 備註 |
|---------|---------|----------|----------|------|
| 立即購買按鈕 | 按鈕 | 跳轉到對應購買頁面 | - | 主要行動按鈕 |
| 等待恢復按鈕 | 按鈕 | 設定恢復提醒 | - | 僅命條不足時顯示 |
| 觀看廣告按鈕 | 按鈕 | 播放獎勵廣告 | - | 免費獲得少量資源 |
| 了解詳情按鈕 | 按鈕 | 查看資源獲得方式 | - | 教育用戶多種獲得途徑 |
| 返回按鈕 | 按鈕 | 返回上一頁面 | - | 不強制購買 |

## 🔄 完整使用者流程

### 主要購買流程圖
```
[資源需求觸發] 或 [主動進入商店]
    ↓
[UI_Shop_Categories 商店主頁] → [瀏覽道具分類]
    ↓
[選擇目標道具] → [UI_Shop_Item_Confirm 購買確認]
    ↓
[確認購買] → [支付流程處理] → [道具到帳生效]
```

### 資源不足處理流程
```
[使用功能觸發資源檢查]
    ↓
[UI_Insufficient_Resources 不足提示] → [選擇解決方案]
    ↓
[立即購買] → [商店購買流程] 
    或
[等待恢復] → [設定提醒] → [自然恢復]
    或  
[觀看廣告] → [獲得少量資源] → [繼續使用]
```

### 付費轉換引導流程
```
[首次資源需求] 
    ↓
[推薦最低門檻道具(30鑽石回覆提示)]
    ↓
[成功體驗] → [推薦進階道具(100鑽石補命)]
    ↓
[使用習慣建立] → [推薦高價值道具(300鑽石加時)]
```

## 📊 商業邏輯規則

### 鑽石套餐定價策略
- **新手包**: 500鑽石 = NT$30 (首次購買專享)
- **基礎包**: 1,200鑽石 = NT$60 (日常購買)
- **價值包**: 2,500鑽石 = NT$99 (最受歡迎，最佳價值)
- **豪華包**: 5,000鑽石 = NT$190 (高頻用戶)
- **至尊包**: 12,000鑽石 = NT$390 (頂級用戶)

### 道具定價心理學
- **入門級**: 30鑽石 (回覆提示) - 降低首次付費門檻
- **成長級**: 50-100鑽石 (挑戰門票、補命) - 建立付費習慣
- **進階級**: 200-300鑽石 (保護罩、加時) - 高價值體驗
- **組合優惠**: 統一20%折扣，建立組合購買偏好

### 轉換漏斗優化
- **無縫引導**: 需求產生 → 即時推薦 → 一鍵購買
- **價值強化**: 強調道具帶來的學習效果和成就感
- **社交激勵**: 結合排行榜和好友競爭驅動消費
- **FOMO策略**: 限時優惠和熱銷標記增加緊迫感

## 🧪 測試要點

### 功能測試
- [ ] 道具購買流程完整無誤
- [ ] 鑽石餘額即時更新準確
- [ ] 組合包價格計算正確
- [ ] 道具使用生效機制正常
- [ ] 資源不足提示準確觸發
- [ ] 支付整合流程穩定
- [ ] 退款機制正常運作

### 界面測試
- [ ] 道具分類切換流暢
- [ ] 購買確認彈窗動畫效果
- [ ] 價格顯示清楚易讀
- [ ] 餘額不足時視覺提示明確
- [ ] 響應式佈局適配良好

### 商業邏輯測試
- [ ] 首購優惠正確應用
- [ ] 組合包折扣計算準確
- [ ] 付費轉換漏斗有效性
- [ ] 推薦算法個人化程度
- [ ] 防刷機制和安全性

## 📝 開發注意事項

### 前端開發
- 道具圖示需要支援動畫效果和狀態變化
- 購買確認彈窗需要防誤觸設計
- 價格顯示需要支援多幣種和匯率
- 購買按鈕需要loading狀態和防重複點擊

### 後端開發
- 道具庫存和使用需要嚴格的事務處理
- 支付回調需要冪等性和安全驗證
- 道具使用記錄需要完整的審計日誌
- 防刷和反作弊機制需要多層防護

### 整合注意事項
- 支付系統需要支援多種第三方平台
- 道具效果需要與遊戲邏輯深度整合
- 用戶行為數據需要即時收集分析
- 客服系統需要支援購買問題快速處理

## 📚 參考資源

- **UI截圖**: 
  - `docs/02_design/views/UI_Shop_Categories.png`
  - `docs/02_design/views/UI_Shop_Item_Confirm.png`
  - `docs/02_design/views/UI_Insufficient_Resources.png`
- **商業規則**: `docs/02_design/business-logic-rules.md` - 道具商店系統章節
- **API文檔**: `docs/04_technical/api/subscription.md`
- **設計規範**: `docs/02_design/ui-ux-guidelines.md`

## 📅 版本歷史

| 版本 | 日期 | 修改內容 | 修改者 |
|-----|------|----------|--------|
| v1.0 | 2025-09-08 | 初始版本建立，基於鑽石貨幣商業模式設計 | Claude AI |

---

**文檔狀態**: 🟢 已完成  
**最後檢查**: 2025-09-08  
**下次檢查**: 2025-09-15