lanyuanxiaoyao
57d3a5cfb4
新增 YAML 配置解析（Bun 内置 YAML）、SQLite 数据存储（bun:sqlite）、按 interval 分组并发拨测引擎、REST API（/api/summary、/api/targets、/api/targets/:id/history、/api/targets/:id/trend）、React 前端 Dashboard（统计卡片、目标表格、可展开详情面板、recharts 趋势图）。CLI 简化为仅接受配置文件路径。移除 /api/demo 路由和相关 demo 代码。保留 /health、静态资源服务和 SPA fallback。
2.6 KiB
2.6 KiB
Purpose
定义 HTTP 拨测工具的 YAML 配置文件格式、解析校验规则和 CLI 启动流程。
Requirements
Requirement: YAML 配置文件格式
系统 SHALL 支持通过 YAML 配置文件定义全部运行参数，包括 server 配置、数据目录、拨测默认值和拨测目标列表。
Scenario: 完整配置文件解析
- WHEN 系统启动并读取包含 server、defaults、targets 的 YAML 配置文件
- THEN 系统 SHALL 正确解析所有字段并用于初始化服务
Scenario: 最简配置文件解析
- WHEN 系统读取只包含 targets 列表的 YAML 配置文件（省略 server 和 defaults）
- THEN 系统 SHALL 使用内置默认值填充未指定的字段（host=127.0.0.1, port=3000, dir=./data, interval=30s, timeout=10s, method=GET）
Scenario: per-target 配置覆盖全局默认值
- WHEN 某个 target 指定了 interval、timeout 或 method
- THEN 该 target SHALL 使用其自身的值，不受 defaults 影响
Requirement: CLI 参数
系统 SHALL 通过单一命令行参数接受 YAML 配置文件路径。
Scenario: 指定配置文件启动
- WHEN 用户执行
./gateway-checker ./probes.yaml - THEN 系统 SHALL 读取并解析指定路径的 YAML 文件作为配置
Scenario: 未提供配置文件路径
- WHEN 用户启动程序时未提供任何命令行参数
- THEN 系统 SHALL 以错误退出并提示需要指定配置文件路径
Scenario: 配置文件不存在
- WHEN 用户指定的配置文件路径不存在
- THEN 系统 SHALL 以错误退出并提示文件不存在
Requirement: 配置校验
系统 SHALL 在启动时对 YAML 配置进行完整校验，校验失败时以非零状态退出并输出清晰的错误信息。
Scenario: target 缺少必填字段
- WHEN YAML 中某个 target 缺少 name 或 url 字段
- THEN 系统 SHALL 以错误退出，提示哪个 target 缺少哪个字段
Scenario: target name 重复
- WHEN YAML 中存在两个 name 相同的 target
- THEN 系统 SHALL 以错误退出，提示重复的 name
Scenario: interval 格式非法
- WHEN interval 或 timeout 值不是有效的时长格式（如
30s、5m） - THEN 系统 SHALL 以错误退出并提示格式错误
Requirement: YAML 配置使用 Bun 内置解析
系统 SHALL 使用 Bun 内置的 Bun.YAML.parse() 解析配置文件，不引入外部 YAML 解析库。
Scenario: 解析 YAML 内容
- WHEN 系统读取 YAML 文件内容
- THEN 系统 SHALL 调用
Bun.YAML.parse()将内容解析为配置对象