云灵汐涉旅电商分销子系统

PC端订单履约全链路管理中心 - 产品需求文档 PRD v1.0

版本:v1.0 日期:2026-07-06 状态:定稿 密级:内部机密

1文档概述

本文档为云灵汐涉旅电商分销子系统PC端订单履约全链路管理中心的产品需求文档(PRD v1.0),覆盖从C端用户下单、支付、订单生成,到平台/供应商/分销商三端协同处理订单、预约、核销、发货、售后、发票、评价的全生命周期。订单履约中心是连接前端交易与后端供应链的核心枢纽,直接影响用户体验、供应商营收和平台资金流转效率。文档面向前端开发工程师、后端开发工程师、测试工程师及产品经理,可直接作为开发和测试依据。

术语定义

术语定义
订单(Order)C端消费者通过平台或分销商渠道提交的商品购买请求,包含商品明细、价格、收货/使用人信息
子订单(OrderItem)主订单内单个SKU+使用人的购买记录,一个主订单可包含多个子订单(多SKU/多使用人)
核销(Verification)针对虚拟商品(门票、酒店、包车)的到店/到场消费确认动作,核销后订单进入已完成状态
预约(Booking)针对需指定日期消费的商品(如酒店入住、景区门票),买家支付后选择具体使用日期的操作
售后单(AfterSale)买家发起的退款/退货退款申请,经供应商一审、平台终审后完成资金退回
分账(Split)订单核销后,系统将商品成交金额按规则拆分为平台服务费、供应商货款、个体分销商佣金(C端推广订单)的账务操作。B端采购订单无分销商佣金、无差价利润,仅产生平台服务费和供应商货款
逆向分账(Reverse Split)售后退款时,按原分账路径从各方待结算账户中扣回资金的逆向操作
核销码虚拟商品子订单的消费凭证码。一单一码:一个子订单生成一个统一核销码,整单一次性核销;一票一码:每个使用人/每张票生成一个独立核销码,支持部分核销/部分退改
行级隔离后端查询订单数据时,根据tenant_type+tenant_id自动拼接WHERE条件的数据权限机制
列级脱敏对敏感字段(手机号、身份证号)进行部分隐藏(如138****1234)的展示控制机制
日历库存按日期维度管理的库存模型,包含总库存、锁定库存、已售库存、可售库存四个字段
实物商品需要物流配送的文创商品等,区别于虚拟商品的核销履约方式
虚拟商品无需物流配送、通过预约+核销完成履约的商品类型,包括门票、酒店、包车、套餐
自提订单买家选择到供应商指定门店自提的履约方式,无需物流配送
自动取消订单创建后超过支付时限(默认30分钟)未支付,系统自动取消并释放库存
超卖实际售出数量超过可用库存的情况,系统通过乐观锁机制严格禁止超卖发生

价格术语定义

术语定义使用场景是否参与结算
市场价商品展示用划线价C端/H5/商品详情展示否
平台销售价商品在平台 C 端销售给用户的默认售价,作为 C端成交价的默认值平台自营商城、C端商品详情、C端订单是,作为 C端成交价默认值
底价(= 分销采购价)B端/OTA 采购该商品时的成交价B端采购、OTA采购、组合产品引用底层资源是,作为 B端/OTA订单成交价
供应商结算基准价平台与底层资源供应商结算的基础价格,等于订单/子商品的实际成交价;C端为平台销售价扣减优惠后的成交价,B端/OTA为底价分账、对账、清分结算是
供应商实收价成交价扣除平台服务费、应由供应商承担的个体佣金、退款冲减、通道费等后的金额结算单、打款单是
个体佣金个体分销商推广成交后,按成交价 × 佣金比例计算的佣金;运费不计入佣金基数个体分销订单、佣金记录、提现是
平台服务费平台按成交价 × 平台服务费率收取的服务费;运费不计入服务费基数所有订单是
最高对外销售价(限价)分销商对 C 端公开售卖时允许的最高价格价格风控、OTA推送价校验、B端外部售卖监管不直接结算,只做风控
成交价订单/子商品的实际成交单价;C端为平台销售价扣减优惠券、满减等活动优惠后的金额(积分不可抵扣订单金额);B端/OTA为底价C端订单、OTA订单、组合产品订单是
支付金额用户或B端本次实际支付金额 = ∑成交价 × 数量 + 运费支付流水是
应结金额按结算规则计算出的应结算金额对账、结算是
实结金额扣除退款、手续费、服务费、佣金、差异调整后的最终打款金额清分结算、打款是
关键约束:
  • 底价 = 分销采购价 = B端/OTA采购下单价。
  • B端分销商以底价采购商品主要用于自身经营消费,不走佣金模式,单商品采购无差价利润;具备供应商身份时创建组合套餐对外销售,套餐溢价收益 = 套餐售价 - ∑子商品成交价 - 套餐平台服务费。
  • 个体分销商不采购商品,走推广佣金模式。
  • 限价不是 B端采购下单校验项,仅用于分销商对外销售价格监管。

2需求背景

2.1 业务痛点

  • 多供应商订单履约协同混乱:一个订单包含多个供应商商品时,各供应商独立履约(各自核销/发货),但C端用户看到的是统一订单,需要系统清晰拆分和展示各子订单履约状态
  • 虚拟商品与实物商品履约方式差异大:门票/酒店需要预约+核销,文创商品需要发货+物流追踪,系统需支持多种履约路径的统一管理
  • 三端数据权限边界模糊:平台运营、供应商、分销商三方都需要查看订单,但能看到的数据范围完全不同,现有系统缺乏精细化的行级+列级权限控制
  • 售后退款与分账回滚复杂:已分账订单发生退款时,需要从平台服务费、供应商货款、分销商佣金三方逆向扣回资金,涉及资金安全和合规要求,流程必须严谨闭环

2.2 现状问题

  • 订单状态不透明:用户无法清晰查看订单内各商品的履约进度(如酒店已预约但门票未核销),缺乏子订单级状态追踪
  • 库存扣减与释放不同步:支付超时、退款等场景下库存释放不及时,导致可用库存与实际库存偏差,影响销售
  • 售后处理效率低:供应商一审后平台终审的流程缺乏线上化支撑,退款周期长达7-15天,用户投诉率高
  • 发票管理分散:各供应商独立处理发票申请,平台无法统一监管开票时效,超期未开票无预警机制

2.3 设计目标

  • 全链路可视化:从下单到售后,每个环节的状态、时间、操作人都在系统中留痕,三端用户可实时查看
  • 三端权限精细化:通过RBAC+租户隔离+列级脱敏,确保平台/供应商/分销商各自看到应看的数据,敏感字段不脱敏不可见
  • 资金操作合规:所有退款从平台监管账户原路退回,分账/逆向分账全流程留痕,支持审计追溯
  • 履约自动化:支付超时自动取消、核销状态自动流转、分账自动触发,减少人工干预

3目标与范围

3.1 核心设计原则

3.2 功能边界

范围做(In Scope)不做(Out of Scope)
订单处理订单列表查询、详情查看、子订单状态追踪、订单导出、订单时间轴C端下单流程(在C端交易PRD中定义)、支付网关对接(在支付中心PRD中定义)
预约管理预约日期修改、超时未预约提醒、代客预约、日历库存校验预约日历的UI展示(在C端商品详情页定义)、第三方日历系统对接
核销管理核销码生成、核销员管理、扫码核销、核销记录查询、部分核销移动端核销APP(独立项目)、硬件POS机对接
发货管理物流信息录入、物流轨迹查询、发货状态同步、批量发货物流API对接(在供应链管理中心定义)、仓储WMS系统
售后管理退款/退货退款申请处理、供应商一审、平台终审仲裁、退款执行C端售后申请页面(在C端交易PRD中定义)、线下退货物流
发票管理发票申请查看、电子发票上传、发票红冲、开票时效预警电子发票PDF生成(调用第三方服务)、税控系统对接
评价管理评价列表查看、评价回复、好评率统计、评价导出C端评价提交页面、评价内容审核(在内容管理中定义)

3.3 上下游模块关系

上游模块交互方向数据/交互内容
C端交易系统上游 → 本模块用户下单后生成订单主表和子订单表数据;支付成功后更新订单支付状态和支付时间
支付中心上游 → 本模块支付成功回调(更新订单状态、触发库存锁定转 sold_stock);退款成功回调(更新售后单状态)
分销中心上游 → 本模块分销商推广参数(distributor_id, channel_id)随订单写入;佣金规则在分账时调用
商家供应链上游 → 本模块商品SPU/SKU信息、日历库存数据、供应商信息;发货时调用物流接口
财务清分结算双向交互订单核销后触发分账;售后退款时触发逆向分账;提现审核状态同步
权限中心上游 → 本模块用户角色权限、数据权限范围(tenant_type/tenant_id)、菜单权限
消息通知中心本模块 → 下游订单状态变更时触发短信/站内信/推送通知(如发货通知、核销成功通知)

4用户与角色

订单履约中心涉及7个核心角色,分布在平台运营后台、供应商后台、分销商后台三端。每个角色的数据权限范围、可操作功能均有明确边界,通过RBAC+租户隔离实现精细化控制。

角色所属后台数据权限范围核心操作
平台订单运营平台运营后台全平台所有订单、售后、发票、评价数据查看全部订单及详情;处理退款终审/仲裁;监管发票开具时效;查看全量评价并回复;订单导出
平台客服专员平台运营后台全平台订单数据(只读为主)查看订单详情及时间轴;协助用户查询订单状态;代客发起售后申请;查看手机号明文(需二次认证)
供应商管理员供应商后台包含本供应商SKU的订单、售后、发票、评价查看归属订单;处理核销/发货;处理售后一审;上传电子发票;回复评价;修改预约日期
供应商核销员供应商后台/移动端被分配的可核销订单扫码/手动输入核销码进行核销;查看核销记录;不可查看订单金额等敏感信息
B端分销商管理员分销商后台通过本租户渠道产生的订单查看本租户渠道订单及佣金数据;查看售后单(只读);查看结算对账单
B端分销商采购员分销商后台本人采购的订单查看本人采购订单;查看物流轨迹;申请售后(仅限本人采购订单)
个体分销商分销商后台(简化版)通过本人推广链接产生的订单查看推广订单及对应佣金;查看售后单(只读,用于统计退款扣佣影响)
关键约束:
  • 供应商管理员只能操作包含自己supplier_id的订单子订单,多供应商订单中仅可操作归属自己的子订单
  • 分销商仅可查看订单,无任何履约操作权限(发货/核销/退款等均不可操作)
  • 供应商核销员是独立角色,由供应商管理员在核销员管理模块中创建并分配权限,与系统用户账号体系隔离

5功能清单

订单履约全链路管理中心共包含7大功能模块、33个功能点,覆盖B端采购下单、订单处理、预约核销、发货物流、售后管理、发票评价、数据导出等全场景。

模块功能点功能描述使用角色
B端采购下单中心立即采购B端分销商在分销商城点击「立即采购」,进入单个商品下单页直接下单B端分销商
加入采购车B端分销商将商品加入采购车,可跨商品、跨供应商选购B端分销商
采购车下单采购车中多商品进入下单页,逐个商品填写下单信息后统一提交,按供应商拆主订单B端分销商
批量填写使用人信息团队采购多张实名制商品时,支持手动录入、Excel/CSV导入、AI智能填报三种方式批量录入多个使用人姓名、身份证、手机号B端分销商
余额支付使用实际余额全额支付,余额不足时不可支付,需先充值B端分销商
授信额度支付使用授信额度全额支付,额度不足时不可支付,需先申请调额B端分销商
在线支付通过微信/支付宝/第三方支付全额支付,一个订单仅支持一种支付方式B端分销商
余额明细查询查看实际余额、授信额度、余额变动时间轴,支持导出B端分销商
余额预警余额低于阈值时自动站内信提醒,阈值可自定义B端分销商
订单处理中心订单列表查询多条件组合搜索订单,支持订单号、手机号、商品名、状态、类型、时间范围、支付方式等维度筛选平台运营/供应商/分销商
订单详情查看查看订单全景信息,包含商品明细、支付明细、子订单履约状态、时间轴、操作日志平台运营/供应商/分销商
订单状态追踪子订单级履约状态实时追踪(待支付/支付中/已支付/已收单/履约中/已发货/已完成/已关闭/已退款/售后处理中/履约异常/OTA回传失败)平台运营/供应商/分销商
订单导出按筛选条件导出订单数据为Excel,大数据量时后台异步生成平台运营/供应商
订单取消/关闭平台运营可在特定场景下强制取消未履约订单(需填写原因)平台运营
订单备注管理为订单添加运营备注(内部可见),支持编辑和查看历史备注平台运营/供应商
预约核销中心预约管理查看待预约订单列表,修改预约日期,处理超时未预约订单,代客预约平台运营/供应商
核销员管理创建/编辑/删除核销员账号,分配核销权限范围供应商管理员
核销码管理查看核销码生成记录,查询核销状态,手动补核销平台运营/供应商
扫码核销PC端辅助输入核销码完成核销(主功能在移动端)供应商核销员
发货物流中心发货管理录入物流公司和运单号,批量发货,发货状态同步供应商管理员
物流轨迹查询对接物流API,在订单详情页展示物流时间轴平台运营/供应商/分销商
自提管理标记订单为自提状态,记录自提完成时间和操作人供应商管理员
售后管理中心售后单列表查看售后申请列表,按状态/类型/时间筛选平台运营/供应商/分销商
供应商一审供应商查看归属自己商品的售后单,执行同意/拒绝操作供应商管理员
平台终审仲裁平台运营处理争议售后单,可强制决定退款或驳回平台运营
退款执行审核通过后系统自动原路退款,记录退款流水系统自动
售后统计查看退款率、售后原因分布、处理时效等统计指标平台运营/供应商
发票评价中心发票申请列表查看发票申请列表,按状态筛选,超48小时未开票标黄预警平台运营/供应商
电子发票上传供应商上传PDF/OFD格式电子发票,系统自动关联订单供应商管理员
发票红冲红冲已上传发票,释放开票额度平台运营/供应商
评价管理查看评价列表,回复评价,查看好评率统计平台运营/供应商
系统支撑订单自动关闭支付超时(默认30分钟)自动取消订单并释放库存系统自动
库存联动下单锁定库存、支付转 sold_stock、取消/退款释放库存系统自动
分账触发核销成功后自动触发分账,拆分资金至各方待结算账户系统自动
消息通知订单状态变更时触发短信/站内信/推送通知系统自动

