feat(P19ERP1-1,P19ERP1-2): 新增ERP主数据同步模型与服务

server/src/jobs/erpMasterDataSyncJob.js

@@ -0,0 +1,91 @@
+const cron = require('node-cron');
+
+const { FEATURE_FLAG_KEYS, evaluateFeatureFlag } = require('../services/featureFlags');
+const { syncErpMasterData } = require('../services/integrations/erpMasterData');
+
+async function runErpMasterDataSyncOnce(prisma, config, logger) {
+  if (!config.erpMasterDataSyncCron) {
+    return {
+      skipped: true,
+      reason: 'cron_disabled',
+      items: [],
+    };
+  }
+
+  const gate = await evaluateFeatureFlag({
+    prisma,
+    config,
+    flagKey: FEATURE_FLAG_KEYS.erpSync,
+    departmentId: null,
+    strictDepartment: false,
+  });
+
+  if (!gate.enabled) {
+    logger.info(
+      {
+        featureFlag: FEATURE_FLAG_KEYS.erpSync,
+        reason: gate.reason,
+      },
+      'ERP master data sync skipped by ERP gate',
+    );
+    return {
+      skipped: true,
+      reason: gate.reason,
+      items: [],
+    };
+  }
+
+  return syncErpMasterData(prisma, config, { logger });
+}
+
+function startErpMasterDataSyncJob(fastify) {
+  if (!fastify.config.erpMasterDataSyncCron) {
+    fastify.log.info('ERP master data sync cron disabled');
+    return null;
+  }
+
+  let running = false;
+  const task = cron.schedule(fastify.config.erpMasterDataSyncCron, async () => {
+    if (running) {
+      return;
+    }
+
+    running = true;
+    try {
+      await runErpMasterDataSyncOnce(fastify.prisma, fastify.config, fastify.log);
+      fastify.metrics?.jobRunsTotal?.inc?.({
+        job: 'erp.master-data.sync',
+        driver: 'cron',
+        outcome: 'success',
+      });
+    } catch (error) {
+      fastify.log.error({ err: error }, 'ERP master data sync job failed');
+      fastify.metrics?.jobRunsTotal?.inc?.({
+        job: 'erp.master-data.sync',
+        driver: 'cron',
+        outcome: 'failure',
+      });
+    } finally {
+      running = false;
+    }
+  });
+
+  fastify.addHook('onClose', async () => {
+    task.stop();
+    task.destroy();
+  });
+
+  fastify.log.info(
+    {
+      cron: fastify.config.erpMasterDataSyncCron,
+    },
+    'ERP master data sync job scheduled',
+  );
+
+  return task;
+}
+
+module.exports = {
+  runErpMasterDataSyncOnce,
+  startErpMasterDataSyncJob,
+};

server/src/jobs/jobSystem.js

@@ -2,6 +2,7 @@ const { startDelegationRevokeJob } = require("./delegationRevokeJob");
 const { startInvoiceArchiveJob } = require("./invoiceArchiveJob");
 const { startOcrJob } = require("./ocrJob");
 const { startIntegrationOutboxWorker } = require("./integrationOutboxWorker");
