spring-boot-starter-trade
约 378 字大约 1 分钟
2026-05-09
电商/订单与支付：商品与分类、订单与订单商品、支付回调消费与下单流程中的公开接口（微信支付能力见 spring-boot-starter-wechat）。
Maven 结构
spring-boot-starter-trade-api：ApiTdGoodsService、ApiTdOrderService；消息契约TradeStreamBindings、TdOrderGoodsDTO。spring-boot-starter-trade-biz：BizTradeAutoConfiguration、各角色 Controller（cus/mgt/pub/callback）、TradeOrderGoodsPaidPublisher。
跨模块协作（MQ）
支付成功后，BizTradeOrderServiceImpl 通过 StreamBridge 发布 trade.order-goods.paid（消息体 TdOrderGoodsDTO）。各业务域按需订阅：
| 消费方 | group | 说明 |
|---|---|---|
| dating-biz | dating | 婚恋履约（DatingTradeGoodsCategoryEnum 路由） |
| distribution-biz | distribution | 分销分佣 |
绑定配置见 application-trade-messaging.yml（classpath，由 runner spring.config.import 引入）。
模块内扩展
- 支付渠道：实现
BizPayService并声明paidChannelCode()（见TradePaidChannelEnum），由BizPayServiceRegistry注入路由，勿使用SpringUtil.getBean按名称解析。
命名说明（历史遗留）
- 本模块部分字段含
SysUser字样（如tdOdSysUserCode）为早期命名，含义即userCode。 - 新字段请勿沿用；全库约定见根目录 AI 编码规范 与 TG-boot 总览：表前缀 + 字段名，省略系统层（例：若新建表需存下单用户，应使用
tdOdUserCode一类写法，而非tdOdSysUserCode）。
HTTP 概要
- 公开：支付相关
PubPayController、PubTradeOrderController、PubBizTradeGoodsController等。 - 回调：微信支付回调已迁至 wechat 模块；trade 通过 MQ（
wx.pay.notify）消费并调用paidOrder。 - 客户端 / 管理端：订单、商品、分类等 CRUD 与查询（微信支付配置见
spring-boot-starter-wechat）。
具体 URL 以 Swagger 与各 @RequestMapping 为准。 源码路径：tg-boot/spring-boot-starter-module/spring-boot-starter-components/