refactor(openspec): 归档心跳数据库v2更新相关文档

将update-heartbeat-db-v2目录下的文档迁移至archive目录
更新specs目录下的相关规范文件以反映最新变更
This commit is contained in:
2026-01-14 19:38:02 +08:00
parent eb35635253
commit 7d5b9c50ea
9 changed files with 89 additions and 45 deletions

View File

@@ -2,11 +2,9 @@
## Purpose
本规范定义心跳处理器对 Kafka 消息 value 的解码/解压(含两层以内组合)、字段校验、转换为分区表写入结构,以及批量写库与失败丢弃/记录策略。
## Requirements
### Requirement: 心跳数据解包
系统 MUST 能够解包 Kafka 消息中的心跳数据
系统 MUST 能够 Kafka 消息 value 解码/解压并还原为 JSON 对象或数组,支持两层以内的编码/压缩组合
#### Scenario: 支持常见编码/压缩(两层以内)
- **WHEN** Kafka 消息 value 为下列任意形式时:
@@ -48,11 +46,15 @@
### Requirement: 心跳数据转换
系统 MUST 能够将解包后的心跳数据转换为数据库存储格式。
#### Scenario: 转换心跳数据格式
#### Scenario: 转换为 v2 明细表字段
- **WHEN** 心跳数据验证通过时
- **THEN** 系统应该将数据转换为数据库表结构所需的格式
- **THEN** 系统应输出与 v2 明细表字段一致的数据结构
- **AND** 添加必要的元数据
#### Scenario: 缺失必填字段
- **WHEN** 心跳数据缺失必填字段时
- **THEN** 系统应判定为无效数据并丢弃
### Requirement: 批量处理支持
系统 MUST 支持批量处理心跳数据,提高处理效率。
@@ -64,3 +66,4 @@
#### Scenario: Kafka 单条消息携带批量心跳
- **WHEN** Kafka 消息 value 为 JSON 数组(批量心跳)
- **THEN** 系统应将数组内每条心跳作为独立项进入批处理队列