+const { startErpMasterDataSyncJob } = require("./erpMasterDataSyncJob");
 const { startPgBossJobs } = require("./pgBossJobs");
 
 async function startJobs(fastify) {
@@ -19,6 +20,7 @@ async function startJobs(fastify) {
   startOcrJob(fastify);
   startInvoiceArchiveJob(fastify);
   startIntegrationOutboxWorker(fastify);
+  startErpMasterDataSyncJob(fastify);
   return { driver: "cron" };
 }
 

server/src/jobs/pgBossJobs.js

@@ -5,6 +5,7 @@ const { archiveUnusedInvoices } = require("./invoiceArchiveJob");
 const { runOcrOnce } = require("./ocrJob");
 const { runVerificationForRecord } = require("./verificationJob");
 const { runIntegrationOutboxOnce } = require("./integrationOutboxJob");
+const { runErpMasterDataSyncOnce } = require("./erpMasterDataSyncJob");
 const {
   FEATURE_FLAG_KEYS,
   evaluateFeatureFlag,
@@ -15,6 +16,7 @@ const JOB_DELEGATION_REVOKE = "delegation.revoke-expired";
 const JOB_INVOICE_ARCHIVE = "invoice.archive-unused";
 const JOB_INVOICE_VERIFY = "invoice.verify";
 const JOB_INTEGRATION_OUTBOX = "integration.outbox.dispatch";
+const JOB_ERP_MASTER_DATA_SYNC = "erp.master-data.sync";
 
 function resolveDatabaseConnectionString() {
   const connectionString = process.env.DATABASE_URL;
@@ -45,6 +47,9 @@ async function startPgBossJobs(fastify) {
   await boss.createQueue(JOB_INVOICE_ARCHIVE);
   await boss.createQueue(JOB_INVOICE_VERIFY);
   await boss.createQueue(JOB_INTEGRATION_OUTBOX);
+  if (fastify.config.erpMasterDataSyncCron) {
+    await boss.createQueue(JOB_ERP_MASTER_DATA_SYNC);
+  }
 
   await boss.work(JOB_DELEGATION_REVOKE, { batchSize: 1 }, async (jobs) => {
     const job = jobs?.[0];
@@ -198,6 +203,37 @@ async function startPgBossJobs(fastify) {
     }
   });
 
+
+  if (fastify.config.erpMasterDataSyncCron) {
+    await boss.work(JOB_ERP_MASTER_DATA_SYNC, { batchSize: 1 }, async (jobs) => {
+      const job = jobs?.[0];
+
+      try {
+        const result = await runErpMasterDataSyncOnce(
+          fastify.prisma,
+          fastify.config,
+          fastify.log,
+        );
+        fastify.metrics?.jobRunsTotal?.inc?.({
+          job: JOB_ERP_MASTER_DATA_SYNC,
+          driver: "pgboss",
+          outcome: "success",
+        });
+        if (!result?.skipped) {
+          fastify.log.info({ jobId: job?.id, result }, "pg-boss ERP master data sync processed");
+        }
+      } catch (error) {
+        fastify.metrics?.jobRunsTotal?.inc?.({
+          job: JOB_ERP_MASTER_DATA_SYNC,
+          driver: "pgboss",
+          outcome: "failure",
+        });
+        fastify.log.error({ err: error, jobId: job?.id }, "pg-boss ERP master data sync failed");
+        throw error;
+      }
+    });
+  }
+
   await boss.work(JOB_INTEGRATION_OUTBOX, { batchSize: 1 }, async (jobs) => {
     const job = jobs?.[0];
 
@@ -294,6 +330,16 @@ async function startPgBossJobs(fastify) {
     singletonSeconds: 55,
   });
 
+  if (fastify.config.erpMasterDataSyncCron) {
+    await boss.schedule(JOB_ERP_MASTER_DATA_SYNC, fastify.config.erpMasterDataSyncCron, null, {
+      tz: fastify.config.appTimezone,
+      singletonKey: JOB_ERP_MASTER_DATA_SYNC,
+      singletonSeconds: 55,
+    });
+  } else {
+    await boss.unschedule(JOB_ERP_MASTER_DATA_SYNC).catch(() => {});
+  }
+
   fastify.log.info(
     {
       schema: fastify.config.pgBossSchema,
@@ -305,6 +351,7 @@ async function startPgBossJobs(fastify) {
       delegationCron: fastify.config.delegationRevokeCron,
       invoiceArchiveCron: fastify.config.invoiceArchiveCron,
       integrationOutboxCron: fastify.config.integrationOutboxCron,
+      erpMasterDataSyncCron: fastify.config.erpMasterDataSyncCron || null,
     },
     "pg-boss job system started",
   );
@@ -318,5 +365,6 @@ module.exports = {
   JOB_INVOICE_ARCHIVE,
   JOB_INVOICE_VERIFY,
   JOB_INTEGRATION_OUTBOX,
+  JOB_ERP_MASTER_DATA_SYNC,
   startPgBossJobs,
 };