zhibo/余额系统改造说明.md

余额系统改造说明

改造内容

1. 前端显示修改

• APP端：将所有"虎牙币"改为"余额"
  • activity_wallet.xml - 钱包页面标题
  • item_recharge_package.xml - 充值套餐显示
  • RechargePackageAdapter.java - 充值套餐适配器

2. 后端字段修改

• 余额字段：从 virtual_balance 改为 now_money
• 涉及文件：
  • VirtualCurrencyController.java - 虚拟货币控制器
  • GiftSystemController.java - 礼物系统控制器

3. 功能说明

余额查询

• 接口：GET /api/front/virtual-currency/balance
• 字段：使用 eb_user.now_money
• 返回：用户当前余额

充值功能

• 接口：POST /api/front/virtual-currency/recharge/create
• 操作：充值金额增加到 eb_user.now_money
• 记录：在 eb_virtual_currency_recharge 表记录充值订单
• 交易：在 eb_virtual_currency_transaction 表记录交易明细

礼物打赏

• 接口：POST /api/front/gift-system/send
• 操作：从 eb_user.now_money 扣除礼物价格
• 记录：在 eb_gift_record 表记录礼物赠送
• 交易：在 eb_virtual_currency_transaction 表记录消费明细

数据库字段

eb_user 表

now_money DECIMAL(10,2) DEFAULT 0.00 COMMENT '用户余额'

优势

1. 统一管理：所有余额相关操作都使用 now_money 字段
2. 兼容性好：now_money 是系统原有字段，无需新建
3. 易于扩展：后续可以添加更多余额相关功能

部署步骤

1. 编译后端

cd Zhibo\zhibo-h
mvn clean package -DskipTests

2. 部署到服务器

# 使用部署脚本
deploy-balance-system.bat

3. 编译APP

在Android Studio中重新编译APP

测试验证

1. 余额查询

• 登录APP
• 进入钱包页面
• 查看余额显示是否正确

2. 充值测试

• 选择充值套餐
• 使用模拟支付
• 验证余额是否增加

3. 礼物打赏测试

• 进入直播间
• 送出礼物
• 验证余额是否扣除

注意事项

1. 数据迁移：如果之前使用了 virtual_balance，需要将数据迁移到 now_money
2. 并发控制：余额扣除使用数据库事务保证原子性
3. 余额不足：送礼物时会检查余额，不足时提示充值

后续优化

1. 添加余额变动推送通知
2. 支持真实支付接口（支付宝/微信）
3. 添加余额提现功能（针对主播）
4. 完善交易记录查询和导出