Compare commits
10 Commits
c120d5125d
...
4c8d5606a8
| Author | SHA1 | Date |
|---|---|---|
 鄭沛軒
|
4c8d5606a8 | |
|
鄭沛軒
|
f5bd20406c | |
|
鄭沛軒
|
eae75615c0 | |
|
鄭沛軒
|
937f6994eb | |
|
鄭沛軒
|
945c7f8530 | |
|
鄭沛軒
|
74bafd3739 | |
|
鄭沛軒
|
cc94096dfe | |
|
鄭沛軒
|
f2439273e5 | |
|
鄭沛軒
|
58162183e8 | |
|
鄭沛軒
|
9e92afb24b |
|
|
@ -0,0 +1,23 @@
|
|||
{
|
||||
"permissions": {
|
||||
"allow": [
|
||||
"Bash(python3:*)",
|
||||
"Read(//Users/jettcheng1018/Downloads/**)",
|
||||
"Read(//tmp/**)",
|
||||
"Bash(comm:*)",
|
||||
"Bash(git commit:*)",
|
||||
"Bash(./check_consistency.sh:*)",
|
||||
"Bash(chmod:*)",
|
||||
"Bash(./scripts/maintenance/create_issue.sh:*)",
|
||||
"Bash(./scripts/maintenance/check_issues.sh:*)",
|
||||
"Bash(./check_issues.sh)",
|
||||
"Bash(cat:*)",
|
||||
"Bash(./drama issue)",
|
||||
"Bash(./drama report \"UI設計缺漏嚴重性評估\")",
|
||||
"Bash(./drama compliance)",
|
||||
"Bash(./drama report analysis \"文檔分類組織結構優化\")"
|
||||
],
|
||||
"deny": [],
|
||||
"ask": []
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
---
|
||||
name: 🐛 Bug Report
|
||||
about: Create a report to help us improve
|
||||
title: '[BUG] '
|
||||
labels: ['bug', 'needs-triage']
|
||||
assignees: ''
|
||||
---
|
||||
|
||||
## 🐛 Bug Description
|
||||
<!-- A clear and concise description of what the bug is -->
|
||||
|
||||
## 🔄 Steps to Reproduce
|
||||
1. Go to '...'
|
||||
2. Click on '....'
|
||||
3. Scroll down to '....'
|
||||
4. See error
|
||||
|
||||
## ✅ Expected Behavior
|
||||
<!-- A clear and concise description of what you expected to happen -->
|
||||
|
||||
## ❌ Actual Behavior
|
||||
<!-- A clear and concise description of what actually happened -->
|
||||
|
||||
## 📱 Environment
|
||||
### Mobile App (Flutter)
|
||||
- **Platform**: iOS / Android
|
||||
- **Device**: [e.g. iPhone 12, Samsung Galaxy S21]
|
||||
- **OS Version**: [e.g. iOS 15.0, Android 12]
|
||||
- **App Version**: [e.g. 1.2.0]
|
||||
|
||||
### Backend (.NET Core)
|
||||
- **Environment**: Development / Staging / Production
|
||||
- **Server OS**: [if known]
|
||||
- **Database**: [PostgreSQL version]
|
||||
|
||||
## 📸 Screenshots
|
||||
<!-- If applicable, add screenshots to help explain your problem -->
|
||||
|
||||
## 📋 Additional Context
|
||||
<!-- Add any other context about the problem here -->
|
||||
|
||||
## 🔍 Error Logs
|
||||
<!-- If available, add any relevant error logs or stack traces -->
|
||||
|
||||
```
|
||||
Paste error logs here
|
||||
```
|
||||
|
||||
## 🎯 Priority
|
||||
<!-- Mark the priority level -->
|
||||
- [ ] 🔴 Critical (System down, data loss)
|
||||
- [ ] 🟠 High (Major feature broken)
|
||||
- [ ] 🟡 Medium (Minor feature issue)
|
||||
- [ ] 🟢 Low (Cosmetic issue)
|
||||
|
||||
## 🏷️ Labels
|
||||
<!-- The following labels will be automatically applied -->
|
||||
<!-- bug, needs-triage -->
|
||||
|
|
@ -0,0 +1,66 @@
|
|||
---
|
||||
name: ✨ Feature Request
|
||||
about: Suggest an idea for this project
|
||||
title: '[FEATURE] '
|
||||
labels: ['enhancement', 'needs-triage']
|
||||
assignees: ''
|
||||
---
|
||||
|
||||
## 💡 Feature Description
|
||||
<!-- A clear and concise description of the feature you want to see -->
|
||||
|
||||
## 🎯 Problem Statement
|
||||
<!-- What problem does this feature solve? -->
|
||||
**Is your feature request related to a problem?**
|
||||
A clear description of what the problem is. Ex. I'm always frustrated when [...]
|
||||
|
||||
## 🛠 Proposed Solution
|
||||
<!-- Describe the solution you'd like to see -->
|
||||
|
||||
## 🔄 User Stories
|
||||
<!-- Describe how users would interact with this feature -->
|
||||
- As a [user type], I want [goal] so that [benefit]
|
||||
- As a [user type], I want [goal] so that [benefit]
|
||||
|
||||
## 📱 Platform
|
||||
<!-- Which parts of the system would be affected? -->
|
||||
- [ ] 📱 Mobile App (Flutter)
|
||||
- [ ] 🔧 Backend API (.NET Core)
|
||||
- [ ] 🗄️ Database Schema
|
||||
- [ ] 🎮 Gamification System
|
||||
- [ ] 🤖 AI Analysis Engine
|
||||
- [ ] 📊 Analytics/Reporting
|
||||
- [ ] 🔐 Authentication/Security
|
||||
|
||||
## 🎨 UI/UX Considerations
|
||||
<!-- If this affects the UI, describe the expected user experience -->
|
||||
|
||||
## 🔧 Technical Considerations
|
||||
<!-- Any technical implementation details or constraints -->
|
||||
|
||||
## 📈 Success Metrics
|
||||
<!-- How would we measure the success of this feature? -->
|
||||
|
||||
## 🚧 Alternative Solutions
|
||||
<!-- Describe alternatives you've considered -->
|
||||
|
||||
## 📋 Additional Context
|
||||
<!-- Add any other context, mockups, or examples -->
|
||||
|
||||
## 🎯 Priority
|
||||
<!-- Mark the priority level -->
|
||||
- [ ] 🔴 Critical (Essential for launch)
|
||||
- [ ] 🟠 High (Important for user experience)
|
||||
- [ ] 🟡 Medium (Nice to have)
|
||||
- [ ] 🟢 Low (Future consideration)
|
||||
|
||||
## 📅 Timeline
|
||||
<!-- When would you like to see this feature? -->
|
||||
- [ ] Next release
|
||||
- [ ] Within 3 months
|
||||
- [ ] Within 6 months
|
||||
- [ ] Future roadmap
|
||||
|
||||
## 🏷️ Labels
|
||||
<!-- The following labels will be automatically applied -->
|
||||
<!-- enhancement, needs-triage -->
|
||||
|
|
@ -0,0 +1,88 @@
|
|||
# Pull Request
|
||||
|
||||
## 📋 Summary
|
||||
<!-- Provide a brief description of the changes in this PR -->
|
||||
|
||||
## 🎯 Type of Change
|
||||
<!-- Mark the relevant option with an 'x' -->
|
||||
- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
|
||||
- [ ] ✨ New feature (non-breaking change which adds functionality)
|
||||
- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
|
||||
- [ ] 📚 Documentation update
|
||||
- [ ] 🏗️ Infrastructure/build changes
|
||||
- [ ] 🧹 Code cleanup/refactoring
|
||||
- [ ] 🧪 Tests only
|
||||
|
||||
## 🔗 Related Issues
|
||||
<!-- Link any related issues using "Fixes #123" or "Related to #123" -->
|
||||
|
||||
## 🛠 Changes Made
|
||||
<!-- Describe the changes made in detail -->
|
||||
|
||||
### Frontend (Flutter)
|
||||
- [ ] UI components updated
|
||||
- [ ] State management changes
|
||||
- [ ] Navigation changes
|
||||
- [ ] New screens/widgets added
|
||||
|
||||
### Backend (.NET Core)
|
||||
- [ ] API endpoints added/modified
|
||||
- [ ] Database schema changes
|
||||
- [ ] Business logic updates
|
||||
- [ ] Authentication/authorization changes
|
||||
|
||||
## 🧪 Testing
|
||||
<!-- Describe the testing done for this change -->
|
||||
|
||||
### Flutter Testing
|
||||
- [ ] Unit tests added/updated
|
||||
- [ ] Widget tests added/updated
|
||||
- [ ] Integration tests added/updated
|
||||
- [ ] Manual testing completed on iOS
|
||||
- [ ] Manual testing completed on Android
|
||||
|
||||
### .NET Testing
|
||||
- [ ] Unit tests added/updated
|
||||
- [ ] Integration tests added/updated
|
||||
- [ ] API testing completed
|
||||
- [ ] Database migration tested
|
||||
|
||||
## 📱 Screenshots/Videos
|
||||
<!-- Add screenshots or videos if applicable -->
|
||||
|
||||
## 📝 Additional Notes
|
||||
<!-- Any additional context, warnings, or notes for reviewers -->
|
||||
|
||||
## ✅ Checklist
|
||||
<!-- Mark completed items with an 'x' -->
|
||||
|
||||
### Code Quality
|
||||
- [ ] Code follows the established coding standards
|
||||
- [ ] Self-review of the code completed
|
||||
- [ ] Code is properly commented (especially complex logic)
|
||||
- [ ] No debugging code or console logs left in
|
||||
- [ ] Error handling is appropriate
|
||||
|
||||
### Documentation
|
||||
- [ ] Documentation updated (if needed)
|
||||
- [ ] API documentation updated (if applicable)
|
||||
- [ ] README updated (if needed)
|
||||
|
||||
### Security & Performance
|
||||
- [ ] No sensitive data exposed in code
|
||||
- [ ] Performance impact considered
|
||||
- [ ] Security implications reviewed
|
||||
- [ ] Accessibility guidelines followed (for UI changes)
|
||||
|
||||
### Testing & Deployment
|
||||
- [ ] All tests pass locally
|
||||
- [ ] CI/CD pipeline passes
|
||||
- [ ] Database migrations work (if applicable)
|
||||
- [ ] Feature works in staging environment
|
||||
|
||||
## 👥 Reviewers
|
||||
<!-- Tag specific people if needed -->
|
||||
@team-leads @senior-developers
|
||||
|
||||
---
|
||||
**Note**: Please ensure all checkboxes are marked before requesting review.
|
||||
|
|
@ -0,0 +1,137 @@
|
|||
name: CI/CD Pipeline
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [ main, develop ]
|
||||
pull_request:
|
||||
branches: [ main, develop ]
|
||||
|
||||
jobs:
|
||||
# Flutter Mobile App CI
|
||||
flutter-test:
|
||||
name: Flutter Tests
|
||||
runs-on: ubuntu-latest
|
||||
defaults:
|
||||
run:
|
||||
working-directory: ./mobile
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Setup Flutter
|
||||
uses: subosito/flutter-action@v2
|
||||
with:
|
||||
flutter-version: '3.16.0'
|
||||
channel: 'stable'
|
||||
|
||||
- name: Get dependencies
|
||||
run: flutter pub get
|
||||
|
||||
- name: Analyze code
|
||||
run: flutter analyze
|
||||
|
||||
- name: Run tests
|
||||
run: flutter test
|
||||
|
||||
- name: Generate coverage
|
||||
run: flutter test --coverage
|
||||
|
||||
- name: Upload coverage to Codecov
|
||||
uses: codecov/codecov-action@v3
|
||||
with:
|
||||
file: ./mobile/coverage/lcov.info
|
||||
|
||||
# .NET Backend API CI
|
||||
dotnet-test:
|
||||
name: .NET Tests
|
||||
runs-on: ubuntu-latest
|
||||
defaults:
|
||||
run:
|
||||
working-directory: ./backend
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Setup .NET
|
||||
uses: actions/setup-dotnet@v3
|
||||
with:
|
||||
dotnet-version: '8.0.x'
|
||||
|
||||
- name: Restore dependencies
|
||||
run: dotnet restore
|
||||
|
||||
- name: Build
|
||||
run: dotnet build --no-restore --configuration Release
|
||||
|
||||
- name: Test
|
||||
run: dotnet test --no-build --configuration Release --verbosity normal --collect:"XPlat Code Coverage"
|
||||
|
||||
- name: Upload coverage to Codecov
|
||||
uses: codecov/codecov-action@v3
|
||||
with:
|
||||
file: ./backend/TestResults/*/coverage.cobertura.xml
|
||||
|
||||
# Security and Quality Checks
|
||||
security-scan:
|
||||
name: Security Scan
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Run Trivy vulnerability scanner
|
||||
uses: aquasecurity/trivy-action@master
|
||||
with:
|
||||
scan-type: 'fs'
|
||||
scan-ref: '.'
|
||||
format: 'sarif'
|
||||
output: 'trivy-results.sarif'
|
||||
|
||||
- name: Upload Trivy scan results to GitHub Security tab
|
||||
uses: github/codeql-action/upload-sarif@v2
|
||||
with:
|
||||
sarif_file: 'trivy-results.sarif'
|
||||
|
||||
# Build and Deploy to Staging (develop branch only)
|
||||
deploy-staging:
|
||||
name: Deploy to Staging
|
||||
needs: [flutter-test, dotnet-test]
|
||||
runs-on: ubuntu-latest
|
||||
if: github.ref == 'refs/heads/develop' && github.event_name == 'push'
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Configure AWS credentials
|
||||
uses: aws-actions/configure-aws-credentials@v2
|
||||
with:
|
||||
aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
|
||||
aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
|
||||
aws-region: us-west-2
|
||||
|
||||
- name: Deploy to staging
|
||||
run: |
|
||||
echo "Deploying to staging environment"
|
||||
# Add actual deployment commands here
|
||||
|
||||
# Build and Deploy to Production (main branch only)
|
||||
deploy-production:
|
||||
name: Deploy to Production
|
||||
needs: [flutter-test, dotnet-test, security-scan]
|
||||
runs-on: ubuntu-latest
|
||||
if: github.ref == 'refs/heads/main' && github.event_name == 'push'
|
||||
environment: production
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Configure AWS credentials
|
||||
uses: aws-actions/configure-aws-credentials@v2
|
||||
with:
|
||||
aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
|
||||
aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
|
||||
aws-region: us-west-2
|
||||
|
||||
- name: Deploy to production
|
||||
run: |
|
||||
echo "Deploying to production environment"
|
||||
# Add actual deployment commands here
|
||||
|
|
@ -483,4 +483,4 @@ secrets/
|
|||
*.pem
|
||||
*.p12
|
||||
*.p8
|
||||
*.mobileprovision
|
||||
*.mobileprovisiondocs/05_views/
|
||||
|
|
|
|||
|
|
@ -0,0 +1,103 @@
|
|||
# 🤖 與 Claude 協作指南
|
||||
|
||||
## 🎯 目標
|
||||
確保 Claude 在協助開發時發現的所有問題都被記錄到問題管理系統中。
|
||||
|
||||
## 📋 每次請 Claude 協助時的提醒詞
|
||||
|
||||
### 🔥 標準提醒語句：
|
||||
```
|
||||
"如果你在過程中發現任何規格不確定、衝突、技術問題或需要決策的地方，請使用問題管理系統記錄下來。"
|
||||
```
|
||||
|
||||
### 💫 簡短版本：
|
||||
```
|
||||
"遇到問題就記錄到問題系統"
|
||||
```
|
||||
|
||||
### 🎯 具體場景提醒：
|
||||
|
||||
**實作功能時：**
|
||||
```
|
||||
"實作 [功能名稱]，發現問題就用 ./issue.sh 記錄"
|
||||
```
|
||||
|
||||
**檢查文檔時：**
|
||||
```
|
||||
"檢查 [文檔]，找到不一致或不清楚的地方就記錄問題"
|
||||
```
|
||||
|
||||
**重構程式時：**
|
||||
```
|
||||
"重構 [模組]，遇到架構問題或技術債務就記錄"
|
||||
```
|
||||
|
||||
## 🔄 Claude 應該記錄的問題類型
|
||||
|
||||
### 🔥 緊急問題
|
||||
- 架構設計衝突
|
||||
- 無法實作的需求
|
||||
- 安全性問題
|
||||
- 資料不一致
|
||||
|
||||
### ⚠️ 重要問題
|
||||
- 規格定義模糊
|
||||
- API 設計不確定
|
||||
- UI/UX 流程不清楚
|
||||
- 技術選型疑慮
|
||||
|
||||
### 📝 一般問題
|
||||
- 文檔格式不統一
|
||||
- 命名規範不一致
|
||||
- 小的技術改進建議
|
||||
- 程式碼品質提升
|
||||
|
||||
## 📝 任務完成後的檢查清單
|
||||
|
||||
每次 Claude 完成任務後，請檢查：
|
||||
|
||||
- [ ] Claude 有沒有提到任何「不確定」、「需要澄清」的地方？
|
||||
- [ ] 有沒有發現文檔間的衝突？
|
||||
- [ ] 有沒有提到技術實作的困難？
|
||||
- [ ] 有沒有建議需要進一步決策的事項？
|
||||
|
||||
**如果有，就提醒：** "把剛才提到的問題記錄到問題系統"
|
||||
|
||||
## 🎯 協作流程範例
|
||||
|
||||
### 範例1：實作功能
|
||||
```
|
||||
您: "實作用戶登入功能，遇到問題就記錄"
|
||||
Claude: "好的，我發現API規格中密碼驗證流程不明確..."
|
||||
您: "把這個記錄到問題系統"
|
||||
Claude: [使用 ./issue.sh 記錄]
|
||||
```
|
||||
|
||||
### 範例2：文檔檢查
|
||||
```
|
||||
您: "檢查API文檔一致性，發現問題就用問題系統記錄"
|
||||
Claude: "我發現用戶管理API和認證API的錯誤碼定義衝突..."
|
||||
Claude: [自動使用 ./issue.sh 記錄問題]
|
||||
```
|
||||
|
||||
## 💡 讓協作更順暢的技巧
|
||||
|
||||
### 🏷️ 在任務開始時就說明：
|
||||
"我希望你把發現的所有問題都記錄下來，這樣我們就不會遺漏任何需要解決的事項。"
|
||||
|
||||
### 🔄 定期檢查：
|
||||
每週問 Claude："最近有沒有發現什麼新的問題需要記錄？"
|
||||
|
||||
### 📊 任務總結：
|
||||
"總結一下這次任務中發現的問題，並確保都記錄了。"
|
||||
|
||||
## 🎉 效益
|
||||
|
||||
✅ **不會遺漏問題** - 所有發現的問題都被記錄
|
||||
✅ **追蹤更完整** - 包含 AI 協助時發現的問題
|
||||
✅ **決策有依據** - 問題記錄成為決策參考
|
||||
✅ **開發更順暢** - 提前發現潛在問題
|
||||
|
||||
---
|
||||
|
||||
**💫 記住：Claude 是您的協作夥伴，讓他幫您記錄問題，讓專案更完善！**
|
||||
|
|
@ -0,0 +1,142 @@
|
|||
# Claude 工作指南 (Claude Working Guidelines)
|
||||
|
||||
## 🤖 Claude 協作標準操作程序
|
||||
|
||||
本文件為 Claude AI 助手在 Drama Ling 專案中的標準操作程序，確保工作流程的一致性和品質。
|
||||
|
||||
## 🛠️ 必須使用的系統工具
|
||||
|
||||
### 報告建立
|
||||
```bash
|
||||
# ✅ 正確做法：使用系統工具
|
||||
./drama report analysis "分析主題"
|
||||
./drama report decision "決策主題"
|
||||
|
||||
# ❌ 禁止行為：手動創建報告檔案
|
||||
# 直接 Write 或 Edit reports/ 目錄下的檔案
|
||||
```
|
||||
|
||||
### 問題管理
|
||||
```bash
|
||||
# ✅ 正確做法：使用問題管理工具
|
||||
./drama issue
|
||||
|
||||
# ❌ 禁止行為：直接編輯 ISSUES.md
|
||||
# 除非是修正現有問題的格式錯誤
|
||||
```
|
||||
|
||||
### 檢查作業
|
||||
```bash
|
||||
# ✅ 正確做法：使用檢查工具
|
||||
./drama check
|
||||
|
||||
# 其他維護腳本
|
||||
./check_consistency.sh
|
||||
```
|
||||
|
||||
## 🎯 核心工作原則
|
||||
|
||||
### 1. 工具優先原則
|
||||
- **必須優先使用現有工具和腳本**
|
||||
- 手動操作只能用於緊急修正
|
||||
- 所有報告都必須透過 `./drama report` 創建
|
||||
|
||||
### 2. 日期準確性原則
|
||||
- **系統工具會自動處理日期**
|
||||
- 當前日期：2025-09-07
|
||||
- 任何手動設定日期都必須使用正確的當前日期
|
||||
|
||||
### 3. 文檔整合原則
|
||||
- 所有問題必須記錄到 ISSUES.md
|
||||
- 所有分析必須產生正式報告
|
||||
- 報告必須與問題系統整合
|
||||
|
||||
## 📋 標準工作流程
|
||||
|
||||
### 分析任務流程
|
||||
1. **建立分析報告**: `./drama report analysis "主題"`
|
||||
2. **執行分析工作**: 使用適當工具進行分析
|
||||
3. **更新報告內容**: 編輯生成的報告檔案
|
||||
4. **整合問題系統**: 確認相關問題已正確連結
|
||||
|
||||
### 問題處理流程
|
||||
1. **記錄問題**: `./drama issue`
|
||||
2. **分配優先級**: 🔥緊急 / ⚠️重要 / 📝一般
|
||||
3. **建立相關報告**: 如有需要，建立分析或決策報告
|
||||
4. **追蹤解決進展**: 定期更新問題狀態
|
||||
|
||||
### 檢查作業流程
|
||||
1. **執行系統檢查**: `./drama check`
|
||||
2. **運行一致性檢查**: `./check_consistency.sh`
|
||||
3. **記錄發現問題**: 使用問題管理系統
|
||||
4. **產生檢查報告**: 必要時建立分析報告
|
||||
|
||||
## ⚠️ 常見錯誤和避免方法
|
||||
|
||||
### 錯誤1: 手動創建報告
|
||||
**問題**: 直接創建報告檔案，導致日期錯誤、格式不一致
|
||||
**解決**: 必須使用 `./drama report` 命令
|
||||
|
||||
### 錯誤2: 忽略現有工具
|
||||
**問題**: 重複實作已存在的功能
|
||||
**解決**: 先檢查 `tools/` 目錄下的現有工具
|
||||
|
||||
### 錯誤3: 未整合問題系統
|
||||
**問題**: 發現問題但未記錄到 ISSUES.md
|
||||
**解決**: 每次發現問題都必須使用 `./drama issue`
|
||||
|
||||
### 錯誤4: 日期不一致
|
||||
**問題**: 使用錯誤的日期或格式
|
||||
**解決**: 依賴系統工具的自動日期處理
|
||||
|
||||
## 🔍 品質檢查清單
|
||||
|
||||
### 每次任務完成後檢查
|
||||
- [ ] 是否使用了正確的系統工具？
|
||||
- [ ] 所有日期是否正確（2025-09-07）？
|
||||
- [ ] 發現的問題是否已記錄？
|
||||
- [ ] 報告是否已正確整合到問題系統？
|
||||
- [ ] 檔案命名是否符合系統標準？
|
||||
|
||||
## 🚨 緊急情況處理
|
||||
|
||||
### 工具故障時
|
||||
1. 記錄工具故障情況到 ISSUES.md
|
||||
2. 使用手動方式完成緊急任務
|
||||
3. 修正工具後重新使用標準流程
|
||||
4. 檢查並修正手動操作造成的不一致
|
||||
|
||||
### 系統不一致時
|
||||
1. 立即停止當前工作
|
||||
2. 運行 `./check_consistency.sh`
|
||||
3. 記錄發現的不一致問題
|
||||
4. 修正問題後繼續工作
|
||||
|
||||
## 📚 相關文檔
|
||||
|
||||
- [問題追蹤系統](./ISSUES.md)
|
||||
- [工具使用說明](./tools/)
|
||||
- [報告模板](./reports/templates/)
|
||||
- [檢查腳本](./scripts/)
|
||||
|
||||
## 🔄 持續改善
|
||||
|
||||
### 發現新問題時
|
||||
1. 立即記錄到 ISSUES.md
|
||||
2. 評估是否需要新工具或流程
|
||||
3. 更新本指南文檔
|
||||
4. 通知相關團隊成員
|
||||
|
||||
### 工具優化時
|
||||
1. 測試新工具的正確性
|
||||
2. 更新操作流程
|
||||
3. 修訂本指南文檔
|
||||
4. 確保向下相容性
|
||||
|
||||
---
|
||||
|
||||
**重要提醒**: 本指南是 Claude AI 助手的強制性操作標準。任何偏離此流程的行為都可能造成系統不一致和品質問題。
|
||||
|
||||
**最後更新**: 2025-09-07
|
||||
**版本**: 1.0
|
||||
**維護者**: Drama Ling 開發團隊
|
||||
|
|
@ -0,0 +1,136 @@
|
|||
# 📋 待處理問題
|
||||
|
||||
## 🔥 緊急問題
|
||||
- [ ] API模組化文檔中有7個待建立的模組
|
||||
|
||||
## ⚠️ 重要問題
|
||||
- [ ] 資料庫schema設計未確定
|
||||
- [ ] 用戶認證流程細節模糊
|
||||
- [ ] System Design有40個UI但User Flow沒有，存在大量設計缺漏（比預期更嚴重）
|
||||
- 📊 **綜合分析**: [UI設計缺漏嚴重性評估](./reports/analysis/2025-09-07_UI-design-gaps-severity-analysis.md)
|
||||
- 📊 **基礎報告**: [UI一致性分析報告](./reports/analysis/2025-09-07_UI-consistency-analysis.md)
|
||||
- 📊 **功能分類**: [缺失UI功能分類分析](/tmp/ui_analysis/missing_ui_analysis.md)
|
||||
- 📋 **實施計劃**: 第1週-核心功能(17個)，第2週-重要功能(13個)，第4週-次要功能(10個)
|
||||
- ⚠️ **緊急建議**: 暫停非核心功能開發，優先補全對話糾正和學習結果系統
|
||||
- [ ] User Flow有7個UI但System Design沒有，可能是實作時新增的UI
|
||||
- 📊 **相關報告**: [UI一致性分析報告](./reports/analysis/2025-09-07_UI-consistency-analysis.md)
|
||||
- 📋 **後續行動**: 需確認這7個UI是否為必要功能
|
||||
|
||||
## 📝 一般問題
|
||||
- [ ] 資料庫設計需要確認用戶表結構
|
||||
- [ ] 文檔格式不統一
|
||||
- [ ] UI組件命名規範
|
||||
- [ ] 部分UI功能重複可能需要合併（多個Result相關UI）
|
||||
|
||||
## 🤖 與 Claude 協作提醒
|
||||
- [ ] Claude **必須優先使用** `./drama report` 而非手動創建報告
|
||||
- [ ] Claude **必須使用** `./drama issue` 而非直接編輯 ISSUES.md
|
||||
- [ ] 定期運行 `./drama compliance` 檢查系統合規性
|
||||
- [ ] 如果 Claude 發現規格不確定或衝突，立即記錄到對應優先級區域
|
||||
- [ ] Claude 實作功能時發現的技術難題也要記錄
|
||||
- [ ] 請 Claude 在完成任務後總結發現的問題
|
||||
|
||||
### 🚨 強制性工作流程
|
||||
**重要**: Claude 必須遵循以下強制性流程，避免系統不一致：
|
||||
|
||||
1. **報告建立**: 必須使用 `./drama report analysis "主題"`
|
||||
2. **問題管理**: 必須使用 `./drama issue`
|
||||
3. **系統檢查**: 定期使用 `./drama compliance` 和 `./drama consistency`
|
||||
4. **參考指南**: 所有操作前先查看 `CLAUDE.md` 工作指南
|
||||
|
||||
**違反流程的後果**: 可能導致日期錯誤、格式不一致、系統追蹤失效等問題
|
||||
|
||||
---
|
||||
|
||||
# 📚 已完成歷史
|
||||
|
||||
## 2025-09-07 完成項目
|
||||
|
||||
### 🔥 緊急問題 - 已解決
|
||||
- [x] **對話糾正系統缺失完整User Flow**，影響核心學習功能（9個UI）
|
||||
- 📊 **詳細分析**: [UI設計缺漏嚴重性評估](./reports/analysis/2025-09-07_UI-design-gaps-severity-analysis.md)
|
||||
- 📋 **User Flow設計**: [對話糾正系統流程設計](/tmp/ui_analysis/dialog_correction_flow.md)
|
||||
- ✅ **解決狀態**: 已完成完整對話糾正系統User Flow設計並整合到官方文檔
|
||||
|
||||
- [x] **System Design與User Flow的UI名稱不一致**
|
||||
- 📊 **分析報告**: [UI一致性分析報告](./reports/analysis/2025-09-07_UI-consistency-analysis.md)
|
||||
- ✅ **解決狀態**: 已修正命名錯誤和特殊字符，39個缺漏UI待補充
|
||||
|
||||
### 📝 一般問題 - 已解決
|
||||
- [x] **UI名稱包含特殊字符**（如UI_ChallengeLevel_ChoosePopup-1有連字號）
|
||||
- [x] **UI命名不一致**（UI_PresonalCenter_dd_Detail有拼寫錯誤）
|
||||
|
||||
### 🤖 Claude 協作 - 已完成
|
||||
- [x] **建立 Claude 工作指南文件** (CLAUDE.md)
|
||||
- [x] **在系統工具中加入操作提醒和防護機制**
|
||||
- [x] **建立合規性檢查系統** (`./drama compliance`)
|
||||
- [x] **建立問題追蹤系統**
|
||||
|
||||
---
|
||||
|
||||
## 💡 問題維護機制
|
||||
|
||||
### 📝 新增問題
|
||||
**推薦方式**: 使用 `./drama issue` 工具
|
||||
- 自動分類到正確優先級
|
||||
- 統一格式和日期
|
||||
- 互動式操作，不易出錯
|
||||
|
||||
**手動方式**: 直接編輯本檔案（緊急時）
|
||||
```
|
||||
- [ ] 問題描述 (優先級: 🔥緊急/⚠️重要/📝一般)
|
||||
- 檔案: path/to/file.md:line
|
||||
- 影響: 描述影響
|
||||
- 建議: 可能的解決方向
|
||||
```
|
||||
|
||||
### ✅ 完成問題
|
||||
1. **標記完成**: 將 `[ ]` 改為 `[x]`
|
||||
2. **移動位置**: 從待處理區域移到「📚 已完成歷史」
|
||||
3. **按日期分組**: 放到對應的日期區域（如：2025-09-08 完成項目）
|
||||
4. **保留詳情**: 移動時保留解決詳情和連結
|
||||
|
||||
### 🔄 定期維護
|
||||
|
||||
#### 每日檢查
|
||||
- 查看是否有新的緊急問題
|
||||
- 更新問題進度
|
||||
|
||||
#### 每週整理
|
||||
- 整理已完成項目到正確日期區域
|
||||
- 檢查是否有逾期的重要問題
|
||||
- 評估問題優先級是否需要調整
|
||||
|
||||
#### 每月歸檔
|
||||
- 將超過一個月的完成項目移到歷史存檔
|
||||
- 統計問題解決效率
|
||||
- 檢討常見問題類型
|
||||
|
||||
### 📊 快速查看
|
||||
- **待處理總覽**: `./drama check`
|
||||
- **完整列表**: `./drama issue` → 選項 4
|
||||
- **狀態統計**: `./drama issue` → 選項 2
|
||||
|
||||
---
|
||||
|
||||
## 🎯 使用原則
|
||||
|
||||
### 🚨 緊急問題
|
||||
- **定義**: 阻擋開發進度的嚴重問題
|
||||
- **處理時間**: 立即處理
|
||||
- **範例**: API 衝突、資料庫設計錯誤
|
||||
|
||||
### ⚠️ 重要問題
|
||||
- **定義**: 影響功能完整性的問題
|
||||
- **處理時間**: 本週內
|
||||
- **範例**: UI 設計缺漏、功能需求不明確
|
||||
|
||||
### 📝 一般問題
|
||||
- **定義**: 可以延後處理的改進
|
||||
- **處理時間**: 有空閒時
|
||||
- **範例**: 文檔格式、命名規範
|
||||
|
||||
### 📚 歷史記錄
|
||||
- **用途**: 了解最近完成的工作
|
||||
- **組織**: 按完成日期分組
|
||||
- **保留**: 解決方案和相關連結
|
||||
|
|
@ -0,0 +1,142 @@
|
|||
# 🚨 Drama Ling 問題管理系統
|
||||
|
||||
## 🎯 統一入口點
|
||||
|
||||
### 🎭 **主命令** (推薦)
|
||||
```bash
|
||||
./drama # 顯示所有可用命令
|
||||
./drama issue # 管理問題
|
||||
./drama check # 檢查問題狀態
|
||||
./drama report "標題" # 建立分析報告
|
||||
./drama consistency # 一致性檢查
|
||||
./drama all # 執行全部檢查
|
||||
```
|
||||
|
||||
## 💫 其他使用方式
|
||||
|
||||
### 1️⃣ **直接使用工具** (進階)
|
||||
```bash
|
||||
./tools/issue.sh # 直接使用問題管理工具
|
||||
./tools/check_issues.sh # 直接檢查問題狀態
|
||||
```
|
||||
|
||||
### 2️⃣ **VS Code 快捷鍵** (推薦進階使用者)
|
||||
- `Cmd+Shift+I` - 📝 記錄問題
|
||||
- `Cmd+Shift+S` - 📊 查看狀態
|
||||
- `Cmd+Shift+C` - 🔍 一致性檢查
|
||||
- `Cmd+Shift+A` - 🚀 全部檢查
|
||||
|
||||
### 3️⃣ **全域命令** (最方便)
|
||||
```bash
|
||||
# 先執行一次設置
|
||||
./drama setup
|
||||
|
||||
# 重啟終端機後，在任何地方都能用:
|
||||
dl # 主選單
|
||||
dl-issue # 記錄問題
|
||||
dl-check # 查看狀態
|
||||
dl-report # 建立報告
|
||||
dl-consistency # 一致性檢查
|
||||
dl-all # 全部檢查
|
||||
```
|
||||
|
||||
## 🚀 快速開始
|
||||
|
||||
### 第一次使用:
|
||||
1. 打開終端機
|
||||
2. `cd /Users/jettcheng1018/code/dramaling-app`
|
||||
3. `./drama` 查看所有命令
|
||||
4. `./drama issue` 開始管理問題
|
||||
|
||||
### 日常使用:
|
||||
```bash
|
||||
# 有問題時
|
||||
./drama issue → 選1 → 輸入問題 → 選優先級
|
||||
|
||||
# 想查狀態時
|
||||
./drama check
|
||||
|
||||
# 建立分析報告
|
||||
./drama report "問題分析標題"
|
||||
|
||||
# 執行系統檢查
|
||||
./drama all
|
||||
```
|
||||
|
||||
## 📋 問題優先級
|
||||
|
||||
- 🔥 **緊急** - 阻擋開發的嚴重問題
|
||||
- ⚠️ **重要** - 影響進度的重要問題
|
||||
- 📝 **一般** - 可以延後的問題
|
||||
|
||||
## ✅ 解決問題
|
||||
|
||||
**方法1 - 用工具:**
|
||||
`./issue.sh` → 選3 → 查看問題列表 → 手動編輯檔案
|
||||
|
||||
**方法2 - 直接編輯:**
|
||||
打開 `ISSUES.md`，把 `[ ]` 改成 `[x]`，移到「已解決」區域
|
||||
|
||||
## 🔧 故障排除
|
||||
|
||||
### 權限問題:
|
||||
```bash
|
||||
chmod +x issue.sh
|
||||
chmod +x setup_aliases.sh
|
||||
```
|
||||
|
||||
### 找不到檔案:
|
||||
```bash
|
||||
# 確認在正確目錄
|
||||
pwd
|
||||
# 應該顯示: /Users/jettcheng1018/code/dramaling-app
|
||||
```
|
||||
|
||||
### VS Code 快捷鍵無效:
|
||||
1. 重啟 VS Code
|
||||
2. 檢查是否在專案根目錄開啟 VS Code
|
||||
|
||||
## 💡 使用技巧
|
||||
|
||||
### 快速記錄:
|
||||
- 發現問題立即記錄，不要拖延
|
||||
- 描述要具體，包含檔案位置
|
||||
- 優先級要準確判斷
|
||||
|
||||
### 定期回顧:
|
||||
- 每週檢查一次狀態
|
||||
- 將已解決問題移到完成區域
|
||||
- 評估緊急問題是否需要立即處理
|
||||
|
||||
### 團隊協作:
|
||||
- 問題描述要清楚，讓其他人也能理解
|
||||
- 相關檔案路徑要完整
|
||||
- 解決後記錄解決方案
|
||||
|
||||
## 📁 相關檔案
|
||||
|
||||
### 核心系統
|
||||
- `drama` - 🎭 統一入口點腳本
|
||||
- `ISSUES.md` - 主要問題追蹤檔案
|
||||
- `reports/` - 結構化報告目錄
|
||||
|
||||
### 工具目錄
|
||||
- `tools/issue.sh` - 互動式問題管理工具
|
||||
- `tools/check_issues.sh` - 快速狀態檢查
|
||||
- `tools/create_report.sh` - 快速建立報告工具
|
||||
- `tools/check_reports.sh` - 報告狀態檢查
|
||||
- `tools/setup_aliases.sh` - 全域命令設置
|
||||
|
||||
### VS Code 整合
|
||||
- `.vscode/tasks.json` - VS Code 任務設定
|
||||
- `.vscode/keybindings.json` - VS Code 快捷鍵
|
||||
|
||||
### 維護系統
|
||||
- `scripts/maintenance_manager.sh` - 系統檢查主腳本
|
||||
- `scripts/maintenance/` - 各種檢查腳本目錄
|
||||
|
||||
---
|
||||
|
||||
**🎉 現在您有了一個超級簡單好用的問題管理系統！**
|
||||
|
||||
遇到問題就記錄，定期檢查狀態，讓專案開發更順暢！
|
||||
|
|
@ -0,0 +1,162 @@
|
|||
# 📚 文檔指南
|
||||
|
||||
本文檔提供 Drama Ling 專案文檔結構的完整說明。
|
||||
|
||||
## 📁 目錄結構
|
||||
|
||||
```
|
||||
docs/
|
||||
├── 00_starter/ # 專案初始化和模板
|
||||
├── 01_requirement/ # 專案需求和規格說明
|
||||
├── design/ # 設計和使用者體驗文檔
|
||||
├── technical/ # 技術架構和規格說明
|
||||
├── development/ # 開發指南和工作流程
|
||||
└── README.md # 本文件 - 文檔總覽
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📂 目錄詳細說明
|
||||
|
||||
### 🚀 `/00_starter` - 專案基礎
|
||||
**用途**: 包含專案初始化和AI輔助開發所使用的基礎模板和提示詞。
|
||||
|
||||
| 檔案名稱 | 用途 |
|
||||
|------|---------|
|
||||
| `CLAUDE_TEMPLATE.md` | Claude AI 互動模板和專案設置 |
|
||||
| `READ.md` | 使用入門模板的說明指引 |
|
||||
| `business_function_design_prompt.md` | 生成業務功能設計的 AI 提示詞 |
|
||||
| `generate_requirements_prompt.md` | 創建專案需求的 AI 提示詞 |
|
||||
| `generate_system_structure_prompt.md` | 系統架構生成的 AI 提示詞 |
|
||||
| `system_detail_prompt.md` | 詳細系統規格的 AI 提示詞 |
|
||||
| `system_structured_schema.json` | 結構化系統設計輸出的 JSON 架構 |
|
||||
|
||||
**使用時機**: 這些檔案主要在專案初始化時使用，以及與 AI 助手協作生成文檔和程式碼結構時使用。
|
||||
|
||||
---
|
||||
|
||||
### 📋 `/01_requirement` - 專案需求
|
||||
**用途**: 包含核心專案需求、規格說明和系統設計文檔。
|
||||
|
||||
| 檔案名稱 | 用途 |
|
||||
|------|---------|
|
||||
| `founding_pitch.md` | 初始專案提案和商業案例 |
|
||||
| `requirements.md` | **主要需求文檔** - 詳細的產品規格、功能和使用者故事 |
|
||||
| `system_structure_design.json` | **結構化系統設計** - 從需求生成，包含模組、功能和UI視圖的JSON格式 |
|
||||
|
||||
**關鍵文檔**: `requirements.md` 是產品應該做什麼以及如何運作的唯一真實來源。
|
||||
|
||||
---
|
||||
|
||||
### 🎨 `/design` - 設計規格
|
||||
**用途**: 涵蓋使用者體驗、視覺設計和互動模式的文檔。
|
||||
|
||||
| 檔案名稱 | 用途 |
|
||||
|------|---------|
|
||||
| `ai-algorithm-specs.md` | AI 分析演算法和語言處理規格 |
|
||||
| `business-logic-rules.md` | 核心商業規則和邏輯流程定義 |
|
||||
| `content-management-specs.md` | 內容創建、策劃和管理工作流程 |
|
||||
| `gamification-mechanics.md` | 遊戲元素、成就和獎勵系統設計 |
|
||||
| `ui-ux-guidelines.md` | 視覺設計標準、組件庫和使用者介面指南 |
|
||||
|
||||
**目標讀者**: 設計師、前端開發人員和產品經理。
|
||||
|
||||
---
|
||||
|
||||
### ⚙️ `/technical` - 技術架構
|
||||
**用途**: 技術實作細節、系統架構和整合規格說明。
|
||||
|
||||
| 檔案名稱 | 用途 |
|
||||
|------|---------|
|
||||
| `api-specifications.md` | **REST API 文檔** - 端點、請求/回應格式、認證 |
|
||||
| `database-schema.md` | 資料庫設計、資料表、關聯和資料模型 |
|
||||
| `flutter-dotnet-integration.md` | Flutter 前端與 .NET Core 後端的整合指南 |
|
||||
| `tech-stack-decision.md` | 技術選擇、理由和架構決策 |
|
||||
|
||||
**關鍵文檔**: `api-specifications.md` 作為前端和後端團隊之間的契約。
|
||||
|
||||
---
|
||||
|
||||
### 👨💻 `/development` - 開發指南
|
||||
**用途**: 為開發人員提供編碼標準、工作流程和專案路線圖的指南。
|
||||
|
||||
| 檔案名稱 | 用途 |
|
||||
|------|---------|
|
||||
| `coding-standards.md` | Flutter/Dart 和 .NET/C# 的程式碼風格指南、命名慣例和最佳實踐 |
|
||||
| `development-workflow.md` | Git 工作流程、分支策略、程式碼審查流程和開發生命週期 |
|
||||
| `project-roadmap.md` | **開發時程表** - 階段、里程碑和功能交付時程 |
|
||||
|
||||
**目標讀者**: 所有參與專案的開發人員。
|
||||
|
||||
---
|
||||
|
||||
## 🎯 如何使用這個文檔
|
||||
|
||||
### 新團隊成員
|
||||
1. **從這裡開始**: 閱讀這個 `README.md` 文檔總覽
|
||||
2. **了解產品**: 閱讀 `/01_requirement/requirements.md`
|
||||
3. **學習技術棧**: 查看 `/technical/tech-stack-decision.md`
|
||||
4. **遵循開發流程**: 學習 `/development/development-workflow.md`
|
||||
5. **遵守編碼標準**: 查看 `/development/coding-standards.md`
|
||||
|
||||
### 前端開發人員
|
||||
- 主要文檔: `/design/ui-ux-guidelines.md`, `/technical/flutter-dotnet-integration.md`
|
||||
- API 契約: `/technical/api-specifications.md`
|
||||
- 編碼標準: `/development/coding-standards.md`
|
||||
|
||||
### 後端開發人員
|
||||
- 主要文檔: `/technical/api-specifications.md`, `/technical/database-schema.md`
|
||||
- 整合指南: `/technical/flutter-dotnet-integration.md`
|
||||
- 商業邏輯: `/design/business-logic-rules.md`
|
||||
|
||||
### 產品經理
|
||||
- 主要文檔: `/01_requirement/requirements.md`, `/development/project-roadmap.md`
|
||||
- 設計規格: `/design/` 目錄下的所有檔案
|
||||
- 進度追蹤: `/development/project-roadmap.md`
|
||||
|
||||
### 設計師
|
||||
- 主要文檔: `/design/ui-ux-guidelines.md`, `/design/gamification-mechanics.md`
|
||||
- 內容策略: `/design/content-management-specs.md`
|
||||
|
||||
---
|
||||
|
||||
## 🔄 文檔維護
|
||||
|
||||
### 何時更新
|
||||
- **需求變更**: 更新 `/01_requirement/requirements.md` 並重新生成 `system_structure_design.json`
|
||||
- **API 變更**: 更新 `/technical/api-specifications.md`
|
||||
- **設計更新**: 更新 `/design/` 目錄中相關檔案
|
||||
- **新功能**: 更新 `/development/project-roadmap.md` 中的路線圖
|
||||
|
||||
### 責任歸屬
|
||||
- **產品團隊**: `/01_requirement/` 和 `/design/` 目錄
|
||||
- **工程團隊**: `/technical/` 和 `/development/` 目錄
|
||||
- **AI/DevOps**: `/00_starter/` 目錄（模板維護）
|
||||
|
||||
---
|
||||
|
||||
## 🔍 快速參考
|
||||
|
||||
| 尋找... | 前往... |
|
||||
|----------------|----------|
|
||||
| 要建構什麼功能 | `/01_requirement/requirements.md` |
|
||||
| API 端點和資料格式 | `/technical/api-specifications.md` |
|
||||
| 資料庫結構 | `/technical/database-schema.md` |
|
||||
| UI 設計標準 | `/design/ui-ux-guidelines.md` |
|
||||
| 如何貢獻程式碼 | `/development/development-workflow.md` |
|
||||
| 開發時程表 | `/development/project-roadmap.md` |
|
||||
| 系統架構 | `/01_requirement/system_structure_design.json` |
|
||||
|
||||
---
|
||||
|
||||
## 📞 技術支援
|
||||
|
||||
如果您需要任何文檔的說明：
|
||||
- 📧 Email: dev@dramaling.com
|
||||
- 💬 Slack: #dev-support
|
||||
- 📱 Issues: [GitHub Issues](https://github.com/JettCheng/DramaLingApp/issues)
|
||||
|
||||
---
|
||||
|
||||
**最後更新**: 2025-01-05
|
||||
**版本**: 1.0.0
|
||||
|
|
@ -37,7 +37,7 @@
|
|||
"type": "array",
|
||||
"items": {
|
||||
"type": "string",
|
||||
"enum": ["UserProfile", "Lesson", "Dialogue", "Task", "TaskReward", "Leaderboard", "Purchase", "Subscription", "AdImpression"]
|
||||
"enum": ["UserProfile", "Lesson", "Dialogue", "Task", "TaskReward", "Leaderboard", "Purchase", "Subscription", "AdImpression", "Vocabulary", "VocabularyReview", "LifePoints", "ContinuousLearning", "TimeWarp"]
|
||||
}
|
||||
},
|
||||
"view_ids": { "type": "array", "items": { "type": "string" } }
|
||||
|
|
|
|||
|
|
@ -4,44 +4,109 @@
|
|||
Drama Ling 是一款結合情境對話訓練、遊戲化機制和智能詞彙複習系統的外語學習應用程式。採用語言習得方法，透過多樣化劇本模擬真實溝通場景，搭配排行榜和闖關機制，解決傳統語言學習缺乏實戰練習、動機不足、無法持續的核心問題，讓學習者真正達到「會說、會用」的溝通目標。
|
||||
|
||||
## feature_demand
|
||||
1. **情境對話訓練模組**
|
||||
- 多場景劇本系統（車禍、購物、餐廳等）
|
||||
- 開場對話引導
|
||||
- 任務清單系統（安撫、報警、說明等）
|
||||
- 指定詞彙練習
|
||||
- 限時對話挑戰
|
||||
|
||||
2. **AI 互動分析系統**
|
||||
- 即時訊息分析與翻譯
|
||||
- 回覆範例提供
|
||||
- 語法、語意、流暢度三維度評分
|
||||
- 對話訂正功能
|
||||
### 1. 用戶認證與引導系統 (ENT - 15個介面)
|
||||
**完整的用戶入門體驗**
|
||||
- **社群登入整合**：支援 Apple ID 和 Google 帳號快速登入
|
||||
- **7天免費試用流程**：無縫試用開啟與轉換機制
|
||||
- **個人化引導流程**：新用戶完整的 7 步驟設定流程
|
||||
- 學習目的選擇（FormPurpose）
|
||||
- 語言程度評估（FormLevel）
|
||||
- 學習時段偏好（FormTimeSlot）
|
||||
- 學習頻率設定（FormFrequency）
|
||||
- 重要提醒和使用須知（Notice）
|
||||
- 個人化建議生成（Result）
|
||||
- **帳號管理功能**：多帳號切換、密碼重設、用戶資料管理
|
||||
|
||||
3. **遊戲化學習機制**
|
||||
- 闖關系統設計
|
||||
- 排行榜競爭機制
|
||||
- 學習進度追蹤
|
||||
- 成就系統
|
||||
### 2. 核心學習功能 (CORE - 23個介面)
|
||||
**深度個人化學習體驗**
|
||||
- **完整個人中心系統**：
|
||||
- 詳細學習統計和成就展示
|
||||
- 社群好友系統（好友列表、搜尋、互動）
|
||||
- 個人設定管理
|
||||
- 他人資料瀏覽
|
||||
- **社群競爭機制**：
|
||||
- 即時排行榜系統
|
||||
- 好友間學習競賽
|
||||
- 訪客提醒機制
|
||||
- **語言程度評估**：
|
||||
- 專業程度測試系統
|
||||
- 詳細結果分析和建議
|
||||
- **多元結果展示系統**：
|
||||
- 成功結果頁面（2種變化）
|
||||
- 失敗分析頁面（2種變化）
|
||||
- 詳細分數總結（2種展示方式）
|
||||
- 對話評分分析
|
||||
- 訂正結果展示
|
||||
- 獎勵確認和小獎勵系統
|
||||
|
||||
4. **智能詞彙複習系統**
|
||||
- 間隔複習演算法
|
||||
- 每日複習清單（5分鐘完成）
|
||||
- 詞彙掌握度評估
|
||||
- 複習遊戲化整合
|
||||
### 3. 學習任務與活動 (TASK - 38個介面)
|
||||
**沉浸式學習體驗核心**
|
||||
- **完整場景對話系統**（9個相關介面）：
|
||||
- 挑戰關卡地圖導航
|
||||
- 多種關卡選擇彈窗（包含鎖定狀態）
|
||||
- 沉浸式場景對話主介面
|
||||
- 雙重任務顯示（劇情任務+指定詞彙）
|
||||
- 目標詳情、角色詳情、關鍵詞詳情
|
||||
- 回覆輔助系統（意圖分析+思維引導+範例生成+中翻英）
|
||||
- 即時回覆結果分析
|
||||
- 成本確認和資源不足提醒
|
||||
- **300秒限時挑戰系統**（4個介面）：
|
||||
- 限時挑戰入場機制和門票購買
|
||||
- 300秒倒數計時器和警告系統
|
||||
- 時間相關道具使用（暫停+加時）
|
||||
- 限時結算和特殊獎勵系統
|
||||
- **三階段詞彙學習系統**（8個介面）：
|
||||
- **詞彙介紹階段**：卡片介紹、選擇練習、結果回饋
|
||||
- **流暢度訓練**：圖像配對、句子重組、結果評估
|
||||
- **複習鞏固**：間隔複習主系統
|
||||
- **時光關卡系統**（3個介面）：
|
||||
- 時光卷獲得和使用機制
|
||||
- 時光關卡選擇和挑戰
|
||||
- 時光關卡結算和獎勵
|
||||
- **AI對話訂正系統**（6個介面）：
|
||||
- 語法錯誤解釋和重試
|
||||
- 流暢度改進建議和練習
|
||||
- 通過/重試結果處理
|
||||
- **遊戲化機制**：
|
||||
- 額外任務系統
|
||||
- 個人詳情追蹤
|
||||
- 成就系統和徽章收集
|
||||
- 命條生命系統（5命條上限+自動回復）
|
||||
|
||||
### 4. 商業模式功能 (BIZ - 12個介面)
|
||||
**完整營收系統**
|
||||
- **鑽石購買系統**（5個介面）：
|
||||
- 鑽石套餐選擇頁面（新手包到至尊包）
|
||||
- 購買確認彈窗和價格顯示
|
||||
- 支付流程和第三方支付整合
|
||||
- 購買成功確認和鑽石到帳
|
||||
- 交易記錄和退款處理
|
||||
- **道具商店系統**（4個介面）：
|
||||
- 道具分類主頁面（加時、補命、回覆提示、時間道具）
|
||||
- 各類道具購買確認彈窗（遊戲化設計）
|
||||
- 資源不足提醒和引導購買
|
||||
- 道具使用狀態和幫助指引
|
||||
- **簡化訂閱系統**（3個介面）：
|
||||
- 7天免費體驗歡迎頁面（外星人角色）
|
||||
- 訂閱成功確認和特權說明
|
||||
- 訂閱狀態管理和續訂提醒
|
||||
|
||||
## target_user
|
||||
**主要目標用戶**：
|
||||
- 已具備基礎外語能力（A1-B1程度）的學習者
|
||||
- 希望提升實際對話能力，而非僅考試成績
|
||||
- 喜歡遊戲化體驗，需要外在動機驅動學習
|
||||
- 已具備基礎外語能力（A1-B2程度）的學習者
|
||||
- 希望透過情境對話提升實際溝通能力
|
||||
- 偏好個人化學習體驗和詳細進度追蹤
|
||||
- 喜歡社群互動和競爭機制的學習環境
|
||||
- 需要完整引導和多元回饋的深度學習體驗
|
||||
- 工作或生活中需要外語溝通能力
|
||||
- 重視學習效率，偏好碎片化時間學習
|
||||
|
||||
**用戶特徵**：
|
||||
- 年齡：18-45歲
|
||||
- 學習目的：實用溝通而非考試
|
||||
- 學習時間：每日10分鐘至數小時彈性安排
|
||||
- 技術接受度：中高，熟悉手機應用操作
|
||||
- 學習目的：實用溝通和流暢度提升
|
||||
- 學習時間：每日20分鐘至1小時的沉浸式學習
|
||||
- 技術接受度：高，期待豐富的互動功能
|
||||
- 願意投資時間進行系統性的能力建構
|
||||
|
||||
## core_value
|
||||
**核心價值**：
|
||||
|
|
@ -50,19 +115,37 @@ Drama Ling 是一款結合情境對話訓練、遊戲化機制和智能詞彙複
|
|||
- 透過遊戲化維持長期學習動機
|
||||
|
||||
**差異化優勢**：
|
||||
- 同時具備遊戲動力與實戰情境，超越純題庫練習
|
||||
- 相較自律型AI練習，增加排行榜競爭機制提升持續率
|
||||
- 透過訂正對話功能，確保學習者掌握表達細節
|
||||
- 結合衝榜上癮與對話痛點雙重動機驅動
|
||||
- **完整學習生態系統**：從引導到精熟的67個介面完整體驗
|
||||
- **深度個人化**：7步驟引導流程和詳細學習分析
|
||||
- **多維度評估系統**：語法、流暢度、對話技巧三重評估
|
||||
- **社群競爭機制**：好友系統和排行榜雙重激勵
|
||||
- **專業AI訂正**：即時語法和流暢度改進建議
|
||||
- **商業模式多元**：道具系統和訂閱服務雙軌營收
|
||||
|
||||
## revenue_model
|
||||
**主要營收來源**：
|
||||
1. **訂閱制服務**：月費/年費無限使用進階功能
|
||||
2. **免費增值模式**：基礎功能免費，進階功能付費
|
||||
3. **內容付費**：特殊情境劇本包、專業領域對話包
|
||||
4. **企業客戶**：公司內訓、語言培訓機構合作
|
||||
5. **廣告收入**：免費用戶觀看廣告解鎖功能
|
||||
6. **數據服務**：匿名化學習數據分析服務（TODO：需評估可行性）
|
||||
1. **鑽石貨幣系統**（主要營收機制）：
|
||||
- 新手包：500鑽石 = NT$30（首次購買優惠）
|
||||
- 基礎包：1,200鑽石 = NT$60
|
||||
- 價值包：2,500鑽石 = NT$99（最受歡迎）
|
||||
- 豪華包：5,000鑽石 = NT$190
|
||||
- 至尊包：12,000鑽石 = NT$390
|
||||
2. **道具商店系統**：
|
||||
- 加時道具：300鑽石/個，1,200鑽石/5個裝包
|
||||
- 補命道具：100鑽石/個，400鑽石/5個裝包
|
||||
- 回覆提示道具：30鑽石/個，250鑽石/10個裝包
|
||||
- 時光卷：關卡失敗獲得，可重新挑戰關卡
|
||||
3. **300秒限時挑戰系統**：
|
||||
- 挑戰門票：50鑽石入場費（每日首次免費）
|
||||
- 時間道具：暫停30秒（100鑽石）、加時60秒（150鑽石）
|
||||
4. **簡化訂閱系統**（次要營收）：
|
||||
- 7天免費體驗完整功能
|
||||
- VIP特權：每日3次免費限時挑戰
|
||||
5. **簡化廣告系統**：
|
||||
- 觀看廣告獲得25-50鑽石
|
||||
- 非強制性，獎勵導向
|
||||
6. **企業客戶**：公司內訓、語言培訓機構合作
|
||||
7. **數據服務**：匿名化學習效果分析報告
|
||||
|
||||
## customer_relationship
|
||||
**客戶關係策略**：
|
||||
|
|
@ -76,25 +159,36 @@ Drama Ling 是一款結合情境對話訓練、遊戲化機制和智能詞彙複
|
|||
## cost_structure
|
||||
**成本配置**：
|
||||
1. **技術成本** (40%)：
|
||||
- AI語音識別與分析技術
|
||||
- 雲端服務器維護
|
||||
- 應用程式開發與更新
|
||||
- AI語音識別與對話分析技術
|
||||
- 雲端服務器維護和扩容
|
||||
- 鑽石貨幣系統和支付整合
|
||||
- 即時排行榜和競技系統
|
||||
- 數據存儲與處理
|
||||
- 300秒限時挑戰系統
|
||||
|
||||
2. **內容製作** (25%)：
|
||||
- 劇本編寫與情境設計
|
||||
- 13階段學習架構劇本編寫
|
||||
- 多語言配音與錄製
|
||||
- 情境對話場景設計
|
||||
- 教學內容品質控制
|
||||
- 回覆輔助系統內容開發
|
||||
|
||||
3. **行銷推廣** (20%)：
|
||||
- 數位行銷投放
|
||||
- 數位行銷投放（專注付費轉換）
|
||||
- KOL合作與內容行銷
|
||||
- 用戶獲取成本
|
||||
- 用戶獲取成本（CAC）
|
||||
- 遊戲化體驗行銷
|
||||
|
||||
4. **營運維護** (15%)：
|
||||
- 人力資源
|
||||
- 客戶服務
|
||||
- 辦公室租賃等固定成本
|
||||
- 道具平衡性調整和維護
|
||||
|
||||
**特殊成本考量**：
|
||||
- **用戶獲取成本**：重點在付費轉換而非免費用戶量
|
||||
- **道具平衡成本**：持續監控遊戲經濟平衡
|
||||
- **技術歠務**：需考量AI技術授權和第三方服務費用
|
||||
|
||||
## key_partnership
|
||||
**關鍵合作夥伴**：
|
||||
|
|
@ -128,14 +222,16 @@ Drama Ling 是一款結合情境對話訓練、遊戲化機制和智能詞彙複
|
|||
|
||||
| 競爭對手 | 我們的優勢 |
|
||||
|---------|-----------|
|
||||
| **出國留學** | 成本更低、風險更小、彈性更高，但保持實戰情境練習 |
|
||||
| **Duolingo** | 更進階的實戰對話訓練，不僅限於基礎入門 |
|
||||
| **Speak AI** | 增加遊戲化競爭機制，提升持續學習動機 |
|
||||
| **出國留學** | 67個介面完整學習系統，成本更低但體驗更系統化 |
|
||||
| **Duolingo** | 深度對話訓練和AI即時訂正，超越基礎遊戲化 |
|
||||
| **Speak AI** | 完整社群競爭和好友系統，增強持續學習動機 |
|
||||
| **HelloTalk** | 結構化學習進程和專業評估系統，不僅是聊天 |
|
||||
|
||||
**核心差異化**：
|
||||
- 唯一結合「衝榜競爭」與「意圖對話訓練」的產品
|
||||
- 填補遊戲化入門工具與純AI練習之間的市場空白
|
||||
- 針對中級學習者提供更有效的進階方案
|
||||
- **唯一的完整生態系統**：從引導到精熟67個介面一條龍體驗
|
||||
- **三維度評估創新**：語法+流暢度+對話技巧全方位分析
|
||||
- **深度個人化引導**：7步驟設定流程打造專屬學習路徑
|
||||
- **社群競爭機制**：好友排行榜和道具系統雙重激勵
|
||||
|
||||
## retention_mechanism
|
||||
**留存策略設計**：
|
||||
|
|
@ -162,10 +258,15 @@ Drama Ling 是一款結合情境對話訓練、遊戲化機制和智能詞彙複
|
|||
- 用戶自評溝通信心度
|
||||
|
||||
**商業指標**：
|
||||
- 付費轉換率
|
||||
- ARPU (平均用戶收入)
|
||||
- CAC (用戶獲取成本)
|
||||
- 首次付費轉換率（目標：新用戶30日冒15-20%）
|
||||
- 鑽石購買頁次購買率（重購率）
|
||||
- ARPPU (平均付費用戶收入)
|
||||
- CAC (付費用戶獲取成本)
|
||||
- LTV (用戶生命週期價值)
|
||||
- 每日活躍付費用戶數 (DAPU)
|
||||
- 道具使用率和購買轉換率
|
||||
- 300秒限時挑戰參與率和重購率
|
||||
- 7天免費體驗轉換率（輔助指標）
|
||||
|
||||
**產品指標**：
|
||||
- App Store評分與評論
|
||||
|
|
@ -194,10 +295,20 @@ Drama Ling 是一款結合情境對話訓練、遊戲化機制和智能詞彙複
|
|||
## user_growth
|
||||
**用戶成長策略**：
|
||||
|
||||
**付費轉換漏斗優化**：
|
||||
- 無縫的鑽石首次購買體驗
|
||||
- 漸進式需求：30鑽石回覆提示→100鑽石補命→300鑽石加時
|
||||
- 第一次付費通常為最低價道具（30鑽石回覆提示）
|
||||
|
||||
**7天免費體驗**：
|
||||
- 體驗期可使用部分核心功能
|
||||
- 個人化學習路徑快速建立
|
||||
- 體驗結束前主動轉換提醒
|
||||
|
||||
**病毒式增長**：
|
||||
- 邀請好友獲得學習加速道具
|
||||
- 邀請好友獲得鑽石獎勵
|
||||
- 學習成果社群分享功能
|
||||
- 挑戰好友對話比賽
|
||||
- 挑戰好友300秒限時對話比賽
|
||||
|
||||
**內容行銷**：
|
||||
- 學習技巧部落格文章
|
||||
|
|
@ -210,11 +321,11 @@ Drama Ling 是一款結合情境對話訓練、遊戲化機制和智能詞彙複
|
|||
- 大學語言中心合作計畫
|
||||
|
||||
**產品驅動增長**：
|
||||
- 免費試用期體驗優化
|
||||
- 訂閱用戶留存率優化
|
||||
- 學習成效展示與分享
|
||||
- 推薦系統精準度提升
|
||||
|
||||
**付費推廣**：
|
||||
- Facebook/Google精準廣告投放
|
||||
- Facebook/Google精準廣告投放（專注付費轉換）
|
||||
- App Store搜尋優化(ASO)
|
||||
- 線下教育展會參與
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,356 @@
|
|||
情境對話 - 功能概述
|
||||
情境對話 - 功能概述
|
||||
整體流程：
|
||||
1. 進入劇本
|
||||
2. 跑開場對話了解劇情背景
|
||||
3. 查看通關條件
|
||||
1. 劇情任務
|
||||
2. 指定詞彙
|
||||
4. 開始對話
|
||||
1. 限時300秒
|
||||
2. 使用者開始扮演角色和AI角色對話想辦法完成任務和提及指定詞彙
|
||||
3. 當使用者提及詞彙或完成某個任務時，要立即回饋使用者成功通知
|
||||
|
||||
4. 對話時，用戶可以使用輔助功能
|
||||
1. 回覆協助功能(需要消耗寶石)協助通關
|
||||
2. 劇情任務範例
|
||||
3. 指定詞彙範例
|
||||
5. 時間到或是點擊系統訊息中的「結算表現」即結算劇本分數
|
||||
開場對話
|
||||
開場對話
|
||||
功能描述：
|
||||
使用者點擊劇本後，即進入對話室，並逐一顯示4-8句開場對話(效果參考Figma prototype)，幫助使用者進入劇情，開場對話結束，使用者即可與劇情中的角色對話
|
||||
|
||||
|
||||
畫面規格：
|
||||
|
||||
|
||||
|
||||
|
||||
________________
|
||||
欄位說明：
|
||||
離開劇本：
|
||||
操作：點擊後彈跳出警告視窗時，點擊「繼續努力」則關閉視窗，點擊「退出」則導航回「闖關學習」
|
||||
警告視窗圖示
|
||||
|
||||
|
||||
劇本名稱、場景描述：不可選取
|
||||
角色對話(用戶扮演)
|
||||
1. 圖示
|
||||
2. 類型：文字
|
||||
3. 操作：角色名稱可複製、角色英文對話可複製，角色中譯對話可複製
|
||||
4. 特殊說明
|
||||
* 角色中譯對話，只有於開場對話才顯示，開始對話後，由用戶自行說出的話顯示角色中譯對話
|
||||
* 角色中譯對話，預設是不顯示，需於「對話功能欄」點選中譯按鈕，才會顯示
|
||||
開場對話功能欄
|
||||
1. 圖示
|
||||
|
||||
2. 類型：按鈕
|
||||
3. 說明
|
||||
1. 播放按鈕：點擊後即播放英文對話
|
||||
2. 中譯按鈕：點擊後顯示中譯對話，再次點擊時隱藏中譯對話
|
||||
3. 儲存對話按鈕：點擊後儲存對話
|
||||
4. 檢舉按鈕：
|
||||
1. 點擊後，彈出問題回報視窗，視窗有5個選項，分別為無意義、重複、不當或冒犯的內容、其他、取消
|
||||
2. 若使用者選擇取消，則關閉回報視窗
|
||||
3. 若使用者選擇任一回報選項，則回報問題至後端，並關閉回報視窗
|
||||
進行對話
|
||||
進行對話
|
||||
功能規格：
|
||||
* 看完6句開場對話，已初步了解劇情，接著再藉由查看通關條件，了解在本次對話當中需完成指定任務和需提及詞彙，時間限制300秒
|
||||
* 對話方式以語音輸入(後台轉文字)為主，文字輸入為輔
|
||||
* 使用者說出來的話(AI說的不需要判斷)，都會進行以下判斷
|
||||
1. 判斷語法正確與否，並顯示於對話功能欄
|
||||
2. 判斷是否有完成任務
|
||||
3. 判斷是否有提及指定詞彙
|
||||
畫面規格：
|
||||
|
||||
|
||||
________________
|
||||
特殊欄位說明：
|
||||
離開劇本：參照「情境對話 - 開場對話」
|
||||
通關條件：
|
||||
1. 圖示：
|
||||
|
||||
|
||||
2. 操作：
|
||||
* 點擊後彈出視窗，有三個分類：劇情任務、指定詞彙、劇情角色
|
||||
* 個別規格請參照個別文件分頁
|
||||
|
||||
|
||||
文字輸入
|
||||
1. 點擊後顯示文字輸入視窗，如下圖
|
||||
說話按鈕
|
||||
1. 圖示
|
||||
|
||||
2. 操作：點擊後即開始錄製語音，再次點擊，即可送出語音，操作畫面流程請參考figma prototype
|
||||
3. 備註
|
||||
1. 當用戶講中文或是輸入中文時，角色應該表示聽不懂
|
||||
2. 如果聽不到聲音，則顯示：抱歉，好像沒有聲音，請重新錄製於系統提示
|
||||
|
||||
|
||||
|
||||
|
||||
通關協助：參照「情境對話 - 通關協助」
|
||||
用戶訊息＆用戶對話功能列
|
||||
1. 用戶訊息 = 用戶扮演角色 + 用戶英文
|
||||
2. 用戶對話功能列
|
||||
1. 第一個按鈕為語法檢查，正確為橘色驚嘆號，錯誤為藍色勾，如下圖
|
||||
|
||||
2. 其他按鈕說明參照
|
||||
劇情任務
|
||||
劇情任務
|
||||
功能說明
|
||||
必須在300秒內，在與劇中角色對話時，完成全部劇情任務，才能通關
|
||||
畫面規格
|
||||
|
||||
|
||||
________________
|
||||
欄位說明
|
||||
|
||||
|
||||
欄位
|
||||
類型
|
||||
圖示
|
||||
操作
|
||||
說明
|
||||
通關條件選單
|
||||
選單
|
||||
|
||||
|
||||
點擊之後可以導航到其他選單
|
||||
|
||||
|
||||
任務狀態
|
||||
|
||||
|
||||
|
||||
|
||||
無法藉由點擊改變狀態，狀態改變是於每次使用者對話後，系統判定是否完成任務
|
||||
當任務為完成狀態時，顯示完成圖標，反之顯示未完成圖標，狀態無法點擊
|
||||
任務描述
|
||||
文字
|
||||
|
||||
|
||||
不可複製
|
||||
|
||||
|
||||
任務提示
|
||||
按鈕
|
||||
|
||||
|
||||
點擊後，顯示一句範例，這樣說可以完成任務
|
||||
當任務已經完成時，不會顯示這個按鈕
|
||||
指定詞彙
|
||||
指定詞彙
|
||||
功能說明
|
||||
必須在300秒內，在與劇中角色對話時，正確提及指定詞彙，才能通關
|
||||
畫面規格可參考「情境對話 - 劇情任務」
|
||||
畫面規格
|
||||
|
||||
|
||||
劇情角色
|
||||
劇情角色
|
||||
功能描述
|
||||
藉由此頁面了解劇情角色有哪些及各角色詳細說明
|
||||
畫面規格
|
||||
|
||||
|
||||
回覆協助
|
||||
回覆協助
|
||||
功能說明
|
||||
主要是當用戶在扮演角色遇到卡關，不知道該講什麼時，或是不知道怎麼講時，給予協助
|
||||
畫面規格
|
||||
|
||||
|
||||
|
||||
|
||||
欄位說明
|
||||
回覆引導
|
||||
根據對話室中最後一句話生成回覆引導，引導內容包含
|
||||
1. 對方意圖：分析對方說這句話的意圖
|
||||
2. 回應思緒：分析用戶聽到這句話的反應及可能可以怎麼回覆
|
||||
3. 回覆範例：生成一句回覆的範例
|
||||
中翻英
|
||||
直接將使用者的中文以google翻譯，轉譯成英文
|
||||
關卡結算
|
||||
關卡表現
|
||||
功能說明
|
||||
當劇本時間用完或用戶主動點選離開劇本時，則立即結算表現並宣告結果，結果有過關與失敗，詳細流程如下：
|
||||
過關判斷
|
||||
是否任務都有完成
|
||||
是否指定詞彙都有提及
|
||||
表現計算
|
||||
評分標準如下
|
||||
1. 對話語意合適分數 > 60 (滿分100)
|
||||
1. 根據上下文一致性、語境適應性、意圖匹配，進行評分
|
||||
2. 語法錯誤率 = 0
|
||||
1. 用戶說的每句話經過語法判定都正確或者訂正後都正確亦可
|
||||
3. 表達流暢平均分數 > 60 (滿分100)
|
||||
1. 用戶說的每句話都會有分數，所有分數平均即為表達流暢平均分數
|
||||
以上每合格一項獲得一顆星
|
||||
宣告過關與否
|
||||
1. 過關流程
|
||||
1. 恭喜過關
|
||||
2. 表現結算
|
||||
3. 是否訂正錯誤
|
||||
1. 如果點擊立即訂正，則跑訂正流程(語法錯誤&表達不順)，訂正完成再回來繼續領獎，此時獎勵是訂正後的獎勵，訂正後的獎勵規則參照
|
||||
2. 如果點擊不訂正，則直接領獎
|
||||
4. 領取通關獎勵
|
||||
2. 失敗流程
|
||||
1. 宣告失敗
|
||||
2. 領取安慰獎
|
||||
|
||||
|
||||
獎勵
|
||||
* 闖關成功
|
||||
* 獲得金幣
|
||||
* 獲得經驗值
|
||||
* 闖關失敗
|
||||
* 獲得時光卷一張
|
||||
|
||||
|
||||
________________
|
||||
畫面規格
|
||||
|
||||
|
||||
|
||||
|
||||
語法錯誤訂正
|
||||
語法錯誤訂正
|
||||
功能說明
|
||||
用戶在情境對話過程中，說的每一句話都會立即判定語法正確與否，結算表現時，當用戶點選立即訂正，系統會將所有該劇本對話時語法錯誤的句子，依序讓用戶進行訂正
|
||||
畫面規格
|
||||
|
||||
|
||||
欄位說明
|
||||
進度條
|
||||
1. 分子 = 訂正的次數
|
||||
1. 每當嘗試一次，不管正確與否，訂正次數都增加
|
||||
2. 分母 = 語法錯誤句數 + 表達不順句數
|
||||
練習按鈕
|
||||
點擊後，即播放說話動畫，再次點擊則送出錄音，檢查完成後，回饋結果正確或錯誤(如下圖)
|
||||
|
||||
|
||||
表達不順訂正
|
||||
表達不順訂正
|
||||
功能說明
|
||||
用戶在情境對話過程中，當用戶是語音輸入，就會針對精準度、流利度、韻律進行評分，結算表現時，當用戶點選立即訂正，系統會將所有該劇本對話時表達不順的句子，依序讓用戶進行訂正
|
||||
畫面規格
|
||||
|
||||
|
||||
欄位說明
|
||||
進度條
|
||||
1. 分子 = 訂正的次數
|
||||
1. 每當嘗試一次，不管正確與否，訂正次數都增加
|
||||
2. 分母 = 語法錯誤句數 + 表達不順句數
|
||||
練習按鈕
|
||||
點擊後，即播放說話動畫，再次點擊則送出錄音，檢查完成後，回饋結果正確或錯誤(如下圖)
|
||||
|
||||
|
||||
附件1：資料來源清單
|
||||
資料來源清單
|
||||
|
||||
|
||||
項目
|
||||
來源
|
||||
生成時機
|
||||
開場對話(含場景描述)
|
||||
資料庫
|
||||
事前手動生成
|
||||
任務(中文、範例、範例翻譯)
|
||||
資料庫
|
||||
事前手動生成
|
||||
詞彙(含翻譯、圖片、題庫、等)
|
||||
資料庫
|
||||
事前手動生成
|
||||
劇情大綱
|
||||
資料庫
|
||||
事前手動生成
|
||||
AI角色對話
|
||||
AI生成
|
||||
關卡進行當下生成
|
||||
用戶對話
|
||||
語音轉文字
|
||||
再存到資料庫
|
||||
關卡進行當下生成
|
||||
關卡經驗值獎勵
|
||||
資料庫
|
||||
數目事前設定
|
||||
關卡寶石獎勵
|
||||
資料庫
|
||||
數目事前設定
|
||||
關卡訂正後的寶石獎勵
|
||||
資料庫
|
||||
數目事前設定
|
||||
對話翻譯
|
||||
google翻譯
|
||||
關卡進行當下生成
|
||||
表達流暢度分析(APP先打第三方平台分析)
|
||||
1. 精準度
|
||||
2. 流利度
|
||||
3. 韻律
|
||||
speakace
|
||||
關卡進行當下生成
|
||||
語法錯誤評估
|
||||
AI生成
|
||||
關卡進行當下生成
|
||||
語意合適度評估
|
||||
AI生成
|
||||
關卡進行當下生成
|
||||
任務完成評估
|
||||
AI生成
|
||||
關卡進行當下生成
|
||||
提及詞彙判斷
|
||||
資料庫
|
||||
儲存時會提供詞彙所有型態以供模糊比對
|
||||
例如 eat ate eats eaten
|
||||
每次對話結束用模糊比對
|
||||
對話儲存
|
||||
資料庫
|
||||
|
||||
|
||||
回覆引導
|
||||
AI生成
|
||||
關卡進行當下生成
|
||||
|
||||
|
||||
附件2：劇情範例
|
||||
劇本範例
|
||||
劇本名稱
|
||||
午餐吃什麼
|
||||
劇情大綱
|
||||
兩位朋友在公園長椅上討論午餐選擇。Alex想吃較重口味的食物，而Jamie偏好清淡餐點。他們各自提出不同選擇，並透過討論與妥協，最終Alex需要決定一個能滿足彼此需求的午餐方案。
|
||||
開場對話
|
||||
* 場景
|
||||
* Two friends sit on a park bench under a shady tree. They both hold their phones, browsing restaurant options and debating what to eat for lunch. The sound of birds chirping and children playing fills the background.
|
||||
* 兩位朋友坐在樹蔭下的公園長椅上，他們手裡拿著手機，瀏覽餐廳選項，討論午餐吃什麼。背景中傳來鳥鳴聲和孩子們玩耍的聲音。
|
||||
* 對話 (用戶扮演Alex)
|
||||
* Alex: “Jamie, I can’t decide! What do you feel like eating?”
|
||||
Alex：「Jamie，我不知道該選什麼！你想吃什麼？」
|
||||
* Jamie: “I’m not sure either. Maybe something light, like salad?”
|
||||
Jamie：「我也不確定，也許吃點清淡的，比如沙拉？」
|
||||
* Alex: “Salad? That’s so boring. How about burgers?”
|
||||
Alex：「沙拉？那也太無聊了吧。吃漢堡怎麼樣？」
|
||||
* Jamie: “Burgers are heavy, and we had them last week!”
|
||||
Jamie：「漢堡太油膩了，而且我們上週才吃過！」
|
||||
任務
|
||||
1. 說服 Jamie 吃自己喜歡的食物，並舉出理由（如口味、方便或氣氛）。
|
||||
1. My friend recommended this place too, said it's the best [food name] they've ever had.
|
||||
2. (我朋友也超推薦這家，說是他吃過最好吃的 [食物名稱]。)
|
||||
2. 在一句表達中，提出至少2種食物選擇，並根據 Jamie 的意見進行妥協。
|
||||
1. I'm thinking either Thai food or burgers tonight, but I'm open to other suggestions. What are you in the mood for?
|
||||
2. 我今晚想吃泰國菜或漢堡，但我也願意聽聽其他建議。你今天想吃什麼？
|
||||
|
||||
|
||||
指定詞彙
|
||||
* Decide：決定
|
||||
* a) deceive b) besides c) decided d) disease
|
||||
* Light：清淡的
|
||||
* a) right b) fight c) sight d) slight
|
||||
* Compromise：折衷
|
||||
* a) comprise b) promise c) surprise d) demise
|
||||
* How about：⋯⋯怎麼樣？
|
||||
* a) what about b) who about c) where about d) which about
|
||||
* Can’t decide：拿不定主意
|
||||
* a) can decide b) will decide c) may decide d) unable to decide
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 54 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 64 KiB |
File diff suppressed because one or more lines are too long
|
|
@ -0,0 +1,6 @@
|
|||
以下有一些要修正
|
||||
1. 收費平台不用stripe或任何第三方支付，應該是直接使用雙平台各自的內購
|
||||
2. 我只會先在台灣開放，所以支援台幣就好
|
||||
3. 對話生成相關 api 使用gpt-4o-mini為主
|
||||
4. 語言評估使用microsoft相關的api
|
||||
5. stt和tts使用google
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 110 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 49 KiB |
File diff suppressed because one or more lines are too long
|
|
@ -0,0 +1,87 @@
|
|||
功能概述
|
||||
詞彙學習關卡 - 功能概述
|
||||
功能說明
|
||||
* 每一個劇本都會根據劇情設計5個常用詞彙(3個單字、1個片語、1個俚語)
|
||||
* 在開始進入對話之前，會有兩個關卡幫助預先熟悉這5個詞彙，分別為「詞彙認識」、「詞彙熟悉」
|
||||
* 闖關開始時會檢查命條 是否大於1
|
||||
* 詞彙認識關答錯就-1，詞彙熟悉關答錯就-1，對話訓練通關失敗就-1
|
||||
* 反之命條歸零時，即闖關失敗，參考「闖關成功或失敗」
|
||||
* 答錯的題目要在最後一題再問一次，直到所有題都答對為止
|
||||
* 「詞彙認識」和「詞彙熟悉」關卡，只要通關就直接給三顆星
|
||||
整體流程：
|
||||
1. 在「闖關學習」頁面選取「詞彙認識」關卡
|
||||
2. 玩「詞彙認識」關卡，依序把這5個詞彙跑完以下流程
|
||||
1. 詞彙展示
|
||||
2. 詞彙選擇題
|
||||
3. 回到「闖關學習」頁面，開始玩下一關，選取「詞彙熟悉」關卡
|
||||
4. 玩「詞彙熟悉」關卡，依序把這5個詞彙跑完以下流程
|
||||
1. 例句重組
|
||||
2. 詞彙配對
|
||||
5. 經歷過以上訓練，對詞彙已有一定程度的熟悉，即開始進入情境對話關卡
|
||||
詞彙認識
|
||||
詞彙認識
|
||||
功能描述：
|
||||
藉由「詞彙展示」「詞彙選擇題」初步認識詞彙
|
||||
在詞彙展示時，嘗試記住詞彙的詞義及例句及示意圖，後續會有考題檢視記憶效果
|
||||
在詞彙選擇題時，選出根據示意圖選出正確的英文詞彙
|
||||
畫面規格：
|
||||
截圖 2025-05-23 凌晨2.57.01.png
|
||||
截圖 2025-05-23 凌晨2.56.56.png
|
||||
詞彙熟悉
|
||||
詞彙熟悉
|
||||
功能描述：
|
||||
藉由「例句重組」「詞彙配對」進一步熟悉詞彙
|
||||
在例句重組時，在從單字選取區點選，組出示意圖的原句
|
||||
在詞彙配對時，左邊是示意圖，右邊是詞彙，嘗試全部配對正確
|
||||
畫面規格：
|
||||
例句重組
|
||||
|
||||
|
||||
詞彙配對
|
||||
|
||||
|
||||
詞彙說明與範例
|
||||
詞彙說明與範例
|
||||
詞彙包含單字、片語、俚語，以下為詞彙的範例
|
||||
|
||||
|
||||
範例1
|
||||
1. 劇本名稱：買菜小冒險
|
||||
2. 常用單字：market, vegetables, price
|
||||
3. 常用片語：ask for a discount（詢問折扣）
|
||||
4. 常用俚語：a steal（超便宜的好東西）
|
||||
範例2
|
||||
1. 劇本名稱：遲到的咖啡約會
|
||||
2. 常用單字：coffee, late, apologize
|
||||
3. 常用片語：run into traffic（遇到交通堵塞）
|
||||
4. 常用俚語：my bad（是我的錯）
|
||||
範例3
|
||||
1. 劇本名稱：失而復得的手機
|
||||
2. 常用單字：phone, lost, find
|
||||
3. 常用片語：look around for（到處找）
|
||||
4. 常用俚語：lucky break（意想不到的好運）
|
||||
|
||||
|
||||
|
||||
|
||||
闖關成功或失敗
|
||||
闖關成功或失敗
|
||||
過關判斷：
|
||||
* 當命條 扣完(歸零)時，即闖關失敗
|
||||
* 答錯題目則命條-1
|
||||
獎勵計算[a]
|
||||
* 闖關成功
|
||||
* 獲得金幣
|
||||
* 獲得經驗值
|
||||
* 闖關失敗
|
||||
* 獲得時光卷一張
|
||||
過關流程
|
||||
|
||||
|
||||
________________
|
||||
失敗流程
|
||||
|
||||
|
||||
|
||||
|
||||
[a]待補充
|
||||
|
|
@ -0,0 +1,33 @@
|
|||
詞彙複習
|
||||
功能概述
|
||||
* 使用者在玩遊戲過程中所學的的詞彙，時間久了就會慢慢忘記，系統以間隔複習的方式協助使用者將詞彙儲存到長期記憶中
|
||||
整體流程
|
||||
1. 點擊開始複習，系統將自動判斷使用者當前哪些詞彙需要複習，整理出一個待複習清單
|
||||
2. 系統將待複習清單以「詞彙熟悉」關卡的形式，讓使用者玩
|
||||
3. 使用者答錯題目時，將該題目複製一份擺到當前最後一題
|
||||
4. 一直答題直到所有題目皆答對為止
|
||||
1. 答題完成後給予使用者複習完成的經驗值
|
||||
5. 當使用者中途離開，要保留使用者的複習紀錄，使用者再次進入時，則繼續上次複習進度
|
||||
1. 中途離開時給予使用者複習完成的經驗值(不包含還沒完成複習的部分)
|
||||
|
||||
|
||||
詞彙複習清單
|
||||
加入
|
||||
1. 只要關卡(詞彙認識、詞彙熟悉、對話訓練)通關，就會把該關卡訂定的詞彙全部加入詞彙複習清單
|
||||
2. 已經加入過的詞彙略過(不重複加入)
|
||||
|
||||
|
||||
當日哪些待複習
|
||||
1. 複習詞彙欄位為下次複習時間若為當日，則為當日複習詞彙
|
||||
2. 當關卡詞彙加入詞彙複習清單，則當日為第一次複習時間，且計算以複習一次
|
||||
3. 下次複習時間 = 當日 + （2^複習次數)
|
||||
4. 範例
|
||||
1. 於3月4日玩了某關卡獲得一個詞彙apple，apple下次複習日期為3/4+2^1=3/6
|
||||
2. 於3月6日複習後，apple下次複習日期為3/6+2^2=3/10
|
||||
5. 未準時複習時
|
||||
1. 本應於3月10日但尚未複習，此時仍應計算為待複習項目
|
||||
2. 若於3月11日複習apple，此時apple下次複習時間應以3/11計算，即3/11+2^3=3/19
|
||||
詞彙收藏
|
||||
詞彙收藏
|
||||
訊息收藏
|
||||
訊息收藏
|
||||
|
|
@ -0,0 +1,98 @@
|
|||
簡述
|
||||
設計理念：最佳體驗＆最佳學習效率
|
||||
1. 適度難度能激起用戶挑戰心與克服之後的成就感
|
||||
2. 適度難度能讓用戶基本功不足需加強
|
||||
3. 適度難度可以讓使用者看到精進方向
|
||||
4. 輔助功能可以協助使用者越級完成挑戰
|
||||
5. 時光關卡引導使用者向前階關卡挑戰，以加強不足的基本功
|
||||
語言程度
|
||||
語言程度介面
|
||||
|
||||
|
||||
|
||||
|
||||
欄位說明
|
||||
1. 晉階按鈕
|
||||
1. 當晉階條件尚未滿足時，晉階按鈕為disable
|
||||
2. 階級介紹：請參照excel表格之欄位-CEFR程度&學習重點
|
||||
|
||||
|
||||
|
||||
|
||||
晉階
|
||||
語言程度 - 晉級設定
|
||||
|
||||
|
||||
簡述
|
||||
總共13階層
|
||||
鼓勵他們往上爬階
|
||||
也鼓勵他們在每一階段學習到一定程度就先往上爬
|
||||
但是往上爬一定會因為程度不夠遇到難關
|
||||
這時候對話輔助功能(如回覆引導)能幫助克服超過程度的關卡
|
||||
然後再以時光關卡的形式引導用戶複習前階關卡，以補足基本功
|
||||
|
||||
|
||||
晉階條件：
|
||||
當階與前階需累積指定次數之對話訓練關卡「滿星分數」
|
||||
|
||||
語言分級與聽說讀寫測驗次數對照表
|
||||
1 級 (A1)
|
||||
|
||||
前階： x
|
||||
|
||||
後階： 10 次
|
||||
|
||||
2-3 級 (A2)
|
||||
|
||||
前階： 15 次
|
||||
|
||||
後階： 10 次
|
||||
|
||||
4-6 級 (B1)
|
||||
|
||||
前階： 15 次
|
||||
|
||||
後階： 10 次
|
||||
|
||||
7-8 級 (B2)
|
||||
|
||||
前階： 15 次
|
||||
|
||||
後階： 10 次
|
||||
|
||||
9-11 級 (C1)
|
||||
|
||||
前階： 15 次
|
||||
|
||||
後階： 10 次
|
||||
|
||||
12 級 (C2)
|
||||
|
||||
前階： 15 次
|
||||
|
||||
後階： 10 次
|
||||
|
||||
13 最高級 (C2)
|
||||
|
||||
前階： (此處無詳細資訊，可能與 C2 級相同或另有規定)
|
||||
|
||||
後階： (此處無詳細資訊，可能與 C2 級相同或另有規定)
|
||||
|
||||
|
||||
|
||||
|
||||
語言表現數據
|
||||
語言表現數據(非本階段工程，不用理會)
|
||||
1. 當前階段
|
||||
1. 會告訴使用者每階段的學習目標
|
||||
2. 儀表板
|
||||
1. 語意合適度
|
||||
3. 數據
|
||||
1. 篩選
|
||||
1. 階段
|
||||
2. 全部
|
||||
2. 數據項目
|
||||
1. 語意合適度
|
||||
2. 語法錯誤率
|
||||
3. 表達流暢度
|
||||
4. 詞彙分數
|
||||
|
|
@ -0,0 +1,80 @@
|
|||
功能概述
|
||||
闖關學習 - 功能概述
|
||||
功能說明
|
||||
* 依序闖關，在闖關中進行學習
|
||||
主流程
|
||||
1. 選擇關卡，視窗往下滑，滑過下一個關卡時，上方關卡資訊要更新
|
||||
2. 點擊關卡，顯示關卡資訊
|
||||
3. 進入關卡
|
||||
4. 結束後返回闖關學習頁面
|
||||
|
||||
|
||||
闖關學習介面
|
||||
闖關學習介面
|
||||
|
||||
|
||||
欄位說明
|
||||
1. 語言程度
|
||||
2. 金幣
|
||||
3. 關卡命條
|
||||
1. 闖關開始時會檢查命條是否大於1
|
||||
2. 命條上限為5，新用戶預設為5
|
||||
3. 獲得：每5小時獲得1個
|
||||
4. 損失
|
||||
1. 詞彙認識關答錯就-1
|
||||
2. 詞彙熟悉關答錯就-1
|
||||
3. 對話訓練通關失敗就-1
|
||||
4. 連續學習天數
|
||||
5. 關卡資訊
|
||||
6. 通關分數
|
||||
7. 劇本標題
|
||||
8. 時光關卡
|
||||
|
||||
|
||||
流程說明
|
||||
1. 闖關必須要按照關卡順序進行，不可跳關
|
||||
2. 當玩過該關卡後，即使分數為零顆星，只要成功通關，依然會解鎖下一關
|
||||
|
||||
|
||||
|
||||
|
||||
補充成功通關
|
||||
* 「詞彙認識」和「詞彙熟悉」關卡，只要通關就直接給三顆星，而這兩種關卡的通關條件是答題都要正確，答錯扣命，直到答對為止
|
||||
* 情境對話通關條件參考
|
||||
|
||||
|
||||
連續學習天數
|
||||
|
||||
|
||||
關卡與教材設計
|
||||
|
||||
|
||||
教材參考連結如下
|
||||
https://docs.google.com/spreadsheets/d/1HiiqBKFF3cw73TNaCb0Xf3fTmg8Wefi5qVEVrXIyYqo/edit?usp=sharing
|
||||
|
||||
|
||||
資料層級與關係
|
||||
1. 階層關係為：第x階段 > 第x劇本 > 某某關卡
|
||||
2. 目前預計共有 13 個階段
|
||||
3. 每一階段會有20個以上的劇本(還會持續增加)
|
||||
4. 每一個劇本都固定有三種關卡(詞彙認識、詞彙熟悉、對話訓練)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
時光關卡
|
||||
時光關卡
|
||||
依照順序挑選前階未玩過對話訓練關卡，若都玩過則隨機挑選，點選「我要挑戰」，則消耗一張時光卷
|
||||
|
||||
|
||||
前階定義
|
||||
|
||||
|
||||
成功通關一樣會將該關卡之詞彙加入詞彙複習
|
||||
關卡命條
|
||||
關卡命條
|
||||
|
||||
|
||||
錢不夠時，按鈕為disable
|
||||
|
|
@ -0,0 +1,371 @@
|
|||
# AI 對話分析算法規格
|
||||
|
||||
## 概述
|
||||
定義 Drama Ling 應用中 AI 對話分析系統的具體實現方案，包含語法、語意、流暢度三維度評分邏輯。
|
||||
|
||||
## 核心評分維度
|
||||
|
||||
基於 UI_LevelResult_ScoreSummary.png 的實際設計，採用簡化的三維評分顯示：
|
||||
|
||||
### 簡化評分系統
|
||||
**目標**: 提供清楚的學習反饋，觸發對應成就獎勵
|
||||
|
||||
#### 三項評分指標
|
||||
- [ ] **語法評分**: 評估語法正確性
|
||||
- 達到優秀標準時觸發「完美語法」成就
|
||||
- 獎勵: +10 鑽石 + 10 閃電能量
|
||||
|
||||
- [ ] **語意評分**: 評估內容理解和表達適切性
|
||||
- 作為整體表現參考
|
||||
- 不單獨觸發特定成就
|
||||
|
||||
- [ ] **流暢度評分**: 評估表達的自然度和流暢性
|
||||
- 達到優秀標準時觸發「表達流利」成就
|
||||
- 獎勵: +10 鑽石 + 10 閃電能量
|
||||
|
||||
#### 技術實現方案
|
||||
- [ ] **AI 模型選擇**: 待決定 (GPT-4/Claude/自建模型)
|
||||
- [ ] **評分閾值設定**: 定義「優秀」標準的具體分數
|
||||
- [ ] **即時分析**: 目標響應時間 < 2秒
|
||||
- [ ] **成就觸發機制**: 自動檢測並發放對應獎勵
|
||||
|
||||
## AI 對話分析功能
|
||||
|
||||
### 即時分析機制 *(更新基於最新規格)*
|
||||
基於最新規格的詳細分析系統：
|
||||
|
||||
- [ ] **每句話即時分析**: 用戶說出的每句話都進行即時判斷
|
||||
- 語法正確性分析（即時顯示於對話功能欄）
|
||||
- 任務完成狀態檢測
|
||||
- 指定詞彙使用檢測
|
||||
- [ ] **即時成功通知**: 當用戶提及詞彙或完成任務時立即回饋
|
||||
- [ ] **三維度結算評分**: 對話結束後的綜合評分
|
||||
- 對話語意合適分數（滿分100，>60為合格）
|
||||
- 語法錯誤率（必須=0，所有句子都正確或訂正後正確）
|
||||
- 表達流暢平均分數（滿分100，>60為合格）
|
||||
|
||||
## 情境對話核心系統
|
||||
|
||||
### 雙重通關條件檢測 *(新增核心功能)*
|
||||
基於最新規格的結構化通關機制：
|
||||
|
||||
#### 劇情任務識別系統
|
||||
- [ ] **任務目標解析**:
|
||||
- 解析每個劇本的具體劇情任務要求
|
||||
- 識別對話中的關鍵情節完成點
|
||||
- 例如："預約餐廳" → 檢測是否包含預約相關對話元素
|
||||
|
||||
- [ ] **任務進度追蹤**:
|
||||
- 即時監控劇情任務的完成狀態
|
||||
- 分析用戶對話是否達成情節目標
|
||||
- 觸發即時成功通知機制
|
||||
|
||||
- [ ] **情節完整性驗證**:
|
||||
- 確保對話內容符合劇情邏輯
|
||||
- 檢驗任務完成的合理性和連貫性
|
||||
- 防止虛假完成的判定
|
||||
|
||||
#### 指定詞彙檢測系統
|
||||
- [ ] **詞彙識別引擎**:
|
||||
- 精準識別用戶是否使用指定的關鍵詞彙
|
||||
- 支援詞彙的不同變化形式（單複數、時態等）
|
||||
- 處理同義詞和相關變體的檢測
|
||||
|
||||
- [ ] **語境相關性分析**:
|
||||
- 確保詞彙使用符合對話情境
|
||||
- 避免機械性插入詞彙的誤判
|
||||
- 驗證詞彙使用的自然度和適當性
|
||||
|
||||
- [ ] **即時反饋機制**:
|
||||
- 使用詞彙時立即觸發成功通知
|
||||
- 提供詞彙使用品質的評分
|
||||
- 記錄詞彙掌握程度的學習數據
|
||||
|
||||
### 回覆卡關輔助系統 *(更新基於最新規格)*
|
||||
|
||||
#### 回覆協助功能 (消耗寶石)
|
||||
**觸發時機**: 用戶在扮演角色遇到卡關，不知道該講什麼或怎麼講時
|
||||
|
||||
**三層引導內容**:
|
||||
- [ ] **對方意圖分析**: 根據對話室中最後一句話，分析對方說這句話的意圖
|
||||
- [ ] **回應思緒引導**: 分析用戶聽到這句話的反應及可能的回覆方向
|
||||
- [ ] **回覆範例生成**: 生成一句具體的回覆範例
|
||||
|
||||
#### 免費輔助工具
|
||||
- [ ] **劇情任務範例**:
|
||||
- 點擊任務提示按鈕後顯示一句範例
|
||||
- 說明「這樣說可以完成任務」
|
||||
- 當任務已完成時不顯示此按鈕
|
||||
- 完全免費，不消耗任何道具
|
||||
|
||||
- [ ] **指定詞彙範例**:
|
||||
- 展示指定詞彙的正確使用方式
|
||||
- 提供詞彙在不同語境下的使用示例
|
||||
- 包含詞彙變化形式的學習支援
|
||||
|
||||
### 中翻英輔助功能 *(更新基於最新規格)*
|
||||
- [ ] **Google翻譯整合**: 直接將使用者的中文以Google翻譯轉譯成英文
|
||||
- [ ] **即時翻譯服務**: 在對話過程中提供即時的中翻英支援
|
||||
- [ ] **翻譯品質優化**: 針對對話情境調整翻譯結果的適切性
|
||||
- [ ] **學習引導**: 協助用戶從依賴翻譯逐步過渡到獨立表達
|
||||
|
||||
### 語音處理系統 *(新增基於最新規格)*
|
||||
- [ ] **語音轉文字**: 以語音輸入為主，文字輸入為輔的對話方式
|
||||
- [ ] **中文檢測**: 當用戶講中文或輸入中文時，角色表示聽不懂
|
||||
- [ ] **語音品質檢測**: 如果聽不到聲音，顯示「抱歉，好像沒有聲音，請重新錄製」
|
||||
- [ ] **表達流暢度分析**: 使用Speakace等第三方平台分析精準度、流利度、韻律
|
||||
|
||||
## 詞彙學習系統 *(新增功能模組)*
|
||||
|
||||
### 詞彙學習關卡系統
|
||||
基於最新規格的結構化詞彙學習機制：
|
||||
|
||||
#### 詞彙認識關卡
|
||||
- [ ] **詞彙展示功能**:
|
||||
- 顯示詞彙本身、詞義、例句和示意圖
|
||||
- 協助用戶初步記住詞彙的核心資訊
|
||||
- 為後續考題做準備
|
||||
- [ ] **詞彙選擇題**:
|
||||
- 根據示意圖選出正確的英文詞彙
|
||||
- 4選1的單選題形式
|
||||
- 答錯會扣除命條(-1)並在最後重新測試
|
||||
- [ ] **通關機制**: 所有詞彙題目都答對才算通關，直接獲得三顆星
|
||||
|
||||
#### 詞彙熟悉關卡
|
||||
- [ ] **例句重組功能**:
|
||||
- 從單字選取區點選組出示意圖的原句
|
||||
- 訓練詞彙在語境中的使用能力
|
||||
- 強化語法結構理解
|
||||
- [ ] **詞彙配對功能**:
|
||||
- 左邊示意圖與右邊詞彙進行配對
|
||||
- 全部配對正確才算完成
|
||||
- 提升詞彙識別和記憶連結
|
||||
- [ ] **通關機制**: 所有配對和重組正確才算通關，直接獲得三顆星
|
||||
|
||||
#### 詞彙內容設計標準
|
||||
基於劇本的5詞彙組合設計：
|
||||
- [ ] **詞彙組合**: 每個劇本包含5個詞彙
|
||||
- 3個常用單字
|
||||
- 1個常用片語
|
||||
- 1個常用俚語
|
||||
- [ ] **詞彙範例結構**:
|
||||
- 買菜小冒險: market, vegetables, price + "ask for a discount" + "a steal"
|
||||
- 遲到的咖啡約會: coffee, late, apologize + "run into traffic" + "my bad"
|
||||
- 失而復得的手機: phone, lost, find + "look around for" + "lucky break"
|
||||
|
||||
### 間隔複習系統 *(Spaced Repetition)*
|
||||
基於遺忘曲線的智慧複習機制：
|
||||
|
||||
#### 複習清單管理
|
||||
- [ ] **自動加入機制**:
|
||||
- 詞彙認識、詞彙熟悉、對話訓練通關後自動加入詞彙
|
||||
- 避免重複加入已存在的詞彙
|
||||
- 維護個人化的複習詞彙庫
|
||||
- [ ] **複習時機計算**:
|
||||
- 下次複習時間 = 當日 + (2^複習次數)
|
||||
- 首次加入當日即為第一次複習時間
|
||||
- 例如：3/4學習 → 3/6複習 → 3/10複習 → 3/18複習
|
||||
|
||||
#### 每日複習排程
|
||||
- [ ] **待複習詞彙判定**:
|
||||
- 複習日期為當日或已過期的詞彙
|
||||
- 未準時複習的詞彙持續標記為待複習
|
||||
- 延遲複習時重新計算下次複習時間
|
||||
- [ ] **複習關卡執行**:
|
||||
- 以「詞彙熟悉」關卡形式進行複習
|
||||
- 答錯題目複製到當前最後一題
|
||||
- 直到所有題目都答對才完成複習
|
||||
|
||||
#### 進度保存機制
|
||||
- [ ] **中途離開處理**:
|
||||
- 保留用戶當前複習進度和狀態
|
||||
- 再次進入時繼續上次未完成的複習
|
||||
- 給予已完成部分的經驗值獎勵
|
||||
- [ ] **完成獎勵機制**:
|
||||
- 複習完成後給予經驗值獎勵
|
||||
- 更新詞彙複習次數和下次複習時間
|
||||
- 強化學習動機和持續性
|
||||
|
||||
## 限時對話系統 *(新增功能)*
|
||||
|
||||
### 300秒倒數計時機制
|
||||
基於最新規格的時間管理系統：
|
||||
|
||||
#### 時間控制引擎
|
||||
- [ ] **精準計時系統**:
|
||||
- 300秒（5分鐘）的精確倒數計時
|
||||
- 支援暫停和恢復功能（特殊情況下）
|
||||
- 時間剩餘的視覺化顯示
|
||||
|
||||
- [ ] **時間壓力分析**:
|
||||
- 分析時間壓力對用戶表現的影響
|
||||
- 記錄不同時間段的對話品質變化
|
||||
- 優化時間分配的學習建議
|
||||
|
||||
- [ ] **結算觸發機制**:
|
||||
- 時間歸零自動觸發結算
|
||||
- 支援用戶主動點擊「結算表現」
|
||||
- 確保數據完整保存和分析
|
||||
|
||||
#### 時間效率優化
|
||||
- [ ] **進度加權評分**:
|
||||
- 基於完成時間給予額外評分
|
||||
- 鼓勵高效但準確的對話完成
|
||||
- 平衡速度與品質的評分機制
|
||||
|
||||
- [ ] **時間管理指導**:
|
||||
- 提供時間分配的策略建議
|
||||
- 分析用戶的時間使用模式
|
||||
- 協助提升對話效率
|
||||
|
||||
## 關卡結算與訂正系統 *(新增基於最新規格)*
|
||||
|
||||
### 關卡表現結算
|
||||
**觸發時機**: 當劇本時間用完或用戶主動點選離開劇本時
|
||||
|
||||
#### 過關判斷標準
|
||||
- [ ] **雙重完成檢查**:
|
||||
- 是否所有任務都已完成
|
||||
- 是否所有指定詞彙都已提及
|
||||
|
||||
#### 表現評分系統
|
||||
- [ ] **評分標準** (每合格一項獲得一顆星):
|
||||
1. **對話語意合適分數 > 60** (滿分100)
|
||||
- 根據上下文一致性進行評分
|
||||
- 語境適應性評估
|
||||
- 意圖匹配度分析
|
||||
2. **語法錯誤率 = 0**
|
||||
- 用戶說的每句話經過語法判定都正確
|
||||
- 或者訂正後都正確亦可
|
||||
3. **表達流暢平均分數 > 60** (滿分100)
|
||||
- 用戶說的每句話都會有流暢度分數
|
||||
- 所有分數平均即為表達流暢平均分數
|
||||
|
||||
### 結算流程系統
|
||||
#### 過關流程
|
||||
- [ ] **成功宣告**: 恭喜過關訊息
|
||||
- [ ] **表現結算**: 顯示詳細評分和星級
|
||||
- [ ] **訂正選擇**:
|
||||
- 如果點擊「立即訂正」→ 執行訂正流程 → 完成後領取訂正後獎勵
|
||||
- 如果點擊「不訂正」→ 直接領獎
|
||||
- [ ] **獎勵發放**: 領取通關獎勵
|
||||
|
||||
#### 失敗流程
|
||||
- [ ] **失敗宣告**: 顯示失敗原因
|
||||
- [ ] **安慰獎勵**: 領取時光卷一張
|
||||
|
||||
### AI訂正系統
|
||||
#### 語法錯誤訂正
|
||||
- [ ] **錯誤收集**: 系統收集該劇本對話中所有語法錯誤的句子
|
||||
- [ ] **依序訂正**: 讓用戶依序對每個錯誤句子進行訂正
|
||||
- [ ] **進度追蹤**: 分子=訂正次數，分母=語法錯誤句數+表達不順句數
|
||||
- [ ] **語音練習**: 點擊練習按鈕後播放說話動畫，再次點擊送出錄音
|
||||
- [ ] **結果反饋**: 檢查完成後回饋正確或錯誤
|
||||
|
||||
#### 表達不順訂正
|
||||
- [ ] **流暢度評估**: 針對語音輸入的精準度、流利度、韻律進行評分
|
||||
- [ ] **不順句收集**: 收集表達不順的句子進行訂正
|
||||
- [ ] **語音重錄**: 使用語音方式重新錄製和練習
|
||||
- [ ] **品質提升**: 透過重複練習提升表達流暢度
|
||||
|
||||
### 技術實現重點
|
||||
- [ ] **快速響應**: 優先保證系統響應速度
|
||||
- [ ] **準確評估**: 確保評分的一致性和準確性
|
||||
- [ ] **獎勵整合**: 與遊戲化系統無縫整合
|
||||
|
||||
## 技術架構設計
|
||||
|
||||
### 核心技術需求 *(更新基於最新規格)*
|
||||
- [ ] **AI 服務選擇**: 確定主要 AI 模型供應商
|
||||
- [ ] **評分算法**: 建立三維度評分的具體邏輯
|
||||
- [ ] **雙重檢測引擎**: 實現劇情任務和詞彙檢測的AI系統
|
||||
- [ ] **即時反饋系統**: 任務完成和詞彙使用的立即通知機制
|
||||
- [ ] **回覆輔助引擎**: 實現意圖分析和回應引導的AI模型
|
||||
- [ ] **語音處理整合**: 語音轉文字和Speakace流暢度分析 *(新增)*
|
||||
- [ ] **翻譯服務整合**: Google翻譯API的無縫整合
|
||||
- [ ] **限時系統整合**: 300秒計時和結算觸發機制
|
||||
- [ ] **訂正系統AI**: 語法錯誤和表達流暢度的訂正引擎 *(新增)*
|
||||
- [ ] **成就系統整合**: 自動觸發獎勵機制
|
||||
- [ ] **性能優化**: 確保響應時間 < 2秒
|
||||
|
||||
### 數據來源架構 *(新增基於最新規格)*
|
||||
#### 預先準備的數據 (事前手動生成)
|
||||
- [ ] **開場對話**: 包含場景描述的4-8句開場對話
|
||||
- [ ] **任務定義**: 中文描述、完成範例、範例翻譯
|
||||
- [ ] **詞彙數據**: 包含翻譯、圖片、題庫等完整詞彙資料
|
||||
- [ ] **劇情大綱**: 完整的劇本背景和角色設定
|
||||
- [ ] **獎勵設定**: 關卡經驗值獎勵、寶石獎勷、訂正後獎勵數目
|
||||
|
||||
#### 即時生成的數據 (關卡進行當下)
|
||||
- [ ] **AI角色對話**: 基於劇情和用戶回應的AI動態生成
|
||||
- [ ] **用戶對話**: 語音轉文字後存入資料庫
|
||||
- [ ] **語法錯誤評估**: AI即時分析每句話的語法正確性
|
||||
- [ ] **語意合適度評估**: AI評估對話的語境適應性
|
||||
- [ ] **任務完成評估**: AI判斷劇情任務的完成狀態
|
||||
- [ ] **流暢度分析**: Speakace平台分析精準度、流利度、韻律
|
||||
- [ ] **回覆引導**: AI生成的三層輔助內容
|
||||
- [ ] **對話翻譯**: Google翻譯提供的中翻英服務
|
||||
|
||||
#### 詞彙檢測系統
|
||||
- [ ] **詞彙變化形式**: 資料庫儲存詞彙所有型態供模糊比對
|
||||
- 例如：eat, ate, eats, eaten
|
||||
- [ ] **即時比對機制**: 每次對話結束後進行模糊比對
|
||||
- [ ] **語境適配**: 確保詞彙使用的自然性和合理性
|
||||
|
||||
### 情境對話技術架構 *(新增)*
|
||||
- [ ] **劇情解析引擎**: 理解和追蹤劇本任務的完成狀態
|
||||
- [ ] **詞彙監控系統**: 即時檢測指定詞彙的使用情況
|
||||
- [ ] **雙重成功判定**: 同時滿足劇情任務和詞彙要求的邏輯
|
||||
- [ ] **時間管理核心**: 精確的300秒倒數計時系統
|
||||
|
||||
### 回覆輔助技術架構
|
||||
- [ ] **意圖識別模型**: 基於context理解對方話語意圖
|
||||
- [ ] **回應策略生成**: 提供多元化的回應思路建議
|
||||
- [ ] **範例生成算法**: 根據使用者等級生成適當的回覆範例
|
||||
- [ ] **情境適應性**: 確保建議符合對話場景和文化背景
|
||||
|
||||
### 基本品質控制
|
||||
- [ ] **準確性測試**: 驗證評分結果的一致性
|
||||
- [ ] **用戶體驗**: 確保獎勵系統運作順暢
|
||||
- [ ] **資料隱私**: 基本的用戶資料保護
|
||||
|
||||
---
|
||||
|
||||
## 待完成任務
|
||||
|
||||
### 高優先級 *(更新基於最新規格)*
|
||||
1. [ ] 建立每句話的即時分析系統（語法、任務、詞彙三重檢測）
|
||||
2. [ ] 實現劇情任務完成狀態的AI檢測引擎
|
||||
3. [ ] 建立指定詞彙模糊比對系統（支援詞彙變化形式）
|
||||
4. [ ] 開發詞彙學習關卡系統（詞彙認識和詞彙熟悉）*(新增)*
|
||||
5. [ ] 實現間隔複習算法（2^複習次數的遺忘曲線計算）*(新增)*
|
||||
6. [ ] 開發即時成功通知機制（任務完成和詞彙使用立即反饋）
|
||||
7. [ ] 實現三維度結算評分系統（語意60+、語法0錯、流暢60+）
|
||||
8. [ ] 建立語音轉文字和中文檢測系統
|
||||
9. [ ] 整合Speakace流暢度分析（精準度、流利度、韻律）
|
||||
10. [ ] 開發回覆輔助的三層引導AI（意圖分析、思緒引導、範例生成）
|
||||
|
||||
### 中優先級
|
||||
1. [ ] 建立雙重通關條件的邏輯驗證系統 *(新增)*
|
||||
2. [ ] 優化時間壓力下的AI分析準確性 *(新增)*
|
||||
3. [ ] 設計三類輔助工具的智能推薦機制 *(新增)*
|
||||
4. [ ] 建立意圖分析模型的準確性測試
|
||||
5. [ ] 優化回覆範例生成的品質控制
|
||||
6. [ ] 建立評分一致性的測試機制
|
||||
7. [ ] 優化與遊戲化系統的整合
|
||||
8. [ ] 確保基本的資料隱私保護
|
||||
|
||||
### 新增功能優先級
|
||||
1. [ ] 設計劇情任務的複雜度分級系統
|
||||
2. [ ] 建立指定詞彙的學習進度追蹤
|
||||
3. [ ] 優化限時環境下的用戶體驗
|
||||
4. [ ] 設計回覆卡關的觸發時機和條件
|
||||
5. [ ] 建立輔助功能使用的數據追蹤
|
||||
6. [ ] 優化中翻英結果的情境適應性
|
||||
7. [ ] 設計輔助功能的學習成效測量
|
||||
|
||||
---
|
||||
|
||||
**最後更新**: 2024年9月5日
|
||||
**負責人**: 待分配
|
||||
**審查週期**: 每兩週檢討一次
|
||||
|
|
@ -0,0 +1,300 @@
|
|||
# 商業邏輯與營收規則
|
||||
|
||||
## 概述
|
||||
基於實際 UI 設計，定義 Drama Ling 的遊戲化商業模式，以鑽石貨幣系統為主的道具購買機制，搭配簡潔的訂閱服務。
|
||||
|
||||
## 鑽石貨幣系統 (主要營收機制)
|
||||
|
||||
### 鑽石獲得方式
|
||||
- [ ] **初始贈送**: 新用戶註冊贈送1500鑽石
|
||||
- [ ] **每日登入**: 登入獎勵鑽石
|
||||
- [ ] **學習成就**: 完成關卡獲得鑽石獎勵
|
||||
- [ ] **現金購買**: 直接購買鑽石包
|
||||
- [ ] **廣告獎勵**: 觀看廣告獲得少量鑽石
|
||||
|
||||
### 道具商店系統
|
||||
|
||||
#### 加時道具 🕰️
|
||||
**功能**: 為對話訓練加時1分3秒
|
||||
- [ ] **單個購買**: 1個 = 300鑽石
|
||||
- [ ] **組合包**: 5個 = 1,200鑽石 (節省20%)
|
||||
- [ ] **使用情境**: 挑戰關卡時間不夠時使用
|
||||
- [ ] **效果**: 獲得更長的思考和組織時間
|
||||
|
||||
#### 補命道具 ❤️
|
||||
**功能**: 為對話學習的時間卡復活1次機會
|
||||
- [ ] **單個購買**: 1個 = 100鑽石
|
||||
- [ ] **組合包**: 5個 = 400鑽石 (節省20%)
|
||||
- [ ] **使用情境**: 對話練習失敗時使用
|
||||
- [ ] **效果**: 可重新挑戰失敗的關卡
|
||||
|
||||
#### 時光卷 ✨ *(更新基於最新規格)*
|
||||
**功能**: 可挑戰1次前階段關卡或獲得失敗安慰獎勵
|
||||
- [ ] **獲得方式**:
|
||||
- 詞彙認識關卡失敗獲得1張
|
||||
- 詞彙熟悉關卡失敗獲得1張
|
||||
- 對話訓練失敗獲得1張
|
||||
- 複習詞彙失敗安慰獎勵
|
||||
- [ ] **使用情境**:
|
||||
- 挑戰時光關卡（前階段未玩過的對話訓練）
|
||||
- 若前階段都已完成則隨機挑選關卡
|
||||
- [ ] **消費機制**: 點擊「我要挑戰」消耗1張時光卷
|
||||
- [ ] **特殊效果**: 成功通關的詞彙一樣加入詞彙複習清單
|
||||
|
||||
#### 回覆提示道具 💡 *(更新基於最新規格)*
|
||||
**功能**: 當用戶在扮演角色遇到卡關，不知道該講什麼或怎麼講時提供協助
|
||||
- [ ] **單個購買**: 1個 = 30鑽石
|
||||
- [ ] **組合包**: 10個 = 250鑽石 (節省17%)
|
||||
- [ ] **觸發條件**: 用戶主動請求回覆協助時使用
|
||||
- [ ] **效果**: 根據對話室中最後一句話生成三層引導內容
|
||||
|
||||
**回覆引導內容** (消耗道具):
|
||||
- [ ] **對方意圖分析**: 分析對方說這句話的意圖
|
||||
- [ ] **回應思緒引導**: 分析用戶聽到這句話的反應及可能的回覆方向
|
||||
- [ ] **回覆範例生成**: 生成一句具體的回覆範例
|
||||
|
||||
**免費輔助功能** (不消耗道具):
|
||||
- [ ] **劇情任務範例**: 點擊任務提示按鈕顯示「這樣說可以完成任務」的範例
|
||||
- [ ] **指定詞彙範例**: 展示指定詞彙的正確使用方式
|
||||
- [ ] **中翻英翻譯**: 直接將使用者的中文以Google翻譯轉譯成英文
|
||||
|
||||
**使用規則**:
|
||||
- [ ] **任務完成狀態**: 當任務已經完成時，不會顯示任務提示按鈕
|
||||
- [ ] **使用限制**: 每次對話合理使用，避免過度依賴
|
||||
- [ ] **學習導向**: 鼓勵用戶從輔助逐步過渡到獨立表達
|
||||
|
||||
## 關卡命條系統 *(新增核心機制)*
|
||||
|
||||
### 命條管理機制
|
||||
基於最新規格的闖關生命值系統：
|
||||
|
||||
#### 命條基本規則
|
||||
- [ ] **初始設定**: 新用戶預設5個命條（上限為5）
|
||||
- [ ] **闖關門檻**: 開始闖關前檢查命條是否大於1
|
||||
- [ ] **自動回復**: 每5小時自動獲得1個命條
|
||||
- [ ] **命條歸零**: 當命條扣完歸零時即闖關失敗
|
||||
|
||||
#### 命條消耗規則
|
||||
- [ ] **詞彙認識關卡**: 答錯題目扣除1個命條
|
||||
- [ ] **詞彙熟悉關卡**: 答錯題目扣除1個命條
|
||||
- [ ] **對話訓練關卡**: 通關失敗扣除1個命條
|
||||
- [ ] **重複答題**: 答錯的題目需在最後重新回答，再次答錯繼續扣命條
|
||||
|
||||
#### 命條不足處理
|
||||
- [ ] **闖關阻擋**: 命條不足時無法開始新的關卡挑戰
|
||||
- [ ] **購買機制**: 命條不足時可使用鑽石購買命條
|
||||
- 1個命條 = 100鑽石
|
||||
- 5個命條組合包 = 400鑽石（節省20%）
|
||||
- [ ] **等待恢復**: 用戶可選擇等待5小時自然恢復命條
|
||||
- [ ] **視覺提示**: 金錢不夠時購買按鈕顯示為disable狀態
|
||||
|
||||
### 關卡結構系統 *(新增基於最新規格)*
|
||||
基於13階段的完整學習路徑：
|
||||
|
||||
#### 階段化學習架構
|
||||
- [ ] **學習階層**: 第x階段 > 第x劇本 > 某某關卡
|
||||
- [ ] **總體規劃**: 共13個學習階段
|
||||
- [ ] **劇本數量**: 每階段包含20個以上劇本（持續增加）
|
||||
- [ ] **關卡類型**: 每個劇本固定包含三種關卡
|
||||
- 詞彙認識關卡
|
||||
- 詞彙熟悉關卡
|
||||
- 對話訓練關卡
|
||||
|
||||
#### 關卡解鎖機制
|
||||
- [ ] **順序闖關**: 必須按照關卡順序進行，不可跳關
|
||||
- [ ] **解鎖條件**: 完成前一關卡才能解鎖下一關
|
||||
- [ ] **通關標準**: 即使獲得零顆星，成功通關仍會解鎖下一關
|
||||
- [ ] **星級獎勵**: 詞彙認識和詞彙熟悉關卡通關直接給予三顆星
|
||||
|
||||
#### 連續學習獎勵
|
||||
- [ ] **連續學習天數**: 追蹤用戶連續學習的天數
|
||||
- [ ] **每日學習判定**: 當日完成至少一個關卡即計為學習一天
|
||||
- [ ] **連續獎勵機制**: 基於連續天數給予額外獎勵
|
||||
- 7天連續: 額外經驗值獎勵
|
||||
- 14天連續: 免費命條補充
|
||||
- 30天連續: 特殊成就徽章
|
||||
|
||||
## 情境對話核心商業機制 *(新增功能)*
|
||||
|
||||
### 雙重通關條件獎勵系統
|
||||
基於最新規格的結構化通關獎勵機制：
|
||||
|
||||
#### 劇情任務完成獎勵
|
||||
- [ ] **基礎完成獎勵**: 完成劇情任務獲得 +10 鑽石 + 10 閃電能量
|
||||
- [ ] **任務品質加成**: 高品質完成劇情任務額外 +5 鑽石
|
||||
- [ ] **即時獎勵機制**: 任務完成立即觸發獎勵通知和發放
|
||||
- [ ] **進度追蹤獎勵**: 連續完成劇情任務的連擊獎勵機制
|
||||
|
||||
#### 指定詞彙使用獎勵
|
||||
- [ ] **詞彙掌握獎勵**: 正確使用指定詞彙獲得 +5 鑽石 + 5 閃電能量
|
||||
- [ ] **自然使用加成**: 詞彙使用自然且符合語境額外 +3 鑽石
|
||||
- [ ] **即時反饋獎勵**: 使用詞彙時立即觸發成功通知
|
||||
- [ ] **詞彙精通獎勵**: 單次對話使用多個指定詞彙的組合獎勵
|
||||
|
||||
#### 結算獎勵系統 *(更新基於最新規格)*
|
||||
**過關獎勵** (同時滿足劇情任務和詞彙要求):
|
||||
- [ ] **基礎通關獎勵**: 獲得金幣和經驗值
|
||||
- [ ] **星級獎勵系統**: 基於三維度評分獲得1-3顆星
|
||||
- 語意合適分數 > 60 (滿分100) = 1顆星
|
||||
- 語法錯誤率 = 0 (所有句子正確或訂正後正確) = 1顆星
|
||||
- 表達流暢平均分數 > 60 (滿分100) = 1顆星
|
||||
- [ ] **訂正後獎勵**: 選擇立即訂正後獲得訂正後的獎勵數值
|
||||
|
||||
**失敗安慰獎勵**:
|
||||
- [ ] **安慰獎**: 獲得時光卷一張（可重新挑戰關卡）
|
||||
- [ ] **鼓勵機制**: 提供重新挑戰的動機和資源
|
||||
|
||||
### 300秒限時挑戰機制
|
||||
基於最新規格的時間管理商業系統：
|
||||
|
||||
#### 限時挑戰入場機制
|
||||
- [ ] **挑戰門票**: 參與300秒限時挑戰需消耗 50鑽石 入場費
|
||||
- [ ] **免費次數**: 每日首次限時挑戰免費，後續挑戰需付費
|
||||
- [ ] **VIP特權**: 付費用戶每日3次免費限時挑戰機會
|
||||
- [ ] **好友邀請**: 邀請好友一同挑戰可減免入場費用
|
||||
|
||||
#### 時間相關道具系統
|
||||
- [ ] **時間暫停道具**: 暫停倒數計時30秒，消耗 100鑽石
|
||||
- [ ] **時間加成道具**: 增加額外60秒挑戰時間，消耗 150鑽石
|
||||
- [ ] **快速完成獎勵**: 在180秒內完成獲得 +15 鑽石時間獎勵
|
||||
- [ ] **壓力測試獎勵**: 在最後30秒完成挑戰獲得 +25 鑽石壓力獎勵
|
||||
|
||||
#### 限時結算獎勵機制
|
||||
- [ ] **基礎完成獎勵**: 300秒內完成對話獲得 +30 鑽石 + 30 閃電能量
|
||||
- [ ] **時間效率獎勵**: 基於完成時間給予 1.2x - 2.0x 獎勵倍數
|
||||
- [ ] **雙重條件加成**: 限時環境下達成雙重條件額外 +50 鑽石
|
||||
- [ ] **排行榜獎勵**: 每週限時挑戰排行榜前10名特殊獎勵
|
||||
|
||||
## 簡化訂閱系統 (次要營收)
|
||||
|
||||
### 訂閱服務設計
|
||||
- [ ] **7天免費體驗**: 新用戶可免費使用7天完整功能
|
||||
- [ ] **目標**: 與靈兔一起闖關學英文，玩出一口流利的口說英文
|
||||
- [ ] **成功頁面**: 可愛外星人角色設計增加親切感
|
||||
- [ ] **續約提醒**: "還在等什麼？先來7天免費體驗看看！"
|
||||
|
||||
### 資源不足機制
|
||||
- [ ] **提醒彈窗**: "任務提示需要消耗30資石，但你目前資石不足"
|
||||
- [ ] **引導購買**: 直接引導用戶到道具商店
|
||||
- [ ] **清楚的需求說明**: 顯示具體需要的資源數量
|
||||
- [ ] **一鍵解決**: 提供"了解"按鈕引導至購買頁面
|
||||
|
||||
## 道具購買流程設計
|
||||
|
||||
### 購買確認機制
|
||||
|
||||
#### 加時道具購買確認
|
||||
- [ ] **視覺化設計**: 大型時鐘圖示加上加號圖示
|
||||
- [ ] **清楚的價值說明**: "用加時道具去玩出更高的分數吧！"
|
||||
- [ ] **遊戲化設計**: 對話式的遊戲要求，而非單純交易
|
||||
- [ ] **即時購買**: "立即購買 300鑽石"按鈕
|
||||
- [ ] **取消選項**: 簡單的"不，謝謝"選項
|
||||
|
||||
#### 補命道具購買確認
|
||||
- [ ] **心形圖示**: 愛心加號的視覺設計
|
||||
- [ ] **功能說明**: 明確告知為學習時間復活用途
|
||||
- [ ] **價格透明**: 直接顯示100鑽石的明確價格
|
||||
- [ ] **低價格策略**: 相對低廉的價格降低購買的障礙感
|
||||
|
||||
#### 回覆提示道具購買確認
|
||||
- [ ] **燈泡圖示**: 智慧提示的視覺設計
|
||||
- [ ] **功能說明**: "獲得AI智慧引導，突破對話卡關！"
|
||||
- [ ] **價格透明**: 直接顯示30鑽石的低門檻價格
|
||||
- [ ] **價值展示**: 強調包含四合一功能(意圖分析+思維引導+回覆範例+翻譯)
|
||||
- [ ] **即時解決**: "立即獲得對話靈感"的行動導向按鈕
|
||||
- [ ] **低價策略**: 最低價道具降低首次付費心理障礙
|
||||
|
||||
### 購買成功機制
|
||||
- [ ] **即時生效**: 購買後立即可在遊戲中使用
|
||||
- [ ] **清楚的庫存顯示**: 在主界面右上角顯示目前鑽石數量(1500)
|
||||
- [ ] **使用指引**: 在需要使用道具時提供明確的使用方式
|
||||
|
||||
## 訂閱成功體驗設計
|
||||
|
||||
### 成功頁面設計理念
|
||||
- [ ] **可愛風格**: 使用外星人角色創造親切感
|
||||
- [ ] **清楚的價值主張**: "和靈兔一起闖關學英文！玩出一口流利的口說英文！"
|
||||
- [ ] **緊迫性設計**: "還在等什麼？先來7天免費體驗看看！"
|
||||
- [ ] **行動導向**: 大型明顯的CTA按鈕"領取7天體驗資格"
|
||||
|
||||
### 用戶心理設計
|
||||
- [ ] **降低抵觸**: 免費體驗降低初次購買的心理障礙
|
||||
- [ ] **社交證明**: 使用外星人形象增加記憶點
|
||||
- [ ] **成就感**: 體驗成功的成就感與滿意度
|
||||
- [ ] **持續動機**: 透過可愛設計建立情感連結
|
||||
|
||||
## 鑽石購買套餐設計
|
||||
|
||||
### 推薦套餐結構
|
||||
- [ ] **新手包**: 500鑽石 = NT$30 (首次購買優惠)
|
||||
- [ ] **基礎包**: 1,200鑽石 = NT$60
|
||||
- [ ] **價值包**: 2,500鑽石 = NT$99 (最受歡迎)
|
||||
- [ ] **豪華包**: 5,000鑽石 = NT$190
|
||||
- [ ] **至尊包**: 12,000鑽石 = NT$390
|
||||
|
||||
### 定價策略考量
|
||||
- [ ] **低門檻**: NT$30的新手包降低進入的障礙
|
||||
- [ ] **價值感**: 每1鑽石約NT$0.04的合理價格
|
||||
- [ ] **組合購買優惠**: 5個裝比單購節省20-25%
|
||||
- [ ] **心理定位**: 道具價格設定在100-1200鑽石區間
|
||||
|
||||
## 付費轉換優化
|
||||
|
||||
### 轉換漏斗設計
|
||||
- [ ] **無縫體驗**: 從免費使用到需要購買的自然過渡
|
||||
- [ ] **第一次付費**: 通常為最低價的道具(回覆提示道具30鑽石)
|
||||
- [ ] **漸進式需求**:
|
||||
- **入門級**: 回覆提示道具(30鑽石) - 解決即時卡關問題
|
||||
- **成長級**: 限時挑戰門票(50鑽石) - 體驗競技式學習
|
||||
- **進階級**: 補命道具(100鑽石) - 提供重新挑戰機會
|
||||
- **專家級**: 時間相關道具(100-150鑽石) - 優化限時挑戰表現
|
||||
- **大師級**: 加時道具(300鑽石) - 獲得更充裕練習時間
|
||||
- [ ] **成就動機**: 通過道具使用獲得更好成績和雙重通關的成就感
|
||||
- [ ] **學習進步感**: 回覆提示功能和即時獎勵讓用戶感受到明顯的學習支援
|
||||
- [ ] **競技驅動**: 300秒限時挑戰創造緊張感和競爭動機
|
||||
- [ ] **社交壓力**: 好友排行榜和限時挑戰排名驅動持續消費
|
||||
|
||||
## 簡化廣告系統
|
||||
|
||||
### 廣告展示策略
|
||||
- [ ] **非強制性**: 主要用於獲得額外鑽石獎勵
|
||||
- [ ] **獎勵導向**: 觀看廣告獲得25-50鑽石
|
||||
- [ ] **頻率控制**: 避免影響核心遊戲體驗
|
||||
- [ ] **品質篩選**: 優先顯示教育和遊戲相關廣告
|
||||
|
||||
## 技術實現考量
|
||||
|
||||
### 支付系統整合
|
||||
- [ ] **第三方支付串接**: 整合多種支付方式API
|
||||
- [ ] **交易安全**: PCI DSS合規的支付安全機制
|
||||
- [ ] **即時到帳**: 購買後立即可使用的鑽石發放
|
||||
- [ ] **退款處理**: 簡化的退款處理流程
|
||||
|
||||
### 道具系統管理
|
||||
- [ ] **即時庫存**: 即時更新用戶鑽石和道具庫存
|
||||
- [ ] **使用追蹤**: 追蹤道具使用情況和效果
|
||||
- [ ] **防作弊機制**: 防止道具被不正當獲得或使用
|
||||
- [ ] **數據分析**: 道具使用率和購買轉換率分析
|
||||
|
||||
---
|
||||
|
||||
## 關鍵差異與實際設計對齊
|
||||
|
||||
### 與原規劃的主要不同
|
||||
1. **簡化商業模式**: 從複雜的4層訂閱制改為鑽石道具+簡單訂閱
|
||||
2. **遊戲化貨幣**: 使用鑽石取代直接台幣定價
|
||||
3. **低門檻策略**: 最低100鑽石的道具降低付費門檻
|
||||
4. **視覺化購買**: 可愛的確認彈窗而非複雜的訂閱頁面
|
||||
5. **即時獎勵**: 購買後立即可用，增加滿足感
|
||||
|
||||
### 實際應用案例
|
||||
- **道具商店頁面**: 清楚的分類和價格顯示
|
||||
- **購買確認彈窗**: 遊戲化的對話式確認
|
||||
- **資源不足提醒**: 直接引導到解決方案
|
||||
- **訂閱成功頁**: 可愛外星人增加品牌親和力
|
||||
|
||||
---
|
||||
|
||||
**最後更新**: 2024年9月5日
|
||||
**基於實際設計**: 05_views 目錄中的商業相關UI設計
|
||||
**審查週期**: 與實際UI設計保持同步更新
|
||||
|
|
@ -0,0 +1,389 @@
|
|||
# 內容管理規格文件
|
||||
|
||||
## 概述
|
||||
基於 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日
|
||||
**負責人**: 待分配
|
||||
**審查週期**: 每兩週檢討一次
|
||||
|
|
@ -0,0 +1,353 @@
|
|||
# 遊戲化機制設計規格
|
||||
|
||||
## 概述
|
||||
定義 Drama Ling 應用中的完整遊戲化系統，包含排行榜、成就系統、闖關機制等，提升用戶學習動機和留存率。
|
||||
|
||||
## 排行榜競爭機制
|
||||
|
||||
### 排行榜類型
|
||||
基於 UI_SocialRanking_Main.png 的實際設計，採用簡化的好友排行榜系統：
|
||||
|
||||
- [ ] **好友排行榜**: 主要排行榜功能，顯示好友間的閃電能量比較
|
||||
- [ ] **排名顯示**: 1-7名好友排列，每位顯示頭像、姓名和閃電總數
|
||||
- [ ] **個人突顯**: 第4名使用紫色背景突顯當前用戶位置
|
||||
|
||||
### 成就獎勵系統
|
||||
基於 UI_LevelResult_ScoreSummary.png 的實際設計，採用簡化的三項成就機制：
|
||||
|
||||
#### 核心成就系統 *(更新)*
|
||||
- [ ] **過關獎勵** (通關寶箱)
|
||||
- 完成對話場景即可獲得
|
||||
- 獎勵: +10 鑽石 + 10 閃電能量
|
||||
|
||||
- [ ] **完美語法**
|
||||
- 語法評分達到優秀標準
|
||||
- 獎勵: +10 鑽石 + 10 閃電能量
|
||||
|
||||
- [ ] **表達流利**
|
||||
- 流暢度評分達到優秀標準
|
||||
- 獎勵: +10 鑽石 + 10 閃電能量
|
||||
|
||||
#### 雙重通關條件成就 *(新增核心功能)*
|
||||
- [ ] **劇情大師**
|
||||
- 成功完成劇情任務且表現優秀
|
||||
- 觸發條件: 完成所有劇情任務要素且邏輯連貫
|
||||
- 獎勵: +15 鑽石 + 15 閃電能量 + 劇情成就徽章
|
||||
|
||||
- [ ] **詞彙專家**
|
||||
- 正確且自然地使用所有指定詞彙
|
||||
- 觸發條件: 使用指定詞彙且符合語境和自然度要求
|
||||
- 獎勵: +12 鑽石 + 12 閃電能量 + 詞彙成就徽章
|
||||
|
||||
- [ ] **完美對話**
|
||||
- 同時滿足劇情任務和指定詞彙雙重條件
|
||||
- 觸發條件: 劇情任務完成 + 詞彙正確使用 + 整體評分≥90
|
||||
- 獎勵: +25 鑽石 + 25 閃電能量 + 雙重成就特殊徽章 + 1個回覆提示道具
|
||||
|
||||
#### 輔助功能成就 *(新增功能)*
|
||||
- [ ] **智慧學習者**
|
||||
- 首次使用回覆輔助功能並成功完成對話
|
||||
- 觸發條件: 使用回覆提示道具完成對話
|
||||
- 獎勵: +5 鑽石 + 2個回覆提示道具
|
||||
|
||||
- [ ] **獨立進步**
|
||||
- 在同一場景中，先使用輔助後能獨立完成類似對話
|
||||
- 觸發條件: 同場景使用輔助後，下次對話無需輔助且分數≥85
|
||||
- 獎勵: +15 鑽石 + 15 閃電能量
|
||||
|
||||
- [ ] **翻譯達人**
|
||||
- 累計使用中翻英功能50次
|
||||
- 觸發條件: 中翻英功能使用次數達標
|
||||
- 獎勵: +20 鑽石 + 5個回覆提示道具
|
||||
|
||||
#### 獎勵貨幣系統
|
||||
- [ ] **鑽石** (💎): 主要遊戲貨幣，用於購買道具和解鎖內容
|
||||
- [ ] **閃電能量** (⚡): 用於加時、提示等輔助功能
|
||||
- [ ] **回覆提示道具** (💡): 專用於回覆卡關輔助功能 *(新增)*
|
||||
- [ ] **限時挑戰門票** (🎫): 專用於300秒限時挑戰入場 *(新增)*
|
||||
- [ ] **時間道具** (⏰): 時間暫停和加成道具 *(新增)*
|
||||
- [ ] **統一獎勵**: 核心成就固定 +10/+10 獎勵，雙重通關和限時成就有特殊獎勵 *(更新)*
|
||||
|
||||
### 關卡進度系統 *(新增基於最新規格)*
|
||||
基於13階段學習架構的完整進度管理：
|
||||
|
||||
#### 階段化進度機制
|
||||
- [ ] **學習路徑**: 第x階段 → 第x劇本 → 詞彙認識 → 詞彙熟悉 → 對話訓練
|
||||
- [ ] **總體架構**: 13個學習階段，每階段20+劇本
|
||||
- [ ] **順序解鎖**: 必須按照順序完成，不可跳關
|
||||
- [ ] **通關標準**: 成功完成即解鎖下一關（即使0星）
|
||||
|
||||
#### 命條生命系統
|
||||
- [ ] **命條機制**: 新用戶預設5命條，上限5條
|
||||
- [ ] **命條消耗**:
|
||||
- 詞彙認識答錯 -1命條
|
||||
- 詞彙熟悉答錯 -1命條
|
||||
- 對話訓練失敗 -1命條
|
||||
- [ ] **命條回復**: 每5小時自動回復1命條
|
||||
- [ ] **命條購買**: 1命條=100鑽石，5命條=400鑽石
|
||||
|
||||
#### 連續學習獎勵系統
|
||||
- [ ] **天數追蹤**: 記錄用戶連續學習天數
|
||||
- [ ] **學習判定**: 當日完成至少1個關卡即計為學習
|
||||
- [ ] **階段性獎勵**:
|
||||
- 7天連續: +100經驗值 + 特殊徽章
|
||||
- 14天連續: +200經驗值 + 2命條補充
|
||||
- 30天連續: +500經驗值 + 特殊成就徽章 + 100鑽石
|
||||
|
||||
### 詞彙學習成就系統 *(新增功能)*
|
||||
基於詞彙學習關卡的專屬成就：
|
||||
|
||||
#### 詞彙掌握成就
|
||||
- [ ] **詞彙新手**
|
||||
- 完成第一個詞彙認識關卡
|
||||
- 獎勵: +50經驗值 + 詞彙學習徽章
|
||||
|
||||
- [ ] **詞彙達人**
|
||||
- 累計完成50個詞彙熟悉關卡
|
||||
- 獎勵: +200經驗值 + 詞彙達人徽章 + 50鑽石
|
||||
|
||||
- [ ] **複習專家**
|
||||
- 連續30天完成詞彙複習
|
||||
- 獎勵: +300經驗值 + 複習專家徽章 + 100鑽石
|
||||
|
||||
#### 關卡完成成就
|
||||
- [ ] **三星收集者**
|
||||
- 在單一劇本中獲得全部三顆星（詞彙認識+詞彙熟悉+對話訓練）
|
||||
- 獎勵: +100經驗值 + 完美劇本徽章
|
||||
|
||||
- [ ] **階段征服者**
|
||||
- 完成整個學習階段的所有劇本
|
||||
- 獎勵: +500經驗值 + 階段征服徽章 + 200鑽石
|
||||
|
||||
### 時光關卡系統 *(新增機制)*
|
||||
基於時光卷的特殊關卡挑戰：
|
||||
|
||||
#### 時光關卡機制
|
||||
- [ ] **關卡選擇**: 依序挑選前階段未玩過的對話訓練關卡
|
||||
- [ ] **隨機機制**: 若前階段都已完成則隨機挑選關卡
|
||||
- [ ] **消費機制**: 點擊「我要挑戰」消耗1張時光卷
|
||||
- [ ] **獎勵機制**: 成功通關的詞彙加入複習清單，獲得正常獎勵
|
||||
|
||||
#### 時光卷獲得途徑
|
||||
- [ ] **失敗安慰**: 各類關卡失敗時獲得1張時光卷
|
||||
- [ ] **每日獎勵**: 連續學習獎勵中包含時光卷
|
||||
- [ ] **成就獎勵**: 特定成就達成時獲得時光卷
|
||||
- [ ] **購買機制**: 可使用鑽石購買時光卷（待定價格）
|
||||
|
||||
### 排行榜更新機制
|
||||
- [ ] **即時更新**: 積分變化立即反映
|
||||
- [ ] **排名快取**: 5分鐘更新一次排名顯示
|
||||
- [ ] **歷史記錄**: 保存每日/週/月排名變化
|
||||
- [ ] **排名爭議處理**: 異常分數檢測和處理機制
|
||||
|
||||
## 成就系統設計
|
||||
|
||||
基於實際 UI 設計，採用簡化的即時成就系統：
|
||||
|
||||
### 核心成就機制
|
||||
- [ ] **過關獎勵**: 完成任何對話場景獲得寶箱獎勵
|
||||
- [ ] **完美語法**: 語法表現優秀時獲得額外獎勵
|
||||
- [ ] **表達流利**: 流暢度表現優秀時獲得額外獎勵
|
||||
- [ ] **輔助功能成就** *(新增)*: 智慧使用回覆輔助功能的學習進步獎勵
|
||||
|
||||
## 300秒限時挑戰系統 *(新增核心功能)*
|
||||
|
||||
### 限時挑戰機制設計
|
||||
基於最新規格的競技式學習系統：
|
||||
|
||||
#### 倒數計時系統
|
||||
- [ ] **精準計時**: 300秒（5分鐘）的精確倒數顯示
|
||||
- [ ] **視覺化時間**: 動態進度條和數字倒數的雙重顯示
|
||||
- [ ] **時間警告**: 剩餘60秒和30秒時的視覺和音效提醒
|
||||
- [ ] **自動結算**: 時間歸零時自動觸發結算流程
|
||||
|
||||
#### 限時挑戰獎勵機制
|
||||
- [ ] **時間效率獎勵**:
|
||||
- 180秒內完成: 1.5x 基礎獎勵倍數
|
||||
- 120秒內完成: 2.0x 基礎獎勵倍數
|
||||
- 60秒內完成: 2.5x 基礎獎勵倍數
|
||||
- [ ] **雙重條件加成**: 限時環境下達成雙重通關額外 +50 鑽石
|
||||
- [ ] **壓力挑戰獎勵**: 最後30秒內完成額外 +25 鑽石壓力獎勵
|
||||
- [ ] **完美限時成就**: 限時內達成完美對話獲得特殊限時徽章
|
||||
|
||||
#### 限時挑戰排行榜
|
||||
- [ ] **每日排行榜**: 每日限時挑戰最佳成績排名
|
||||
- [ ] **每週冠軍賽**: 週末特殊限時挑戰競賽
|
||||
- [ ] **好友競技**: 好友間的限時挑戰比較和挑戰
|
||||
- [ ] **全球排名**: 全體用戶的限時挑戰成績排行
|
||||
|
||||
### 限時挑戰成就系統
|
||||
基於時間壓力下的特殊成就機制：
|
||||
|
||||
#### 時間相關成就
|
||||
- [ ] **閃電戰士**
|
||||
- 首次在180秒內完成限時挑戰
|
||||
- 獎勵: +30 鑽石 + 30 閃電能量 + 速度徽章
|
||||
|
||||
- [ ] **時間大師**
|
||||
- 累計完成10次限時挑戰且平均時間<4分鐘
|
||||
- 獎勵: +50 鑽石 + 50 閃電能量 + 時間掌控徽章
|
||||
|
||||
- [ ] **壓力之王**
|
||||
- 在最後30秒內完成5次限時挑戰
|
||||
- 獎勵: +75 鑽石 + 75 閃電能量 + 壓力專家徽章
|
||||
|
||||
#### 限時雙重通關成就
|
||||
- [ ] **限時劇情大師**
|
||||
- 在限時挑戰中完成劇情任務且時間<4分鐘
|
||||
- 獎勵: +40 鑽石 + 40 閃電能量 + 限時劇情徽章
|
||||
|
||||
- [ ] **限時詞彙專家**
|
||||
- 在限時挑戰中正確使用所有指定詞彙且時間<3分鐘
|
||||
- 獎勵: +35 鑽石 + 35 閃電能量 + 限時詞彙徽章
|
||||
|
||||
- [ ] **限時完美對話**
|
||||
- 在限時挑戰中達成雙重通關且時間<2.5分鐘
|
||||
- 獎勵: +100 鑽石 + 100 閃電能量 + 限時完美徽章 + 3個回覆提示道具
|
||||
|
||||
### 獎勵統一標準
|
||||
- [ ] **統一獎勵**: 每項成就固定給予 +10 鑽石 + 10 閃電能量
|
||||
- [ ] **即時反饋**: 完成對話後立即顯示獲得的成就
|
||||
- [ ] **視覺化展示**: 使用寶箱和貨幣圖示清楚顯示獎勵
|
||||
|
||||
## 闖關系統設計
|
||||
|
||||
### 關卡結構
|
||||
|
||||
#### 主線關卡 (情境導向)
|
||||
- [ ] **第一章: 日常生活** (10關)
|
||||
- 自我介紹、購物、餐廳、交通等基礎場景
|
||||
- 解鎖條件: 無 (新手引導)
|
||||
- 完成獎勵: 100積分 + 基礎徽章
|
||||
|
||||
- [ ] **第二章: 社交互動** (12關)
|
||||
- 朋友聚會、約會、工作會議、電話對話等
|
||||
- 解鎖條件: 第一章通過率 ≥ 80%
|
||||
- 完成獎勵: 150積分 + 社交徽章
|
||||
|
||||
- [ ] **第三章: 應急處理** (15關)
|
||||
- 醫療急救、車禍處理、投訴申訴、緊急求助等
|
||||
- 解鎖條件: 第二章通過率 ≥ 75% + 總積分 ≥ 1000
|
||||
- 完成獎勵: 200積分 + 危機處理徽章
|
||||
|
||||
- [ ] **第四章: 專業場景** (18關)
|
||||
- 商務談判、學術討論、技術交流、面試等
|
||||
- 解鎖條件: 第三章通過率 ≥ 70% + 連續學習 ≥ 30天
|
||||
- 完成獎勵: 300積分 + 專業徽章
|
||||
|
||||
#### 支線關卡 (技能導向)
|
||||
- [ ] **語法強化關**: 專注語法訓練的特殊關卡
|
||||
- [ ] **詞彙擴展關**: 大量新詞彙學習關卡
|
||||
- [ ] **發音矯正關**: 語音識別和發音練習關卡
|
||||
- [ ] **文化理解關**: 目標語言文化背景學習關卡
|
||||
- [ ] **考試準備關**: 針對語言檢定考試的專門關卡
|
||||
|
||||
#### 每日挑戰關
|
||||
- [ ] **每日一題**: 精選對話場景每日更新
|
||||
- [ ] **週題挑戰**: 週末特殊難題挑戰
|
||||
- [ ] **月度任務**: 整月累積完成的大型任務
|
||||
- [ ] **季節活動**: 配合節日的限時特殊關卡
|
||||
- [ ] **突發事件**: 隨機出現的緊急情境關卡
|
||||
|
||||
### 關卡評價系統
|
||||
- [ ] **三星評級**: 基於綜合表現的 1-3 星評價
|
||||
- ⭐ 通過: 綜合評分 ≥ 60分
|
||||
- ⭐⭐ 良好: 綜合評分 ≥ 80分
|
||||
- ⭐⭐⭐ 優秀: 綜合評分 ≥ 95分
|
||||
|
||||
- [ ] **完成條件**:
|
||||
- 達成主要對話目標
|
||||
- 使用指定關鍵詞彙 (如有)
|
||||
- 在時間限制內完成 (如有)
|
||||
- 維持角色扮演一致性
|
||||
|
||||
- [ ] **重複挑戰**: 允許重複挑戰提升星級評價
|
||||
- [ ] **額外目標**: 每關設定 2-3 個額外挑戰目標
|
||||
|
||||
### 解鎖機制
|
||||
- [ ] **順序解鎖**: 主線關卡需按順序完成
|
||||
- [ ] **條件解鎖**: 滿足特定條件才能解鎖新內容
|
||||
- [ ] **付費解鎖**: 部分高級內容需要付費或達到VIP等級
|
||||
- [ ] **社交解鎖**: 邀請好友或達到社交成就解鎖
|
||||
- [ ] **時間解鎖**: 某些內容在特定時間開放
|
||||
|
||||
## 進度追蹤系統
|
||||
|
||||
### 簡化追蹤機制
|
||||
基於實際 UI 設計的簡化追蹤系統：
|
||||
|
||||
- [ ] **闖關進度**: 完成的對話場景數量統計
|
||||
- [ ] **貨幣累積**: 鑽石和閃電能量的當前持有量
|
||||
- [ ] **好友排名**: 在好友圈中的閃電能量排名
|
||||
- [ ] **成就記錄**: 獲得過關獎勵、完美語法、表達流利的次數統計
|
||||
|
||||
## 社交競爭機制
|
||||
|
||||
### 好友排行榜系統
|
||||
基於 UI_SocialRanking_Main.png 的簡化社交功能：
|
||||
|
||||
- [ ] **好友邀請**: 基本的好友添加功能
|
||||
- [ ] **排行榜比較**: 顯示好友間的閃電能量排名（1-7名）
|
||||
- [ ] **個人位置突顯**: 使用紫色背景標示當前用戶排名
|
||||
- [ ] **簡潔展示**: 每位好友顯示頭像、姓名和總閃電數
|
||||
|
||||
---
|
||||
|
||||
## 技術實現考量
|
||||
|
||||
### 資料存儲
|
||||
- [ ] **積分記錄**: 用戶積分變化歷史記錄
|
||||
- [ ] **成就狀態**: 各項成就的完成狀態和進度
|
||||
- [ ] **關卡進度**: 關卡完成狀態和評級記錄
|
||||
- [ ] **排行榜快取**: 高效的排行榜查詢和更新機制
|
||||
- [ ] **統計數據**: 各種學習統計數據的存儲結構
|
||||
|
||||
### 效能優化
|
||||
- [ ] **排行榜快取策略**: Redis快取熱門排行榜數據
|
||||
- [ ] **積分批次更新**: 避免頻繁數據庫寫入
|
||||
- [ ] **成就檢查優化**: 高效的成就觸發檢測機制
|
||||
- [ ] **統計數據預計算**: 定期預計算複雜統計數據
|
||||
- [ ] **分散式處理**: 大量用戶同時更新的處理策略
|
||||
|
||||
### 防作弊機制
|
||||
- [ ] **異常檢測**: 識別異常高分或快速完成的可疑行為
|
||||
- [ ] **行為分析**: 分析用戶學習行為模式的合理性
|
||||
- [ ] **時間驗證**: 驗證完成任務的時間合理性
|
||||
- [ ] **IP限制**: 防止同一IP多帳號刷分
|
||||
- [ ] **人工審核**: 對可疑高分進行人工審核機制
|
||||
|
||||
---
|
||||
|
||||
## 待完成任務
|
||||
|
||||
### 高優先級 *(更新)*
|
||||
1. [ ] 實現雙重通關條件的成就系統和獎勵機制 *(新增)*
|
||||
2. [ ] 建立300秒限時挑戰的完整競技系統 *(新增)*
|
||||
3. [ ] 設計限時挑戰排行榜和時間相關成就 *(新增)*
|
||||
4. [ ] 建立雙重條件在限時環境下的特殊獎勵機制 *(新增)*
|
||||
5. [ ] 確定積分計算的具體數值和平衡性
|
||||
6. [ ] 設計成就系統的徽章視覺設計
|
||||
7. [ ] 實現回覆輔助功能的三項新成就系統 *(新增)*
|
||||
8. [ ] 規劃關卡內容的具體場景劇本
|
||||
9. [ ] 建立防作弊機制的技術方案
|
||||
10. [ ] 設計回覆提示道具的獎勵平衡機制 *(新增)*
|
||||
|
||||
### 中優先級
|
||||
1. [ ] 設計社交功能的互動介面
|
||||
2. [ ] 建立輔助功能使用數據的分析追蹤 *(新增)*
|
||||
3. [ ] 優化輔助功能成就的觸發時機和用戶體驗 *(新增)*
|
||||
4. [ ] 規劃競賽活動的舉辦週期和規則
|
||||
5. [ ] 建立學習數據的分析和建議算法
|
||||
6. [ ] 設計個性化推薦系統
|
||||
|
||||
### 低優先級
|
||||
1. [ ] 研究遊戲化的心理學原理應用
|
||||
2. [ ] 探索AR/VR技術在闖關系統的應用
|
||||
3. [ ] 建立與外部平台的積分兌換機制
|
||||
4. [ ] 設計線下活動與線上系統的結合
|
||||
|
||||
---
|
||||
|
||||
**最後更新**: 2024年9月5日
|
||||
**負責人**: 待分配
|
||||
**審查週期**: 每兩週檢討一次
|
||||
|
|
@ -0,0 +1,268 @@
|
|||
# UI設計任務清單與規格文件
|
||||
|
||||
## 📋 任務概述
|
||||
|
||||
**專案名稱**：Drama Ling 語言學習應用程式
|
||||
**設計任務**：完成剩餘17個UI介面設計
|
||||
**當前進度**：71/88 (81%)
|
||||
**目標**：達成100%完整UI設計覆蓋
|
||||
|
||||
## 🎯 設計目標與原則
|
||||
|
||||
### 核心設計目標
|
||||
- **一致性**：與已完成的71個UI保持視覺一致性
|
||||
- **易用性**：符合語言學習應用的用戶習慣
|
||||
- **商業導向**：支持鑽石貨幣+訂閱雙軌營收模式
|
||||
- **遊戲化**：體現學習的趣味性和成就感
|
||||
|
||||
### 設計原則
|
||||
- 遵循 `/docs/02_design/ui-ux-guidelines.md` 的設計規範
|
||||
- UI命名格式：`UI_[功能名].png`
|
||||
- 支持iOS和Android雙平台
|
||||
- 考慮不同螢幕尺寸的響應式設計
|
||||
|
||||
## 📊 優先級任務分配
|
||||
|
||||
### 🔥 **第一優先級 - 核心商業功能 (6個)**
|
||||
|
||||
#### 1. UI_SubscriptionPlans - 訂閱方案選擇頁面
|
||||
**功能描述**：展示簡化訂閱系統的VIP方案
|
||||
**關鍵元素**：
|
||||
- 7天免費體驗醒目展示
|
||||
- VIP特權清單（每日3次免費限時挑戰等）
|
||||
- 清楚的價格標示和優惠資訊
|
||||
- 「立即體驗」和「稍後決定」按鈕
|
||||
|
||||
**商業邏輯**：
|
||||
- 次要營收來源，配合鑽石貨幣系統
|
||||
- 強調價值而非價格
|
||||
- 引導用戶先體驗再決定
|
||||
|
||||
**參考流程**：`user-flow-specification.md` 第12節
|
||||
|
||||
#### 2. UI_PaymentFlow - 付費流程頁面
|
||||
**功能描述**：統一的付費確認和處理界面
|
||||
**關鍵元素**：
|
||||
- 購買項目明細（鑽石套餐/訂閱/道具）
|
||||
- 支付方式選擇（Apple Pay/Google Pay/信用卡）
|
||||
- 安全性提示和隱私說明
|
||||
- 付費確認按鈕和取消選項
|
||||
|
||||
**商業邏輯**：
|
||||
- 支援鑽石購買和訂閱付費
|
||||
- 降低付費摩擦，提升轉換率
|
||||
- 建立用戶付費信任感
|
||||
|
||||
#### 3. UI_TimedDialogue - 限時對話頁面
|
||||
**功能描述**：300秒限時挑戰的對話界面
|
||||
**關鍵元素**：
|
||||
- 醒目的倒數計時器（300秒）
|
||||
- 對話進度條
|
||||
- 暫停和加時道具按鈕
|
||||
- 緊急退出確認機制
|
||||
|
||||
**商業邏輯**：
|
||||
- 創造付費需求（加時、暫停道具）
|
||||
- 提升學習強度和參與度
|
||||
- 每日首次免費，後續收費50鑽石
|
||||
|
||||
**參考流程**：`user-flow-specification.md` 第11節
|
||||
|
||||
#### 4. UI_RankingDetail - 排行榜詳情頁面
|
||||
**功能描述**：展示詳細排名資訊和競爭數據
|
||||
**關鍵元素**：
|
||||
- 排名趨勢圖表
|
||||
- 個人vs好友對比數據
|
||||
- 挑戰其他用戶按鈕
|
||||
- 成就和徽章展示區
|
||||
|
||||
**商業邏輯**：
|
||||
- 增強社群競爭動機
|
||||
- 引導更多學習參與
|
||||
- 間接促進道具購買
|
||||
|
||||
#### 5. UI_RewardClaim - 獎勵領取頁面
|
||||
**功能描述**：統一的獎勵領取和確認界面
|
||||
**關鍵元素**：
|
||||
- 獎勵類型圖示（鑽石/經驗值/道具）
|
||||
- 獎勵數量和來源說明
|
||||
- 慶祝動效設計
|
||||
- 「領取」確認按鈕
|
||||
|
||||
**商業邏輯**：
|
||||
- 增強用戶成就感
|
||||
- 鼓勵持續學習行為
|
||||
- 廣告觀看獎勵25-50鑽石
|
||||
|
||||
#### 6. UI_BonusMission_Main - 額外任務主頁面
|
||||
**功能描述**：每日任務和特殊活動的集中展示
|
||||
**關鍵元素**：
|
||||
- 今日任務列表和進度條
|
||||
- 任務獎勵預覽
|
||||
- 完成狀態指示器
|
||||
- 任務重置時間倒數
|
||||
|
||||
**商業邏輯**：
|
||||
- 提升日活躍度
|
||||
- 引導用戶完成更多學習內容
|
||||
- 獎勵機制促進留存
|
||||
|
||||
### 🟡 **第二優先級 - 學習體驗增強 (6個)**
|
||||
|
||||
#### 7. UI_ReviewCards - 複習卡片頁面
|
||||
**功能描述**：間隔複習系統的卡片展示界面
|
||||
**關鍵元素**：
|
||||
- 詞彙卡片設計（正面/背面）
|
||||
- 熟悉度評估按鈕（忘記/困難/簡單）
|
||||
- 複習進度指示器
|
||||
- 批次複習控制
|
||||
|
||||
**學習邏輯**：
|
||||
- 間隔複習演算法：下次複習時間 = 當日 + (2^複習次數)
|
||||
- 支持批量複習提升效率
|
||||
|
||||
#### 8. UI_ReviewProgress - 複習進度頁面
|
||||
**功能描述**：展示個人複習系統的整體進度
|
||||
**關鍵元素**：
|
||||
- 複習統計圖表
|
||||
- 掌握度分析
|
||||
- 待複習詞彙數量
|
||||
- 複習效果趨勢
|
||||
|
||||
#### 9. UI_ReviewSchedule - 複習排程頁面
|
||||
**功能描述**：個人化複習計劃和時間安排
|
||||
**關鍵元素**：
|
||||
- 每日複習計劃
|
||||
- 複習提醒設定
|
||||
- 自定義複習時段
|
||||
- 複習目標設定
|
||||
|
||||
#### 10. UI_BadgeCollection - 徽章收藏頁面
|
||||
**功能描述**：展示用戶獲得的學習成就徽章
|
||||
**關鍵元素**：
|
||||
- 徽章展示網格
|
||||
- 獲得條件說明
|
||||
- 未解鎖徽章預覽
|
||||
- 成就進度條
|
||||
|
||||
#### 11. UI_PurchasedContent - 已購買內容頁面
|
||||
**功能描述**：管理用戶已購買的付費內容
|
||||
**關鍵元素**：
|
||||
- 購買記錄列表
|
||||
- 內容使用狀況
|
||||
- 下載和更新狀態
|
||||
- 退款申請入口
|
||||
|
||||
#### 12. UI_AdOffer - 廣告提供頁面
|
||||
**功能描述**：邀請用戶觀看廣告獲得獎勵
|
||||
**關鍵元素**：
|
||||
- 獎勵預覽（25-50鑽石）
|
||||
- 廣告時長說明
|
||||
- 「觀看廣告」大按鈕
|
||||
- 「稍後再說」選項
|
||||
|
||||
### 🟢 **第三優先級 - 輔助功能完善 (5個)**
|
||||
|
||||
#### 13. UI_AdViewing - 廣告觀看頁面
|
||||
**功能描述**：廣告播放過程中的界面
|
||||
**關鍵元素**：
|
||||
- 廣告進度條
|
||||
- 剩餘時間顯示
|
||||
- 不可跳過提示
|
||||
- 播放控制（如需要）
|
||||
|
||||
#### 14-17. **其他輔助UI**
|
||||
- 錯誤處理頁面
|
||||
- 載入狀態頁面
|
||||
- 網路連接異常頁面
|
||||
- 維護公告頁面
|
||||
|
||||
## 📐 設計規格要求
|
||||
|
||||
### 通用規格
|
||||
- **解析度**：支援1x, 2x, 3x多種解析度
|
||||
- **格式**：PNG格式，透明背景（如需要）
|
||||
- **色彩**：遵循品牌色彩規範
|
||||
- **字體**：支援中文和英文字體規範
|
||||
|
||||
### 響應式設計
|
||||
- **手機版**：375px - 414px 寬度
|
||||
- **平板版**：768px - 1024px 寬度
|
||||
- **考慮**：橫豎屏切換適配
|
||||
|
||||
### 無障礙設計
|
||||
- **色彩對比**：符合WCAG 2.1 AA標準
|
||||
- **字體大小**：最小12pt，重要資訊14pt以上
|
||||
- **觸控區域**：最小44x44pt
|
||||
|
||||
## 🔍 參考資源
|
||||
|
||||
### 必讀文件
|
||||
1. **設計規範**：`/docs/02_design/ui-ux-guidelines.md`
|
||||
2. **用戶流程**：`/docs/04_technical/user-flow-specification.md`
|
||||
3. **系統架構**：`/docs/01_requirement/system_structure_design.json`
|
||||
4. **產品需求**：`/docs/01_requirement/requirements.md`
|
||||
|
||||
### 現有設計參考
|
||||
- **已完成UI**：`/docs/02_design/views/` (71個檔案)
|
||||
- **風格一致性**：參考現有登入、學習、結果頁面設計
|
||||
|
||||
## 💎 關鍵商業邏輯提醒
|
||||
|
||||
### 鑽石貨幣系統
|
||||
- **新手包**：500鑽石 = NT$30
|
||||
- **價值包**：2,500鑽石 = NT$99 (最受歡迎)
|
||||
- **至尊包**：12,000鑽石 = NT$390
|
||||
|
||||
### 道具定價
|
||||
- **回覆提示**：30鑽石/次 (最常用微付費)
|
||||
- **補命道具**：100鑽石/個
|
||||
- **加時道具**：300鑽石/個 (限時挑戰用)
|
||||
|
||||
### 生命系統
|
||||
- **上限**：5條命
|
||||
- **自動回復**：定時回復機制
|
||||
- **付費補充**：100鑽石購買補命道具
|
||||
|
||||
## ⏰ 交付計劃
|
||||
|
||||
### 第一週：高優先級設計 (6個)
|
||||
- 完成核心商業功能UI設計
|
||||
- 重點：訂閱、付費、限時挑戰界面
|
||||
|
||||
### 第二週：中優先級設計 (6個)
|
||||
- 完成學習體驗增強UI設計
|
||||
- 重點：複習系統、徽章收藏界面
|
||||
|
||||
### 第三週：低優先級與優化 (5個)
|
||||
- 完成輔助功能UI設計
|
||||
- 整體設計一致性檢查和優化
|
||||
|
||||
## 📝 交付標準
|
||||
|
||||
### 設計檔案
|
||||
- **主檔案**：Sketch/Figma源檔案
|
||||
- **切圖檔**：PNG格式，分1x/2x/3x解析度
|
||||
- **命名規則**：UI_[功能名].png
|
||||
|
||||
### 說明文件
|
||||
- 每個UI的設計說明和互動邏輯
|
||||
- 特殊狀態和動效需求說明
|
||||
- 與開發團隊的交接文件
|
||||
|
||||
### 品質檢查
|
||||
- [ ] 視覺一致性檢查
|
||||
- [ ] 用戶流程完整性驗證
|
||||
- [ ] 商業邏輯正確性確認
|
||||
- [ ] 無障礙設計合規性檢查
|
||||
|
||||
---
|
||||
|
||||
## 🤝 設計團隊協作
|
||||
|
||||
**專案聯絡人**：[產品經理姓名]
|
||||
**設計評審週期**：每週二、四
|
||||
**檔案交付位置**：`/docs/02_design/views/`
|
||||
**意見回饋管道**：[協作工具/群組]
|
||||
|
||||
**預祝設計順利！** 🎨✨
|
||||
File diff suppressed because it is too large
Load Diff
Binary file not shown.
|
After Width: | Height: | Size: 46 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 13 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 31 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 41 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 28 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 23 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 30 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 33 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 48 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 51 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 51 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 33 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 10 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 14 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 55 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 9.7 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 40 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 5.4 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 111 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 5.2 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 5.4 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 5.5 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 12 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 33 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 29 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 42 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 62 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 36 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 27 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 30 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 60 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 16 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 32 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 58 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 25 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 23 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 26 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 39 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 9.1 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 38 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 37 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 36 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 31 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 36 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 36 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 29 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 28 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 32 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 36 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 50 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 15 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 35 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 56 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 23 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 58 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 58 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 62 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 22 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 47 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 39 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 39 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 55 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 32 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 61 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 64 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 112 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 60 KiB |
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue