wangsli/hyb-oa
1
0
派生 0
代码 工单 合并请求 工作流 8 软件包 项目 发布 百科 活动

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

浏览代码 
- 新增 Prometheus 指标端点 /metrics（HTTP + DB + 作业统计）
- request.log 绑定 requestId/actorId，避免日志难追踪
- cron/pg-boss 作业增加 metrics 计数（runs/processed）
- 更新 env/runbook/README 与 v3 CSV 状态推进
这个提交包含在：
wangsli
2026-02-09 20:30:41 +08:00
父节点 55924c8ff8
当前提交 6ecebf8ad6
共修改 17 个文件，包含 353 行新增和 25 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
issues/2026-02-09_13-39-02-p5-blueprint-v3.csv
+1 -1
查看文件
@@ -23,7 +23,7 @@ F19c,作业迁移（委派回收 -> pg-boss）,"将委派过期回收迁移到 p
F19d,作业迁移（超期归档 -> pg-boss）,"将 90 天游离归档迁移到 pg-boss（替代 node-cron），统一重试/并发/可观测字段","作业可重复执行幂等；多进程不重复处理；回归全绿","cd server && ./scripts/regression-ocr.sh && ./scripts/regression-all.sh",manual,DONE,DONE,DONE,"server/src/jobs/pgBossJobs.js | server/src/jobs/invoiceArchiveJob.js | server/src/jobs/jobSystem.js | server/README.md","[""F19"",""F12""]","invoice.archive-unused 默认按 INVOICE_ARCHIVE_CRON 调度；回滚：JOB_DRIVER=cron"
F20,Worker进程拆分（可选）,"提供 API 进程与 Worker 进程拆分的部署方式（compose 开关），保持单机也可跑","开启后：API 不跑作业；Worker 只跑作业；两者共享 DATABASE_URL；功能不回归","manual: docker compose 起两个进程并跑回归脚本",manual,DONE,DONE,DONE,"deploy/trialrun/docker-compose.yml | server/src/index.js | server/README.md","[""F19""]","仍保持单机；为未来横向扩展铺路"
F21,对象存储（MinIO/S3兼容）,"存储从本地目录演进到 S3 兼容（先 MinIO），保持 signed-url 契约不变或提供兼容层","上传/预览/签名URL 在 MinIO 下可用；回归与 E2E 通过；迁移路径清晰可回滚","manual: trialrun 环境启用 MinIO 并完成一次上传预览",manual,TODO,TODO,TODO,"server/src/services/storage/* | deploy/trialrun/* | server/README.md","[""F20""]","优先用 @aws-sdk/client-s3；单机优先 MinIO"
F22,可观测性增强（metrics/日志）,"新增 /metrics（Prometheus）与更完整的结构化日志字段规范（不落敏感）","metrics 可抓取关键指标（HTTP/作业/DB）；日志具备 requestId/actorId/targetId 等字段","manual: curl /metrics 并核对字段；触发作业观察指标变化",manual,TODO,TODO,TODO,"server/src/app.js | server/src/observability/* | deploy/trialrun/*","[""F19""]","优先用 prom-client；OTel 放更后"
F22,可观测性增强（metrics/日志）,"新增 /metrics（Prometheus）与更完整的结构化日志字段规范（不落敏感）","metrics 可抓取关键指标（HTTP/作业/DB）；日志具备 requestId/actorId/targetId 等字段","manual: curl /metrics 并核对字段；触发作业观察指标变化",manual,DONE,DONE,DONE,"server/src/app.js | server/src/observability/* | deploy/trialrun/*","[""F19""]","优先用 prom-client；OTel 放更后"
F23,SSO/OIDC（可选，P7+）,"支持 OIDC 登录（企业 SSO），保留现有密码登录作为 fallback","可通过 OIDC 登录并绑定员工；权限模型不变；可配置开关","manual: 配置 OIDC provider 后走一次登录回调",manual,TODO,TODO,TODO,"server/src/routes/auth.js | server/src/services/oidc/* | server/README.md","[""F1""]","优先复用 openid-client/passport 策略"
F24,工作流扩展到其他实体（P7+）,"抽象 entity_type 扩展到请假/采购等（先骨架：definition+instance+task 复用）","新实体可创建 instance 并走同审批动作；不影响报销既有链路","manual: seed 一个 leave 定义并跑一条最小链路",manual,TODO,TODO,TODO,"server/src/routes/workflow.js | server/src/routes/leave.js | server/prisma/schema.prisma","[""F19""]","只做骨架与复用点，不做完整业务表单"
F25,敏感字段加密与脱敏（P6+）,"落实员工银行卡/身份证等敏感字段的可逆加密与脱敏输出，并对查看/变更写审计","对外响应仅脱敏；解密仅限特权权限并写 audit；不在日志/错误中泄露明文","manual: 创建员工并查看返回脱敏；用特权接口取明文并在 audit 检索记录",manual,TODO,TODO,TODO,"server/src/routes/users.js | server/src/services/crypto/* | server/src/routes/audit.js","[""F1""]","优先用成熟库（libsodium/crypto），并明确密钥轮换策略"
1 ID Title Description Acceptance Test_Method Tools Dev_Status Review1_Status Regression_Status Files Dependencies Notes
23 F19d 作业迁移（超期归档 -> pg-boss） 将 90 天游离归档迁移到 pg-boss（替代 node-cron），统一重试/并发/可观测字段 作业可重复执行幂等；多进程不重复处理；回归全绿 cd server && ./scripts/regression-ocr.sh && ./scripts/regression-all.sh manual DONE DONE DONE server/src/jobs/pgBossJobs.js | server/src/jobs/invoiceArchiveJob.js | server/src/jobs/jobSystem.js | server/README.md ["F19","F12"] invoice.archive-unused 默认按 INVOICE_ARCHIVE_CRON 调度；回滚：JOB_DRIVER=cron
24 F20 Worker进程拆分（可选） 提供 API 进程与 Worker 进程拆分的部署方式（compose 开关），保持单机也可跑 开启后：API 不跑作业；Worker 只跑作业；两者共享 DATABASE_URL；功能不回归 manual: docker compose 起两个进程并跑回归脚本 manual DONE DONE DONE deploy/trialrun/docker-compose.yml | server/src/index.js | server/README.md ["F19"] 仍保持单机；为未来横向扩展铺路
25 F21 对象存储（MinIO/S3兼容） 存储从本地目录演进到 S3 兼容（先 MinIO），保持 signed-url 契约不变或提供兼容层 上传/预览/签名URL 在 MinIO 下可用；回归与 E2E 通过；迁移路径清晰可回滚 manual: trialrun 环境启用 MinIO 并完成一次上传预览 manual TODO TODO TODO server/src/services/storage/* | deploy/trialrun/* | server/README.md ["F20"] 优先用 @aws-sdk/client-s3；单机优先 MinIO
26 F22 可观测性增强（metrics/日志） 新增 /metrics（Prometheus）与更完整的结构化日志字段规范（不落敏感） metrics 可抓取关键指标（HTTP/作业/DB）；日志具备 requestId/actorId/targetId 等字段 manual: curl /metrics 并核对字段；触发作业观察指标变化 manual TODO DONE TODO DONE TODO DONE server/src/app.js | server/src/observability/* | deploy/trialrun/* ["F19"] 优先用 prom-client；OTel 放更后
27 F23 SSO/OIDC（可选，P7+） 支持 OIDC 登录（企业 SSO），保留现有密码登录作为 fallback 可通过 OIDC 登录并绑定员工；权限模型不变；可配置开关 manual: 配置 OIDC provider 后走一次登录回调 manual TODO TODO TODO server/src/routes/auth.js | server/src/services/oidc/* | server/README.md ["F1"] 优先复用 openid-client/passport 策略
28 F24 工作流扩展到其他实体（P7+） 抽象 entity_type 扩展到请假/采购等（先骨架：definition+instance+task 复用） 新实体可创建 instance 并走同审批动作；不影响报销既有链路 manual: seed 一个 leave 定义并跑一条最小链路 manual TODO TODO TODO server/src/routes/workflow.js | server/src/routes/leave.js | server/prisma/schema.prisma ["F19"] 只做骨架与复用点，不做完整业务表单
29 F25 敏感字段加密与脱敏（P6+） 落实员工银行卡/身份证等敏感字段的可逆加密与脱敏输出，并对查看/变更写审计 对外响应仅脱敏；解密仅限特权权限并写 audit；不在日志/错误中泄露明文 manual: 创建员工并查看返回脱敏；用特权接口取明文并在 audit 检索记录 manual TODO TODO TODO server/src/routes/users.js | server/src/services/crypto/* | server/src/routes/audit.js ["F1"] 优先用成熟库（libsodium/crypto），并明确密钥轮换策略