1. 为什么增加第二层验收
文章级追踪只能证明一篇文章里存在请求、日志和数据变化说明，不能证明文章内每个业务子模块都能独立排查。本矩阵把验收粒度下沉到子模块：采购保存、提交、支付、发货、入库、关闭和退货必须分别闭环，其他业务域同理。
当前文章级追踪为 47/47；子模块级独立追踪为 416/416。只有后者达到 416/416，才表示“所有每个模块各自”完成。
2. 单个子模块的完成标准
每个清单项必须在所属文章中拥有独立的 ### 子模块追踪 章节，并至少回答：
- 谁从哪个 Controller、API code、Consumer 或 Task 触发，请求和稳定业务键是什么；
- Controller/Consumer 到 Service/Provider、Model、表、缓存、MQ 和外部系统怎样调用；
- 每一步读取什么事实、处于哪个事务或异步边界；
- 哪张表或缓存发生 insert/update/delete，状态、数量、金额怎样
old -> new； - 日志用 request ID、
sid、业务单号、来源单号、支付/OA/message ID 中哪些键串联； - 失败会回滚到哪里，部分成功由谁补偿，怎样只读回查且重复执行不产生副作用。
3. 全量覆盖矩阵
| 文章 | 已完成/总数 | 状态 | 子模块清单 |
|---|---|---|---|
| 01 | 7/7 | 已完成 | 已补 pc-request PC 请求生命周期；已补 inner-api Inner 内部 API 生命周期；已补 app-gateway App tradeCode 网关；已补 openapi 老 OpenAPI 动态分发；已补 mq-consumer MQ 回调与消费者；已补 cli-task CLI 与定时任务；已补 transaction-data 统一事务与数据访问边界 |
| 02 | 8/8 | 已完成 | 已补 goods-sync 商品中心资料同步；已补 goods-status 商品与物料状态可用性；已补 storage-location 仓库与货位维护；已补 inventory-flow 库存流水写入；已补 realtime-inventory 实时库存增减；已补 negative-inventory 负库存控制；已补 stock-check 盘点差异调整；已补 inventory-cache 库存缓存、搜索与预警同步 |
| 03 | 8/8 | 已完成 | 已补 po-draft 采购草稿保存与编辑；已补 po-submit-audit 采购提交与审核；已补 po-payment 采购支付与支付回调；已补 po-delivery 采购发货与配送；已补 po-inbound 采购入库与库存增加；已补 po-close 采购关闭与取消；已补 po-return 采购退货与退货出库；已补 po-source 秒杀、赠品与预订单来源联动 |
| 04 | 8/8 | 已完成 | 已补 sale-create 销售订单创建；已补 sale-outbound 销售出库单创建；已补 sale-stock 销售出库库存扣减；已补 sale-delivery 配送、自提与签收；已补 sale-receipt 对账、收款与核销；已补 sale-revoke 撤销出库与状态恢复；已补 sale-return 销售退货与退货入库；已补 sale-sync 销售与出库下游同步 |
| 05 | 9/9 | 已完成 | 已补 flash-config 秒杀活动配置；已补 flash-oa OA 提交与审批回调；已补 flash-scope 服务站范围与商品可见性；已补 flash-cart 购物车与原子锁量；已补 flash-preview 订单预览与价格库存复核；已补 flash-submit 秒杀下单与转采购；已补 flash-pay 秒杀支付与锁量转已用；已补 flash-release 取消、关闭与数量释放；已补 flash-compensate 超时与补偿任务 |
| 06 | 9/9 | 已完成 | 已补 eshop-order E站销售订单创建；已补 eshop-split E站分仓拆单；已补 eshop-goods 移动商城商品查询；已补 move-supply 微仓补货；已补 move-transfer 微仓调拨与收货；已补 move-return 移动退货；已补 robot-v1 旧智能询价；已补 robot-v2 RobotV2 会话与查询；已补 robot-callback-order AI 异步回调与机器人下单 |
| 07 | 8/8 | 已完成 | 已补 channel-goods 渠道商品查询；已补 channel-create 渠道订单创建；已补 channel-audit 人工代建与渠道审核；已补 channel-ship 渠道发货与库存出库；已补 channel-sign 渠道签收；已补 channel-aftersale 渠道售后申请与审核；已补 channel-return 渠道退货入库与退款；已补 allcarpart 全车件路由、代理与本地能力 |
| 08 | 7/7 | 已完成 | 已补 pay-success 支付成功落账；已补 pay-exception 支付异常与退款回调；已补 credit-adjust 额度调整与授信回调；已补 report-query 报表查询与离线数据；已补 oa-callback OA 模板分流与结果回调；已补 order-sync 销售和出库下游同步；已补 mq-compensation MQ 消费与定时补偿 |
| 10 | 9/9 | 已完成 | 已补 base-tables 基础资料域表；已补 purchase-tables 采购域表；已补 sale-tables 销售与出库域表；已补 inventory-tables 库存域表与分片；已补 finance-tables 财务域表；已补 activity-tables 活动与秒杀域表；已补 channel-tables 渠道与大客户域表；已补 move-tables 移动商城、微仓与对账域表；已补 system-tables 系统、权限、机器人与专项表 |
| 11 | 10/10 | 已完成 | 已补 po-status 采购主状态机；已补 po-type-source 采购订单类型与来源；已补 preorder-status 预订单状态机；已补 sale-status 销售订单状态机；已补 invoice-status 销售出库状态机；已补 flash-status 秒杀活动、购物车与订单状态机；已补 channel-status 渠道订单与售后状态机；已补 move-status 微仓补货、退货与调拨状态机；已补 delivery-status 配送状态映射；已补 finance-status 收付款、对账与交易类型状态 |
| 12 | 8/8 | 已完成 | 已补 pc-entry PC Controller 入口；已补 inner-entry Inner 内部 API 入口；已补 app-entry App tradeCode 映射入口；已补 pda-entry App、PDA 直接 Controller 入口；已补 openapi-entry 老 OpenAPI 入口；已补 allcarpart-entry 全车件路由与代理入口；已补 report-file-entry 报表、导出与文件入口；已补 mq-cli-entry MQ Consumer 与 CLI Task 入口 |
| 13 | 10/10 | 已完成 | 已补 paycenter-mq 支付中心消息；已补 ordercenter-mq 订单中心消息；已补 dispatch-mq 调拨与配送中心消息；已补 oa-mq OA 消息；已补 itemcenter-mq 商品中心消息；已补 dgj-mq DGJ 内部消息；已补 saas-mq DGJ 发往 App 与 SAAS 的消息；已补 channel-mq 渠道消息；已补 statement-mq 对账单异步任务；已补 delay-compensate 延迟队列、重试与补偿任务 |
| 14 | 8/8 | 已完成 | 已补 po-create-check 采购创建、保存与提交排查；已补 po-audit-check 采购审核排查；已补 po-pay-check 采购支付排查；已补 po-delivery-check 采购出库与配送排查；已补 po-inbound-check 采购入库与库存排查；已补 po-overreceipt-check 重复入库与超收排查；已补 po-close-check 采购关闭取消排查；已补 po-return-check 采购退货与特殊来源排查 |
| 15 | 8/8 | 已完成 | 已补 sale-create-check 销售创建排查；已补 sale-out-check 销售出库排查；已补 sale-stock-check 出库与库存一致性排查；已补 sale-delivery-check 配送与 TMS 排查；已补 sale-receipt-check 对账收款核销排查；已补 sale-close-check 关单、结单与撤销出库排查；已补 sale-return-check 销售退货排查；已补 sale-mq-check 销售下游 MQ 排查 |
| 16 | 9/9 | 已完成 | 已补 inventory-write-check 库存写入与实时量排查；已补 inventory-negative-check 负库存控制排查；已补 inventory-archive-check 分片、跨月与历史归档排查；已补 inventory-repeat-check 删除、编辑与重复操作排查；已补 inventory-stocktake-check 盘点一致性排查；已补 inventory-package-check 套包、拆包与组包排查；已补 inventory-transfer-check 货位调整与调拨排查；已补 inventory-warning-check 库存预警排查；已补 inventory-cache-check Redis、ES 与页面库存排查 |
| 17 | 10/10 | 已完成 | 已补 flash-save-check 活动保存、效期与冲突规则；已补 flash-scope-check 站点范围与商品可见性；已补 flash-oa-check OA 提交与回调；已补 flash-price-check 秒杀价格链；已补 flash-stock-check 秒杀库存计算；已补 flash-cart-check 购物车与失效；已补 flash-preview-submit 预览、提交与原子锁量；已补 flash-po-pay 转采购与支付；已补 flash-cancel-compensate 取消、超时、关闭与补偿；已补 flash-import-export 秒杀导入、导出与模板 |
| 18 | 10/10 | 已完成 | 已补 finance-pay-request 支付发起与受理；已补 finance-pay-success 支付成功回调；已补 finance-repeat-late 重复回调与迟到支付；已补 finance-zero-mixed 零元与混合支付；已补 finance-preorder 预订单支付；已补 finance-exception 支付异常；已补 finance-refund 退款与提现退款；已补 finance-credit 额度调整、授信与白条还款；已补 finance-overdue 到期提醒与逾期锁站；已补 finance-receipt 销售收款、对账与核销 |
| 19 | 9/9 | 已完成 | 已补 menu-load PC 菜单加载与过滤；已补 user-grant 用户授权写入；已补 runtime-auth 运行时接口鉴权；已补 rights-cache USER_RIGHTS 缓存；已补 ops-menu OPS 菜单规则配置；已补 app-menu 应用开通与菜单；已补 ops-whitelist OPS、地区与运营白名单；已补 business-blacklist 采购销售黑名单与财务锁站；已补 acl-migration 菜单同步与 ACL 迁移 |
| 20 | 9/9 | 已完成 | 已补 excel-upload-parse 文件上传、解析与表头契约；已补 excel-validate-write 三层校验与批量落库；已补 excel-error-file 错误返回与错误文件；已补 excel-download 模板缓存、下载与 OSS；已补 excel-security 公式注入、列数与大文件安全；已补 flash-excel 秒杀商品导入导出；已补 base-excel 基础资料导入；已补 trade-excel 采购、销售与盘点导入；已补 report-export 报表与 CSV 导出 |
| 21 | 9/9 | 已完成 | 已补 search-route Mongo、ES 与数据库查询路由；已补 mongo-index 物料 Mongo 缓存与索引；已补 es-index 物料 ES 文档与 mapping；已补 redis-material Redis 物料、限购与价格集合；已补 goods-notify 商品中心增量通知；已补 full-sync 全量同步与重建；已补 increment-sync 增量水位与任务锁；已补 search-api 搜索 API 与业务可用性过滤；已补 search-repair 缓存索引差异修复 |
| 22 | 8/8 | 已完成 | 已补 purchase-report 采购订单、退货与入库报表；已补 sale-report 销售明细、聚合与对账报表；已补 inventory-report 库存流水报表；已补 profit-report 利润表与成本口径；已补 receivable-report 应收账款报表；已补 payable-report 应付账款报表；已补 statement-report 对账单生成与发送；已补 report-export-delay 报表导出、权限与离线延迟 |
| 23 | 18/18 | 已完成 | 已补 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 中心、新采购与新销售服务 |
| 24 | 10/10 | 已完成 | 已补 local-start 本地容器启动与健康检查；已补 local-pc PC 请求联调；已补 local-app-pda App 与 PDA 请求联调；已补 local-openapi 老 OpenAPI 联调；已补 local-inner Inner API 联调；已补 local-mq RabbitMQ 消费联调；已补 local-cli CLI 与定时任务联调；已补 local-data MySQL、Redis、Mongo 与 ES 联调；已补 local-provider 外部 Provider 与 Mock 联调；已补 preprod-log 预发日志、Kibana 与环境差异 |
| 25 | 11/11 | 已完成 | 已补 risk-invpo-service InvPoService 采购公共链；已补 risk-invpo-factory InvPoFactory 采购事务编排；已补 risk-poorder-ser PoOrderSer 新采购领域链；已补 risk-invsa-service InvSaService 销售公共链；已补 risk-saorder-ser SaOrderSer 新销售领域链；已补 risk-inventory-ser InventorySer 库存事实链；已补 risk-kzinventory-ser KzInventorySer 供给库存链；已补 risk-mq-ser MqSer 消息生产链；已补 risk-task-consumer 支付、订单、OA Consumer；已补 risk-base-model BaseModel 数据访问链；已补 risk-base-provider-view BaseProvider 与公共视图组件 |
| 26 | 8/8 | 已完成 | 已补 pda-login-common PDA 登录与公共查询；已补 pda-purchase PDA 采购收货与入库；已补 pda-sale PDA 销售拣货与出库；已补 pda-stocktake PDA 扫码盘点；已补 gpda-stocktake GPDA 盘点与仓库查询；已补 pda-area-change 库区与货位调整；已补 pda-outcheck 出库复核；已补 gpda-notify GPDA 消息回调与 OPS 通知 |
| 27 | 7/7 | 已完成 | 已补 stf-apply 服务站调拨申请；已补 stf-audit 申请审核与供给确认；已补 stf-outbound 供给站调拨出库；已补 stf-intransit 调拨在途；已补 stf-inbound 申请站调拨入库；已补 stf-cancel 调拨取消与剩余量关闭；已补 stf-settlement 调拨资金结算 |
| 28 | 7/7 | 已完成 | 已补 statement-strategy 对账策略维护；已补 statement-relation 策略客户关系；已补 statement-task 账单生成任务；已补 statement-snapshot 账单三层快照；已补 statement-export 账单文件生成；已补 statement-send 微信、短信与文件发送；已补 statement-receipt 收款同步与账单状态重算 |
| 29 | 7/7 | 已完成 | 已补 return-apply 售后申请创建；已补 return-audit 售后审核；已补 return-order 销售退货单创建；已补 return-inbound 退货入库与库存增加；已补 return-refund 退款与资金回退；已补 return-reject-cancel 驳回、取消与额度释放；已补 return-notify 售后状态通知 |
| 30 | 6/6 | 已完成 | 已补 tax-config 税票资料配置；已补 tax-apply 税务发票申请；已补 tax-provider 外部开票受理；已补 tax-callback 开票结果回写；已补 tax-file 发票文件与 OSS；已补 tms-invoice TMS 出库 Invoice 概念隔离 |
| 31 | 8/8 | 已完成 | 已补 bank-pay 银行与聚合支付；已补 installment-config 授信分期模式配置；已补 installment-sign 分期签约；已补 installment-apply 分期申请与服务费；已补 installment-pay 分期支付回调；已补 installment-lock 延迟、逾期与锁定；已补 installment-refund 分期退款；已补 installment-repay 分期还款与额度恢复 |
| 32 | 8/8 | 已完成 | 已补 exclusive-pool 专属授信资金池；已补 exclusive-activity 专属授信活动；已补 exclusive-station-apply 服务站授信申请；已补 exclusive-approve 申请审批与额度分配；已补 exclusive-order-hold 订单占额与冻结；已补 exclusive-pay 支付后冻结转已用；已补 exclusive-adjust 上下级额度调整；已补 exclusive-refund-rebate 退款、返利与额度返还 |
| 33 | 7/7 | 已完成 | 已补 help-question 用户提问；已补 help-answer 回答与采纳；已补 help-library 题库维护；已补 help-knowledge 知识文章维护；已补 help-audit 内容审核与发布；已补 help-search 知识库搜索；已补 help-index-repair ES 索引同步与修复 |
| 34 | 7/7 | 已完成 | 已补 tyre-user-property 轮胎用户与属性配置；已补 tyre-registration 轮胎安装登记；已补 tyre-image 登记与理赔图片；已补 tyre-claim 理赔申请；已补 tyre-claim-audit 理赔审核；已补 tyre-bad-po 坏品采购退货联动；已补 tyre-compensate 理赔状态补偿 |
| 35 | 10/10 | 已完成 | 已补 login-web Web 登录与 Session；已补 login-first-silent 首次登录与静默登录；已补 login-pc PC 登录与客户端类型；已补 pc-bind PC 机器码绑定、授权与解绑；已补 login-app App 登录、选站与单设备；已补 login-pda PDA 登录；已补 terminal-switch 站点端开关与缓存；已补 account-security 账号安全配置与强制重登；已补 password-reset 忘记密码与重置；已补 finance-lock 财务锁站与全端失效 |
| 36 | 7/7 | 已完成 | 已补 headoffice-sync OPS 总分店组织同步；已补 headoffice-login 总部账号登录与 Session；已补 headoffice-switch 总部切换分店；已补 headoffice-rights 权限传播与 Session 刷新；已补 headoffice-purchase 总部采购汇总；已补 headoffice-sale 总部销售汇总；已补 headoffice-finance 总部财务与单站报表 |
| 37 | 9/9 | 已完成 | 已补 client-activity-apply 服务站活动申请；已补 client-activity-audit OPS 审核与正式活动生成；已补 client-activity-manage 正式活动编辑、状态与可见性；已补 client-activity-stock 活动库存追加与订单扣减；已补 client-activity-refund 活动退款与数量释放；已补 client-coupon-template 优惠券模板与审核；已补 client-coupon-issue 优惠券发放与库存；已补 client-coupon-use 券实例、核销与销售单；已补 client-marketing-import 营销导入导出与到期任务 |
| 38 | 10/10 | 已完成 | 已补 self-delivery-create 商家自配送创建；已补 self-delivery-rider 配送员接单、改派与到达；已补 self-delivery-sign 自配送签收与轨迹；已补 third-delivery-quote 三方配送准入与询价；已补 third-delivery-create 三方配送下单与本地落库；已补 third-delivery-cancel 三方取消、改派与异常退回；已补 urgent-pickup 采购急件自提；已补 tms-callback TMS 状态回调；已补 transfer-delivery 调拨中心采购出库；已补 express-supplement 运单、箱号与预计到货补偿 |
| 39 | 9/9 | 已完成 | 已补 im-ingress 腾讯 IM 消息入站；已补 robot-context RobotV2 会话 Context 与状态机；已补 robot-media VIN、图片与语音解析；已补 robot-query 机器人商品查询与展示；已补 robot-quote 旧 AI 报价与人工报价；已补 wechat-robot 微信机器人消息链；已补 im-group IM 群成员维护；已补 udesk-sync Udesk 同步与人工接管；已补 robot-timeout 重复消息、并发与超时任务 |
| 40 | 10/10 | 已完成 | 已补 datafix DataFix 定点修复；已补 general-task GeneralTasks 通用任务；已补 quote-migrate 报价规则迁移；已补 activity-migrate 活动规则迁移；已补 acl-migrate ACL 与菜单迁移；已补 channel-temp 临时渠道业务自动化；已补 file-replay 临时文件重放；已补 multiprocess-task 多进程与循环任务；已补 express-fix 运单补偿；已补 sql-migrate SQL 与 RobotV2 迁移文件 |
| 41 | 11/11 | 已完成 | 已补 quote-rule 报价规则配置；已补 quote-customer 客户绑定与报价范围；已补 quote-goods 商品配置与基础商品；已补 quote-calculate 最终价格计算；已补 quote-recent 最近报价与最近销售价；已补 smart-input 智能询价输入识别；已补 smart-decision 自动报价决策；已补 offer-apply 待报价申请；已补 offer-order 正式报价单；已补 offer-to-sale 正式报价转销售；已补 offer-im IM 工作台人工报价 |
| 42 | 8/8 | 已完成 | 已补 battery-identity 电池站身份；已补 battery-scope 自营与第三方可售范围；已补 battery-cache 可售 SKU Redis 缓存；已补 battery-search 商品列表与搜索过滤；已补 battery-purchase 采购查询与提交校验；已补 battery-sale-return 销售、退货与采购售后；已补 battery-import 电池商品导入；已补 battery-robot V1/V2 机器人电池查询 |
| 43 | 10/10 | 已完成 | 已补 preorder-create 预订单创建与定金；已补 preorder-pay 预订单支付；已补 preorder-pick-check 可提货与最小提货校验；已补 preorder-pick-po 提货转采购；已补 preorder-quota 提货额度原子更新；已补 preorder-close-return 采购关闭与额度回退；已补 preorder-aftersale 预订单售后与退款；已补 firstmatch-config 首配方案配置与商品生成；已补 firstmatch-po 首配采购单生成与履约；已补 firstmatch-return 首配退货与补偿任务 |
| 44 | 9/9 | 已完成 | 已补 big-goods 大客户渠道商品查询；已补 big-order-create 外部渠道下单；已补 big-manual 服务站人工代建订单；已补 big-audit 渠道审核与自动发货决策；已补 big-ship 渠道发货与库存事实单；已补 big-sign 签收与异步回写；已补 big-aftersale 渠道售后申请与审核；已补 big-return 渠道退货入库；已补 big-service-type 普通、直采与临采 |
| 45 | 9/9 | 已完成 | 已补 cost-read-version 动态成本分表、版本与按日读取；已补 cost-weighted 移动加权与负库存入库成本；已补 cost-init-fix 成本初始化与零成本修复；已补 cost-po-inbound 采购入库成本更新；已补 cost-other-stock 销退、大客户、调拨与盘点成本；已补 cost-sale-snapshot 销售出库成本快照；已补 cost-adjust 成本调整单；已补 cost-sale-profit 销售明细毛利；已补 cost-month-profit 月利润表与报表差异 |
| 46 | 10/10 | 已完成 | 已补 region-tree 行政区划树与缓存；已补 region-calibrate 省市区校准任务；已补 contact-address 客户、供应商与服务站地址；已补 order-address-snapshot 采购销售订单地址快照；已补 storage-geocode 仓库地址与地理编码；已补 return-address 快准退货地址与缓存；已补 delivery-timeliness 承运商与配送时效；已补 self-delivery-address 自配送创建与地址使用；已补 third-delivery-address 三方询价、下单与取消；已补 purchase-logistics 采购急件与退货物流 |
| 47 | 10/10 | 已完成 | 已补 message-inbox 站内信创建、收件与已读；已补 message-manual 人工发送、删除与撤销；已补 message-cron 定时站内信；已补 message-remind 弹窗与悬浮提醒；已补 message-app-mq APP 业务通知 MQ；已补 message-jpush JPush 客情提醒；已补 message-sms 短信与验证码；已补 message-im IM 入站消息；已补 message-statement 对账单微信发送与重发；已补 message-ops-alert 用户通知与运维告警隔离 |
| 48 | 9/9 | 已完成 | 已补 legacy-openapi 老 OpenAPI 动态分发与幂等；已补 app-api App API 签名、登录与映射；已补 legacy-saas 老 SAAS 映射与销售建单；已补 open-saas 令牌式 OpenSaaS 与 VIP 下单；已补 point-mall 积分商城映射入口；已补 allcarpart-proxy 全车件代理与本地能力；已补 base-api BaseApiController 直连接口；已补 compat-response 旧响应、错误码与字段兼容；已补 api-migration 接口迁移、审计与下线 |
4. 验收命令
python3 scripts/audit-dgj2-docs.py --require-trace
python3 scripts/audit-dgj2-docs.py --require-submodules第一条只检查文章级追踪；第二条按 scripts/data/dgj2-submodule-trace-manifest.json 检查每一个子模块。施工期间允许第一条通过、第二条失败；最终交付必须两条都通过。