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 核心设计原则
- 订单原子性:订单为最小业务单元,子订单为最小履约单元。每个子订单独立追踪履约状态,但统一订单号对外展示
- 状态机驱动:订单、子订单、售后单均有明确的状态机定义,状态流转由特定事件触发,禁止非法状态跳转
- 资金安全第一:所有资金操作(退款、分账、逆向分账)必须基于已审核的订单/售后单,操作留痕不可篡改
- 库存强一致:采用乐观锁+定时任务补偿机制,确保total_stock = locked_stock + sold_stock + available_stock始终成立
- 三端数据隔离:平台运营看全量、供应商看归属自己SKU的订单、分销商看自己渠道产生的订单,通过tenant_type+tenant_id强制过滤
- 敏感字段脱敏:手机号、身份证号等默认脱敏展示,查看明文需二次认证(输入当前账号密码),60秒有效
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.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["退款原路退回"]
- 虚拟商品和实物商品在支付成功后分走不同履约路径,但最终都汇聚到"已完成"状态并触发分账
- 需预约商品(酒店/门票)在收单后进入已收单状态,通过 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
7全局通用规则
7.1 订单编号生成规则
- 格式:DD + YYYYMMDD + 8位分布式ID(Snowflake),总长度20位
- 示例:DD2026070612345678
- 生成时机:C端用户提交订单时由订单服务生成,保证全局唯一
- 查询支持:订单号支持精确匹配查询,输入非数字时前端自动过滤
7.2 库存联动规则
| 业务场景 | 库存操作 | 详细逻辑 |
|---|---|---|
| 用户下单 | locked_stock +N | C端提交订单时,库存服务对订单内每个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 |
| 售后退款(已核销) | 不释放库存 | 已核销订单退款不退库存(已消费),仅做资金退回 |
7.3 支付超时与自动取消规则
- 默认超时时间:订单创建后30分钟未支付,系统自动取消
- 定时任务频率:每1分钟执行一次扫描
- 扫描条件:status = 1(待支付)AND expire_time < NOW() AND is_auto_cancel = 1
- 取消后操作:更新order_status = 8(已关闭),cancel_reason = "支付超时系统自动取消",释放locked_stock,发送取消通知给用户
- 例外场景:秒杀订单的超时时间可能不同(如15分钟),由商品配置决定
7.4 敏感字段脱敏规则
| 字段 | 脱敏规则 | 查看明文条件 | 操作留痕 |
|---|---|---|---|
| 买家手机号 | 138****1234 | 点击眼睛图标,输入当前账号密码验证通过后,60秒内可见明文 | 记录到操作日志:用户ID、时间、查看的订单号、查看的字段 |
| 身份证号 | 110**********1234 | 同上,需二次认证 | 同上 |
| 银行卡号 | 6222****1234 | 提现审核页面中,点击眼睛图标查看完整账号 | 记录到操作日志 |
| 收货地址 | 完整展示(不脱敏) | 无限制 | 无需留痕 |
7.5 主订单与子订单拆分规则
- 主订单拆分:一个结算单包含多个供应商的商品时,按supplier_id拆分为多个主订单(t_order)。不同供应商的主订单独立履约、结算、售后、发票
- 子订单拆分:每个主订单内,按SKU + 使用人拆分为多个子订单(t_order_item)。实名制商品一个使用人一条子订单,便于按人名退款。每个子订单独立追踪履约状态
- 供应商可见范围:供应商后台仅展示包含自己supplier_id的子订单,其他供应商的子订单信息隐藏(显示为"其他供应商商品")
- 分账处理:跨供应商订单核销时,各主订单下的子订单独立触发分账,分别向对应供应商结算货款
- 售后处理:买家申请售后时,按子订单维度处理。供应商仅可处理归属自己的子订单售后申请
- 订单完成条件:同一主订单下所有子订单item_status均达到7(已完成)时,该主订单order_status同步更新为7(已完成)
7.6 支付方式规则
- 单结算单单一支付方式:B端采购车统一结算时,一个结算单仅允许使用一种支付方式,严禁混用。结算单支付后按供应商拆分为多个主订单,各主订单共享同一支付方式与支付流水。单一支付方式确保退款时原路退回逻辑清晰,对账时结算单与银行流水一一对应
- B端采购支付方式:三种支付方式三选一:① 余额支付(扣减实际余额,不足不可选)② 授信额度支付(扣减授信额度,不足/过期不可选)③ 在线支付(微信/支付宝/第三方支付)。下单页/支付页三选一单选,选定时其余两种置灰
- C端消费者支付方式:仅支持在线支付(微信/支付宝/第三方支付),不支持余额支付和授信支付
- 支付方式记录:结算单表t_settlement.payment_method与主订单表t_order.payment_method均记录支付方式。支付流水与结算单关联,主订单通过settlement_id关联结算单
- 退款路径:退款必须按原支付方式原路退回。余额支付→退回余额账户;授信支付→恢复授信额度;在线支付→原路退回微信/支付宝。禁止跨渠道退款
- 分账前提:仅在线支付订单的资金进入银行监管账户,核销后从监管账户分账。余额支付和授信支付属于平台内部记账,不触发银行分账接口,仅做平台内部账户扣减/恢复
7.7 消息通知触发规则
| 触发场景 | 通知对象 | 通知渠道 | 通知内容 |
|---|---|---|---|
| 订单支付成功 | 买家 | 站内信+短信 | "您的订单DDXXX已支付成功,请留意后续履约通知" |
| 订单发货 | 买家 | 站内信+短信+微信推送 | "您的订单DDXXX已发货,物流公司:XX,运单号:XXX" |
| 核销成功 | 买家 | 站内信+微信推送 | "您的XX商品已核销成功,祝您游玩愉快" |
| 退款完成 | 买家 | 站内信+短信 | "您的退款申请已处理完成,退款金额XXX元已原路退回" |
| 预约即将到期 | 买家+供应商 | 站内信+短信 | "您的预约即将到期,请尽快完成预约" |
| 售后单状态变更 | 买家+供应商 | 站内信 | "您的售后单XXX已被XX处理,结果:同意/驳回" |
| 发票已开具 | 买家 | 站内信+邮件 | "您的发票已开具,请查收邮件附件" |
7.8 订单导出规则
- 导出字段:订单号、下单时间、买家昵称、买家手机号(脱敏)、商品名称、SKU名称、实付金额、订单状态、支付方式、供应商名称、分销商名称
- 小数据量(<= 5000条):前端直接下载Excel,按钮显示loading
- 大数据量(> 5000条):Toast提示"数据量较大,将在后台生成后通知您下载",后台异步生成后通过站内信发送下载链接
- 时间限制:单次导出时间跨度不超过90天,默认近30天
- 权限控制:供应商导出仅包含归属自己SKU的订单;分销商导出仅包含自己渠道的订单
7.9 价格口径与底价优先级规则
7.9.1 价格术语使用规范
为避免价格字段混用,PRD 中统一使用以下术语:B端/OTA 采购下单价统一称为底价(= 分销采购价),即B端/OTA订单的成交价;供应商结算基础价格称为供应商结算基准价,等于下单时子商品的实际成交价(C端为平台销售价扣减优惠后的成交价,B端/OTA为底价);分销商对外售卖监管价格称为限价(最高对外销售价)。
7.9.2 底价优先级规则
系统计算 B端/OTA 最终采购下单价(底价)时,按以下优先级取最精确、有效期内、状态启用的价格:
- 授权产品-指定分销商专属底价
- 授权产品-指定分销商分组底价
- 授权产品-指定渠道等级底价
- 商品SKU-指定分销商底价
- 商品SKU-渠道+等级底价
- 商品SKU-渠道默认底价
- 商品SKU基础分销采购价(底价)
7.9.3 底价补充规则
- 唯一生效:同一商品、同一SKU、同一渠道、同一授权对象、同一时间段,只能有一条生效价格。
- 变更留痕:所有底价/限价变更必须写入价格变更日志,包含旧价、新价、生效时间、操作人、变更原因。
- 快照结算:已创建订单按下单时的底价快照结算,不受后续调价影响。
- 来源展示:下单页需展示「当前生效价来源」,例如:来源:授权产品 / 指定分销商专属底价。
- 限价用途:限价仅用于分销商对外销售价格风控,不参与 B端采购下单价计算。
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.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.3 分销商后台页面结构
flowchart TB
subgraph 订单查看["订单查看"]
O1["订单列表(只读)"] --> O2["订单详情"]
end
subgraph 售后查看["售后查看"]
A1["售后列表(只读)"] --> A2["售后详情"]
end
subgraph 数据中心["数据中心"]
D1["推广订单统计"] --> D2["佣金结算单"]
end
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.2 核心数据表结构
9.2.1 订单主表(t_order)
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| order_id | bigint | PK | 订单唯一ID |
| order_sn | varchar(32) | NOT NULL, UNIQUE | 订单号,格式:DD+YYYYMMdd+8位分布式ID |
| user_id | bigint | NOT NULL | 下单用户ID |
| distributor_id | bigint | NOT NULL, DEFAULT 0 | 推广分销商ID(0表示平台直售) |
| channel_id | bigint | DEFAULT 0 | 渠道ID(用于区分分销商的子渠道) |
| source_channel | tinyint | NOT NULL, DEFAULT 1 | 订单来源渠道:1-平台自营,2-B端分销,3-OTA渠道,4-组合产品 |
| settlement_id | bigint | NULL | 关联结算单ID(购物车整单支付时必填) |
| ota_channel_id | bigint | NULL | OTA渠道ID(OTA订单必填) |
| ota_order_sn | varchar(64) | NULL | OTA渠道方订单号(OTA订单必填) |
| ota_push_price | decimal(10,2) | NULL | OTA推送价(OTA订单必填) |
| combo_product_id | bigint | NULL | 组合产品ID(组合产品订单必填) |
| combo_sale_price | decimal(10,2) | NULL | 组合产品成交价(组合产品订单必填) |
| combo_seller_id | bigint | NULL | 组合产品销售方ID(组合产品订单必填) |
| platform_service_fee | decimal(10,2) | DEFAULT 0.00 | 平台服务费 |
| price_source | varchar(100) | NULL | 底价来源描述,例如「授权产品 / 指定分销商专属底价」 |
| stock_lock_time | datetime | NULL | 库存锁定时间 |
| reconciliation_status | tinyint | DEFAULT 0 | 对账状态:0-未对账,1-已对账,2-对账差异。仅状态标记,对账逻辑详见财务PRD |
| order_status | tinyint | NOT NULL, DEFAULT 1 | 订单状态:1-待支付,2-支付中,3-已支付,4-已收单,5-履约中,6-已发货,7-已完成,8-已关闭,9-已退款,10-售后处理中,11-履约异常,12-OTA回传失败 |
| order_type | tinyint | NOT NULL, DEFAULT 1 | 订单类型:1-普通订单,2-秒杀订单(仅表达C端营销活动类型) |
| total_amount | decimal(10,2) | NOT NULL | 订单总金额:C端为平台销售价合计;B端/OTA为底价合计;组合产品为组合产品成交价 |
| discount_amount | decimal(10,2) | DEFAULT 0.00 | 优惠金额(优惠券+活动减免) |
| freight_amount | decimal(10,2) | DEFAULT 0.00 | 运费金额 |
| pay_amount | decimal(10,2) | NOT NULL | 实付金额 = total_amount - discount_amount + freight_amount |
| pay_time | datetime | NULL | 支付时间 |
| payment_method | tinyint | NULL | 支付方式:1-微信支付,2-支付宝,3-余额支付,4-授信额度支付,5-第三方支付 |
| payment_sn | varchar(64) | NULL | 第三方支付流水号 |
| expire_time | datetime | NOT NULL | 自动取消时间(默认创建时间+30分钟) |
| cancel_reason | varchar(200) | NULL | 取消原因(用户填写或系统生成) |
| cancel_time | datetime | NULL | 取消时间 |
| complete_time | datetime | NULL | 完成时间(所有子订单均完成后) |
| settlement_status | tinyint | DEFAULT 0 | 结算状态:0-未结算,1-结算中,2-已结算,3-结算失败 |
| is_auto_cancel | tinyint | DEFAULT 1 | 是否允许自动取消:1-是,0-否(如秒杀订单可配置不允许自动取消) |
| buyer_remark | varchar(500) | NULL | 买家留言 |
| create_time | datetime | NOT NULL | 创建时间 |
| update_time | datetime | NOT NULL | 最后修改时间 |
9.2.2 订单商品明细表(t_order_item)
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| order_item_id | bigint | PK | 子订单ID |
| order_id | bigint | NOT NULL, FK | 关联订单ID |
| spu_id | bigint | NOT NULL | 商品SPU ID |
| sku_id | bigint | NOT NULL | 商品SKU ID |
| supplier_id | bigint | NOT NULL | 供应商ID |
| sku_name_snapshot | varchar(100) | NOT NULL | SKU名称快照(冗余,防止商品修改后历史订单显示异常) |
| sku_image_snapshot | varchar(500) | NULL | SKU主图快照 |
| price_snapshot | decimal(10,2) | NOT NULL | 成交价快照:C端为平台销售价扣减优惠券、满减等活动优惠后的成交价(积分不可抵扣订单金额);B端/OTA/组合产品子商品为底价 |
| settlement_base_price_snapshot | decimal(10,2) | NULL | 供应商结算基准价快照,等于订单/子商品的实际成交价,用于分账/结算计算 |
| market_price_snapshot | decimal(10,2) | NULL | 市场价快照 |
| platform_sale_price_snapshot | decimal(10,2) | NULL | 平台销售价快照(C端订单必填) |
| base_price_snapshot | decimal(10,2) | NULL | 底价快照(B端/OTA/组合产品子商品必填) |
| price_source_snapshot | varchar(100) | NULL | 底价来源快照,例如「授权产品 / 指定分销商专属底价」 |
| max_external_sale_price_snapshot | decimal(10,2) | NULL | 最高对外销售价(限价)快照,用于风控留痕 |
| quantity | int | NOT NULL, DEFAULT 1 | 购买数量 |
| total_amount | decimal(10,2) | NOT NULL | 小计金额 = price_snapshot × quantity |
| item_status | tinyint | NOT NULL, DEFAULT 1 | 子订单状态:1-待支付,2-支付中,3-已支付,4-已收单,5-履约中,6-已发货,7-已完成,8-已关闭,9-售后处理中,10-履约异常,11-OTA回传失败 |
| refund_status | tinyint | DEFAULT 0 | 退款状态:0-无售后,1-售后中,2-退款成功,3-退款失败。与item_status解耦,财务对账和退款统计以本字段为准 |
| verification_code | varchar(32) | NULL | 一单一码场景下的统一核销码;一票一码场景下可为空或存主码,独立码见 t_verification_code 表 |
| verification_status | tinyint | DEFAULT 0 | 核销状态:0-未核销,1-部分核销,2-全部核销 |
| verification_time | datetime | NULL | 核销时间 |
| shipping_status | tinyint | DEFAULT 0 | 发货状态:0-未发货,1-已发货,2-已签收,3-自提完成 |
| shipping_time | datetime | NULL | 发货时间 |
| receive_time | datetime | NULL | 签收/自提完成时间 |
| logistics_company | varchar(50) | NULL | 物流公司名称 |
| logistics_no | varchar(50) | NULL | 物流运单号 |
| refund_amount | decimal(10,2) | DEFAULT 0.00 | 已退款金额 |
| is_commented | tinyint | DEFAULT 0 | 是否已评价:0-否,1-是 |
| individual_commission_amount | decimal(10,2) | NULL | 个体佣金金额 = 成交价 × 佣金比例(个体分销推广订单必填);运费不计入佣金基数 |
| commission_status | tinyint | DEFAULT 0 | 佣金/分账状态:0-未分账,1-已分账,2-分账失败,3-逆向分账 |
| supplier_real_amount | decimal(10,2) | NULL | 供应商实收价 = 成交价 - 平台服务费 - 应由供应商承担的个体佣金 - 退款冲减 - 其他扣费 |
| platform_service_fee | decimal(10,2) | DEFAULT 0.00 | 该子商品的平台服务费 = 成交价 × 平台服务费率;运费不计入服务费基数 |
| combo_sub_product_id | bigint | NULL | 组合产品中子商品ID(组合产品子商品必填) |
| combo_sub_supplier_id | bigint | NULL | 组合产品中子商品供应商ID(组合产品子商品必填) |
| spec_date | date | NULL | 预约/使用日期(日历库存商品必填) |
| booking_status | tinyint | DEFAULT 0 | 预约状态:0-无需预约,1-待预约,2-已预约,3-预约超时 |
| create_time | datetime | NOT NULL | 创建时间 |
| update_time | datetime | NOT NULL | 最后修改时间 |
9.2.3 核销码表(t_verification_code)
用于存储虚拟商品子订单的核销码,支持一单一码(一个子订单一个统一码)和一票一码(每个使用人/每张票一个独立码)两种模式。部分退改时,对应数量的核销码作废,剩余核销码保留可用。
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| code_id | bigint | PK | 核销码ID |
| order_item_id | bigint | NOT NULL | 关联子订单ID |
| verification_code | varchar(32) | NOT NULL, UNIQUE | 12位数字核销码 |
| status | tinyint | DEFAULT 0 | 状态:0-未核销,1-已核销,2-已作废 |
| verify_time | datetime | NULL | 核销时间 |
| verify_user_id | bigint | NULL | 核销员ID |
| refund_related | tinyint | DEFAULT 0 | 是否因退款作废:0-否,1-是 |
| create_time | datetime | NOT NULL | 创建时间 |
| update_time | datetime | NOT NULL | 最后修改时间 |
9.2.4 结算单表(t_settlement)
结算单用于聚合一次支付行为。当B端分销商通过采购车一次性采购多个供应商商品时,系统生成一个结算单,用户一次性支付后,再按供应商拆分为多个主订单。结算单号不对用户展示,仅用于系统内部关联支付流水与主订单。
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| settlement_id | bigint | PK | 结算单ID |
| settlement_sn | varchar(32) | NOT NULL, UNIQUE | 结算单号,内部使用,不对用户展示 |
| buyer_id | bigint | NOT NULL | 下单主体ID(B端分销商ID或C端用户ID) |
| buyer_type | tinyint | NOT NULL | 下单主体类型:1-C端用户,2-B端分销商 |
| total_amount | decimal(10,2) | NOT NULL | 结算单商品总金额 |
| discount_amount | decimal(10,2) | DEFAULT 0.00 | 优惠金额 |
| pay_amount | decimal(10,2) | NOT NULL | 实付金额 |
| payment_method | tinyint | NULL | 支付方式:1-微信,2-支付宝,3-余额,4-授信额度,5-第三方 |
| payment_sn | varchar(64) | NULL | 第三方支付流水号 |
| pay_time | datetime | NULL | 支付时间 |
| status | tinyint | DEFAULT 0 | 结算单状态:0-待支付,1-已支付,2-已关闭 |
| expire_time | datetime | NOT NULL | 支付超时时间 |
| create_time | datetime | NOT NULL | 创建时间 |
| update_time | datetime | NOT NULL | 更新时间 |
9.2.4 订单状态变更日志表(t_order_status_log)
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| log_id | bigint | PK | 日志ID |
| order_id | bigint | NOT NULL | 订单ID |
| order_item_id | bigint | NULL | 子订单ID(主订单状态变更时为空) |
| from_status | tinyint | NOT NULL | 原状态 |
| to_status | tinyint | NOT NULL | 新状态 |
| operator_type | tinyint | NOT NULL | 操作者类型:1-系统,2-买家,3-供应商,4-平台运营 |
| operator_id | bigint | NULL | 操作人ID |
| operator_name | varchar(50) | NULL | 操作人名称(冗余,便于查看) |
| remark | varchar(200) | NULL | 变更原因/备注 |
| create_time | datetime | NOT NULL | 变更时间 |
9.2.5 预约记录表(t_booking_record)
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| booking_id | bigint | PK | 预约ID |
| order_item_id | bigint | NOT NULL, FK | 关联子订单ID |
| booking_date | date | NOT NULL | 预约游玩/入住日期 |
| booking_time | varchar(20) | NULL | 预约时段(如"10:00-12:00") |
| contact_name | varchar(50) | NOT NULL | 预约人姓名 |
| contact_mobile | varchar(20) | NOT NULL | 预约人手机 |
| id_card_no | varchar(18) | NULL | 身份证号(景区门票等场景) |
| status | tinyint | DEFAULT 1 | 状态:1-待使用,2-已使用,3-已取消 |
| cancel_time | datetime | NULL | 取消时间 |
| operator_id | bigint | NULL | 操作人ID(代客预约时记录) |
| create_time | datetime | NOT NULL | 创建时间 |
| update_time | datetime | NOT NULL | 最后修改时间 |
9.2.6 核销记录表(t_verification_record)
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| record_id | bigint | PK | 记录ID |
| order_item_id | bigint | NOT NULL, FK | 关联子订单ID |
| verifier_id | bigint | NOT NULL | 核销员ID |
| verifier_name | varchar(50) | NOT NULL | 核销员名称 |
| verification_code | varchar(32) | NOT NULL | 核销码 |
| verification_time | datetime | NOT NULL | 核销时间 |
| verify_quantity | int | DEFAULT 1 | 本次核销数量(支持部分核销) |
| device_info | varchar(100) | NULL | 核销设备信息 |
| create_time | datetime | NOT NULL | 创建时间 |
9.2.7 售后申请表(t_after_sale)
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| after_sale_id | bigint | PK | 售后单ID |
| after_sale_sn | varchar(32) | NOT NULL, UNIQUE | 售后单号,格式:SH+YYYYMMdd+6位流水 |
| order_id | bigint | NOT NULL, FK | 关联订单ID |
| order_item_id | bigint | NOT NULL, FK | 关联子订单ID |
| user_id | bigint | NOT NULL | 申请人ID(买家) |
| supplier_id | bigint | NOT NULL | 归属供应商ID |
| apply_type | tinyint | NOT NULL | 售后类型:1-仅退款,2-退货退款 |
| apply_reason | varchar(200) | NOT NULL | 退款原因 |
| apply_amount | decimal(10,2) | NOT NULL | 申请退款金额 |
| evidence_urls | JSON | NULL | 凭证图片URL数组 |
| status | tinyint | DEFAULT 1 | 售后状态:1-待供应商处理,2-供应商同意,3-供应商拒绝,4-平台介入中,5-平台同意退款,6-平台驳回,7-已退款,8-已关闭,9-退款失败 |
| supplier_opinion | varchar(200) | NULL | 供应商处理意见(驳回时必填) |
| supplier_handle_time | datetime | NULL | 供应商处理时间 |
| platform_opinion | varchar(200) | NULL | 平台仲裁意见 |
| platform_handle_time | datetime | NULL | 平台处理时间 |
| platform_handler_id | bigint | NULL | 平台处理人ID |
| refund_amount | decimal(10,2) | DEFAULT 0.00 | 实际退款金额 |
| refund_time | datetime | NULL | 实际退款时间 |
| refund_sn | varchar(64) | NULL | 退款流水号 |
| is_reverse_split | tinyint | DEFAULT 0 | 是否已执行逆向分账:0-否,1-是 |
| create_time | datetime | NOT NULL | 创建时间 |
| update_time | datetime | NOT NULL | 最后修改时间 |
9.2.8 退款记录表(t_refund_record)
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| record_id | bigint | PK | 记录ID |
| after_sale_id | bigint | NOT NULL, FK | 关联售后单ID |
| order_id | bigint | NOT NULL | 关联订单ID |
| refund_amount | decimal(10,2) | NOT NULL | 退款金额 |
| refund_type | tinyint | NOT NULL | 退款类型:1-原路退回,2-退至余额 |
| refund_status | tinyint | DEFAULT 1 | 退款状态:1-处理中,2-成功,3-失败 |
| refund_sn | varchar(64) | NULL | 退款流水号 |
| third_refund_sn | varchar(64) | NULL | 第三方退款流水号 |
| fail_reason | varchar(200) | NULL | 失败原因 |
| create_time | datetime | NOT NULL | 创建时间 |
| complete_time | datetime | NULL | 完成时间 |
9.2.9 支付记录表(t_payment_record)
记录每笔支付与退款的独立流水。正向支付(payment_type=1)关联结算单;逆向退款(payment_type=2)关联售后单与退款记录。支付失败不归为终态,超时或取消后置为已关闭;退款失败时状态回到待退款,允许重试。
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| payment_id | bigint | PK | 支付记录ID |
| payment_sn | varchar(32) | NOT NULL, UNIQUE | 支付流水号 |
| payment_type | tinyint | NOT NULL | 流水类型:1-支付,2-退款 |
| settlement_id | bigint | NULL | 关联结算单ID(正向支付必填) |
| order_id | bigint | NULL | 关联主订单ID(冗余) |
| after_sale_id | bigint | NULL | 关联售后单ID(退款必填) |
| payment_method | tinyint | NOT NULL | 支付方式:1-微信,2-支付宝,3-余额,4-授信额度,5-第三方 |
| amount | decimal(10,2) | NOT NULL | 支付/退款金额 |
| status | tinyint | NOT NULL, DEFAULT 1 | 支付状态:1-待支付,2-支付中,3-支付成功,4-已关闭;退款状态:5-待退款,6-退款中,7-退款成功 |
| third_party_sn | varchar(64) | NULL | 第三方支付渠道流水号 |
| fail_reason | varchar(200) | NULL | 失败原因(失败时记录) |
| create_time | datetime | NOT NULL | 创建时间 |
| pay_time | datetime | NULL | 支付/退款成功时间 |
| close_time | datetime | NULL | 关闭时间 |
9.2.10 发票申请表(t_invoice_application)
发票由供应商开具,按子订单维度管理。买家可对每个子订单申请发票,一个子订单可开一张发票。
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| invoice_id | bigint | PK | 发票ID |
| order_item_id | bigint | NOT NULL, FK | 关联子订单ID |
| order_id | bigint | NOT NULL | 关联订单ID(冗余,便于查询) |
| user_id | bigint | NOT NULL | 申请人ID |
| invoice_type | tinyint | NOT NULL | 发票类型:1-增值税普通发票(电子),2-增值税专用发票 |
| title_type | tinyint | NOT NULL | 抬头类型:1-个人,2-企业 |
| title_name | varchar(100) | NOT NULL | 抬头名称 |
| tax_no | varchar(30) | NULL | 税号(企业抬头必填) |
| varchar(100) | NOT NULL | 接收邮箱 | |
| file_url | varchar(500) | NULL | 电子发票PDF/OFD地址 |
| status | tinyint | DEFAULT 1 | 发票状态:1-待开票,2-已开票,3-已红冲 |
| supplier_id | bigint | NOT NULL | 开票供应商ID |
| apply_time | datetime | NOT NULL | 申请时间 |
| finish_time | datetime | NULL | 开票完成时间 |
| cancel_time | datetime | NULL | 作废时间 |
9.2.11 评价表(t_comment)
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| comment_id | bigint | PK | 评价ID |
| order_item_id | bigint | NOT NULL, FK | 关联子订单ID |
| order_id | bigint | NOT NULL | 关联订单ID |
| user_id | bigint | NOT NULL | 评价用户ID |
| spu_id | bigint | NOT NULL | 商品SPU ID |
| supplier_id | bigint | NOT NULL | 供应商ID |
| rating | tinyint | NOT NULL | 评分:1-5星 |
| content | text | NULL | 评价内容 |
| image_urls | JSON | NULL | 评价图片URL数组 |
| reply_content | varchar(500) | NULL | 商家回复内容 |
| reply_time | datetime | NULL | 商家回复时间 |
| is_anonymous | tinyint | DEFAULT 0 | 是否匿名:0-否,1-是 |
| status | tinyint | DEFAULT 1 | 状态:1-正常,2-隐藏 |
| create_time | datetime | NOT NULL | 创建时间 |
9.2.12 订单备注表(t_order_remark)
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| remark_id | bigint | PK | 备注ID |
| order_id | bigint | NOT NULL, FK | 关联订单ID |
| content | varchar(500) | NOT NULL | 备注内容 |
| operator_id | bigint | NOT NULL | 操作人ID |
| operator_name | varchar(50) | NOT NULL | 操作人名称 |
| operator_type | tinyint | NOT NULL | 操作者类型:3-供应商,4-平台运营 |
| create_time | datetime | NOT NULL | 创建时间 |
9.2.13 调价记录表(t_price_change_record)
记录市场价、实际售价、底价、限价、专属价等价格变更历史,满足价格变更留痕要求。字段与供应链管理中心PRD保持一致,分销中心价格变更同步写入本表。
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| record_id | bigint | PK AUTO_INCREMENT | 记录ID |
| tenant_type | varchar(20) | NOT NULL | PLATFORM/SUPPLIER/DISTRIBUTOR |
| tenant_id | bigint | NOT NULL | 租户ID |
| biz_type | varchar(50) | NOT NULL | 业务对象类型:spu / sku / calendar_inventory / authorization / platform_limit |
| biz_id | bigint | NOT NULL | 业务对象ID |
| sku_id | bigint | NULL | SKU ID,SKU或日历库存时填写 |
| spec_date | date | NULL | 日历库存日期,非日历场景为空 |
| price_type | varchar(50) | NOT NULL | 价格类型:market_price / sale_price / base_price / limit_price / exclusive_price |
| old_value | decimal(12,2) | NULL | 调整前价格,新建时为空 |
| new_value | decimal(12,2) | NOT NULL | 调整后价格 |
| change_reason | varchar(500) | NULL | 调价原因 |
| source | varchar(50) | DEFAULT 'manual' | 调价来源:manual手动 / import批量导入 / ai智能填报 / api同步 |
| operator_id | bigint | NOT NULL | 操作人ID |
| operator_name | varchar(100) | NULL | 操作人姓名 |
| status | varchar(20) | DEFAULT 'effective' | effective已生效 / pending待生效 / revoked已撤销 |
| effective_time | datetime | NULL | 计划生效时间,为空表示即时生效 |
| create_time | datetime | NOT NULL | 创建时间 |
9.2.14 SPU下单配置表(t_spu_order_config)
SPU下单配置表由供应链模块在商品发布时维护,订单模块在下单和核销时读取。一个SPU对应一条配置记录,通过spu_id关联t_spu主表。字段与供应链管理中心PRD保持一致,配置字段驱动下单页动态渲染和核销规则判断。
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| config_id | bigint | PK | 配置记录ID |
| spu_id | bigint | NOT NULL, UNIQUE | 关联商品SPU ID,一对一 |
| is_show_buy_notice | tinyint | DEFAULT 1 | 是否展示购买须知:1-展示,0-不展示 |
| enable_sku | tinyint | DEFAULT 1 | 是否选择SKU规格:1-需要,0-无SKU直接购买 |
| inventory_type | varchar(20) | DEFAULT 'calendar' | 库存类型:calendar-日历库存;total_inventory-总库存 |
| is_time_slot_enabled | tinyint | DEFAULT 0 | 是否启用时段库存:1-是,0-否 |
| advance_book_days | int | DEFAULT 0 | 提前预定天数:0=可订今日,1=需提前1天,N=需提前N天 |
| advance_book_time | varchar(10) | NULL | 提前预定截止时间 |
| cutoff_time | varchar(10) | DEFAULT '00:00' | 每日截止下单时间(如17:00),超过后不可订当日 |
| order_time_start | varchar(10) | NULL | 每日允许下单开始时间 |
| order_time_end | varchar(10) | NULL | 每日允许下单结束时间 |
| sale_region_limit_enabled | tinyint | DEFAULT 0 | 是否启用购买区域限制:1-是,0-否 |
| sale_region_geo | json | NULL | 购买区域GeoJSON多边形 |
| group_guide_certificate_required | tinyint | DEFAULT 0 | 团队订单是否需导游证件:1-是,0-否 |
| group_guide_real_name_required | tinyint | DEFAULT 0 | 团队订单是否需导游实名:1-是,0-否 |
| group_itinerary_required | tinyint | DEFAULT 0 | 团队订单是否需上传行程单:1-是,0-否 |
| package_only | tinyint | DEFAULT 0 | 是否仅允许组合套餐引用:1-是,0-否 |
| stock_mode | varchar(20) | DEFAULT 'independent' | 库存池模式:shared-共享库存;independent-独立控位 |
| stock_warning_notify_mode | varchar(100) | DEFAULT 'site' | 库存预警通知方式:site站内 / sms短信 / email邮件,多选用逗号分隔 |
| enable_real_name | tinyint | DEFAULT 0 | 是否实名制:1-每个使用人需填写姓名/身份证/手机号,0-无需 |
| require_certificate | tinyint | DEFAULT 0 | 是否上传证件:1-下单时需上传证件图片(如教师资格证),0-无需 |
| certificate_type | varchar(50) | NULL | 证件类型标签:teacher/student/senior/soldier/guide等,多个用逗号分隔 |
| require_guide_info | tinyint | DEFAULT 0 | 是否填写导游信息:1-需填写导游姓名/导游证号/手机号,0-无需 |
| require_itinerary | tinyint | DEFAULT 0 | 是否上传行程单:1-下单时需上传行程单(PDF/图片),0-无需 |
| verify_before_use | tinyint | DEFAULT 0 | 与 manual_accept_order 等价:1-支付后进入待供应商确认收单状态,供应商确认收单(审核通过)后才可核销;0-无需 |
| verification_type | varchar(20) | DEFAULT 'one_ticket_one_code' | 核销方式:one_order_one_code-一单一码;one_ticket_one_code-一票一码;manual_confirm-手动确认;none-无需核销 |
| allow_partial_use | tinyint | DEFAULT 1 | 是否支持部分核销:1-支持(如10张核销3张剩余7张可用);0-不支持(必须整单核销) |
| auto_accept_order | tinyint | DEFAULT 1 | 是否自动收单:1-支付成功后自动进入已收单;0-不自动收单 |
| manual_accept_order | tinyint | DEFAULT 0 | 是否手动收单:1-支付成功后保持已支付,等待供应商确认接单后进入已收单(与 verify_before_use 等价);0-否 |
| create_time | datetime | NOT NULL | 创建时间 |
| update_time | datetime | NOT NULL | 最后修改时间 |
9.2.15 AI填报任务表(ai_form_fill_task)
记录一次AI智能填报任务的元数据。任务在下单确认页/购物车商品实名信息区发起,订单尚未创建,因此target_object_id使用预下单标识或购物车标识;任务完成后保留30天用于审计追溯。
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| task_id | bigint | PK | 任务ID |
| task_sn | varchar(32) | NOT NULL, UNIQUE | 任务流水号,格式:AIT+YYYYMMdd+8位流水 |
| tenant_id | bigint | NOT NULL | 租户ID |
| scenario_code | varchar(50) | NOT NULL | 场景编码,固定为traveler_realname_fill |
| target_object_type | varchar(50) | NOT NULL | 目标对象类型:pre_order_token(下单页)/ cart_item_id(购物车商品) |
| target_object_id | varchar(100) | NOT NULL | 目标对象标识:预下单token或购物车商品记录ID |
| spu_id | bigint | NOT NULL | 关联商品SPU ID |
| source_type | varchar(20) | NOT NULL | 输入来源:text/image/excel/pdf/docx/mixed |
| task_status | tinyint | NOT NULL, DEFAULT 1 | 任务状态:1-识别中,2-识别完成,3-识别失败,4-已取消 |
| created_by | bigint | NOT NULL | 创建人ID |
| created_at | datetime | NOT NULL | 创建时间 |
| completed_at | datetime | NULL | 识别完成时间 |
| ai_model | varchar(50) | NULL | 调用模型标识 |
| quota_cost | int | DEFAULT 0 | 本次任务消耗的AI额度(按识别次数或页数计费) |
| error_code | varchar(50) | NULL | 错误码 |
| error_message | varchar(500) | NULL | 错误信息 |
| retention_expire_at | datetime | NOT NULL | 临时数据保留过期时间,默认created_at+30天 |
| create_time | datetime | NOT NULL | 创建时间 |
| update_time | datetime | NOT NULL | 最后更新时间 |
9.2.16 AI识别结果表(ai_form_fill_result)
存储AI识别出的单条结构化结果,供人工复核。确认导入后写入下单页实名信息表单;最终结果行保留30天用于审计。
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| result_id | bigint | PK | 结果ID |
| task_id | bigint | NOT NULL, FK | 关联任务ID |
| row_no | int | NOT NULL | 识别序号,同一任务内从1递增 |
| raw_text | text | NULL | 原始识别文本片段或OCR结果 |
| structured_json | JSON | NOT NULL | AI结构化字段JSON,包含traveler_name/gender/birthday/mobile/cert_type/cert_no/cert_expire_date等 |
| confidence_json | JSON | NULL | 各字段识别置信度JSON |
| validation_json | JSON | NULL | 校验结果JSON:必填缺失、格式错误、证件号重复等 |
| review_status | tinyint | NOT NULL, DEFAULT 1 | 复核状态:1-待复核,2-已确认,3-已忽略,4-需补充,5-有冲突 |
| reviewed_json | JSON | NULL | 人工复核修正后的字段JSON |
| import_status | tinyint | NOT NULL, DEFAULT 0 | 导入状态:0-未导入,1-导入成功,2-导入失败 |
| fail_reason | varchar(500) | NULL | 导入失败原因 |
| reviewed_by | bigint | NULL | 复核人ID |
| reviewed_at | datetime | NULL | 复核时间 |
| create_time | datetime | NOT NULL | 创建时间 |
| update_time | datetime | NOT NULL | 最后更新时间 |
9.2.17 租户AI额度表(ai_tenant_quota)
记录租户级AI智能填报可用额度,识别任务提交时扣减,额度不足时禁止提交。额度管理后台由系统管理模块维护。
| 字段名 | 数据类型 | 约束 | 说明 |
|---|---|---|---|
| quota_id | bigint | PK | 额度记录ID |
| tenant_id | bigint | NOT NULL, UNIQUE | 租户ID |
| quota_type | tinyint | NOT NULL, DEFAULT 1 | 额度类型:1-按识别次数,2-按识别页数,3-按token数 |
| total_quota | bigint | NOT NULL | 总额度 |
| used_quota | bigint | NOT NULL, DEFAULT 0 | 已用额度 |
| reset_cycle | tinyint | DEFAULT 0 | 重置周期:0-一次性,1-按月,2-按年 |
| reset_day | tinyint | DEFAULT 1 | 重置日(如每月1日) |
| last_reset_at | datetime | NULL | 上次重置时间 |
| status | tinyint | DEFAULT 1 | 状态:1-启用,0-停用 |
| create_time | datetime | NOT NULL | 创建时间 |
| update_time | datetime | NOT NULL | 最后更新时间 |
9.3 数据一致性约束
- 订单金额一致性:t_order.pay_amount = SUM(t_order_item.total_amount) - t_order.discount_amount + t_order.freight_amount
- 结算单金额一致性:t_settlement.pay_amount = SUM(关联主订单.pay_amount)
- 子订单状态一致性:当同一主订单下所有子订单item_status均达到7(已完成)时,该主订单order_status必须同步更新为7(已完成)
- 结算单状态一致性:结算单支付成功后,其关联的所有主订单应同步从「待支付」更新为「已支付」
- 库存一致性:t_calendar_inventory.total_stock = locked_stock + sold_stock + available_stock 必须始终成立
- 售后金额约束:t_after_sale.apply_amount <= t_order_item.total_amount - t_order_item.refund_amount
- 发票金额约束:发票金额 ≤ 对应子订单实付金额 - 该子订单已退款金额
- 价格唯一性约束:同一商品、同一SKU、同一渠道、同一授权对象、同一时间段,只能有一条生效底价
- SPU配置一致性:t_spu_order_config.spu_id 必须在 t_spu 中存在,且一对一。删除SPU时级联删除配置记录
- AI额度一致性:ai_tenant_quota.used_quota 必须小于等于 total_quota。额度扣减使用原子操作,防止超扣
- AI任务幂等:同一 task_id 下同一 result_id 只允许导入一次;确认填入接口需校验 import_status,已导入成功的 result_id 不允许重复确认
- AI数据保留:ai_form_fill_task 和 ai_form_fill_result 的 retention_expire_at 到期后由定时任务清理;任务元数据和操作日志保留时间不少于1年
10B端分销商采购下单管理
B端分销商采购下单是订单履约链路的起点。分销商在PC端分销商城可通过两种方式下单:① 单个商品「立即采购」,直接进入该商品的下单页;② 多个商品「加入采购车」,统一进入下单页后逐个商品填写信息并一次性提交。本章覆盖从选品到支付完成的全链路交互。
10.1 余额体系
10.1.1 余额分类
| 余额类型 | 来源 | 用途 | 可提现 | 有效期 | 扣款优先级 |
|---|---|---|---|---|---|
| 实际余额 | 线下充值(银行转账至平台监管账户),平台运营审核通过后入账 | 采购下单消费 | 不可提现(仅可消费) | 永久有效 | 第一优先 |
| 授信额度 | 平台/供应商授予的赊购额度,支持审批流程,可配置有效期 | 采购下单消费 | 不可提现 | 按配置有效期,到期前7天提醒,到期自动回收 | 第二优先(实际余额不足时自动使用) |
| 冻结余额 | 提现申请审核中、对账争议中的部分金额 | 不可消费 | 不可提现 | 冻结期间 | 不参与扣款 |
10.1.2 余额计算公式
10.1.3 余额变动记录
- 变动类型:充值入账、采购消费、授信调整(增加/减少/回收)、退款退回、冻结/解冻。所有变动写入t_balance_log表,包含时间、金额、变动类型、关联结算单号/订单号、操作人
- 余额查询:分销商可在PC端实时查看实际余额、授信额度、总可用余额、已冻结金额。供应商可查看其专属分销商的额度使用情况
- 预警机制:余额低于阈值时(默认500元),系统自动发送站内信提醒充值。阈值可由分销商自定义
10.2 采购下单核心流程
10.2.1 两种采购入口
| 入口 | 适用场景 | 流程 |
|---|---|---|
| 立即采购 | 单个商品直接下单 | 分销商城商品卡片点击「立即采购」→ 进入该商品下单页 → 填写信息 → 确认下单 → 支付 |
| 加入采购车 | 多个商品统一结算 | 商品卡片点击「加入采购车」→ 继续选购 → 点击「去结算」→ 进入下单页逐个商品填写信息 → 确认下单 → 一次性支付 |
10.2.2 核心业务逻辑
- 选品与加购:B端分销商在PC端分销商城浏览商品,根据可见范围控制(全渠道B端/指定分组)展示可采购商品。商品卡片提供「立即采购」和「加入采购车」两个按钮
- 采购车管理:采购车按供应商分组展示已加购商品,支持修改数量、删除、清空。采购车数据跨设备同步
- 进入下单页:点击「立即采购」或采购车「去结算」后,进入下单页。下单页展示所有待下单商品,每个商品独立填写下单信息
- 逐个商品填写信息:每个商品区域根据该商品SPU的t_spu_order_config配置动态渲染表单:
① 选择SKU规格(enable_sku=1)
② 选择日期/时段(inventory_type='calendar')
③ 填写实名信息(enable_real_name=1),购买N张需填写N组实名信息
④ 上传证件(require_certificate=1)
⑤ 填写导游信息(require_guide_info=1)
⑥ 上传行程单(require_itinerary=1)
⑦ 阅读并勾选购买须知(is_show_buy_notice=1) - 底价计算:每个商品独立按底价优先级规则取生效底价,页面展示「当前生效价来源」,例如:来源:授权产品 / 指定分销商专属底价。采购金额 = 底价 × 数量 + 运费(如有)
- 确认下单:点击「确认下单」后,系统生成 1 个内部结算单(状态:待支付),并按供应商拆分为 N 个主订单(状态:待支付),每个主订单内按 SKU + 使用人 拆分为子订单(状态:待支付)
- 支付方式选择:下单页提供三种支付方式三选一,一个结算单仅允许使用一种支付方式,不可混用:
① 余额支付——使用实际余额全额支付,余额不足时不可选择此方式,需先去充值
② 授信额度支付——使用授信额度全额支付,额度不足或已过期时不可选择此方式,需先申请调额
③ 在线支付——通过微信/支付宝/第三方支付全额支付,拉起对应支付渠道收银台 - 支付方式校验:选择余额支付时校验实际余额 >= 结算单应付金额,不足时该选项置灰并提示"余额不足,当前余额X元,需Y元";选择授信支付时校验授信额度 >= 结算单应付金额,不足时置灰并提示"额度不足"
- 库存锁定:确认下单时锁定库存(日历模式扣减对应日期的locked_stock),使用乐观锁防超卖。支付成功后锁定库存转为 sold_stock
- 支付与拆单:用户一次性支付结算单金额。支付成功后,结算单状态变为「已支付」,所有关联主订单及子订单同步变为「已支付」
- 收单处理:已支付订单进入收单流程。供应商确认接单后变为「已收单」;若 SPU 配置为自动接单,则支付成功后立即变为「已收单」。超时未接单或供应商拒单则自动关闭订单并退款
- 收单后履约:已收单后进入统一履约执行阶段。日历商品通过 booking_status 跟踪预约,实物商品通过 shipping_status 跟踪发货,到店核销商品通过 verification_status 跟踪核销。履约完成后订单状态变为已完成
- 订单类型与渠道:B端采购订单的 source_channel=2(B端分销),order_type=1(普通订单),distributor_id 记录当前分销商
10.2.3 拆单规则
| 层级 | 拆分依据 | 说明 |
|---|---|---|
| 结算单 | 一次「确认下单」行为 | 内部单据,聚合一次支付,结算单号不对用户展示 |
| 主订单 | 按 供应商 拆分 | 不同供应商独立履约、结算、售后、发票 |
| 子订单 | 按 SKU + 使用人 拆分 | 最小履约和退款单元;实名制商品一个使用人一条子订单 |
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.3 批量填写使用人信息
10.3.1 核心业务逻辑
- 使用场景:当B端分销商一次性采购多张同类实名制商品(如团队采购10张门票)时,需要为每张门票录入不同使用人的实名信息。系统支持在下单页面以表格形式批量录入,提升录入效率
- 触发条件:商品 enable_real_name=1 且购买数量 > 1 时,该商品在下单页自动展开"批量录入使用人信息"区域
- 录入方式:表格形式,每行对应一个使用人,列包括:序号、姓名、身份证号、手机号。系统根据购买数量自动生成对应行数
- 三种填写入口:实名信息区提供三种并行入口,用户可任选其一:
- 手动录入:在表格中逐行填写姓名、身份证号、手机号
- Excel/CSV导入:上传固定模板的Excel/CSV文件,系统直接解析并填充到表格中
- AI智能填报:通过粘贴文本或上传图片/Excel/PDF/DOCX,由AI识别并结构化实名信息后,人工复核确认填入
- 身份证格式校验:前端实时校验身份证号格式(18位,最后一位可为X),格式错误时该单元格标红提示
- 重复校验:同一商品内不允许出现重复的身份证号,重复时标红提示"该身份证已录入"
- 自动填充:支持从Excel/CSV导入实名信息(姓名、身份证、手机号三列),系统自动解析并填充到表格中
- 历史联系人:分销商可从"常用联系人"中选择已有记录快速填充,减少重复录入
- 批量限制:单次批量录入最多100人,超过时提示"单次最多录入100人,请分批下单"
- 子订单生成:批量录入的 N 组实名信息,最终生成 N 条子订单,每条子订单对应一个使用人,便于后续按人名退款
- 不可补录约束:实名信息必须在下单前完成。订单创建后(待支付及之后状态),不允许再通过AI智能填报或任何批量方式补录/修改实名信息
10.3.2 批量填写使用人信息页-原型
10.3.3 AI智能填报详细设计
10.3.3.1 功能定位
AI智能填报是批量填写使用人信息的第三种可选方式,与手动录入、Excel导入并行。用户在下单确认页或购物车结算页点击「AI智能填报」后,通过粘贴文本或上传图片/Excel/PDF/DOCX,由AI识别并结构化出姓名、身份证号、手机号等实名字段,再经人工复核确认后一键填入当前商品的实名信息表格。AI识别结果不直接写入业务表,必须经过人工确认。
10.3.3.2 触发入口
- 入口位置:下单确认页/购物车结算页中,每个 enable_real_name=1 的商品实名信息区右上角
- 入口形态:与「从Excel导入」「从常用联系人选择」并列的按钮「AI智能填报」
- 权限控制:当前用户具备该商品所在订单的编辑权限时可见;所有可编辑订单的B端分销商均可使用
- 额度控制:租户AI额度不足或额度状态停用时,按钮置灰,Hover提示"当前AI额度不足,请联系管理员"
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结构化 |
| 混合输入 | 文本 + 多附件 | 同一任务可上传多个文件并粘贴文本,合并识别后统一返回结构化结果 |
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 覆盖规则
- 去重键:以证件号码(cert_no)作为同一商品内同一使用人的唯一标识
- 新增:AI识别出的证件号在当前商品实名表格中不存在时,确认后新增一行
- 覆盖:AI识别出的证件号在当前商品实名表格中已存在时,确认后用AI结果覆盖原记录的姓名、性别、出生日期、手机号、证件类型、证件有效期
- 数量限制:确认填入的行数不能超过当前商品的购买数量;超出时提示"超出购买数量,请先调整数量或删除多余行"
- 部分导入:支持只导入校验通过的行;校验失败或用户忽略的行保留在复核页,用户修正后可再次确认
10.3.3.8 额度管理
- 扣减时机:用户提交AI识别任务时立即扣减租户AI额度
- 扣减单位:按任务维度扣减,每个识别任务消耗1次额度;混合输入不重复计费
- 额度不足:提交时校验tenant_id对应ai_tenant_quota余额,不足则拦截并提示"当前AI额度不足,请联系管理员"
- 额度返还:识别失败、用户取消、未确认导入均不返还额度
- 额度重置:支持按月/按年/一次性三种周期,重置日由系统管理后台配置
10.3.3.9 安全与留痕
- 敏感信息脱敏:身份证号、手机号在复核表格中默认脱敏展示(如110101********1234、138****5678),编辑态按用户权限展示完整内容
- 加密传输与存储:完整身份证号、手机号在前后端传输和数据库落库时加密
- 操作留痕:AI任务创建、识别结果返回、人工复核修改、确认填入等操作均记录操作日志,包含操作人、时间、任务ID、结果ID
- 数据保留:ai_form_fill_task和ai_form_fill_result保留30天,到期后由定时任务清理;任务元数据和操作日志长期保留
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.5.2 下单页原型
10.6 采购下单状态说明表
| 状态码 | 状态名称 | 触发条件 | 后续操作 |
|---|---|---|---|
| 0 | 待支付 | 点击"确认下单"后生成结算单,等待支付 | 30分钟超时自动关闭 |
| 1 | 已支付 | 余额扣款成功/授信扣款成功/在线支付成功 | 同步更新所有关联主订单/子订单为已支付,并触发收单流程 |
| 2 | 已关闭 | 支付超时/取消/失败或分销商手动关闭 | 释放库存,如已扣款则原路退回 |
10.7 异常处理
| 异常场景 | 现象 | 处理方案 |
|---|---|---|
| 余额不足 | 选择余额支付时,实际余额 < 结算单应付金额 | 该支付方式选项置灰,提示"余额不足,当前余额X元,需Y元"。可点击"去充值"或切换其他支付方式 |
| 授信额度不足/过期 | 授信额度 < 结算单金额或额度已到期 | 选项置灰,提示"额度不足"或"授信额度已到期,请充值后下单"。可切换其他支付方式 |
| 部分商品库存不足 | 购物车统一提交时,部分商品库存不足 | 阻止整个结算单生成,在对应商品位置提示"库存不足,剩余N件"。分销商可修改数量或删除该商品后重新提交 |
| 余额扣款成功但库存扣减失败 | 库存不足导致下单失败,但余额已扣 | 立即回滚余额扣款,生成逆向流水记录。前端提示"库存不足,已退还余额" |
| 授信扣款成功但库存扣减失败 | 库存不足导致下单失败,但授信额度已扣 | 立即回滚授信扣减,生成逆向流水记录。前端提示"库存不足,已恢复授信额度" |
| 在线支付成功但库存扣减失败 | 库存不足导致下单失败,但微信/支付宝已扣款 | 立即调用支付渠道退款接口原路退回,提示"库存不足,已在线退款,1-3个工作日到账" |
| 在线支付超时/失败 | 微信/支付宝收银台30分钟内未完成支付,或支付渠道返回失败 | 结算单状态回到"待支付"或"已关闭"(超过整单有效期后),主订单/子订单不生成或保持待支付。已扣款金额原路退回。提示"支付失败,请重新支付或取消" |
| 收单超时 | 手动收单/审核收单场景下,供应商超过超时时间(默认30分钟)未确认接单 | 订单自动关闭并全额退款,关闭原因="收单超时" |
| 供应商拒单 | 供应商点击"拒绝接单" | 订单立即关闭并全额退款,关闭原因="供应商拒单" |
| 实名信息不完整 | 必填字段未填写或格式错误 | 前端拦截提交,标红未填写/错误的字段,页面自动滚动到第一个错误位置 |
| 身份证号重复 | 同一商品内录入重复身份证号 | 重复行标红提示"该身份证已录入",阻止提交 |
| Excel导入格式错误 | 上传的Excel列名不符合要求 | 提示"文件格式错误,请检查列名(姓名、身份证号、手机号)",允许重新上传 |
| Excel导入行数超限 | Excel中包含超过100行的数据 | 自动截断至100行,提示"仅导入前100人,超出部分已忽略" |
| 商品已下架 | 下单时商品已下架或已不可见 | 页面加载时即提示"该商品已下架,无法下单",隐藏"确认下单"按钮 |
| 商品价格变更 | 供应商在分销商下单前修改了底价 | 页面加载时显示最新底价,如价格已变更提示"商品价格已更新" |
| 批量录入超限 | 购买数量超过100人 | 数量输入框最大限制100,超限输入时提示"单次最多购买100人" |
| 结算单支付成功但部分主订单生成失败 | 分布式事务异常导致部分主订单未生成 | 记录异常日志并触发告警,已成功生成的主订单正常履约,失败的主订单自动退款对应金额至分销商账户 |
11订单处理中心
订单处理中心是履约管理的核心入口,覆盖订单列表查询、详情查看、状态追踪、导出、强制取消、备注管理等全场景。三端用户(平台/供应商/分销商)共用同一套列表组件,但数据范围和操作权限严格隔离。
11.1 核心业务逻辑
- 订单列表查询:支持订单号、买家手机号(脱敏)、商品名称、订单状态、订单类型、支付方式、时间范围、供应商(平台端可见)、分销商(平台端可见)等9个维度的组合筛选
- 数据权限过滤:后端查询时自动拼接tenant_type+tenant_id条件。平台端tenant_type=PLATFORM无限制;供应商端tenant_type=SUPPLIER且supplier_id=当前供应商ID;分销商端tenant_type=DISTRIBUTOR且distributor_id=当前分销商ID
- 子订单状态聚合:列表中展示主订单状态,详情页展示各子订单独立履约状态。主订单状态=所有子订单状态的"最保守"聚合(如有任意子订单为"售后处理中",主订单状态即显示"售后处理中")
- 履约中状态聚合规则:当主订单下存在至少一个子订单 item_status=5(履约中)或 item_status=6(已发货)且未全部完成时,主订单 order_status=5(履约中);全部子订单均达到 item_status=7(已完成)时,主订单 order_status=7(已完成)
- 退款状态聚合规则:当主订单下全部子订单 refund_status=2(退款成功)时,主订单 order_status=9(已退款);部分子订单退款成功但其他子订单已完成时,主订单 order_status=7(已完成),财务通过 refund_status 识别退款子订单
- 关闭状态口径:已关闭仅用于无资金往来的订单终止场景(支付超时/用户取消/平台强制取消/供应商拒单/收单超时);凡是有资金原路退回的,统一使用已退款
- 订单详情全景展示:详情页分为4个Tab——商品信息(子订单列表)、支付信息(金额明细+支付流水)、履约信息(发货/核销/预约状态)、操作日志(时间轴形式)
- 订单导出异步化:数据量>5000条时走后台异步任务,生成完成后通过站内信通知下载
- 强制取消权限:仅平台订单运营角色可执行强制取消,取消时必须填写原因(必填,最少10字),取消后触发库存释放和退款(如已支付)
- 订单备注:平台运营和供应商管理员均可添加备注,备注内容仅内部可见(买家不可见),按时间倒序展示
- 快捷待办入口:列表顶部提供“已支付/已收单/履约中/已发货/售后中”快捷按钮,帮助运营和供应商快速定位当前需处理的订单。数量为 0 时按钮置灰
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:平台运营端订单列表页原型
| 订单号 | 下单时间 | 买家信息 | 商品信息 | 实付金额 | 状态 | 供应商 | 分销商 | 操作 |
|---|---|---|---|---|---|---|---|---|
| DD2026070601234567 | 2026-07-06 14:30 | 张三 138****1234 | 西湖门票x2 | 198.00 | 已完成 | 杭州文旅 | 平台直售 | 详情 |
| DD2026070601234568 | 2026-07-06 15:10 | 李四 139****5678 | 灵隐寺门票x1+文创x1 | 256.00 | 已收单 | 杭州文旅 | 小王旅游 | 详情 |
| DD2026070601234569 | 2026-07-06 16:00 | 王五 137****9012 | 千岛湖酒店x1晚 | 888.00 | 已收单 | 千岛湖度假 | 平台直售 | 详情 |
11.3.2 订单详情Drawer原型
图11-2:订单详情Drawer原型(平台运营端)
订单详情 DD2026070601234567
×| SKU图片 | 商品名称 | SKU | 单价 | 数量 | 小计 | 状态 | 核销码 |
|---|---|---|---|---|---|---|---|
| [图] | 西湖门票 | 成人票 | 99.00 | 2 | 198.00 | 已完成 | 123456789012 |
11.4 状态说明表
| 状态 | 页面表现(Tag颜色) | 触发条件 | 可执行操作 |
|---|---|---|---|
| 待支付 | 蓝色Tag | 订单创建后未支付 | 查看详情;平台可强制取消;用户可手动取消 |
| 支付中 | 蓝色Tag | 用户发起在线支付,等待渠道回调 | 查看详情;查询支付结果 |
| 已支付 | 蓝色Tag | 支付成功回调触发,尚未收单 | 查看详情;等待供应商收单;平台可特殊处理 |
| 已收单 | 绿色Tag | 供应商已确认承接订单,等待履约(发货/预约/核销) | 查看详情;进入发货/预约/核销流程;买家可申请售后 |
| 履约中 | 蓝色Tag | 部分子订单已开始履约(已发货/已预约/已部分核销),但尚未全部完成 | 查看详情;查看子订单履约明细;买家可申请售后 |
| 已发货 | 绿色Tag | 供应商已发货或自提标记完成 | 查看详情;查看物流/自提信息;买家可申请售后 |
| 已完成 | 绿色Tag | 所有子订单均发货/核销完成且无未结售后 | 查看详情;触发分账;买家可评价;可申请售后(限定期内) |
| 已关闭 | 灰色Tag | 无资金往来的订单关闭:支付超时/用户取消/平台强制取消/供应商拒单/收单超时 | 仅查看详情(只读) |
| 已退款 | 灰色Tag | 全部子订单退款成功,有资金原路退回 | 查看详情;查看退款流水;财务对账 |
| 售后处理中 | 橙色Tag | 买家发起售后申请后 | 查看详情;供应商一审;平台终审仲裁 |
| 履约异常 | 红色Tag | 预约/发货/核销/OTA回传等环节失败 | 查看详情;人工特殊处理;可协商退款或重新履约 |
| OTA回传失败 | 红色Tag | OTA订单或状态回传接口失败 | 查看详情;手动重试;重试成功后若尚未收单则进入"已收单",若已开始履约则进入"履约中";多次失败或确认无法回传后可人工关闭订单,状态变为"已关闭" |
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 核心业务逻辑
- 预约触发条件:商品SPU的sale_type=1(日历模式)时,支付成功后子订单进入"待预约"状态(booking_status=1),需买家或供应商选择具体使用日期
- 预约时限:默认支付成功后7天内必须完成预约,超时未预约系统自动发送提醒(短信+站内信),超14天未预约平台运营可代客预约或协商退款
- 日历库存校验:选择预约日期时,系统实时查询t_calendar_inventory的available_stock,库存不足时该日期灰色不可选
- 预约修改规则:已预约订单在"已收单"状态下,买家可申请修改预约日期(限1次),供应商审核通过后更新booking_date。修改时须重新校验目标日期库存
- 代客预约:平台运营和供应商管理员可在后台直接为买家选择预约日期,无需买家操作。代客预约后发送通知告知买家
- 批量预约:平台运营可勾选多个待预约订单,批量选择同一日期完成预约(适用于团队订单)
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 核心业务逻辑
- 核销码生成:虚拟商品支付成功后(或预约成功后),系统根据商品 SPU 配置的 verification_type 生成核销码,存储于 t_order_item 及 t_verification_code 表:
① 一单一码(one_order_one_code):一个子订单生成一个统一 12 位数字核销码,整单一次性核销,不允许部分退改。
② 一票一码(one_ticket_one_code):每个使用人/每张票生成一个独立 12 位数字核销码,支持部分核销和部分退改。 - 部分退改时的核销码处理:一票一码场景下,买家对子订单中部分数量申请退款/退改并经审核通过后,系统将该部分数量对应的核销码状态变更为"已作废",剩余未退款数量对应的核销码保持"未核销"状态,可继续使用。
- 核销员管理:供应商管理员在后台创建核销员账号(独立于系统用户体系),设置核销员姓名、手机号、可核销商品范围。核销员凭手机号+验证码登录移动端核销页面
- 核销方式:PC端支持手动输入核销码完成核销(主要用于补核销场景);移动端支持扫码核销(扫描买家出示的核销码二维码)
- 部分核销:当子订单 quantity>1 且为一票一码时,支持分次核销。首次核销后 item_status=5(履约中),verification_status=1(部分核销);累计核销数量=quantity 时 item_status=7(已完成),verification_status=2(全部核销)
- 核销后触发:子订单全部核销完成后,更新 item_status=7(已完成),触发分账流程(调用分账服务)
- 重复核销防护:同一核销码在"已核销"或"已作废"状态下再次核销,系统提示"该核销码已完成核销或已作废,不可重复核销"
- 跨店核销限制:核销员只能核销归属自己供应商且在自己可核销商品范围内的订单
- 核销规则配置驱动:核销逻辑根据 SPU 在 t_spu_order_config 中的配置动态执行:
① verify_before_use=1(与 manual_accept_order 等价)时,支付成功后订单状态为"已支付"(待供应商确认收单/审核),供应商在后台确认收单(查看证件/行程单/导游信息后点击"确认收单")后状态变为"已收单"并生成核销码;确认收单驳回则退款并关闭订单。不单独设置"待审核"状态
② verification_type=one_ticket_one_code 时,每个使用人/每张票生成独立核销码,一码一票一用;verification_type=one_order_one_code 时,一个子订单共享一个核销码,一码全单通用
③ allow_partial_use=1 时支持分次核销(如10张先核销3张);allow_partial_use=0 时必须一次性核销全部数量,不可部分核销
④ 酒店/包车等非门票类商品(inventory_type='calendar' 且非门票场景)不使用核销码,由供应商在订单详情页点击"确认入住"/"确认还车"完成履约
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.2.4 核销状态说明表
| 核销状态 | 页面表现 | 触发条件 | 可执行操作 |
|---|---|---|---|
| 未核销 | 灰色Tag | 虚拟商品支付后/预约成功后 | 可执行核销操作;买家可申请售后 |
| 部分核销 | 橙色Tag | quantity>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 核心业务逻辑
- 发货入口:供应商在订单列表或订单详情中,对item_status=4(已收单)且shipping_status=0(未发货)的子订单执行发货操作。发货时需选择物流公司和录入运单号
- 物流公司选择:下拉选择平台预设的物流公司(顺丰、中通、圆通、韵达、申通、EMS、京东物流等),支持"其他"选项手动输入物流公司名称
- 运单号校验:前端校验运单号非空且长度在6-30位之间。后端不校验运单号真实性(由物流API查询时校验)
- 批量发货:供应商可勾选多个已收单且未发货子订单,统一选择物流公司和录入运单号后批量发货。适用于同一买家购买多个商品合并发货场景
- 发货后触发:更新t_order_item.item_status=6(已发货),shipping_status=1(已发货),shipping_time=当前时间,发送发货通知(短信+站内信+微信推送)
- 物流轨迹查询:对接物流API(如快递鸟、快递100),在订单详情页展示物流时间轴。首次查询时缓存结果到Redis(TTL=30分钟)
- 签收确认:物流API回传签收状态后,系统自动更新shipping_status=2(已签收),item_status=7(已完成),触发分账
- 自提管理:买家下单时选择"到店自提"的,供应商在后台标记"自提完成",记录自提时间和操作人,更新shipping_status=3(自提完成)
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原型
收货人:李四 139****5678
地址:浙江省杭州市西湖区xxx
13.2 物流轨迹展示
图13-2:物流轨迹时间轴原型
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.2 核心业务逻辑
- 售后申请入口:买家在C端提交售后申请(不在本PRD范围),申请信息同步到售后单表。售后申请按子订单维度处理,一个子订单同一时间只能有一个进行中的售后单
- 供应商一审:供应商在售后列表查看归属自己的售后单,5个工作日内必须处理(超时未处理系统自动同意)。处理结果:①同意 → 进入平台终审 ②拒绝 → 需填写拒绝原因,买家可选择申诉
- 平台终审:平台运营查看供应商同意和买家申诉的售后单,3个工作日内完成终审(超时未处理系统自动同意)。处理结果:①同意 → 执行退款 ②驳回 → 售后关闭
- 退款执行:审核通过后,系统自动调用支付中心执行原路退款。退款成功后更新售后单状态为"已退款",更新对应子订单 refund_status=2(退款成功)和 refund_amount。若主订单下全部子订单 refund_status=2,则主订单 order_status=9(已退款);否则主订单保持原履约状态或恢复为售后前状态。触发逆向分账(从各方待结算账户扣回资金)
- 退款金额计算:核销前退款(未发货/未履约/已发货未签收等)按商品退改规则计算退款金额,可能扣除手续费;已签收/已履约订单原则上不支持退款(特殊情况平台仲裁)
- 逆向分账:退款成功后,分账服务按原分账路径逆向扣回资金。如某方待结算账户余额不足,标记为"分账欠款",下次结算时自动抵扣
- 售后时效:买家在订单完成后7天内可申请售后(特殊商品如酒店入住前24小时)。超时不显示售后入口
- 优惠券与营销活动退款处理:
① 优惠券成本承担方:平台发放的优惠券由平台承担;供应商/商家发放的优惠券由对应供应商承担;不允许平台与供应商联合发放优惠券。
② 退款后退券:整单退款时,优惠券退回用户账户并恢复原有有效期(未过期情况下);部分退款时,优惠券不退回。
③ 退款金额计算:按用户实际支付金额(成交价 × 数量)退款,已使用的优惠券不再补发或折现。
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 售后统计
| 统计维度 | 指标说明 | 计算方式 |
|---|---|---|
| 退款率 | 统计周期内退款订单数 / 总成交订单数 | 按供应商/平台维度分别计算 |
| 售后原因分布 | 各退款原因的占比(商品质量问题/与描述不符/未按时发货/买家原因等) | 按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 核心业务逻辑
- 发票申请触发:买家在C端订单详情页对每个子订单发起发票申请,申请信息包括发票类型(个人/企业)、发票抬头、纳税人识别号(企业必填)、接收邮箱。申请仅允许在子订单状态为"已完成"时发起,一子订单一发票
- 发票类型支持:系统仅支持增值税普通发票(电子发票),暂不支持专用发票和纸质发票。电子发票格式为PDF,由供应商开具后上传至系统
- 发票审核流程:供应商在后台发票列表中查看申请,确认发票信息无误后开具电子发票并上传PDF文件。上传后买家自动收到邮件通知,可在C端下载
- 发票红冲:发票上传后7天内可申请红冲(买家申请或供应商主动红冲),红冲后买家可重新发起发票申请。超过7天不可红冲
- 发票金额:默认为订单实付金额(含运费),不可修改。如订单有售后退款,发票金额=实付金额-退款金额
- 发票开具维度:发票按子订单开具,一个子订单可申请一张发票。多供应商订单中,各供应商分别给自己的子订单开具发票。发票金额 = 子订单实付金额 - 该子订单已退款金额
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 核心业务逻辑
- 评价触发条件:订单状态为"已完成"后,买家可在C端对订单内每个子订单的商品分别进行评价。评价有效期为订单完成后30天,超期不可评价
- 评价维度:买家可选择评分(1-5星,半星精度)和文字评价(最多500字),可选上传图片(最多6张,单张不超过5MB)。评分分为"商品质量"和"服务态度"两个维度
- 评价审核:买家提交评价后,系统自动审核(敏感词过滤+图片OCR识别违规内容)。审核通过的评价立即展示;审核不通过的评价进入"待人工审核"状态,由平台运营处理
- 评价回复:供应商管理员可在后台对评价进行回复,每条评价仅可回复一次,回复后不可修改/删除。平台运营也可代供应商回复
- 评价展示:评价内容展示在C端商品详情页,按时间倒序排列。默认展示全部评价,支持筛选"有图评价""好评(4-5星)""中评(3星)""差评(1-2星)"
- 评价统计:系统实时计算每个SKU的好评率(4-5星占比)、综合评分(加权平均),作为商品排序和供应商考核的指标
15.2.2 极细交互说明
| 页面/组件 | 用户动作 | 系统行为 | 备注 |
|---|---|---|---|
| 评价管理页 列表 | 查看评价列表 | 展示评价ID、关联订单号、商品名称、买家昵称、评分、评价内容、图片缩略图、评价时间、回复状态。支持按评分/时间/商品/供应商筛选 | 供应商端仅展示自己商品的评价 |
| 评价管理页 | 点击"回复" | 弹出回复Dialog,输入框最多300字。提交后回复内容展示在评价下方,状态变为"已回复" | 每条评价仅可回复一次,提交前二次确认 |
| 评价管理页 | 点击"隐藏" | 弹出确认Dialog,确认后评价在C端商品详情页不再展示,但后台仍可见。隐藏后不可恢复展示 | 仅平台运营角色可操作隐藏 |
| 评价详情页 | 查看评价详情 | 展示买家完整评价内容、图片(点击放大)、评分明细(商品质量/服务态度)、买家历史评价数 | 图片使用Lightbox组件放大查看 |
| 评价统计页 | 查看好评率统计 | 展示供应商维度的好评率趋势图(近30天)、各SKU综合评分排名、好评/中评/差评分布饼图 | 统计每日凌晨2:00定时任务计算更新 |
15.2.3 评价状态说明表
| 状态码 | 状态名称 | 触发条件 | 允许操作 |
|---|---|---|---|
| 1 | 待审核 | 买家提交评价后,系统审核中 | 平台运营可审核通过/驳回 |
| 2 | 已通过 | 系统或人工审核通过后 | 供应商可回复,平台运营可隐藏 |
| 3 | 已驳回 | 审核不通过(含违规内容) | 买家可修改后重新提交 |
| 4 | 已隐藏 | 平台运营执行隐藏后 | 不可恢复,仅后台可见 |
15.2.4 评价统计与回复规则
- 好评率计算公式:好评率 = (4星评价数 + 5星评价数) / 总评价数 × 100%。保留1位小数
- 综合评分计算:综合评分 = (商品质量评分 × 0.6 + 服务态度评分 × 0.4),按订单量加权平均
- 统计维度:支持按SKU、SPU、供应商、时间范围(日/周/月)四个维度统计评价数据
- 回复时效:供应商应在评价提交后72小时内回复,超期未回复的系统发送提醒通知
- 恶意评价识别:系统识别同一买家30天内对同一供应商超过3条差评的情况,自动标记为"疑似恶意",供平台运营人工复核
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章所有图表渲染效果 |