146 lines
3.5 KiB
Markdown
146 lines
3.5 KiB
Markdown
|
# 礼物系统完整部署指南
|
|||
|
|
|
|||
|
|
## 一、系统功能
|
|||
|
|
|
|||
|
|
### 1. 礼物列表（礼物配置）
|
|||
|
|
- 显示所有可用礼物（玫瑰、巧克力、跑车等）
|
|||
|
|
- 可以添加、编辑、删除礼物
|
|||
|
|
- 设置礼物价格、图标、排序
|
|||
|
|
- 启用/禁用礼物
|
|||
|
|
|
|||
|
|
### 2. 打赏记录
|
|||
|
|
- 显示所有用户的打赏记录
|
|||
|
|
- 谁送了什么礼物给哪个主播
|
|||
|
|
- 在哪个直播间送的
|
|||
|
|
- 礼物数量和总价值
|
|||
|
|
- 支持按关键词、日期筛选
|
|||
|
|
- 显示统计数据（总礼物数、总价值、今日数据）
|
|||
|
|
|
|||
|
|
### 3. 充值套餐
|
|||
|
|
- 显示所有充值套餐配置
|
|||
|
|
- 可以编辑套餐金额、赠送比例
|
|||
|
|
- 设置热门推荐
|
|||
|
|
|
|||
|
|
## 二、部署步骤
|
|||
|
|
|
|||
|
|
### 步骤1：部署后端
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 运行部署脚本
|
|||
|
|
deploy-gift-records-fix.bat
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
或手动执行：
|
|||
|
|
```bash
|
|||
|
|
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：部署前端
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd Zhibo/admin
|
|||
|
|
npm run build:prod
|
|||
|
|
|
|||
|
|
# 上传到服务器
|
|||
|
|
scp -r dist/* root@1.15.149.240:/www/wwwroot/admin/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 步骤3：验证数据
|
|||
|
|
|
|||
|
|
运行SQL检查数据：
|
|||
|
|
```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
|
|||
|
|
|
|||
|
|
## 八、后续优化
|
|||
|
|
|
|||
|
|
1. 添加礼物图片上传功能
|
|||
|
|
2. 添加礼物动画效果预览
|
|||
|
|
3. 添加打赏记录导出功能
|
|||
|
|
4. 添加收礼/送礼排行榜
|
|||
|
|
5. 添加礼物收益统计图表
|