feat: 将 demo 项目转化为 HTTP 拨测监控工具

新增 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。
2026-05-09 17:04:25 +08:00
parent 9267f6585c
commit 57d3a5cfb4
43 changed files with 2910 additions and 525 deletions
--- a/openspec/specs/frontend-development-workflow/spec.md
+++ b/openspec/specs/frontend-development-workflow/spec.md
@@ -1,6 +1,6 @@
 ## Purpose

-定义 Vite + React + TypeScript 前端开发工作流、开发期 API 代理、共享契约和端到端 demo 的行为要求。
+定义 Vite + React + TypeScript 前端开发工作流、开发期 API 代理和共享契约的行为要求。

 ## Requirements

@@ -18,8 +18,8 @@
 ### Requirement: 前端开发期 API 代理
 前端开发服务器 SHALL 在本地开发期间将 `/api/*` 请求代理到 Bun 后端服务。

-#### Scenario: 前端开发期调用 API
- **WHEN** 浏览器从 Vite 开发源请求 `/api/demo`
+#### Scenario: 前端开发期调用拨测 API
+- **WHEN** 浏览器从 Vite 开发源请求 `/api/summary`、`/api/targets` 等拨测 API
 - **THEN** Vite SHALL 将请求转发到 Bun 后端服务，且不需要浏览器 CORS 配置

 #### Scenario: 开发期访问非 API 前端路由
@@ -52,23 +52,12 @@
 - **WHEN** host 或 port 在开发环境和生产环境之间变化
 - **THEN** 前端 API 调用 SHALL 无需修改源码即可继续工作

-### Requirement: 端到端开发 demo
-项目 SHALL 提供一个可见的开发 demo，用于证明 React 前端可以通过 Vite 代理调用 Bun 后端。
-
-#### Scenario: Demo 页面展示后端响应
- **WHEN** 开发者启动文档化的开发命令并打开前端 URL
- **THEN** 页面 SHALL 调用 `/api/demo` 并展示 Bun 后端返回的数据
-
-#### Scenario: 开发期后端不可用
- **WHEN** 前端 demo 无法访问 `/api/demo`
- **THEN** 页面 SHALL 展示清晰的错误状态，而不是静默显示为成功
-
 ### Requirement: 集成开发命令
-项目 SHALL 提供一个文档化命令，用于在 demo 开发期间同时运行前端和后端。
+项目 SHALL 提供一个文档化命令，用于在开发期间同时运行前端和后端。

 #### Scenario: 启动全栈开发
 - **WHEN** 开发者运行文档化的全栈开发命令
- **THEN** 系统 SHALL 启动 Vite 前端开发服务器和 `/api/demo` 所需的 Bun 后端服务器
+- **THEN** 系统 SHALL 启动 Vite 前端开发服务器和 Bun 后端服务器

 ### Requirement: 开发质量命令文档化
 项目 SHALL 在前端开发工作流文档中说明日常检查和完整验证命令。
--- a/openspec/specs/fullstack-app-runtime/spec.md
+++ b/openspec/specs/fullstack-app-runtime/spec.md
@@ -9,45 +9,34 @@

 #### Scenario: 启动运行时服务器
 - **WHEN** server 进程成功启动
- **THEN** 它 SHALL 监听配置的 host 和 port，并记录实际 server URL
+- **THEN** 它 SHALL 监听 YAML 配置文件中指定的 host 和 port，并记录实际 server URL

-#### Scenario: 提供运行时配置
- **WHEN** 通过支持的运行时配置提供 host 或 port
+#### Scenario: 通过 YAML 配置提供运行时参数
+- **WHEN** 通过 YAML 配置文件提供 host、port、数据目录等参数
 - **THEN** server SHALL 使用该值，且不需要重新构建

