外部系统对接清单

本文把“DGJ2 仓库之外的系统”统一登记为系统边界。每个边界说明：谁调用谁、走 HTTP 还是 MQ、关键业务键、状态落点、失败后谁补偿，以及哪些结论仍需环境确认。

文档只保留配置常量和接口路径，不记录域名值、密钥、Token、手机号、客户数据或内部 IP。

1. 业务目标

DGJ2 不是独立单体。采购、支付、配送、商品、SAAS、渠道、报表、IM、短信和文件都依赖外部系统。建立清单的目的有四个：

1. 联调时知道应该找哪个系统和哪个入口。
2. 故障时分清“本地未发送、消息在途、下游失败、回调未消费”。
3. 改代码时知道契约、状态和补偿影响面。
4. 交接时能用业务键从 DGJ 一直追到下游。

2. 适用场景

3. 什么叫“外部系统”

本文同时登记三类边界：

“外部”是相对 DGJ2 代码与数据库而言，不代表一定在公网。

4. 总体系统图

flowchart TB
    DGJ[DGJ2]
    OC[订单中心]
    PAY[支付中心]
    DIS[调拨中心]
    TMS[TMS]
    ITEM[商品中心]
    INV[库存中心]
    OPS[OPS / OPS Manager]
    OA[OA]
    SAAS[SAAS / E站]
    QCJ[全车件 / QPay]
    IM[IM中心 / 腾讯IM]
    DATA[数据平台 / 报表中心]
    CRM[CRM / 风控]
    OUT[短信 / Udesk / 高德 / OSS]

    DGJ <--> OC
    DGJ <--> PAY
    DGJ <--> DIS
    DGJ <--> TMS
    DGJ <--> ITEM
    DGJ --> INV
    DGJ <--> OPS
    DGJ <--> OA
    DGJ <--> SAAS
    DGJ <--> QCJ
    DGJ <--> IM
    DGJ <--> DATA
    DGJ <--> CRM
    DGJ <--> OUT

5. 系统资产总表

6. 集成方式分类

flowchart LR
    A[业务动作] --> B{需要同步结果吗}
    B -->|必须马上知道| C[同步 HTTP]
    B -->|可最终一致| D[MQ]
    B -->|多项可并行查询| E[异步 HTTP Promise]
    C --> F{HTTP 成功}
    F -->|是| G[继续本地流程]
    F -->|否| H[回滚或明确失败]
    D --> I[本地提交后生产消息]
    I --> J[下游消费与回调]
    E --> K[asyncWait 汇总结果]

选择协议不能只看性能：

• 状态必须立即确认的提交用同步 HTTP。
• 可以最终一致的通知用 MQ。
• 并行查询适合异步 HTTP，但失败不能静默当成空数据。
• 跨系统事务必须有幂等键和补偿，不存在真正的单库事务。

7. 公共 HTTP Provider 规则

7.1 BaseProvider

application/Providers/BaseProvider.php 基于 Guzzle，支持：

7.2 响应契约并不统一

新增 Provider 时必须复用对应系统的父类，不能假定所有服务都用同一个成功码。

7.3 公共日志风险

BaseProvider 默认记录 URL、headers、data 和响应。以下字段必须在调用前后脱敏：

Authorization、Token、签名、密码、UserSig、手机号、身份证、银行卡、客户联系方式、文件临时地址

只调用 closeLogger() 会失去排查证据，优先实现结构化脱敏。

7.4 requestId 的边界

当前 Provider 内部 requestId 由请求体与当前时间计算，仅用于本地日志，没有确认会放到请求头传给下游。

因此跨系统追踪不能只依赖该值，建议统一透传：

trace_id + request_id + business_key + event_type

8. 公共 MQ 规则

核心枚举：application/KzData/Enums/MqEventEnums.php。

sequenceDiagram
    participant B as DGJ业务事务
    participant P as MqSer/Producer
    participant Q as RabbitMQ
    participant C as 外部系统或DGJ Consumer
    participant DB as 消费方数据库
    B->>B: 写本地业务状态
    B->>P: 组装 destination/routingKey/payload
    P->>Q: publish(messageId)
    Q->>C: deliver
    C->>DB: 幂等检查并落库
    alt 成功或不可重试业务错误
        C-->>Q: ACK
    else 临时系统错误
        C-->>Q: NACK / 重试
    end