6系统架构

6.1 订单履约中心系统架构图

flowchart TB
subgraph Client["客户端层"]
  PC1["平台运营后台"]
  PC2["供应商后台"]
  PC3["分销商后台"]
  H5["C端H5/小程序"]
end
subgraph Gateway["网关与认证层"]
  GW["API Gateway"]
  JWT["JWT认证中间件"]
  RB["RBAC权限校验"]
  DP["数据权限拦截器\ntenant_type+tenant_id"]
end
subgraph Service["业务服务层"]
  S1["订单服务\nOrderService"]
  S2["预约服务\nBookingService"]
  S3["核销服务\nVerificationService"]
  S4["发货服务\nShippingService"]
  S5["售后服务\nAfterSaleService"]
  S6["发票服务\nInvoiceService"]
  S7["评价服务\nCommentService"]
  S8["库存服务\nInventoryService"]
  S9["分账服务\nSplitService"]
  S10["消息服务\nNotificationService"]
end
subgraph Data["数据存储层"]
  DB1[("订单库\nOrder DB")]
  DB2[("售后库\nAfterSale DB")]
  DB3[("库存库\nInventory DB")]
  DB4[("财务库\nFinance DB")]
  REDIS[("Redis\n缓存/锁")]
  MQ[("消息队列\nMQ")]
end
Client --> Gateway
GW --> JWT
JWT --> RB
RB --> DP
DP --> Service
S1 --> DB1
S2 --> DB3
S3 --> DB1
S4 --> DB1
S5 --> DB2
S6 --> DB2
S7 --> DB1
S8 --> DB3
S9 --> DB4
S10 --> MQ
S1 --> S8
S1 --> S9
S3 --> S9
S5 --> S9
S5 --> S8
S1 --> S10
S3 --> S10
S4 --> S10
S5 --> S10
S8 --> REDIS
    
图6-1:订单履约中心系统架构图
架构说明:订单服务为履约中心核心,与库存服务(库存扣减/释放)、分账服务(分账/逆向分账)、消息服务(状态通知)均有直接调用关系。库存服务通过Redis实现分布式乐观锁,防止超卖。所有资金操作(分账、退款)均通过分账服务统一处理,确保资金合规。

6.2 订单履约核心业务流程图

flowchart LR
A["C端下单"] --> B{"支付成功?"}
B -->|"否/超时"| C["自动取消订单"]
C --> D["释放锁定库存"]
B -->|"是"| E["订单状态:已支付"]
E --> F{"供应商接单?"}
F -->|"超时/拒绝"| C
F -->|"确认/自动"| G["订单状态:已收单"]
G --> H{"商品类型"}
H -->|"虚拟商品"| I["生成核销码"]
H -->|"实物商品"| J["进入发货流程"]
H -->|"需预约"| K["进入预约流程"]
K --> L{"超时未预约?"}
L -->|"是"| M["自动提醒/代客预约"]
L -->|"否"| N["预约成功"]
N --> I
I --> O["到店核销"]
J --> P["供应商发货"]
P --> Q["物流运输"]
Q --> R["买家签收"]
O --> S["核销成功"]
R --> S
S --> T["触发分账"]
T --> U["资金拆分至各方待结算"]
U --> V["进入T+N冻结期"]
V --> W["结算打款"]
E --> X{"买家申请售后?"}
X -->|"是"| Y["供应商一审"]
Y -->|"同意"| Z["平台终审"]
Y -->|"拒绝"| AA{"买家申请平台介入?"}
AA -->|"是"| AB["平台仲裁"]
AA -->|"否"| AC["售后关闭"]
AB -->|"同意退款"| AD["执行退款+逆向分账"]
Z -->|"同意"| AD
AB -->|"驳回"| AC
AD --> AE["退款原路退回"]
    
图6-2:订单履约核心业务流程图(从下单到结算/售后完整闭环)
关键说明:
  • 虚拟商品和实物商品在支付成功后分走不同履约路径,但最终都汇聚到"已完成"状态并触发分账
  • 需预约商品(酒店/门票)在收单后进入已收单状态,通过 booking_status 跟踪预约;预约成功后再生成核销码
  • 售后流程可在订单履约的任何阶段发起(未发货/未核销/已完成均可),但退款金额和方式因订单状态不同而有差异
  • 所有资金操作(分账、退款)均基于银行监管账户,平台不触碰资金

6.3 三端权限与数据隔离模型

维度平台运营端供应商端分销商端
菜单权限订单管理、售后管理、发票管理、评价管理、数据统计(全量)订单管理(仅归属订单)、售后管理(仅归属售后)、核销管理、发货管理、发票管理、评价管理订单列表(只读)、售后列表(只读)、结算对账
行级隔离WHERE 1=1(无限制)WHERE supplier_id IN (当前供应商关联的SKU列表)WHERE distributor_id = 当前分销商ID OR team_id = 当前分销商ID
列级控制所有字段可见,手机号可申请查看明文买家手机号脱敏,订单中其他供应商商品信息隐藏仅能看到订单基础信息和佣金数据,供应商信息脱敏
操作权限查看全部;处理退款终审/仲裁;强制取消订单;监管发票时效核销/发货/修改预约;处理售后一审;上传发票;回复评价只读,无任何操作权限
数据范围示例可查看全平台10000条订单仅可查看包含自己SKU的800条订单仅可查看自己渠道产生的120条订单

6.4 订单状态机总览

flowchart LR
A["待支付"] -->|"发起支付"| B["支付中"]
B -->|"支付成功"| C["已支付"]
B -->|"支付失败"| D["已关闭"]
A -->|"超时/取消"| D
C -->|"供应商确认接单"| E["已收单"]
C -->|"超时未接单/供应商拒单"| D
E -->|"开始履约但未全部完成"| F["履约中"]
E -->|"实物商品全部发货"| G["已发货"]
E -->|"虚拟/需预约商品全部完成"| H["已完成"]
F -->|"全部完成"| H
G -->|"签收/自提完成"| H
C -->|"申请退款"| I["售后处理中"]
E -->|"申请退款"| I
F -->|"申请退款"| I
G -->|"申请退款"| I
H -->|"申请退款"| I
I -->|"审核通过(退款)"| K["已退款"]
I -->|"审核驳回"| H
E -->|"预约/核销/发货异常"| J["履约异常"]
J -->|"重新履约"| E
J -->|"协商关闭"| D
    
图6-3:订单主状态机流转图
状态机约束:每个状态变更必须通过特定事件触发,禁止非法状态跳转。例如"已支付"不能直接变为"已关闭"(关闭必须由取消/超时/拒单事件触发);"已完成"不能回退到"已收单"。所有状态变更必须记录到t_order_status_log表。

7全局通用规则

7.1 订单编号生成规则

7.2 库存联动规则

业务场景库存操作详细逻辑
用户下单locked_stock +NC端提交订单时,库存服务对订单内每个SKU的对应日期执行locked_stock扣减。使用乐观锁(version字段)保证并发安全,超卖时返回"库存不足"
支付成功locked_stock -N
sold_stock +N
支付回调触发,将locked_stock中的数量转移至sold_stock。此操作必须在同一事务中完成
支付超时取消locked_stock -N定时任务每1分钟扫描expire_time < now且status=待支付的订单,自动取消并释放locked_stock
用户手动取消locked_stock -N待支付状态下用户主动取消,立即释放locked_stock
售后退款(未核销)locked_stock/sold_stock -N未核销订单退款时,若已支付未核销则释放sold_stock;若待支付则释放locked_stock
售后退款(已核销)不释放库存已核销订单退款不退库存(已消费),仅做资金退回
超卖防护:库存扣减必须使用乐观锁或分布式锁。推荐实现:UPDATE t_calendar_inventory SET locked_stock = locked_stock + ?, version = version + 1 WHERE sku_id = ? AND spec_date = ? AND version = ? AND (total_stock - locked_stock - sold_stock) >= ?。若影响行数为0,则返回库存不足。

7.3 支付超时与自动取消规则

7.4 敏感字段脱敏规则

字段脱敏规则查看明文条件操作留痕
买家手机号138****1234点击眼睛图标,输入当前账号密码验证通过后,60秒内可见明文记录到操作日志:用户ID、时间、查看的订单号、查看的字段
身份证号110**********1234同上,需二次认证同上
银行卡号6222****1234提现审核页面中,点击眼睛图标查看完整账号记录到操作日志
收货地址完整展示(不脱敏)无限制无需留痕

7.5 主订单与子订单拆分规则

7.6 支付方式规则

7.7 消息通知触发规则

触发场景通知对象通知渠道通知内容
订单支付成功买家站内信+短信"您的订单DDXXX已支付成功,请留意后续履约通知"
订单发货买家站内信+短信+微信推送"您的订单DDXXX已发货,物流公司:XX,运单号:XXX"
核销成功买家站内信+微信推送"您的XX商品已核销成功,祝您游玩愉快"
退款完成买家站内信+短信"您的退款申请已处理完成,退款金额XXX元已原路退回"
预约即将到期买家+供应商站内信+短信"您的预约即将到期,请尽快完成预约"
售后单状态变更买家+供应商站内信"您的售后单XXX已被XX处理,结果:同意/驳回"
发票已开具买家站内信+邮件"您的发票已开具,请查收邮件附件"

7.8 订单导出规则

7.9 价格口径与底价优先级规则

7.9.1 价格术语使用规范

为避免价格字段混用,PRD 中统一使用以下术语:B端/OTA 采购下单价统一称为底价(= 分销采购价),即B端/OTA订单的成交价;供应商结算基础价格称为供应商结算基准价,等于下单时子商品的实际成交价(C端为平台销售价扣减优惠后的成交价,B端/OTA为底价);分销商对外售卖监管价格称为限价(最高对外销售价)。

7.9.2 底价优先级规则

系统计算 B端/OTA 最终采购下单价(底价)时,按以下优先级取最精确、有效期内、状态启用的价格:

  1. 授权产品-指定分销商专属底价
  2. 授权产品-指定分销商分组底价
  3. 授权产品-指定渠道等级底价
  4. 商品SKU-指定分销商底价
  5. 商品SKU-渠道+等级底价
  6. 商品SKU-渠道默认底价
  7. 商品SKU基础分销采购价(底价)

7.9.3 底价补充规则

8全局页面流转说明

本章描述订单履约中心各功能模块之间的页面跳转关系,以及三端后台的页面结构。

8.1 平台运营后台页面结构

flowchart TB
 subgraph 订单管理["订单管理"]
    O1["订单列表"] --> O2["订单详情"]
    O2 --> O3["退款处理"]
    O2 --> O4["强制取消"]
    O2 --> O5["备注管理"]
  end
 subgraph 售后管理["售后管理"]
    A1["售后列表"] --> A2["售后详情"]
    A2 --> A3["仲裁处理"]
  end
 subgraph 发票管理["发票管理"]
    I1["发票列表"] --> I2["发票详情"]
    I2 --> I3["强制作废"]
  end
 subgraph 评价管理["评价管理"]
    C1["评价列表"] --> C2["评价详情"]
    C2 --> C3["回复评价"]
  end
 subgraph 数据中心["数据中心"]
    D1["订单统计"] --> D2["售后统计"]
    D2 --> D3["导出记录"]
  end
    
图8-1:平台运营后台页面流转图

8.2 供应商后台页面结构

flowchart TB
 subgraph 订单管理["订单管理"]
    O1["订单列表"] --> O2["订单详情"]
    O2 --> O3["发货"]
    O2 --> O4["修改预约"]
    O2 --> O5["备注"]
  end
 subgraph 核销管理["核销管理"]
    V1["核销员管理"] --> V2["核销记录"]
    V2 --> V3["扫码核销"]
  end
 subgraph 售后管理["售后管理"]
    A1["售后列表"] --> A2["售后详情"]
    A2 --> A3["同意/拒绝"]
  end
 subgraph 发票管理["发票管理"]
    I1["待开票列表"] --> I2["上传发票"]
    I2 --> I3["红冲发票"]
  end
 subgraph 评价管理["评价管理"]
    C1["评价列表"] --> C2["回复评价"]
  end
    
图8-2:供应商后台页面流转图

8.3 分销商后台页面结构

flowchart TB
 subgraph 订单查看["订单查看"]
    O1["订单列表(只读)"] --> O2["订单详情"]
  end
 subgraph 售后查看["售后查看"]
    A1["售后列表(只读)"] --> A2["售后详情"]
  end
 subgraph 数据中心["数据中心"]
    D1["推广订单统计"] --> D2["佣金结算单"]
  end
    
图8-3:分销商后台页面流转图(只读)

8.4 三端共用页面说明

页面三端差异说明
订单列表数据范围不同三端共用同一套列表UI组件,但后端返回的数据范围受tenant_type+tenant_id限制。列显示也有差异(供应商端不显示"供应商筛选"列)
订单详情操作按钮不同平台端显示"强制取消"、"退款处理"按钮;供应商端显示"发货"、"修改预约"按钮;分销商端隐藏所有操作按钮
售后列表操作权限不同平台端显示"仲裁"按钮;供应商端显示"处理"按钮;分销商端只读
评价列表数据范围不同平台端可回复全量评价;供应商端仅可回复归属自己商品的评价

9数据模型

9.1 ER关系图

erDiagram
    t_order ||--o{ t_order_item : contains
    t_order ||--o{ t_order_status_log : logs
    t_order_item ||--o| t_booking_record : books
    t_order_item ||--o| t_verification_record : verifies
    t_order ||--o{ t_after_sale : has
    t_order ||--o| t_invoice_application : invoices
    t_order_item ||--o{ t_comment : commented
    t_order ||--o{ t_order_remark : remarks
    t_order_item }o--|| t_product_sku : references
    t_order_item }o--|| t_product_spu : references
    t_calendar_inventory }o--|| t_product_sku : stocks
    t_after_sale ||--o{ t_payment_record : refunds
    t_order }o--|| t_user : buyer
    t_order }o--|| t_distributor : promoter
    t_after_sale }o--|| t_supplier : handler
    
图9-1:订单履约中心ER关系图

