xiangqinxiaochengxu/后台使用说明.md

后台使用说明

1. 后台地址

本地开发地址：

http://127.0.0.1:5173/

2. 登录账号

默认管理员账号：

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

3. 接口地址配置

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

配置文件：

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

默认配置：

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 后需要重新启动前端开发服务：

npm run dev

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

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