feat: 初始化后端服务基础架构与核心组件

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

bls-rcu-action-backend/src/db/partitionManager.js

@@ -0,0 +1,71 @@
+import { logger } from '../utils/logger.js';
+import dbManager from './databaseManager.js';
+
+class PartitionManager {
+  /**
+   * Calculate the start and end timestamps (milliseconds) for a given date.
+   * @param {Date} date - The date to calculate for.
+   * @returns {Object} { startMs, endMs, partitionSuffix }
+   */
+  getPartitionInfo(date) {
+    const yyyy = date.getFullYear();
+    const mm = String(date.getMonth() + 1).padStart(2, '0');
+    const dd = String(date.getDate()).padStart(2, '0');
+    const partitionSuffix = `${yyyy}${mm}${dd}`;
+
+    const start = new Date(date);
+    start.setHours(0, 0, 0, 0);
+    const startMs = start.getTime();
+
+    const end = new Date(date);
+    end.setDate(end.getDate() + 1);
+    end.setHours(0, 0, 0, 0);
+    const endMs = end.getTime();
+
+    return { startMs, endMs, partitionSuffix };
+  }
+
+  /**
+   * Ensure partitions exist for the next N days.
+   * @param {number} daysAhead - Number of days to pre-create.
+   */
+  async ensurePartitions(daysAhead = 30) {
+    const client = await dbManager.pool.connect();
+    try {
+      logger.info(`Starting partition check for the next ${daysAhead} days...`);
+      const now = new Date();
+
+      for (let i = 0; i < daysAhead; i++) {
+        const targetDate = new Date(now);
+        targetDate.setDate(now.getDate() + i);
+
+        const { startMs, endMs, partitionSuffix } = this.getPartitionInfo(targetDate);
+        const partitionName = `rcu_action.rcu_action_events_${partitionSuffix}`;
+
+        // Check if partition exists
+        const checkSql = `
+          SELECT to_regclass($1) as exists;
+        `;
+        const checkRes = await client.query(checkSql, [partitionName]);
+        
+        if (!checkRes.rows[0].exists) {
+          logger.info(`Creating partition ${partitionName} for range [${startMs}, ${endMs})`);
+          const createSql = `
+            CREATE TABLE IF NOT EXISTS ${partitionName}
+            PARTITION OF rcu_action.rcu_action_events
+            FOR VALUES FROM (${startMs}) TO (${endMs});
+          `;
+          await client.query(createSql);
+        }
+      }
+      logger.info('Partition check completed.');
+    } catch (err) {
+      logger.error('Error ensuring partitions:', err);
+      throw err;
+    } finally {
+      client.release();
+    }
+  }
+}
+
+export default new PartitionManager();