9.2 核心数据表结构

9.2.1 订单主表(t_order)

字段名数据类型约束说明
order_idbigintPK订单唯一ID
order_snvarchar(32)NOT NULL, UNIQUE订单号,格式:DD+YYYYMMdd+8位分布式ID
user_idbigintNOT NULL下单用户ID
distributor_idbigintNOT NULL, DEFAULT 0推广分销商ID(0表示平台直售)
channel_idbigintDEFAULT 0渠道ID(用于区分分销商的子渠道)
source_channeltinyintNOT NULL, DEFAULT 1订单来源渠道:1-平台自营,2-B端分销,3-OTA渠道,4-组合产品
settlement_idbigintNULL关联结算单ID(购物车整单支付时必填)
ota_channel_idbigintNULLOTA渠道ID(OTA订单必填)
ota_order_snvarchar(64)NULLOTA渠道方订单号(OTA订单必填)
ota_push_pricedecimal(10,2)NULLOTA推送价(OTA订单必填)
combo_product_idbigintNULL组合产品ID(组合产品订单必填)
combo_sale_pricedecimal(10,2)NULL组合产品成交价(组合产品订单必填)
combo_seller_idbigintNULL组合产品销售方ID(组合产品订单必填)
platform_service_feedecimal(10,2)DEFAULT 0.00平台服务费
price_sourcevarchar(100)NULL底价来源描述,例如「授权产品 / 指定分销商专属底价」
stock_lock_timedatetimeNULL库存锁定时间
reconciliation_statustinyintDEFAULT 0对账状态:0-未对账,1-已对账,2-对账差异。仅状态标记,对账逻辑详见财务PRD
order_statustinyintNOT NULL, DEFAULT 1订单状态:1-待支付,2-支付中,3-已支付,4-已收单,5-履约中,6-已发货,7-已完成,8-已关闭,9-已退款,10-售后处理中,11-履约异常,12-OTA回传失败
order_typetinyintNOT NULL, DEFAULT 1订单类型:1-普通订单,2-秒杀订单(仅表达C端营销活动类型)
total_amountdecimal(10,2)NOT NULL订单总金额:C端为平台销售价合计;B端/OTA为底价合计;组合产品为组合产品成交价
discount_amountdecimal(10,2)DEFAULT 0.00优惠金额(优惠券+活动减免)
freight_amountdecimal(10,2)DEFAULT 0.00运费金额
pay_amountdecimal(10,2)NOT NULL实付金额 = total_amount - discount_amount + freight_amount
pay_timedatetimeNULL支付时间
payment_methodtinyintNULL支付方式:1-微信支付,2-支付宝,3-余额支付,4-授信额度支付,5-第三方支付
payment_snvarchar(64)NULL第三方支付流水号
expire_timedatetimeNOT NULL自动取消时间(默认创建时间+30分钟)
cancel_reasonvarchar(200)NULL取消原因(用户填写或系统生成)
cancel_timedatetimeNULL取消时间
complete_timedatetimeNULL完成时间(所有子订单均完成后)
settlement_statustinyintDEFAULT 0结算状态:0-未结算,1-结算中,2-已结算,3-结算失败
is_auto_canceltinyintDEFAULT 1是否允许自动取消:1-是,0-否(如秒杀订单可配置不允许自动取消)
buyer_remarkvarchar(500)NULL买家留言
create_timedatetimeNOT NULL创建时间
update_timedatetimeNOT NULL最后修改时间
索引:idx_user_id(user_id), idx_distributor_id(distributor_id), idx_source_channel(source_channel), idx_settlement_id(settlement_id), idx_ota_channel_id(ota_channel_id), idx_combo_product_id(combo_product_id), idx_order_status(order_status), idx_order_sn(order_sn), idx_create_time(create_time), idx_pay_time(pay_time)

9.2.2 订单商品明细表(t_order_item)

字段名数据类型约束说明
order_item_idbigintPK子订单ID
order_idbigintNOT NULL, FK关联订单ID
spu_idbigintNOT NULL商品SPU ID
sku_idbigintNOT NULL商品SKU ID
supplier_idbigintNOT NULL供应商ID
sku_name_snapshotvarchar(100)NOT NULLSKU名称快照(冗余,防止商品修改后历史订单显示异常)
sku_image_snapshotvarchar(500)NULLSKU主图快照
price_snapshotdecimal(10,2)NOT NULL成交价快照:C端为平台销售价扣减优惠券、满减等活动优惠后的成交价(积分不可抵扣订单金额);B端/OTA/组合产品子商品为底价
settlement_base_price_snapshotdecimal(10,2)NULL供应商结算基准价快照,等于订单/子商品的实际成交价,用于分账/结算计算
market_price_snapshotdecimal(10,2)NULL市场价快照
platform_sale_price_snapshotdecimal(10,2)NULL平台销售价快照(C端订单必填)
base_price_snapshotdecimal(10,2)NULL底价快照(B端/OTA/组合产品子商品必填)
price_source_snapshotvarchar(100)NULL底价来源快照,例如「授权产品 / 指定分销商专属底价」
max_external_sale_price_snapshotdecimal(10,2)NULL最高对外销售价(限价)快照,用于风控留痕
quantityintNOT NULL, DEFAULT 1购买数量
total_amountdecimal(10,2)NOT NULL小计金额 = price_snapshot × quantity
item_statustinyintNOT NULL, DEFAULT 1子订单状态:1-待支付,2-支付中,3-已支付,4-已收单,5-履约中,6-已发货,7-已完成,8-已关闭,9-售后处理中,10-履约异常,11-OTA回传失败
refund_statustinyintDEFAULT 0退款状态:0-无售后,1-售后中,2-退款成功,3-退款失败。与item_status解耦,财务对账和退款统计以本字段为准
verification_codevarchar(32)NULL一单一码场景下的统一核销码;一票一码场景下可为空或存主码,独立码见 t_verification_code 表
verification_statustinyintDEFAULT 0核销状态:0-未核销,1-部分核销,2-全部核销
verification_timedatetimeNULL核销时间
shipping_statustinyintDEFAULT 0发货状态:0-未发货,1-已发货,2-已签收,3-自提完成
shipping_timedatetimeNULL发货时间
receive_timedatetimeNULL签收/自提完成时间
logistics_companyvarchar(50)NULL物流公司名称
logistics_novarchar(50)NULL物流运单号
refund_amountdecimal(10,2)DEFAULT 0.00已退款金额
is_commentedtinyintDEFAULT 0是否已评价:0-否,1-是
individual_commission_amountdecimal(10,2)NULL个体佣金金额 = 成交价 × 佣金比例(个体分销推广订单必填);运费不计入佣金基数
commission_statustinyintDEFAULT 0佣金/分账状态:0-未分账,1-已分账,2-分账失败,3-逆向分账
supplier_real_amountdecimal(10,2)NULL供应商实收价 = 成交价 - 平台服务费 - 应由供应商承担的个体佣金 - 退款冲减 - 其他扣费
platform_service_feedecimal(10,2)DEFAULT 0.00该子商品的平台服务费 = 成交价 × 平台服务费率;运费不计入服务费基数
combo_sub_product_idbigintNULL组合产品中子商品ID(组合产品子商品必填)
combo_sub_supplier_idbigintNULL组合产品中子商品供应商ID(组合产品子商品必填)
spec_datedateNULL预约/使用日期(日历库存商品必填)
booking_statustinyintDEFAULT 0预约状态:0-无需预约,1-待预约,2-已预约,3-预约超时
create_timedatetimeNOT NULL创建时间
update_timedatetimeNOT NULL最后修改时间
索引:idx_order_id(order_id), idx_sku_id(sku_id), idx_supplier_id(supplier_id), idx_item_status(item_status), idx_verification_code(verification_code)

9.2.3 核销码表(t_verification_code)

用于存储虚拟商品子订单的核销码,支持一单一码(一个子订单一个统一码)和一票一码(每个使用人/每张票一个独立码)两种模式。部分退改时,对应数量的核销码作废,剩余核销码保留可用。

字段名数据类型约束说明
code_idbigintPK核销码ID
order_item_idbigintNOT NULL关联子订单ID
verification_codevarchar(32)NOT NULL, UNIQUE12位数字核销码
statustinyintDEFAULT 0状态:0-未核销,1-已核销,2-已作废
verify_timedatetimeNULL核销时间
verify_user_idbigintNULL核销员ID
refund_relatedtinyintDEFAULT 0是否因退款作废:0-否,1-是
create_timedatetimeNOT NULL创建时间
update_timedatetimeNOT NULL最后修改时间
索引:idx_order_item_id(order_item_id), idx_verification_code(verification_code)

9.2.4 结算单表(t_settlement)

结算单用于聚合一次支付行为。当B端分销商通过采购车一次性采购多个供应商商品时,系统生成一个结算单,用户一次性支付后,再按供应商拆分为多个主订单。结算单号不对用户展示,仅用于系统内部关联支付流水与主订单。

字段名数据类型约束说明
settlement_idbigintPK结算单ID
settlement_snvarchar(32)NOT NULL, UNIQUE结算单号,内部使用,不对用户展示
buyer_idbigintNOT NULL下单主体ID(B端分销商ID或C端用户ID)
buyer_typetinyintNOT NULL下单主体类型:1-C端用户,2-B端分销商
total_amountdecimal(10,2)NOT NULL结算单商品总金额
discount_amountdecimal(10,2)DEFAULT 0.00优惠金额
pay_amountdecimal(10,2)NOT NULL实付金额
payment_methodtinyintNULL支付方式:1-微信,2-支付宝,3-余额,4-授信额度,5-第三方
payment_snvarchar(64)NULL第三方支付流水号
pay_timedatetimeNULL支付时间
statustinyintDEFAULT 0结算单状态:0-待支付,1-已支付,2-已关闭
expire_timedatetimeNOT NULL支付超时时间
create_timedatetimeNOT NULL创建时间
update_timedatetimeNOT NULL更新时间
索引:idx_settlement_sn(settlement_sn), idx_buyer_id(buyer_id), idx_status(status), idx_expire_time(expire_time)

9.2.4 订单状态变更日志表(t_order_status_log)

字段名数据类型约束说明
log_idbigintPK日志ID
order_idbigintNOT NULL订单ID
order_item_idbigintNULL子订单ID(主订单状态变更时为空)
from_statustinyintNOT NULL原状态
to_statustinyintNOT NULL新状态
operator_typetinyintNOT NULL操作者类型:1-系统,2-买家,3-供应商,4-平台运营
operator_idbigintNULL操作人ID
operator_namevarchar(50)NULL操作人名称(冗余,便于查看)
remarkvarchar(200)NULL变更原因/备注
create_timedatetimeNOT NULL变更时间

9.2.5 预约记录表(t_booking_record)

字段名数据类型约束说明
booking_idbigintPK预约ID
order_item_idbigintNOT NULL, FK关联子订单ID
booking_datedateNOT NULL预约游玩/入住日期
booking_timevarchar(20)NULL预约时段(如"10:00-12:00")
contact_namevarchar(50)NOT NULL预约人姓名
contact_mobilevarchar(20)NOT NULL预约人手机
id_card_novarchar(18)NULL身份证号(景区门票等场景)
statustinyintDEFAULT 1状态:1-待使用,2-已使用,3-已取消
cancel_timedatetimeNULL取消时间
operator_idbigintNULL操作人ID(代客预约时记录)
create_timedatetimeNOT NULL创建时间
update_timedatetimeNOT NULL最后修改时间

9.2.6 核销记录表(t_verification_record)

字段名数据类型约束说明
record_idbigintPK记录ID
order_item_idbigintNOT NULL, FK关联子订单ID
verifier_idbigintNOT NULL核销员ID
verifier_namevarchar(50)NOT NULL核销员名称
verification_codevarchar(32)NOT NULL核销码
verification_timedatetimeNOT NULL核销时间
verify_quantityintDEFAULT 1本次核销数量(支持部分核销)
device_infovarchar(100)NULL核销设备信息
create_timedatetimeNOT NULL创建时间

9.2.7 售后申请表(t_after_sale)

字段名数据类型约束说明
after_sale_idbigintPK售后单ID
after_sale_snvarchar(32)NOT NULL, UNIQUE售后单号,格式:SH+YYYYMMdd+6位流水
order_idbigintNOT NULL, FK关联订单ID
order_item_idbigintNOT NULL, FK关联子订单ID
user_idbigintNOT NULL申请人ID(买家)
supplier_idbigintNOT NULL归属供应商ID
apply_typetinyintNOT NULL售后类型:1-仅退款,2-退货退款
apply_reasonvarchar(200)NOT NULL退款原因
apply_amountdecimal(10,2)NOT NULL申请退款金额
evidence_urlsJSONNULL凭证图片URL数组
statustinyintDEFAULT 1售后状态:1-待供应商处理,2-供应商同意,3-供应商拒绝,4-平台介入中,5-平台同意退款,6-平台驳回,7-已退款,8-已关闭,9-退款失败
supplier_opinionvarchar(200)NULL供应商处理意见(驳回时必填)
supplier_handle_timedatetimeNULL供应商处理时间
platform_opinionvarchar(200)NULL平台仲裁意见
platform_handle_timedatetimeNULL平台处理时间
platform_handler_idbigintNULL平台处理人ID
refund_amountdecimal(10,2)DEFAULT 0.00实际退款金额
refund_timedatetimeNULL实际退款时间
refund_snvarchar(64)NULL退款流水号
is_reverse_splittinyintDEFAULT 0是否已执行逆向分账:0-否,1-是
create_timedatetimeNOT NULL创建时间
update_timedatetimeNOT NULL最后修改时间

9.2.8 退款记录表(t_refund_record)

字段名数据类型约束说明
record_idbigintPK记录ID
after_sale_idbigintNOT NULL, FK关联售后单ID
order_idbigintNOT NULL关联订单ID
refund_amountdecimal(10,2)NOT NULL退款金额
refund_typetinyintNOT NULL退款类型:1-原路退回,2-退至余额
refund_statustinyintDEFAULT 1退款状态:1-处理中,2-成功,3-失败
refund_snvarchar(64)NULL退款流水号
third_refund_snvarchar(64)NULL第三方退款流水号
fail_reasonvarchar(200)NULL失败原因
create_timedatetimeNOT NULL创建时间
complete_timedatetimeNULL完成时间

