# 后台使用说明

## 1. 后台地址

本地开发地址：

```text
http://127.0.0.1:5173/
```

## 2. 登录账号

默认管理员账号：

1. 用户名：`admin`
2. 密码：`Admin@123456`

## 3. 接口地址配置

后台管理端已改为通过 Vite 环境变量读取接口地址。

配置文件：

1. `admin-web/.env.development`
2. `admin-web/.env.example`

默认配置：

```env
VITE_API_BASE_URL=http://127.0.0.1:8000/api/v1
```

如果后端地址变化，只需要修改这个变量，不需要再去页面代码里逐个替换。

## 4. 已有功能模块

当前后台已支持：

1. 数据看板
2. 待审核工作台
3. 用户管理
4. 活动管理
5. 公告管理
6. 匹配记录
7. 系统设置

## 5. 模块说明

### 5.1 数据看板

支持查看：

1. 总用户数
2. 7 日活跃用户
3. 待审核用户数
4. 活动总数
5. 进行中活动数
6. 总匹配数
7. 匹配率
8. 用户增长趋势图
9. 匹配增长趋势图

### 5.2 待审核工作台

支持：

1. 查看待审核用户队列
2. 打开右侧详情抽屉查看资料
3. 审核通过
4. 驳回并填写原因
5. 审核完成后自动切换下一位

### 5.3 用户管理

支持：

1. 搜索昵称/真实姓名
2. 按审核状态筛选
3. 按性别筛选
4. 查看用户详情
5. 封禁/解封用户

### 5.4 活动管理

支持：

1. 快捷创建活动
2. 独立新建活动页
3. 编辑活动
4. 发布/下架活动
5. 删除活动
6. 按标题/分类/发布状态筛选
7. 查看报名详情
8. 按性别/报名状态筛选报名名单
9. 导出报名名单 CSV

注意：

1. 已有报名记录的活动不可删除

### 5.5 公告管理

支持：

1. 创建公告
2. 编辑公告
3. 预览公告
4. 删除公告
5. 按标题/发布状态筛选

### 5.6 匹配记录

支持：

1. 查看匹配记录
2. 按用户 ID 筛选
3. 按日期区间筛选

### 5.7 系统设置

支持：

1. AI 权重调整
2. 每日推荐上限配置

## 6. 常见问题

### 6.1 登录后提示失效

后台已接入统一鉴权处理，接口返回 401 时会自动清除本地 token 并跳回登录页。

### 6.2 页面没有数据

优先检查：

1. 后端是否启动
2. `http://127.0.0.1:8000/health` 是否正常
3. `admin-web/.env.development` 中接口地址是否正确

### 6.3 后台改完地址没生效

修改 `.env.development` 后需要重新启动前端开发服务：

```bash
npm run dev
```

## 7. 当前仍可继续增强的方向

1. 管理员账号管理
2. 更细的角色权限
3. 看板更多维度图表
4. 更丰富的用户画像展示
5. 报名名单导出更多字段