对手方 CRUD

概述

Liquia 本地维护 Counterparty，并在开启 DTMS sync 时与 DTMS /counterparties 双向链接：创建前先 search，避免重复；更新/删除以本地为准，DTMS 失败仅告警（不回滚本地）。

触发入口

动作	HTTP
列表	GET /api/counterparties
创建	POST /api/counterparties
更新	PATCH /api/counterparties/:id
删除	DELETE /api/counterparties/:id

参与方

• Client、api-gateway、Counterparties use-case
• CounterpartyService
• DtmsAuthService、DtmsClient
• Redis、DTMS、本地 DB

业务流程图

加载图表…

业务流程图

时序图（Create）

加载图表…

时序图（Create）

时序图（Update / Delete）

加载图表…

时序图（Update / Delete）

DTMS API 对照

步骤	Liquia	HTTP	Path	Bearer
搜索	searchCounterparties	POST	/counterparties/search	是
创建	createCounterparty	POST	/counterparties	是
更新	updateCounterparty	PATCH	/counterparties/{id}	是
删除	deleteCounterparty	DELETE	/counterparties/{id}	是

本地数据影响

• Counterparty.dtmsCounterpartyId 及 status / entityId 等本地字段

异常与补偿

• skip sync：只写本地
• 创建失败：DTMS_COUNTERPARTY_CREATE_FAILED + soft-delete
• 名称冲突：本地 400
• Document apply 内嵌同类 search/create（见 06）

源码索引

• apps/api/src/orchestration/counterparties/counterparty.service.ts
• Counterparties controller / use-case