+#### Scenario: CLI 只接受配置文件路径
+- **WHEN** 用户通过命令行启动程序
+- **THEN** 系统 SHALL 只接受一个命令行参数作为 YAML 配置文件路径
+
+#### Scenario: 提供拨测相关 API
+- **WHEN** server 启动完成
+- **THEN** 系统 SHALL 提供 `/api/summary`、`/api/targets`、`/api/targets/:id/history`、`/api/targets/:id/trend` 端点
+
 ### Requirement: HTTP method 语义
 系统 SHALL 为运行时端点提供明确的 HTTP method 语义，避免不支持的 method 被错误地当作成功请求处理。

 #### Scenario: GET 请求访问运行时端点
- **WHEN** 客户端使用 `GET` 请求 `/health` 或 `/api/demo`
+- **WHEN** 客户端使用 `GET` 请求 `/health` 或 `/api/*` 端点
 - **THEN** Bun server SHALL 返回对应端点的成功响应

 #### Scenario: HEAD 请求访问运行时端点
- **WHEN** 客户端使用 `HEAD` 请求 `/health` 或 `/api/demo`
+- **WHEN** 客户端使用 `HEAD` 请求 `/health` 或 `/api/*` 端点
 - **THEN** Bun server SHALL 返回与 `GET` 相同的成功状态和 headers，但 MUST NOT 返回响应体

 #### Scenario: 不支持的 method 访问运行时端点
- **WHEN** 客户端使用不支持的 method 请求 `/health` 或 `/api/demo`
- **THEN** Bun server MUST 返回 JSON 405 响应，并带有描述允许 method 的 `Allow` header
-
-### Requirement: 运行配置校验
-系统 SHALL 对运行时 host 和 port 配置提供稳定、可测试的解析与校验行为。
-
-#### Scenario: 使用默认运行配置
- **WHEN** 未提供 host 或 port 覆盖
- **THEN** server SHALL 使用 README 文档化的默认 host 和 port
-
-#### Scenario: CLI 参数优先于环境变量
- **WHEN** CLI 参数和环境变量同时提供同一项运行配置
- **THEN** server SHALL 使用 CLI 参数中的值
-
-#### Scenario: 拒绝无效端口
- **WHEN** port 配置不是整数、小于 0 或大于 65535
- **THEN** server MUST 拒绝启动并报告无效端口
-
-#### Scenario: 接受端口边界值
- **WHEN** port 配置为 0 或 65535
- **THEN** server SHALL 将其作为有效端口配置处理
+- **WHEN** 客户端使用不支持的 method 请求 `/health` 或 `/api/*` 端点
+- **THEN** Bun server SHALL 返回 405 状态码和 Allow header

 ### Requirement: API 路由命名空间
 系统 MUST 将 `/api/*` 保留给后端 API 路由。
@@ -71,17 +60,6 @@
 - **WHEN** 客户端使用不支持的 method 请求已存在的 API 路由
 - **THEN** Bun server MUST 返回包含 `error` 和 `status` 字段的 JSON 405 响应

-### Requirement: Demo API 端点
-系统 SHALL 暴露 `/api/demo` 作为稳定 demo 端点，用于证明前后端集成可用。
-
-#### Scenario: Demo API 成功响应
- **WHEN** 客户端请求 `/api/demo`
- **THEN** Bun server SHALL 返回包含可读 message 和 runtime metadata 的 JSON 响应
-
-#### Scenario: Demo API 内容类型
- **WHEN** 客户端请求 `/api/demo`
- **THEN** Bun server SHALL 返回 JSON content type 的响应
-
 ### Requirement: 健康检查端点
 系统 SHALL 在前端 SPA fallback 之外暴露健康检查端点。

@@ -100,10 +78,6 @@
 - **WHEN** 客户端请求 `/`
 - **THEN** Bun server SHALL 返回前端入口 HTML 文档

-#### Scenario: 生产 demo 页面调用 API
- **WHEN** 客户端从生产 Bun runtime 打开前端页面
- **THEN** demo 页面 SHALL 能够从同源调用 `/api/demo` 并展示后端响应
-
 ### Requirement: 生产缓存策略
 系统 SHALL 为生产静态资源和前端入口 HTML 使用明确的缓存策略。

