业务功能规划

更新日期：2026-05-31。

本文以当前代码为准，整合 WinTradeCloudService、admin、client、ops、h5 的业务能力。

平台定位

本项目是面向跨境贸易的多商户商城与履约平台。平台通过一个后端服务承接多个前端端口：

平台的业务核心不是单一商城前台，而是“商品交易 + 商户经营 + 跨境履约 + 多角色协同”。消费者侧完成购买，商户侧完成经营和发货，平台侧完成规则、审核和监管，仓配侧完成包裹流转，系统侧用权限、消息、状态机和基础数据把流程串起来。

代码依据

业务主线

后端业务原则

当前后端代码把核心业务原则放在领域 Service 和 Component 中，前端负责展示和触发动作。

角色划分

业务域规划

账号与权限

• 平台支持用户账户、个人账户、企业账户、政府账户、商户账户和员工账户。
• 平台管理端使用账号密码登录、验证码、路由菜单和权限编码控制访问。
• 消费者小程序支持微信登录，未绑定手机号时需要先完成手机号绑定。
• 权限模型以菜单、角色、权限标识和用户关系为核心，前端负责菜单与按钮控制，后端负责接口权限校验。

业务边界：

登录流程上，admin 和 ops 以账号密码登录为主，client 同时支持微信登录。微信登录未绑定手机号时，前端不得写入完整登录态，需要先完成手机号授权绑定。

商品与店铺

• 平台维护商品类目、品牌、属性、属性值、SPU、SKU 和价格策略。
• 商户通过店铺上架能力将 SKU 绑定到店铺售卖，平台可进行上架审核。
• 消费者侧展示商品首页、分类、商品列表、商品详情、店铺主页和店铺列表。
• 商品评价、评价回复、敏感词和黑名单由后端提供接口，平台和商户侧共同治理。

商品供给流程：

1. 平台配置类目、品牌、属性和属性值。
2. 商户或平台维护 SPU 基础资料、详情和图片。
3. 商户或平台维护 SKU，确认规格、价格、库存关联和可售状态。
4. 商户将 SKU 提交到店铺上架。
5. 平台进行上架审核，审核通过后商品对消费者可见。
6. 消费者浏览、收藏、评价，商户可在商户侧处理评价回复。

商品展示侧需要统一价格口径。消费者看到的价格应优先来自店铺上架和价格策略计算结果，不能直接展示后台录入的原始成本或非售卖价。

购物车、交易与支付

• 消费者可将 SKU 加入购物车，按购物车或直接购买创建订单。
• 订单链路包含订单预创建、正式创建、支付、取消、确认完成、退货申请。
• 平台端负责订单查询和异常处理，商户端负责商户订单和退货确认。
• 当前小程序已接入订单列表、订单详情、订单确认、支付结果和物流详情页面。

标准下单流程：

1. 消费者从商品详情或购物车进入订单确认页。
2. 前端带上 SKU、数量、地址和客户类型请求预创建接口。
3. 后端返回价格、运费、优惠和订单校验结果。
4. 消费者确认后创建正式订单。
5. 支付接口处理余额或第三方支付结果，订单进入待发货。
6. 商户或平台进入发货链路。
7. 消费者可在订单详情查看物流，签收后确认完成或申请售后。

订单侧需要重点保证金额精度、库存扣减、运费计算、支付幂等和状态流转一致。前端金额展示使用 Big.js，后端应保持金额字段语义稳定。

物流履约

• 物流域包含发货单、发货明细、包裹、包裹类型、包裹件级单元、车次、批次、运单、轨迹、退货单、报关单。
• 仓作业分为入库、库存查询、库存操作、仓中转、仓派送和配送员工作台。
• ops 当前提供商户发货、仓库作业、海外仓作业和配送员任务页面。
• 海外仓不是独立接口集合，当前使用 /api/v1/logistics/warehouse/... 通用仓接口，由后端场景组件校验仓库 abroad = true。
• 当前代码中，仓派送加包允许同仓的 ARRIVED 或 STORED 包裹，但要求 reviewed = true，并校验当前仓、库位和目的地区。INBOUND 包裹必须先完成复核后再进入派送。

海外仓当前作业流程：

1. 仓库管理员选择海外仓。
2. 按车次查询待入库数据，并确认车次到仓。
3. 按批次号、包裹号、内部运单号或第三方运单号进行入库预查询。
4. 满足条件后执行正式入库。
5. 入库后执行仓内复核，将包裹变成已复核库存。
6. 后续根据目的地和路线进入仓中转或仓派送。
7. 派送场景中，仓库管理员创建派送上下文、分拣加包、完成分拣并分配配送员。
8. 配送员在任务页执行签收、失败上报或失败件退仓。

物流域的业务判断应以后端返回为准。前端只做必要的字段完整性提示，不自行复制后端状态机逻辑。

商户与结算

• 商户域包含商户账户、商户资质文件、店铺、商户仓库、商户库存、库存流水。
• 结算域包含佣金策略、策略历史、商户钱包、保证金钱包、提现申请、结算批次、结算单、结算明细和结算汇总。
• 平台端负责策略和结算管理，商户侧主要查看自身钱包、提现、结算单和明细。

