zhibo/粉丝团功能开发说明.md

# 粉丝团功能开发说明

## 功能概述

粉丝团是主播与粉丝之间建立更紧密联系的功能，粉丝可以加入主播的粉丝团，获得专属徽章，通过送礼物等方式增加亲密度和等级。

## 数据库表结构

### eb_fan_group（粉丝团表）
| 字段 | 类型 | 说明 |
|------|------|------|
| id | int | 主键ID |
| anchor_id | int | 主播ID |
| anchor_name | varchar | 主播昵称 |
| name | varchar | 粉丝团名称 |
| badge | varchar | 粉丝徽章 |
| badge_color | varchar | 徽章颜色 |
| member_count | int | 成员数量 |
| status | tinyint | 状态(1正常 0解散) |
| create_time | datetime | 创建时间 |

### eb_fan_group_member（粉丝团成员表）
| 字段 | 类型 | 说明 |
|------|------|------|
| id | int | 主键ID |
| group_id | int | 粉丝团ID |
| uid | int | 用户ID |
| nickname | varchar | 用户昵称 |
| level | int | 粉丝等级(1-10) |
| intimacy | int | 亲密度 |
| status | tinyint | 状态(1正常 0退出) |
| join_time | datetime | 加入时间 |

## 后端API

### APP端接口 (FanGroupController)
路径前缀: `/api/front/fan-group`

| 接口 | 方法 | 说明 |
|------|------|------|
| /my | GET | 获取我的粉丝团（主播） |
| /streamer/{streamerId} | GET | 获取主播的粉丝团 |
| /create | POST | 创建粉丝团 |
| /update | POST | 更新粉丝团信息 |
| /join/{groupId} | POST | 加入粉丝团 |
| /leave/{groupId} | POST | 退出粉丝团 |
| /joined | GET | 获取我加入的粉丝团列表 |
| /{groupId}/members | GET | 获取粉丝团成员列表 |
| /{groupId}/check-joined | GET | 检查是否已加入 |
| /{groupId}/add-intimacy | POST | 增加亲密度 |

### 后台管理接口 (FanGroupController - admin)
路径前缀: `/api/admin/fan/group`

| 接口 | 方法 | 说明 |
|------|------|------|
| /list | GET | 粉丝团列表 |
| /delete/{id} | POST | 删除粉丝团 |
| /batch-delete | POST | 批量删除 |
| /member/list | GET | 成员列表 |
| /member/delete/{id} | POST | 移除成员 |

## Android端实现

### 新增文件
1. `MyFanGroupActivity.java` - 我的粉丝团页面（主播视角）
2. `activity_my_fan_group.xml` - 布局文件
3. `dialog_create_fan_group.xml` - 创建/编辑粉丝团对话框
4. `item_fan_group_member.xml` - 成员列表项布局
5. `bg_badge.xml` - 徽章背景
6. `bg_level_tag.xml` - 等级标签背景

### 入口位置
- 主播中心页面 (StreamerCenterActivity) 添加"我的粉丝团"入口

### ApiService新增接口
```java
// 粉丝团接口
@GET("api/front/fan-group/my")
Call<ApiResponse<Map<String, Object>>> getMyFanGroup();

@GET("api/front/fan-group/streamer/{streamerId}")
Call<ApiResponse<Map<String, Object>>> getStreamerFanGroup(@Path("streamerId") int streamerId);

@POST("api/front/fan-group/create")
Call<ApiResponse<Map<String, Object>>> createFanGroup(@Body Map<String, Object> request);

@POST("api/front/fan-group/update")
Call<ApiResponse<String>> updateFanGroup(@Body Map<String, Object> request);

@POST("api/front/fan-group/join/{groupId}")
Call<ApiResponse<String>> joinFanGroup(@Path("groupId") int groupId);

@POST("api/front/fan-group/leave/{groupId}")
Call<ApiResponse<String>> leaveFanGroup(@Path("groupId") int groupId);

@GET("api/front/fan-group/joined")
Call<ApiResponse<PageResponse<Map<String, Object>>>> getJoinedFanGroups(...);

@GET("api/front/fan-group/{groupId}/members")
Call<ApiResponse<PageResponse<Map<String, Object>>>> getFanGroupMembers(...);

@GET("api/front/fan-group/{groupId}/check-joined")
Call<ApiResponse<Map<String, Object>>> checkFanGroupJoined(@Path("groupId") int groupId);
```

## 后台管理前端

### 已有文件
- `Zhibo/admin/src/views/fanGroup/list/index.vue` - 粉丝团列表页面
- `Zhibo/admin/src/api/fanGroup.js` - API接口定义
- `Zhibo/admin/src/router/modules/fanGroup.js` - 路由配置

### 菜单配置
执行以下SQL显示粉丝团菜单：
```sql
UPDATE eb_system_menu SET is_show = 1 WHERE id = 663;
```

## 等级规则

粉丝等级根据亲密度自动升级：
- Lv.1: 0-999 亲密度
- Lv.2: 1000-1999 亲密度
- Lv.3: 2000-2999 亲密度
- ...
- Lv.10: 9000+ 亲密度

亲密度获取方式：
- 送礼物（礼物价值 = 亲密度增加值）
- 每日签到（+10亲密度）
- 观看直播（每分钟+1亲密度）

## 部署步骤

1. 执行SQL修复菜单显示
2. 重新编译后端项目
3. 重新编译Android项目
4. 重启后端服务

## 后续优化

1. 粉丝团聊天功能（基于群组系统扩展）
2. 粉丝团专属礼物
3. 粉丝团排行榜
4. 粉丝团活动