DiAL/openspec/specs/data-retention/spec.md at 146cef982e7363286ed8f9c830b755a87a087100

Files

lanyuanxiaoyao bcfb907bd3 feat: 基础设施加固 — 修复构建、数据保留、错误边界、bundle 拆分

- 修复 build script 引用已删除的 registerCheckers，恢复生产构建
- 生产入口添加 SIGINT/SIGTERM 优雅关闭（与 dev.ts 一致）
- 新增 runtime.retention 配置（默认 7d），ProbeStore.prune() 定时清理过期数据
- parseDuration 扩展支持 h/d 单位
- 新增前端 ErrorBoundary 组件，防止渲染错误白屏
- Vite codeSplitting.groups 拆分 vendor chunks（业务代码 1180KB → 47KB）
- 同步 delta specs 到主规范

2026-05-13 16:48:56 +08:00

1.8 KiB

Raw Blame History

Purpose

定义历史拨测数据的自动清理机制：可配置的保留时长和定时清理调度。

Requirements

Requirement: 数据保留配置

系统 SHALL 支持通过 runtime.retention 配置项指定历史数据保留时长，格式为持续时间字符串（<数字><单位>，单位支持 d/h/m）。

Scenario: 配置 7 天保留

WHEN 配置文件中 runtime.retention 设置为 "7d"
THEN 系统 SHALL 保留最近 7 天的检查结果，清理更早的数据

Scenario: 配置小时级保留

WHEN 配置文件中 runtime.retention 设置为 "24h"
THEN 系统 SHALL 保留最近 24 小时的检查结果

Scenario: 未配置 retention

WHEN 配置文件中未指定 runtime.retention
THEN 系统 SHALL 使用默认值 "7d"

Scenario: 无效 retention 格式

WHEN 配置文件中 runtime.retention 格式不合法（如 "abc"、"7x"）
THEN 系统 SHALL 在配置校验阶段报错，拒绝启动

Requirement: 定时清理调度

系统 SHALL 以固定间隔（1 小时）定期执行数据清理，删除超过保留时长的历史检查结果。

Scenario: 引擎启动后首次清理

WHEN ProbeEngine 启动
THEN 系统 SHALL 立即执行一次清理，然后每隔 1 小时再次执行

Scenario: 清理执行

WHEN 清理定时器触发
THEN 系统 SHALL 删除 check_results 表中 timestamp 早于 now - retentionMs 的所有记录

Scenario: 引擎停止时清除定时器

WHEN ProbeEngine.stop() 被调用
THEN 系统 SHALL 清除清理定时器，不再执行后续清理

Scenario: retention 为 0 时不清理

WHEN 配置的 retention 解析为 0 毫秒
THEN 系统 SHALL 不注册清理定时器，数据永久保留

1.8 KiB Raw Blame History Unescape Escape