--- a/openspec/specs/probe-api/spec.md
+++ b/openspec/specs/probe-api/spec.md
@@ -0,0 +1,63 @@
+## Purpose
+
+定义拨测系统的 REST API 端点：总览统计、目标列表含状态、历史记录和趋势聚合。
+
+## Requirements
+
+### Requirement: 总览统计 API
+系统 SHALL 提供 `GET /api/summary` 端点，返回所有目标的总体统计信息。
+
+#### Scenario: 获取总览统计
+- **WHEN** 客户端请求 `GET /api/summary`
+- **THEN** 系统 SHALL 返回 JSON 包含 total（总目标数）、up（正常数）、down（异常数）、avgLatencyMs（所有目标平均延迟）、lastCheckTime（最近一次拨测时间）
+
+### Requirement: 目标列表 API
+系统 SHALL 提供 `GET /api/targets` 端点，返回所有目标及其最新状态和统计摘要。
+
+#### Scenario: 获取目标列表
+- **WHEN** 客户端请求 `GET /api/targets`
+- **THEN** 系统 SHALL 返回 JSON 数组，每个元素包含目标基本信息、最近一次拨测结果（timestamp、success、statusCode、latencyMs、error、matched）和统计摘要（totalChecks、availability、avgLatencyMs、p99LatencyMs）
+
+#### Scenario: 目标无历史记录
+- **WHEN** 某目标尚未执行过任何拨测
+- **THEN** 其 latestCheck 为 null，stats 中 totalChecks 为 0
+
+### Requirement: 历史记录 API
+系统 SHALL 提供 `GET /api/targets/:id/history` 端点，返回指定目标的最近 N 条拨测记录。
+
+#### Scenario: 获取最近历史记录
+- **WHEN** 客户端请求 `GET /api/targets/1/history?limit=20`
+- **THEN** 系统 SHALL 返回最多 20 条拨测记录，按时间倒序排列
+
+#### Scenario: 使用默认 limit
+- **WHEN** 客户端请求 `GET /api/targets/1/history`（未指定 limit）
+- **THEN** 系统 SHALL 默认返回最近 20 条记录
+
+### Requirement: 趋势聚合 API
+系统 SHALL 提供 `GET /api/targets/:id/trend` 端点，返回指定目标按小时聚合的趋势数据。
+
+#### Scenario: 获取 24 小时趋势
+- **WHEN** 客户端请求 `GET /api/targets/1/trend?hours=24`
+- **THEN** 系统 SHALL 返回按小时分组的聚合数据，每个数据点包含 hour、avgLatencyMs、availability、totalChecks
+
+#### Scenario: 使用默认时间范围
+- **WHEN** 客户端请求 `GET /api/targets/1/trend`（未指定 hours）
+- **THEN** 系统 SHALL 默认返回最近 24 小时的趋势数据
+
+### Requirement: 保留健康检查端点
+系统 SHALL 保留 `GET /health` 端点，不受拨测功能影响。
+
+#### Scenario: 访问健康检查
+- **WHEN** 客户端请求 `GET /health`
+- **THEN** 系统 SHALL 返回与之前格式一致的健康检查响应
+
+### Requirement: API 错误处理
+系统 SHALL 对不存在的目标 ID 和无效参数返回适当的 HTTP 错误响应。
+
+#### Scenario: 查询不存在的目标
+- **WHEN** 客户端请求 `GET /api/targets/999/history`
+- **THEN** 系统 SHALL 返回 404 状态码和错误信息
+
+#### Scenario: 无效的 limit 参数
+- **WHEN** 客户端请求 `GET /api/targets/1/history?limit=abc`
+- **THEN** 系统 SHALL 返回 400 状态码和错误信息
--- a/openspec/specs/probe-config/spec.md
+++ b/openspec/specs/probe-config/spec.md
@@ -0,0 +1,57 @@
+## 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()` 将内容解析为配置对象
--- a/openspec/specs/probe-dashboard/spec.md
+++ b/openspec/specs/probe-dashboard/spec.md
@@ -0,0 +1,73 @@
+## Purpose
+
+定义拨测系统的 React 前端 Dashboard：统计卡片、目标列表表格、可展开详情面板和趋势图可视化。
+
+## Requirements
+
+### Requirement: 总览统计卡片
+Dashboard SHALL 在页面顶部展示总览统计卡片，包含总目标数、正常数、异常数和平均延迟。
+
+#### Scenario: 展示统计卡片
+- **WHEN** 用户打开 Dashboard 页面
+- **THEN** 页面顶部 SHALL 显示 4 个统计卡片：全部目标数、正常目标数、异常目标数、所有目标平均延迟
+
+#### Scenario: 统计数据自动刷新
+- **WHEN** 页面处于打开状态
+- **THEN** 统计卡片 SHALL 每 5-10 秒自动刷新数据
+
+### Requirement: 目标列表表格
+Dashboard SHALL 展示所有拨测目标的列表表格，包含名称、URL、当前状态、最新延迟和迷你趋势线。
+
+#### Scenario: 展示目标列表
+- **WHEN** 用户打开 Dashboard 页面
+- **THEN** 页面 SHALL 显示表格，每行包含目标名称、URL、状态指示圆点（● UP / ● DOWN）、最新延迟值、迷你 Sparkline 趋势线
+
+#### Scenario: 状态指示圆点
+- **WHEN** 目标最近一次拨测 success=true 且 matched=true
+- **THEN** 状态圆点 SHALL 显示为绿色（UP）
+- **WHEN** 目标最近一次拨测 success=false 或 matched=false
+- **THEN** 状态圆点 SHALL 显示为红色（DOWN）
+
+### Requirement: 可展开的目标详情面板
+Dashboard SHALL 支持在目标列表中展开某行，显示该目标的详细状态、统计摘要、趋势图和最近历史记录。
+
+#### Scenario: 展开目标详情
+- **WHEN** 用户点击目标列表中的某一行
+- **THEN** 该行下方 SHALL 展开详情面板，包含：可用率百分比、平均延迟、P99 延迟、24 小时延迟趋势折线图、最近 5-10 条拨测记录列表
+
+#### Scenario: 收起目标详情
+- **WHEN** 用户再次点击已展开的目标行
+- **THEN** 详情面板 SHALL 收起
+
+#### Scenario: 趋势图按需加载
+- **WHEN** 用户展开某个目标的详情面板
+- **THEN** 系统 SHALL 此时请求该目标的趋势数据，而非页面加载时预加载所有目标的趋势数据
+
+### Requirement: 历史记录展示
+Dashboard SHALL 在目标详情面板中展示最近的拨测记录，包含时间、状态码、延迟和成功/失败标记。
+
+#### Scenario: 展示历史记录
+- **WHEN** 用户展开目标详情面板
+- **THEN** 面板 SHALL 显示最近拨测记录列表，每条包含时间戳、HTTP 状态码（或错误信息）、延迟毫秒数、成功/失败图标
+
+### Requirement: 趋势图可视化
+Dashboard SHALL 使用 recharts 库渲染趋势图，包括目标列表中的迷你 Sparkline 和详情面板中的完整折线图。
+
+#### Scenario: 表格行内迷你趋势线
+- **WHEN** 目标列表表格渲染
+- **THEN** 每行 SHALL 包含一个基于 recharts 的迷你折线图，展示最近的延迟趋势
+
+#### Scenario: 详情面板完整趋势图
+- **WHEN** 用户展开目标详情面板
+- **THEN** 面板 SHALL 展示基于 recharts 的完整折线图，X 轴为时间（小时），Y 轴为平均延迟，并标注可用率
+
+### Requirement: 页面加载与错误状态
+Dashboard SHALL 正确处理加载状态和 API 错误。
+
+#### Scenario: 首次加载
+- **WHEN** 页面首次加载且数据尚未返回
+- **THEN** 页面 SHALL 显示加载状态指示
+
+#### Scenario: API 请求失败
+- **WHEN** 前端轮询 API 请求失败
+- **THEN** 页面 SHALL 显示错误提示，并在下一次轮询周期自动重试
--- a/openspec/specs/probe-data-store/spec.md
+++ b/openspec/specs/probe-data-store/spec.md
@@ -0,0 +1,60 @@
+## Purpose
+
+定义基于 SQLite 的拨测数据持久化存储：targets 同步、check_results 追加写入、索引与聚合查询。
+
+## Requirements
+
+### Requirement: SQLite 数据库初始化
+系统 SHALL 使用 Bun 内置 `bun:sqlite` 模块在配置的数据目录下创建 SQLite 数据库文件，并以 WAL 模式运行。
+
+#### Scenario: 首次启动创建数据库
+- **WHEN** 指定的数据目录下不存在数据库文件
+- **THEN** 系统 SHALL 创建数据库文件并初始化 targets 和 check_results 表
+
+#### Scenario: 数据目录不存在
+- **WHEN** 配置的数据目录路径不存在
+- **THEN** 系统 SHALL 自动创建该目录
+
+#### Scenario: 数据库已存在时启动
+- **WHEN** 数据库文件已存在
+- **THEN** 系统 SHALL 直接打开数据库，不重新建表
+
+### Requirement: targets 表同步
+系统 SHALL 在启动时将 YAML 配置中的目标列表同步到 SQLite targets 表。
+
+#### Scenario: 首次同步目标
+- **WHEN** 数据库为空且 YAML 中定义了 N 个目标
+- **THEN** 系统 SHALL 将所有目标插入 targets 表
+
+#### Scenario: 配置变更后重新同步
+- **WHEN** YAML 配置发生变更（新增、删除或修改目标）后重启
+- **THEN** 系统 SHALL 根据 name 字段匹配：新增的插入、删除的移除、修改的更新
+
+### Requirement: check_results 表追加写入
+系统 SHALL 将每次拨测结果追加写入 check_results 表，不更新或删除已有记录。
+
+#### Scenario: 写入拨测结果
+- **WHEN** 一次拨测完成
+- **THEN** 系统 SHALL 插入一条包含 target_id、timestamp、success、status_code、latency_ms、error、matched 的记录
+
+### Requirement: 时间范围查询索引
+系统 SHALL 在 check_results 表上创建 (target_id, timestamp) 复合索引，加速按目标和时间范围的查询。
+
+#### Scenario: 查询某目标的历史记录
+- **WHEN** 查询指定 target_id 的最近 N 条记录
+- **THEN** 系统 SHALL 使用索引快速定位，无需全表扫描
+
+### Requirement: 聚合查询支持
+数据存储 SHALL 支持按时间段聚合查询，用于计算可用率、平均延迟、P99 延迟等统计指标。
+
+#### Scenario: 计算目标可用率
+- **WHEN** 查询某目标在指定时间范围内的可用率
+- **THEN** 系统 SHALL 返回 UP (success=true AND matched=true) 的记录数占总记录数的百分比
+
+#### Scenario: 计算目标平均延迟
+- **WHEN** 查询某目标在指定时间范围内的平均延迟
+- **THEN** 系统 SHALL 返回 latency_ms 的平均值（仅计算 success=true 的记录）
+
+#### Scenario: 按小时聚合趋势数据
+- **WHEN** 查询某目标在指定时间范围内的趋势数据
+- **THEN** 系统 SHALL 返回按小时分组的聚合数据，包括每小时的平均延迟和可用率
--- a/openspec/specs/probe-engine/spec.md
+++ b/openspec/specs/probe-engine/spec.md
@@ -0,0 +1,87 @@
+## Purpose
+
+定义拨测调度引擎的行为：按 interval 分组定时、组内并发拨测、expect 结果校验和结果持久化。
+
+## Requirements
+
+### Requirement: 按 interval 分组调度
+系统 SHALL 将拨测目标按 interval 值分组，每组使用独立的定时器进行调度。
+
+#### Scenario: 相同 interval 的目标共享定时器
+- **WHEN** 多个 target 配置了相同的 interval（如 30s）
+- **THEN** 系统 SHALL 使用同一个 `setInterval` 定时器，每次 tick 并发拨测所有该组目标
+
+#### Scenario: 不同 interval 的目标各自调度
+- **WHEN** target A 配置 15s interval，target B 配置 30s interval
+- **THEN** 系统 SHALL 创建两个独立定时器，分别按各自频率调度
+
+### Requirement: 组内并发拨测
+系统 SHALL 在每次调度 tick 时，使用 `Promise.all` 并发执行同组内所有目标的拨测。
+
+#### Scenario: 同组目标并发执行
+- **WHEN** 调度器触发一次 tick，该组有 3 个目标
+- **THEN** 系统 SHALL 同时发起 3 个 HTTP 请求，而非顺序执行
+
+#### Scenario: 单个目标失败不影响同组其他目标
+- **WHEN** 同组中某个目标的拨测请求超时或失败
+- **THEN** 其他目标的拨测 SHALL 正常完成并记录结果
+
+### Requirement: HTTP 拨测执行
+系统 SHALL 对每个目标执行 HTTP 请求，支持 GET、POST、PUT、DELETE、PATCH、HEAD 方法，并携带配置的 headers 和 body。
+
+#### Scenario: 执行 GET 请求
+- **WHEN** 目标配置 method 为 GET
+- **THEN** 系统 SHALL 发送 GET 请求到目标 URL
+
+#### Scenario: 执行 POST 请求带 body
+- **WHEN** 目标配置 method 为 POST 且指定了 body 和 Content-Type header
+- **THEN** 系统 SHALL 发送带指定 body 的 POST 请求
+
+#### Scenario: 携带自定义 headers
+- **WHEN** 目标配置了 headers（如 Authorization）
+- **THEN** 系统 SHALL 在请求中包含所有配置的 headers
+
+### Requirement: 请求超时控制
+系统 SHALL 对每次拨测请求实施超时控制，超时时间使用目标配置的 timeout 值。
+
+#### Scenario: 请求超时
+- **WHEN** 拨测请求在 timeout 时间内未收到响应
+- **THEN** 系统 SHALL 中止该请求，记录为失败并标注超时错误
+
+#### Scenario: 请求在超时前完成
+- **WHEN** 拨测请求在 timeout 时间内收到响应
+- **THEN** 系统 SHALL 正常记录响应结果
+
+### Requirement: expect 校验
+系统 SHALL 在拨测完成后根据目标的 expect 配置校验响应，校验结果记入 check result。
+
+#### Scenario: 校验状态码
+- **WHEN** 目标配置了 `expect.status: [200, 201]`
+- **THEN** 系统 SHALL 检查响应状态码是否在列表中，将匹配结果记录到 matched 字段
+
+#### Scenario: 校验响应体包含
+- **WHEN** 目标配置了 `expect.bodyContains: "healthy"`
+- **THEN** 系统 SHALL 检查响应体是否包含该文本，将匹配结果记录到 matched 字段
+
+#### Scenario: 校验延迟阈值
+- **WHEN** 目标配置了 `expect.maxLatencyMs: 3000`
+- **THEN** 系统 SHALL 检查实际延迟是否超过阈值，将匹配结果记录到 matched 字段
+
+#### Scenario: 无 expect 配置
+- **WHEN** 目标未配置任何 expect 规则
+- **THEN** 系统 SHALL 将 matched 字段设为 true
+
+#### Scenario: 多条 expect 规则
+- **WHEN** 目标同时配置了 status、bodyContains 和 maxLatencyMs
+- **THEN** 系统 SHALL 所有规则全部通过时 matched 为 true，任一不通过则为 false
+
+### Requirement: 拨测结果记录
+系统 SHALL 在每次拨测完成后，将结果写入 SQLite 数据存储，包含 target_id、timestamp、success、status_code、latency_ms、error、matched 字段。
+
+#### Scenario: 成功拨测结果记录
+- **WHEN** 拨测请求成功完成（收到 HTTP 响应）
+- **THEN** 系统 SHALL 记录 success=true、status_code、latency_ms、matched
+
+#### Scenario: 失败拨测结果记录
+- **WHEN** 拨测请求失败（网络错误、超时等）
+- **THEN** 系统 SHALL 记录 success=false、error 信息，status_code 和 latency_ms 为 null