Web_BLS_OnOffLine_Server/bls-onoffline-backend/spec/onoffline-spec.md

bls-onoffline-backend 规格说明

1. Kafka 数据结构 { "HotelCode": "1085", "MAC": "00:1A:2B:3C:4D:5E", "HostNumber": "091123987456", "RoomNumber": "8888房", "EndPoint": "50.2.60.1:6543", "CurrentStatus": "on", "CurrentTime": "2026-02-02T10:30:00Z", "UnixTime": 1770000235000, "LauncherVersion": "1.0.0", "RebootReason": "1" }

2. Kafka 主题 Topic：blwlog4Nodejs-rcu-onoffline-topic

3. 数据库结构 数据库：log_platform 表：onoffline_record 字段： guid varchar(32) ts_ms int8 write_ts_ms int8 hotel_id int2 mac varchar(21) device_id varchar(64) room_id varchar(64) ip varchar(21) current_status varchar(10) launcher_version varchar(10) reboot_reason varchar(10) 主键：（ts_ms, mac, device_id, room_id） 按 ts_ms 每日分区

G5库结构（双写，临时接入）： 库同为：log_platform 表：onoffline_record_g5 差异字段：

• guid 为 int4，由库自己生成。
• record_source 固定为 CRICS。
• current_status 为 int2，on映射为1，off映射为2，restart映射为3，其余为0。 支持通过环境变量开关双写。

4. 数据处理规则 非重启数据：reboot_reason 为空或不存在，current_status 取 CurrentStatus 重启数据：reboot_reason 不为空时保留 Kafka 上游 current_status 值；若上游值为 restart，则入库标记为 restart，G5 库映射为 3 其余字段直接按 Kafka 原值落库，空值不补 0