docs/test(P19ERP3-5,P19ERP3-6): 收口资产ERP文档矩阵与回归脚本
这个提交包含在:
@@ -1,7 +1,7 @@
|
||||
# 集成边界冻结(P19 / P19+IM-1 / P19+ERP-2)
|
||||
# 集成边界冻结(P19 / P19+IM-1 / P19+ERP-3)
|
||||
|
||||
**快照日期**:2026-03-08
|
||||
**当前基线**:`P19+IM-1`、`P19+ERP-1` 与 `P19+ERP-2` 已完成;当前运行时已落地企微群机器人 + 深链 + Outbox 异步派发的一期协同适配,以及 ERP 主数据 Pull、报销付款凭证切片、采购双阶段 journal 与归档摘要出站。
|
||||
**快照日期**:2026-03-09
|
||||
**当前基线**:`P19+IM-1`、`P19+ERP-1`、`P19+ERP-2` 与 `P19+ERP-3` 已完成;当前运行时已落地企微群机器人 + 深链 + Outbox 异步派发的一期协同适配,以及 ERP 主数据 Pull、报销付款凭证切片、采购双阶段 journal / 归档摘要出站、资产台账摘要出站。
|
||||
**目标**:在保持核心域稳定的前提下,冻结 ERP / IM / AI / MCP 的长期边界,并记录 IM 一期与 ERP 两期的已实现范围、禁入规则和后续扩展位。
|
||||
|
||||
## 1. 总体原则
|
||||
@@ -28,7 +28,7 @@
|
||||
### 2.1 允许进入适配层的对象
|
||||
- 主数据:`LegalEntity`、`CostCenter`、`Supplier`
|
||||
- 采购:`purchase_request` 审批结果、预算占用确认结果、PO / 合同归档摘要
|
||||
- 资产:`asset_card` 基础卡片信息、归属变更摘要、盘点完成摘要
|
||||
- 资产:`asset_card` 基础卡片信息、财务维度变更摘要、盘点完成摘要
|
||||
|
||||
### 2.2 推荐适配方式
|
||||
- **主数据同步**:
|
||||
@@ -49,7 +49,7 @@
|
||||
### 2.4 建议后续专项
|
||||
- `P19+ERP-1`:主数据同步协议
|
||||
- `P19+ERP-2`:采购双阶段 journal 与归档摘要出站
|
||||
- `P19+ERP-3`:资产台账摘要导出协议
|
||||
- `P19+ERP-3`:资产台账摘要导出协议(已完成一期)
|
||||
|
||||
### 2.5 P19+ERP-1 已实现范围
|
||||
- 已新增 `IntegrationBinding` 与 `IntegrationSyncState` 两张集成层私有表,用于维护 ERP 映射与同步状态,不向核心事务表注入 ERP 私有字段。
|
||||
@@ -66,6 +66,14 @@
|
||||
- 已明确 `IntegrationSyncState` 继续只表示资源级主数据同步状态,不承载采购单据级轨道;采购详情轨道只允许由 `IntegrationOutbox + IntegrationBinding + 当前单据事实` 推导。
|
||||
- 已将采购 ERP 轨道挂件固定在采购详情 / 归档区:所有可读用户仅查看阶段状态,`integration.manage` 才能查看 ERP 外部编号并执行手动补发 / 重试。
|
||||
|
||||
### 2.7 P19+ERP-3 已实现范围
|
||||
- 已新增 `erp.asset.export` 单一资产 ERP 事件,固定用于 `asset_card` 的 ledger summary export,不进入 `erp.journal.export`,也不向核心资产表注入 ERP 私有字段。
|
||||
- 已冻结资产一期触发边界:仅 `POST /api/assets` 建卡成功,以及 `PATCH /api/assets/:id` 导致 `legalEntityId / costCenterId / status(retired|archived)` 发生变化时自动出站。
|
||||
- 已明确 `POST /api/assets/:id/assign`、`POST /api/assets/:id/return`、`POST /api/assets/:id/transfer` 与仅 `name / location / serialNo / activatedAt` 变化不触发 ERP,同步边界仅覆盖财务台账摘要。
|
||||
- 已为单资产固定 `asset_card:{assetId}:ledger_summary` dedupe key,并采用“同一条 outbox 覆盖同步”语义:payload 无变化时返回历史记录,payload 有变化或失败 / 死信时仅重置同一条记录。
|
||||
- 已在 `integration_bindings` 中固定资产映射 `asset_erp_card`;成功派发后回写 ERP 资产外部编号与最近同步时间。
|
||||
- 已将资产 ERP 轨道挂件固定在资产详情侧边栏:所有可读用户查看同步状态,`integration.manage` 才能查看 ERP 外部编号并执行补发 / 重试;`IntegrationSyncState` 继续不承载资产单据级轨道。
|
||||
|
||||
## 3. IM / 协同适配边界
|
||||
|
||||
### 3.1 一期已实现能力(P19+IM-1)
|
||||
|
||||
在新工单中引用
屏蔽一个用户