# 礼物系统完整部署指南

## 一、系统功能

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