Twilioapp/BILLING_FEATURES.md
2025-06-29 01:33:41 +08:00

130 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 移动端计费功能实现总结
## 已实现的功能
### 1. 计费系统核心功能 (`src/types/billing.ts`)
- ✅ 用户类型定义:个人用户和企业用户
- ✅ 通话类型:语音通话和视频通话
- ✅ 翻译类型:文本翻译、手语翻译、人工翻译
- ✅ 计费规则配置
- ✅ 用户账户信息管理
- ✅ 预约信息结构
- ✅ 翻译员信息管理
- ✅ 通话记录和充值记录
### 2. 计费服务 (`src/services/billingService.ts`)
- ✅ 单例模式的计费服务类
- ✅ 根据用户类型设置不同的计费规则
- ✅ 通话费用计算(基于通话类型、翻译类型、时长、翻译员费率)
- ✅ 余额检查和扣费功能
- ✅ 低余额警告
- ✅ 账户充值功能
- ✅ 金额格式化显示
### 3. 预约服务 (`src/services/appointmentService.ts`)
- ✅ 预约管理服务
- ✅ 翻译员管理和可用性检查
- ✅ 预约创建、查询、更新、取消
- ✅ 时间冲突检查
- ✅ 按日期和月份筛选预约
- ✅ 模拟数据初始化
### 4. 移动端首页更新 (`src/pages/mobile/Home.tsx`)
- ✅ 用户账户余额显示
- ✅ 账户类型显示
- ✅ 快捷操作按钮(语音通话、视频通话、预约通话、账户充值)
- ✅ 即将到来的预约预览
- ✅ 最近活动记录(包含费用信息)
- ✅ 美观的卡片式布局
### 5. 移动端通话页面 (`src/pages/mobile/Call.tsx`)
- ✅ 支持语音和视频通话选择
- ✅ 翻译类型选择(文本、手语、人工翻译)
- ✅ 实时费用计算和显示
- ✅ 账户余额监控
- ✅ 通话时长计时
- ✅ 翻译员选择(人工翻译时)
- ✅ 翻译历史记录
- ✅ 自动扣费功能
### 6. 移动端充值页面 (`src/pages/mobile/Recharge.tsx`)
- ✅ 预设充值金额选择
- ✅ 自定义充值金额输入
- ✅ 充值赠送金额计算
- ✅ 多种支付方式支持
- ✅ 充值历史记录查看
- ✅ 账户余额实时显示
- ✅ 充值成功后余额更新
### 7. 移动端预约页面 (`src/pages/mobile/Appointment.tsx`)
- ✅ 通话类型选择(语音/视频)
- ✅ 翻译类型选择
- ✅ 日期和时间选择未来7天
- ✅ 语言对选择
- ✅ 翻译员选择(基于语言和日期可用性)
- ✅ 预估费用计算
- ✅ 余额充足性检查
- ✅ 预约创建和确认
### 8. 移动端设置页面 (`src/pages/mobile/Settings.tsx`)
- ✅ 用户信息展示(账户类型、余额)
- ✅ 账户管理功能
- ✅ 通话设置选项
- ✅ 翻译设置选项
- ✅ 通知设置管理
- ✅ 帮助和反馈入口
- ✅ 退出登录功能
### 9. 路由配置更新 (`src/routes/index.tsx`)
- ✅ 新增充值页面路由 `/mobile/recharge`
- ✅ 新增预约页面路由 `/mobile/appointment`
- ✅ 移动端路由完整配置
## 核心计费逻辑
### 费率配置
- **语音通话 + 文本翻译**: ¥0.50/分钟
- **视频通话 + 手语翻译**: ¥1.00/分钟
- **视频通话 + 人工翻译**: ¥2.00/分钟 + 翻译员费率
### 用户类型差异
- **个人用户**: 使用标准费率
- **企业用户**: 可配置专属费率和信用额度
### 余额管理
- 低余额警告不足5分钟通话费用时提醒
- 最低余额限制不足1分钟通话费用时禁止通话
- 自动扣费:通话结束后自动从账户余额扣除费用
### 充值优惠
- 充值金额越大,赠送比例越高
- 支持多种支付方式(微信、支付宝、银行卡等)
## 技术特性
- 🎯 **TypeScript 类型安全**: 完整的类型定义确保代码质量
- 🏗️ **单例模式**: 服务类使用单例模式确保数据一致性
- 💾 **模拟数据**: 完整的模拟数据支持开发和测试
- 🎨 **响应式设计**: 适配移动端的美观界面
-**实时计算**: 费用和余额实时更新
- 🔒 **余额保护**: 多重余额检查防止超支
## 使用流程
1. **用户注册/登录** → 获得初始账户和余额
2. **查看余额** → 在首页或设置页面查看当前余额
3. **充值账户** → 选择金额和支付方式进行充值
4. **预约通话** → 选择时间、类型、翻译员创建预约
5. **开始通话** → 选择通话类型和翻译方式
6. **实时计费** → 通话过程中显示累计费用
7. **自动扣费** → 通话结束后自动从余额扣除费用
8. **查看记录** → 在首页查看通话历史和费用记录
## 下一步开发建议
1. **后端集成**: 连接真实的后端API替换模拟数据
2. **支付集成**: 集成真实的支付网关
3. **推送通知**: 实现余额不足和预约提醒
4. **数据持久化**: 实现本地数据存储
5. **错误处理**: 完善网络错误和支付失败处理
6. **单元测试**: 为核心计费逻辑添加测试用例