DiAL/openspec/changes/backend-architecture-hardening/specs/server-bootstrap/spec.md at 147a2559ae17c76e043f404c502866dad3138fc1

Files

lanyuanxiaoyao 147a2559ae refactor: 后端架构加固 — 泛型化、批量查询、bootstrap 统一、路径修复与 pageSize 上限

- CheckerDefinition 泛型化，HTTP/Command checker 移除 resolved target 断言
- 新增 ProbeStore.getAllRecentSamples 消除 targets 路由 N+1 查询
- 统一 getAllTargetStats 与 getTargetStats 的 availability 精度
- Engine rejected 结果写入 internal error 记录，提升可观测性
- 新增 bootstrap.ts 统一 dev/production 启动序列
- dataDir 相对路径改为基于配置文件目录解析
- validatePagination 增加 pageSize 上限 200 校验
- 修复 ErrorBoundary override 标记
- 更新 README/DEVELOPMENT 文档，新增完整测试覆盖

2026-05-13 18:15:46 +08:00

1.8 KiB

Raw Blame History

ADDED Requirements

Requirement: 统一启动引导函数

系统 SHALL 提供 src/server/bootstrap.ts 导出 bootstrap(options: BootstrapOptions) 函数，封装完整的服务启动序列：加载配置、创建 store、同步 targets、创建并启动 engine、启动 HTTP server、注册 shutdown handler。

Scenario: 开发模式启动

WHEN dev.ts 调用 bootstrap({ configPath, mode: "development" })
THEN 系统 SHALL 完成完整启动序列，不传入 staticAssets

Scenario: 生产模式启动

WHEN build entry 调用 bootstrap({ configPath, mode: "production", staticAssets })
THEN 系统 SHALL 完成完整启动序列，并将 staticAssets 传递给 startServer

Scenario: 启动失败处理

WHEN 启动过程中任何步骤抛出异常
THEN 系统 SHALL 输出错误信息并以非零退出码退出进程

Scenario: 优雅关机

WHEN 进程收到 SIGINT 或 SIGTERM 信号
THEN bootstrap 注册的 shutdown handler SHALL 调用 engine.stop() 和 store.close() 后退出

Requirement: BootstrapOptions 接口

bootstrap 函数 SHALL 接受 BootstrapOptions 参数，包含 configPath: string、mode: RuntimeMode、staticAssets?: StaticAssets。

Scenario: 最小配置

WHEN 仅传入 configPath 和 mode
THEN 系统 SHALL 正常启动，staticAssets 为 undefined

Requirement: dev.ts 和 build entry 使用 bootstrap

dev.ts 和 scripts/build.ts 生成的 server entry SHALL 调用 bootstrap() 而非各自维护启动序列。

Scenario: dev.ts 调用 bootstrap

WHEN 开发者运行 bun run dev:server
THEN dev.ts SHALL 调用 bootstrap 完成启动

Scenario: build entry 调用 bootstrap

WHEN 生产可执行文件启动
THEN 生成的 entry SHALL 调用 bootstrap 完成启动

1.8 KiB Raw Blame History Unescape Escape