8.1 MQ 必备字段

建议所有事件至少具备：

当前部分生产代码使用 uniqid() 作为消息 ID，不能证明跨进程、跨机器的严格唯一和业务幂等。消费方仍应按业务键防重。

9. 订单中心

9.1 责任边界

9.2 DGJ 主动调用 / 发送

9.3 DGJ 消费事件

队列前缀：ordercenter_notify；入口：tasks/OrderCenterNotify.php。

9.4 核心幂等键

DGJ billNo / 外部 outOrderNo / orderCenterOrderNo / 售后单号 / sourceLineCode / 明细行 ID

9.5 主流程

sequenceDiagram
    participant D as DGJ
    participant O as 订单中心
    participant M as ordercenter_notify
    D->>O: 创建采购/售后（HTTP或MQ）
    O-->>D: 受理结果/外部单号
    O->>M: 审核、取消、关闭或退款事件
    M->>D: OrderCenterNotify 消费
    D->>D: 校验单号、类型、原状态和明细
    D->>D: 事务更新采购/售后/数量

9.6 失败边界

• HTTP 超时不代表订单中心一定未受理，必须按外部单号查询。
• MQ 重复可能表现为“原状态不允许”，要区分已处理与真实脏状态。
• 明细行关闭必须以来源行号防重，不能只看主单。
• 本地事务成功后下游副作用失败，需要单独补偿。

10. 支付中心

10.1 责任边界

10.2 消费入口

队列：paycenter_notify；入口：tasks/PayCenterNotify.php。

10.3 支付结果示意

{
  "billNo": "业务单号",
  "payStatus": "02",
  "payOrderNo": "支付流水号",
  "payAmount": 10000,
  "payTime": "业务时间",
  "payItems": []
}

示意中的金额单位必须按接口合同确认。DGJ 支付链存在外部“分”和本地“元”的转换，不能仅按字段名判断。

10.4 幂等与补偿

flowchart TD
    A[收到支付结果] --> B{payStatus 是成功吗}
    B -->|否| C[记录或按事件类型处理]
    B -->|是| D[按业务单号查订单]
    D --> E{本地已落同一支付流水吗}
    E -->|是| F[ACK 幂等结束]
    E -->|否| G[事务写 Payment/PaymentInfo/PayInfo]
    G --> H[推进采购状态和活动库存]
    H --> I[发送后续事件]

支付回调最小幂等组合：支付中心流水号 + 业务单号 + 支付状态 + 金额。只用业务单状态会误伤混合支付或多次退款。

11. 调拨中心

11.1 HTTP 能力

application/Providers/DispatchCenter/OrderProvider.php：

11.2 MQ 消费

队列：dispatchcenter_notify；入口：tasks/DispatchCenterNotify.php。

部分配送出库失败会进入 20 秒延迟队列后再次投递。

11.3 关键业务键

采购主单号 + 子单号/发货单号 + 配送单号 + 明细行号 + 本次出库数量

不能只按采购主单幂等，因为一个采购单可以多次分批出库。

12. TMS

TMS 和调拨中心不是同一个边界。TMS 更关注运单与履约状态。

入口：tasks/ExpressNoSyncNotify.php，队列前缀 tmsprod_notify。

flowchart LR
    A[DGJ销售/采购单] --> B[调拨中心配送单]
    B --> C[TMS运单]
    C --> D[运单号/箱号]
    C --> E[预计到达]
    C --> F[配送/取件状态]
    D --> G[DGJ履约展示]
    E --> G
    F --> G

排查“已出库无物流”时，先确认调拨中心是否已出库，再确认 TMS 是否已建运单；不要混成一个状态。

13. 商品中心

消费入口：tasks/ItemCenterNotify.php，队列 itemcenter_notify。

