3.5 KiB
3.5 KiB
礼物系统完整部署指南
一、系统功能
1. 礼物列表（礼物配置）
- 显示所有可用礼物（玫瑰、巧克力、跑车等）
- 可以添加、编辑、删除礼物
- 设置礼物价格、图标、排序
- 启用/禁用礼物
2. 打赏记录
- 显示所有用户的打赏记录
- 谁送了什么礼物给哪个主播
- 在哪个直播间送的
- 礼物数量和总价值
- 支持按关键词、日期筛选
- 显示统计数据（总礼物数、总价值、今日数据）
3. 充值套餐
- 显示所有充值套餐配置
- 可以编辑套餐金额、赠送比例
- 设置热门推荐
二、部署步骤
步骤1：部署后端
# 运行部署脚本
deploy-gift-records-fix.bat
或手动执行：
cd Zhibo/zhibo-h
mvn clean package -DskipTests -Pdev
# 上传到服务器
scp crmeb-admin/target/crmeb-admin.jar root@1.15.149.240:/www/server/java/
# 重启服务
ssh root@1.15.149.240 "cd /www/server/java && ./stop.sh && ./start.sh"
步骤2：部署前端
cd Zhibo/admin
npm run build:prod
# 上传到服务器
scp -r dist/* root@1.15.149.240:/www/wwwroot/admin/
步骤3：验证数据
运行SQL检查数据：
-- 检查礼物配置
SELECT * FROM eb_gift_config ORDER BY sort_order;
-- 检查礼物记录
SELECT COUNT(*) FROM eb_gift_record;
-- 检查充值套餐
SELECT * FROM eb_recharge_package ORDER BY sort_order;
三、菜单结构
礼物打赏
├── 礼物列表 - 管理礼物配置（玫瑰、巧克力等）
├── 打赏记录 - 查看所有打赏记录和统计
└── 充值套餐 - 管理充值套餐配置
四、API接口
礼物配置
- GET
/api/admin/gift/config/list- 获取礼物列表 - POST
/api/admin/gift/config/add- 添加礼物 - POST
/api/admin/gift/config/update- 更新礼物 - POST
/api/admin/gift/config/delete/{id}- 删除礼物
打赏记录
- GET
/api/admin/gift/records- 获取打赏记录列表 - GET
/api/admin/gift/statistics- 获取统计数据
充值套餐
- GET
/api/admin/gift/recharge/packages- 获取充值套餐 - POST
/api/admin/gift/recharge/package/update- 更新套餐
五、数据库表
eb_gift_config - 礼物配置表
存储礼物的基本信息（名称、图标、价格等）
eb_gift_record - 礼物记录表
存储所有打赏记录，包括：
- sender_id, sender_name - 送礼者
- receiver_id, receiver_name - 接收者（主播）
- room_id - 直播间
- gift_id, gift_name - 礼物信息
- quantity - 数量
- total_price - 总价
eb_recharge_package - 充值套餐表
存储充值套餐配置
eb_user.virtual_balance - 用户虚拟货币余额
存储在用户表的 virtual_balance 字段
六、测试数据
数据库中已有测试数据：
- 10个礼物配置（玫瑰、巧克力、棒棒糖等）
- 12条打赏记录
- 6个充值套餐
- 测试用户43、44有10000虚拟币余额
七、常见问题
1. 页面显示"暂无数据"
- 检查后端是否正常启动
- 检查API接口是否返回数据
- 查看浏览器控制台是否有错误
2. 数据不显示
- 确认数据库中有数据
- 检查后端SQL查询是否正确
- 查看后端日志
3. 字段不匹配错误
- 已修复：quantity 字段
- 已修复：sender_nickname, receiver_nickname 使用 COALESCE
- 已修复：is_live 替代 status
八、后续优化
- 添加礼物图片上传功能
- 添加礼物动画效果预览
- 添加打赏记录导出功能
- 添加收礼/送礼排行榜
- 添加礼物收益统计图表