dramaling-app/docs/02_design/function-specs/mobile/item-shop-mobile.md

12 KiB
Raw Blame History

道具商店功能規格文檔

📋 功能概述

功能名稱: 道具商店系統
建立日期: 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個命條依用戶等級上限 命條不足時購買
生命保護罩 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