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. 添加礼物收益统计图表
|