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

docs/test(P19ERP1-5,P19ERP1-6): 收口ERP文档矩阵与回归

浏览代码
这个提交包含在：
wangsli
2026-03-08 16:29:16 +08:00
父节点 855bcdffeb
当前提交 f407c01484
共修改 6 个文件，包含 550 行新增和 222 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
docs/domain-events.md
+9 -2
查看文件
@@ -1,7 +1,7 @@
# 领域事件清单（P19 / P19+IM-1） # 领域事件清单（P19 / P19+IM-1 / P19+ERP-1）
**快照日期**：2026-03-08 **快照日期**：2026-03-08
**目标**：冻结 `hyb-oa` 当前采购与资产域的标准领域事件名，并补充 `P19+IM-1` 已实际消费的 IM 通知类型清单，作为后续 ERP / IM / AI 适配的事实源。 **目标**：冻结 `hyb-oa` 当前采购与资产域的标准领域事件名，并补充 `P19+IM-1` 已实际消费的 IM 通知类型清单，以及 `P19+ERP-1` 已实际落地的 ERP 消费映射，作为后续 ERP / IM / AI 适配的事实源。
## 1. 使用原则 ## 1. 使用原则
- 本文档同时维护两类事实： - 本文档同时维护两类事实：
@@ -90,3 +90,10 @@
- `inventory_check.started` - `inventory_check.started`
这些事件名称仍保留在长期蓝图中，但不属于 `P19+IM-1` 的首批协同覆盖范围。 这些事件名称仍保留在长期蓝图中，但不属于 `P19+IM-1` 的首批协同覆盖范围。
## 10. P19+ERP-1 已实现消费映射
- `P19+ERP-1` 没有新增新的领域事件名；当前 ERP 一期真正落地消费的既有业务事实是 `reimbursement.paid`。
- 运行时不会把 ERP 专有结构写回核心报销表，而是先构建标准化 `ReimbursementJournalSlice`，再通过 `erp.journal.export` 写入 `IntegrationOutbox` 异步派发。
- `ReimbursementJournalSlice.sourceEventName` 固定为 `reimbursement.paid`，用于标记该凭证切片来源于“报销付款完成”这一既有业务事实。
- ERP 主数据同步（`LegalEntity` / `CostCenter` / `Supplier`）属于主动 Pull，不作为新的领域事件名纳入本表。
- `purchase_request.approved`、`asset.card.created`、`inventory_check.completed` 等事件仍只冻结名称与最小载荷；真实 ERP 导出留待后续 `P19+ERP-2 / ERP-3`。
docs/feature-matrix.md
+12 -3
查看文件
@@ -1,8 +1,8 @@
# hyb-oa 实现状态矩阵（P5-P19+IM-1） # hyb-oa 实现状态矩阵（P5-P19+IM-1+ERP-1）
**快照日期**：2026-03-08 **快照日期**：2026-03-08
**范围**：`F1-F42`（含 `F19b/F19c/F19d`）+ `R1-S2` + `P9A1-P9D1` + `P10E1-P10G1` + `G0-G6` + `H1` + `M1-M4` + `P13-0-P13-8` + `P14-0-P14-8` + `P15A-0-P15A-5` + `P15B-0-P15B-6` + `P16A-0-P16A-6` + `P16B-0-P16B-6` + `P16C-0-P16C-6` + `R9-0-R9-3` + `G2-0-G2-6` + `P17A-0-P17A-6` + `P17B-0-P17B-6` + `P18A-0-P18A-6` + `P18B-0-P18B-6` + `P19-0-P19-6` + `P19IM1-0-P19IM1-6`，共 199 项。 **范围**：`F1-F42`（含 `F19b/F19c/F19d`）+ `R1-S2` + `P9A1-P9D1` + `P10E1-P10G1` + `G0-G6` + `H1` + `M1-M4` + `P13-0-P13-8` + `P14-0-P14-8` + `P15A-0-P15A-5` + `P15B-0-P15B-6` + `P16A-0-P16A-6` + `P16B-0-P16B-6` + `P16C-0-P16C-6` + `R9-0-R9-3` + `G2-0-G2-6` + `P17A-0-P17A-6` + `P17B-0-P17B-6` + `P18A-0-P18A-6` + `P18B-0-P18B-6` + `P19-0-P19-6` + `P19IM1-0-P19IM1-6` + `P19ERP1-0-P19ERP1-6`，共 206 项。
**事实源**：`issues/2026-02-09_13-39-02-p5-blueprint-v3.csv` + `issues/2026-02-09_23-30-00-p6-p8-remaining-work-master.csv` + `issues/2026-02-10_09-42-31-p9-maintenance-performance-matrix.csv` + `issues/2026-02-10_10-35-30-p10-production-hardening.csv` + `issues/2026-02-11-p11-p12-governance-mobile.csv` + `issues/2026-02-12_01-09-41-p13-l5-governance.csv` + `issues/2026-02-13_00-11-56-p14-l5-operationalization.csv` + `issues/2026-03-06_14-30-00-p15a-l5-permission-decouple.csv` + `issues/2026-03-06_14-30-00-p15b-l5-leave-v1.csv` + `issues/2026-03-07_13-47-05-p16a-l5-master-data-core.csv` + `issues/2026-03-07_16-22-07-p16b-l5-holiday-calendar.csv` + `issues/2026-03-07_17-14-39-p16c-l5-suppliers.csv` + `issues/2026-03-07_18-15-03-r9-g2-p19-roadmap-refresh.csv` + `issues/2026-03-07_18-16-00-g2-l5-cross-domain-bridge.csv` + `issues/2026-03-07_19-33-09-p17a-l5-procurement-core.csv` + `issues/2026-03-07_21-00-37-p17b-l5-procurement-budget-archive.csv` + `issues/2026-03-07_22-02-09-p18a-l5-asset-registry-core.csv` + `issues/2026-03-07_22-34-03-p18b-l5-asset-movements-inventory.csv` + `issues/2026-03-07_23-22-00-p19-l4-integration-readiness.csv` + `issues/2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv`（执行合同） **事实源**：`issues/2026-02-09_13-39-02-p5-blueprint-v3.csv` + `issues/2026-02-09_23-30-00-p6-p8-remaining-work-master.csv` + `issues/2026-02-10_09-42-31-p9-maintenance-performance-matrix.csv` + `issues/2026-02-10_10-35-30-p10-production-hardening.csv` + `issues/2026-02-11-p11-p12-governance-mobile.csv` + `issues/2026-02-12_01-09-41-p13-l5-governance.csv` + `issues/2026-02-13_00-11-56-p14-l5-operationalization.csv` + `issues/2026-03-06_14-30-00-p15a-l5-permission-decouple.csv` + `issues/2026-03-06_14-30-00-p15b-l5-leave-v1.csv` + `issues/2026-03-07_13-47-05-p16a-l5-master-data-core.csv` + `issues/2026-03-07_16-22-07-p16b-l5-holiday-calendar.csv` + `issues/2026-03-07_17-14-39-p16c-l5-suppliers.csv` + `issues/2026-03-07_18-15-03-r9-g2-p19-roadmap-refresh.csv` + `issues/2026-03-07_18-16-00-g2-l5-cross-domain-bridge.csv` + `issues/2026-03-07_19-33-09-p17a-l5-procurement-core.csv` + `issues/2026-03-07_21-00-37-p17b-l5-procurement-budget-archive.csv` + `issues/2026-03-07_22-02-09-p18a-l5-asset-registry-core.csv` + `issues/2026-03-07_22-34-03-p18b-l5-asset-movements-inventory.csv` + `issues/2026-03-07_23-22-00-p19-l4-integration-readiness.csv` + `issues/2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv` + `issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv`（执行合同）
**说明**： **说明**：
- 本矩阵用于全局读图（审计/交接/回归覆盖追踪），不替代 `issues/*.csv` 的执行合同职责。 - 本矩阵用于全局读图（审计/交接/回归覆盖追踪），不替代 `issues/*.csv` 的执行合同职责。
@@ -229,3 +229,12 @@
| P19IM1-4 | 前端渠道管理页与导航入口 | N/A | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08 | DONE | client:typecheck/build | 新增 `NotificationChannelsPage`、`/system/notification-channels` 路由与菜单入口，支持测试发送 | | P19IM1-4 | 前端渠道管理页与导航入口 | N/A | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08 | DONE | client:typecheck/build | 新增 `NotificationChannelsPage`、`/system/notification-channels` 路由与菜单入口，支持测试发送 |
| P19IM1-5 | OpenAPI文档与矩阵同步 | N/A | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08 | DONE | validate-feature-matrix | 集成边界、领域事件与 Feature Matrix 更新到 `P5-P19+IM-1` 并纳入新合同事实源 | | P19IM1-5 | OpenAPI文档与矩阵同步 | N/A | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08 | DONE | validate-feature-matrix | 集成边界、领域事件与 Feature Matrix 更新到 `P5-P19+IM-1` 并纳入新合同事实源 |
| P19IM1-6 | P19IM1回归与验收收口 | N/A | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08 | DONE | server:test + regression-all + client:typecheck/build | 企微 mock / webhook、渠道后台、业务入队与回归脚本全部通过，且站内通知 / 邮件零回归 | | P19IM1-6 | P19IM1回归与验收收口 | N/A | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv | 2026-03-08 | DONE | server:test + regression-all + client:typecheck/build | 企微 mock / webhook、渠道后台、业务入队与回归脚本全部通过，且站内通知 / 邮件零回归 |
| P19ERP1-0 | P19ERP1执行合同建档 | N/A | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08 | DONE | CSV 校验 | ERP 主数据同步与报销付款凭证桥接执行合同建档，冻结先入后出与不污染核心域原则 |
| P19ERP1-1 | ERP适配契约与集成层模型 | N/A | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08 | DONE | prisma:validate + server:test | 新增 `IntegrationBinding` / `IntegrationSyncState` 与 ERP provider 扩展契约，且不向核心事务表写 ERP 私有字段 |
| P19ERP1-2 | 主数据入站同步服务与接口 | N/A | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08 | DONE | server:test + regression-integrations | `LegalEntity`、`CostCenter`、`Supplier` 支持 ERP 全量 Pull、状态查询与可选 cron，同步冲突与 skip 语义可追踪 |
| P19ERP1-3 | 报销付款凭证切片出站 | N/A | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08 | DONE | server:test + regression-integrations + regression-all | `reimbursement.paid` 可预览标准 journal slice，并通过 `erp.journal.export` Outbox 导出；旧 `/api/integrations/erp/sync/:id` 继续兼容 |
| P19ERP1-4 | ERP管理页与报销详情导出入口 | N/A | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08 | DONE | client:typecheck/build | 新增 `ErpIntegrationPage`、系统导航入口与报销详情 ERP 导出卡片，支持手动同步与导出反馈 |
| P19ERP1-5 | OpenAPI文档与矩阵同步 | N/A | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08 | DONE | validate-feature-matrix | 集成边界、领域事件、Feature Matrix 与校验器同步到 `P5-P19+IM-1+ERP-1`，并纳入 ERP-1 合同事实源 |
| P19ERP1-6 | P19ERP1回归与安全收口 | N/A | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | 2026-03-08 | DONE | server:test + regression-integrations + regression-all + client:typecheck/build | 主数据 Pull、报销凭证切片、ERP 管理入口、开关阻断与 dead_letter 重入全部通过，且既有主流程零回归 |
docs/integration-boundaries.md
+10 -3
查看文件
@@ -1,8 +1,8 @@
# 集成边界冻结（P19 / P19+IM-1） # 集成边界冻结（P19 / P19+IM-1 / P19+ERP-1）
**快照日期**：2026-03-08 **快照日期**：2026-03-08
**当前基线**：`P19+IM-1` 已完成，当前运行时已落地企微群机器人 + 深链 + Outbox 异步派发的一期协同适配。 **当前基线**：`P19+IM-1` 与 `P19+ERP-1` 已完成；当前运行时已落地企微群机器人 + 深链 + Outbox 异步派发的一期协同适配，以及 ERP 主数据 Pull / 报销付款凭证切片的一期桥接。
**目标**：在保持核心域稳定的前提下，冻结 ERP / IM / AI / MCP 的长期边界，并记录 IM 一期的已实现范围与后续禁入规则。 **目标**：在保持核心域稳定的前提下，冻结 ERP / IM / AI / MCP 的长期边界，并记录 IM 一期与 ERP 一期的已实现范围、禁入规则和后续扩展位。
## 1. 总体原则 ## 1. 总体原则
@@ -51,6 +51,13 @@
- `P19+ERP-2`：采购审批结果导出 / 回写协议 - `P19+ERP-2`：采购审批结果导出 / 回写协议
- `P19+ERP-3`：资产台账摘要导出协议 - `P19+ERP-3`：资产台账摘要导出协议
### 2.5 P19+ERP-1 已实现范围
- 已新增 `IntegrationBinding` 与 `IntegrationSyncState` 两张集成层私有表，用于维护 ERP 映射与同步状态，不向核心事务表注入 ERP 私有字段。
- 已实现 `LegalEntity`、`CostCenter`、`Supplier` 的 ERP 全量 Pull，同步方式固定为 `manual + cron`；其中 `ERP_MASTER_DATA_SYNC_CRON` 为空时不自动调度。
- 已实现 `reimbursement.paid` 的标准化凭证切片导出，运行时通过 `erp.journal.export` 写入 `IntegrationOutbox` 并由 dispatcher 异步派发。
- 已兼容保留历史 `erp.reimbursement.paid` 派发路径；成功导出后统一回写 `integration_bindings(provider=erp, entity_type=reimbursement_journal)`。
- 已明确 `ERP_SYNC_ENABLED` 与 `erp_sync` feature flag 共同构成 ERP 管理端总闸，任一关闭都必须阻断主数据同步与手动导出。
## 3. IM / 协同适配边界 ## 3. IM / 协同适配边界
### 3.1 一期已实现能力（P19+IM-1） ### 3.1 一期已实现能力（P19+IM-1）
issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv
+8 -8
查看文件
@@ -1,8 +1,8 @@
ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes
P19ERP1-0,P19ERP1执行合同建档,创建并校验P19ERP1主数据同步与凭证切片执行合同CSV,CSV通过校验且字段完整,python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv,manual,DONE,DONE,DONE,issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv,[],P19ERP1先做主数据入站与报销付款凭证切片 不进入采购资产真实过账 P19ERP1-0,P19ERP1执行合同建档,创建并校验P19ERP1主数据同步与凭证切片执行合同CSV,CSV通过校验且字段完整,python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv,manual,DONE,DONE,DONE,issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv,[],P19ERP1先做主数据入站与报销付款凭证切片 不进入采购资产真实过账
P19ERP1-1,ERP适配契约与集成层模型,新增IntegrationBinding与IntegrationSyncState并扩展ERP provider契约,不向核心事务表写ERP私有字段且provider支持master data pull与journal export两类能力,cd server && npm run prisma:validate && npm run test,manual,TODO,TODO,TODO,server/prisma/schema.prisma | server/src/services/integrations/erp.js | server/src/config.js | server/tests,"[""P19ERP1-0""]",仅允许新增集成层私有表 不得把ERP字段塞入LegalEntity CostCenter Supplier PurchaseRequest AssetCard P19ERP1-1,ERP适配契约与集成层模型,新增IntegrationBinding与IntegrationSyncState并扩展ERP provider契约,不向核心事务表写ERP私有字段且provider支持master data pull与journal export两类能力,cd server && npm run prisma:validate && npm run test,manual,DONE,DONE,DONE,server/prisma/schema.prisma | server/src/services/integrations/erp.js | server/src/config.js | server/tests,"[""P19ERP1-0""]",仅允许新增集成层私有表 不得把ERP字段塞入LegalEntity CostCenter Supplier PurchaseRequest AssetCard
P19ERP1-2,主数据入站同步服务与接口,实现LegalEntity CostCenter Supplier的ERP拉取同步 手动接口 状态查询与cron作业,三类主数据可按业务键幂等upsert并记录同步状态 停用仅归档不硬删,cd server && npm run test && ./scripts/regression-integrations.sh,manual,TODO,TODO,TODO,server/src/routes/integrations.js | server/src/services/integrations/erpMasterData.js | server/src/jobs | server/tests,"[""P19ERP1-1""]",同步顺序固定为LegalEntity再CostCenter再Supplier 无稳定supplier code则安全skip P19ERP1-2,主数据入站同步服务与接口,实现LegalEntity CostCenter Supplier的ERP拉取同步 手动接口 状态查询与cron作业,三类主数据可按业务键幂等upsert并记录同步状态 停用仅归档不硬删,cd server && npm run test && ./scripts/regression-integrations.sh,manual,DONE,DONE,DONE,server/src/routes/integrations.js | server/src/services/integrations/erpMasterData.js | server/src/jobs | server/tests,"[""P19ERP1-1""]",同步顺序固定为LegalEntity再CostCenter再Supplier 无稳定supplier code则安全skip
P19ERP1-3,报销付款凭证切片出站,将现有erp.reimbursement.paid泛化为erp.journal.export并提供预览与导出接口,paid报销单可预览标准凭证切片并通过Outbox导出ERP且旧接口保持兼容,cd server && npm run test && OCR_PROVIDER=mock JOBS_ENABLED=false ./scripts/regression-all.sh,manual,TODO,TODO,TODO,server/src/routes/reimbursements.js | server/src/routes/integrations.js | server/src/services/integrations/erpJournal.js | server/src/services/integrations/dispatcher.js | server/src/services/integrations/outbox.js | server/tests,"[""P19ERP1-2""]",ERP-1只实装reimbursement paid journal export 采购资产仅保留后续扩展位 P19ERP1-3,报销付款凭证切片出站,将现有erp.reimbursement.paid泛化为erp.journal.export并提供预览与导出接口,paid报销单可预览标准凭证切片并通过Outbox导出ERP且旧接口保持兼容,cd server && npm run test && OCR_PROVIDER=mock JOBS_ENABLED=false ./scripts/regression-all.sh,manual,DONE,DONE,DONE,server/src/routes/reimbursements.js | server/src/routes/integrations.js | server/src/services/integrations/erpJournal.js | server/src/services/integrations/dispatcher.js | server/src/services/integrations/outbox.js | server/tests,"[""P19ERP1-2""]",ERP-1只实装reimbursement paid journal export 采购资产仅保留后续扩展位
P19ERP1-4,ERP管理页与报销详情导出入口,新增ERP集成管理页并在报销详情页增加ERP导出卡片,integrations后台可查看主数据同步状态且paid报销详情可执行ERP导出,cd client && npm run typecheck && npm run build,manual,TODO,TODO,TODO,client/src/pages/ErpIntegrationPage.tsx | client/src/pages/ReimbursementDetailPage.tsx | client/src/api/integrations.ts | client/src/router/index.tsx | client/src/components/navigation/NavLinks.tsx,"[""P19ERP1-3""]",继续使用integration.manage 不新增ERP配置大表单 P19ERP1-4,ERP管理页与报销详情导出入口,新增ERP集成管理页并在报销详情页增加ERP导出卡片,integrations后台可查看主数据同步状态且paid报销详情可执行ERP导出,cd client && npm run typecheck && npm run build,manual,DONE,DONE,DONE,client/src/pages/ErpIntegrationPage.tsx | client/src/pages/ReimbursementDetailPage.tsx | client/src/api/integrations.ts | client/src/router/index.tsx | client/src/components/navigation/NavLinks.tsx,"[""P19ERP1-3""]",继续使用integration.manage 不新增ERP配置大表单
P19ERP1-5,OpenAPI文档与矩阵同步,同步ERP-1接口说明 集成边界 事件映射与Feature Matrix事实源,Feature Matrix收口到P5-P19+IM-1+ERP-1且事实源纳入新合同,python3 scripts/validate-feature-matrix.py,manual,TODO,TODO,TODO,docs/integration-boundaries.md | docs/domain-events.md | docs/feature-matrix.md | scripts/validate-feature-matrix.py | issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv,"[""P19ERP1-4""]",矩阵总数从199更新到206 并追加P19ERP1-0到P19ERP1-6 P19ERP1-5,OpenAPI文档与矩阵同步,同步ERP-1接口说明 集成边界 事件映射与Feature Matrix事实源,Feature Matrix收口到P5-P19+IM-1+ERP-1且事实源纳入新合同,python3 scripts/validate-feature-matrix.py,manual,DONE,DONE,DONE,docs/integration-boundaries.md | docs/domain-events.md | docs/feature-matrix.md | scripts/validate-feature-matrix.py | issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv,"[""P19ERP1-4""]",矩阵总数从199更新到206 并追加P19ERP1-0到P19ERP1-6
P19ERP1-6,P19ERP1回归与安全收口,完成主数据同步 凭证切片 后台入口与集成回归验证后再进入下一专项,ERP mock与http模式可回归 关闭ERP开关时核心业务零回归且无越权导出,cd server && npm run test && ./scripts/regression-integrations.sh && OCR_PROVIDER=mock JOBS_ENABLED=false ./scripts/regression-all.sh && cd ../client && npm run typecheck && npm run build,manual,TODO,TODO,TODO,issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | server/scripts/regression-integrations.sh | client/src/pages/ErpIntegrationPage.tsx | client/src/pages/ReimbursementDetailPage.tsx,"[""P19ERP1-5""]",重点核对主数据绑定冲突 凭证死信重入 越权导出与ERP 4xx 5xx timeout处理 P19ERP1-6,P19ERP1回归与安全收口,完成主数据同步 凭证切片 后台入口与集成回归验证后再进入下一专项,ERP mock与http模式可回归 关闭ERP开关时核心业务零回归且无越权导出,cd server && npm run test && ./scripts/regression-integrations.sh && OCR_PROVIDER=mock JOBS_ENABLED=false ./scripts/regression-all.sh && cd ../client && npm run typecheck && npm run build,manual,DONE,DONE,DONE,issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | server/scripts/regression-integrations.sh | client/src/pages/ErpIntegrationPage.tsx | client/src/pages/ReimbursementDetailPage.tsx,"[""P19ERP1-5""]",重点核对主数据绑定冲突 凭证死信重入 越权导出与ERP 4xx 5xx timeout处理
1 ID Title Description Acceptance Test_Method Tools Dev_Status Review1_Status Regression_Status Files Dependencies Notes
2 P19ERP1-0 P19ERP1执行合同建档 创建并校验P19ERP1主数据同步与凭证切片执行合同CSV CSV通过校验且字段完整 python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv manual DONE DONE DONE issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv [] P19ERP1先做主数据入站与报销付款凭证切片 不进入采购资产真实过账
3 P19ERP1-1 ERP适配契约与集成层模型 新增IntegrationBinding与IntegrationSyncState并扩展ERP provider契约 不向核心事务表写ERP私有字段且provider支持master data pull与journal export两类能力 cd server && npm run prisma:validate && npm run test manual TODO DONE TODO DONE TODO DONE server/prisma/schema.prisma | server/src/services/integrations/erp.js | server/src/config.js | server/tests ["P19ERP1-0"] 仅允许新增集成层私有表 不得把ERP字段塞入LegalEntity CostCenter Supplier PurchaseRequest AssetCard
4 P19ERP1-2 主数据入站同步服务与接口 实现LegalEntity CostCenter Supplier的ERP拉取同步 手动接口 状态查询与cron作业 三类主数据可按业务键幂等upsert并记录同步状态 停用仅归档不硬删 cd server && npm run test && ./scripts/regression-integrations.sh manual TODO DONE TODO DONE TODO DONE server/src/routes/integrations.js | server/src/services/integrations/erpMasterData.js | server/src/jobs | server/tests ["P19ERP1-1"] 同步顺序固定为LegalEntity再CostCenter再Supplier 无稳定supplier code则安全skip
5 P19ERP1-3 报销付款凭证切片出站 将现有erp.reimbursement.paid泛化为erp.journal.export并提供预览与导出接口 paid报销单可预览标准凭证切片并通过Outbox导出ERP且旧接口保持兼容 cd server && npm run test && OCR_PROVIDER=mock JOBS_ENABLED=false ./scripts/regression-all.sh manual TODO DONE TODO DONE TODO DONE server/src/routes/reimbursements.js | server/src/routes/integrations.js | server/src/services/integrations/erpJournal.js | server/src/services/integrations/dispatcher.js | server/src/services/integrations/outbox.js | server/tests ["P19ERP1-2"] ERP-1只实装reimbursement paid journal export 采购资产仅保留后续扩展位
6 P19ERP1-4 ERP管理页与报销详情导出入口 新增ERP集成管理页并在报销详情页增加ERP导出卡片 integrations后台可查看主数据同步状态且paid报销详情可执行ERP导出 cd client && npm run typecheck && npm run build manual TODO DONE TODO DONE TODO DONE client/src/pages/ErpIntegrationPage.tsx | client/src/pages/ReimbursementDetailPage.tsx | client/src/api/integrations.ts | client/src/router/index.tsx | client/src/components/navigation/NavLinks.tsx ["P19ERP1-3"] 继续使用integration.manage 不新增ERP配置大表单
7 P19ERP1-5 OpenAPI文档与矩阵同步 同步ERP-1接口说明 集成边界 事件映射与Feature Matrix事实源 Feature Matrix收口到P5-P19+IM-1+ERP-1且事实源纳入新合同 python3 scripts/validate-feature-matrix.py manual TODO DONE TODO DONE TODO DONE docs/integration-boundaries.md | docs/domain-events.md | docs/feature-matrix.md | scripts/validate-feature-matrix.py | issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv ["P19ERP1-4"] 矩阵总数从199更新到206 并追加P19ERP1-0到P19ERP1-6
8 P19ERP1-6 P19ERP1回归与安全收口 完成主数据同步 凭证切片 后台入口与集成回归验证后再进入下一专项 ERP mock与http模式可回归 关闭ERP开关时核心业务零回归且无越权导出 cd server && npm run test && ./scripts/regression-integrations.sh && OCR_PROVIDER=mock JOBS_ENABLED=false ./scripts/regression-all.sh && cd ../client && npm run typecheck && npm run build manual TODO DONE TODO DONE TODO DONE issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv | server/scripts/regression-integrations.sh | client/src/pages/ErpIntegrationPage.tsx | client/src/pages/ReimbursementDetailPage.tsx ["P19ERP1-5"] 重点核对主数据绑定冲突 凭证死信重入 越权导出与ERP 4xx 5xx timeout处理
scripts/validate-feature-matrix.py
+1
查看文件
@@ -39,6 +39,7 @@ CSV_FACT_SOURCES = [
ROOT / "issues" / "2026-03-07_22-34-03-p18b-l5-asset-movements-inventory.csv", ROOT / "issues" / "2026-03-07_22-34-03-p18b-l5-asset-movements-inventory.csv",
ROOT / "issues" / "2026-03-07_23-22-00-p19-l4-integration-readiness.csv", ROOT / "issues" / "2026-03-07_23-22-00-p19-l4-integration-readiness.csv",
ROOT / "issues" / "2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv", ROOT / "issues" / "2026-03-08_12-18-10-p19-im-1-l5-collaboration-adapter.csv",
ROOT / "issues" / "2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv",
] ]
ID_PATTERN = re.compile(r"^[A-Z][0-9][0-9A-Za-z-]*$") ID_PATTERN = re.compile(r"^[A-Z][0-9][0-9A-Za-z-]*$")
server/scripts/regression-integrations.sh
+510 -206
查看文件
@@ -3,6 +3,16 @@ set -euo pipefail
ERP_SYNC_TIMEOUT_MS="${ERP_SYNC_TIMEOUT_MS:-300}" ERP_SYNC_TIMEOUT_MS="${ERP_SYNC_TIMEOUT_MS:-300}"
MOCK_ERP_PORT="${MOCK_ERP_PORT:-$((3900 + RANDOM % 500))}" MOCK_ERP_PORT="${MOCK_ERP_PORT:-$((3900 + RANDOM % 500))}"
APP_PORT="${APP_PORT:-$((4300 + RANDOM % 500))}"
BASE_URL="http://127.0.0.1:${APP_PORT}"
DEVICE_FINGERPRINT="${DEVICE_FINGERPRINT:-regression-integrations}"
FINANCE_MGR_IDENTIFIER="${FINANCE_MGR_IDENTIFIER:-finance_mgr@hyinda.com}"
FINANCE_MGR_PASSWORD="${FINANCE_MGR_PASSWORD:-FinanceMgrPassword1234}"
RUN_SUFFIX="$(date +%s)-$RANDOM"
RUN_SUFFIX_NUMERIC="${RUN_SUFFIX//[^0-9]/}"
LEGAL_ENTITY_CODE="LE${RUN_SUFFIX_NUMERIC}"
COST_CENTER_CODE="CC${RUN_SUFFIX_NUMERIC}"
SUPPLIER_CODE="SUP${RUN_SUFFIX_NUMERIC}"
if ! command -v node >/dev/null 2>&1; then if ! command -v node >/dev/null 2>&1; then
echo "[ERROR] node not found" >&2 echo "[ERROR] node not found" >&2
@@ -35,10 +45,15 @@ if [[ -z "${DATABASE_URL:-}" ]]; then
fi fi
TMP_DIR="$(mktemp -d)" TMP_DIR="$(mktemp -d)"
RUN_SUFFIX="$(date +%s)-$RANDOM"
MOCK_SERVER_PID="" MOCK_SERVER_PID=""
APP_SERVER_PID=""
TOKEN=""
cleanup() { cleanup() {
if [[ -n "$APP_SERVER_PID" ]] && kill -0 "$APP_SERVER_PID" >/dev/null 2>&1; then
kill "$APP_SERVER_PID" >/dev/null 2>&1 || true
wait "$APP_SERVER_PID" >/dev/null 2>&1 || true
fi
if [[ -n "$MOCK_SERVER_PID" ]] && kill -0 "$MOCK_SERVER_PID" >/dev/null 2>&1; then if [[ -n "$MOCK_SERVER_PID" ]] && kill -0 "$MOCK_SERVER_PID" >/dev/null 2>&1; then
kill "$MOCK_SERVER_PID" >/dev/null 2>&1 || true kill "$MOCK_SERVER_PID" >/dev/null 2>&1 || true
wait "$MOCK_SERVER_PID" >/dev/null 2>&1 || true wait "$MOCK_SERVER_PID" >/dev/null 2>&1 || true
@@ -47,31 +62,102 @@ cleanup() {
} }
trap cleanup EXIT trap cleanup EXIT
assert_status() {
local actual="$1"
local expected="$2"
local name="$3"
if [[ "$actual" != "$expected" ]]; then
echo "[ERROR] $name expected HTTP $expected but got $actual" >&2
exit 1
fi
}
start_mock_erp_server() { start_mock_erp_server() {
local server_file="$TMP_DIR/mock-erp-server.js" local server_file="$TMP_DIR/mock-erp-server.js"
cat >"$server_file" <<'NODE' cat >"$server_file" <<'NODE'
const http = require("node:http"); const http = require('node:http');
const { URL } = require("node:url"); const { URL } = require('node:url');
const port = Number(process.argv[2] || 3900); const port = Number(process.argv[2] || 3900);
const runSuffix = String(process.env.RUN_SUFFIX ?? '001');
const runDigits = runSuffix.replace(/\D+/g, '');
const legalEntityCode = `LE${runDigits}`;
const costCenterCode = `CC${runDigits}`;
const supplierCode = `SUP${runDigits}`;
function sendJson(res, status, payload) { function sendJson(res, status, payload) {
res.statusCode = status; res.statusCode = status;
res.setHeader("content-type", "application/json; charset=utf-8"); res.setHeader('content-type', 'application/json; charset=utf-8');
res.end(JSON.stringify(payload)); res.end(JSON.stringify(payload));
} }
const server = http.createServer(async (req, res) => { const server = http.createServer(async (req, res) => {
const url = new URL(req.url, `http://${req.headers.host || `127.0.0.1:${port}`}`); const url = new URL(req.url, `http://${req.headers.host || `127.0.0.1:${port}`}`);
if (req.method === "GET" && url.pathname === "/health") { if (req.method === 'GET' && url.pathname === '/health') {
return sendJson(res, 200, { ok: true, mode: "health" }); return sendJson(res, 200, { ok: true, mode: 'health' });
} }
if (req.method === "POST" && url.pathname === "/erp/reimbursements/paid") { if (req.method === 'POST' && url.pathname === '/erp/master-data/pull') {
const mode = url.searchParams.get("mode") || "success"; const mode = url.searchParams.get('mode') || 'success';
if (mode === 'timeout') {
setTimeout(() => {
sendJson(res, 200, { ok: true, delayed: true });
}, 1500);
return;
}
if (mode === 'client') {
return sendJson(res, 422, { ok: false, code: 'invalid_payload', message: 'mock client error' });
}
if (mode === 'server') {
return sendJson(res, 503, { ok: false, code: 'service_unavailable', message: 'mock server error' });
}
return sendJson(res, 200, {
ok: true,
legalEntities: [
{
externalId: `ERP-${legalEntityCode}`,
code: legalEntityCode,
name: `法体-${runSuffix}`,
shortName: `法体-${runDigits}`,
currencyCode: 'CNY',
taxNo: `TAX-${runDigits}`,
enabled: true,
},
],
costCenters: [
{
externalId: `ERP-${costCenterCode}`,
legalEntityCode,
code: costCenterCode,
name: `成本中心-${runSuffix}`,
enabled: true,
},
],
suppliers: [
{
externalId: `ERP-${supplierCode}`,
legalEntityCode,
code: supplierCode,
name: `供应商-${runSuffix}`,
shortName: `供应商-${runDigits}`,
taxNo: `SUP-TAX-${runDigits}`,
contactName: '张三',
contactPhone: '13800000000',
paymentTerms: '月结30天',
enabled: true,
},
],
});
}
if (
req.method === 'POST' &&
(url.pathname === '/erp/journals/reimbursements/paid' || url.pathname === '/erp/reimbursements/paid')
) {
const mode = url.searchParams.get('mode') || 'success';
const chunks = []; const chunks = [];
for await (const chunk of req) { for await (const chunk of req) {
chunks.push(chunk); chunks.push(chunk);
@@ -79,58 +165,58 @@ const server = http.createServer(async (req, res) => {
let parsedBody = null; let parsedBody = null;
try { try {
parsedBody = JSON.parse(Buffer.concat(chunks).toString("utf8") || "{}"); parsedBody = JSON.parse(Buffer.concat(chunks).toString('utf8') || '{}');
} catch { } catch {
parsedBody = null; parsedBody = null;
} }
if (mode === "timeout") { if (mode === 'timeout') {
setTimeout(() => { setTimeout(() => {
sendJson(res, 200, { sendJson(res, 200, {
ok: true, ok: true,
scenario: "timeout", scenario: 'timeout',
externalId: `ERP-TIMEOUT-${Date.now()}`, externalId: `ERP-TIMEOUT-${Date.now()}`,
reimbursementId: parsedBody?.reimbursementId || null, reimbursementId: parsedBody?.reimbursementId || parsedBody?.entityId || null,
}); });
}, 1500); }, 1500);
return; return;
} }
if (mode === "client") { if (mode === 'client') {
return sendJson(res, 422, { return sendJson(res, 422, {
ok: false, ok: false,
scenario: "client", scenario: 'client',
code: "invalid_payload", code: 'invalid_payload',
message: "mock client error", message: 'mock client error',
}); });
} }
if (mode === "server") { if (mode === 'server') {
return sendJson(res, 503, { return sendJson(res, 503, {
ok: false, ok: false,
scenario: "server", scenario: 'server',
code: "service_unavailable", code: 'service_unavailable',
message: "mock server error", message: 'mock server error',
}); });
} }
return sendJson(res, 200, { return sendJson(res, 200, {
ok: true, ok: true,
scenario: "success", scenario: 'success',
externalId: `ERP-${parsedBody?.formNumber || parsedBody?.reimbursementId || Date.now()}`, externalId: `ERP-${parsedBody?.documentNo || parsedBody?.formNumber || parsedBody?.entityId || Date.now()}`,
reimbursementId: parsedBody?.reimbursementId || null, reimbursementId: parsedBody?.reimbursementId || parsedBody?.entityId || null,
}); });
} }
sendJson(res, 404, { ok: false, message: "not_found" }); sendJson(res, 404, { ok: false, message: 'not_found' });
}); });
server.listen(port, "127.0.0.1", () => { server.listen(port, '127.0.0.1', () => {
process.stdout.write(`mock-erp-listening:${port}\n`); process.stdout.write(`mock-erp-listening:${port}\n`);
}); });
NODE NODE
node "$server_file" "$MOCK_ERP_PORT" >"$TMP_DIR/mock-erp.log" 2>&1 & RUN_SUFFIX="$RUN_SUFFIX" node "$server_file" "$MOCK_ERP_PORT" >"$TMP_DIR/mock-erp.log" 2>&1 &
MOCK_SERVER_PID="$!" MOCK_SERVER_PID="$!"
for _ in $(seq 1 30); do for _ in $(seq 1 30); do
@@ -145,180 +231,71 @@ NODE
exit 1 exit 1
} }
create_paid_reimbursement_and_enqueue() { start_app_server() {
local scenario="$1" PORT="$APP_PORT" \
DATABASE_URL="$DATABASE_URL" RUN_SUFFIX="$RUN_SUFFIX" SCENARIO="$scenario" node <<'NODE' HOST="127.0.0.1" \
require("dotenv/config"); JOBS_ENABLED=false \
OCR_PROVIDER=mock \
const { createPrismaClient } = require("./src/prismaClient");
const { getConfig } = require("./src/config");
const { buildErpPayload } = require("./src/services/integrations/erp");
const { enqueueIntegrationEvent } = require("./src/services/integrations/outbox");
(async () => {
const runSuffix = process.env.RUN_SUFFIX;
const scenario = process.env.SCENARIO;
const config = getConfig();
const { prisma, pool } = createPrismaClient();
await prisma.$connect();
try {
const owner = await prisma.employee.findFirst({
where: {
email: {
in: ["[email protected]", "[email protected]"],
},
},
select: { id: true, department_id: true },
orderBy: { created_at: "asc" },
});
if (!owner) {
throw new Error("employee/finance_mgr not found");
}
const reimbursement = await prisma.reimbursementForm.create({
data: {
form_number: `BX-P10-${scenario}-${runSuffix}`.slice(0, 60),
submitter_id: owner.id,
owner_id: owner.id,
department_id: owner.department_id,
reimbursement_date: new Date("2026-02-10T00:00:00.000Z"),
total_amount: "100.00",
status: "paid",
payment_voucher_no: `PV-${scenario}-${runSuffix}`.slice(0, 60),
payment_date: new Date("2026-02-10T00:00:00.000Z"),
paid_at: new Date(),
created_by: owner.id,
updated_by: owner.id,
},
select: {
id: true,
form_number: true,
owner_id: true,
submitter_id: true,
total_amount: true,
payment_voucher_no: true,
payment_date: true,
paid_at: true,
},
});
const payload = buildErpPayload({ reimbursement });
const enqueued = await enqueueIntegrationEvent(prisma, {
eventType: "erp.reimbursement.paid",
payload,
dedupeKey: reimbursement.id,
maxAttempts: config.integrationOutboxMaxAttempts,
actorId: owner.id,
});
process.stdout.write(
JSON.stringify({
scenario,
reimbursementId: reimbursement.id,
outboxId: enqueued.id,
duplicated: enqueued.duplicated,
}),
);
} finally {
await prisma.$disconnect();
await pool.end();
}
})().catch((error) => {
console.error(error);
process.exit(1);
});
NODE
}
query_outbox_state() {
local outbox_id="$1"
DATABASE_URL="$DATABASE_URL" OUTBOX_ID="$outbox_id" node <<'NODE'
require("dotenv/config");
const { createPrismaClient } = require("./src/prismaClient");
(async () => {
const outboxId = process.env.OUTBOX_ID;
const { prisma, pool } = createPrismaClient();
await prisma.$connect();
try {
const row = await prisma.integrationOutbox.findUnique({
where: { id: outboxId },
select: {
id: true,
status: true,
attempts: true,
next_retry_at: true,
dead_letter_at: true,
last_error: true,
},
});
if (!row) {
throw new Error(`outbox not found: ${outboxId}`);
}
process.stdout.write(
JSON.stringify({
id: row.id,
status: row.status,
attempts: row.attempts,
nextRetryAt: row.next_retry_at ? row.next_retry_at.toISOString() : null,
deadLetterAt: row.dead_letter_at ? row.dead_letter_at.toISOString() : null,
lastError: row.last_error,
}),
);
} finally {
await prisma.$disconnect();
await pool.end();
}
})().catch((error) => {
console.error(error);
process.exit(1);
});
NODE
}
run_outbox_once() {
local endpoint="$1"
ERP_SYNC_ENABLED=true \ ERP_SYNC_ENABLED=true \
ERP_SYNC_PROVIDER=http \ ERP_SYNC_PROVIDER=http \
ERP_SYNC_ENDPOINT="$endpoint" \ ERP_MASTER_DATA_ENDPOINT="http://127.0.0.1:$MOCK_ERP_PORT/erp/master-data/pull?mode=success" \
ERP_JOURNAL_EXPORT_ENDPOINT="http://127.0.0.1:$MOCK_ERP_PORT/erp/journals/reimbursements/paid?mode=success" \
ERP_SYNC_ENDPOINT="http://127.0.0.1:$MOCK_ERP_PORT/erp/reimbursements/paid?mode=success" \
ERP_SYNC_TIMEOUT_MS="$ERP_SYNC_TIMEOUT_MS" \ ERP_SYNC_TIMEOUT_MS="$ERP_SYNC_TIMEOUT_MS" \
ERP_MASTER_DATA_TIMEOUT_MS="$ERP_SYNC_TIMEOUT_MS" \
ERP_SYNC_AUTH_TOKEN="" \ ERP_SYNC_AUTH_TOKEN="" \
npm run --silent job:integration-outbox-once >"$TMP_DIR/outbox-once.log" node src/index.js >"$TMP_DIR/app.log" 2>&1 &
APP_SERVER_PID="$!"
for _ in $(seq 1 60); do
if curl -sS "$BASE_URL/health" >/dev/null 2>&1; then
return 0
fi
sleep 0.5
done
echo "[ERROR] app server failed to start" >&2
cat "$TMP_DIR/app.log" >&2 || true
exit 1
}
login_finance_mgr() {
local login_body="$TMP_DIR/login.json"
local login_status
login_status="$(curl -sS -o "$login_body" -w "%{http_code}" \
-X POST "$BASE_URL/api/auth/login" \
-H "content-type: application/json" \
-H "x-device-fingerprint: ${DEVICE_FINGERPRINT}-finance" \
-d "{\"identifier\":\"$FINANCE_MGR_IDENTIFIER\",\"password\":\"$FINANCE_MGR_PASSWORD\"}")"
assert_status "$login_status" "200" "finance_mgr login"
TOKEN="$(jq -er '.data.accessToken' "$login_body")"
} }
set_erp_flag() { set_erp_flag() {
local mode="$1" local mode="$1"
DATABASE_URL="$DATABASE_URL" MODE="$mode" node <<'NODE' DATABASE_URL="$DATABASE_URL" MODE="$mode" node <<'NODE'
require("dotenv/config"); require('dotenv/config');
const { createPrismaClient } = require('./src/prismaClient');
const { createPrismaClient } = require("./src/prismaClient");
(async () => { (async () => {
const mode = process.env.MODE; const mode = process.env.MODE;
const { prisma, pool } = createPrismaClient(); const { prisma, pool } = createPrismaClient();
await prisma.$connect(); await prisma.$connect();
try { try {
await prisma.featureFlag.upsert({ await prisma.featureFlag.upsert({
where: { flag_key: "erp_sync" }, where: { flag_key: 'erp_sync' },
create: { create: {
flag_key: "erp_sync", flag_key: 'erp_sync',
override_mode: mode, override_mode: mode,
rollout_type: "global", rollout_type: 'global',
department_ids: [], department_ids: [],
note: "regression-integrations", note: 'regression-integrations',
}, },
update: { update: {
override_mode: mode, override_mode: mode,
rollout_type: "global", rollout_type: 'global',
department_ids: [], department_ids: [],
note: "regression-integrations", note: 'regression-integrations',
version: { increment: 1 }, version: { increment: 1 },
}, },
}); });
@@ -333,10 +310,250 @@ const { createPrismaClient } = require("./src/prismaClient");
NODE NODE
} }
echo "[0/6] Ensure ERP feature flag force_on" create_paid_reimbursement() {
set_erp_flag "force_on" DATABASE_URL="$DATABASE_URL" RUN_SUFFIX="$RUN_SUFFIX" node <<'NODE'
require('dotenv/config');
assert_mode_semantics() { const { createPrismaClient } = require('./src/prismaClient');
(async () => {
const runSuffix = process.env.RUN_SUFFIX;
const { prisma, pool } = createPrismaClient();
await prisma.$connect();
try {
const owner = await prisma.employee.findFirst({
where: {
email: {
in: ['[email protected]', '[email protected]'],
},
},
select: {
id: true,
department_id: true,
legal_entity_id: true,
},
orderBy: { created_at: 'asc' },
});
if (!owner) {
throw new Error('seed employee not found');
}
const uniqueSuffix = `${runSuffix}-${Date.now()}-${Math.floor(Math.random() * 1000000)}`;
const reimbursement = await prisma.reimbursementForm.create({
data: {
form_number: `BX-ERP-${uniqueSuffix}`.slice(0, 60),
submitter_id: owner.id,
owner_id: owner.id,
department_id: owner.department_id,
reimbursement_date: new Date('2026-03-08T00:00:00.000Z'),
total_amount: '100.00',
status: 'paid',
payment_voucher_no: `PV-ERP-${uniqueSuffix}`.slice(0, 60),
payment_date: new Date('2026-03-08T00:00:00.000Z'),
paid_at: new Date(),
created_by: owner.id,
updated_by: owner.id,
},
select: { id: true },
});
process.stdout.write(reimbursement.id);
} finally {
await prisma.$disconnect();
await pool.end();
}
})().catch((error) => {
console.error(error);
process.exit(1);
});
NODE
}
query_outbox_state() {
local outbox_id="$1"
DATABASE_URL="$DATABASE_URL" OUTBOX_ID="$outbox_id" node <<'NODE'
require('dotenv/config');
const { createPrismaClient } = require('./src/prismaClient');
(async () => {
const outboxId = process.env.OUTBOX_ID;
const { prisma, pool } = createPrismaClient();
await prisma.$connect();
try {
const row = await prisma.integrationOutbox.findUnique({
where: { id: outboxId },
select: {
id: true,
event_type: true,
status: true,
attempts: true,
next_retry_at: true,
processed_at: true,
dead_letter_at: true,
last_error: true,
},
});
if (!row) {
throw new Error(`outbox not found: ${outboxId}`);
}
process.stdout.write(JSON.stringify({
id: row.id,
eventType: row.event_type,
status: row.status,
attempts: row.attempts,
nextRetryAt: row.next_retry_at ? row.next_retry_at.toISOString() : null,
processedAt: row.processed_at ? row.processed_at.toISOString() : null,
deadLetterAt: row.dead_letter_at ? row.dead_letter_at.toISOString() : null,
lastError: row.last_error,
}));
} finally {
await prisma.$disconnect();
await pool.end();
}
})().catch((error) => {
console.error(error);
process.exit(1);
});
NODE
}
query_binding_state() {
local reimbursement_id="$1"
DATABASE_URL="$DATABASE_URL" REIMBURSEMENT_ID="$reimbursement_id" node <<'NODE'
require('dotenv/config');
const { createPrismaClient } = require('./src/prismaClient');
(async () => {
const reimbursementId = process.env.REIMBURSEMENT_ID;
const { prisma, pool } = createPrismaClient();
await prisma.$connect();
try {
const row = await prisma.integrationBinding.findUnique({
where: {
provider_entity_type_local_id: {
provider: 'erp',
entity_type: 'reimbursement_journal',
local_id: reimbursementId,
},
},
select: {
external_id: true,
external_code: true,
last_synced_at: true,
},
});
process.stdout.write(JSON.stringify({
externalId: row?.external_id ?? null,
externalCode: row?.external_code ?? null,
lastSyncedAt: row?.last_synced_at ? row.last_synced_at.toISOString() : null,
}));
} finally {
await prisma.$disconnect();
await pool.end();
}
})().catch((error) => {
console.error(error);
process.exit(1);
});
NODE
}
assert_master_data_seeded() {
DATABASE_URL="$DATABASE_URL" LEGAL_ENTITY_CODE="$LEGAL_ENTITY_CODE" COST_CENTER_CODE="$COST_CENTER_CODE" SUPPLIER_CODE="$SUPPLIER_CODE" node <<'NODE'
require('dotenv/config');
const { createPrismaClient } = require('./src/prismaClient');
(async () => {
const { prisma, pool } = createPrismaClient();
await prisma.$connect();
try {
const legalEntity = await prisma.legalEntity.findUnique({
where: { code: process.env.LEGAL_ENTITY_CODE },
select: { id: true },
});
const supplier = await prisma.supplier.findUnique({
where: { code: process.env.SUPPLIER_CODE },
select: { id: true },
});
const costCenter = await prisma.costCenter.findFirst({
where: { code: process.env.COST_CENTER_CODE },
select: { id: true },
});
if (!legalEntity || !costCenter || !supplier) {
throw new Error('master data not synced as expected');
}
} finally {
await prisma.$disconnect();
await pool.end();
}
})().catch((error) => {
console.error(error);
process.exit(1);
});
NODE
}
run_outbox_once() {
local mode="$1"
DATABASE_URL="$DATABASE_URL" \
INTEGRATION_OUTBOX_BATCH_SIZE=500 \
ERP_SYNC_ENABLED=true \
ERP_SYNC_PROVIDER=http \
ERP_JOURNAL_EXPORT_ENDPOINT="http://127.0.0.1:$MOCK_ERP_PORT/erp/journals/reimbursements/paid?mode=$mode" \
ERP_SYNC_ENDPOINT="http://127.0.0.1:$MOCK_ERP_PORT/erp/reimbursements/paid?mode=$mode" \
ERP_SYNC_TIMEOUT_MS="$ERP_SYNC_TIMEOUT_MS" \
ERP_SYNC_AUTH_TOKEN="" \
npm run --silent job:integration-outbox-once >"$TMP_DIR/outbox-once.log"
}
assert_pull_mode() {
local mode="$1"
ERP_SYNC_ENABLED=true \
ERP_SYNC_PROVIDER=http \
ERP_MASTER_DATA_ENDPOINT="http://127.0.0.1:$MOCK_ERP_PORT/erp/master-data/pull?mode=$mode" \
ERP_MASTER_DATA_TIMEOUT_MS="$ERP_SYNC_TIMEOUT_MS" \
ERP_SYNC_AUTH_TOKEN="" \
node <<'NODE'
const { pullMasterDataFromErp } = require('./src/services/integrations/erp');
(async () => {
const result = await pullMasterDataFromErp({
erpSyncEnabled: true,
erpSyncProvider: 'http',
erpMasterDataEndpoint: process.env.ERP_MASTER_DATA_ENDPOINT,
erpMasterDataTimeoutMs: Number(process.env.ERP_MASTER_DATA_TIMEOUT_MS ?? 300),
erpSyncAuthToken: process.env.ERP_SYNC_AUTH_TOKEN ?? '',
}, { resources: ['legal_entity'] });
process.stdout.write(JSON.stringify(result));
})().catch((error) => {
console.error(error);
process.exit(1);
});
NODE
}
api_get() {
local path="$1"
local out_file="$2"
curl -sS -o "$out_file" -w "%{http_code}" \
-H "authorization: Bearer $TOKEN" \
"$BASE_URL$path"
}
api_post() {
local path="$1"
local body="$2"
local out_file="$3"
curl -sS -o "$out_file" -w "%{http_code}" \
-X POST "$BASE_URL$path" \
-H "authorization: Bearer $TOKEN" \
-H "content-type: application/json" \
-d "$body"
}
assert_export_mode_semantics() {
local mode="$1" local mode="$1"
local state_json="$2" local state_json="$2"
@@ -363,20 +580,22 @@ assert_mode_semantics() {
esac esac
} }
run_mode_case() { run_export_mode_case() {
local mode="$1" local mode="$1"
local reimbursement_id
reimbursement_id="$(create_paid_reimbursement)"
local created_json local export_body="$TMP_DIR/export-$mode.json"
created_json="$(create_paid_reimbursement_and_enqueue "$mode")" local export_status
export_status="$(api_post "/api/integrations/erp/journals/reimbursements/${reimbursement_id}/export?runNow=0" '{}' "$export_body")"
assert_status "$export_status" "200" "journal export enqueue $mode"
local outbox_id local outbox_id
outbox_id="$(jq -er '.outboxId' <<<"$created_json")" outbox_id="$(jq -er '.data.outboxId' "$export_body")"
local endpoint="http://127.0.0.1:$MOCK_ERP_PORT/erp/reimbursements/paid?mode=$mode"
local state_json="" local state_json=""
local status="" local status=""
for _ in $(seq 1 8); do for _ in $(seq 1 8); do
run_outbox_once "$endpoint" run_outbox_once "$mode"
state_json="$(query_outbox_state "$outbox_id")" state_json="$(query_outbox_state "$outbox_id")"
status="$(jq -r '.status' <<<"$state_json")" status="$(jq -r '.status' <<<"$state_json")"
if [[ "$status" != "pending" && "$status" != "processing" ]]; then if [[ "$status" != "pending" && "$status" != "processing" ]]; then
@@ -386,37 +605,122 @@ run_mode_case() {
done done
if [[ "$status" == "pending" || "$status" == "processing" ]]; then if [[ "$status" == "pending" || "$status" == "processing" ]]; then
echo "[ERROR] mode=$mode did not finish processing" >&2 echo "[ERROR] export mode=$mode did not finish processing" >&2
echo "$state_json" >&2 echo "$state_json" >&2
exit 1 exit 1
fi fi
if ! assert_mode_semantics "$mode" "$state_json"; then assert_export_mode_semantics "$mode" "$state_json"
echo "[ERROR] mode=$mode semantics assertion failed" >&2
echo "$state_json" >&2 if [[ "$mode" == "success" ]]; then
exit 1 local binding_json
binding_json="$(query_binding_state "$reimbursement_id")"
jq -e '.externalId != null and .externalCode != null' <<<"$binding_json" >/dev/null
fi fi
echo "[OK] mode=$mode outbox_status=$status" echo "[OK] export mode=$mode outbox_status=$status" >&2
printf '%s' "$reimbursement_id"
} }
echo "[1/6] Start embedded mock ERP server" echo "[0/9] Ensure ERP feature flag force_on"
set_erp_flag "force_on"
echo "[1/9] Start embedded mock ERP server"
start_mock_erp_server start_mock_erp_server
echo "[2/6] ERP success path => succeeded" echo "[2/9] Start isolated app server"
run_mode_case "success" start_app_server
echo "[3/6] ERP 4xx path => dead_letter" sleep 1
run_mode_case "client"
echo "[4/6] ERP 5xx path => failed(retryable)" echo "[3/9] Login finance manager"
run_mode_case "server" login_finance_mgr
echo "[5/6] ERP timeout path => failed(retryable)" echo "[4/9] ERP status + master data sync success"
run_mode_case "timeout" status_body="$TMP_DIR/status.json"
status_code="$(api_get '/api/integrations/erp/master-data/status' "$status_body")"
assert_status "$status_code" "200" "erp status"
jq -e '.data.gate.provider == "http" and (.data.items | length) == 3' "$status_body" >/dev/null
sync_body="$TMP_DIR/master-sync.json"
sync_code="$(api_post '/api/integrations/erp/master-data/sync' '{"resources":["legal_entity","cost_center","supplier"]}' "$sync_body")"
assert_status "$sync_code" "200" "erp master data sync"
jq -e '.data.items | all(.status == "succeeded")' "$sync_body" >/dev/null
assert_master_data_seeded
echo "[5/9] ERP master data provider error modes"
for mode in client server timeout; do
mode_json="$(assert_pull_mode "$mode")"
case "$mode" in
client) jq -e '.ok == false and .code == "erp_master_data_http_4xx"' <<<"$mode_json" >/dev/null ;;
server) jq -e '.ok == false and .code == "erp_master_data_http_5xx"' <<<"$mode_json" >/dev/null ;;
timeout) jq -e '.ok == false and .code == "erp_master_data_timeout"' <<<"$mode_json" >/dev/null ;;
esac
echo "[OK] master-data mode=$mode validated"
done
echo "[6/9] Preview paid reimbursement journal"
preview_reimbursement_id="$(create_paid_reimbursement)"
preview_body="$TMP_DIR/preview.json"
preview_code="$(api_get "/api/integrations/erp/journals/reimbursements/${preview_reimbursement_id}/preview" "$preview_body")"
assert_status "$preview_code" "200" "journal preview"
jq -e '.data.journal.journalType == "reimbursement_paid" and .data.journal.entityId != null' "$preview_body" >/dev/null
echo "[7/9] Export journal success / 4xx / 5xx / timeout"
run_export_mode_case success >/dev/null
client_reimbursement_id="$(run_export_mode_case client)"
run_export_mode_case server >/dev/null
run_export_mode_case timeout >/dev/null
echo "[8/9] Dead-letter requeue + legacy alias"
requeue_body="$TMP_DIR/requeue.json"
requeue_code="$(api_post "/api/integrations/erp/journals/reimbursements/${client_reimbursement_id}/export?runNow=0" '{}' "$requeue_body")"
assert_status "$requeue_code" "200" "journal export requeue"
jq -e '.data.requeued == true and .data.duplicated == false' "$requeue_body" >/dev/null
requeue_outbox_id="$(jq -er '.data.outboxId' "$requeue_body")"
requeue_state="$(query_outbox_state "$requeue_outbox_id")"
jq -e '.status == "pending" and .attempts == 0 and .lastError == null' <<<"$requeue_state" >/dev/null
run_outbox_once success
requeue_state_done="$(query_outbox_state "$requeue_outbox_id")"
jq -e '.status == "succeeded"' <<<"$requeue_state_done" >/dev/null
legacy_reimbursement_id="$(create_paid_reimbursement)"
legacy_body="$TMP_DIR/legacy-export.json"
legacy_code="$(api_post "/api/integrations/erp/sync/${legacy_reimbursement_id}?runNow=0" '{}' "$legacy_body")"
assert_status "$legacy_code" "200" "legacy erp sync alias"
legacy_outbox_id="$(jq -er '.data.outboxId' "$legacy_body")"
legacy_state="$(query_outbox_state "$legacy_outbox_id")"
jq -e '.eventType == "erp.journal.export" and .status == "pending"' <<<"$legacy_state" >/dev/null
echo "[9/9] ERP env gate off blocks sync"
if kill -0 "$APP_SERVER_PID" >/dev/null 2>&1; then
kill "$APP_SERVER_PID" >/dev/null 2>&1 || true
wait "$APP_SERVER_PID" >/dev/null 2>&1 || true
fi
APP_SERVER_PID=""
PORT="$APP_PORT" \
HOST="127.0.0.1" \
JOBS_ENABLED=false \
OCR_PROVIDER=mock \
ERP_SYNC_ENABLED=false \
ERP_SYNC_PROVIDER=http \
ERP_MASTER_DATA_ENDPOINT="http://127.0.0.1:$MOCK_ERP_PORT/erp/master-data/pull?mode=success" \
ERP_JOURNAL_EXPORT_ENDPOINT="http://127.0.0.1:$MOCK_ERP_PORT/erp/journals/reimbursements/paid?mode=success" \
ERP_SYNC_TIMEOUT_MS="$ERP_SYNC_TIMEOUT_MS" \
ERP_MASTER_DATA_TIMEOUT_MS="$ERP_SYNC_TIMEOUT_MS" \
ERP_SYNC_AUTH_TOKEN="" \
node src/index.js >"$TMP_DIR/app-gate-off.log" 2>&1 &
APP_SERVER_PID="$!"
for _ in $(seq 1 60); do
if curl -sS "$BASE_URL/health" >/dev/null 2>&1; then
break
fi
sleep 0.5
done
login_finance_mgr
blocked_body="$TMP_DIR/blocked.json"
blocked_code="$(api_post '/api/integrations/erp/master-data/sync' '{"resources":["legal_entity"]}' "$blocked_body")"
assert_status "$blocked_code" "409" "erp gate off blocked"
jq -e '.error.code == "VALID_001" and (.error.details.integration == "erp_sync_disabled" or .error.details.reason == "env_hard_off")' "$blocked_body" >/dev/null
echo "[6/6] Done"
echo "[OK] Integrations regression passed" echo "[OK] Integrations regression passed"
echo "[post] Reset ERP feature flag force_off"
set_erp_flag "force_off"