feat: 添加 Kafka 消费者和消息处理功能

- 新增 Kafka 消费者实现，支持消息处理和错误处理。
- 实现 OffsetTracker 类，用于跟踪消息偏移量。
- 新增消息解析和数据库插入逻辑，支持从 Kafka 消息构建数据库行。
- 实现 UDP 数据包解析功能，支持不同类型的 UDP 消息。
- 新增 Redis 错误队列处理，支持错误重试机制。
- 实现 Redis 客户端和集成类，支持日志记录和心跳机制。
- 添加 Zod 验证模式，确保 Kafka 消息有效性。
- 新增日志记录和指标收集工具，支持系统监控。
- 添加 UUID 生成工具，支持唯一标识符生成。
- 编写处理器逻辑的单元测试，确保功能正确性。
- 配置 Vite 构建工具，支持 Node.js 环境下的构建。

bls-register-backend/scripts/verifyProbeInDb.js

@@ -0,0 +1,67 @@
+import dotenv from 'dotenv';
+import pg from 'pg';
+
+dotenv.config();
+
+const probeTs = Number(process.argv[2]);
+const probeRoom = process.argv[3];
+const probeHotelId = Number(process.argv[4]);
+
+if (!Number.isFinite(probeTs) || !probeRoom || !Number.isFinite(probeHotelId)) {
+  console.error('Usage: node scripts/verifyProbeInDb.js <probeTs> <probeRoom> <probeHotelId>');
+  process.exit(1);
+}
+
+const pool = new pg.Pool({
+  host: process.env.POSTGRES_HOST_G5,
+  port: Number(process.env.POSTGRES_PORT_G5 || 5434),
+  user: process.env.POSTGRES_USER_G5,
+  password: process.env.POSTGRES_PASSWORD_G5,
+  database: process.env.POSTGRES_DATABASE_G5,
+  max: 1
+});
+
+const main = async () => {
+  const eventResult = await pool.query(
+    `SELECT ts_ms, room_id, app_version, udp_raw
+     FROM rcu_info.rcu_info_events_g5
+     WHERE ts_ms = $1 AND room_id = $2
+     ORDER BY write_ts_ms DESC
+     LIMIT 1`,
+    [probeTs, probeRoom]
+  );
+
+  const statusResult = await pool.query(
+    `SELECT hotel_id, room_id, app_version, launcher_version, config_version, upgrade_ts_ms, register_ts_ms
+     FROM room_status.room_status_moment_g5
+     WHERE hotel_id = $1 AND room_id = $2
+     LIMIT 1`,
+    [probeHotelId, probeRoom]
+  );
+
+  console.log(`[probe-db] event_rows=${eventResult.rowCount}`);
+  if (eventResult.rowCount > 0) {
+    const row = eventResult.rows[0];
+    console.log(`[probe-db] event.ts_ms=${row.ts_ms} room_id=${row.room_id} app_version=${row.app_version}`);
+    console.log(`[probe-db] event.udp_raw=${row.udp_raw}`);
+  }
+
+  console.log(`[probe-db] room_status_rows=${statusResult.rowCount}`);
+  if (statusResult.rowCount > 0) {
+    const row = statusResult.rows[0];
+    console.log(`[probe-db] room_status.room_id=${row.room_id} register_ts_ms=${row.register_ts_ms} upgrade_ts_ms=${row.upgrade_ts_ms}`);
+  } else {
+    console.log('[probe-db] room_status row not found (expected behavior when key does not exist)');
+  }
+};
+
+main()
+  .then(async () => {
+    await pool.end();
+    process.exit(0);
+  })
+  .catch(async (err) => {
+    console.error(`[probe-db] verify failed: ${err.message}`);
+    await pool.end();
+    process.exit(1);
+  });