9.2.9 支付记录表(t_payment_record)

记录每笔支付与退款的独立流水。正向支付(payment_type=1)关联结算单;逆向退款(payment_type=2)关联售后单与退款记录。支付失败不归为终态,超时或取消后置为已关闭;退款失败时状态回到待退款,允许重试。

字段名数据类型约束说明
payment_idbigintPK支付记录ID
payment_snvarchar(32)NOT NULL, UNIQUE支付流水号
payment_typetinyintNOT NULL流水类型:1-支付,2-退款
settlement_idbigintNULL关联结算单ID(正向支付必填)
order_idbigintNULL关联主订单ID(冗余)
after_sale_idbigintNULL关联售后单ID(退款必填)
payment_methodtinyintNOT NULL支付方式:1-微信,2-支付宝,3-余额,4-授信额度,5-第三方
amountdecimal(10,2)NOT NULL支付/退款金额
statustinyintNOT NULL, DEFAULT 1支付状态:1-待支付,2-支付中,3-支付成功,4-已关闭;退款状态:5-待退款,6-退款中,7-退款成功
third_party_snvarchar(64)NULL第三方支付渠道流水号
fail_reasonvarchar(200)NULL失败原因(失败时记录)
create_timedatetimeNOT NULL创建时间
pay_timedatetimeNULL支付/退款成功时间
close_timedatetimeNULL关闭时间
索引:idx_payment_sn(payment_sn), idx_settlement_id(settlement_id), idx_order_id(order_id), idx_after_sale_id(after_sale_id), idx_status(status), idx_create_time(create_time)

9.2.10 发票申请表(t_invoice_application)

发票由供应商开具,按子订单维度管理。买家可对每个子订单申请发票,一个子订单可开一张发票。

字段名数据类型约束说明
invoice_idbigintPK发票ID
order_item_idbigintNOT NULL, FK关联子订单ID
order_idbigintNOT NULL关联订单ID(冗余,便于查询)
user_idbigintNOT NULL申请人ID
invoice_typetinyintNOT NULL发票类型:1-增值税普通发票(电子),2-增值税专用发票
title_typetinyintNOT NULL抬头类型:1-个人,2-企业
title_namevarchar(100)NOT NULL抬头名称
tax_novarchar(30)NULL税号(企业抬头必填)
emailvarchar(100)NOT NULL接收邮箱
file_urlvarchar(500)NULL电子发票PDF/OFD地址
statustinyintDEFAULT 1发票状态:1-待开票,2-已开票,3-已红冲
supplier_idbigintNOT NULL开票供应商ID
apply_timedatetimeNOT NULL申请时间
finish_timedatetimeNULL开票完成时间
cancel_timedatetimeNULL作废时间

9.2.11 评价表(t_comment)

字段名数据类型约束说明
comment_idbigintPK评价ID
order_item_idbigintNOT NULL, FK关联子订单ID
order_idbigintNOT NULL关联订单ID
user_idbigintNOT NULL评价用户ID
spu_idbigintNOT NULL商品SPU ID
supplier_idbigintNOT NULL供应商ID
ratingtinyintNOT NULL评分:1-5星
contenttextNULL评价内容
image_urlsJSONNULL评价图片URL数组
reply_contentvarchar(500)NULL商家回复内容
reply_timedatetimeNULL商家回复时间
is_anonymoustinyintDEFAULT 0是否匿名:0-否,1-是
statustinyintDEFAULT 1状态:1-正常,2-隐藏
create_timedatetimeNOT NULL创建时间

9.2.12 订单备注表(t_order_remark)

字段名数据类型约束说明
remark_idbigintPK备注ID
order_idbigintNOT NULL, FK关联订单ID
contentvarchar(500)NOT NULL备注内容
operator_idbigintNOT NULL操作人ID
operator_namevarchar(50)NOT NULL操作人名称
operator_typetinyintNOT NULL操作者类型:3-供应商,4-平台运营
create_timedatetimeNOT NULL创建时间

9.2.13 调价记录表(t_price_change_record)

记录市场价、实际售价、底价、限价、专属价等价格变更历史,满足价格变更留痕要求。字段与供应链管理中心PRD保持一致,分销中心价格变更同步写入本表。

字段名数据类型约束说明
record_idbigintPK AUTO_INCREMENT记录ID
tenant_typevarchar(20)NOT NULLPLATFORM/SUPPLIER/DISTRIBUTOR
tenant_idbigintNOT NULL租户ID
biz_typevarchar(50)NOT NULL业务对象类型:spu / sku / calendar_inventory / authorization / platform_limit
biz_idbigintNOT NULL业务对象ID
sku_idbigintNULLSKU ID,SKU或日历库存时填写
spec_datedateNULL日历库存日期,非日历场景为空
price_typevarchar(50)NOT NULL价格类型:market_price / sale_price / base_price / limit_price / exclusive_price
old_valuedecimal(12,2)NULL调整前价格,新建时为空
new_valuedecimal(12,2)NOT NULL调整后价格
change_reasonvarchar(500)NULL调价原因
sourcevarchar(50)DEFAULT 'manual'调价来源:manual手动 / import批量导入 / ai智能填报 / api同步
operator_idbigintNOT NULL操作人ID
operator_namevarchar(100)NULL操作人姓名
statusvarchar(20)DEFAULT 'effective'effective已生效 / pending待生效 / revoked已撤销
effective_timedatetimeNULL计划生效时间,为空表示即时生效
create_timedatetimeNOT NULL创建时间

9.2.14 SPU下单配置表(t_spu_order_config)

SPU下单配置表由供应链模块在商品发布时维护,订单模块在下单和核销时读取。一个SPU对应一条配置记录,通过spu_id关联t_spu主表。字段与供应链管理中心PRD保持一致,配置字段驱动下单页动态渲染和核销规则判断。

字段名数据类型约束说明
config_idbigintPK配置记录ID
spu_idbigintNOT NULL, UNIQUE关联商品SPU ID,一对一
is_show_buy_noticetinyintDEFAULT 1是否展示购买须知:1-展示,0-不展示
enable_skutinyintDEFAULT 1是否选择SKU规格:1-需要,0-无SKU直接购买
inventory_typevarchar(20)DEFAULT 'calendar'库存类型:calendar-日历库存;total_inventory-总库存
is_time_slot_enabledtinyintDEFAULT 0是否启用时段库存:1-是,0-否
advance_book_daysintDEFAULT 0提前预定天数:0=可订今日,1=需提前1天,N=需提前N天
advance_book_timevarchar(10)NULL提前预定截止时间
cutoff_timevarchar(10)DEFAULT '00:00'每日截止下单时间(如17:00),超过后不可订当日
order_time_startvarchar(10)NULL每日允许下单开始时间
order_time_endvarchar(10)NULL每日允许下单结束时间
sale_region_limit_enabledtinyintDEFAULT 0是否启用购买区域限制:1-是,0-否
sale_region_geojsonNULL购买区域GeoJSON多边形
group_guide_certificate_requiredtinyintDEFAULT 0团队订单是否需导游证件:1-是,0-否
group_guide_real_name_requiredtinyintDEFAULT 0团队订单是否需导游实名:1-是,0-否
group_itinerary_requiredtinyintDEFAULT 0团队订单是否需上传行程单:1-是,0-否
package_onlytinyintDEFAULT 0是否仅允许组合套餐引用:1-是,0-否
stock_modevarchar(20)DEFAULT 'independent'库存池模式:shared-共享库存;independent-独立控位
stock_warning_notify_modevarchar(100)DEFAULT 'site'库存预警通知方式:site站内 / sms短信 / email邮件,多选用逗号分隔
enable_real_nametinyintDEFAULT 0是否实名制:1-每个使用人需填写姓名/身份证/手机号,0-无需
require_certificatetinyintDEFAULT 0是否上传证件:1-下单时需上传证件图片(如教师资格证),0-无需
certificate_typevarchar(50)NULL证件类型标签:teacher/student/senior/soldier/guide等,多个用逗号分隔
require_guide_infotinyintDEFAULT 0是否填写导游信息:1-需填写导游姓名/导游证号/手机号,0-无需
require_itinerarytinyintDEFAULT 0是否上传行程单:1-下单时需上传行程单(PDF/图片),0-无需
verify_before_usetinyintDEFAULT 0与 manual_accept_order 等价:1-支付后进入待供应商确认收单状态,供应商确认收单(审核通过)后才可核销;0-无需
verification_typevarchar(20)DEFAULT 'one_ticket_one_code'核销方式:one_order_one_code-一单一码;one_ticket_one_code-一票一码;manual_confirm-手动确认;none-无需核销
allow_partial_usetinyintDEFAULT 1是否支持部分核销:1-支持(如10张核销3张剩余7张可用);0-不支持(必须整单核销)
auto_accept_ordertinyintDEFAULT 1是否自动收单:1-支付成功后自动进入已收单;0-不自动收单
manual_accept_ordertinyintDEFAULT 0是否手动收单:1-支付成功后保持已支付,等待供应商确认接单后进入已收单(与 verify_before_use 等价);0-否
create_timedatetimeNOT NULL创建时间
update_timedatetimeNOT NULL最后修改时间
下单页动态渲染逻辑:前端在下单页加载时,调用 /api/spu/order-config/{spu_id} 接口获取该SPU的t_spu_order_config配置。根据各配置字段的布尔值决定是否渲染对应的表单组件。例如 enable_real_name=1 时渲染实名信息表格,require_certificate=1 时在上传证件区展示文件上传组件。配置字段变更后,已发布的商品需要供应商重新提交审核才能生效。

9.2.15 AI填报任务表(ai_form_fill_task)

记录一次AI智能填报任务的元数据。任务在下单确认页/购物车商品实名信息区发起,订单尚未创建,因此target_object_id使用预下单标识或购物车标识;任务完成后保留30天用于审计追溯。

字段名数据类型约束说明
task_idbigintPK任务ID
task_snvarchar(32)NOT NULL, UNIQUE任务流水号,格式:AIT+YYYYMMdd+8位流水
tenant_idbigintNOT NULL租户ID
scenario_codevarchar(50)NOT NULL场景编码,固定为traveler_realname_fill
target_object_typevarchar(50)NOT NULL目标对象类型:pre_order_token(下单页)/ cart_item_id(购物车商品)
target_object_idvarchar(100)NOT NULL目标对象标识:预下单token或购物车商品记录ID
spu_idbigintNOT NULL关联商品SPU ID
source_typevarchar(20)NOT NULL输入来源:text/image/excel/pdf/docx/mixed
task_statustinyintNOT NULL, DEFAULT 1任务状态:1-识别中,2-识别完成,3-识别失败,4-已取消
created_bybigintNOT NULL创建人ID
created_atdatetimeNOT NULL创建时间
completed_atdatetimeNULL识别完成时间
ai_modelvarchar(50)NULL调用模型标识
quota_costintDEFAULT 0本次任务消耗的AI额度(按识别次数或页数计费)
error_codevarchar(50)NULL错误码
error_messagevarchar(500)NULL错误信息
retention_expire_atdatetimeNOT NULL临时数据保留过期时间,默认created_at+30天
create_timedatetimeNOT NULL创建时间
update_timedatetimeNOT NULL最后更新时间
索引:idx_task_sn(task_sn), idx_tenant_id(tenant_id), idx_target_object(target_object_type, target_object_id), idx_task_status(task_status), idx_retention_expire_at(retention_expire_at)

9.2.16 AI识别结果表(ai_form_fill_result)

存储AI识别出的单条结构化结果,供人工复核。确认导入后写入下单页实名信息表单;最终结果行保留30天用于审计。

字段名数据类型约束说明
result_idbigintPK结果ID
task_idbigintNOT NULL, FK关联任务ID
row_nointNOT NULL识别序号,同一任务内从1递增
raw_texttextNULL原始识别文本片段或OCR结果
structured_jsonJSONNOT NULLAI结构化字段JSON,包含traveler_name/gender/birthday/mobile/cert_type/cert_no/cert_expire_date等
confidence_jsonJSONNULL各字段识别置信度JSON
validation_jsonJSONNULL校验结果JSON:必填缺失、格式错误、证件号重复等
review_statustinyintNOT NULL, DEFAULT 1复核状态:1-待复核,2-已确认,3-已忽略,4-需补充,5-有冲突
reviewed_jsonJSONNULL人工复核修正后的字段JSON
import_statustinyintNOT NULL, DEFAULT 0导入状态:0-未导入,1-导入成功,2-导入失败
fail_reasonvarchar(500)NULL导入失败原因
reviewed_bybigintNULL复核人ID
reviewed_atdatetimeNULL复核时间
create_timedatetimeNOT NULL创建时间
update_timedatetimeNOT NULL最后更新时间
索引:idx_task_id(task_id), idx_review_status(review_status), idx_import_status(import_status)

9.2.17 租户AI额度表(ai_tenant_quota)

记录租户级AI智能填报可用额度,识别任务提交时扣减,额度不足时禁止提交。额度管理后台由系统管理模块维护。

字段名数据类型约束说明
quota_idbigintPK额度记录ID
tenant_idbigintNOT NULL, UNIQUE租户ID
quota_typetinyintNOT NULL, DEFAULT 1额度类型:1-按识别次数,2-按识别页数,3-按token数
total_quotabigintNOT NULL总额度
used_quotabigintNOT NULL, DEFAULT 0已用额度
reset_cycletinyintDEFAULT 0重置周期:0-一次性,1-按月,2-按年
reset_daytinyintDEFAULT 1重置日(如每月1日)
last_reset_atdatetimeNULL上次重置时间
statustinyintDEFAULT 1状态:1-启用,0-停用
create_timedatetimeNOT NULL创建时间
update_timedatetimeNOT NULL最后更新时间
索引:idx_tenant_id(tenant_id)

9.3 数据一致性约束

10B端分销商采购下单管理

B端分销商采购下单是订单履约链路的起点。分销商在PC端分销商城可通过两种方式下单:① 单个商品「立即采购」,直接进入该商品的下单页;② 多个商品「加入采购车」,统一进入下单页后逐个商品填写信息并一次性提交。本章覆盖从选品到支付完成的全链路交互。

