feat: 添加回路名称字段并实现元数据缓存查询

在 RCU 事件处理中新增回路名称(loop_name)字段,用于标识具体设备回路。
- 在 rcu_action_events 表中添加 loop_name 字段
- 新增项目元数据缓存模块,每日从 temporary_project 表刷新房间与回路信息
- 处理消息时,根据 device_id、dev_addr 等字段查询缓存获取回路名称
- 若缓存未命中,则根据设备类型规则生成兜底名称
- 更新环境变量、文档及测试用例以适配新功能
This commit is contained in:
2026-02-02 19:43:49 +08:00
parent 0e6c5c3cc3
commit 4e0f5213db
12 changed files with 660 additions and 117 deletions

View File

@@ -75,4 +75,20 @@ ACK (待补充)
5. 队列结构
队列分区数6
Topicblwlog4Nodejs-rcu-action-topic
Topicblwlog4Nodejs-rcu-action-topic
6. 入库前特殊操作
- 定期从temporary_project表中读取数据并保存到`内存`以全局变量的形式每天凌晨1点从数据库更新一次。
- 每条数据写库之前需要根据项目ID从内存中读取项目信息。
- 我需要在现有数据表`rcu_action_events`里,添加一个字段:`loop_name`,用于存储回路名称。
- 查询`loop_name`的方法是:
- 根据要插入的数据中的`device_id``rooms`表中找出对应的房间 -> 得到 `room_type_id`
- 根据 `room_type_id``loop_address``loops` 表中查找对应的 `loop_name`
- `loop_address` 的生成规则:将数据的 `dev_type``dev_addr``dev_loop` 分别转换为 3 位字符串(不足前方补 0然后拼接。
- 例如:`dev_type=1, dev_addr=23, dev_loop=12` -> `001` + `023` + `012` -> `001023012`
- **兜底逻辑**:如果根据上述规则在 `loops` 缓存中未找到对应的 `loop_name`,则使用 `dev_type` 对应的设备名称(配置在 `ACTION_TYPE_DEV_TYPE_RULES` 中)默认名称。
- 格式:`[dev_type名称+'-'+dev_addr+'-'+dev_loop]`
- 例如:`dev_type=35` (名称: TimeCtrl), `addr=14`, `loop=21` -> `[35TimeCtrl-14-21]`
- 最后将找到的或生成的 `loop_name` 写入 `rcu_action_events` 表。
- 注意,所有查库操作都要通过内存缓存来实现。