项目名称：跨境代购代采中台（对接 1688 寻源通 API）定位：面向跨境卖家（TikTok Shop / AliExpress 速卖通 / Shopee / 独立站）提供货源采集、自动采购、代发履约、财务对账一体化 SaaS 平台对接底座：1688 开放平台 - 寻源通（跨境代采）OAuth2.0 API模式：推荐【多租户 SaaS】，每个卖家独立授权自有 1688 买家账号，资金隔离，合规风险最低；同时兼容自营统一代采模式能力边界：只做代采履约中台；不爬虫，主链路全部使用官方开放 API
包含：整体架构、业务时序图、核心数据库表、风控设计、API 对接规范、部署上线方案
一、整体系统架构（微服务架构，中小团队可简化单体）
1. 分层架构
【前端接入层】 卖家管理后台（Vue） 运营控制台 选品工作台 财务对账后台 OpenAPI（给第三方ERP对接） 【API网关层】 Nginx/CloudGateway 统一鉴权、签名校验、限流、日志采集、跨域、防重放 【业务微服务层（核心）】 1. 租户授权服务 1688 OAuth授权管理、access_token/refresh_token自动刷新、多租户隔离 2. 货源选品服务 关键词搜货、图搜同款、商品详情采集、成本核算、多语言翻译、货源缓存 3. SKU映射服务 下游外部SKU ↔ 1688 offerId+skuId 绑定管理、价格同步 4. 采购履约服务 创建1688采购单、支付链接获取、订单查询、订单取消、状态流转 5. 库存风控服务 定时库存同步、下单实时库存校验、Redis分布式锁防超卖、缺货预警 6. 物流履约服务 国内运费预估、物流轨迹拉取、运单回填下游、货代系统对接 7. 消息回调服务（Webhook） 接收1688平台回调：付款成功、发货、退款、订单关闭，异步处理 8. 下游渠道服务 对接TikTok/速卖通/Shopee/独立站，拉取下游订单、回传单号 9. 财务对账服务 采购账单、佣金、跨境宝结算、利润统计、导出对账报表 【中间件基础设施】 MySQL8.0：业务主数据 Redis：分布式锁、token缓存、商品缓存、限流计数器 RabbitMQ/RocketMQ：异步削峰（订单回流、回调处理、库存同步） MinIO 对象存储：商品图片、报关资料、面单存档 ELK：日志收集排查 Prometheus + Grafana：监控告警 【外部对接层】 ✅ 1688寻源通开放API（核心） ✅ 下游跨境平台开放API（TikTok Shop / AliExpress / Shopee） ✅ 货代/集运系统API ✅ 跨境宝、支付对账接口
2. 两种部署模式对比
模式 A：SaaS 多租户（推荐对外商用）
OAuth2.0：卖家授权自己的 1688 企业买家账号
资金隔离：跨境宝在卖家自己名下，平台不触碰资金
优势：合规、低财税风险，适合对外售卖 ERP / 代采服务
模式 B：自营代采中台（内部自用）
统一 1688 采购账号，统一资金池
风险：资金归集、报关、财税合规压力大，建议具备进出口资质企业使用
二、完整业务时序（标准一件代发全链路）
业务场景：跨境卖家刊登 1688 货源，海外买家下单 → 系统自动代采代发
选品刊登阶段1）卖家在代采中台输入关键词 / 上传图片 2）中台调用寻源通：
alibaba.offer.search.crossborder/ 图搜接口，获取跨境专供货源 3）调用alibaba.product.get_pro获取完整 SKU、件重尺、阶梯价、代发规则 4）调用运费预估接口alibaba.logistics.offer.freight.estimate核算国内采购成本 5）（可选）寻源通 AI 翻译接口生成英文标题属性 6）系统建立映射关系：外部SKU ↔ offerId + skuId，存入 t_sku_mapping 7）一键刊登至 TikTok / 速卖通 / 独立站下游店铺下游订单回流1）海外消费者下单，下游平台推送订单消息到中台 2）MQ 异步接收下游订单，避免高并发压垮数据库 3）分布式锁：防止同一外部订单重复创建采购单 4）风控校验：实时调用
alibaba.offer.sku.stock.get校验 SKU 库存库存不足 → 标记缺货，推送消息通知卖家，终止流程，进入告警队列
库存充足 → 继续执行
1688 采购下单1）调用
alibaba.trade.order.create创建 1688 采购单入参携带外部唯一订单号（幂等标识）、收货地址 = 国内集运仓 / 货代地址、贴单备注 2）调用
alibaba.trade.payWay.query查询支持支付渠道（跨境宝 crossBorderPay） 3）调用alibaba.crossBorderPay.url.get获取支付链接 4）跳转支付（免密代扣需单独签约风控限额）供应商履约 + 1688 回调1）供应商后台接单，打包贴国内面单，点击发货 2）1688 Webhook 推送【已发货】回调，携带国内运单号 3）中台异步解析回调，更新采购单物流信息 4）运单同步至货代系统，合箱、报关、国际专线发出
回填下游店铺 + 售后闭环1）中台将国内运单 / 国际运单号回传给下游跨境店铺 2）海外买家查看物流轨迹 3）退款回调同步：下游发起退款 → 中台同步发起 1688 采购单退款