与C端下单的本质区别:C端买家通过个体分销商推广链接下单,支付给平台后进入监管账户;B端分销商在分销商城自行采购,以自己的余额账户支付给平台,按底价采购后主要用于自身经营消费。B端分销商不走佣金模式,单商品采购无差价利润;具备供应商身份时可将所采购商品组合为套餐/线路对外销售并自行定价,套餐溢价扣除平台服务费后即为收益。

10.1 余额体系

10.1.1 余额分类

余额类型来源用途可提现有效期扣款优先级
实际余额线下充值(银行转账至平台监管账户),平台运营审核通过后入账采购下单消费不可提现(仅可消费)永久有效第一优先
授信额度平台/供应商授予的赊购额度,支持审批流程,可配置有效期采购下单消费不可提现按配置有效期,到期前7天提醒,到期自动回收第二优先(实际余额不足时自动使用)
冻结余额提现申请审核中、对账争议中的部分金额不可消费不可提现冻结期间不参与扣款

10.1.2 余额计算公式

可用余额 = 实际余额 + 授信额度 - 冻结余额。下单页显示余额明细:"本次消费将使用实际余额A元,授信额度B元"。

10.1.3 余额变动记录

10.2 采购下单核心流程

10.2.1 两种采购入口

入口适用场景流程
立即采购单个商品直接下单分销商城商品卡片点击「立即采购」→ 进入该商品下单页 → 填写信息 → 确认下单 → 支付
加入采购车多个商品统一结算商品卡片点击「加入采购车」→ 继续选购 → 点击「去结算」→ 进入下单页逐个商品填写信息 → 确认下单 → 一次性支付

10.2.2 核心业务逻辑

10.2.3 拆单规则

层级拆分依据说明
结算单一次「确认下单」行为内部单据,聚合一次支付,结算单号不对用户展示
主订单按 供应商 拆分不同供应商独立履约、结算、售后、发票
子订单按 SKU + 使用人 拆分最小履约和退款单元;实名制商品一个使用人一条子订单
示例:采购车中包含供应商A的黄山门票成人票×2张(实名制)和供应商B的千岛湖酒店×1晚。确认下单后生成 1 个结算单、2 个主订单、3 条子订单(黄山门票 2 条子订单各 1 人,酒店 1 条子订单)。

10.2.4 采购下单流程图

flowchart TD
  A["B端分销商浏览分销商城"] --> B{"选择采购方式"}
  B -->|"立即采购"| C1["进入单个商品下单页"]
  B -->|"加入采购车"| C2["继续选购多个商品"]
  C2 --> C3["点击去结算"]
  C3 --> C1
  C1 --> D["逐个商品填写下单信息"]
  D --> E["系统按底价优先级计算每个商品底价"]
  E --> F["展示当前生效价来源"]
  F --> G["确认下单"]
  G --> H["生成内部结算单"]
  H --> I["按供应商拆分主订单"]
  I --> J["按SKU+使用人拆分子订单"]
  J --> K["锁定库存"]
  K --> L["选择支付方式三选一"]
  L --> M["余额支付"]
  L --> N["授信额度支付"]
  L --> O["在线支付"]
  M --> M1{"余额充足?"}
  M1 -->|"是"| M2["扣减实际余额"]
  M1 -->|"否"| M3["选项置灰,提示去充值"]
  N --> N1{"额度充足且未过期?"}
  N1 -->|"是"| N2["扣减授信额度"]
  N1 -->|"否"| N3["选项置灰,提示申请调额"]
  O --> O1["拉起微信/支付宝收银台"]
  O1 --> O2{"支付结果?"}
  O2 -->|"成功"| P["支付成功"]
  O2 -->|"超时/取消/失败"| O3["结算单关闭,释放库存"]
  M2 --> P
  N2 --> P
  P --> Q["结算单状态:已支付"]
  Q --> R["主订单/子订单状态:已支付"]
  R --> AC{"供应商接单?"}
  AC -->|"确认/自动接单"| AD["状态:已收单"]
  AC -->|"超时/拒绝"| AG["订单关闭并退款"]
  AD --> AI{"履约进度?"}
  AI -->|"部分完成"| AJ["状态:履约中"]
  AI -->|"实物全部发货"| AK["状态:已发货"]
  AI -->|"全部完成"| AM["状态:已完成"]
  AJ -->|"全部完成"| AM
  AK -->|"签收/自提"| AM
  AM --> AN["发送履约完成通知"]
    
图10-1:B端分销商采购下单流程图

10.3 批量填写使用人信息

10.3.1 核心业务逻辑

10.3.2 批量填写使用人信息页-原型

图10-2:批量录入实名信息 - 团队采购10张门票
录入使用人信息(10人)
序号 姓名 * 身份证号 * 手机号 *
1
2
3
... 共10行,剩余7行省略展示 ...
身份证号 110101199001011234 重复录入,请检查

10.3.3 AI智能填报详细设计

10.3.3.1 功能定位

AI智能填报是批量填写使用人信息的第三种可选方式,与手动录入、Excel导入并行。用户在下单确认页或购物车结算页点击「AI智能填报」后,通过粘贴文本或上传图片/Excel/PDF/DOCX,由AI识别并结构化出姓名、身份证号、手机号等实名字段,再经人工复核确认后一键填入当前商品的实名信息表格。AI识别结果不直接写入业务表,必须经过人工确认。

10.3.3.2 触发入口

10.3.3.3 抽屉交互流程

点击「AI智能填报」后从右侧弹出大抽屉,分三步完成:

步骤页面区域用户操作系统行为
第一步:上传资料输入区选择「粘贴文本」或「上传文件」,可混合输入校验文件格式和大小;创建ai_form_fill_task任务记录并扣减租户AI额度
第二步:AI识别识别进度区等待识别完成调用AI服务进行OCR/文本抽取/结构化;将识别结果写入ai_form_fill_result;低置信度、缺失必填、格式错误、疑似重复的记录做标记
第三步:复核确认结果表格区查看识别结果、inline编辑、删除不需要的行、确认/忽略单条或全选校验所有「已确认」行;按证件号去重覆盖当前商品已填写的实名记录;确认后一键填入下单页实名信息表格

10.3.3.4 支持输入来源

输入方式支持格式处理说明
粘贴文本纯文本、表格文本、聊天记录直接送AI模型做NER抽取,识别姓名、身份证号、手机号等字段
上传图片JPG、PNG、HEIC先OCR识别文字,再送AI结构化;支持身份证照片、名单截图、微信截图等
上传表格XLSX、CSV上传后仍走AI识别流程,由AI做表头映射、字段清洗和非标格式识别
上传文档PDF、DOCX先提取文本/表格内容,再送AI结构化
混合输入文本 + 多附件同一任务可上传多个文件并粘贴文本,合并识别后统一返回结构化结果
文件限制:单个文件最大10MB;单次任务最多上传10个文件;图片类文件建议单张不超过5MB;Excel/CSV最大100行,超出部分截断并提示

10.3.3.5 识别字段与复核规则

字段名称字段编码是否必填AI来源人工可编辑校验规则
游客姓名traveler_name是文本/证件/表格是非空,2-20个字符
性别gender是身份证号/文本是男、女、未知
出生日期birthday是身份证号/证件图片是身份证可自动解析
手机号mobile是文本/表格是11位数字
证件类型cert_type是文本/证件图片是身份证、护照、港澳通行证、台胞证等
证件号码cert_no是文本/证件图片是按证件类型校验格式;同一商品内不允许重复
证件有效期cert_expire_date否证件图片/文本是早于出团/使用日期时提示风险

10.3.3.6 复核状态与视觉标识

状态说明视觉表现操作
待复核AI已返回结果,尚未确认默认白色背景可编辑、可删除、可确认、可忽略
已确认用户确认该条可填入行左侧绿色竖线仍可编辑;取消确认后回到待复核
已忽略用户不导入该条整行置灰可恢复为待复核
需补充必填字段缺失或格式错误缺失字段单元格标红补充正确后才能确认
有冲突证件号与当前商品已填写记录重复黄色背景,提示"将覆盖已有记录"确认后按证件号覆盖;忽略则跳过

10.3.3.7 覆盖规则

10.3.3.8 额度管理

10.3.3.9 安全与留痕

10.3.3.10 异常处理

异常场景前端提示处理方式
AI服务不可用AI服务暂时不可用,请稍后重试或使用批量导入/手动录入关闭抽屉,用户可继续使用其他两种录入方式
额度不足当前AI额度不足,请联系管理员提交按钮置灰,禁止创建任务
文件过大文件超过大小限制,请拆分后上传前端拦截,不上传
识别为空未识别到有效实名信息,请检查资料后重试允许重新上传或粘贴
字段缺失部分字段缺失,请补充后再导入缺失字段标红,补充后可确认
导入失败部分记录导入失败,请查看失败原因成功项填入表格,失败项保留在复核页可重试

10.3.3.11 AI填报状态字典

状态类型枚举值说明
AI任务状态
(ai_form_fill_task.task_status)
1-识别中任务已创建,AI正在处理
2-识别完成AI已返回全部识别结果
3-识别失败AI服务异常或识别异常
4-已取消用户主动取消任务
AI复核状态
(ai_form_fill_result.review_status)
1-待复核AI结果尚未人工确认
2-已确认用户确认该条可导入
3-已忽略用户不导入该条
4-需补充必填字段缺失或格式错误
5-有冲突证件号与当前商品已填记录重复
AI导入状态
(ai_form_fill_result.import_status)
0-未导入尚未执行填入
1-导入成功已成功填入下单页表格
2-导入失败填入失败,记录失败原因

10.3.3.12 核心接口

接口名称方法路径说明
创建AI填报任务POST/api/ai/form-fill/tasks创建任务,校验额度和权限,返回task_id
上传识别附件POST/api/ai/form-fill/tasks/{task_id}/files上传图片/Excel/PDF/DOCX等附件
提交识别POST/api/ai/form-fill/tasks/{task_id}/recognize触发AI识别,扣减额度
查询任务状态GET/api/ai/form-fill/tasks/{task_id}查询任务状态、进度、错误信息
查询识别结果GET/api/ai/form-fill/tasks/{task_id}/results获取结构化识别结果列表
更新复核结果PUT/api/ai/form-fill/tasks/{task_id}/results/{result_id}人工修改单条识别结果或变更复核状态
确认填入POST/api/ai/form-fill/tasks/{task_id}/confirm批量确认已复核结果,按证件号覆盖/新增后填入下单页表格
取消任务POST/api/ai/form-fill/tasks/{task_id}/cancel用户取消任务,不返还额度

10.4 下单页面极细交互说明

页面/组件用户动作系统行为备注
分销商城
商品卡片
点击"立即采购"跳转至单个商品下单页,URL为 /purchase/order?sku_id=XXX。页面加载时显示骨架屏,同时调用商品详情接口、底价查询接口和余额查询接口不可见商品或已下架商品不显示"立即采购"按钮
分销商城
商品卡片
点击"加入采购车"将商品加入采购车,Toast提示"已加入采购车"。若该商品已存在,数量+1已下架/不可见商品不显示"加入采购车"按钮
采购车页面查看采购车按供应商分组展示已加购商品,展示商品图、名称、规格、数量、单价、小计。支持修改数量、删除、清空采购车数据跨设备同步,登录后保留
采购车页面点击"去结算"携带采购车中所有商品进入下单页空采购车时按钮置灰
下单页
商品卡片区
逐个商品填写信息每个商品根据该SPU的t_spu_order_config配置独立渲染表单。不同商品区域可折叠/展开,填写错误时该区域标红SPU配置变更不影响已加购商品,以加购时的配置为准
下单页
SKU选择区
选择SKU规格展示SKU规格选项,选择后更新底价。库存为0的规格置灰不可选仅单选,不可多选不同规格
下单页
日历组件
选择日期和时段日历模式商品展示未来90天日历,可用日期绿色可选,已满日期灰色禁用,已过日期不显示。选中日期后展开时段选择日历组件调用库存服务实时查询available_stock
下单页
数量输入
输入购买数量普通商品输入数量,最小1,最大库存数。数量变更时实时计算小计金额。超过库存时输入框标红并提示"库存不足,最多N件"实名制商品数量=实名信息行数,自动联动
下单页
实名信息区
填写使用人姓名必填,非空校验。支持从常用联系人下拉选择自动填充姓名+身份证+手机号姓名字段限制2-20个字符
下单页
实名信息区
填写身份证号前端实时校验:18位,最后一位可为X。校验不通过时单元格边框变红。同一商品内重复身份证号标红提示"该身份证已录入"支持身份证OCR识别上传自动填充
下单页
实名信息区
填写手机号必填,前端校验11位数字。支持从常用联系人选择自动填充手机号输入框自动脱敏显示
下单页
实名信息区
点击"从Excel导入"弹出文件选择Dialog,支持.xlsx和.csv格式。解析后自动填充到表格中,解析失败时提示"文件格式错误,请检查列名(姓名、身份证号、手机号)"最大支持100行,超出截断并提示
下单页
实名信息区
点击"AI智能填报"打开右侧AI填报抽屉。校验租户AI额度和当前用户权限后初始化任务额度不足或权限不足时按钮置灰并提示原因
AI填报抽屉
资料上传
粘贴文本在文本框中粘贴名单/聊天记录等文本,点击「开始识别」后创建任务并提交识别文本长度限制5000字符
AI填报抽屉
资料上传
上传文件支持JPG/PNG/HEIC/XLSX/CSV/PDF/DOCX,最多10个文件。校验通过后上传至任务单个文件最大10MB,Excel/CSV最大100行
AI填报抽屉
识别结果
查看并编辑识别结果以表格展示AI识别结果,inline编辑任意字段。低置信度/缺失/格式错误/冲突行按规则标色身份证号、手机号默认脱敏展示,点击可查看完整内容
AI填报抽屉
识别结果
确认/忽略单条结果点击单行「确认」则review_status=2;点击「忽略」则review_status=3。已确认行可取消确认需补充字段未修正前不能确认
AI填报抽屉
识别结果
点击"确认填入"校验所有已确认行;按证件号去重,存在则覆盖当前商品已填记录,不存在则新增;校验通过行填入下单页实名信息表格部分失败时成功项填入,失败项保留抽屉内展示失败原因
下单页
购买须知
阅读并勾选同意is_show_buy_notice=1 时该商品区域顶部展示"购买须知"折叠面板,分销商需勾选"我已阅读并同意"后"确认下单"按钮才可用未勾选时点击"确认下单"提示"请先阅读并同意购买须知"
下单页
日历组件
选择日期inventory_type='calendar' 时渲染日历,advance_book_days>0 时近N天灰色不可选,cutoff_time之前允许订当日、之后仅允许订次日及以后日历数据实时调用库存服务查询 available_stock
下单页
证件上传
上传证件图片require_certificate=1 时在每个使用人信息后增加证件上传入口,certificate_type 决定前端展示证件名称。支持JPG/PNG,单张最大5MB,最多1张上传后前端预览,支付成功后供应商可在订单详情查看证件图片
下单页
导游信息
填写导游信息require_guide_info=1 时增加导游信息区:导游姓名(必填)、导游证号(必填)、手机号(必填,11位数字)导游信息与实名信息分开录入,不占用实名信息行数
下单页
行程单上传
上传行程单require_itinerary=1 时增加行程单上传入口,支持PDF/图片(JPG/PNG),最大10MB,最多上传3张上传后前端预览,支付成功后供应商可在订单详情查看/下载行程单
下单页
底价来源
查看商品价格每个商品展示当前生效底价及「当前生效价来源」,例如:来源:授权产品 / 指定分销商专属底价价格变更时重新进入下单页才生效,已填写信息保留
下单页
支付方式区
选择支付方式展示三种支付方式单选:
① 余额支付——显示实际余额XX元,余额充足时可选,不足时置灰并提示"余额不足,当前X元,需Y元"
② 授信额度支付——显示可用授信XX元,额度充足且未过期时可选,不足时置灰并提示"额度不足"
③ 在线支付——始终可选,显示微信/支付宝图标
三选一,不可同时选择多种
下单页点击"确认下单"1. 校验每个商品的必填信息完整(SKU、日期/时段、实名信息、证件、导游、行程单、购买须知)
2. 校验库存充足
3. 按底价优先级计算每个商品底价并生成价格快照
4. 生成内部结算单(待支付)
5. 按供应商拆分主订单,按SKU+使用人拆分子订单
6. 锁定库存
7. 进入支付页选择支付方式
8. 支付成功后主订单/子订单状态变为"已支付";供应商确认接单或自动接单后变为"已收单"
9. verify_before_use=1时进入"待审核"状态
任一校验不通过则阻止下单并滚动到第一个错误位置

