链路断点与联调检查

当前已确认的代码事实

位置	事实	影响
EntrustApiImpl.saveEntrust	根据 isEnterMatching 调用桥接	上游存在调用意图
entrust.remote.MatchingEngineService.enterMatching	最终撮合 RPC 块被注释	旧路径不能据此认定实际下单
同类 cancelOrder	撤单构造与 RPC 被注释	旧路径不能据此认定完成撤单
matching-admin 的 OrderController	历史普通下单与撤单映射被注释	管理端不是已经确认的替代提交入口
matching-provider 的 MatchEngineExecuteService	addOrder / cancelOrder 仍有实际实现	需要确认正在使用的调用方与 DTO 协议
行情部分历史 Consumer	个别监听注解被注释	不将所有类作为生效消费者

这些事实来自当前工作空间检出的代码，不代表生产一定采用相同版本，也不证明整个交易系统没有其他可用入口。本次只修正文档，没有修改业务源码或恢复注释代码。

源码证据位置

• coinex-entrust/entrust-provider/src/main/java/com/exch/entrust/dubbo/EntrustApiImpl.java
• coinex-entrust/entrust-provider/src/main/java/com/exch/entrust/remote/MatchingEngineService.java
• coinex-match/matching-admin/src/main/java/com/exch/matching/admin/controller/OrderController.java
• coinex-match/matching-provider/src/main/java/com/exch/matching/provider/MatchEngineExecuteService.java
• coinex-market/market-provider/src/main/java/com/exch/market/provider/mq/CreateOrderConsumer.java

联调核对顺序

1. 确认实际部署 checkout、客户端请求地址及对应 Controller。
2. 用一个受控请求跟踪入口、委托标识、交易配置和账户冻结。
3. 确认有效调用抵达撮合 addOrder，而不只是记录 enterMatching 日志。
4. 对照前置事件、订单簿、成交及剩余数量。
5. 确认消息从缓存真正送达消费者，再验证行情展示。
6. 对账订单、余额冻结、手续费与成交记录。
7. 覆盖部分成交撤单、重复请求、重启与三方执行失败。

接口受理、订单落库、消息入缓存和最终成交分别取证，不以单一成功响应证明整条链路运行。

成交消费与资金模型补充

旧 EntrustMatchListener 的监听声明存在，但业务处理块被注释；EntrustDealListener 的组件、监听与业务处理也被注释。不能把它们作为当前成交回写已贯通的证据。

旧创建服务与撮合 SaveOrderHandler 都有账户冻结实现，不能串成同一订单的两次必经冻结。同步 Future 成功又可能在前置阶段完成，需与订单簿、落地及行情结果分别取证。详细见现货主流程第 1、9、13、14 节。