290 lines
12 KiB
Markdown
290 lines
12 KiB
Markdown
# 道具商店功能規格文檔
|
||
|
||
## 📋 功能概述
|
||
|
||
**功能名稱**: 道具商店系統
|
||
**建立日期**: 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 |