10.5 下单页面原型

10.5.1 采购车页面原型

图10-3:B端分销商采购车页面
采购车(3件)
黄山旅游发展有限公司
商品图
黄山风景区门票-成人票
底价 ¥195.50
¥391.00
千岛湖度假酒店
商品图
千岛湖湖景大床房(含双早)
底价 ¥680.00
¥680.00
已选 3 件商品
¥1,071.00

10.5.2 下单页原型

图10-4:B端分销商采购下单页(多商品)
黄山旅游发展有限公司
商品图
黄山风景区门票-成人票
来源:授权产品 / 指定分销商专属底价
¥195.50
选择规格
成人票
儿童票
选择日期和时段 *
周一
07/15
周二
07/16
上午场 09:00-12:00
下午场 13:00-17:00
使用人信息 *
序号姓名身份证号手机号
1
2
+ 从Excel批量导入
千岛湖度假酒店
商品图
千岛湖湖景大床房(含双早)
来源:商品SKU / 渠道默认底价
¥680.00
入住日期 *
周一
07/15
周二
07/16
购买数量
选择支付方式 * (三选一,不可混用)
余额支付
当前实际余额 ¥5,000.00
余额充足
授信额度支付
可用授信额度 ¥2,000.00(有效期至2026-07-31)
额度充足
在线支付
微信 / 支付宝 / 第三方支付
共 3 件商品
¥1,071.00

10.6 采购下单状态说明表

结算单状态:结算单只用于支付聚合,状态如下:
状态码状态名称触发条件后续操作
0待支付点击"确认下单"后生成结算单,等待支付30分钟超时自动关闭
1已支付余额扣款成功/授信扣款成功/在线支付成功同步更新所有关联主订单/子订单为已支付,并触发收单流程
2已关闭支付超时/取消/失败或分销商手动关闭释放库存,如已扣款则原路退回
主订单/子订单核心状态流:待支付 → 支付中 → 已支付 → 已收单 → 履约中 → (实物)已发货 → 已完成;无资金往来关闭 → 已关闭;全额退款 → 已退款。B端采购订单的 source_channel=2。
注意:B端采购订单支付成功后,后续履约流程(发货/核销/售后/发票/评价)与C端订单共用同一套处理逻辑,参见第11-17章。区别在于:B端采购订单不走佣金模式,B端分销商以底价自采自用,单商品采购无差价利润;具备供应商身份时创建组合套餐对外销售,套餐溢价收益 = 套餐售价 - ∑子商品成交价 - 套餐平台服务费。

10.7 异常处理

异常场景现象处理方案
余额不足选择余额支付时,实际余额 < 结算单应付金额该支付方式选项置灰,提示"余额不足,当前余额X元,需Y元"。可点击"去充值"或切换其他支付方式
授信额度不足/过期授信额度 < 结算单金额或额度已到期选项置灰,提示"额度不足"或"授信额度已到期,请充值后下单"。可切换其他支付方式
部分商品库存不足购物车统一提交时,部分商品库存不足阻止整个结算单生成,在对应商品位置提示"库存不足,剩余N件"。分销商可修改数量或删除该商品后重新提交
余额扣款成功但库存扣减失败库存不足导致下单失败,但余额已扣立即回滚余额扣款,生成逆向流水记录。前端提示"库存不足,已退还余额"
授信扣款成功但库存扣减失败库存不足导致下单失败,但授信额度已扣立即回滚授信扣减,生成逆向流水记录。前端提示"库存不足,已恢复授信额度"
在线支付成功但库存扣减失败库存不足导致下单失败,但微信/支付宝已扣款立即调用支付渠道退款接口原路退回,提示"库存不足,已在线退款,1-3个工作日到账"
在线支付超时/失败微信/支付宝收银台30分钟内未完成支付,或支付渠道返回失败结算单状态回到"待支付"或"已关闭"(超过整单有效期后),主订单/子订单不生成或保持待支付。已扣款金额原路退回。提示"支付失败,请重新支付或取消"
收单超时手动收单/审核收单场景下,供应商超过超时时间(默认30分钟)未确认接单订单自动关闭并全额退款,关闭原因="收单超时"
供应商拒单供应商点击"拒绝接单"订单立即关闭并全额退款,关闭原因="供应商拒单"
实名信息不完整必填字段未填写或格式错误前端拦截提交,标红未填写/错误的字段,页面自动滚动到第一个错误位置
身份证号重复同一商品内录入重复身份证号重复行标红提示"该身份证已录入",阻止提交
Excel导入格式错误上传的Excel列名不符合要求提示"文件格式错误,请检查列名(姓名、身份证号、手机号)",允许重新上传
Excel导入行数超限Excel中包含超过100行的数据自动截断至100行,提示"仅导入前100人,超出部分已忽略"
商品已下架下单时商品已下架或已不可见页面加载时即提示"该商品已下架,无法下单",隐藏"确认下单"按钮
商品价格变更供应商在分销商下单前修改了底价页面加载时显示最新底价,如价格已变更提示"商品价格已更新"
批量录入超限购买数量超过100人数量输入框最大限制100,超限输入时提示"单次最多购买100人"
结算单支付成功但部分主订单生成失败分布式事务异常导致部分主订单未生成记录异常日志并触发告警,已成功生成的主订单正常履约,失败的主订单自动退款对应金额至分销商账户

11订单处理中心

订单处理中心是履约管理的核心入口,覆盖订单列表查询、详情查看、状态追踪、导出、强制取消、备注管理等全场景。三端用户(平台/供应商/分销商)共用同一套列表组件,但数据范围和操作权限严格隔离。

11.1 核心业务逻辑

11.2 极细交互说明

页面/组件用户动作系统行为备注
订单列表页
搜索栏
输入订单号点击搜索精确匹配order_sn,支持部分输入自动补全(输入DD2026后下拉提示匹配订单)订单号输入框只允许数字,前端过滤非数字字符
订单列表页
搜索栏
输入手机号搜索后端使用手机号模糊查询(LIKE '%尾号%'),供应商/分销商端仅搜索自己可见订单的买家手机号手机号输入框自动脱敏,输入完整11位后搜索
订单列表页
筛选区
选择"订单状态"筛选项下拉选项:待支付/支付中/已支付/已收单/履约中/已发货/已完成/已关闭/已退款/售后处理中/履约异常/OTA回传失败。多选支持不同角色看到的选项相同,但后端会根据角色过滤数据
订单列表页
快捷待办区
点击顶部快捷筛选项按钮:已支付/已收单/履约中/已发货/已退款/售后中。点击后按对应状态过滤列表并高亮当前选中按钮仅展示当前角色有权限处理且存在未结数据的待办状态;数量为0时按钮置灰并展示"0"
订单列表页
筛选区
选择"时间范围"快捷选项:今天/近7天/近30天/近90天/自定义。默认近30天自定义范围最多90天,超出时提示"时间范围不能超过90天"
订单列表页
筛选区
点击"导出"按钮如当前筛选结果<=5000条,直接下载Excel;如>5000条,Toast提示"后台生成中",后台异步生成后站内信通知导出字段包含脱敏手机号,不含明文。供应商导出仅含归属自己SKU的订单
订单列表页
列表行
点击订单号打开订单详情Drawer,从右侧滑入,宽度800px详情页加载时显示骨架屏,数据分4个Tab展示
订单详情页
Tab-商品信息
查看子订单列表展示每个子订单的SKU图片、名称、单价、数量、小计、履约状态、核销码(虚拟商品)。多供应商订单中,非当前供应商的子订单显示"其他供应商商品"供应商端仅展示归属自己supplier_id的子订单详情,其他子订单折叠显示
订单详情页
Tab-支付信息
查看支付明细展示订单金额、优惠金额、运费、实付金额、支付方式、支付时间、第三方流水号个体分销商端可查看佣金比例和预估佣金金额(基于 price_snapshot/成交价 与个体佣金规则计算);B端分销商端展示底价采购信息(单商品无差价利润);组合套餐另展示套餐溢价收益
订单详情页
Tab-履约信息
查看履约时间轴以时间轴形式展示订单全生命周期:下单→支付→收单→发货/预约/核销→完成。每个节点显示时间和操作人时间轴按子订单维度展示,支持展开/折叠各子订单的履约记录
订单详情页
操作按钮
点击"强制取消"弹出确认Dialog,要求输入取消原因(最少10字)。确认后:更新订单状态为"已关闭",释放库存,如已支付则触发退款流程仅平台订单运营角色可见此按钮。已核销/已完成的订单不显示"强制取消"
订单详情页
操作按钮
点击"添加备注"弹出输入框,输入备注内容(最多500字)。保存后备注按时间倒序展示在详情页底部平台运营和供应商管理员均可添加,买家不可见
订单详情页
敏感信息
点击手机号旁的"眼睛"图标弹出二次认证Dialog,要求输入当前账号密码。验证通过后,60秒内该页面手机号显示明文,过期后自动恢复脱敏查看明文操作记录到t_sensitive_view_log表

11.3 HTML/CSS内联原型

11.3.1 订单列表页原型

图11-1:平台运营端订单列表页原型

全部订单
待支付
支付中
已支付
已收单
履约中
已发货
已完成
已关闭
已退款
售后中
履约异常
OTA回传失败
订单号 手机号 商品名
订单状态 时间
订单号下单时间买家信息商品信息实付金额状态供应商分销商操作
DD20260706012345672026-07-06 14:30张三 138****1234西湖门票x2198.00已完成杭州文旅平台直售详情
DD20260706012345682026-07-06 15:10李四 139****5678灵隐寺门票x1+文创x1256.00已收单杭州文旅小王旅游详情
DD20260706012345692026-07-06 16:00王五 137****9012千岛湖酒店x1晚888.00已收单千岛湖度假平台直售详情
共 1,234 条 1 / 13

11.3.2 订单详情Drawer原型

图11-2:订单详情Drawer原型(平台运营端)

订单详情 DD2026070601234567

×
商品信息
支付信息
履约信息
操作日志
子订单列表
SKU图片商品名称SKU单价数量小计状态核销码
[图]西湖门票成人票99.002198.00已完成123456789012
收货/使用人信息
姓名:张三 | 手机:138****1234 👁 | 预约日期:2026-07-10

11.4 状态说明表

状态页面表现(Tag颜色)触发条件可执行操作
待支付蓝色Tag订单创建后未支付查看详情;平台可强制取消;用户可手动取消
支付中蓝色Tag用户发起在线支付,等待渠道回调查看详情;查询支付结果
已支付蓝色Tag支付成功回调触发,尚未收单查看详情;等待供应商收单;平台可特殊处理
已收单绿色Tag供应商已确认承接订单,等待履约(发货/预约/核销)查看详情;进入发货/预约/核销流程;买家可申请售后
履约中蓝色Tag部分子订单已开始履约(已发货/已预约/已部分核销),但尚未全部完成查看详情;查看子订单履约明细;买家可申请售后
已发货绿色Tag供应商已发货或自提标记完成查看详情;查看物流/自提信息;买家可申请售后
已完成绿色Tag所有子订单均发货/核销完成且无未结售后查看详情;触发分账;买家可评价;可申请售后(限定期内)
已关闭灰色Tag无资金往来的订单关闭:支付超时/用户取消/平台强制取消/供应商拒单/收单超时仅查看详情(只读)
已退款灰色Tag全部子订单退款成功,有资金原路退回查看详情;查看退款流水;财务对账
售后处理中橙色Tag买家发起售后申请后查看详情;供应商一审;平台终审仲裁
履约异常红色Tag预约/发货/核销/OTA回传等环节失败查看详情;人工特殊处理;可协商退款或重新履约
OTA回传失败红色TagOTA订单或状态回传接口失败查看详情;手动重试;重试成功后若尚未收单则进入"已收单",若已开始履约则进入"履约中";多次失败或确认无法回传后可人工关闭订单,状态变为"已关闭"

11.5 异常处理

