feat: 升级心跳数据库为高吞吐日分区模型（v2）

- 新增 heartbeat 数据库与表结构文档，描述心跳明细表设计及字段约束。
- 新增 OpenSpec 符合性说明文档，指出与规范的一致点及偏差。
- 新增 Kafka 心跳数据推送说明文档，定义消息格式与推送方式。
- 更新数据库创建脚本，支持 UTF-8 编码与中文排序规则。
- 更新心跳表结构脚本，定义主表及索引，采用 ts_ms 日分区。
- 实现自动分区机制，确保按天创建分区以支持高吞吐写入。
- 添加数据库应用脚本，自动执行 SQL 文件并验证表结构。
- 添加运行时烟雾测试脚本，验证数据库连接与基本操作。
- 添加完整的烟雾测试脚本，验证数据插入与分区创建。

openspec/changes/update-heartbeat-db-v2/specs/db/spec.md

@@ -0,0 +1,26 @@
+## MODIFIED Requirements
+
+### Requirement: 数据库表结构管理
+系统必须包含数据库表结构的定义和管理机制。
+
+#### Scenario: 表结构初始化（高吞吐分区表）
+- **WHEN** 系统首次启动或部署数据库时
+- **THEN** 应该存在按 `ts_ms` 日分区的心跳明细表
+- **AND** 必填字段应具备 NOT NULL 约束
+- **AND** 状态类字段应具备 CHECK 约束（限制取值范围）
+- **AND** 必需索引应存在（hotel_id/power_state/guest_type/device_id B-tree；service_mask BRIN）
+
+#### Scenario: 自动分区
+- **WHEN** 写入某天数据而该日分区不存在
+- **THEN** 系统应能够自动创建对应日分区或确保分区被预创建
+- **AND** 不应影响持续写入（高吞吐场景）
+
+## ADDED Requirements
+
+### Requirement: 高吞吐写入友好
+系统在高吞吐场景（约 5 万条/分钟量级）下应避免单点瓶颈。
+
+#### Scenario: 批量写入与分区裁剪
+- **WHEN** 进行批量写入
+- **THEN** 写入应路由到正确日分区
+- **AND** 常见查询（hotel_id + 时间范围）应触发分区裁剪

openspec/changes/update-heartbeat-db-v2/specs/kafka/spec.md

@@ -0,0 +1,17 @@
+## ADDED Requirements
+
+### Requirement: 心跳消息载荷格式（生产者约束）
+Kafka 心跳消息必须包含数据库落库所需的必填字段，并采用 UTF-8 编码。
+
+#### Scenario: JSON 心跳消息
+- **WHEN** 生产者向主题推送心跳消息
+- **THEN** 消息 value 应为 JSON（UTF-8）
+- **AND** 至少包含 ts_ms、hotel_id、room_id、device_id、ip、power_state、guest_type、cardless_state、service_mask、pms_state、carbon_state、device_count、comm_seq
+- **AND** 可选包含 extra（json object）
+
+### Requirement: 分区键友好的 Kafka Key
+
+#### Scenario: 使用 device_id 作为 key
+- **WHEN** 生产者发送消息
+- **THEN** 建议使用 `hotel_id:device_id` 作为 Kafka message key
+- **AND** 以提升同设备有序性与消费侧批量聚合效率

openspec/changes/update-heartbeat-db-v2/specs/processor/spec.md

@@ -0,0 +1,9 @@
+## MODIFIED Requirements
+
+### Requirement: 心跳数据转换
+系统必须能够将解包后的心跳数据转换为数据库存储格式。
+
+#### Scenario: 转换为 v2 明细表字段
+- **WHEN** 心跳数据验证通过时
+- **THEN** 系统应输出与 v2 明细表字段一致的数据结构
+- **AND** 缺失必填字段时应判定为无效数据并丢弃