HTTP Provider：application/Providers/ItemCenter/*，用于商品和物料查询。

13.1 消费后副作用

flowchart TD
    A[商品中心消息] --> B[校验事件和商品标识]
    B --> C[更新本地商品/价格配置]
    C --> D[刷新 Redis 集合或缓存时间]
    C --> E[触发 Mongo/ES 或前端数据更新]
    C --> F[影响采购、销售、活动可买性]

商品中心消息处理成功不能只看业务表，必须核对缓存和搜索层。

14. 库存中心

Provider：application/Providers/InventoryCenter/KzInventoryProvider.php。

主要能力：

调用常为异步 HTTP，依赖回调和最终 asyncWait()。

关键参数：

sid + skuIds + orderType + warehouseCode + extraQuery

库存中心返回的是可买库存口径，不等于 DGJ 本地实时库存表。秒杀、套包、指定仓和在途库存还会二次计算。

15. OPS Center

15.1 消费入口

tasks/OpsCenterNotify.php，队列 opscenter_notify。

15.2 HTTP Provider

application/Providers/OpsCenter/* 覆盖：

• 服务站与区域。
• 供应商、银行、发票资料。
• 品牌授权。
• 第三方物流与 TMS。

OPS 是主数据所有者时，DGJ 只保存业务所需快照或缓存，不能反向直接覆盖主数据。

16. OPS Manager

application/Providers/OpsManager/* 是最大的外部 Provider 家族，覆盖：

金融 Provider 只登记接口路径和配置 key，不把签名算法参数、密钥或银行资料写入文档。

17. OA

17.1 双向链路

秒杀活动使用特定模板码分流到 FlashActivitySer::callback20260526。

sequenceDiagram
    participant D as DGJ业务
    participant O as OA
    participant Q as oa_notify
    D->>O: 提交审批，携带模板码和业务ID
    O-->>D: 审批实例信息
    O->>Q: oa_audit
    Q->>D: 模板码分流
    D->>D: 幂等更新审核状态
    D-->>O: 结果同步/处理回执

OA 幂等键至少包括模板码 + 审批实例号 + 业务 ID + 审批节点/结果。

18. SAAS / E站

18.1 DGJ 调用 SAAS

application/Providers/KzSaas/* 覆盖：

• 销售订单与出库。
• 客户、用户与门店。
• 盘点。
• 微仓库存。
• 优惠券、信用、资质。
• 微信和银联相关能力。

18.2 DGJ 发送 MQ

MqSer 和 SyncOrderBuilder/SyncOrderSer 发送：

18.3 DGJ 内部 Direct 消费

tasks/SaasOrderNotify.php 消费 dgj：库存事件、采购关闭确认、新站、应用开通、OPS 创建/关闭订单、配送出库等。它名字包含 SAAS，但不代表所有事件都来自 SAAS。

18.4 销售同步流程

sequenceDiagram
    participant S as DGJ销售事务
    participant B as SyncOrderBuilder
    participant M as dgj_notify
    participant A as SAAS
    S->>S: 提交销售单/出库单
    S->>B: 构建版本化事件
    B->>M: 发送业务单号、状态和明细
    M->>A: 下游消费
    A->>A: 按订单号+事件版本幂等

同一销售单可能连续产生 created、updated、completed。下游必须防乱序，不能只按最后到达时间覆盖。

19. 大客户渠道

队列：dgj_channel；入口：tasks/ChannelOrderNotify.php。

核心表：t_channel_order、t_channel_order_info、t_channel_aftersale、t_channel_aftersale_info。

业务状态：created、wait_ship、part_ship、finish、cancel。

幂等必须落到平台订单号 + 平台明细行号 + 动作类型，分批发货不能按主单只处理一次。

20. 全车件、QCJ 与 QPay

20.1 HTTP 边界

20.2 MQ 边界

入口：tasks/QPayCenterNotify.php 及全车件相关 Controller。

全车件业务同时跨销售、采购、结算三条链，排查时必须保留平台订单号、DGJ 单号和结算流水三组映射。

21. GPDA / WMS

21.1 GPDA 事件

tasks/GpdaNotify.php 按 taskNo 批量把未关闭盘点单更新为关闭状态，使用数据库事务，异常返回 NACK。

21.2 盘点幂等键

taskNo + skuId + 扫码批次/提交版本 + 状态

盘点关闭与盘点差异入账不是同一个动作，关闭回调不能重复生成库存流水。

22. IM 中心与腾讯 IM

22.1 HTTP 能力

application/Providers/ImCenter/ImCenterProvider.php：

默认 HTTP 超时 5 秒，成功响应通常 code = 0。

22.2 MQ 消费

队列：imcenter_notify；事件：im_app_biz_message；入口：tasks/ImCenterNotify.php。

sequenceDiagram
    participant T as 腾讯IM
    participant I as IM中心
    participant Q as imcenter_notify
    participant D as DGJ机器人
    participant R as 会话/报价服务
    T->>I: 用户业务消息
    I->>Q: im_app_biz_message
    Q->>D: msgId + account + content
    D->>R: 保存会话并执行业务回复
    alt 处理成功
        D->>I: msgSyncResult(msgId)
        D-->>Q: ACK
    else 可重试系统异常
        D-->>Q: NACK
    else 参数/业务错误
        D-->>Q: ACK并记录
    end

22.3 风险

• UserSig 属于敏感凭据，日志不得输出。
• 当消息没有 msgId 时本地可能生成临时值，无法与上游严格对账。
• 同步结果通知失败只记录 warning 时，IM 中心可能再次投递；本地会话入库必须幂等。

23. 微信机器人

Provider：application/Providers/WechatRobot/*；业务：application/Services/MoveMall/Robot*。

能力包括：

• 接收群聊/私聊消息。
• 识别联系人、车辆、VIN、关键词。
• 查询商品、价格和库存。
• 发送文本、图片和商品列表。
• 将微信群订单同步到 SAAS。

flowchart TD
    A[微信消息] --> B[机器人接入]
    B --> C[会话与联系人识别]
    C --> D{VIN/车型/关键词是否完整}
    D -->|否| E[追问或预输入缓存]
    D -->|是| F[商品/价格/库存查询]
    F --> G[格式化回复]
    G --> H[微信机器人发送]
    G --> I[可选同步 SAAS 询价/订单]

机器人失败要分接入、消息队列、会话、识别、查询和发送六层，不要只看“没有回复”。

24. Udesk

24.1 接口方式

application/Providers/Udesk/* 使用第三方 HTTP API：

• 客户创建。
• 客户更新。
• 请求携带账号标识、时间戳和签名。
• 成功业务码为 1000。

签名使用本地配置中的凭据计算，文档与日志只允许记录“签名已生成”，不记录原值。

24.2 异步方式

入口：tasks/SaasOrderNotify.php、tasks/UdeskNotify.php。

Udesk 失败不应回滚客户主数据，但必须进入可查询的同步失败记录或重试任务。

25. VIN 与国内数据平台

队列：vin；入口：tasks/VinAuditNotify.php。

HTTP Provider：application/Providers/Vin/*、application/Providers/DevCenter/VinProvider.php。

分类别名、方位词、OE 变化会影响智能询价和搜索，不是只更新一个展示字段。

26. 报表中心、Report Service 与 DataService

这三类系统不共用同一响应码和同步时效。详细口径见《22_报表口径专题》。

26.1 异步查询风险

DataService 部分报表并行发请求，异步失败回调可能只收到空数组。业务层必须区分：

真实无数据 != 请求超时 != 下游返回错误 != 回调没有执行

27. CRM 与经营任务

Provider：application/Providers/Crm/*。

CRM 是签约与经营任务的主系统，DGJ 负责业务入口和展示。保存后超时必须按业务单号查询，避免重复创建签约单。

28. 风控中心

Provider：application/Providers/RiskCenter/RiskCenterProvider.php。

能力：按服务站批量查询信用健康和风险信息。

关键原则：

• 风控接口不可用时，涉及授信、放款或高风险资金动作不能默认放行。
• 普通只读展示可以降级为空或提示，但必须明确与“无风险”不同。
• 风险结果应带查询时间，避免使用过期缓存做资金决策。

29. 通知中心与 JPush

29.1 短信

application/Providers/NotifyCenter/Sms/SmsProvider.php：

短信通过 scenarioCode + args + receivers 调用通知中心。

29.2 推送

application/Providers/DataService/JpushProvider.php 处理移动推送，部分调用采用异步回调。

手机号、验证码、账号初始信息都属于敏感信息，Provider 公共日志必须脱敏。

30. 文件服务、OSS 与文档转换

文档转换服务地址按环境配置，禁止在知识库记录实际内部地址。

flowchart LR
    A[业务数据] --> B[HTML/模板]
    B --> C[文档转换服务]
    C --> D[PDF或PNG]
    D --> E[OSS]
    E --> F[短信/机器人/人工下载]

失败补偿需要区分：生成失败、上传失败、临时 URL 过期、发送失败。

31. 高德地图

Provider：application/Providers/Amap/AmapProvider.php。

密钥来自配置，不能记录在日志或文档。地址属于个人/客户数据，日志只保留必要片段或哈希。

地图失败通常不应直接修改客户原始地址；可以标记待解析并补偿。

32. AI 中心与语音能力

application/Providers/AiCenter/AiCenterProvider.php 支持：

• 语音解析和格式转换。
• 图片配件 OCR。
• 异步 OCR 回调上下文。
• 业务消息发送。

application/Providers/DevCenter/Voice2TextProvider.php 还提供语音转文字 Token 能力。

32.1 超时和降级

AI 请求可使用较长超时。OCR/语音失败时应允许用户重新上传、手工输入或回到普通搜索，不应把空识别结果写成已确认车型/配件。

33. 新采购服务与销售服务

这些 Provider 表明单体能力正在向独立服务迁移。改动前要确认流量开关和旧/新实现所有权：

flowchart TD
    A[DGJ Controller] --> B{服务化开关/路由}
    B -->|旧链路| C[本地 Service + 本地表]
    B -->|新链路| D[Purchase/Sale/DGJ Service]
    C --> E[统一响应]
    D --> E

不能只修改本地旧 Service 后就认为线上生效。

34. 鉴权清单

“Provider 中没有 header”不等于接口无鉴权，必须通过网关配置和部署环境确认。

35. 超时清单

每个接口都要定义：连接超时、总超时、最大重试、退避、可重试错误和最终补偿。

36. 幂等清单

37. 跨系统一致性模型

flowchart TD
    A[本地事务提交] --> B[写待发送/业务日志]
    B --> C[发送 HTTP 或 MQ]
    C --> D{外部确认}
    D -->|成功| E[记录外部单号/最终状态]
    D -->|明确失败| F[回滚可回滚动作或标记失败]
    D -->|超时未知| G[按幂等键主动查询]
    G -->|已受理| E
    G -->|未受理| H[安全重试]
    G -->|仍未知| I[人工待处理]

DGJ 当前并非所有链路都有 Outbox。高风险资金、库存、订单事件应逐步补齐“本地业务提交 + 待发送记录 + 重试 + 对账”闭环。

38. ACK / NACK 决策

不能用一个通用 catch 对所有异常都 NACK，否则永久业务错误会形成重试风暴。

39. 联调前契约模板

每个新接口或事件必须明确：

系统名称：
系统 Owner / 值班群：
环境与配置常量：
协议：HTTP / Topic MQ / Direct MQ
方向：DGJ -> 对方 / 对方 -> DGJ
接口路径或 destination.routingKey：
鉴权方式：
请求字段与单位：
成功码：
业务幂等键：
超时与重试：
乱序规则：
回调/回执：
失败补偿：
日志 traceId：
上线开关：
监控与告警：

40. HTTP 请求示例

仅示意结构，不包含真实域名和凭据：

POST {CENTER_API}/imcenter/ext/zgj/user/sendimmessage
Content-Type: application/json
X-Trace-Id: trace_example

{
  "message": {
    "bizType": "业务类型",
    "bizContext": "{\"sid\":\"站点\"}",
    "bizData": "{\"businessNo\":\"业务单号\"}"
  }
}

响应需同时判断 HTTP 状态和业务 code。

41. MQ 消息示例

{
  "messageId": "稳定唯一消息标识",
  "eventType": "garage_repair_order_updated",
  "businessKey": "销售单号",
  "occurredAt": "2026-07-15T12:00:00+08:00",
  "version": 3,
  "source": "dgj",
  "traceId": "trace_example",
  "data": {
    "orderNo": "销售单号",
    "status": "业务状态",
    "items": []
  }
}

42. 一次完整联调流程

sequenceDiagram
    participant P as 产品/业务
    participant D as DGJ开发
    participant E as 外部系统开发
    participant T as 测试
    P->>D: 确认业务状态与失败处理
    D->>E: 确认契约、幂等、单位和超时
    D->>D: 记录请求/事件和本地状态
    D->>E: 发送一条唯一业务样本
    E-->>D: 返回外部单号或消费证据
    E->>D: 回调/反向事件
    D->>D: 核对本地状态、表和副作用
    T->>D: 重复、乱序、超时、缺字段测试
    D-->>P: 业务闭环验收

43. 故障定位总流程

flowchart TD
    A[拿到业务单号/消息ID] --> B{方向}
    B -->|DGJ发出| C[查本地事务与Producer日志]
    B -->|DGJ接收| D[查队列Consumer与routing key]
    C --> E{是否发送成功}
    E -->|否| F[本地重试/Outbox/补偿]
    E -->|是| G[查对方接收和业务结果]
    D --> H{是否收到}
    H -->|否| I[查binding、积压、消费者进程]
    H -->|是| J[查幂等、状态校验和事务]
    G --> K{是否有回调}
    K -->|无| L[查对方回调生产与本地队列]
    K -->|有| J

44. 常用日志关键字

日志中查询手机号、银行卡、Token 等敏感信息时，应使用脱敏值或受控工具。

45. 常用代码检索

# 所有 destination 和 routing key
rg -n "const DEST_|const TYPE_|const .*NOTIFY" application/KzData/Enums/MqEventEnums.php

# 所有消费者注册
rg -n "create.*Consumer|registryCallback|startConsume" application/controllers/tasks

# 所有生产方法
rg -n "public function send|create.*Producer|publish" application/Services/Mq/MqSer.php application/Services/SyncOrder

# 外部 HTTP Provider
find application/Providers -type f -name '*.php' | sort
rg -n "requestSer|requestSerAsync|CENTER_API|REPORT_SERVICE" application/Providers

# 超时、异常和响应码
rg -n "timeout|code.*[!=]=|RequestTimeoutException|ProviderErrorException" application/Providers

46. 只读核对数据

跨系统故障至少收集以下证据，不直接修改数据：

1. 本地业务主单与明细状态。
2. 外部单号映射。
3. Producer/HTTP 请求时间、traceId、messageId。
4. 对方受理或消费证据。
5. 回调事件和 Consumer 结果。
6. 本地幂等记录或已落流水。
7. 后续库存、资金、报表和通知副作用。

47. 常见误判

48. 高风险公共问题

49. 改动风险

1. 修改 destination/routing key 会导致生产和消费解绑。
2. 修改 payload 字段或类型会影响所有下游版本。
3. 修改金额单位可能造成资金事故。
4. 修改状态枚举可能让旧消息无法消费。
5. 修改超时和重试可能放大下游压力。
6. 修改 Provider 公共响应判断会影响多系统。
7. 修改 MQ ACK/NACK 会改变积压和死信行为。
8. 修改日志字段需要保证脱敏但仍可追踪。
9. 修改旧/新服务路由必须确认流量开关。

50. 回归矩阵

51. 发布前检查清单

• [ ] 系统 Owner、值班群和升级路径已确认。
• [ ] 开发、预发、生产配置常量已核对，未记录实际密钥。
• [ ] HTTP 路径、方法、Content-Type 和成功码已确认。
• [ ] MQ destination、routing key、exchange 类型和 binding 已确认。
• [ ] 请求字段的必填、类型、金额单位和时间格式已确认。
• [ ] 业务幂等键有数据库唯一约束或可靠处理记录。
• [ ] 超时后不会盲目重复提交。
• [ ] 重复、乱序、缺字段、部分成功已回归。
• [ ] ACK/NACK、重试、死信和人工补偿已演练。
• [ ] traceId、messageId、业务单号能跨系统串联。
• [ ] 公共 Provider 日志已脱敏。
• [ ] 旧链路和新服务化链路的真实流量已确认。
• [ ] 监控覆盖请求失败率、超时、队列积压和死信。
• [ ] 回滚不会破坏已被外部受理的业务。

52. 证据文件

53. 待环境确认

1. 每个系统的生产 Owner、值班群和升级时限。
2. 所有 HTTP 接口的网关鉴权、服务身份和凭据轮换。
3. MQ exchange 类型、binding、prefetch、publisher confirm、重试和死信配置。
4. 生产是否启用拆分后的 Purchase/Sale/DGJ Service 路由。
5. 订单、支付、库存关键流水的数据库唯一约束。
6. TMS 与调拨中心状态版本和乱序规则。
7. Report Service、DataService 和 DWD 的 SLA。
8. Udesk、高德、腾讯 IM、短信、OSS 的配额与告警。
9. 对账单文档转换服务的高可用和失败重试。
10. 公共 Provider 日志在生产的脱敏策略。

54. 维护规则

新增外部系统时，必须同步完成：

Provider/Consumer/Producer 代码
+ 配置 key（不含值）
+ 接口或事件契约
+ 幂等和补偿
+ 监控告警
+ 本文系统资产表
+ 对应业务专题
+ 可复用 Skill

废弃接口不能只删调用方，应确认队列 binding、定时任务、配置、告警和下游订阅均已清理，并在本文标记 deprecated 与下线日期。

55. 一句话记忆

每次跨系统排查都沿“本地业务提交 → 请求/消息发送 → 对方受理 → 回调消费 → 本地副作用”五段走，任何一段都要有业务键、状态证据和补偿责任人。

请求-日志-数据变更追踪卡

多入口请求链路

日志证据矩阵

| 链路段 | 日志来源 | 可检索锚点 | 成功信号 | 失败信号 | 与下一段关联方式 | | --- | --- | --- | --- | --- | --- | --- | | 本地发起 | 调用 Service | request_id、本地单号、Provider/route | 参数快照和调用开始可定位 | 未调用或参数构造失败 | 本地单号进入 Provider | | 网络/Provider | BaseProvider/子 Provider | URL 名称、外部 request ID、耗时、HTTP/业务码 | 对方明确受理 | timeout、HTTP 非 2xx、业务失败 | 外部 request/order ID 供对方检索 | | 对方处理 | 对方日志/工单证据 | 外部 request/order ID | 对方状态完成 | 对方未收到/处理中/失败 | 外部单号进入回调 | | 回调消费 | Inner/OpenAPI/Notify 日志 | message ID、外部单号、本地单号 | 幂等落库并 ACK | 映射缺失、重复/乱序、NACK | 关系表映射到本地主表 |

环节数据变更台账

子模块追踪：ext-order-center 订单中心

子模块追踪：ext-pay-center 支付中心

子模块追踪：ext-transfer-dispatch 调拨中心与 TMS

子模块追踪：ext-item-inventory 商品中心与库存中心

子模块追踪：ext-ops OPS Center 与 OPS Manager

子模块追踪：ext-oa OA

子模块追踪：ext-saas SAAS 与 E站

子模块追踪：ext-channel 大客户渠道

子模块追踪：ext-allcarpart 全车件、QCJ 与 QPay

子模块追踪：ext-gpda GPDA 与 WMS

子模块追踪：ext-im IM 中心与腾讯 IM

子模块追踪：ext-wechat-udesk 微信机器人与 Udesk

子模块追踪：ext-vin VIN 与国内数据平台

子模块追踪：ext-report 报表中心、Report Service 与 DataService

子模块追踪：ext-crm-risk CRM 与风控中心

子模块追踪：ext-notify 通知中心、JPush 与短信

子模块追踪：ext-file-map 文件服务、OSS 与高德地图

子模块追踪：ext-ai-new-trade AI 中心、新采购与新销售服务