结算流程建议按以下业务口径维护：

1. 交易订单完成后形成可结算业务数据。
2. 系统按佣金策略和店铺绑定关系计算平台佣金。
3. 平台执行结算批次，生成商户结算单和明细。
4. 商户查看钱包、结算单和结算明细。
5. 商户发起提现申请。
6. 平台审核、驳回或打款，并同步钱包流水。

营销与消息

• 营销域已从 Banner、广告位和公告扩展为营销活动中心，覆盖平台活动、商户活动、活动范围、优惠券、券池、活动价、预算池、成本日报、补贴确认和补贴结算推进。
• 消费者侧新增个人卡券钱包，支持查询卡券、卡券流水、可领取平台券、可领取商户券、领取平台券和领取商户券。
• 订单链路已接入优惠券，支持购物车订单和单商品订单的可用券查询、带券试算、创建时锁券、支付时用券、取消或超时时释放。
• 商品当前价格计算已接入平台活动价和商户活动价，价格展示应以后端当前价格接口为准。
• 活动 H5 已提供 61 和 618 两套静态会场资源，根路径默认跳转 618，接口通过 /api/v1 代理到客户端服务。
• 消息域覆盖模板、内容、路由规则、订阅、偏好、站内信、派发计划、派发日志、统计和待办。
• 个人、商户和员工分别有自己的消息、偏好和待办入口；个人消息订阅已细化为 SKU 到货、SKU 降价、店铺上新和订阅分页。

营销活动中心业务对象：

营销活动中心的业务边界：

平台营销推荐运营闭环：

1. 运营创建平台活动，确认活动时间、活动说明和适用市场。
2. 运营绑定参与店铺和 SKU，避免活动影响不相关商品。
3. 运营配置平台券或活动价，明确优惠规则、发放时间、预算池和成本承担方。
4. 财务或运营给平台活动预算池充值。
5. 活动启动后，消费者可领券或商品价格命中活动价。
6. 消费者带券下单并支付，系统生成用券记录、分摊记录、预算流水和补贴确认数据。
7. 活动期间，运营查看成本日报、预算流水和低预算预警。
8. 活动结束后，运营处理补贴确认、剩余预算退回、结算后调整和活动归档。

商户营销推荐运营闭环：

1. 商户创建店铺活动，选择活动时间和参与店铺。
2. 商户绑定参与 SKU，设置商户券或商户活动价。
3. 商户从钱包给活动预算池充值。
4. 活动启动后，消费者在商户店铺内领券或享受活动价。
5. 订单支付后，系统按商户承担金额记录成本、预算使用和分摊数据。
6. 商户查看用券记录、活动价分摊、预算流水和成本日报。
7. 活动结束后，商户核对补贴记录和结算推进结果。

标准优惠券下单流程：

1. 消费者进入订单确认页，后端返回商品价格、运费和基础应付金额。
2. 消费者查询订单可用券，选择平台券和商户券。
3. 前端提交订单预览或创建请求时传入 platformCouponWalletItemId 和 merchantCouponWalletItems。
4. 后端在试算结果中写入优惠券优惠金额、平台承担金额、商户承担金额和商户结算基数。
5. 创建正式订单时锁定优惠券。
6. 支付成功后将优惠券标记为已使用，并生成用券记录、分摊记录和待确认补贴。
7. 订单取消、支付失败、待支付超时或退款完成时，系统释放或治理对应优惠券和补贴数据。

订单营销金额关系：

营销与结算的衔接点：

消息与待办应服务于业务动作，而不是只作为独立信息流。建议优先覆盖以下事件：

营销消息建议按事件优先级分层：

系统基础资料

• 系统基础资料包含地区、组织、币种、字典、语言、参数配置、物流公司、区域城市映射、运费规则。
• 文件能力包含文件上传、预签名上传、访问 URL、文件夹、移动、复制和删除。
• 监控能力包含服务器监控、缓存监控、登录日志、操作日志和在线用户。

多端功能矩阵

当前阶段重点

1. 交易闭环：商品上架、消费者下单、支付、商户发货、物流跟踪、确认收货、售后和评价需要保持端到端可用。
2. 物流闭环：将 admin 的物流管理能力与 ops 的仓内操作能力对齐，重点验证海外仓入库、复核、中转、派送和退仓恢复链路。
3. 商户闭环：补齐商户店铺、库存、发货、钱包、提现、佣金、结算的业务说明和页面入口。
4. 营销闭环：平台活动、商户活动、领券、下单用券、预算核算、成本日报、补贴确认和结算推进需要端到端联调。
5. 消息闭环：订单、审核、发货、售后、结算、优惠券过期、预算预警和补贴确认等关键业务事件应通过消息和待办触达对应角色。
6. 文档维护：业务规划只描述业务目标和多端职责，接口细节统一维护在 doc/API。

营销闭环当前建议优先验收以下 6 条链路：

阶段规划

业务风险与待确认事项

营销联调数据建议

营销功能依赖活动、店铺、SKU、用户、钱包、预算和订单等多类数据。联调前建议准备一组最小可用数据。

联调期间建议保留以下证据，便于排查金额问题：