feat: 初始化BLS心跳接收端项目

- 添加基础项目结构,包括.gitignore、vite配置和package.json
- 实现Kafka消费者模块框架
- 添加心跳处理器模块框架
- 实现数据库管理模块框架
- 添加OpenSpec规范文档
- 更新README文档说明项目功能和技术栈
This commit is contained in:
2026-01-08 09:16:53 +08:00
parent 24654c4b90
commit adc3bfd87d
19 changed files with 5549 additions and 1 deletions

View File

@@ -0,0 +1,46 @@
# 数据处理器规范
## 需求
### Requirement: 心跳数据解包
系统必须能够解包Kafka消息中的二进制心跳数据。
#### Scenario: 解包有效心跳数据
- **WHEN** 接收到有效格式的Kafka心跳消息时
- **THEN** 系统应该成功解包消息
- **AND** 提取出心跳数据的各个字段
#### Scenario: 解包无效心跳数据
- **WHEN** 接收到无效格式的Kafka心跳消息时
- **THEN** 系统应该返回解包错误
- **AND** 记录错误日志
### Requirement: 心跳数据验证
系统必须能够验证解包后的心跳数据的有效性。
#### Scenario: 验证有效心跳数据
- **WHEN** 解包后的心跳数据格式正确且字段完整时
- **THEN** 系统应该验证通过
- **AND** 将数据传递给数据库层进行存储
#### Scenario: 验证无效心跳数据
- **WHEN** 解包后的心跳数据缺少必填字段时
- **THEN** 系统应该验证失败
- **AND** 记录错误日志
- **AND** 丢弃该数据
### Requirement: 心跳数据转换
系统必须能够将解包后的心跳数据转换为数据库存储格式。
#### Scenario: 转换心跳数据格式
- **WHEN** 心跳数据验证通过时
- **THEN** 系统应该将数据转换为数据库表结构所需的格式
- **AND** 添加必要的元数据
### Requirement: 批量处理支持
系统必须支持批量处理心跳数据,提高处理效率。
#### Scenario: 批量处理心跳数据
- **WHEN** 接收到大量心跳消息时
- **THEN** 系统应该将数据分批处理
- **AND** 每批处理的数量可配置