lanyuanxiaoyao
548b44d28e
表格布局替换为按分组展示的卡片式布局，新增 group 字段配置和 TargetBoard/TargetCard 等组件。模态框详情页支持时间范围筛选和分页，SummaryCards 减为 3 个。API 端点变更：trend/history 改用 from/to 参数，history 支持分页。recentSampleCount 硬编码为 30。
77 lines
3.4 KiB
Markdown
77 lines
3.4 KiB
Markdown
## Purpose
|
||
|
||
定义目标详情模态框：时间范围筛选（快捷按钮 + 日期选择器）、多维统计图（可用率趋势、耗时趋势、状态分布环形图）和分页检查结果列表。
|
||
|
||
## Requirements
|
||
|
||
### Requirement: 目标详情模态框
|
||
Dashboard SHALL 在用户点击目标卡片后弹出模态框，展示该目标的详细统计图表和检查结果列表。
|
||
|
||
#### Scenario: 打开模态框
|
||
- **WHEN** 用户点击某个目标卡片
|
||
- **THEN** 系统 SHALL 弹出模态框，占据视口 80% 宽度，展示该目标的详情
|
||
|
||
#### Scenario: 模态框默认时间范围
|
||
- **WHEN** 模态框打开
|
||
- **THEN** 筛选器 SHALL 默认选中"最近 24 小时"
|
||
|
||
#### Scenario: 关闭模态框
|
||
- **WHEN** 用户点击模态框关闭按钮或模态框外部区域
|
||
- **THEN** 模态框 SHALL 关闭
|
||
|
||
### Requirement: 时间范围筛选
|
||
模态框 SHALL 支持通过快捷按钮和自定义日期时间选择器筛选数据的时间范围。
|
||
|
||
#### Scenario: 快捷时间范围按钮
|
||
- **WHEN** 模态框渲染
|
||
- **THEN** 筛选栏 SHALL 显示快捷按钮：1h、6h、24h、7d，当前选中的按钮高亮显示
|
||
|
||
#### Scenario: 点击快捷按钮
|
||
- **WHEN** 用户点击快捷按钮（如 "24h"）
|
||
- **THEN** 筛选器 SHALL 自动设置对应的起止时间，日期选择器显示对应的时间范围，该按钮高亮
|
||
|
||
#### Scenario: 自定义日期时间选择
|
||
- **WHEN** 用户通过日期时间选择器修改起止时间（分钟精度）
|
||
- **THEN** 快捷按钮 SHALL 取消高亮，表示当前为自定义时间范围
|
||
|
||
#### Scenario: 筛选触发数据刷新
|
||
- **WHEN** 时间范围发生变化（快捷按钮或自定义选择）
|
||
- **THEN** 系统 SHALL 重新请求该时间范围内的趋势数据和历史记录
|
||
|
||
### Requirement: 统计图表展示
|
||
模态框图表区 SHALL 展示可用率趋势折线图、耗时趋势折线图和状态分布环形图。
|
||
|
||
#### Scenario: 可用率趋势折线图
|
||
- **WHEN** 模态框加载完成且趋势数据可用
|
||
- **THEN** 图表区 SHALL 展示可用率随时间变化的折线图，Y 轴为可用率百分比
|
||
|
||
#### Scenario: 耗时趋势折线图
|
||
- **WHEN** 模态框加载完成且趋势数据可用
|
||
- **THEN** 图表区 SHALL 展示耗时随时间变化的折线图，Y 轴为耗时毫秒数
|
||
|
||
#### Scenario: 状态分布环形图
|
||
- **WHEN** 模态框加载完成
|
||
- **THEN** 图表区 SHALL 展示环形图（Donut Chart），外圈显示 UP/DOWN 比例（绿色/红色），中间显示可用率百分比数字
|
||
|
||
### Requirement: 检查结果列表
|
||
模态框检查记录列表 SHALL 展示当前筛选时间范围内的检查结果列表，支持分页浏览。
|
||
|
||
#### Scenario: 展示检查结果
|
||
- **WHEN** 模态框加载完成且历史记录可用
|
||
- **THEN** 检查记录列表 SHALL 展示检查结果，每条包含时间戳、UP/DOWN 状态标记、耗时毫秒数、statusDetail 和 failure 信息
|
||
|
||
#### Scenario: 分页导航
|
||
- **WHEN** 检查结果总数超过一页
|
||
- **THEN** 列表底部 SHALL 展示分页器，用户可点击切换页码
|
||
|
||
#### Scenario: 翻页刷新
|
||
- **WHEN** 用户点击分页器切换页码
|
||
- **THEN** 系统 SHALL 请求对应页码的历史记录数据，列表更新
|
||
|
||
### Requirement: 模态框布局
|
||
模态框 SHALL 采用自上而下布局，上方展示统计图表，下方展示检查记录列表。
|
||
|
||
#### Scenario: 自上而下渲染
|
||
- **WHEN** 模态框渲染
|
||
- **THEN** 内容区域 SHALL 分为上下两部分，上方展示统计图表，下方展示检查结果列表和分页器
|