feat(server): /metrics 可观测与日志上下文（F22）

- 新增 Prometheus 指标端点 /metrics（HTTP + DB + 作业统计）
- request.log 绑定 requestId/actorId，避免日志难追踪
- cron/pg-boss 作业增加 metrics 计数（runs/processed）
- 更新 env/runbook/README 与 v3 CSV 状态推进

server/src/jobs/pgBossJobs.js

@@ -38,26 +38,64 @@ async function startPgBossJobs(fastify) {
 
   await boss.work(JOB_DELEGATION_REVOKE, { batchSize: 1 }, async (jobs) => {
     const job = jobs?.[0];
-    const revoked = await revokeExpiredDelegations(fastify.prisma, fastify.log);
-    if (revoked > 0) {
-      fastify.log.info(
-        { jobId: job?.id, revoked },
-        "pg-boss delegation revoke tick processed",
-      );
+    try {
+      const revoked = await revokeExpiredDelegations(fastify.prisma, fastify.log);
+      fastify.metrics?.jobRunsTotal?.inc?.({
+        job: JOB_DELEGATION_REVOKE,
+        driver: "pgboss",
+        outcome: "success",
+      });
+      if (revoked > 0) {
+        fastify.metrics?.jobProcessedTotal?.inc?.(
+          { job: JOB_DELEGATION_REVOKE, driver: "pgboss", kind: "revoked" },
+          revoked,
+        );
+        fastify.log.info(
+          { jobId: job?.id, revoked },
+          "pg-boss delegation revoke tick processed",
+        );
+      }
+    } catch (error) {
+      fastify.metrics?.jobRunsTotal?.inc?.({
+        job: JOB_DELEGATION_REVOKE,
+        driver: "pgboss",
+        outcome: "failure",
+      });
+      fastify.log.error({ err: error, jobId: job?.id }, "pg-boss delegation revoke tick failed");
+      throw error;
     }
   });
 
   await boss.work(JOB_INVOICE_ARCHIVE, { batchSize: 1 }, async (jobs) => {
     const job = jobs?.[0];
-    const archived = await archiveUnusedInvoices(fastify.prisma, fastify.log, {
-      batchSize: fastify.config.invoiceArchiveBatchSize,
-      unusedDays: fastify.config.invoiceArchiveUnusedDays,
-    });
-    if (archived > 0) {
-      fastify.log.info(
-        { jobId: job?.id, archived, unusedDays: fastify.config.invoiceArchiveUnusedDays },
-        "pg-boss invoice archive tick processed",
-      );
+    try {
+      const archived = await archiveUnusedInvoices(fastify.prisma, fastify.log, {
+        batchSize: fastify.config.invoiceArchiveBatchSize,
+        unusedDays: fastify.config.invoiceArchiveUnusedDays,
+      });
+      fastify.metrics?.jobRunsTotal?.inc?.({
+        job: JOB_INVOICE_ARCHIVE,
+        driver: "pgboss",
+        outcome: "success",
+      });
+      if (archived > 0) {
+        fastify.metrics?.jobProcessedTotal?.inc?.(
+          { job: JOB_INVOICE_ARCHIVE, driver: "pgboss", kind: "archived" },
+          archived,
+        );
+        fastify.log.info(
+          { jobId: job?.id, archived, unusedDays: fastify.config.invoiceArchiveUnusedDays },
+          "pg-boss invoice archive tick processed",
+        );
+      }
+    } catch (error) {
+      fastify.metrics?.jobRunsTotal?.inc?.({
+        job: JOB_INVOICE_ARCHIVE,
+        driver: "pgboss",
+        outcome: "failure",
+      });
+      fastify.log.error({ err: error, jobId: job?.id }, "pg-boss invoice archive tick failed");
+      throw error;
     }
   });
 
@@ -68,12 +106,46 @@ async function startPgBossJobs(fastify) {
 
     const job = jobs?.[0];
     const workerId = `pgboss:ocr:${process.pid}`;
-    const stats = await runOcrOnce(fastify.prisma, fastify.config, fastify.log, workerId);
-    if (stats.claimed > 0) {
-      fastify.log.info(
-        { jobId: job?.id, workerId, ...stats },
-        "pg-boss OCR tick processed",
-      );
+    try {
+      const stats = await runOcrOnce(fastify.prisma, fastify.config, fastify.log, workerId);
+      fastify.metrics?.jobRunsTotal?.inc?.({
+        job: JOB_OCR_TICK,
+        driver: "pgboss",
+        outcome: "success",
+      });
+      if (stats.available > 0) {
+        fastify.metrics?.jobProcessedTotal?.inc?.(
+          { job: JOB_OCR_TICK, driver: "pgboss", kind: "available" },
+          stats.available,
+        );
+      }
+      if (stats.duplicate > 0) {
+        fastify.metrics?.jobProcessedTotal?.inc?.(
+          { job: JOB_OCR_TICK, driver: "pgboss", kind: "duplicate" },
+          stats.duplicate,
+        );
+      }
+      if (stats.failed > 0) {
+        fastify.metrics?.jobProcessedTotal?.inc?.(
+          { job: JOB_OCR_TICK, driver: "pgboss", kind: "failed" },
+          stats.failed,
+        );
+      }
+
+      if (stats.claimed > 0) {
+        fastify.log.info(
+          { jobId: job?.id, workerId, ...stats },
+          "pg-boss OCR tick processed",
+        );
+      }
+    } catch (error) {
+      fastify.metrics?.jobRunsTotal?.inc?.({
+        job: JOB_OCR_TICK,
+        driver: "pgboss",
+        outcome: "failure",
+      });
+      fastify.log.error({ err: error, jobId: job?.id }, "pg-boss OCR tick failed");
+      throw error;
     }
   });