feat: 实现Redis集成与Kafka消息处理优化

- 新增Redis集成模块,支持心跳写入与控制台日志队列
- 优化Kafka消费者实现,支持多实例与自动重连
- 改进消息处理器,支持批量处理与多层解码
- 更新数据库表结构,调整字段类型与约束
- 添加Redis与Kafka的配置项和环境变量支持
- 补充测试用例和文档说明
This commit is contained in:
2026-01-14 17:58:45 +08:00
parent eb94aaf92b
commit 910f1c353f
28 changed files with 1691 additions and 177 deletions

View File

@@ -1,9 +1,12 @@
# 数据库操作规范
## 需求
## Purpose
本规范定义本服务对 PostgreSQL 的连接池配置、表结构初始化(含分区表)、分区预创建维护策略、批量写入与约束错误处理等行为。
## Requirements
### Requirement: 数据库连接管理
系统必须能够建立和维护与PostgreSQL数据库的连接。
系统 MUST 能够建立和维护与 PostgreSQL 数据库的连接。
#### Scenario: 成功连接数据库
- **WHEN** 系统启动时
@@ -16,7 +19,7 @@
- **AND** 重连失败时应该记录错误日志
### Requirement: 心跳数据写入
系统必须能够将处理后的心跳数据写入PostgreSQL数据库。
系统 MUST 能够将处理后的心跳数据写入 PostgreSQL 数据库。
#### Scenario: 写入单条心跳数据
- **WHEN** 接收到单条处理后的心跳数据时
@@ -29,7 +32,7 @@
- **AND** 提高写入效率
### Requirement: 数据完整性保障
系统必须保障写入数据库的心跳数据完整性。
系统 MUST 保障写入数据库的心跳数据完整性。
#### Scenario: 事务管理
- **WHEN** 写入多条相关数据时
@@ -43,7 +46,7 @@
- **AND** 根据配置决定是否重试
### Requirement: 数据库表结构管理
系统必须包含数据库表结构的定义和管理机制。
系统 MUST 提供数据库表结构的定义和管理机制。
#### Scenario: 表结构初始化
- **WHEN** 系统首次启动时
@@ -62,7 +65,7 @@
- **AND** 不影响现有数据
### Requirement: 数据查询支持
系统必须支持基本的数据查询操作,用于监控和调试。
系统 MUST 支持基本的数据查询操作,用于监控和调试。
#### Scenario: 查询最新心跳数据
- **WHEN** 需要查询最新的心跳数据时