Files
Web_BLS_RCUAction_Server/docs/project.md
XuJiacheng 86a1e79153 feat: 初始化后端服务基础架构与核心组件
- 添加项目基础结构,包括 .gitignore、package.json、Docker 配置和环境变量示例
- 实现核心模块:Kafka 消费者、PostgreSQL 数据库管理器、Redis 客户端与错误队列
- 添加工具类:日志记录器、指标收集器、UUID 生成器
- 实现数据处理器,支持 0x36 上报和 0x0F 命令的解析与存储
- 添加数据库初始化脚本和分区管理,支持按时间范围分区
- 引入 Zod 数据验证和 Vitest 单元测试框架
- 提供完整的项目文档,包括数据库设计、Kafka 格式规范和 Redis 集成协议
2026-01-30 11:05:00 +08:00

2.8 KiB
Raw Blame History

  1. 0x36 上报数据格式

P0 系统锁状态 0x00未锁定 0x01锁定 P1P6 保留 P7 上报设备数量 P8P13 设备参数描述一个设备参数固定为6Byte,具体格式如下: DevType设备类型 1Byte DevAddr设备地址 1Byte DevLoop设备回路 2Byte DevData设备状态 2Byte P14 上报设备故障数量 P15~P20 上报设备故障数量 DevType设备类型 1Byte DevAddr设备地址 1Byte DevLoop设备回路 2Byte ErrorType故障类型 1Byte ErrorData故障内容 1Byte

上报设备的状态具体参数需要查看备数6Byte如果故障设备数为0则没有设备故障参数。 故障参数解析: 故障类型 故障内容 0x01 0:在线 1:离线 0x02 0~100电量 0x03 电流(10mA) 0x04 1901故障检测次数 0x05 设备回路故障具体设备,不同类型的设备上报状态的描述是不同的。 具体有多少设备状态需要上报,设备参数所占用的字节=设备数6Byte 同样设备故障参数所占用的字节=设 2. 0x0F 下发数据格式

P0控制设备总数 P1 ~P495设备控制参数描述一个设备控制参数固定为6Byte具体格式如下 DevType控制设备类型 - 1Byte DevAddr控制设备地址 - 1Byte Loop控制设备的回路地址 - 2Byte Type控制设备的输出类型 - 2Byte Type_L执行方式 Type_H执行内容

该命令一般用于服务下发控制数据 3. 0x0F 上报数据格式 ACK (待补充)

  1. 数据表结构

不可为空字段: 日志产生时间ts_ms 入库时间write_ts_ms 酒店index 房间index 方向(上传/下发index 命令字index 通讯帧号 UDP消息原文 记录行为类型ACK、下发控制、主动控制、设备回路状态index通过设备类型区分 可为空字段: 系统锁状态 本次上报数量 DevType设备类型 1Byte DevAddr设备地址 1Byte DevLoop设备回路 2Byte DevData设备状态 2Byte 本次故障数量 DevType设备类型 1Byte DevAddr设备地址 1Byte DevLoop设备回路 2Byte ErrorType故障类型 1Byte ErrorData故障内容 1Byte

一条命令可能会有多条状态,每个状态生成一条记录,通过命令字和帧号来做串联。 即一条UDP通讯可能对照多条数据库记录

  1. 队列结构 队列分区数6 Topicblwlog4Nodejs-rcu-action-topic