提交修改,后台管理页面bug修复,已经发布后台管理界面V1.0版本
This commit is contained in:
@@ -108,6 +108,22 @@
|
||||
- **THEN** 显示抽屉式菜单(点击菜单按钮展开)
|
||||
- **AND** 菜单包含:首页、会话记录管理、用户管理等功能入口
|
||||
|
||||
实现约束(移动端可靠性):
|
||||
- 手机端抽屉菜单 SHOULD 使用 Element Plus `el-drawer` 自带的显示/隐藏机制
|
||||
- 菜单 SHOULD 使用 Element Plus `el-menu`(router 模式)
|
||||
- 抽屉的打开 SHALL 由 Header 菜单按钮通过事件触发
|
||||
- 不依赖 class + CSS transform 的方式实现“展开/收起”(避免出现 class 变化但 UI 无响应)
|
||||
|
||||
#### Scenario: 手机端点击按钮打开菜单(事件触发)
|
||||
- **WHEN** 管理员在手机端点击 Header 的菜单按钮
|
||||
- **THEN** 系统通过事件触发打开 `el-drawer`
|
||||
- **AND** 抽屉内显示 `el-menu` 导航项
|
||||
|
||||
#### Scenario: 手机端点击菜单项自动收起
|
||||
- **WHEN** 管理员在抽屉中点击任一菜单项
|
||||
- **THEN** 路由跳转到对应页面
|
||||
- **AND** 抽屉自动关闭
|
||||
|
||||
### Requirement: 模块化设计
|
||||
前端管理网站 SHALL 采用模块化设计思路。
|
||||
|
||||
@@ -173,6 +189,23 @@
|
||||
- **WHEN** 管理端提交包含多个筛选条件的查询请求
|
||||
- **THEN** 系统返回同时满足所有条件的会话记录
|
||||
|
||||
### Requirement: 会话记录筛选(时间范围,移动端友好)
|
||||
|
||||
管理端会话记录页面 SHALL 提供便于移动端使用的时间范围筛选控件:
|
||||
- 使用两个独立日期选择器:开始日期、结束日期
|
||||
- 提供快捷范围选择器:今天、最近3天、最近7天、最近30天
|
||||
- 默认范围为最近7天
|
||||
|
||||
#### Scenario: 默认最近7天
|
||||
- **WHEN** 管理员进入会话记录页面
|
||||
- **THEN** 页面默认选中“最近7天”
|
||||
- **AND** 查询请求携带对应的 `StartTime/EndTime`
|
||||
|
||||
#### Scenario: 移动端可用性
|
||||
- **WHEN** 管理员在移动端访问会话记录页面
|
||||
- **THEN** 快捷选择器与开始/结束日期选择器纵向排列
|
||||
- **AND** 控件全宽显示,避免横向挤压
|
||||
|
||||
### Requirement: 查询用户列表(管理端)
|
||||
系统 SHALL 提供接口返回可用用户列表,用于管理侧选择/筛选。
|
||||
|
||||
@@ -195,6 +228,25 @@
|
||||
- **THEN** 返回已完善基础信息且未禁用的用户
|
||||
- **AND** 结果按首次登录时间倒序排列
|
||||
|
||||
### Requirement: 首页统计(管理端)
|
||||
|
||||
系统 SHALL 提供聚合统计接口供管理端首页展示关键指标。
|
||||
|
||||
接口:`GET /api/Admin/QueryStats`
|
||||
|
||||
返回(成功):
|
||||
- `success: true`
|
||||
- `data`:包含以下字段的对象
|
||||
- `ActiveUsers`:最近 7 天内 `UpdateTime` 有更新,且 `UserKey` 与 `PhoneNumber` 均不为空的用户数
|
||||
- `TotalConversations`:`xcx_conversation` 总记录数
|
||||
- `TodayNewConversations`:`xcx_conversation.CreateTime` 在“今天”内的记录数
|
||||
- `TotalUsers`:`xcx_users` 中 `UserKey` 与 `PhoneNumber` 均不为空的用户总数
|
||||
|
||||
#### Scenario: 首页加载统计卡片
|
||||
- **WHEN** 管理员进入首页(Home)
|
||||
- **THEN** 前端调用 `GET /api/Admin/QueryStats`
|
||||
- **AND** 将返回的四个数字分别展示到“系统统计卡片”的四个位置
|
||||
|
||||
## Known Limitations
|
||||
- 当前接口未提供分页与导出能力(若管理端数据量很大,需在后续能力中补齐)。
|
||||
- 当前未强制鉴权(JWT 配置存在但未启用认证中间件/授权标注)。
|
||||
|
||||
Reference in New Issue
Block a user