异常场景前端表现后端处理用户可恢复操作
订单号不存在搜索后列表为空,提示"未找到匹配订单"返回空列表,HTTP 200检查订单号是否正确,重新输入
无权限查看订单点击详情后Toast提示"您无权查看该订单"根据tenant_type+tenant_id过滤,无权限返回HTTP 403联系平台运营确认订单归属
导出数据量过大Toast提示"数据量较大,将在后台生成后通知您下载"将导出任务放入MQ,后台异步生成Excel文件等待站内信通知,点击通知中的下载链接
强制取消已履约订单"强制取消"按钮灰色不可点击,hover提示"已履约订单不可强制取消"后端校验订单状态,已发货/已完成的订单拒绝取消请求引导用户走售后退款流程
二次认证失败Dialog提示"密码错误,请重试",3次失败后锁定1小时校验当前用户密码,错误次数记录到Redis,3次后锁定1小时后重试,或联系管理员重置密码
订单状态变更冲突Toast提示"订单状态已变更,请刷新后重试"更新前校验当前状态是否与预期一致,不一致返回冲突错误刷新页面查看最新状态后重新操作

12预约与核销管理

预约与核销管理针对虚拟商品(门票、酒店、包车、套餐)的履约场景。预约管理负责处理需指定日期消费的商品的日期选择和修改;核销管理负责线下到店消费的凭证验证和确认。

12.1 预约管理

12.1.1 核心业务逻辑

12.1.2 极细交互说明

页面/组件用户动作系统行为备注
预约管理页
列表
查看待预约订单展示所有booking_status=1的子订单,包含买家信息、商品名称、支付时间、剩余预约天数(倒计时)按剩余天数升序排列,剩余天数<3天的行标红预警
预约管理页
日历组件
点击"选择日期"弹出日历组件,展示未来90天日期。可用日期绿色可选,已满日期灰色禁用,已过日期不显示。选中日期后显示当日available_stock日历组件调用库存服务实时查询,避免超卖
预约管理页点击"确认预约"校验库存→扣减available_stock→更新booking_status=2→更新item_status=5(履约中)→生成核销码→发送预约成功通知库存扣减使用乐观锁,并发时如库存不足则提示"该日期库存不足,请选择其他日期"
预约管理页点击"修改预约"弹出日历组件,选择新日期。确认后:释放原日期库存→扣减新日期库存→更新booking_date每个子订单仅限修改1次,修改后按钮消失
预约管理页批量勾选+批量预约勾选多个待预约子订单,选择统一日期后点击"批量预约"。系统逐条校验库存,全部通过则全部预约成功;任一条库存不足则全部失败并提示具体商品批量操作使用事务,保证原子性
订单详情页查看预约信息展示预约人姓名、手机、身份证号、预约日期、时段、核销码身份证号默认脱敏,查看明文需二次认证

12.1.3 状态说明表

预约状态页面表现触发条件可执行操作
待预约橙色Tag,列表中显示倒计时日历商品支付成功后选择预约日期;修改预约(限1次);平台/供应商可代客预约
已预约绿色Tag选择日期并确认后查看预约详情;修改预约(限1次,如未核销);进入履约中状态
预约超时红色Tag支付后超过14天未预约平台运营可代客预约;或引导买家申请售后退款
已取消灰色Tag订单取消或退款后仅查看(只读)

12.2 核销管理

12.2.1 核心业务逻辑

12.2.2 极细交互说明

页面/组件用户动作系统行为备注
核销员管理页点击"新增核销员"弹出表单:姓名(必填)、手机号(必填,唯一校验)、可核销商品(多选,默认全部)。保存后生成核销员记录核销员手机号不可与系统用户手机号重复
核销员管理页点击"删除核销员"二次确认Dialog。确认后逻辑删除(is_deleted=1),已产生的核销记录保留删除后该核销员不可再登录移动端
PC扫码核销页输入12位核销码实时查询核销码有效性:①是否存在于系统 ②是否归属当前供应商 ③是否已完成核销 ④是否在可核销范围内。校验通过后展示订单信息输入框支持扫码枪输入(自动触发查询)
PC扫码核销页点击"确认核销"更新t_verification_record插入核销记录→更新t_order_item.verification_status→如全部核销完成则更新item_status=7→触发分账→发送核销成功通知核销操作必须在3秒内完成,超时提示"网络异常,请重试"
核销记录页查看核销记录列表展示:核销码、商品名称、买家信息、核销时间、核销员、核销数量。支持按时间范围筛选供应商仅可查看自己供应商的核销记录
核销记录页点击"补核销"弹出输入框,输入核销码+核销数量。校验通过后执行核销流程。补核销需填写原因(必填)补核销操作记录到t_order_status_log,operator_type=3(供应商)

12.2.3 HTML/CSS内联原型

图12-1:PC端核销页面原型

扫码核销
请输入或扫描12位核销码
订单信息
商品:西湖门票 - 成人票
买家:张三 138****1234
数量:2张(已核销0张)
预约日期:2026-07-10
本次核销数量:

12.2.4 核销状态说明表

核销状态页面表现触发条件可执行操作
未核销灰色Tag虚拟商品支付后/预约成功后可执行核销操作;买家可申请售后
部分核销橙色Tagquantity>1且已核销部分数量可继续核销剩余数量;不可申请售后(已核销部分)
全部核销绿色Tag累计核销数量=quantity子订单状态更新为已完成;触发分账;买家可评价

12.3 预约与核销异常处理

异常场景前端表现后端处理用户可恢复操作
选择日期库存不足日历组件中该日期灰色禁用,hover提示"该日期库存不足"实时查询available_stock,库存<quantity时标记为不可选选择其他有库存日期
核销码不存在输入后提示"核销码不存在,请检查输入"查询t_order_item.verification_code,无匹配返回错误检查核销码是否正确,或联系平台运营核实
核销码归属其他供应商提示"该核销码不属于您的供应商,无权核销"校验子订单的supplier_id是否与当前核销员所属供应商一致引导买家到正确门店核销
重复核销提示"该核销码已完成核销,不可重复操作"校验verification_status,如=2(全部核销)则拒绝查看核销记录确认状态
核销时网络异常提示"网络异常,请重试",保留当前输入内容核销操作使用数据库事务,异常时回滚,保证数据一致性网络恢复后重新点击"确认核销"
预约修改超次"修改预约"按钮灰色,hover提示"已超出修改次数限制"校验booking_modify_count字段,>=1时拒绝联系平台运营协商处理

13发货与物流管理

发货与物流管理针对实物商品(文创产品等)的履约场景。供应商在后台录入物流信息完成发货,买家和分销商可在订单详情中查看物流轨迹。系统同时支持自提履约方式。

13.1 发货管理

13.1.1 核心业务逻辑

13.1.2 极细交互说明

页面/组件用户动作系统行为备注
订单列表页点击"发货"按钮弹出发货Dialog,包含:物流公司下拉选择、运单号输入框、确认发货按钮仅item_status=4(已收单)且shipping_status=0(未发货)的子订单显示"发货"按钮
发货Dialog选择物流公司下拉展示平台预设物流公司列表,选择"其他"时显示额外输入框手动输入公司名称物流公司数据由平台运营在系统管理中维护
发货Dialog输入运单号前端校验:非空、长度6-30位、仅允许字母数字。不符合时输入框边框变红并提示错误支持扫码枪扫描运单条码自动填入
发货Dialog点击"确认发货"校验通过后:更新shipping_status=1→shipping_time=now→发送发货通知→调用物流API订阅轨迹推送发货操作不可逆,确认Dialog二次确认
订单列表页勾选多个订单+批量发货弹出批量发货Dialog,统一选择物流公司和录入运单号。确认后逐条执行发货流程仅允许勾选同一买家的子订单进行批量发货
订单详情页
物流Tab
查看物流轨迹展示物流时间轴:已揽件→运输中→派送中→已签收。每个节点显示时间和地点物流数据调用第三方API实时查询,首次查询后缓存30分钟
订单详情页点击"标记自提完成"弹出确认Dialog,确认后更新shipping_status=3,receive_time=now,item_status=7仅shipping_status=0(未发货)且订单类型为自提的订单显示此按钮

13.1.3 HTML/CSS内联原型

图13-1:发货Dialog原型

确认发货
订单号:DD2026070601234568
物流公司
运单号
商品:灵隐寺文创手串 x1
收货人:李四 139****5678
地址:浙江省杭州市西湖区xxx

13.2 物流轨迹展示

图13-2:物流轨迹时间轴原型

物流信息:顺丰速运 | SF1234567890
✓
已签收
您的快件已由【前台】代收,感谢您使用顺丰速运
2026-07-08 14:30:00
2
派送中
【杭州市】快件正在派送中,派件员:王师傅 138****1234
2026-07-08 08:15:00
3
运输中
【杭州市】快件已到达杭州西湖集散中心
2026-07-07 22:00:00
4
已揽件
【杭州市】顺丰速运已收取快件
2026-07-07 16:30:00

13.3 发货与物流异常处理

异常场景前端表现后端处理用户可恢复操作
运单号格式错误输入框边框变红,提示"运单号长度应在6-30位之间"前端正则校验:^[A-Za-z0-9]{6,30}$重新输入正确的运单号
物流API查询失败物流时间轴显示"物流信息查询失败,点击重试"物流API超时或返回错误时,展示缓存数据(如有)或失败提示点击"重试"按钮重新查询
物流长时间未更新物流时间轴最后节点显示"物流信息已X天未更新",标黄预警定时任务每天扫描发货后7天未签收的订单,标记为"物流异常"供应商联系物流公司核实
重复发货已发货订单不显示"发货"按钮后端校验shipping_status,不为0时拒绝发货请求如需修改物流信息,联系平台运营
自提订单误点发货自提订单显示"标记自提完成"按钮,不显示"发货"按钮根据订单的delivery_type字段(1-快递,2-自提)动态显示不同按钮确认订单履约方式后操作

14售后管理中心

售后管理中心处理买家发起的退款/退货退款申请,采用"供应商一审 → 平台终审"的两级审核机制。涉及资金退回和逆向分账,是订单履约链路中风险最高的环节。

14.1 售后单处理流程

flowchart LR
A["买家申请售后"] --> B{"售后类型"}
B -->|"仅退款"| C1["待供应商处理"]
B -->|"退货退款"| C1
C1 -->|"供应商同意"| D["待平台终审"]
C1 -->|"供应商拒绝"| E{"买家是否申诉"}
E -->|"是"| F["平台介入仲裁"]
E -->|"否"| G["售后关闭"]
F -->|"平台同意"| H["执行退款+逆向分账"]
F -->|"平台驳回"| G
D -->|"平台同意"| H
D -->|"平台驳回"| G
H --> I["退款原路退回"]
I --> J["售后完成"]
    
图14-1:售后处理流程图

14.2 核心业务逻辑

14.3 极细交互说明

页面/组件用户动作系统行为备注
售后列表页查看售后单列表展示售后单号、关联订单号、商品信息、申请类型、申请金额、申请原因、状态、申请时间。按状态Tab分组供应商仅展示归属自己supplier_id的售后单;分销商只读
售后列表页
供应商端
点击"处理"按钮打开处理Drawer,展示售后详情:申请原因、凭证图片、买家信息。下方显示"同意"和"拒绝"两个按钮状态为"待供应商处理"时显示"处理"按钮,超5个工作日未处理系统自动同意
售后处理Drawer点击"同意"二次确认Dialog。确认后:更新status=2(供应商同意)→ 进入平台终审队列 → 通知买家"供应商已同意,等待平台审核"同意后不可撤销
售后处理Drawer点击"拒绝"弹出拒绝原因输入框(必填,最少10字)。确认后:更新status=3(供应商拒绝)→ 通知买家→买家可在7天内申诉拒绝时必须上传凭证或填写详细原因
售后列表页
平台端
点击"仲裁"按钮打开仲裁Drawer,展示供应商处理结果、买家申诉内容(如有)、订单信息、售后凭证。下方显示"同意退款"和"驳回申请"状态为"供应商同意"或"平台介入中"时显示"仲裁"按钮
售后仲裁Drawer点击"同意退款"二次确认Dialog。确认后:更新status=5(平台同意)→ 调用支付中心执行退款 → 退款成功后更新status=7(已退款)、对应子订单refund_status=2 → 触发逆向分账 → 通知各方退款失败时标记status=9(退款失败),人工介入处理
售后仲裁Drawer点击"驳回申请"弹出驳回原因输入框(必填)。确认后:更新status=6(平台驳回)→ 通知买家→ 售后关闭买家对平台仲裁结果不可再次申诉
售后详情页查看退款进度展示售后时间轴:申请→供应商处理→平台审核→退款执行。每个节点显示时间和操作人退款执行节点显示退款流水号和第三方退款单号

14.4 售后状态说明表

售后状态页面表现触发条件可执行操作
待供应商处理橙色Tag买家提交售后申请后供应商可同意/拒绝;超时5天未处理自动同意
供应商同意蓝色Tag供应商点击"同意"后平台运营可终审(同意退款/驳回)
供应商拒绝红色Tag供应商点击"拒绝"后买家可在7天内申诉;超时不申诉自动关闭
平台介入中橙色Tag买家申诉后平台运营可仲裁(同意退款/驳回)
平台同意退款绿色Tag平台点击"同意退款"后系统自动执行退款;退款成功后变为"已退款"
平台驳回红色Tag平台点击"驳回"后售后关闭,不可再次申诉
已退款绿色Tag退款成功回调后只读;触发逆向分账
退款失败红色Tag支付中心退款回调返回失败时平台运营收到告警通知,可手动重新发起退款或线下处理
已关闭灰色Tag买家超时未申诉/平台驳回/买家主动撤销只读

14.5 售后统计

2.3%
退款率
48h
平均处理时效
156
本月售后单数
89.5%
供应商按时处理率
统计维度指标说明计算方式
退款率统计周期内退款订单数 / 总成交订单数按供应商/平台维度分别计算
售后原因分布各退款原因的占比(商品质量问题/与描述不符/未按时发货/买家原因等)按after_sale.apply_reason分组统计
处理时效供应商平均处理时长 = AVG(供应商处理时间 - 申请时间)仅统计已处理的售后单
供应商按时处理率5天内处理的售后单 / 总售后单按月统计,作为供应商考核指标

14.6 售后异常处理

