155 lines
2.5 KiB
Markdown
155 lines
2.5 KiB
Markdown
|
# 后台使用说明
|
||
|
|
|
||
|
|
## 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. 报名名单导出更多字段
|