1文档概述
本章明确本文档的用途、读者、术语定义及版本记录,确保所有角色对商品供应链管理中心PRD的理解一致。
1.1 文档用途
本文档是云灵汐涉旅电商分销子系统中 PC端商品供应链管理中心 的产品需求说明,覆盖商品分类、商品信息管理、效期与价格、特色商品进销存、日历库存、内容素材等全链路功能。文档面向产品经理、后端开发、前端开发、测试、UI/UX、项目经理及业务运营人员,作为设计、开发、验收的基准。
1.2 读者对象
| 角色 | 关注重点 | 建议阅读章节 |
| 后端开发 | 数据模型、状态机、接口字段、业务规则、并发控制 | 第6、8、10、11-15章 |
| 前端开发 | 页面结构、交互流程、表单校验、动态渲染规则 | 第9、11-15章 |
| 测试工程师 | 功能用例、边界条件、异常场景、验收标准 | 第7、8、17章 |
| UI/UX设计师 | 页面布局、原型示意、字段排列、状态展示 | 第9、11-15章 |
| 业务运营 | 商品上架流程、审核机制、价格策略 | 第2-5、7、11-15章 |
| 项目经理 | 范围边界、依赖关系、里程碑、验收标准 | 第3、5、16、17章 |
1.3 文档约定
| 约定项 | 说明 |
| 必须 | 关键规则,必须实现,否则影响业务流程或资金安全。 |
| 建议 | 推荐实现,可在MVP后优化。 |
| 示例 | 用于说明的样例数据,不代表真实配置。 |
字段名 | 数据表字段或接口参数,英文命名。 |
| 「」 | 页面文案或按钮名称。 |
| 角色/状态 | 使用标签样式如 已上架 表示稳定状态,待审核 表示中间状态。 |
1.4 术语定义
| 术语 | 英文/缩写 | 定义 |
| 商品供应链管理中心 | Supply Chain Center | 供应商/平台运营对商品进行分类、创建、定价、库存、素材、上下架、审核的系统模块。 |
| 标准化产品单元 | SPU | Standard Product Unit,商品标准单元,描述商品共性(名称、类目、图片、基础属性)。 |
| 库存量单位 | SKU | Stock Keeping Unit,最小可售单元,描述具体规格、价格、库存。 |
| 商品类型 | Product Type | 门票、酒店、车辆、特色商品、组合套餐、线路产品六种涉旅非标商品分类。 |
| 日历模式 | Calendar Mode | 按日期定价与控库存,常见于门票、酒店。 |
| 通兑模式 | Voucher Mode | 不指定具体日期,购买后在效期内预约或直接使用。 |
| 市场价 | Market Price | 商品对外展示的市场参考价,用于划线价展示。 |
| 实际售价 | Sale Price | 分销商/C端实际销售价格。 |
| 平台限价 | Platform Max Price | 平台为防止乱价设置的最高售价。 |
| 底价 | Base Cost Price | 供应商结算底价,B端分销商采购价。 |
| 专属价 | Exclusive Price | 供应商针对特定B端分销商设置的独立采购价。 |
| 平台默认分销价 | Default Distribution Price | 供应商未设置专属价时,B端分销商看到的默认采购价。 |
| 佣金 | Commission | 个体分销商推广商品后获得的提成,按成交金额比例计算。 |
| 活态库存 | Live Inventory | total_stock = locked_stock + sold_stock + available_stock 的动态库存模型。 |
| 共享库存 | Shared Stock | 多个SKU/渠道共用同一库存池。 |
| 独立控位 | Dedicated Stock | 某个SKU/渠道独占固定库存。 |
| 核销 | Verification | 用户到店/入住/用车后,商家或系统确认订单履约完成。 |
| 使用前审核 | Pre-use Audit | 与手动收单等价,支付成功后需供应商在后台确认收单(审核通过)才生成核销码或确认履约,不单独设置待审核状态。 |
| 退改规则 | Cancel Policy | 商品在不同时间点申请退款时扣除的手续费规则;核销前退款按此规则计算退款金额。 |
1.5 版本记录
| 版本 | 日期 | 修订人 | 修订内容 |
| v1.0 | 2026-07-08 | 产品经理 | 完成第1-10章初稿。 |
| v2.0 | 2026-07-08 | 产品经理 | 基于PRD-SOP深度模板、分销中心v2、订单履约PRD、功能清单、菜单结构、核心业务主流程图重新设计,完成17章全量内容。 |
2需求背景
本章说明商品供应链管理中心建设的业务背景、当前痛点及不解决带来的影响,为后续功能设计提供依据。
2.1 业务背景
云灵汐涉旅电商分销子系统连接供应商、平台运营、B端分销商及个体分销商,向C端游客提供门票、酒店、车辆、特色商品、组合套餐、线路产品等涉旅产品。商品供应链管理中心是交易履约的前置核心,直接决定分销商能否高效选品、平台能否控价控质、供应商能否灵活管理库存与价格。
2.2 当前痛点
痛点1:商品信息不规范,上架效率低
不同供应商填报的商品字段差异大,缺少统一分类与规格模板,导致平台审核反复退回,上架周期长。
痛点2:六种商品类型规则混杂,下单页无法灵活适配
门票需要选日期/时段/实名,酒店需要入住日期/联系人,车辆需要用车时间/行程单,特色商品需要收货地址,线路产品需要选择出发日期/填写出游人。现有系统用硬编码表单,新增商品类型改造成本高。
痛点3:价格体系层级不清,乱价与利润冲突频发
市场价、售价、限价、底价、专属价混用,B端与个体分销商的结算模式不同(底价/佣金),缺少全局限价校验,分销商低价倾销或高价截流时有发生。
痛点4:库存口径不一致,超卖与虚库存并存
供应商线下销售与平台线上库存不同步,未区分锁定/已售/可用库存,高峰期超卖导致客诉;独立控位与共享库存混用,财务对账困难。
痛点5:素材与内容管理分散,分销推广成本高
商品图片、文案、海报、短视频素材散落在供应商本地或微信群,分销商无法一键获取合规素材,推广效率低且品牌口径不统一。
2.3 不解决的影响
| 影响维度 | 具体表现 | 风险等级 |
| 交易侧 | 商品信息缺失导致下单页字段错误,订单履约失败率上升,退款率提高。 | 高 |
| 平台侧 | 无法统一控价控质,分销商乱价损害品牌形象;审核效率低影响GMV。 | 高 |
| 供应商侧 | 多商品类型需重复录入,库存与价格维护成本高,响应市场慢。 | 中 |
| 分销商侧 | 选品信息不完整,素材获取困难,推广转化下降。 | 中 |
| 财务侧 | 底价/佣金/专属价计算口径不统一,结算纠纷增加。 | 高 |
3目标与范围
本章明确商品供应链管理中心要达成的业务目标、功能边界、涉及角色及与周边模块的边界关系。
3.1 业务目标
| 目标编号 | 目标描述 | 衡量指标 |
| G1 | 建立统一的SPU/SKU商品模型,支持六种涉旅商品类型灵活扩展。 | 新增商品类型从需求到上线 ≤ 5人日。 |
| G2 | 通过SPU配置驱动下单页渲染与核销规则,减少硬编码。 | 下单页字段变更由商品配置即时生效,无需发版。 |
| G3 | 构建五层价格体系与全局限价机制,防止分销商乱价。 | 超限售价订单拦截率100%,违规记录完整留痕。 |
| G4 | 实现日历库存引擎与特色商品进销存,支持共享库存与独立控位,杜绝超卖。 | 库存并发扣减准确,超卖率 = 0。 |
| G5 | 沉淀商品内容素材中心,降低分销商推广成本。 | 90%以上上架商品提供标准化分销素材包。 |
3.2 功能范围
包含:商品分类管理(门票/酒店/车辆/特色商品/组合套餐/线路产品)、六类商品信息管理、SPU配置驱动规则、效期与价格管理、底价/专属价/佣金配置、全局限价、特色商品进销存管理、内容素材管理、商品审核流程、上下架管理、操作日志审计。
不包含:分销商协议签署(归属分销中心)、分销商下单与支付(归属订单履约)、售后退款与逆向分账(归属订单履约/财务结算)、物流发货(特色商品物流对接不在MVP)、C端商城展示(归属前端H5/小程序)、供应商资质认证(归属基础功能/权限中心)。
3.3 边界关系
| 相邻模块 | 交互内容 | 数据/接口方向 | 边界说明 |
| 基础功能与权限中心 | 租户隔离、角色权限、操作日志、用户部门数据范围。 | 读取角色权限,写入操作日志。 | 商品中心只负责业务数据,鉴权与日志由权限中心提供能力。 |
| 分销中心 | 商品授权、可见范围、底价/专属价、平台限价、分销商等级佣金。 | 提供商品/价格/库存数据与默认销售渠道;接收授权/限价/佣金配置。 | 商品中心维护商品默认销售渠道与分销员可见范围;授权关系、授权底价/库存及佣金规则在分销中心维护。 |
| 订单履约 | SPU配置驱动下单页、库存锁定/释放/核销、使用前审核、退改规则。 | 提供SPU配置与库存数据;接收订单履约状态回写。 | 订单状态流转由订单中心负责,商品中心只维护库存数量与商品配置。 |
| 财务结算 | 底价、专属价、佣金比例用于结算与分账。 | 提供价格快照与佣金比例。 | 不处理资金账户与结算单,只输出价格/佣金参数。 |
| 营销系统 | 商品参与营销活动时的价格与库存占用。 | 提供活动可用库存与活动价校验。 | 营销活动创建在营销系统,商品中心提供库存占用与价格下限校验。 |
3.4 设计原则
- 配置驱动: 通过
t_spu_order_config 表控制不同商品类型的下单字段与核销规则,避免硬编码。
- 层级清晰: 五层价格体系(市场价 ≥ 实际售价;实际售价 ≤ 平台限价;平台限价 ≥ 底价)严格约束,防止价格倒挂。专属价由供应商针对特定分销商独立设置,与底价之间不做强制大小约束。
- 库存精确: 总库存 = 锁定 + 已售 + 可用,关键扣减使用乐观锁/分布式锁,保证不超卖。
- 租户隔离: 供应商只能操作本租户数据,平台运营可操作全部数据,SQL自动注入
tenant_id 条件。
- 审核留痕: 商品上架、价格调整、库存变更等关键操作记录审计日志,含修改前后Diff。
4用户与角色
本章定义商品供应链管理中心涉及的用户角色、职责、数据权限范围及典型操作。
4.1 角色矩阵
| 角色 | 所属租户 | 主要职责 | 数据权限范围 | 典型页面 |
| 平台运营管理员 | PLATFORM | 制定商品分类、审核商品、设置全局限价、查看全平台商品与库存。 | 全部数据 | 商品分类、商品审核、限价管理、库存监控 |
| 平台运营专员 | PLATFORM | 协助审核商品、处理价格异常、查看分管品类商品。 | 本人数据/自定义范围 | 商品审核、库存监控、操作日志 |
| 供应商管理员 | SUPPLIER | 管理本供应商所有商品、价格、库存、素材,分配子账号权限。 | 本供应商全部数据 | 商品列表、商品创建、价格管理、库存管理、素材管理 |
| 供应商运营 | SUPPLIER | 日常维护商品信息、价格、库存,提交上架审核。 | 本部门/本人数据 | 商品列表、商品编辑、库存管理 |
| 分销商采购员 | DISTRIBUTOR | 在分销商城查看可见商品并采购,不直接操作供应链功能。 | 可见商品范围 | 分销商城(采购) |
4.2 角色权限说明
平台运营管理员
- 维护商品分类树,设置分类属性模板与关联商品类型。
- 审核供应商提交的商品上架申请,执行通过/驳回操作。
- 配置平台级限价规则(全局/品类/商品维度)。
- 查看所有供应商的商品、库存、价格、操作日志。
- 对违规商品执行强制下架。
供应商管理员/运营
- 创建并维护本供应商商品(SPU/SKU)。
- 设置商品价格体系、退改规则、效期、库存。
- 上传商品素材(图片、海报、文案、视频)。
- 提交商品上架审核,管理商品上下架状态。
- 处理特色商品采购入库、出库、盘点、调拨;维护日历模式商品(门票/酒店/车辆/线路产品)的每日库存与共享库存分配。
4.3 数据权限实现
商品供应链管理中心所有业务表必须包含 tenant_type 与 tenant_id 字段,用于多租户硬隔离。供应商表额外包含 supplier_id 与 tenant_id 一致,订单履约与分销中心通过 supplier_id 关联商品。
| 数据范围类型 | 适用角色 | SQL注入条件示例 |
| 全部数据 | 平台运营管理员 | 无额外条件(平台租户内)。 |
| 本部门及下级 | 平台运营专员/供应商运营 | WHERE dept_id IN (SELECT id FROM sys_dept WHERE path LIKE '当前部门path%') |
| 本人数据 | 平台运营专员/供应商运营 | WHERE creator_id = #{currentUserId} |
| 本供应商全部 | 供应商管理员 | WHERE tenant_id = #{currentTenantId} |
禁止: 任何查询不得出现无 tenant_id 过滤的全表扫描;平台运营查询全平台数据时,必须显式指定 tenant_type='SUPPLIER' 并遍历租户,不得绕过租户隔离。
5功能清单
本章列出商品供应链管理中心全部功能点,按模块组织,并标注优先级、依赖关系及对应章节。
5.1 功能清单总表
| 模块 | 功能点 | 优先级 | 对应章节 | 依赖 |
| 商品分类、POI与短信模板 | 分类树维护(新增/编辑/删除/排序/启用禁用) | P0 | 11.1 | 无 |
| 分类属性模板配置 | P0 | 11.2 | 分类树 |
| 分类与商品类型绑定 | P0 | 11.3 | 分类树、商品类型 |
| 线路主题与线路归类 | P0 | 11.4 | 无 |
| 分类删除限制与转移 | P1 | 11.5 | 商品表 |
| POI管理(新建/审核/编辑/禁用) | P0 | 11.7 | 无 |
| 短信模板管理 | P0 | 11.8 | 无 |
| 商品信息管理 | 六种商品类型字段表单(含POI关联) | P0 | 12.1-12.8 | 分类树、POI |
| SKU规格与价格通用规则 | P0 | 12.9 | SPU |
| SPU配置驱动(下单字段与核销规则) | P0 | 12.10 | SPU |
| 商品上下架与状态机 | P0 | 12.11 | 审核流程 |
| 商品审核流程 | P0 | 12.12 | SPU、角色权限 |
| 商品复制/批量导入/批量导出 | P1 | 12.13 | SPU/SKU |
| 销售规则配置 | P0 | 12.14 | SPU |
| 核销规则配置 | P0 | 12.15 | SPU |
| 短信模板选择 | P0 | 12.16 | 短信模板 |
| 第三方接口资源同步机制 | P0 | 12.17 | SPU |
| 效期、收单与价格管理 | 退改规则模板管理 | P0 | 13.1 | 无 |
| 收单规则管理(自动/手动/审核收单) | P0 | 13.2 | SPU配置 |
| 购买区域限制规则 | P0 | 13.3 | SPU配置 |
| 效期规则管理(固定/动态/指定日期) | P0 | 13.4 | SPU |
| 五层价格体系配置 | P0 | 13.5 | SKU |
| 底价/专属价/佣金比例 | P0 | 13.6 | 分销中心 |
| 全局限价规则 | P1 | 13.7 | 分销中心 |
| 特色商品进销存管理 | 入库单管理(采购/退货/盘盈/调拨入库) | P0 | 14.2 | SKU |
| 出库单管理(销售/盘亏/调拨出库) | P0 | 14.3 | 入库单 |
| 库存盘点与调拨 | P1 | 14.4-14.5 | 入库单 |
| 库存预警与日志 | P1 | 14.6/14.8 | 入库单 |
| 内容素材管理 | 规格模板与商品详情编辑 | P0 | 15.1 | SPU |
| 海报/图片/视频/文案素材库 | P1 | 15.2 | SPU |
| 分销素材工坊 | P2 | 15.3 | 素材库 |
| 系统初始化 | 初始化数据清单 | P0 | 16.1 | 权限中心 |
| 依赖顺序与接口契约 | P0 | 16.2 | 所有模块 |
| 验收标准 | 功能验收与质量门禁 | P0 | 17 | 全量功能 |
5.2 优先级定义
| 优先级 | 定义 | 上线策略 |
| P0 | 阻塞MVP上线,缺少则业务流程无法闭环。 | 必须在本版本完成并通过测试。 |
| P1 | 显著提升效率或体验,可在MVP后快速迭代。 | 建议本版本完成,可排期延后。 |
| P2 | 增强型功能,非必需。 | 后续版本规划。 |
6系统架构
本章说明商品供应链管理中心的系统定位、服务边界、核心实体关系及与其他模块的集成关系。
6.1 系统定位
商品供应链管理中心是云灵汐分销子系统的商品数据中心与规则配置中心。它向上为分销中心提供可售商品池、价格、可见范围基础数据;向下为订单履约提供SPU配置、库存、效期、退改规则与收单/区域限制规则;向内沉淀商品分类、POI、短信模板、素材、审核、库存引擎等通用能力。
6.2 服务架构
flowchart TB
subgraph 前端层
A[平台运营后台]
B[供应商后台]
C[分销商城采购页]
end
subgraph 网关层
G[API Gateway / 鉴权 / 限流]
end
subgraph 业务服务
S1[商品服务 product-service]
S2[价格服务 price-service]
S3[库存服务 inventory-service]
S4[素材服务 material-service]
S5[审核服务 audit-service]
end
subgraph 公共能力
C1[权限中心 auth-service]
C2[订单中心 order-service]
C3[分销中心 distribution-service]
C4[文件存储 OSS]
C5[消息队列 MQ]
end
subgraph 数据层
D1[(MySQL 业务库)]
D2[(Redis 缓存)]
D3[(ES 商品搜索)]
end
A --> G
B --> G
C --> G
G --> S1 & S2 & S3 & S4 & S5
S1 --> C1 & C5 & D1 & D2 & D3
S2 --> C3 & D1 & D2
S3 --> C2 & C5 & D1 & D2
S4 --> C4 & D1
S5 --> C1 & D1 & C5
商品供应链管理中心服务架构图
6.3 服务职责
| 服务 | 职责 | 核心表/资源 |
| 商品服务 | SPU/SKU增删改查、商品分类、POI与短信模板、商品类型扩展、商品状态机、第三方资源同步。 | t_category, t_scenic_poi, t_sms_template, t_product_spu, t_product_sku, t_spu_order_config |
| 价格服务 | 五层价格体系、底价/专属价/佣金比例、全局限价校验、退改规则模板。 | t_price_config, t_cancel_policy_template, t_price_limit_rule |
| 库存服务 | 日历库存引擎(门票/酒店/车辆/线路产品)、特色商品进销存(入库/出库/盘点/调拨)、库存预警、库存日志。 | t_calendar_inventory, t_inventory_inbound, t_inventory_outbound, t_inventory_log |
| 素材服务 | 商品详情模板、图片/视频/海报/文案上传、素材分类、分销素材包。 | t_material_library, t_product_detail |
| 审核服务 | 商品上架审核流、价格调整审批(如需要)、操作日志记录。 | t_product_audit_record, t_operation_log |
6.4 核心实体关系
| 实体A | 关系 | 实体B | 说明 |
| 分类 Category | 1:N | SPU | 一个分类下可有多个SPU,SPU必须归属末级分类。 |
| SPU | 1:N | SKU | 一个SPU下可有多个SKU,SKU是实际售卖单元。 |
| SPU | 1:1 | SPU Order Config | 每个SPU对应一份下单/核销配置。 |
| POI | 1:N | SPU | 一个POI可被多个SPU引用,门票/酒店/车辆/线路产品必须关联已审核POI。 |
| SPU | N:M | SMS Template | 一个SPU可选择多个短信模板,覆盖已支付/已确认收单/已退款等节点。 |
| SKU | 1:N | Calendar Inventory | 日历模式商品(门票/酒店/车辆/线路产品),每个SKU按日期有多条库存记录。 |
| 特色商品SKU | 1:N | Inbound Order | 仅特色商品SKU存在入库记录,通过入库单增加库存。 |
| SKU | 1:1 | Price Config | 每个SKU对应一份价格配置(含日历价或统一价)。 |
| SPU | N:1 | Cancel Policy Template | 多个SPU可引用同一退改规则模板。 |
| SPU | 1:N | Material | 一个SPU可关联多张图片/海报/视频/文案。 |
6.5 技术关键点
- 读写分离: 商品详情、搜索走ES;库存扣减、价格计算走MySQL主库。
- 缓存策略: 商品基础信息、价格、库存热点数据缓存于Redis,库存扣减使用Redis预扣+MySQL落库。
- 消息驱动: 商品上下架、库存预警、审核结果通过MQ通知订单中心、分销中心。
- 并发控制: 库存扣减使用乐观锁(version字段)+ 分布式锁(sku_id+date维度)。
- POI与短信模板: POI关键字段变更需重新审核,审核通过后同步更新已关联SPU展示;短信模板由平台统一维护,供应商按场景选用。
- 购买区域限制: GeoJSON多边形存储于SPU配置,下单时通过定位/IP服务完成点包含判断。
- 第三方资源同步: 第三方商品通过独立同步任务拉取库存、价格、订单、核销、退款状态,异常时进入重试队列。
- 租户隔离: 所有数据表强制携带
tenant_type + tenant_id,ORM自动注入WHERE条件。
7核心业务流程图
本章通过流程图展示商品供应链管理的核心业务路径,包括商品上架主流程与商品审核流程。
7.1 商品供应链主流程
flowchart TD
Start([开始]) --> Init[平台运营初始化分类、属性模板、POI与短信模板]
Init --> SupplierCreate[供应商选择商品类型]
SupplierCreate --> Step1[步骤1 基础信息 选择POI与填写SPU信息]
Step1 --> Step2[步骤2 票型与规格 配置SKU与库存模式]
Step2 --> Step3[步骤3 库存与价格 设置库存与五层价格]
Step3 --> Step4[步骤4 销售规则 提前预订、下单时段、购买区域、团队规则]
Step4 --> Step5[步骤5 核销规则 一单一码/一票一码/手动确认/无需核销]
Step5 --> Step6[步骤6 退改规则 选择退改模板]
Step6 --> Step7[步骤7 渠道与短信 销售渠道与短信模板]
Step7 --> Step8[步骤8 预览 完整商品信息确认]
Step8 --> SubmitAudit{提交审核/保存草稿}
SubmitAudit -- 保存草稿 --> Draft[草稿状态 可再次编辑]
Draft --> Step1
SubmitAudit -- 提交审核 --> Audit{平台审核}
Audit -- 通过 --> PutOn[商品上架]
PutOn --> Authorize[供应商授权给分销商]
Authorize --> Visible[设置可见范围与专属价]
Visible --> MallShow[分销商城展示]
MallShow --> OrderLock[订单锁定库存]
OrderLock --> Accept{自动收单或手动收单}
Accept -- 自动收单 --> Verify[核销/履约]
Accept -- 手动收单/审核订单 --> AuditOrder[供应商审核收单]
AuditOrder -- 通过 --> Verify
AuditOrder -- 驳回 --> RefundOrder[订单退款]
Verify --> End([结束])
Audit -- 驳回 --> Revise[供应商修改商品]
Revise --> Step1
Audit -- 强制下架 --> OffShelf[商品下架]
OffShelf --> Revise
商品供应链主流程图
7.2 商品审核流程
flowchart TD
Start([供应商提交审核]) --> Check[校验商品必填项与价格合法性]
Check -- 不通过 --> ErrorPage[前端提示缺失字段]
ErrorPage --> Start
Check -- 通过 --> StatusChange[SPU状态变更为待审核]
StatusChange --> PlatformAudit[平台运营审核]
PlatformAudit -- 通过 --> AuditPass[状态变更为已上架]
AuditPass --> NoticeSupplier[通知供应商上架成功]
AuditPass --> SyncMall[同步分销商城]
PlatformAudit -- 驳回 --> AuditReject[状态变更为审核驳回]
AuditReject --> RecordReason[记录驳回原因]
RecordReason --> NoticeReject[通知供应商修改]
NoticeReject --> Revise[供应商修改后重新提交]
Revise --> Start
PlatformAudit -- 强制下架 --> ForceOff[状态变更为已下架]
ForceOff --> RecordLog[记录操作日志]
商品审核流程图
7.3 库存扣减与释放流程
flowchart TD
Start([用户提交订单]) --> LockStock[锁定库存 available- N locked+ N]
LockStock -- 库存不足 --> Fail[返回库存不足]
LockStock -- 成功 --> WaitPay[等待支付]
WaitPay -- 支付成功 --> MoveStock[locked- N sold+ N]
WaitPay -- 超时取消 --> ReleaseStock[locked- N available+ N]
WaitPay -- 手动取消 --> ReleaseStock
MoveStock --> Verify{核销/履约}
Verify -- 完成 --> End([结束])
Verify -- 退款未核销 --> RefundStock[sold- N available+ N]
Verify -- 退款已核销 --> NoRefund[不释放库存]
库存扣减与释放流程图
7.4 价格变更生效流程
flowchart TD
Start([供应商修改价格]) --> CheckRule[校验五层价格体系]
CheckRule -- 价格倒挂 --> Reject[前端提示错误]
CheckRule -- 通过 --> SaveDraft[保存为待生效配置]
SaveDraft --> OnShelf{商品是否已上架}
OnShelf -- 是 --> NeedAudit[是否需要重新审核]
NeedAudit -- 是 --> SubmitAudit[提交审核]
NeedAudit -- 否 --> Immediate[即时生效]
OnShelf -- 否 --> Draft[随商品上架一起生效]
SubmitAudit -- 通过 --> Immediate
Immediate --> Snapshot[生成价格快照]
Snapshot --> Sync[同步缓存与分销中心]
价格变更生效流程图
8全局通用规则
本章定义商品供应链管理中心跨模块复用的全局规则,包括状态机、价格体系、库存公式、数据隔离、编码规则、SPU配置驱动规则等。
8.1 商品状态机
| 状态编码 | 状态名称 | 说明 | 允许操作 |
| draft | 草稿 | 供应商创建中,未提交审核。 | 编辑、删除、提交审核 |
| pending_audit | 待审核 | 已提交平台审核,等待运营处理。 | 平台审核通过/驳回、强制下架(对已上架) |
| approved | 已上架 | 审核通过,可在分销商城展示。 | 下架、编辑(触发重新审核或即时生效) |
| stock_warning | 库存预警 | 已上架商品库存低于预警阈值,仍可销售但需提醒补货。 | 下架、编辑(仅库存/价格)、补货 |
| sold_out | 售罄 | 已上架商品所有 SKU 可用库存为 0,暂时不可售。 | 下架、补货 |
| rejected | 审核驳回 | 平台审核不通过,需修改后重新提交。 | 编辑、重新提交审核、删除 |
| offline | 已下架 | 已下架,分销商城不展示。 | 编辑、重新上架(需审核) |
8.1.1 状态流转规则
- 草稿 → 待审核: 供应商点击「提交审核」,系统校验所有必填项与价格合法性。
- 待审核 → 已上架: 平台运营点击「审核通过」。
- 待审核 → 审核驳回: 平台运营点击「驳回」,必须填写驳回原因。
- 已上架 → 已下架: 供应商主动下架或平台运营强制下架。
- 已上架 → 库存预警: 库存低于预警阈值时自动流转。
- 已上架 → 售罄: 全部 SKU 可用库存为 0 时自动流转。
- 库存预警 → 售罄: 库存继续下降至 0 时自动流转。
- 库存预警 → 已上架: 库存回升至预警阈值以上后自动恢复。
- 售罄 → 已上架: 补充库存后自动恢复。
- 售罄/库存预警 → 已下架: 供应商主动下架或平台运营强制下架。
- 已下架 → 待审核: 供应商修改后重新提交审核。
- 审核驳回 → 待审核: 供应商修改后重新提交。
8.1.2 状态变更约束
禁止: 不允许从「已上架/库存预警/售罄」直接回到「草稿」;不允许删除「已上架/待审核/库存预警/售罄」商品,必须先下架/驳回。
8.2 五层价格体系
商品价格必须满足如下层级约束,任一关系不成立则前端红框提示并阻止保存。
市场价 ≥ 实际售价;实际售价 ≤ 平台限价;平台限价 ≥ 底价。专属价由供应商针对特定分销商独立设置,与底价之间不做强制大小约束。
| 价格类型 | 定义 | 维护角色 | 使用场景 |
| 市场价 | 对外展示划线价,仅作参考。 | 供应商 | C端/B端展示原价对比。 |
| 实际售价 | 分销商/C端实际销售价格。 | 分销商/平台 | 前台下单价。 |
| 平台限价 | 平台设置的最高售价,防止乱价。 | 平台运营 | 分销商下单销售时校验。 |
| 底价 | 供应商与平台/分销商结算底价,B端采购价。 | 供应商 | B端分销商采购、财务结算。 |
| 专属价 | 供应商对特定B端分销商的独立采购价。 | 供应商 | 有专属协议的分销商采购。 |
8.2.1 价格合法性校验
market_price ≥ sale_price,sale_price ≤ limit_price,limit_price ≥ base_price,小数点后2位。
- 专属价
exclusive_price 由供应商针对特定分销商独立设置,与底价 base_price 之间不做强制大小约束。
- 日历模式下,每一天的上述价格关系独立校验。
- 价格 ≤ 0 时禁止保存。
8.3 库存公式
总库存 total_stock = 可用库存 available_stock + 锁定库存 locked_stock + 已售库存 sold_stock
| 库存类型 | 说明 | 触发场景 |
| available_stock | 当前可售库存。 | 入库增加、支付超时释放、售后退款未核销释放。 |
| locked_stock | 已下单未支付库存。 | 提交订单锁定、支付成功转移、取消/超时释放。 |
| sold_stock | 已支付未核销/未履约库存。 | 支付成功增加、核销后不变、退款未核销减少。 |
8.4 数据隔离规则
- 所有业务表必须包含
tenant_type(PLATFORM/SUPPLIER/DISTRIBUTOR)与 tenant_id 字段。
- 供应商数据:
tenant_type='SUPPLIER' AND tenant_id=#{currentTenantId}。
- 平台运营查询全平台供应商商品时,必须显式按
tenant_id 列表或租户类型过滤,禁止跨租户模糊查询。
- 操作日志表独立存储,含
tenant_id、操作人、模块、变更前后值。
8.5 编码规则
| 对象 | 编码规则 | 示例 | 唯一性 |
| SPU编码 | SPU + 8位日期 + 6位随机字母数字 | SPU20260708A3B7C9 | 全局唯一 |
| SKU编码 | SKU + SPU编码后6位 + 3位序号 | SKU7B7C9001 | SPU内唯一 |
| 入库单号 | IN + 8位日期 + 6位流水 | IN20260708000001 | 全局唯一 |
| 分类编码 | CAT + 3位层级 + 4位序号 | CAT0010001 | 全局唯一 |
8.6 SPU配置驱动规则
每个SPU通过 t_spu_order_config 表控制下单页渲染与核销规则。该表与订单履约PRD保持一致,字段定义见第10章。
8.6.1 配置字段与下单页组件映射
| 配置字段 | 取值 | 下单页表现 |
| is_show_buy_notice | 1 | 展示购买须知折叠面板,需勾选同意。 |
| enable_sku | 1 | 渲染SKU规格选择器;0则直接数量输入。 |
| inventory_type | calendar | 按日期维护库存与价格,下单需选择日期。 |
| inventory_type | total_inventory | 不指定具体日期,维护总库存与统一价。 |
| is_time_slot_enabled | 1 | 在日历或总库存模式下再按上午/下午/晚上等时段拆分库存。 |
| advance_book_days | N | 今日+N天前日期不可选。 |
| advance_book_time | HH:MM | 游玩当日截止下单时间,超过后该日期不可选。 |
| cutoff_time | HH:MM | 每日截止下单时间,超过后当日不可订。 |
| order_time_start / order_time_end | HH:MM | 每日允许下单的开始与结束时间,不在时段内禁止提交订单。 |
| sale_region_limit_enabled | 1 | 校验用户定位或IP是否在sale_region_geo多边形内,不在区域内禁止下单。 |
| enable_real_name | 1 | 按数量渲染实名信息录入行。 |
| require_certificate | 1 | 每个使用人上传证件图片。 |
| certificate_type | teacher/student/... | 展示对应证件名称。 |
| require_guide_info | 1 | 展示导游姓名/证号/手机输入区。 |
| require_itinerary | 1 | 展示行程单上传入口。 |
| group_guide_certificate_required | 1 | 团队订单要求上传导游证图片。 |
| group_guide_real_name_required | 1 | 团队订单要求填写导游姓名、证号、手机。 |
| group_itinerary_required | 1 | 团队订单要求上传行程单。 |
| verify_before_use | 1 | 与 manual_accept_order 等价,支付后需供应商确认收单(审核通过)才生成核销码,不单独设置待审核状态。 |
| verification_type | one_order_one_code | 一个订单生成一个统一核销码,适用于团队或通兑。 |
| verification_type | one_ticket_one_code | 每份/每人生成独立核销码,支持逐张核销。 |
| verification_type | manual_confirm | 无需核销码,由供应商在后台确认履约。 |
| verification_type | none | 无需核销,物流或系统自动完成。 |
| allow_partial_use | 1 | 支持分次核销。 |
| package_only | 1 | 商品不在C端/B端商城单独展示,仅可被组合套餐引用。 |
| stock_mode | shared / independent | 共享库存池时所有SKU共用库存,独立控位时各SKU分别扣减。 |
| auto_accept_order | 1 | 支付成功后订单自动收单,进入待核销/履约。 |
| manual_accept_order | 1 | 支付成功后订单进入待供应商审核收单,审核通过才算正式收单。 |
8.6.2 商品类型默认配置
| 商品类型 | is_show_buy_notice | enable_sku | inventory_type | is_time_slot_enabled | enable_real_name | require_certificate | require_guide_info | require_itinerary | verify_before_use | verification_type | package_only | stock_mode | auto_accept_order | manual_accept_order |
| 门票 | 1 | 1 | calendar | 0/1 | 1 | 0/1 | 0/1 | 0/1 | 0/1 | one_ticket_one_code | 0 | shared/independent | 1 | 0 |
| 酒店 | 1 | 1 | calendar | 0 | 0 | 0 | 0/1 | 0/1 | 0/1 | manual_confirm | 0 | independent | 0 | 1 |
| 车辆 | 1 | 1 | calendar | 0 | 1 | 0 | 0/1 | 1 | 0/1 | manual_confirm | 0 | independent | 0 | 1 |
| 特色商品 | 1 | 1 | total_inventory | 0 | 0 | 0 | 0 | 0 | 0 | none | 0 | independent | 1 | 0 |
| 组合套餐 | 1 | 1 | 按子项 | 0/1 | 0/1 | 0 | 0/1 | 0/1 | 0/1 | 按组成商品 | 0 | 按子项 | 0/1 | 0/1 |
| 线路产品 | 1 | 1 | calendar | 0 | 1 | 0 | 0/1 | 0 | 0/1 | manual_confirm | 0 | independent | 0 | 1 |
说明: 上表为系统建议默认值,供应商可在配置页面按实际业务调整。其中特色商品默认无核销(物流签收),车辆默认由供应商手动确认还车完成履约。
9全局页面流转说明
本章描述商品供应链管理中心核心页面之间的跳转关系、入口条件及返回行为。
9.1 页面流转总表
| 序号 | 起始页面 | 触发操作 | 目标页面 | 前置条件 | 返回行为 |
| 1 | 商品列表 | 点击「新增商品」 | 选择商品类型 | 拥有商品创建权限 | 返回商品列表 |
| 2 | 选择商品类型 | 选择门票/酒店/车辆/特色商品/组合套餐/线路产品 | SPU基础信息编辑 | 已维护商品分类与POI | 返回选择商品类型 |
| 3 | SPU基础信息编辑 | 点击「下一步」 | 票型与规格 | 基础信息校验通过 | 返回上一步 |
| 4 | 票型与规格 | 点击「下一步」 | 库存与价格 | SKU规格校验通过 | 返回上一步 |
| 5 | 库存与价格 | 点击「下一步」 | 销售规则配置 | 价格/库存校验通过 | 返回上一步 |
| 6 | 销售规则配置 | 点击「下一步」 | 核销规则配置 | 销售规则校验通过 | 返回上一步 |
| 7 | 核销规则配置 | 点击「下一步」 | 退改规则配置 | 核销规则校验通过 | 返回上一步 |
| 8 | 退改规则配置 | 点击「下一步」 | 渠道与短信配置 | 退改规则校验通过 | 返回上一步 |
| 9 | 渠道与短信配置 | 点击「下一步」 | 预览提交 | 短信/渠道配置完成 | 返回上一步 |
| 10 | 预览提交 | 点击「提交审核」 | 商品列表 | 全量校验通过 | 返回商品列表 |
| 11 | 预览提交 | 点击「保存草稿」 | 商品列表 | 无 | 返回商品列表 |
| 12 | 商品列表 | 点击「编辑」 | SPU基础信息编辑 | 商品状态为草稿/已下架/审核驳回 | 返回商品列表 |
| 13 | 商品列表 | 点击「提交审核」 | 商品列表 | 商品状态为草稿/审核驳回 | 无 |
| 14 | 商品审核列表 | 点击「审核」 | 商品审核详情 | 平台运营有审核权限 | 返回审核列表 |
| 15 | 商品审核详情 | 点击「通过/驳回」 | 商品审核列表 | 已填写审核意见 | 返回审核列表 |
| 16 | 商品列表 | 点击「库存管理」 | 库存详情页 | 商品存在SKU | 返回商品列表 |
| 17 | 商品列表 | 点击「价格管理」 | 价格日历/统一价页 | 商品存在SKU | 返回商品列表 |
| 18 | 商品列表 | 点击「素材管理」 | 素材库页 | 商品已创建 | 返回商品列表 |
9.2 页面布局通用规则
- 商品创建采用步骤条导航,固定8步:基础信息 → 票型与规格 → 库存与价格 → 销售规则配置 → 核销规则配置 → 退改规则配置 → 渠道与短信 → 预览提交。每类商品根据业务类型加载不同的默认字段,其中门票/酒店/车辆/线路产品配置日历库存,特色商品通过入库单管理进销存库存,组合套餐库存由子项联动决定。
- 每步支持「上一步/下一步/暂存草稿」,暂存不校验必填,提交审核时全量校验。
- 已上架商品编辑时,若修改价格/库存/SPU配置,系统提示是否触发重新审核或即时生效(根据变更字段决定)。
- 所有列表页支持高级筛选、分页(默认20条/页)、导出Excel。
10数据模型
本章定义商品供应链管理中心的核心数据表结构、字段含义、索引建议及关键约束,确保与分销中心、订单履约中心的数据一致性。
10.1 实体关系总览
erDiagram
CATEGORY ||--o{ PRODUCT_SPU : contains
SCENIC_POI ||--o{ PRODUCT_SPU : "门票/酒店/车辆/线路"
PRODUCT_SPU ||--|{ PRODUCT_SKU : has
PRODUCT_SPU ||--|| SPU_ORDER_CONFIG : config
PRODUCT_SPU }o--|| CANCEL_POLICY_TEMPLATE : uses
PRODUCT_SPU }o--o{ ROUTE_THEME : tagged
PRODUCT_SPU }o--o{ ROUTE_NODE : routed
PRODUCT_SPU }o--o{ PRODUCT_SPU : composed
PRODUCT_SPU }o--o{ SMS_TEMPLATE : selects
PRODUCT_SKU ||--o{ CALENDAR_INVENTORY : has
PRODUCT_SKU ||--o{ INVENTORY_INBOUND : "仅特色商品入库"
PRODUCT_SKU ||--|| PRICE_CONFIG : has
PRODUCT_SPU ||--o{ MATERIAL_LIBRARY : has
商品供应链核心实体关系图(注:INVENTORY_INBOUND 仅适用于特色商品SKU;SCENIC_POI 关联门票/酒店/车辆/线路产品)
10.2 商品分类表 t_category
| 字段名 | 类型 | 约束 | 说明 |
| id | bigint | PK AUTO_INCREMENT | 分类ID |
| tenant_type | varchar(20) | NOT NULL | PLATFORM/SUPPLIER |
| tenant_id | bigint | NOT NULL | 租户ID,平台分类填0 |
| category_code | varchar(32) | NOT NULL UNIQUE | 分类编码 |
| category_name | varchar(100) | NOT NULL | 分类名称 |
| parent_id | bigint | NOT NULL DEFAULT 0 | 父分类ID,0为根 |
| level | tinyint | NOT NULL | 层级 1/2/3 |
| tree_path | varchar(500) | NOT NULL | 层级路径,如 0,1,5 |
| sort_order | int | DEFAULT 0 | 同层排序 |
| product_type | varchar(20) | NULL | 关联商品类型 |
| status | tinyint | DEFAULT 1 | 0禁用 1启用 |
| is_deleted | tinyint | DEFAULT 0 | 逻辑删除 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.3 POI 表 t_scenic_poi
POI 用于维护景区、场馆、酒店、取还车点等物理场所信息。供应商可创建 POI 并提交平台审核,审核通过后可在 SPU 中关联使用。
| 字段名 | 类型 | 约束 | 说明 |
| poi_id | bigint | PK AUTO_INCREMENT | POI ID |
| tenant_type | varchar(20) | NOT NULL | PLATFORM/SUPPLIER |
| tenant_id | bigint | NOT NULL | 租户ID,平台创建填0 |
| poi_code | varchar(32) | NOT NULL UNIQUE | POI编码 |
| poi_name | varchar(100) | NOT NULL | POI名称,如景区/酒店名 |
| poi_type | varchar(20) | NOT NULL | 景区/场馆/演出厅/酒店/取车点/还车点 |
| province | varchar(50) | NULL | 省 |
| city | varchar(50) | NULL | 市 |
| district | varchar(50) | NULL | 区/县 |
| address | varchar(255) | NULL | 详细地址 |
| longitude | decimal(10,7) | NULL | 经度 |
| latitude | decimal(10,7) | NULL | 纬度 |
| business_hours | varchar(100) | NULL | 营业时间,如 08:00-18:00 |
| entry_address | varchar(255) | NULL | 入园/入店/上车地址 |
| preferential_policy | text | NULL | 优待政策说明 |
| contact_phone | varchar(50) | NULL | 联系电话 |
| images | json | NULL | POI图片URL数组 |
| status | tinyint | DEFAULT 1 | 0禁用 1启用 |
| audit_status | varchar(20) | DEFAULT 'draft' | draft/pending_audit/approved/rejected |
| audit_reason | varchar(500) | NULL | 审核驳回原因 |
| is_deleted | tinyint | DEFAULT 0 | 逻辑删除 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.3.1 POI 状态机
| 状态 | 说明 | 允许操作 |
| draft | 供应商创建中,未提交审核。 | 编辑、删除、提交审核 |
| pending_audit | 已提交平台审核。 | 平台审核通过/驳回 |
| approved | 审核通过,可关联 SPU。 | 编辑(触发重新审核)、禁用 |
| rejected | 审核驳回。 | 编辑、重新提交、删除 |
10.4 线路主题字典表 t_route_theme
| 字段名 | 类型 | 约束 | 说明 |
| theme_id | bigint | PK AUTO_INCREMENT | 主题ID |
| theme_name | varchar(50) | NOT NULL | 主题名称,如亲子、蜜月 |
| theme_code | varchar(32) | NOT NULL UNIQUE | 主题编码 |
| sort_order | int | DEFAULT 0 | 排序 |
| status | tinyint | DEFAULT 1 | 0禁用 1启用 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.5 线路节点字典表 t_route_node
| 字段名 | 类型 | 约束 | 说明 |
| node_id | bigint | PK AUTO_INCREMENT | 节点ID |
| node_name | varchar(100) | NOT NULL | 节点名称,如黄果树、小七孔 |
| node_code | varchar(32) | NOT NULL UNIQUE | 节点编码 |
| node_type | varchar(20) | NOT NULL | 景点/城市/商圈 |
| parent_id | bigint | DEFAULT 0 | 父节点ID |
| sort_order | int | DEFAULT 0 | 排序 |
| status | tinyint | DEFAULT 1 | 0禁用 1启用 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.6 商品SPU表 t_product_spu
| 字段名 | 类型 | 约束 | 说明 |
| spu_id | bigint | PK AUTO_INCREMENT | SPU主键 |
| spu_code | varchar(64) | NOT NULL UNIQUE | SPU编码 |
| tenant_type | varchar(20) | NOT NULL | 固定SUPPLIER |
| tenant_id | bigint | NOT NULL | 供应商租户ID |
| supplier_id | bigint | NOT NULL | 供应商ID,与tenant_id一致 |
| category_id | bigint | NOT NULL | 末级分类ID |
| product_type | varchar(20) | NOT NULL | ticket/hotel/vehicle/specialty/package/route |
| spu_name | varchar(200) | NOT NULL | 商品名称 |
| sub_title | varchar(500) | NULL | 副标题 |
| main_image | varchar(500) | NOT NULL | 主图URL |
| image_list | json | NULL | 轮播图数组 |
| detail_content | longtext | NULL | 商品详情富文本 |
| buy_notice | text | NULL | 购买须知 |
| attr_values | json | NULL | 分类属性模板值,见11.2 |
| route_themes | json | NULL | 线路主题ID数组,线路产品必填 |
| route_nodes | json | NULL | 线路节点ID数组(按顺序),线路产品必填 |
| package_composition | json | NULL | 套餐组成,组合套餐必填 |
| cancel_policy_id | bigint | NULL | 退改规则模板ID |
| poi_id | bigint | NULL | 关联POI ID,门票/酒店/车辆/线路产品必填 |
| is_points_product | tinyint | DEFAULT 0 | 是否积分商品 |
| is_searchable | tinyint | DEFAULT 1 | 是否允许被搜索 |
| is_third_party | tinyint | DEFAULT 0 | 是否第三方接口资源 |
| third_party_code | varchar(100) | NULL | 第三方产品编码 |
| third_party_supplier_code | varchar(100) | NULL | 第三方供应商/渠道编码 |
| sale_mode | varchar(20) | DEFAULT 'free_sale' | free_sale自由销售 / package_only仅套餐可用 |
| sms_template_ids | json | NULL | 关联短信模板ID数组 |
| sale_channels | json | NULL | 默认销售渠道配置,如 {"all":true} 或 {"b2b":{"levels":["S","A"],"distributor_ids":[1,2]},"c2c":true,"ota":false} |
| salesperson_visibility | varchar(20) | DEFAULT 'invisible' | 分销员可见范围:public公共分销 / exclusive专属分销 / invisible分销员不可见 |
| status | varchar(20) | DEFAULT 'draft' | draft/pending_audit/approved/stock_warning/sold_out/rejected/offline |
| audit_remark | varchar(500) | NULL | 审核驳回原因 |
| on_sale_time | datetime | NULL | 实际上架时间 |
| off_sale_time | datetime | NULL | 实际下架时间 |
| is_deleted | tinyint | DEFAULT 0 | 逻辑删除 |
| version | int | DEFAULT 0 | 乐观锁版本号 |
| creator_id / updater_id | bigint | NOT NULL | 创建/更新人 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.7 商品SKU表 t_product_sku
| 字段名 | 类型 | 约束 | 说明 |
| sku_id | bigint | PK AUTO_INCREMENT | SKU主键 |
| sku_code | varchar(64) | NOT NULL UNIQUE | SKU编码 |
| spu_id | bigint | NOT NULL FK | 所属SPU |
| tenant_type | varchar(20) | NOT NULL | SUPPLIER |
| tenant_id | bigint | NOT NULL | 供应商租户ID |
| sku_name | varchar(200) | NOT NULL | SKU名称,如成人票/双床房 |
| sku_desc | varchar(500) | NULL | SKU描述,如适用于18-59周岁成人 |
| sku_specs | json | NULL | 规格属性,如 {"人群":"成人","场次":"上午"} |
| age_min | int | NULL | 最低适用年龄,空表示不限 |
| age_max | int | NULL | 最高适用年龄,空表示不限 |
| audience_tags | json | NULL | 适用人群标签,如 ["成人","学生"] |
| real_name_required | tinyint | DEFAULT 0 | 该SKU是否要求实名 |
| real_name_types | json | NULL | 实名证件类型数组,如 ["身份证","护照"] |
| source_region_limit | json | NULL | 客源地限制,省份/城市编码数组 |
| special_certificate_required | tinyint | DEFAULT 0 | 是否要求上传特殊证件 |
| special_certificate_type | varchar(50) | NULL | 特殊证件类型,如教师证/学生证 |
| purchase_limit | int | DEFAULT 0 | 每人限购数量,0表示不限 |
| warning_stock | int | DEFAULT 0 | 库存预警阈值,0表示不预警 |
| market_price | decimal(12,2) | NOT NULL | 市场价 |
| sale_price | decimal(12,2) | NOT NULL | 实际售价 |
| limit_price | decimal(12,2) | NULL | 平台限价 |
| base_price | decimal(12,2) | NOT NULL | 底价 |
| weight | decimal(8,3) | DEFAULT 0 | 重量kg,普通商品物流用 |
| status | varchar(20) | DEFAULT 'enabled' | enabled/disabled |
| sort_order | int | DEFAULT 0 | 排序 |
| is_deleted | tinyint | DEFAULT 0 | 逻辑删除 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.8 SPU下单配置表 t_spu_order_config
本表与订单履约PRD保持一致,一个SPU对应一条配置,控制下单页渲染与核销规则。
| 字段名 | 类型 | 约束 | 说明 |
| config_id | bigint | PK AUTO_INCREMENT | 配置ID |
| spu_id | bigint | NOT NULL UNIQUE | SPU主键 |
| is_show_buy_notice | tinyint | DEFAULT 1 | 是否展示购买须知 |
| enable_sku | tinyint | DEFAULT 1 | 是否需要选择SKU |
| inventory_type | varchar(20) | DEFAULT 'calendar' | 库存类型:calendar日历库存 / total_inventory总库存 |
| is_time_slot_enabled | tinyint | DEFAULT 0 | 是否启用时段库存,0=不分时段,1=按时段拆分 |
| advance_book_days | int | DEFAULT 0 | 提前预定天数 |
| advance_book_time | varchar(10) | DEFAULT '00:00' | 提前预定截止时间,如18:00表示游玩当日18:00前可订 |
| cutoff_time | varchar(10) | DEFAULT '00:00' | 每日截止下单时间 |
| order_time_start | varchar(10) | NULL | 每日允许下单开始时间,如 09:00 |
| order_time_end | varchar(10) | NULL | 每日允许下单结束时间,如 22:00 |
| sale_region_limit_enabled | tinyint | DEFAULT 0 | 是否启用购买区域限制 |
| sale_region_geo | json | NULL | 购买区域多边形 GeoJSON |
| group_guide_certificate_required | tinyint | DEFAULT 0 | 团队订单是否要求上传导游证 |
| group_guide_real_name_required | tinyint | DEFAULT 0 | 团队订单是否要求导游实名信息 |
| group_itinerary_required | tinyint | DEFAULT 0 | 团队订单是否要求上传行程单 |
| package_only | tinyint | DEFAULT 0 | 是否仅允许组合套餐引用 |
| stock_mode | varchar(20) | DEFAULT 'independent' | shared共享库存池 / independent独立控位 |
| stock_warning_notify_mode | varchar(100) | DEFAULT 'platform_message' | 库存预警通知方式,多个以逗号分隔:platform_message/sms/email |
| enable_real_name | tinyint | DEFAULT 0 | 是否实名制 |
| require_certificate | tinyint | DEFAULT 0 | 是否上传证件 |
| certificate_type | varchar(50) | NULL | 证件类型标签 |
| require_guide_info | tinyint | DEFAULT 0 | 是否填写导游信息 |
| require_itinerary | tinyint | DEFAULT 0 | 是否上传行程单 |
| verify_before_use | tinyint | DEFAULT 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 | 是否支持部分核销 |
| auto_accept_order | tinyint | DEFAULT 1 | 是否自动收单 |
| manual_accept_order | tinyint | DEFAULT 0 | 是否允许手动收单 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.9 日历库存表 t_calendar_inventory
| 字段名 | 类型 | 约束 | 说明 |
| inventory_id | bigint | PK AUTO_INCREMENT | 库存记录ID |
| sku_id | bigint | NOT NULL FK | SKU ID |
| spec_date | date | NOT NULL | 日期 |
| total_stock | int | DEFAULT 0 | 总库存 |
| available_stock | int | DEFAULT 0 | 可用库存 |
| locked_stock | int | DEFAULT 0 | 锁定库存 |
| sold_stock | int | DEFAULT 0 | 已售库存 |
| warning_stock | int | DEFAULT 0 | 预警阈值 |
| sale_price | decimal(12,2) | NULL | 该日售价,为空取SKU默认 |
| base_price | decimal(12,2) | NULL | 该日底价,为空取SKU默认 |
| version | int | DEFAULT 0 | 乐观锁版本号 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.10 退改规则模板表 t_cancel_policy_template
| 字段名 | 类型 | 约束 | 说明 |
| template_id | bigint | PK AUTO_INCREMENT | 模板ID |
| tenant_type | varchar(20) | NOT NULL | PLATFORM/SUPPLIER |
| tenant_id | bigint | NOT NULL | 租户ID |
| template_name | varchar(100) | NOT NULL | 模板名称 |
| policy_json | json | NOT NULL | 退改规则JSON,见13.1 |
| is_default | tinyint | DEFAULT 0 | 是否为默认模板 |
| status | tinyint | DEFAULT 1 | 0禁用 1启用 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.11 短信模板表 t_sms_template
短信模板由平台运营统一维护,供应商在创建商品时选择需要触发的模板。
| 字段名 | 类型 | 约束 | 说明 |
| template_id | bigint | PK AUTO_INCREMENT | 模板ID |
| tenant_type | varchar(20) | NOT NULL | 固定 PLATFORM |
| tenant_id | bigint | NOT NULL DEFAULT 0 | 平台租户ID |
| template_code | varchar(32) | NOT NULL UNIQUE | 模板编码 |
| template_name | varchar(100) | NOT NULL | 模板名称 |
| template_content | varchar(500) | NOT NULL | 模板内容,支持变量如 {orderNo} {productName} |
| scene | varchar(50) | NOT NULL | 触发场景:paid已支付 / confirmed已确认收单 / refunded已退款 / custom自定义 |
| status | tinyint | DEFAULT 1 | 0禁用 1启用 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.11.1 短信变量规范
| 变量名 | 含义 | 示例值 |
| {orderNo} | 订单编号 | ORD202607080001 |
| {productName} | 商品名称 | 黄果树瀑布成人票 |
| {useDate} | 使用日期 | 2026-07-10 |
| {verifyCode} | 核销凭证码 | 832956 |
| {poiName} | POI名称 | 黄果树瀑布景区 |
| {entryAddress} | 入园/入店地址 | 景区东门游客中心 |
10.12 关键数据一致性约束
| 约束 | 实现方式 | 触发时机 |
| SPU与配置一对一 | t_spu_order_config.spu_id UNIQUE + 外键 | 创建SPU时自动初始化配置 |
| SKU归属SPU同租户 | 应用层校验 tenant_id 一致 | 创建/更新SKU时 |
| 价格层级不倒挂 | 应用层校验 + 数据库CHECK约束 | 保存SKU/价格日历时 |
| 库存公式恒等 | 定时对账任务 + 应用层更新同一事务 | 库存变更后 |
| POI 审核通过才可关联 SPU | 应用层校验 poi.audit_status='approved' | 创建/更新SPU时 |
| 仅套餐可用商品不单独展示 | 应用层过滤 sale_mode='package_only' | 分销商城查询时 |
| 第三方商品编码唯一性 | 应用层校验 supplier_id + third_party_supplier_code + third_party_code 唯一 | 保存第三方商品时 |
| 末级分类才可绑定SPU | 应用层校验 category.level=3 | 创建SPU时 |
| 删除限制 | 逻辑删除 + 外键约束 | 删除分类/SPU/SKU时 |
10.13 索引建议
| 表 | 索引字段 | 索引类型 | 用途 |
| t_product_spu | (tenant_id, status, category_id) | 复合索引 | 供应商商品列表查询 |
| t_product_spu | (spu_code) | 唯一索引 | 编码查询 |
| t_product_sku | (spu_id, status) | 复合索引 | SPU下SKU查询 |
| t_calendar_inventory | (sku_id, spec_date) | 唯一索引 | 按日期库存查询 |
| t_calendar_inventory | (sku_id, spec_date, available_stock) | 复合索引 | 可售日期筛选 |
| t_category | (tenant_id, parent_id, level, sort_order) | 复合索引 | 分类树查询 |
| t_scenic_poi | (tenant_id, audit_status, status) | 复合索引 | 供应商POI列表查询 |
| t_scenic_poi | (poi_code) | 唯一索引 | POI编码查询 |
| t_product_spu | (poi_id) | 普通索引 | 按POI查询商品 |
| t_product_spu | (is_third_party, third_party_code) | 复合索引 | 第三方商品查询 |
| t_spu_order_config | (spu_id) | 唯一索引 | 配置查询 |
| t_sms_template | (scene, status) | 复合索引 | 按场景查询可用模板 |
10.14 敏感词库表 t_sensitive_word
| 字段名 | 类型 | 约束 | 说明 |
| word_id | bigint | PK AUTO_INCREMENT | 敏感词ID |
| tenant_type | varchar(20) | NOT NULL | PLATFORM / SUPPLIER |
| tenant_id | bigint | NOT NULL | 租户ID,平台级填0 |
| word | varchar(200) | NOT NULL | 敏感词内容 |
| word_type | varchar(50) | DEFAULT 'sensitive' | sensitive敏感/forbidden违禁/political政治/ads广告法 |
| source | varchar(20) | DEFAULT 'manual' | manual手动添加 / ai AI自动发现 |
| status | tinyint | DEFAULT 1 | 1启用 0禁用 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.15 AI 审核记录表 t_ai_audit_record
| 字段名 | 类型 | 约束 | 说明 |
| record_id | bigint | PK AUTO_INCREMENT | 记录ID |
| biz_type | varchar(50) | NOT NULL | spu/sku/material |
| biz_id | bigint | NOT NULL | 业务对象ID |
| audit_type | varchar(20) | NOT NULL | text文本 / image图片 |
| content_snapshot | text | NULL | 文本快照或图片URL |
| ai_result | varchar(20) | NOT NULL | pass通过 / suspect疑似 / reject拒绝 |
| ai_score | decimal(5,2) | NULL | 置信度分数 |
| ai_reason | varchar(500) | NULL | AI判定原因 |
| ai_model | varchar(100) | NULL | 模型/服务版本 |
| manual_result | varchar(20) | NULL | 人工复审结果 |
| manual_reason | varchar(500) | NULL | 人工复审原因 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.16 库存预警记录表 t_stock_warning_record
| 字段名 | 类型 | 约束 | 说明 |
| record_id | bigint | PK AUTO_INCREMENT | 记录ID |
| sku_id | bigint | NOT NULL FK | SKU ID |
| spec_date | date | NULL | 日历库存日期,总库存场景为空 |
| warning_stock | int | DEFAULT 0 | 触发时的预警阈值 |
| available_stock | int | DEFAULT 0 | 触发时的可用库存 |
| notify_mode | varchar(100) | NULL | 实际发送的通知方式 |
| status | varchar(20) | DEFAULT 'sent' | sent已发送 / resolved已解除 |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.17 AI 生成记录表 t_ai_generation_record
| 字段名 | 类型 | 约束 | 说明 |
| record_id | bigint | PK AUTO_INCREMENT | 记录ID |
| biz_type | varchar(50) | NOT NULL | spu/sku |
| biz_id | bigint | NOT NULL | 业务对象ID |
| field_type | varchar(50) | NOT NULL | main_image/ carousel/ selling_point/ detail_content |
| prompt | text | NULL | 用户输入的提示词或参考内容 |
| candidates | json | NULL | AI返回的候选结果 |
| apply_status | varchar(20) | DEFAULT 'pending' | pending待应用 / applied已应用 / discarded已放弃 |
| creator_id | bigint | NOT NULL | 操作人ID |
| create_time / update_time | datetime | NOT NULL | 创建/更新时间 |
10.18 调价记录表 t_price_change_record
| 字段名 | 类型 | 约束 | 说明 |
| 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 | 创建时间 |
11商品分类、POI 与短信模板管理
本章定义商品分类管理体系、POI 管理、短信模板管理,以及分类属性模板、线路主题与线路节点字典。供应商创建的 POI 需提交平台审核,审核通过后才可在 SPU 中关联使用;短信模板由平台运营统一维护,供应商在创建商品时选择。
11.1 分类树维护
11.1.1 业务规则
- 分类树支持三级结构:一级类目 → 二级类目 → 三级类目。
- 一级分类固定为: 门票、酒店、车辆、特色商品。平台运营不可新增/删除一级分类,但可编辑名称与排序。
- 平台运营在一级分类下维护二三级分类;组合套餐、线路产品作为独立商品类型,也支持设置二三级分类(一级分类可单独设置「组合套餐」「线路产品」,或由平台运营在后台配置)。
- SPU必须绑定到末级分类(level=3)。
- 分类支持启用/禁用,禁用后该分类下已上架商品保持上架状态,但新增商品不可再选择该分类。
- 分类支持同层级排序,排序值越小越靠前。
11.1.2 新增分类
| 字段 | 规则 | 前端表现 |
| 分类名称 | 必填,2-20字符,同父下不可重复。 | 输入框,重复时红框提示。 |
| 父分类 | 一级分类父ID为0;二级/三级需选择上级。一级分类只能从预设四项中选择。 | 级联选择器,仅展示启用中的上级。 |
| 层级 | 根据父分类自动计算,最大3级。 | 只读展示。 |
| 排序 | 整数,默认0,同层按升序排列。 | 数字输入框。 |
| 关联商品类型 | 三级分类可选,决定该分类下SPU默认商品类型。 | 下拉选择:门票/酒店/车辆/特色商品/组合套餐/线路产品。 |
| 状态 | 默认启用。 | 开关组件。 |
11.1.3 编辑分类
- 分类名称、排序、状态、关联商品类型可编辑。
- 父分类不可编辑;如需调整,需先删除原分类再新建(无SPU关联时)。
- 编辑分类名称后,已关联SPU的分类路径展示名称即时生效(读取时根据当前分类表动态计算)。
11.1.4 删除分类
删除限制: 存在以下任一情况时禁止删除:1)该分类存在子分类;2)该分类下存在SPU(含已删除SPU);3)该分类被平台默认模板或活动规则引用。
- 删除操作执行逻辑删除,
is_deleted=1,不物理删除。
- 删除前弹窗二次确认,并提示关联数据数量。
11.2 分类属性模板(平台运营自定义)
11.2.1 业务规则
平台运营可针对二三级分类配置属性模板,用于规范该分类下SPU/SKU的扩展属性,解决不同供应商填报字段不一致的问题。
- 属性模板按分类维护,优先加载三级分类模板;三级未配置时继承二级分类模板。
- 属性分为基础属性(系统内置,不可删除)和扩展属性(平台运营自定义)。
- 属性类型支持:文本、数字、单选、多选、多选标签、日期、日期区间、图片、富文本、布尔、地址、关联字典。
- 属性可设置为必填或选填,可设置排序、默认值、提示文案。
- 平台运营修改模板后,仅对新创建SPU生效,已创建SPU保持原值不变。
11.2.2 属性模板配置入口
- 平台运营后台「商品中心-分类管理」选择分类后,点击「配置属性模板」。
- 弹窗展示已配置字段,支持新增、编辑、删除、排序。
- 每个字段包含:字段名称、字段编码、字段类型、是否必填、默认值、提示文案、可选值(单选/多选时)。
11.2.3 属性模板示例
| 分类 | 属性名 | 类型 | 必填 | 说明 |
| 门票-景区门票 | 景区名称 | 文本 | 是 | 景区/场馆全称。 |
| 门票-景区门票 | 入园方式 | 单选 | 是 | 刷身份证/二维码/纸质票。 |
| 门票-景区门票 | 是否需要预约 | 布尔 | 是 | 控制是否进入待预约流程。 |
| 酒店-度假酒店 | 酒店星级 | 单选 | 是 | 一星至五星/民宿。 |
| 酒店-度假酒店 | 入住时间 | 文本 | 是 | 如 14:00。 |
| 车辆-日游包车 | 车型 | 单选 | 是 | 5座/7座/12座等。 |
| 车辆-日游包车 | 服务时长 | 数字 | 是 | 单位小时。 |
| 特色商品-特产 | 产地 | 文本 | 否 | 商品产地。 |
| 线路产品-跟团游 | 行程天数 | 数字 | 是 | 行程总天数。 |
| 线路产品-跟团游 | 出发地 | 文本 | 是 | 集合出发城市。 |
| 线路产品-跟团游 | 主题 | 多选标签 | 否 | 亲子/蜜月/摄影/徒步等。 |
11.2.4 属性模板生效规则
- 供应商创建SPU选择分类后,系统自动加载该分类的属性模板。
- 必填属性未填写时,禁止提交审核。
- 单选/多选字段必须在可选值范围内选择,不可随意输入。
11.3 分类与商品类型绑定
| 商品类型 | 适用一级分类 | 二级/三级分类示例 | 默认SPU配置 |
| 门票 | 门票 | 景区门票、演艺票、体验票 | 日历模式、需实名、一单一码一票一用 |
| 酒店 | 酒店 | 度假酒店、民宿客栈、商务酒店 | 日历模式、需联系人、确认入住 |
| 车辆 | 车辆 | 接送机、日游包车、租车自驾 | 日历模式、需用车人、手动确认 |
| 特色商品 | 特色商品 | 文创周边、旅游特产、装备 | 非日历、无实名、物流发货 |
| 组合套餐 | 组合套餐 | 自由行套餐、亲子套餐、情侣套餐 | 根据组成商品聚合配置 |
| 线路产品 | 线路产品 | 跟团游、私家团、一日游 | 日历模式、需联系人、按行程核销 |
11.4 线路主题与线路归类
11.4.1 线路主题(标签)
- 线路产品支持设置多个主题标签,如「亲子」「蜜月」「摄影」「徒步」「美食」「康养」。
- 主题标签由平台运营维护,供应商在创建线路产品时多选关联。
- 主题标签用于分销商城筛选与搜索加权。
11.4.2 线路归类
- 线路产品支持设置线路归类,用于标识线路经过的核心节点,如「黄果树——小七孔——西江千户苗寨」。
- 线路归类由平台运营维护基础节点字典(景点/城市),供应商可组合选择节点顺序。
- 节点顺序影响线路详情页行程展示与搜索过滤。
- 线路归类与分类树独立,一个线路产品可同时属于某个三级分类 + 多个主题 + 一条线路归类。
11.4.3 数据表扩展
| 表 | 说明 |
| t_route_theme | 线路主题字典表,平台运营维护。 |
| t_route_node | 线路节点字典表(景点/城市),平台运营维护。 |
| t_product_spu.route_themes | 线路产品关联主题ID数组(JSON)。 |
| t_product_spu.route_nodes | 线路产品关联节点ID数组(JSON,按顺序)。 |
11.5 分类删除与转移
11.5.1 批量转移
- 当分类需要下线或合并时,平台运营可将该分类下SPU批量转移至其他末级分类。
- 转移前校验目标分类的商品类型与原分类一致;不一致时提示「目标分类商品类型不一致,请重新选择」。
- 转移后原分类下无SPU,方可删除原分类。
11.5.2 异常处理
| 异常场景 | 前端表现 | 后端处理 |
| 同父分类名称重复 | 红框提示「该分类名称已存在」 | 400 + CATEGORY_NAME_DUPLICATE |
| 删除有子分类的分类 | 弹窗提示「请先删除子分类」 | 400 + HAS_CHILD_CATEGORY |
| 删除有SPU的分类 | 弹窗提示「该分类下存在N个商品,请先转移」 | 400 + HAS_PRODUCT |
| 超过三级分类 | 三级分类下不显示「新增子分类」按钮 | 400 + CATEGORY_LEVEL_EXCEEDED |
| 修改一级分类 | 一级分类名称与排序可编辑,删除按钮禁用 | 400 + ROOT_CATEGORY_IMMUTABLE |
11.6 页面原型示意
▼📁门票
▼📁酒店
▼📁车辆
▼📁特色商品
▼📁组合套餐
▼📁线路产品
分类详情
分类名称景区门票
父分类门票
层级三级
商品类型门票
排序1
状态启用
11.7 POI 管理
11.7.1 业务规则
- POI 用于维护景区、场馆、演出厅、酒店、取车点、还车点等物理场所信息,可被多个 SPU 共享引用。
- POI 可由供应商创建后提交平台审核,也可由平台运营直接创建;平台运营创建的 POI 默认
audit_status='approved',全平台供应商均可引用。
- 仅
audit_status='approved' 且 status=1 的 POI 才允许在 SPU 中关联。
- SPU 关联 POI 后,POI 关键字段变更需重新提交审核,审核通过后同步更新已关联 SPU 的展示信息。
- POI 删除限制:若存在已上架 SPU 关联,则禁止删除,需先下架/转移商品。
11.7.2 POI 字段表单
| 字段 | 类型 | 必填 | 说明 |
| POI名称 | 输入框 | 是 | 景区/场馆/酒店名,如黄果树瀑布景区 |
| POI类型 | 下拉单选 | 是 | 景区/场馆/演出厅/酒店/取车点/还车点 |
| 所在地区 | 省市区级联 | 是 | 省/市/区选择 |
| 详细地址 | 输入框 | 是 | 完整地址,支持地图选点回填经纬度 |
| 经纬度 | 数字输入 | 否 | 地图选点后自动填充,用于区域限制判断 |
| 营业时间 | 输入框 | 否 | 如 08:00-18:00 |
| 入园/入店/上车地址 | 输入框 | 否 | 实际使用入口地址 |
| 优待政策说明 | 富文本 | 否 | 儿童、老人、学生等优待政策 |
| 联系电话 | 输入框 | 否 | 景区/酒店联系电话 |
| POI图片 | 图片上传 | 否 | 最多9张,用于商品详情展示 |
11.7.3 页面功能
| 功能 | 操作人 | 说明 |
| 新增 POI | 供应商 | 填写表单后保存为草稿或提交审核 |
| 编辑 POI | 供应商/平台 | 供应商编辑后重新进入待审核;平台编辑且不改关键字段可直接生效 |
| 提交审核 | 供应商 | 校验必填项后状态变为 pending_audit |
| 审核通过/驳回 | 平台运营 | 驳回必填原因;通过后关联 SPU 可选择 |
| 禁用/启用 | 平台运营 | 禁用后已关联 SPU 仍可展示,但新建 SPU 不可选择 |
| 删除 POI | 供应商/平台 | 仅草稿/驳回且未关联 SPU 时可删除 |
11.7.4 异常处理
| 异常场景 | 前端表现 | 后端处理 |
| POI 名称重复 | 红框提示「POI名称已存在」 | 400 + POI_NAME_DUPLICATE |
| 未审核通过关联 SPU | POI 下拉框中隐藏 | 保存 SPU 时校验 poi.audit_status |
| 删除已关联 SPU 的 POI | 弹窗提示「该POI已被N个商品引用,不可删除」 | 400 + POI_HAS_PRODUCT |
11.8 短信模板管理
11.8.1 业务规则
- 短信模板由平台运营统一维护,供应商在创建商品时按场景选择需要触发的模板。
- 模板内容支持变量替换,变量格式为 {orderNo}、{productName}、{useDate}、{verifyCode}、{poiName}、{entryAddress}。
- 同一触发场景下,一个 SPU 可选择启用多个模板或关闭短信通知。
- 模板变更后,已保存草稿/已上架商品的短信配置不受影响;重新编辑商品时可重新选择。
11.8.2 短信触发场景
| 场景编码 | 场景名称 | 触发时机 | MVP是否支持 |
| paid | 已支付 | 用户支付成功后 | 是 |
| confirmed | 已确认收单 | 订单自动收单或供应商手动确认收单后 | 是 |
| refunded | 已退款 | 退款完成后 | 是 |
| custom | 自定义 | 预留,后续支持按业务事件自定义触发 | 否 |
11.8.3 模板字段表单
| 字段 | 类型 | 必填 | 说明 |
| 模板编码 | 输入框 | 是 | 全局唯一,如 TICKET_PAID_SMS |
| 模板名称 | 输入框 | 是 | 如门票支付成功通知 |
| 触发场景 | 下拉单选 | 是 | paid/confirmed/refunded/custom |
| 模板内容 | 文本域 | 是 | 短信正文,限制500字符,支持变量 |
| 状态 | 开关 | 是 | 启用/禁用 |
11.8.4 页面功能
| 功能 | 操作人 | 说明 |
| 新增模板 | 平台运营 | 填写编码、名称、场景、内容后保存 |
| 编辑模板 | 平台运营 | 修改后即时生效,已选商品下次发送使用新内容 |
| 禁用模板 | 平台运营 | 禁用后供应商不可选择,已选商品继续发送 |
| 预览效果 | 平台运营 | 输入测试变量后渲染短信内容 |
13效期与价格管理
本章覆盖商品退改规则模板、效期规则、五层价格体系、底价/专属价/佣金配置及全局限价规则,确保价格与退款逻辑可落地。
13.1 退改规则模板管理
13.1.1 业务规则
- 退改规则以模板形式维护,平台运营可创建平台默认模板,供应商可创建自有模板。
- 模板支持多个退款时间段,每个时间段对应不同的退款比例。
- 退款比例 = 实际退还金额 / 实付金额,100%表示全额退款,0%表示不可退。
- 模板被SPU引用后,修改模板对已引用商品不追溯生效,仅对新引用生效(避免历史订单规则变化)。
- 核销前退款按商品引用的退改规则模板计算退款金额,可能扣除手续费;已核销/已履约订单原则上不支持退款(特殊情况平台仲裁)。
13.1.2 模板字段
| 字段 | 类型 | 说明 |
| template_name | varchar(100) | 模板名称,如「演出开始前24小时可退」。 |
| policy_json | json | 退改规则数组,见下方示例。 |
| is_default | tinyint | 是否为默认模板,每个租户最多1个默认。 |
| status | tinyint | 0禁用 1启用。 |
13.1.3 policy_json 结构示例
JSON示例
[{
"before_hours": 24,
"refund_rate": 100,
"deduct_type": "none",
"remark": "演出开始前24小时及以上,全额退款"
},{
"before_hours": 4,
"refund_rate": 50,
"deduct_type": "percent",
"remark": "演出开始前4至24小时,退还50%"
},{
"before_hours": 0,
"refund_rate": 0,
"deduct_type": "all",
"remark": "演出开始前4小时内,不可退款"
}]
13.1.4 退款金额计算
- 根据订单中商品的使用时间(如入园日期、入住日期)计算距使用时间的剩余小时数。
- 匹配最大
before_hours 且小于等于剩余小时数的规则。
- 退款金额 = 实付金额 × 退款比例。
- 若存在手续费,优先从退款金额中扣除,或按平台规则由用户承担。
13.2 收单规则管理
13.2.1 业务规则
- 订单支付成功后,系统根据SPU的
auto_accept_order与manual_accept_order配置决定收单方式。
- 自动收单:
auto_accept_order=1时,订单状态由已支付直接流转为已收单,进入待核销/履约。
- 手动收单/审核收单:
manual_accept_order=1或verify_before_use=1时,订单进入待供应商确认收单状态(二者等价,不单独设置待审核状态),供应商确认有房、出票成功或资源可用后点击确认收单,才算正式收单。
- 手动收单/审核收单设置默认处理时效,如24小时;超时未处理自动触发退款并释放库存。
- 确认收单驳回后订单按原支付方式原路退款,已占库存释放。
- 组合套餐的收单规则按子项中最严格的规则执行:任一子项需手动收单,则整个套餐订单需等待所有子项收单完成。
13.2.2 状态流转
| 收单方式 | 支付后状态 | 供应商操作 | 下一状态 |
| 自动收单 | 已收单 | 无需操作 | 待核销/履约 |
| 手动收单/审核收单 | 待收单 | 确认收单 | 已收单并生成核销凭证 |
| 手动收单/审核收单驳回 | 待收单 | 驳回/超时 | 已退款 |
13.2.3 与核销规则的关系
- 自动收单且无需使用前审核的订单,支付成功后即可生成核销码或进入履约流程。
- 手动收单/审核收单的订单,仅在供应商确认收单后才生成核销码;确认前不可核销。
- 核销方式由
verification_type决定,与收单方式独立配置。
13.3 购买区域限制规则
13.3.1 业务规则
- 供应商在商品销售规则中可启用购买区域限制,绘制或导入GeoJSON多边形作为可售区域。
- 用户下单时,系统优先获取用户定位经纬度;定位失败时 fallback 到IP解析经纬度。
- 判断点是否在任一多边形内,不在区域内则禁止下单,前端提示「当前定位不在销售区域内,无法购买」。
- 区域限制对C端与B端商城均生效;组合套餐中包含受区域限制子项时,按子项限制分别校验。
- 「仅套餐可用」商品不参与商城展示,但在组合套餐中被购买时仍需校验区域限制。
13.3.2 技术实现
- GeoJSON多边形存储在
t_spu_order_config.sale_region_geo字段中,支持多个多边形集合。
- 下单接口调用区域判断服务,入参为用户经纬度,返回是否在区域内。
- 定位与IP解析结果均不命中时,按平台配置策略处理:允许购买或禁止购买。
13.4 效期规则管理
13.4.1 效期类型
| 效期类型 | 说明 | 适用商品 |
| 固定有效期 | 指定开始日期与结束日期,如 2026-07-01 至 2026-09-30。 | 门票、套餐 |
| 动态有效期 | 购买后N天内有效,如购买后30天有效。 | 门票、套餐 |
| 指定日期有效 | 仅在特定日期或日期区间可用。 | 活动票、特价房 |
| 长期有效 | 无明确过期时间。 | 特色商品、部分通兑券 |
13.4.2 效期与日历模式关系
- 日历模式商品:用户选择具体日期,该日期必须在效期范围内。
- 通兑模式商品:用户购买后在效期内预约或直接核销。
- 商品过期后系统自动下架,已售未使用订单按退改规则处理。
13.5 五层价格体系配置
13.5.1 价格层级约束
核心公式: 市场价 market_price ≥ 实际售价 sale_price;实际售价 sale_price ≤ 平台限价 limit_price;平台限价 limit_price ≥ 底价 base_price。专属价 exclusive_price 由供应商针对特定分销商独立设置,与底价 base_price 之间不做强制大小约束。
13.5.2 各价格角色
| 价格 | 维护方 | 可见方 | 用途 |
| 市场价 | 供应商 | 所有人 | 划线价,展示优惠力度。 |
| 实际售价 | 供应商/平台 | C端/B端采购前 | 前台展示价。 |
| 平台限价 | 平台运营 | 分销商(限制) | 分销商销售价上限。 |
| 底价 | 供应商 | B端/OTA分销商 | B端/OTA采购成交价,即B端/OTA订单的成交价。 |
| 专属价 | 供应商 | 特定B端/OTA分销商 | 专属协议采购成交价。 |
13.5.3 价格校验规则
- 所有价格必须 > 0,保留两位小数。
market_price ≥ sale_price,sale_price ≤ limit_price,limit_price ≥ base_price。
- 专属价
exclusive_price 由供应商针对特定分销商独立设置,与底价 base_price 之间不做强制大小约束。
- 日历模式下,每一天的价格独立校验。
- 修改价格后,已创建订单按下单时的价格快照结算,不受后续调价影响。
13.6 底价/专属价/佣金配置
13.6.1 B端底价模式
- B端分销商以底价采购商品,主要用于自身经营消费;具备供应商身份时,可将所采购商品与其他商品组合为套餐/线路对外销售并自行定价。
- 不同B端等级(S/A/B/C)可在分销中心配置不同底价折扣。
- 底价由供应商维护,平台运营可设置全局限价。
13.6.2 专属价配置
- 供应商在「分销管理-授权产品」中为特定分销商设置专属价。
- 专属价由供应商独立设置,与平台默认分销价(即底价或默认分销价)之间不做强制大小约束。
- 授权有效期内,该分销商在分销商城看到专属价。
- 专属价变更后即时生效,已生成订单不受影响。
13.6.3 个体佣金配置
- 个体分销商推广商品获得佣金,佣金比例在分销中心维护。
- 商品中心不直接维护佣金比例,但需在价格服务中暴露
commission_rate 字段供分销中心写入。
- 佣金计算基础为实际成交金额(不含运费)。
13.7 全局限价规则
13.7.1 限价维度
| 维度 | 优先级 | 说明 |
| 商品级 | 最高 | 针对具体SKU/SPU设置限价。 |
| 品类级 | 中 | 针对某一品类统一设置限价。 |
| 全局级 | 最低 | 平台级默认规则。 |
13.7.2 限价规则字段
| 字段 | 说明 |
| rule_type | global/category/product |
| target_id | 品类ID或SPU/SKU ID,全局规则填0。 |
| max_price | 最高售价,必须 > 底价。 |
| effective_time | 生效时间。 |
| status | 启用/禁用。 |
13.7.3 限价拦截
- 分销商下单销售时,系统校验售价是否超过限价。
- 超限时前端红框提示「售价超过平台限价(¥XXX.XX),请调整价格」,提交按钮禁用。
- 后端校验错误码:400 + PRICE_LIMIT_EXCEEDED。
- 违规记录留痕,包含分销商、商品、违规售价、限价、触发时间。
13.8 价格变更生效规则
| 变更类型 | 是否需要重新审核 | 生效时机 |
| 市场价、副标题、卖点等非价格敏感字段 | 否 | 保存即时生效。 |
| 售价、底价调整但未突破层级 | 建议(可配置) | 已上架商品需重新审核或平台运营确认。 |
| 平台限价调整 | 否 | 保存即时生效,不追溯历史订单。 |
| 专属价调整 | 否 | 保存即时生效,已授权分销商立即看到新价。 |
13.8.1 调价留痕
- 所有售价、底价、限价、专属价的变更均写入
t_price_change_record,包含调整前后值、价格类型、业务对象、操作人、来源与生效状态。
- 日历库存模式下,按 SKU+日期维度记录每一天的价格变更。
- 授权底价/授权库存的变更同样记录到本表,
biz_type='authorization'。
13.9 异常处理
| 异常场景 | 前端表现 | 后端处理 |
| 价格倒挂 | 红框提示具体层级错误 | 400 + PRICE_INVERSION |
| 限价低于底价 | 提示「限价不能低于底价」 | 400 + LIMIT_BELOW_BASE |
| 退改规则时间冲突 | 提示「退款时间段存在重叠」 | 400 + POLICY_TIME_OVERLAP |
| 手动收单超时 | 提示「供应商未在时效内确认收单,订单已自动退款」 | 400 + ACCEPT_ORDER_TIMEOUT |
| 收单审核驳回 | 提示「供应商审核未通过,订单将原路退款」 | 400 + ACCEPT_ORDER_REJECTED |
| 不在销售区域 | 提示「当前定位不在销售区域内,无法购买」 | 400 + OUT_OF_SALE_REGION |
14特色商品进销存管理
本章仅针对特色商品(实物商品)的进销存管理进行说明,包括入库单、出库单、库存盘点、调拨、批次管理及库存预警。门票、酒店、车辆、组合套餐、线路产品的库存管理由各商品类型在创建时按日历/控位/子项联动方式处理,不在本章详述。
14.1 业务规则
- 特色商品库存采用进销存管理模式,支持采购入库、销售出库、盘点、调拨。
- 库存增加必须通过入库单,库存减少可通过销售出库单、盘点盘亏、调拨出库。
- 特色商品库存按SKU维度管理,支持批次(先进先出)。
- 所有库存变动记录流水,支持追溯。
14.2 入库单管理
14.2.1 入库类型
| 入库类型 | 说明 |
| 采购入库 | 从供应商或厂家采购入库。 |
| 退货入库 | 分销商/客户退货入库,需质检。 |
| 盘盈入库 | 盘点发现实物多于系统库存。 |
| 调拨入库 | 从其他仓库调入。 |
14.2.2 入库单字段
| 字段 | 说明 |
| inbound_no | 入库单号,IN + 日期 + 6位流水。 |
| sku_id | 入库SKU。 |
| batch_no | 批次号。 |
| quantity | 入库数量,正整数。 |
| warehouse_id | 入库仓库。 |
| inbound_type | 入库类型。 |
| supplier_remark | 供应商备注。 |
| status | pending/submitted/approved/revoked。 |
| auditor_id / audit_time | 审核人/时间。 |
14.2.3 入库流程
- 供应商运营选择SKU、仓库、批次,填写入库数量与类型。
- 提交后状态变更为「待审核」。
- 供应商管理员审核通过后,状态变更为「已入库」,库存增加。
14.3 出库单管理
14.3.1 出库类型
| 出库类型 | 说明 |
| 销售出库 | 订单发货后自动生成。 |
| 盘亏出库 | 盘点发现实物少于系统库存。 |
| 调拨出库 | 调出至其他仓库。 |
14.3.2 销售出库触发规则
- 特色商品订单发货后,系统自动生成销售出库单。
- 出库数量 = 订单购买数量。
- 按批次先进先出扣减库存。
14.4 库存盘点
- 供应商定期对特色商品进行盘点。
- 盘点单包含:SKU、批次、系统库存、实盘数量、差异数量。
- 盘点完成后生成盘盈/盘亏单,经审核后调整库存。
14.5 库存调拨
- 支持多仓库间调拨。
- 调拨单包含:调出仓库、调入仓库、SKU、数量、批次。
- 调拨出库后库存减少,调拨入库后库存增加。
14.6 库存预警
- 每个SKU可设置安全库存阈值。
- 当可用库存 ≤ 安全库存时,系统发送站内消息/短信提醒供应商运营补货。
- 商品列表展示「库存紧张」标签。
14.7 库存公式
可用库存 = 期初库存 + 累计入库 - 累计出库 - 锁定库存
- 锁定库存:已下单未发货订单占用的库存。
- 超卖防护:提交订单时校验可用库存,并发场景使用乐观锁。
14.8 库存日志
| 字段 | 说明 |
| log_id | 日志ID |
| sku_id / batch_no | SKU与批次 |
| change_type | 入库/出库/盘点/调拨/锁定/释放 |
| quantity | 变动数量,正增负减 |
| before_stock / after_stock | 变动前后可用库存 |
| biz_type / biz_id | 业务类型与业务单号 |
| operator_id | 操作人 |
| create_time | 操作时间 |
14.9 异常处理
| 异常场景 | 前端表现 | 后端处理 |
| 入库数量非法 | 红框提示「请输入正整数」 | 400 + INVALID_QUANTITY |
| 出库数量超过可用库存 | 提示「库存不足,无法出库」 | 400 + STOCK_INSUFFICIENT |
| 并发超卖 | 下单页提示「库存不足」 | 409 + STOCK_INSUFFICIENT |
| 盘点差异未审核 | 提示「请先审核盘点单」 | 400 + INVENTORY_NOT_AUDITED |
15内容素材管理
本章覆盖商品详情模板、图片/视频/海报/文案素材库,以及面向分销商的分销素材工坊,确保商品内容规范、推广素材可复用。
15.1 商品详情模板
15.1.1 业务规则
- 商品详情采用富文本编辑器维护,支持文字、图片、视频、表格、链接。
- 平台运营可维护商品详情模板,供应商创建商品时可引用模板并替换内容。
- 详情内容审核时检测违禁词、敏感图片、虚假宣传。
15.1.2 详情字段
| 字段 | 说明 | 限制 |
| 商品介绍 | 富文本,介绍商品特色。 | ≤20000字符 |
| 费用包含 | 列出套餐包含内容。 | ≤5000字符 |
| 费用不含 | 列出不含项目。 | ≤5000字符 |
| 使用说明 | 使用时间、地点、方式。 | ≤5000字符 |
| 购买须知 | 已单独字段存储,SPU配置决定是否下单页展示。 | ≤5000字符 |
| 温馨提示 | 注意事项。 | ≤5000字符 |
15.1.3 详情内容安全
- 图片需经过OCR/敏感图检测,违规图片禁止保存。
- 文本内容经过违禁词库过滤,命中时提示修改。
- 外部链接需通过白名单校验,禁止跳转非授权域名。
15.2 素材库
15.2.1 素材类型
| 素材类型 | 格式 | 大小限制 | 用途 |
| 商品主图 | JPG/PNG | ≤5MB | 列表/详情展示 |
| 轮播图 | JPG/PNG | ≤5MB/张 | 详情页轮播 |
| 详情图 | JPG/PNG | ≤10MB/张 | 富文本详情 |
| 海报 | JPG/PNG | ≤10MB | 分销商推广 |
| 短视频 | MP4 | ≤100MB | 详情/推广 |
| 推广文案 | 文本 | ≤500字符 | 朋友圈/社群 |
| 行程单模板 | PDF/Word | ≤10MB | 团队订单上传 |
15.2.2 素材关联
- 每个SPU可关联多个素材,素材按类型分组展示。
- 主图、轮播图、购买须知为必填项(根据SPU配置)。
- 素材支持批量上传、拖拽排序、替换、删除。
15.2.3 素材水印
- 上传图片/海报时可选择是否添加平台水印(默认开启)。
- 水印位置:右下角,透明度30%,包含平台Logo。
- 分销商下载素材时,可选择是否叠加分销商专属二维码。
15.3 分销素材工坊
15.3.1 业务规则
- 分销素材工坊面向供应商和分销商,提供一键生成推广素材的能力。
- 供应商上传商品素材后,系统自动生成多套海报尺寸(朋友圈1:1、抖音9:16、公众号2.35:1等)。
- 分销商可选择素材模板,输入自定义文案,生成带个人推广二维码的海报。
15.3.2 素材模板管理
| 模板字段 | 说明 |
| template_name | 模板名称。 |
| aspect_ratio | 宽高比,如1:1、9:16、2.35:1。 |
| layout_json | 布局配置JSON(图片位置、文字位置、颜色)。 |
| status | 启用/禁用。 |
15.3.3 AI文案辅助
- 系统根据商品名称、卖点、价格自动生成多条推广文案。
- 供应商/分销商可编辑后保存。
- AI文案需经过违禁词检测。
15.4 异常处理
| 异常场景 | 前端表现 | 后端处理 |
| 图片格式不符 | 提示「仅支持JPG/PNG」 | 400 + INVALID_IMAGE_FORMAT |
| 图片超过大小 | 提示「图片大小不能超过X MB」 | 400 + IMAGE_TOO_LARGE |
| 素材包含违禁词 | 提示「素材内容违规,请修改」 | 400 + CONTENT_VIOLATION |
| 主图缺失 | 提交审核时提示「请上传主图」 | 400 + MAIN_IMAGE_REQUIRED |
16系统初始化与依赖顺序
本章说明商品供应链管理中心上线前需准备的基础数据、依赖模块及接口契约,确保系统可按正确顺序交付与验收。
16.1 初始化数据清单
| 初始化项 | 数据内容 | 维护方 | 依赖 | 优先级 |
| 资源商品分类树 | 一级固定为门票/酒店/车辆/特色商品,运营平台维护二三级分类;SPU必须挂载到末级分类。 | 平台运营 | 无 | P0 |
| 组合套餐分类 | 独立于资源分类维护,支持多级分类设置。 | 平台运营 | 无 | P0 |
| 线路产品分类 | 独立于资源分类维护,支持多级分类设置。 | 平台运营 | 无 | P0 |
| 线路主题与线路节点 | 线路主题(标签)字典、线路节点/归类字典(如黄果树—小七孔—西江千户苗寨)。 | 平台运营 | 无 | P0 |
| 分类属性模板 | 按商品类型预置扩展属性(如门票的景区、入园方式等)。 | 平台运营 | 分类树 | P0 |
| 平台默认退改模板 | 至少3个默认模板:随时退、不可退、阶梯退。 | 平台运营 | 无 | P0 |
| 全局限价规则 | 平台级默认限价规则(全局/品类维度)。 | 平台运营 | 分类树 | P1 |
| 商品详情模板 | 按商品类型预置详情模板。 | 平台运营 | 无 | P1 |
| 素材模板 | 分销素材工坊海报模板(1:1/9:16/2.35:1)。 | 平台运营 | 无 | P2 |
| POI类型字典 | 景区/场馆/演出厅/酒店/取车点/还车点等POI类型,供供应商创建POI时选择。 | 平台运营 | 无 | P0 |
| 短信模板 | 平台统一维护的短信模板,至少覆盖已支付、已确认收单、已退款三个触发节点。 | 平台运营 | 无 | P0 |
| 第三方接口配置 | 第三方渠道地址、app_key、同步频率、重试策略等,用于库存/价格/订单/核销/退款同步。 | 平台运营 | 无 | P0 |
| 收单时效参数 | 手动收单/审核收单默认超时时间,如24小时。 | 平台运营 | 无 | P0 |
| 系统参数 | 库存预警默认值、审核超时时间、单次导入上限、购买区域定位失败策略等。 | 平台运营 | 无 | P0 |
16.2 模块依赖顺序
flowchart LR
A[基础功能与权限中心] --> B[商品供应链管理中心]
B --> C[分销中心]
B --> D[订单履约中心]
C --> D
D --> E[财务结算中心]
模块依赖顺序
- 基础功能与权限中心: 提供租户、用户、角色、权限、菜单、日志能力,商品中心依赖其完成租户隔离与鉴权。
- 商品供应链管理中心: 提供商品、价格、库存、素材数据,是分销中心和订单中心的数据基础。
- 分销中心: 在商品数据基础上维护授权、可见范围、佣金、限价,供分销商城使用。
- 订单履约中心: 调用商品中心SPU配置与库存,完成下单、核销、售后。
- 财务结算中心: 读取商品价格与佣金比例,完成结算与分账。
16.3 接口契约
16.3.1 商品中心对外提供接口
| 接口 | Method | 调用方 | 说明 |
| /api/product/spu/{spu_id} | GET | 订单中心、分销中心 | 查询SPU基础信息。 |
| /api/product/sku/{sku_id} | GET | 订单中心 | 查询SKU价格与规格。 |
| /api/spu/order-config/{spu_id} | GET | 订单中心、前端下单页 | 查询SPU下单与核销配置。 |
| /api/inventory/lock | POST | 订单中心 | 锁定库存。 |
| /api/inventory/release | POST | 订单中心 | 释放锁定库存。 |
| /api/inventory/confirm | POST | 订单中心 | 支付成功转移锁定到已售。 |
| /api/inventory/verify | POST | 订单中心 | 核销后扣减已售库存。 |
| /api/inventory/refund | POST | 订单中心 | 退款释放库存。 |
| /api/price/check-limit | POST | 分销中心、订单中心 | 校验售价是否超过限价。 |
| /api/price/snapshot | POST | 订单中心 | 生成价格快照。 |
16.3.2 商品中心依赖接口
| 接口 | 提供方 | 用途 |
| /api/auth/current-user | 权限中心 | 获取当前用户租户、角色、数据范围。 |
| /api/auth/permission/check | 权限中心 | 校验按钮/菜单权限。 |
| /api/distribution/authorization/list | 分销中心 | 查询商品授权状态。 |
| /api/order/order-status | 订单中心 | 查询商品关联订单状态,用于下架判断。 |
16.4 数据初始化顺序
- 初始化平台租户与管理员账号(权限中心)。
- 初始化商品分类树与属性模板。
- 初始化退改规则模板与系统参数。
- 创建供应商租户与账号(权限中心)。
- 供应商创建商品、价格、库存、素材。
- 平台运营审核商品上架。
- 分销中心配置授权、可见范围、限价、佣金。
- 订单中心调用商品接口完成交易闭环。
17验收标准
本章定义商品供应链管理中心的功能验收标准、性能标准、安全标准及交付物清单,作为开发完成后测试与验收的依据。
17.1 功能验收标准
| 功能模块 | 验收项 | 验收标准 | 优先级 |
| 商品分类、POI与短信模板 | 分类树CRUD | 支持三级分类新增/编辑/删除/排序/启用禁用,删除有子分类或SPU时禁止并提示。 | P0 |
| 分类属性模板 | 按分类+商品类型加载属性模板,必填属性缺失时阻止提交审核。 | P0 |
| 分类转移 | 支持批量转移SPU到新分类,商品类型不一致时阻止。 | P1 |
| POI管理 | 供应商可新建POI并提交审核,审核通过后才可在SPU中关联;关键字段变更需重新审核。 | P0 |
| 短信模板管理 | 平台统一维护短信模板,供应商在商品中选择;触发节点至少包含已支付、已确认收单、已退款。 | P0 |
| 商品信息管理 | 六种商品类型创建 | 门票/酒店/车辆/特色商品/组合套餐/线路产品均能完整创建SPU/SKU,字段与商品类型匹配,且必须正确关联POI。 | P0 |
| 销售规则配置 | 提前预订、下单时段、购买区域、自由销售/仅套餐可用、团队导游证/实名/行程单均可配置并在下单时生效。 | P0 |
| 核销规则配置 | 一单一码/一票一码/手动确认/无需核销可选;审核订单模式下支付后未确认收单不可核销。 | P0 |
| 短信模板选择 | 商品可绑定多个短信模板,订单状态变更时按触发节点自动发送。 | P0 |
| 第三方接口资源同步 | 第三方商品编码、库存同步、价格同步、订单对接、核销对接、退款对接机制在MVP阶段保留字段并写入同步机制。 | P0 |
| SPU配置驱动 | 修改t_spu_order_config后,下单页按配置动态渲染字段,已生成订单不受影响。 | P0 |
| 价格校验 | 市场价≥售价≥限价≥底价,专属价与底价之间不做强制大小约束,其他价格倒挂保存时拦截。 | P0 |
| 商品审核 | 供应商提交审核后平台运营可通过/驳回,驳回必填原因,通过后商品上架。 | P0 |
| 上下架 | 已上架商品在分销商城可见,下架/强制下架后不可见,已支付订单不受影响。 | P0 |
| 效期、收单与价格 | 退改规则模板 | 支持多时间段退款比例配置,退款金额按规则正确计算。 | P0 |
| 收单规则 | 自动收单/手动收单/审核收单按SPU配置生效;手动收单超时自动退款;驳回后原路退款。 | P0 |
| 购买区域限制 | GeoJSON区域在下单时按定位/IP校验,区域外用户无法下单,并给出明确提示。 | P0 |
| 效期规则 | 日历模式日期必须在效期内,过期商品自动下架。 | P0 |
| 全局限价 | 商品级/品类级/全局级限价生效,超限时下单拦截并留痕。 | P1 |
| 特色商品进销存 | 入库单 | 特色商品入库需审核,审核通过后库存增加;撤销需校验可用库存。 | P0 |
| 出库/盘点/调拨 | 销售出库、盘盈盘亏、仓库调拨均正确更新可用库存并记录日志。 | P0 |
| 超卖防护 | 并发场景下特色商品库存扣减准确,可用库存不足时返回库存不足,无超卖。 | P0 |
| 日历库存 | 日历库存维护 | 门票/酒店/车辆/线路产品按日期维护总库存、可用库存、锁定库存、已售库存。 | P0 |
| 库存扣减 | 提交订单锁定、支付转移、取消释放、退款未核销释放、已核销不释放均正确。 | P0 |
| 超卖防护 | 并发场景下日历库存扣减准确,可用库存不足时返回库存不足,无超卖。 | P0 |
| 内容素材 | 素材上传 | 支持图片/视频/海报/文案上传,格式/大小超限拦截,主图缺失阻止审核。 | P0 |
| 详情模板 | 支持富文本编辑与模板引用,违禁词/敏感图片检测拦截。 | P1 |
17.2 性能验收标准
| 指标 | 目标值 | 测试场景 |
| 商品列表查询 | P95 ≤ 500ms | 单供应商商品10000条,分页20条。 |
| 库存扣减接口 | P95 ≤ 200ms | Redis预扣+MySQL落库。 |
| 价格校验接口 | P95 ≤ 100ms | 单SPU多SKU价格校验。 |
| 商品详情加载 | P95 ≤ 800ms | 含富文本、图片、SKU、库存。 |
| 并发库存扣减 | 超卖率 = 0 | 1000并发同时抢购同一SKU。 |
17.3 安全与合规标准
| 维度 | 验收标准 |
| 租户隔离 | 供应商A无法查询/修改供应商B的商品、价格、库存数据。 |
| 权限控制 | 未授权菜单/按钮不可见或禁用,越权访问返回403。 |
| 操作审计 | 商品创建、编辑、审核、上下架、价格调整、库存变更均记录日志,含修改前后Diff。 |
| 敏感数据 | 底价等价格敏感字段按租户隔离,平台运营默认不可见(需单独授权)。 |
| 内容安全 | 商品详情与素材经过违禁词/敏感图检测,违规内容禁止保存。 |
17.4 交付物清单
| 交付物 | 形式 | 负责人 | 验收人 |
| 后端服务代码 | Git仓库 | 后端开发 | 技术负责人 |
| 前端页面代码 | Git仓库 | 前端开发 | 技术负责人 |
| 数据库脚本 | DDL + DML | 后端开发 | DBA/架构师 |
| 接口文档 | Swagger/YApi | 后端开发 | 测试/前端 |
| 测试用例 | 测试平台 | 测试工程师 | 产品经理 |
| 操作手册 | Markdown/PDF | 产品经理 | 业务运营 |
| 验收报告 | 文档 | 测试工程师 | 项目经理 |
17.5 缺陷等级定义
| 等级 | 定义 | 验收要求 |
| P0 致命 | 导致系统崩溃、数据丢失、资金风险、核心流程无法闭环。 | 必须为零,发现即阻塞上线。 |
| P1 严重 | 核心功能异常但可绕过,性能明显低于标准,影响用户体验。 | 上线前修复率100%。 |
| P2 一般 | 非核心功能异常,UI/文案问题。 | 上线前修复率≥90%。 |
| P3 轻微 | 建议优化项,不影响使用。 | 可排入迭代计划。 |
17.6 上线前Checklist
- [ ] 所有P0功能通过测试用例。
- [ ] 五层价格体系校验在所有商品类型下验证通过。
- [ ] 库存超卖防护通过并发压测。
- [ ] 租户隔离与权限控制通过安全测试。
- [ ] 商品审核流程端到端验证通过。
- [ ] POI新建、审核、SPU关联流程验证通过。
- [ ] 短信模板配置与触发节点(已支付/已确认收单/已退款)验证通过。
- [ ] 销售规则(提前预订、下单时段、购买区域、仅套餐可用)与核销规则(一单一码/一票一码/审核订单)验证通过。
- [ ] 自动收单/手动收单/审核收单及超时退款流程验证通过。
- [ ] 第三方资源同步字段与同步任务机制验证通过。
- [ ] 与分销中心、订单履约中心的接口联调通过。
- [ ] 初始化数据(分类、退改模板、系统参数、POI类型、短信模板、第三方配置)已部署。
- [ ] 操作日志与审计功能已启用。