异常场景前端表现后端处理用户可恢复操作
重复申请售后C端提交时提示"该商品已有进行中的售后单,不可重复申请"校验该order_item_id是否存在status IN (1,2,3,4,5,9)的售后单等待当前售后单处理完成后再申请
退款金额超过实付提示"退款金额不能超过实付金额XXX元"校验apply_amount <= t_order_item.total_amount - t_order_item.refund_amount修改退款金额后重新提交
退款失败售后状态变为"退款失败",平台运营收到告警通知支付中心退款回调返回失败时,更新status=9,发送告警给平台运营平台运营核实原因后手动重新发起退款或线下处理
逆向分账失败售后状态为"已退款",但分账服务标记"逆向分账欠款"逆向分账时如某方待结算账户余额不足,记录欠款,下次结算自动抵扣平台运营在结算对账中查看欠款明细
供应商超时未处理供应商端列表中该售后单行标红,提示"即将超时"定时任务每天扫描,超过5天未处理自动更新status=2(供应商同意)供应商及时处理避免系统自动通过

15发票与评价管理

发票与评价管理覆盖订单完成后的两项增值服务能力:发票管理负责处理买家的电子发票申请、开具、上传、红冲全链路;评价管理负责收集买家对商品和服务的评价内容,支持运营回复和好评率统计,为商品排序和供应商考核提供数据支撑。

15.1 发票管理

15.1.1 核心业务逻辑

15.1.2 极细交互说明

页面/组件用户动作系统行为备注
发票管理页
列表
查看发票申请列表展示发票单号、关联子订单号、关联主订单号、买家信息、发票类型、发票金额、申请时间、状态。支持按状态/时间/供应商筛选供应商端仅展示自己商品的子订单发票申请
发票管理页点击"上传发票"弹出上传Dialog,支持拖拽上传PDF文件,限制大小10MB。上传后系统校验文件格式为PDF上传后发票状态变为"已开票",自动发送邮件给买家
发票管理页点击"红冲"弹出确认Dialog,确认后发票状态变为"已红冲",释放该子订单的发票申请额度,买家可重新申请仅状态为"已开票"且上传时间在7天内的发票可操作红冲
发票详情页查看发票信息展示发票申请信息(抬头、税号、邮箱)、上传的PDF预览、操作日志(申请→上传→通知)PDF预览使用浏览器原生PDF预览能力

15.1.3 发票状态说明表

状态码状态名称触发条件允许操作
1待开票买家提交发票申请后供应商可上传发票
2已开票供应商上传PDF发票后7天内可红冲
3已红冲供应商或平台运营执行红冲后买家可重新申请

15.1.4 异常处理

异常场景现象处理方案
发票PDF上传失败文件上传后系统校验非PDF格式提示"请上传PDF格式文件",清除已选文件
邮件发送失败发票上传后买家未收到邮件系统记录发送失败日志,运营可手动点击"重发邮件"
重复申请买家对已开发票子订单再次申请提示"该子订单已开具发票,如需修改请先红冲原发票"
超期红冲供应商尝试红冲超过7天的发票按钮置灰不可点击,Tooltip提示"超过7天不可红冲"

15.2 评价管理

15.2.1 核心业务逻辑

15.2.2 极细交互说明

页面/组件用户动作系统行为备注
评价管理页
列表
查看评价列表展示评价ID、关联订单号、商品名称、买家昵称、评分、评价内容、图片缩略图、评价时间、回复状态。支持按评分/时间/商品/供应商筛选供应商端仅展示自己商品的评价
评价管理页点击"回复"弹出回复Dialog,输入框最多300字。提交后回复内容展示在评价下方,状态变为"已回复"每条评价仅可回复一次,提交前二次确认
评价管理页点击"隐藏"弹出确认Dialog,确认后评价在C端商品详情页不再展示,但后台仍可见。隐藏后不可恢复展示仅平台运营角色可操作隐藏
评价详情页查看评价详情展示买家完整评价内容、图片(点击放大)、评分明细(商品质量/服务态度)、买家历史评价数图片使用Lightbox组件放大查看
评价统计页查看好评率统计展示供应商维度的好评率趋势图(近30天)、各SKU综合评分排名、好评/中评/差评分布饼图统计每日凌晨2:00定时任务计算更新

15.2.3 评价状态说明表

状态码状态名称触发条件允许操作
1待审核买家提交评价后,系统审核中平台运营可审核通过/驳回
2已通过系统或人工审核通过后供应商可回复,平台运营可隐藏
3已驳回审核不通过(含违规内容)买家可修改后重新提交
4已隐藏平台运营执行隐藏后不可恢复,仅后台可见

15.2.4 评价统计与回复规则

15.2.5 异常处理

异常场景现象处理方案
评价包含敏感词系统审核命中敏感词库评价进入"待人工审核",运营确认违规后驳回,通知买家修改
评价图片违规图片OCR识别出违规文字或二维码自动拦截,评价状态为"待审核",运营人工复核
重复评价买家对已评价子订单再次提交评价提示"您已评价过该商品",前端禁用评价入口
超期评价订单完成超过30天后买家尝试评价C端评价入口自动关闭,提示"评价已过期"

16系统初始化与依赖顺序

订单履约中心作为涉旅电商分销子系统的核心业务模块,其上线前必须完成依赖模块的部署、基础数据的初始化、定时任务的配置和权限角色的分配。本章明确上线前的所有准备工作和检查清单。

16.1 上线前数据初始化

初始化项数据来源负责方验收标准
物流公司字典运营手动录入:顺丰、中通、圆通、韵达、申通、EMS、京东物流、德邦、其他平台运营字典表t_logistics_company包含≥9条记录,code唯一不重复
订单自动关闭时间系统参数表配置:default_cancel_minutes=30(分钟)技术团队参数表存在且值为30,定时任务每1分钟扫描一次
售后审核时限系统参数表配置:supplier_audit_days=5,platform_audit_days=3技术团队参数表存在且值正确,超时自动流转逻辑已验证
发票红冲期限系统参数表配置:invoice_void_days=7技术团队超过7天的发票红冲按钮置灰不可点击
评价有效期系统参数表配置:review_valid_days=30技术团队订单完成后30天C端评价入口自动关闭
预约超时提醒系统参数表配置:booking_remind_days=7,booking_max_days=14技术团队支付成功后7天发送提醒,14天未预约进入待处理队列
核销员账号为每个供应商创建至少1个核销员账号(角色=核销员),绑定supplier_id供应商管理员核销员可登录移动端核销APP/小程序
银行监管账户财务部门提供银行监管账户信息,配置到支付网关财务+技术测试环境可正常进行支付和退款测试

16.2 依赖模块就绪检查

依赖模块必须提供的接口/能力检查方式不通过影响
商品管理模块SKU查询接口、SPU属性查询、商品上下架状态调用接口查询测试商品,校验返回字段完整性订单创建时无法获取商品信息,导致下单失败
库存管理模块库存扣减接口、库存释放接口、日历库存查询接口并发测试扣减/释放,验证库存一致性超卖或库存不一致
支付网关统一下单接口、退款接口、分账接口、银行流水查询接口测试环境完成一笔完整支付+退款流程无法收款或退款
用户中心买家信息查询、手机号脱敏接口、用户权限校验查询测试买家信息,校验脱敏规则订单无法关联买家,敏感信息泄露
分销商模块分销商信息查询、佣金策略查询、分销商等级查询查询测试分销商,校验佣金计算规则分销订单无法计算佣金
消息服务短信发送接口、站内信接口、微信模板消息接口触发各类通知,验证到达率买家/供应商收不到状态变更通知
物流API运单轨迹查询接口、订阅推送接口用测试运单号查询轨迹,验证返回格式无法展示物流轨迹

16.3 定时任务配置清单

任务名称执行周期任务职责失败告警
订单自动关闭扫描每1分钟扫描待支付订单,超时30分钟自动取消并释放库存连续失败3次发送告警邮件给技术负责人
待预约订单提醒每天10:00扫描booking_status=1且超7天的订单,发送短信+站内信提醒失败记录日志,不告警
售后超时自动流转每1小时扫描供应商审核中超5天的售后单,自动流转至平台终审失败记录日志,不告警
物流轨迹同步每2小时对已发货未签收的订单调用物流API刷新轨迹单条失败不重试,记录日志
评价统计计算每天凌晨2:00计算各SKU/SPU/供应商的好评率和综合评分失败记录日志,不告警
分账补触发扫描每小时扫描"已核销但未分账"的订单,补触发分账流程连续失败3次发送告警
AI填报数据清理每天凌晨3:00扫描 ai_form_fill_task.retention_expire_at 小于当前时间的任务,物理删除对应 ai_form_fill_result 行并归档任务元数据到日志连续失败3次发送告警

17验收标准

本章定义订单履约全链路PRD的功能验收、性能验收、安全验收和兼容性验收标准,作为开发完成后的测试依据和上线准入条件。

17.1 功能验收标准

模块验收项验收标准验收方式
订单创建C端下单流程买家可正常选择商品→填写信息→支付→生成订单,订单号符合DD+YYYYMMDD+8位规则手工测试10笔不同商品类型的订单
订单创建库存扣减支付成功后库存准确扣减,并发10笔同一SKU订单时库存不超卖压力测试工具并发下单,验证库存一致性
订单处理三端列表查询平台端可见全部订单,供应商端仅可见自己SKU的订单,分销商端仅可见自己推广的订单用不同角色账号登录,校验数据范围
订单处理订单详情展示详情页4个Tab(商品/支付/履约/日志)数据完整准确,多供应商订单展示正确抽查10笔订单,核对各Tab数据
订单处理订单导出≤5000条直接下载,>5000条异步生成后通知下载。导出字段正确,手机号脱敏分别测试500条和6000条导出场景
预约核销日历库存校验选择日期时实时校验库存,库存不足日期灰色不可选将某日库存设为0,验证该日不可选
预约核销核销流程核销员输入12位核销码,校验通过后状态变为"已核销",触发分账手工测试10次核销,验证状态变更和分账
发货物流发货操作供应商可正常录入物流公司和运单号,发货后买家收到通知手工测试5笔发货流程
发货物流物流轨迹订单详情页展示物流时间轴,数据与物流API返回一致对比系统展示与快递100官网数据
售后管理两级审核流程供应商审核→平台终审→退款执行,每级超时自动流转测试正常通过和超时自动流转场景
售后管理退款金额校验退款金额≤订单实付金额-已退款金额,超出时前端拦截尝试输入超额退款金额,验证拦截
发票管理发票申请与上传买家申请→供应商上传PDF→买家收到邮件,全流程闭环手工测试3笔发票流程
评价管理评价提交与展示买家提交评价→系统审核→C端展示,供应商可回复测试含图评价、敏感词评价、正常评价
AI智能填报粘贴文本识别粘贴包含姓名、身份证号、手机号的名单文本,AI正确识别≥90%字段,人工复核后可一键填入测试10份不同格式名单
AI智能填报图片识别上传身份证照片/名单截图,AI识别字段并结构化,低置信度字段标黄提示测试10张不同清晰度图片
AI智能填报覆盖规则同一商品内证件号重复时按证件号覆盖已有记录,不同证件号新增记录先手动填入3人,再用AI识别包含其中2人的资料确认覆盖
AI智能填报额度控制租户AI额度为0时按钮置灰;每次识别任务扣减1次额度;额度不足时提交被拦截手动调整额度测试阈值场景
AI智能填报数据清理retention_expire_at 到期后定时任务清理 ai_form_fill_result 数据,任务元数据归档到日志手工修改 retention_expire_at 触发清理任务

17.2 性能验收标准

指标项目标值测试场景测试工具
订单列表查询响应时间≤500ms(单页20条)平台端查询全部订单,按时间倒序JMeter / k6
订单详情页加载时间≤800ms打开包含5个子订单的复杂订单详情浏览器DevTools
库存扣减并发支持100TPS同一SKU并发扣减不超卖100并发请求同时扣减同一SKU库存JMeter
订单导出5000条导出≤30秒(同步),>5000条后台生成≤5分钟分别测试5000条和10000条导出手工计时
物流轨迹查询≤1000ms(含Redis缓存)首次查询和缓存命中查询分别测试浏览器DevTools
定时任务执行订单自动关闭扫描≤30秒(10万笔待支付)模拟10万笔待支付订单,执行扫描数据库插入+手工触发

17.3 安全验收标准

安全项验收标准验收方式
数据权限隔离供应商A无法查询/操作供应商B的订单、售后、发票数据用供应商A账号尝试访问B的数据,验证403拒绝
敏感字段脱敏手机号展示为138****1234,身份证展示为110**********1234检查所有列表和导出文件的敏感字段
明文查看控制查看手机号明文需二次认证(短信验证码),认证有效期60秒点击"查看明文",验证验证码流程和超时失效
SQL注入防护订单号搜索框输入' OR 1=1 --,系统正常返回空结果手工输入SQL注入payload
XSS防护订单备注输入<script>alert(1)</script>,保存后页面不执行脚本手工输入XSS payload
资金操作安全所有退款、分账操作必须经过审核流程,无直接操作资金的接口代码审查+接口测试
操作日志所有订单状态变更、售后审核、强制取消操作均记录到t_order_status_log抽查10笔订单,核对日志完整性
AI数据权限隔离分销商A无法查询/操作分销商B的AI填报任务和识别结果用分销商A账号尝试访问B的task_id,验证403拒绝
AI敏感数据保护AI填报抽屉中身份证号、手机号默认脱敏;完整明文仅在编辑态按权限展示;数据库存储加密检查AI抽屉展示、数据库字段存储、网络传输报文
AI额度防刷额度扣减使用原子操作,并发提交识别任务时不会超扣额度压力测试并发创建AI任务,核对used_quota

17.4 兼容性验收标准

兼容项验收标准验收方式
浏览器兼容Chrome 90+、Edge 90+、Firefox 88+、Safari 14+正常展示和操作在4种浏览器中执行完整功能测试
响应式布局1366x768至1920x1080分辨率下页面无横向滚动、无元素重叠浏览器DevTools调整分辨率验证
PDF预览发票PDF在Chrome/Edge/Firefox中可正常预览和下载上传测试PDF,在各浏览器中预览
Mermaid图表架构图、流程图、状态机图在各浏览器中正常渲染无乱码检查第6章所有图表渲染效果