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

PC端商品供应链管理中心 - 产品需求文档 PRD v2.0

版本:v2.0 日期:2026-07-08 状态:初稿 密级:内部

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供应商/平台运营对商品进行分类、创建、定价、库存、素材、上下架、审核的系统模块。
标准化产品单元SPUStandard Product Unit,商品标准单元,描述商品共性(名称、类目、图片、基础属性)。
库存量单位SKUStock 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 Inventorytotal_stock = locked_stock + sold_stock + available_stock 的动态库存模型。
共享库存Shared Stock多个SKU/渠道共用同一库存池。
独立控位Dedicated Stock某个SKU/渠道独占固定库存。
核销Verification用户到店/入住/用车后,商家或系统确认订单履约完成。
使用前审核Pre-use Audit与手动收单等价,支付成功后需供应商在后台确认收单(审核通过)才生成核销码或确认履约,不单独设置待审核状态。
退改规则Cancel Policy商品在不同时间点申请退款时扣除的手续费规则;核销前退款按此规则计算退款金额。

1.5 版本记录

版本日期修订人修订内容
v1.02026-07-08产品经理完成第1-10章初稿。
v2.02026-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 设计原则

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与短信模板分类树维护(新增/编辑/删除/排序/启用禁用)P011.1无
分类属性模板配置P011.2分类树
分类与商品类型绑定P011.3分类树、商品类型
线路主题与线路归类P011.4无
分类删除限制与转移P111.5商品表
POI管理(新建/审核/编辑/禁用)P011.7无
短信模板管理P011.8无
商品信息管理六种商品类型字段表单(含POI关联)P012.1-12.8分类树、POI
SKU规格与价格通用规则P012.9SPU
SPU配置驱动(下单字段与核销规则)P012.10SPU
商品上下架与状态机P012.11审核流程
商品审核流程P012.12SPU、角色权限
商品复制/批量导入/批量导出P112.13SPU/SKU
销售规则配置P012.14SPU
核销规则配置P012.15SPU
短信模板选择P012.16短信模板
第三方接口资源同步机制P012.17SPU
效期、收单与价格管理退改规则模板管理P013.1无
收单规则管理(自动/手动/审核收单)P013.2SPU配置
购买区域限制规则P013.3SPU配置
效期规则管理(固定/动态/指定日期)P013.4SPU
五层价格体系配置P013.5SKU
底价/专属价/佣金比例P013.6分销中心
全局限价规则P113.7分销中心
特色商品进销存管理入库单管理(采购/退货/盘盈/调拨入库)P014.2SKU
出库单管理(销售/盘亏/调拨出库)P014.3入库单
库存盘点与调拨P114.4-14.5入库单
库存预警与日志P114.6/14.8入库单
内容素材管理规格模板与商品详情编辑P015.1SPU
海报/图片/视频/文案素材库P115.2SPU
分销素材工坊P215.3素材库
系统初始化初始化数据清单P016.1权限中心
依赖顺序与接口契约P016.2所有模块
验收标准功能验收与质量门禁P017全量功能

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说明
分类 Category1:NSPU一个分类下可有多个SPU,SPU必须归属末级分类。
SPU1:NSKU一个SPU下可有多个SKU,SKU是实际售卖单元。
SPU1:1SPU Order Config每个SPU对应一份下单/核销配置。
POI1:NSPU一个POI可被多个SPU引用,门票/酒店/车辆/线路产品必须关联已审核POI。
SPUN:MSMS Template一个SPU可选择多个短信模板,覆盖已支付/已确认收单/已退款等节点。
SKU1:NCalendar Inventory日历模式商品(门票/酒店/车辆/线路产品),每个SKU按日期有多条库存记录。
特色商品SKU1:NInbound Order仅特色商品SKU存在入库记录,通过入库单增加库存。
SKU1:1Price Config每个SKU对应一份价格配置(含日历价或统一价)。
SPUN:1Cancel Policy Template多个SPU可引用同一退改规则模板。
SPU1:NMaterial一个SPU可关联多张图片/海报/视频/文案。

6.5 技术关键点

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 状态流转规则

8.1.2 状态变更约束

禁止: 不允许从「已上架/库存预警/售罄」直接回到「草稿」;不允许删除「已上架/待审核/库存预警/售罄」商品,必须先下架/驳回。

8.2 五层价格体系

商品价格必须满足如下层级约束,任一关系不成立则前端红框提示并阻止保存。

市场价 ≥ 实际售价;实际售价 ≤ 平台限价;平台限价 ≥ 底价。专属价由供应商针对特定分销商独立设置,与底价之间不做强制大小约束。
价格类型定义维护角色使用场景
市场价对外展示划线价,仅作参考。供应商C端/B端展示原价对比。
实际售价分销商/C端实际销售价格。分销商/平台前台下单价。
平台限价平台设置的最高售价,防止乱价。平台运营分销商下单销售时校验。
底价供应商与平台/分销商结算底价,B端采购价。供应商B端分销商采购、财务结算。
专属价供应商对特定B端分销商的独立采购价。供应商有专属协议的分销商采购。

8.2.1 价格合法性校验

8.3 库存公式

总库存 total_stock = 可用库存 available_stock + 锁定库存 locked_stock + 已售库存 sold_stock
库存类型说明触发场景
available_stock当前可售库存。入库增加、支付超时释放、售后退款未核销释放。
locked_stock已下单未支付库存。提交订单锁定、支付成功转移、取消/超时释放。
sold_stock已支付未核销/未履约库存。支付成功增加、核销后不变、退款未核销减少。

8.4 数据隔离规则

8.5 编码规则

对象编码规则示例唯一性
SPU编码SPU + 8位日期 + 6位随机字母数字SPU20260708A3B7C9全局唯一
SKU编码SKU + SPU编码后6位 + 3位序号SKU7B7C9001SPU内唯一
入库单号IN + 8位日期 + 6位流水IN20260708000001全局唯一
分类编码CAT + 3位层级 + 4位序号CAT0010001全局唯一

8.6 SPU配置驱动规则

每个SPU通过 t_spu_order_config 表控制下单页渲染与核销规则。该表与订单履约PRD保持一致,字段定义见第10章。

8.6.1 配置字段与下单页组件映射

配置字段取值下单页表现
is_show_buy_notice1展示购买须知折叠面板,需勾选同意。
enable_sku1渲染SKU规格选择器;0则直接数量输入。
inventory_typecalendar按日期维护库存与价格,下单需选择日期。
inventory_typetotal_inventory不指定具体日期,维护总库存与统一价。
is_time_slot_enabled1在日历或总库存模式下再按上午/下午/晚上等时段拆分库存。
advance_book_daysN今日+N天前日期不可选。
advance_book_timeHH:MM游玩当日截止下单时间,超过后该日期不可选。
cutoff_timeHH:MM每日截止下单时间,超过后当日不可订。
order_time_start / order_time_endHH:MM每日允许下单的开始与结束时间,不在时段内禁止提交订单。
sale_region_limit_enabled1校验用户定位或IP是否在sale_region_geo多边形内,不在区域内禁止下单。
enable_real_name1按数量渲染实名信息录入行。
require_certificate1每个使用人上传证件图片。
certificate_typeteacher/student/...展示对应证件名称。
require_guide_info1展示导游姓名/证号/手机输入区。
require_itinerary1展示行程单上传入口。
group_guide_certificate_required1团队订单要求上传导游证图片。
group_guide_real_name_required1团队订单要求填写导游姓名、证号、手机。
group_itinerary_required1团队订单要求上传行程单。
verify_before_use1与 manual_accept_order 等价,支付后需供应商确认收单(审核通过)才生成核销码,不单独设置待审核状态。
verification_typeone_order_one_code一个订单生成一个统一核销码,适用于团队或通兑。
verification_typeone_ticket_one_code每份/每人生成独立核销码,支持逐张核销。
verification_typemanual_confirm无需核销码,由供应商在后台确认履约。
verification_typenone无需核销,物流或系统自动完成。
allow_partial_use1支持分次核销。
package_only1商品不在C端/B端商城单独展示,仅可被组合套餐引用。
stock_modeshared / independent共享库存池时所有SKU共用库存,独立控位时各SKU分别扣减。
auto_accept_order1支付成功后订单自动收单,进入待核销/履约。
manual_accept_order1支付成功后订单进入待供应商审核收单,审核通过才算正式收单。

8.6.2 商品类型默认配置

商品类型is_show_buy_noticeenable_skuinventory_typeis_time_slot_enabledenable_real_namerequire_certificaterequire_guide_inforequire_itineraryverify_before_useverification_typepackage_onlystock_modeauto_accept_ordermanual_accept_order
门票11calendar0/110/10/10/10/1one_ticket_one_code0shared/independent10
酒店11calendar0000/10/10/1manual_confirm0independent01
车辆11calendar0100/110/1manual_confirm0independent01
特色商品11total_inventory000000none0independent10
组合套餐11按子项0/10/100/10/10/1按组成商品0按子项0/10/1
线路产品11calendar0100/100/1manual_confirm0independent01
说明: 上表为系统建议默认值,供应商可在配置页面按实际业务调整。其中特色商品默认无核销(物流签收),车辆默认由供应商手动确认还车完成履约。

9全局页面流转说明

本章描述商品供应链管理中心核心页面之间的跳转关系、入口条件及返回行为。

9.1 页面流转总表

序号起始页面触发操作目标页面前置条件返回行为
1商品列表点击「新增商品」选择商品类型拥有商品创建权限返回商品列表
2选择商品类型选择门票/酒店/车辆/特色商品/组合套餐/线路产品SPU基础信息编辑已维护商品分类与POI返回选择商品类型
3SPU基础信息编辑点击「下一步」票型与规格基础信息校验通过返回上一步
4票型与规格点击「下一步」库存与价格SKU规格校验通过返回上一步
5库存与价格点击「下一步」销售规则配置价格/库存校验通过返回上一步
6销售规则配置点击「下一步」核销规则配置销售规则校验通过返回上一步
7核销规则配置点击「下一步」退改规则配置核销规则校验通过返回上一步
8退改规则配置点击「下一步」渠道与短信配置退改规则校验通过返回上一步
9渠道与短信配置点击「下一步」预览提交短信/渠道配置完成返回上一步
10预览提交点击「提交审核」商品列表全量校验通过返回商品列表
11预览提交点击「保存草稿」商品列表无返回商品列表
12商品列表点击「编辑」SPU基础信息编辑商品状态为草稿/已下架/审核驳回返回商品列表
13商品列表点击「提交审核」商品列表商品状态为草稿/审核驳回无
14商品审核列表点击「审核」商品审核详情平台运营有审核权限返回审核列表
15商品审核详情点击「通过/驳回」商品审核列表已填写审核意见返回审核列表
16商品列表点击「库存管理」库存详情页商品存在SKU返回商品列表
17商品列表点击「价格管理」价格日历/统一价页商品存在SKU返回商品列表
18商品列表点击「素材管理」素材库页商品已创建返回商品列表

9.2 页面布局通用规则

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

字段名类型约束说明
idbigintPK AUTO_INCREMENT分类ID
tenant_typevarchar(20)NOT NULLPLATFORM/SUPPLIER
tenant_idbigintNOT NULL租户ID,平台分类填0
category_codevarchar(32)NOT NULL UNIQUE分类编码
category_namevarchar(100)NOT NULL分类名称
parent_idbigintNOT NULL DEFAULT 0父分类ID,0为根
leveltinyintNOT NULL层级 1/2/3
tree_pathvarchar(500)NOT NULL层级路径,如 0,1,5
sort_orderintDEFAULT 0同层排序
product_typevarchar(20)NULL关联商品类型
statustinyintDEFAULT 10禁用 1启用
is_deletedtinyintDEFAULT 0逻辑删除
create_time / update_timedatetimeNOT NULL创建/更新时间

10.3 POI 表 t_scenic_poi

POI 用于维护景区、场馆、酒店、取还车点等物理场所信息。供应商可创建 POI 并提交平台审核,审核通过后可在 SPU 中关联使用。

字段名类型约束说明
poi_idbigintPK AUTO_INCREMENTPOI ID
tenant_typevarchar(20)NOT NULLPLATFORM/SUPPLIER
tenant_idbigintNOT NULL租户ID,平台创建填0
poi_codevarchar(32)NOT NULL UNIQUEPOI编码
poi_namevarchar(100)NOT NULLPOI名称,如景区/酒店名
poi_typevarchar(20)NOT NULL景区/场馆/演出厅/酒店/取车点/还车点
provincevarchar(50)NULL省
cityvarchar(50)NULL市
districtvarchar(50)NULL区/县
addressvarchar(255)NULL详细地址
longitudedecimal(10,7)NULL经度
latitudedecimal(10,7)NULL纬度
business_hoursvarchar(100)NULL营业时间,如 08:00-18:00
entry_addressvarchar(255)NULL入园/入店/上车地址
preferential_policytextNULL优待政策说明
contact_phonevarchar(50)NULL联系电话
imagesjsonNULLPOI图片URL数组
statustinyintDEFAULT 10禁用 1启用
audit_statusvarchar(20)DEFAULT 'draft'draft/pending_audit/approved/rejected
audit_reasonvarchar(500)NULL审核驳回原因
is_deletedtinyintDEFAULT 0逻辑删除
create_time / update_timedatetimeNOT NULL创建/更新时间

10.3.1 POI 状态机

状态说明允许操作
draft供应商创建中,未提交审核。编辑、删除、提交审核
pending_audit已提交平台审核。平台审核通过/驳回
approved审核通过,可关联 SPU。编辑(触发重新审核)、禁用
rejected审核驳回。编辑、重新提交、删除

10.4 线路主题字典表 t_route_theme

字段名类型约束说明
theme_idbigintPK AUTO_INCREMENT主题ID
theme_namevarchar(50)NOT NULL主题名称,如亲子、蜜月
theme_codevarchar(32)NOT NULL UNIQUE主题编码
sort_orderintDEFAULT 0排序
statustinyintDEFAULT 10禁用 1启用
create_time / update_timedatetimeNOT NULL创建/更新时间

10.5 线路节点字典表 t_route_node

字段名类型约束说明
node_idbigintPK AUTO_INCREMENT节点ID
node_namevarchar(100)NOT NULL节点名称,如黄果树、小七孔
node_codevarchar(32)NOT NULL UNIQUE节点编码
node_typevarchar(20)NOT NULL景点/城市/商圈
parent_idbigintDEFAULT 0父节点ID
sort_orderintDEFAULT 0排序
statustinyintDEFAULT 10禁用 1启用
create_time / update_timedatetimeNOT NULL创建/更新时间

10.6 商品SPU表 t_product_spu

字段名类型约束说明
spu_idbigintPK AUTO_INCREMENTSPU主键
spu_codevarchar(64)NOT NULL UNIQUESPU编码
tenant_typevarchar(20)NOT NULL固定SUPPLIER
tenant_idbigintNOT NULL供应商租户ID
supplier_idbigintNOT NULL供应商ID,与tenant_id一致
category_idbigintNOT NULL末级分类ID
product_typevarchar(20)NOT NULLticket/hotel/vehicle/specialty/package/route
spu_namevarchar(200)NOT NULL商品名称
sub_titlevarchar(500)NULL副标题
main_imagevarchar(500)NOT NULL主图URL
image_listjsonNULL轮播图数组
detail_contentlongtextNULL商品详情富文本
buy_noticetextNULL购买须知
attr_valuesjsonNULL分类属性模板值,见11.2
route_themesjsonNULL线路主题ID数组,线路产品必填
route_nodesjsonNULL线路节点ID数组(按顺序),线路产品必填
package_compositionjsonNULL套餐组成,组合套餐必填
cancel_policy_idbigintNULL退改规则模板ID
poi_idbigintNULL关联POI ID,门票/酒店/车辆/线路产品必填
is_points_producttinyintDEFAULT 0是否积分商品
is_searchabletinyintDEFAULT 1是否允许被搜索
is_third_partytinyintDEFAULT 0是否第三方接口资源
third_party_codevarchar(100)NULL第三方产品编码
third_party_supplier_codevarchar(100)NULL第三方供应商/渠道编码
sale_modevarchar(20)DEFAULT 'free_sale'free_sale自由销售 / package_only仅套餐可用
sms_template_idsjsonNULL关联短信模板ID数组
sale_channelsjsonNULL默认销售渠道配置,如 {"all":true} 或 {"b2b":{"levels":["S","A"],"distributor_ids":[1,2]},"c2c":true,"ota":false}
salesperson_visibilityvarchar(20)DEFAULT 'invisible'分销员可见范围:public公共分销 / exclusive专属分销 / invisible分销员不可见
statusvarchar(20)DEFAULT 'draft'draft/pending_audit/approved/stock_warning/sold_out/rejected/offline
audit_remarkvarchar(500)NULL审核驳回原因
on_sale_timedatetimeNULL实际上架时间
off_sale_timedatetimeNULL实际下架时间
is_deletedtinyintDEFAULT 0逻辑删除
versionintDEFAULT 0乐观锁版本号
creator_id / updater_idbigintNOT NULL创建/更新人
create_time / update_timedatetimeNOT NULL创建/更新时间

10.7 商品SKU表 t_product_sku

字段名类型约束说明
sku_idbigintPK AUTO_INCREMENTSKU主键
sku_codevarchar(64)NOT NULL UNIQUESKU编码
spu_idbigintNOT NULL FK所属SPU
tenant_typevarchar(20)NOT NULLSUPPLIER
tenant_idbigintNOT NULL供应商租户ID
sku_namevarchar(200)NOT NULLSKU名称,如成人票/双床房
sku_descvarchar(500)NULLSKU描述,如适用于18-59周岁成人
sku_specsjsonNULL规格属性,如 {"人群":"成人","场次":"上午"}
age_minintNULL最低适用年龄,空表示不限
age_maxintNULL最高适用年龄,空表示不限
audience_tagsjsonNULL适用人群标签,如 ["成人","学生"]
real_name_requiredtinyintDEFAULT 0该SKU是否要求实名
real_name_typesjsonNULL实名证件类型数组,如 ["身份证","护照"]
source_region_limitjsonNULL客源地限制,省份/城市编码数组
special_certificate_requiredtinyintDEFAULT 0是否要求上传特殊证件
special_certificate_typevarchar(50)NULL特殊证件类型,如教师证/学生证
purchase_limitintDEFAULT 0每人限购数量,0表示不限
warning_stockintDEFAULT 0库存预警阈值,0表示不预警
market_pricedecimal(12,2)NOT NULL市场价
sale_pricedecimal(12,2)NOT NULL实际售价
limit_pricedecimal(12,2)NULL平台限价
base_pricedecimal(12,2)NOT NULL底价
weightdecimal(8,3)DEFAULT 0重量kg,普通商品物流用
statusvarchar(20)DEFAULT 'enabled'enabled/disabled
sort_orderintDEFAULT 0排序
is_deletedtinyintDEFAULT 0逻辑删除
create_time / update_timedatetimeNOT NULL创建/更新时间

10.8 SPU下单配置表 t_spu_order_config

本表与订单履约PRD保持一致,一个SPU对应一条配置,控制下单页渲染与核销规则。

字段名类型约束说明
config_idbigintPK AUTO_INCREMENT配置ID
spu_idbigintNOT NULL UNIQUESPU主键
is_show_buy_noticetinyintDEFAULT 1是否展示购买须知
enable_skutinyintDEFAULT 1是否需要选择SKU
inventory_typevarchar(20)DEFAULT 'calendar'库存类型:calendar日历库存 / total_inventory总库存
is_time_slot_enabledtinyintDEFAULT 0是否启用时段库存,0=不分时段,1=按时段拆分
advance_book_daysintDEFAULT 0提前预定天数
advance_book_timevarchar(10)DEFAULT '00:00'提前预定截止时间,如18:00表示游玩当日18:00前可订
cutoff_timevarchar(10)DEFAULT '00:00'每日截止下单时间
order_time_startvarchar(10)NULL每日允许下单开始时间,如 09:00
order_time_endvarchar(10)NULL每日允许下单结束时间,如 22:00
sale_region_limit_enabledtinyintDEFAULT 0是否启用购买区域限制
sale_region_geojsonNULL购买区域多边形 GeoJSON
group_guide_certificate_requiredtinyintDEFAULT 0团队订单是否要求上传导游证
group_guide_real_name_requiredtinyintDEFAULT 0团队订单是否要求导游实名信息
group_itinerary_requiredtinyintDEFAULT 0团队订单是否要求上传行程单
package_onlytinyintDEFAULT 0是否仅允许组合套餐引用
stock_modevarchar(20)DEFAULT 'independent'shared共享库存池 / independent独立控位
stock_warning_notify_modevarchar(100)DEFAULT 'platform_message'库存预警通知方式,多个以逗号分隔:platform_message/sms/email
enable_real_nametinyintDEFAULT 0是否实名制
require_certificatetinyintDEFAULT 0是否上传证件
certificate_typevarchar(50)NULL证件类型标签
require_guide_infotinyintDEFAULT 0是否填写导游信息
require_itinerarytinyintDEFAULT 0是否上传行程单
verify_before_usetinyintDEFAULT 0使用前是否需审核
verification_typevarchar(20)DEFAULT 'one_ticket_one_code'核销方式:one_order_one_code一单一码 / one_ticket_one_code一票一码 / manual_confirm手动确认 / none无需核销
allow_partial_usetinyintDEFAULT 1是否支持部分核销
auto_accept_ordertinyintDEFAULT 1是否自动收单
manual_accept_ordertinyintDEFAULT 0是否允许手动收单
create_time / update_timedatetimeNOT NULL创建/更新时间

10.9 日历库存表 t_calendar_inventory

字段名类型约束说明
inventory_idbigintPK AUTO_INCREMENT库存记录ID
sku_idbigintNOT NULL FKSKU ID
spec_datedateNOT NULL日期
total_stockintDEFAULT 0总库存
available_stockintDEFAULT 0可用库存
locked_stockintDEFAULT 0锁定库存
sold_stockintDEFAULT 0已售库存
warning_stockintDEFAULT 0预警阈值
sale_pricedecimal(12,2)NULL该日售价,为空取SKU默认
base_pricedecimal(12,2)NULL该日底价,为空取SKU默认
versionintDEFAULT 0乐观锁版本号
create_time / update_timedatetimeNOT NULL创建/更新时间

10.10 退改规则模板表 t_cancel_policy_template

字段名类型约束说明
template_idbigintPK AUTO_INCREMENT模板ID
tenant_typevarchar(20)NOT NULLPLATFORM/SUPPLIER
tenant_idbigintNOT NULL租户ID
template_namevarchar(100)NOT NULL模板名称
policy_jsonjsonNOT NULL退改规则JSON,见13.1
is_defaulttinyintDEFAULT 0是否为默认模板
statustinyintDEFAULT 10禁用 1启用
create_time / update_timedatetimeNOT NULL创建/更新时间

10.11 短信模板表 t_sms_template

短信模板由平台运营统一维护,供应商在创建商品时选择需要触发的模板。

字段名类型约束说明
template_idbigintPK AUTO_INCREMENT模板ID
tenant_typevarchar(20)NOT NULL固定 PLATFORM
tenant_idbigintNOT NULL DEFAULT 0平台租户ID
template_codevarchar(32)NOT NULL UNIQUE模板编码
template_namevarchar(100)NOT NULL模板名称
template_contentvarchar(500)NOT NULL模板内容,支持变量如 {orderNo} {productName}
scenevarchar(50)NOT NULL触发场景:paid已支付 / confirmed已确认收单 / refunded已退款 / custom自定义
statustinyintDEFAULT 10禁用 1启用
create_time / update_timedatetimeNOT 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_idbigintPK AUTO_INCREMENT敏感词ID
tenant_typevarchar(20)NOT NULLPLATFORM / SUPPLIER
tenant_idbigintNOT NULL租户ID,平台级填0
wordvarchar(200)NOT NULL敏感词内容
word_typevarchar(50)DEFAULT 'sensitive'sensitive敏感/forbidden违禁/political政治/ads广告法
sourcevarchar(20)DEFAULT 'manual'manual手动添加 / ai AI自动发现
statustinyintDEFAULT 11启用 0禁用
create_time / update_timedatetimeNOT NULL创建/更新时间

10.15 AI 审核记录表 t_ai_audit_record

字段名类型约束说明
record_idbigintPK AUTO_INCREMENT记录ID
biz_typevarchar(50)NOT NULLspu/sku/material
biz_idbigintNOT NULL业务对象ID
audit_typevarchar(20)NOT NULLtext文本 / image图片
content_snapshottextNULL文本快照或图片URL
ai_resultvarchar(20)NOT NULLpass通过 / suspect疑似 / reject拒绝
ai_scoredecimal(5,2)NULL置信度分数
ai_reasonvarchar(500)NULLAI判定原因
ai_modelvarchar(100)NULL模型/服务版本
manual_resultvarchar(20)NULL人工复审结果
manual_reasonvarchar(500)NULL人工复审原因
create_time / update_timedatetimeNOT NULL创建/更新时间

10.16 库存预警记录表 t_stock_warning_record

字段名类型约束说明
record_idbigintPK AUTO_INCREMENT记录ID
sku_idbigintNOT NULL FKSKU ID
spec_datedateNULL日历库存日期,总库存场景为空
warning_stockintDEFAULT 0触发时的预警阈值
available_stockintDEFAULT 0触发时的可用库存
notify_modevarchar(100)NULL实际发送的通知方式
statusvarchar(20)DEFAULT 'sent'sent已发送 / resolved已解除
create_time / update_timedatetimeNOT NULL创建/更新时间

10.17 AI 生成记录表 t_ai_generation_record

字段名类型约束说明
record_idbigintPK AUTO_INCREMENT记录ID
biz_typevarchar(50)NOT NULLspu/sku
biz_idbigintNOT NULL业务对象ID
field_typevarchar(50)NOT NULLmain_image/ carousel/ selling_point/ detail_content
prompttextNULL用户输入的提示词或参考内容
candidatesjsonNULLAI返回的候选结果
apply_statusvarchar(20)DEFAULT 'pending'pending待应用 / applied已应用 / discarded已放弃
creator_idbigintNOT NULL操作人ID
create_time / update_timedatetimeNOT NULL创建/更新时间

10.18 调价记录表 t_price_change_record

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

11商品分类、POI 与短信模板管理

本章定义商品分类管理体系、POI 管理、短信模板管理,以及分类属性模板、线路主题与线路节点字典。供应商创建的 POI 需提交平台审核,审核通过后才可在 SPU 中关联使用;短信模板由平台运营统一维护,供应商在创建商品时选择。

11.1 分类树维护

11.1.1 业务规则

11.1.2 新增分类

字段规则前端表现
分类名称必填,2-20字符,同父下不可重复。输入框,重复时红框提示。
父分类一级分类父ID为0;二级/三级需选择上级。一级分类只能从预设四项中选择。级联选择器,仅展示启用中的上级。
层级根据父分类自动计算,最大3级。只读展示。
排序整数,默认0,同层按升序排列。数字输入框。
关联商品类型三级分类可选,决定该分类下SPU默认商品类型。下拉选择:门票/酒店/车辆/特色商品/组合套餐/线路产品。
状态默认启用。开关组件。

11.1.3 编辑分类

11.1.4 删除分类

删除限制: 存在以下任一情况时禁止删除:1)该分类存在子分类;2)该分类下存在SPU(含已删除SPU);3)该分类被平台默认模板或活动规则引用。

11.2 分类属性模板(平台运营自定义)

11.2.1 业务规则

平台运营可针对二三级分类配置属性模板,用于规范该分类下SPU/SKU的扩展属性,解决不同供应商填报字段不一致的问题。

11.2.2 属性模板配置入口

11.2.3 属性模板示例

分类属性名类型必填说明
门票-景区门票景区名称文本是景区/场馆全称。
门票-景区门票入园方式单选是刷身份证/二维码/纸质票。
门票-景区门票是否需要预约布尔是控制是否进入待预约流程。
酒店-度假酒店酒店星级单选是一星至五星/民宿。
酒店-度假酒店入住时间文本是如 14:00。
车辆-日游包车车型单选是5座/7座/12座等。
车辆-日游包车服务时长数字是单位小时。
特色商品-特产产地文本否商品产地。
线路产品-跟团游行程天数数字是行程总天数。
线路产品-跟团游出发地文本是集合出发城市。
线路产品-跟团游主题多选标签否亲子/蜜月/摄影/徒步等。

11.2.4 属性模板生效规则

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 批量转移

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 页面原型示意

▼📁门票
▼📁景区门票
📄5A景区
📄4A景区
▼📁演艺票
▼📁酒店
📄度假酒店
📄民宿客栈
▼📁车辆
▼📁特色商品
▼📁组合套餐
▼📁线路产品
分类详情
分类名称景区门票
父分类门票
层级三级
商品类型门票
排序1
状态启用

11.7 POI 管理

11.7.1 业务规则

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
未审核通过关联 SPUPOI 下拉框中隐藏保存 SPU 时校验 poi.audit_status
删除已关联 SPU 的 POI弹窗提示「该POI已被N个商品引用,不可删除」400 + POI_HAS_PRODUCT

11.8 短信模板管理

11.8.1 业务规则

11.8.2 短信触发场景

场景编码场景名称触发时机MVP是否支持
paid已支付用户支付成功后是
confirmed已确认收单订单自动收单或供应商手动确认收单后是
refunded已退款退款完成后是
custom自定义预留,后续支持按业务事件自定义触发否

11.8.3 模板字段表单

字段类型必填说明
模板编码输入框是全局唯一,如 TICKET_PAID_SMS
模板名称输入框是如门票支付成功通知
触发场景下拉单选是paid/confirmed/refunded/custom
模板内容文本域是短信正文,限制500字符,支持变量
状态开关是启用/禁用

11.8.4 页面功能

功能操作人说明
新增模板平台运营填写编码、名称、场景、内容后保存
编辑模板平台运营修改后即时生效,已选商品下次发送使用新内容
禁用模板平台运营禁用后供应商不可选择,已选商品继续发送
预览效果平台运营输入测试变量后渲染短信内容

12商品信息管理

本章是商品供应链管理中心的核心章节,覆盖SPU基础信息、六种涉旅商品类型(门票/酒店/车辆/特色商品/组合套餐/线路产品)的字段表单、SKU管理、SPU配置驱动、上下架、审核及批量操作。

12.1 创建商品入口

12.2 通用基础信息字段

以下字段为所有商品类型共有,不同商品类型的扩展字段见12.3-12.8。

字段是否必填规则前端组件
商品名称是2-100字符,同供应商内不可重复。文本输入框
副标题否0-200字符。文本输入框
商品分类是必须选择末级分类,且分类商品类型与所选类型一致。级联选择器
关联 POI条件必填门票/酒店/车辆/线路产品必须选择已审核通过的 POI。POI 搜索选择器
商品主图是1张,JPG/PNG,≤5MB,建议800x800;支持本地上传或AI生成。图片上传 + AI生成按钮
商品轮播图是3-9张;支持本地上传或AI生成。多图上传 + AI生成按钮
商品卖点否每点≤30字符,最多5条;支持手动输入或AI生成。标签输入 + AI生成按钮
商品详情否≤20000字符,支持富文本,可插入图片与链接;支持手动编辑或AI生成。富文本编辑器 + AI生成按钮
购买须知是≤5000字符,支持富文本。富文本编辑器
是否允许搜索是关闭后商品不在商城搜索/列表中展示,仅可通过授权链接或组合套餐访问。开关
是否积分商品是积分商品使用积分抵扣或全额兑换,受积分中心规则约束。开关
是否第三方接口资源是开启后需填写第三方产品编码与供应商编码,库存/价格/核销走同步机制。开关
第三方产品编码条件必填第三方系统唯一商品编码。文本输入框
第三方供应商编码条件必填第三方渠道/供应商编码。文本输入框
销售模式是free_sale自由销售 / package_only仅套餐可用。单选
退改规则模板是选择已启用的退改模板。下拉选择 + 预览
生效时间否商品可售开始/结束时间,为空则长期有效。日期时间选择器

12.2.1 销售渠道与分销员可见性

以下配置保存在 SPU 上,作为商品的默认销售范围。未配置时,默认对全部渠道可见。

字段是否必填规则前端组件
销售渠道否默认全部渠道;可选 B端 / C端渠道 / OTA分销商,可多选。B端维度取值:全渠道、指定分组、指定分销商;选择 B端后,可再选全部B端等级或 S/A/B/C 等级,也可指定单个/多个分销商。多选 + 级联选择 + 搜索添加
分销员可见范围否默认分销员不可见;可选公共分销(所有分销员可推广)/ 专属分销(仅建立专属关系的分销员可推广)/ 分销员不可见。单选

12.2.2 生效规则

12.3 门票字段表单

12.3.1 POI 关联说明

门票 SPU 必须关联已审核通过的景区/场馆 POI。POI 中的景区地址、营业时间、入园地址、优待政策等信息会自动带入商品详情,供应商无需重复填写。

12.3.2 SPU 商品级字段

字段类型必填说明
关联 POI选择器是选择已审核通过的景区/场馆 POI。
商品名称文本是2-100字符,建议包含景区名+票型。
票型优惠说明富文本否如早鸟票、双人票等优惠规则说明。
入园方式多选是刷身份证/二维码/纸质票/人脸识别。
是否需要预约布尔是控制支付后是否进入待预约。
有效期类型单选是固定日期区间 / 购买后 N 天内有效。
生效时间日期否商品可售开始/结束时间。

12.3.3 SKU 规格字段

字段类型必填说明
SKU名称文本是如成人票、儿童票、学生票。
SKU描述文本否如适用于18-59周岁成人。
适用人群多选是成人/儿童/学生/老人/军人/教师等。
年龄限制数字区间否最低/最高适用年龄,空表示不限。
是否实名布尔是该票型是否要求使用人实名。
实名证件类型多选条件必填实名开启时可多选:身份证/护照/港澳通行证/台湾通行证/外国人永久居留证/其他。
客源地限制多选否限制可购买的省份/城市,空表示不限。
是否需要特殊证件布尔否优惠票是否需要上传特殊证件。
特殊证件类型多选条件必填教师证/学生证/军官证/残疾证等。
每人限购数字否0表示不限购。
排序数字是同SPU下票型展示顺序。
市场价金额是划线价。
状态开关是启用/禁用。

12.3.4 库存与价格模式

门票的库存与价格模式不再固定,由供应商在创建商品时选择以下三个维度:

维度可选项说明
库存类型日历库存 / 总库存日历库存按日期设置价格与库存;总库存不指定具体日期,维护统一价与总库存。
是否时段是 / 否开启后可在日历或总库存下再按上午场/下午场/晚上场等时段拆分库存。
库存池共享库存池 / 独立控位共享库存池时所有票型共用库存;独立控位时各票型分别扣减。

12.3.5 价格与库存设置

12.3.6 推荐默认配置

12.4 酒店字段表单

12.4.1 POI 关联说明

酒店 SPU 必须关联已审核通过的酒店/民宿 POI。POI 中的地址、联系方式、入住/退房时间等信息自动带入商品详情。

12.4.2 SPU扩展字段

字段类型必填说明
关联 POI选择器是选择已审核通过的酒店/民宿 POI。
商品名称文本是如贵阳某酒店标准大床房。
酒店星级单选否一星至五星/民宿/经济型。
房型设施多选否WiFi/早餐/停车/泳池等。
儿童政策富文本否加床、婴儿床政策说明。
退改说明富文本是入住前取消规则。

12.4.2 SKU规格字段

字段类型必填说明
SKU名称文本是如大床房、双床房、套房。
床型单选是大床/双床/多床。
面积数字否房间面积(平方米)。
可住人数数字是最大入住人数。
是否含早单选否含早/不含早/双早。

12.4.3 库存与价格模式

酒店的库存与价格模式由供应商选择:库存类型(日历库存/总库存)、是否时段、库存池(共享库存池/独立控位)。推荐默认:日历库存 + 独立控位。

12.4.4 价格与库存设置

12.4.5 推荐默认配置

12.5 车辆字段表单

12.5.1 POI 关联说明

车辆 SPU 可关联取车点/还车点 POI(租车自驾)或上车点 POI(接送/包车)。服务区域通过销售规则中的购买区域限制或文本说明控制。

12.5.2 SPU扩展字段

字段类型必填说明
关联 POI选择器否取车点/上车点 POI,接送机/包车场景可填。
服务类型单选是接送机/日游包车/租车自驾/点对点接送。
服务区域文本是可用服务城市/区域。
起步价规则富文本否起步价包含里程/时长。
超时/超里程规则富文本否额外费用说明。
取车/上车地点文本否默认上车地点,可补充POI。
服务时长数字否默认服务小时数。

12.5.2 SKU规格字段

字段类型必填说明
SKU名称文本是如5座轿车、7座商务。
车型单选是轿车/SUV/商务车/中巴/大巴。
座位数数字是含司机座位数。
行李数数字否可载行李件数。
司机服务布尔否是否含司机。

12.5.3 库存与价格模式

车辆的库存与价格模式由供应商选择:库存类型(日历库存/总库存)、是否时段、库存池(共享库存池/独立控位)。推荐默认:日历库存 + 独立控位。

12.5.4 价格与库存设置

12.5.5 推荐默认配置

12.6 特色商品字段表单(含进销存)

12.6.1 SPU扩展字段

字段类型必填说明
商品品牌文本否品牌名称。
产地文本否商品产地。
发货地地址是默认发货地址。
运费模板关联是选择已配置的运费模板。
保质期日期/文本否食品类必填。
生产日期日期否批次生产日期。

12.6.2 SKU规格字段

字段类型必填说明
SKU名称文本是如500g装、红色款。
规格文本是重量/容量/颜色/尺码等。
重量(kg)数字否用于运费计算。
体积(m³)数字否用于运费计算。
条形码文本否商品条码。

12.6.3 价格与库存

12.6.4 进销存管理(特色商品专用)

特色商品需要实物库存管理,支持入库、出库、盘点、调拨、库存预警。

功能说明
入库单采购入库、退货入库、盘盈入库。需审核后库存增加。
出库单销售出库、盘亏出库、调拨出库。订单发货后自动生成销售出库单。
库存盘点定期盘点实物库存,生成盘盈盘亏单。
库存调拨支持仓库间调拨,调拨完成后库存转移。
库存预警设置安全库存阈值与通知方式,低于阈值时通过站内消息/短信/邮件提醒补货。
批次管理支持按批次管理库存,先进先出。

12.6.5 默认SPU配置

12.7 组合套餐字段表单

12.7.1 SPU扩展字段

字段类型必填说明
套餐类型单选是固定组合/可选组合。
套餐组成关联是选择已上架的门票/酒店/车辆/特色商品作为子项。
套餐有效期日期区间是套餐可预约/使用有效期。
预约方式单选是无需预约/需预约/部分子项需预约。

12.7.2 SKU规格字段

字段类型必填说明
SKU名称文本是如成人套餐、儿童套餐。
适用人群单选否成人/儿童/家庭。
子项规格关联是每个子项选择的SKU规格。

12.7.3 价格与库存

12.7.4 默认SPU配置

12.8 线路产品字段表单

12.8.1 POI 关联说明

线路产品 SPU 可关联出发地/集合点 POI,行程节点中的景区可通过线路节点字典维护,节点信息可与 POI 关联展示。

12.8.2 SPU扩展字段

字段类型必填说明
关联 POI选择器否出发地/集合点 POI。
线路名称文本是线路产品名称。
行程天数数字是总天数。
出发地文本是集合出发城市。
目的地文本是主要目的地。
线路主题多选标签否亲子/蜜月/摄影/徒步等。
线路归类节点顺序否黄果树—小七孔—西江千户苗寨等节点顺序。
行程详情富文本是每日行程安排。
费用包含富文本是交通/住宿/门票/餐饮等。
费用不含富文本是个人消费/保险等。
成团人数数字否最低成团人数。
出发班次日期/周期是固定发团日期或周期发团。

12.8.2 SKU规格字段

字段类型必填说明
SKU名称文本是如成人价、儿童价。
出发日期日期是具体发团日期。
余位数字是该班次剩余可售位置。
成人/儿童价金额是不同人群价格。

12.8.3 库存与价格模式

线路产品的库存与价格模式由供应商选择:库存类型(日历库存/总库存)、是否时段、库存池(共享库存池/独立控位)。推荐默认:日历库存 + 独立控位。

12.8.4 价格与库存设置

12.8.5 推荐默认配置

12.9 SKU规格与价格通用规则

12.9.1 SKU创建规则

12.9.2 SKU价格字段

字段必填说明
市场价是划线价,≥售价。
实际售价是前台销售价。
底价是B端采购价,≤售价。
平台限价否平台级限价,≤售价。

12.9.3 日历价格设置

12.9.4 库存预警与通知方式

12.10 SPU配置驱动(详细)

12.10.1 配置入口

在商品创建/编辑页的「下单与核销配置」步骤中,供应商可调整SPU配置。平台运营在审核时也可查看配置是否合理。

12.10.2 配置字段业务说明

字段业务说明校验规则
是否展示购买须知开启后下单页顶部折叠展示购买须知,需勾选同意。默认开启。
是否需要选择SKU关闭后SPU无规格,直接数量输入购买。多SKU商品必须开启。
库存类型calendar日历库存 / total_inventory总库存,决定按日期还是按总量维护库存与价格。门票/酒店/车辆/线路产品可选,特色商品固定为总库存。
是否时段开启后在日历或总库存基础上按时段拆分库存。与库存类型组合使用。
提前预定天数0表示可订今日,N表示需提前N天。整数 ≥ 0。
提前预定截止时间游玩当日截止下单时间,如18:00。HH:MM格式。
每日截止下单时间超过后当日不可订。HH:MM格式。
允许下单时段每日允许用户下单的开始/结束时间。HH:MM格式,结束时间需晚于开始时间。
购买区域限制开启后仅允许定位/IP在指定多边形区域内的用户下单。需绘制或导入GeoJSON区域。
仅套餐可用开启后商品不在C端/B端商城单独展示,仅可被选入组合套餐。与自由销售互斥。
团队导游证要求团队订单需上传导游证图片。线路/车辆/门票团队订单可选。
团队导游实名团队订单需填写导游姓名/证号/手机。团队导游证要求开启时才可开启。
团队行程单要求团队订单需上传行程单PDF/图片。车辆默认开启。
库存模式共享库存池 / 独立控位,影响日历库存扣减逻辑。门票/酒店/车辆/线路产品可选。
库存预警通知方式站内消息 / 短信 / 邮件,可多选;用于SKU库存低于预警阈值时通知供应商。默认仅站内消息。
是否实名制开启后按购买数量填写使用人信息。门票/线路默认开启。
是否上传证件优惠票等特殊SKU需上传证件。enable_real_name=1时才可开启。
是否填写导游信息团队订单需填写导游姓名/证号/手机。enable_real_name=1时才可开启。
是否上传行程单团队/包车订单需上传行程单PDF/图片。车辆默认开启。
使用前是否审核支付后进入待审核,供应商审核通过才履约/收单。高风险商品建议开启。
核销方式one_order_one_code一单一码 / one_ticket_one_code一票一码 / manual_confirm手动确认 / none无需核销。按商品类型限制可选值。
是否支持部分核销开启后允许分次核销。verification_type=one_ticket_one_code时可选。
自动收单支付成功后是否自动确认收单。默认开启,关闭后需供应商手动收单。
手动收单是否允许供应商在后台手动确认收单。开启后订单列表显示「确认收单」按钮。

12.10.3 配置变更生效规则

生效规则: SPU配置变更后,已上架商品需重新提交审核(或平台运营审核通过)才能生效;未上架商品随商品上架一起生效。已生成订单按下单时的配置执行,不受后续变更影响。

12.11 商品上下架与状态机

12.11.1 上架条件

12.11.2 下架条件

12.11.3 上下架对订单的影响

操作待支付订单已支付未核销订单已核销订单
供应商下架保留订单,支付时校验商品状态;15分钟内未支付提示商品已下架。不受影响,正常履约。不受影响。
平台强制下架建议自动取消待支付订单并通知分销商。供应商需处理退款或履约。不受影响。

12.12 商品审核流程

12.12.1 审核入口

12.12.2 审核内容

审核维度审核要点
基础信息名称、图片、分类、卖点是否符合规范,是否存在违禁词。
价格体系市场价≥售价≥限价≥底价,是否存在价格倒挂。
SKU规格规格组合是否合理,名称是否清晰,价格是否完整。
SPU配置下单字段与核销规则是否与商品类型匹配。
退改规则是否选择退改模板,规则是否合理。
素材内容详情图片是否清晰、是否存在侵权或虚假宣传。
类型专属字段如线路行程、套餐组成、车辆规则等是否完整。

12.12.3 审核操作

12.12.4 审核时效

平台运营需在2个工作日内完成审核;超时未处理,系统自动提醒运营负责人。(MVP阶段可不做自动通过,只做提醒。)

12.12.5 智能初审

供应商提交审核后,系统先进行智能初审,结果作为人工复审的辅助标记。

12.12.6 人工复审

12.13 商品复制/批量导入/导出

12.13.1 商品复制

12.13.2 批量导入

12.13.3 批量导出

12.14 销售规则配置

12.14.1 配置入口

商品创建/编辑流程中的「销售规则」步骤,供应商按实际业务配置提前预定、下单时段、购买区域、销售范围、团队信息要求等规则。

12.14.2 字段说明

字段类型必填说明
提前预定天数数字是0表示可订今日,N表示需提前N天。
提前预定截止时间时间否游玩当日截止下单时间,如18:00。
每日允许下单时段时间区间否如 09:00-22:00,空则表示全天。
购买区域限制开关+地图否开启后绘制多边形区域,按用户下单时定位/IP判断。
销售模式单选是自由销售 / 仅套餐可用。
团队导游证要求开关否团队订单(单次购买≥N张,N在SPU配置中设置)需上传导游证。
团队导游实名开关否团队订单需填写导游姓名/证号/手机。
团队行程单要求开关否团队订单需上传行程单PDF/图片。
自动收单开关是支付成功后是否自动确认收单。
手动收单开关是是否允许供应商手动确认收单。

12.14.3 购买区域限制规则

12.14.4 自由销售 / 仅套餐可用

12.15 核销规则配置

12.15.1 配置入口

商品创建/编辑流程中的「核销规则」步骤,供应商配置核销凭证形式、是否审核订单、是否允许部分核销等。

12.15.2 字段说明

字段类型必填说明
核销方式单选是one_order_one_code一单一码 / one_ticket_one_code一票一码 / manual_confirm手动确认 / none无需核销。
是否审核订单开关否开启后支付成功进入待审核,供应商审核通过才算收单,才可生成核销凭证/履约。
是否允许部分核销开关否一票一码模式下,允许分次核销。
核销有效期单选是按商品有效期 / 购买后N天内有效 / 指定日期区间。

12.15.3 核销方式说明

核销方式适用商品说明
one_order_one_code门票团队订单/酒店/线路一个订单生成一个统一核销码,整单一次性核销。
one_ticket_one_code门票散客订单每张票/每个使用人生成一个独立核销码,支持部分核销。
manual_confirm酒店/车辆/线路产品供应商在后台手动确认入住/还车/成团,不生成统一核销码。
none特色商品无需核销,物流签收即履约完成。

12.15.4 审核订单流程

12.16 短信模板选择

12.16.1 配置入口

商品创建/编辑流程中的「渠道与短信」步骤,供应商按触发场景选择平台预置的短信模板。

12.16.2 字段说明

字段类型必填说明
已支付短信下拉选择否用户支付成功后触发。
已确认收单短信下拉选择否订单确认收单后触发。
已退款短信下拉选择否退款完成后触发。
短信开关开关是按场景启用/禁用短信发送。

12.16.3 发送规则

12.17 第三方接口资源同步机制

12.17.1 适用场景

当 SPU 标记为第三方接口资源(is_third_party=1)时,库存、价格、订单、核销状态需与第三方系统对接同步。

12.17.2 同步内容

同步类型方向触发时机说明
库存同步第三方 → 本平台定时任务(5分钟)+ 下单前实时查询同步第三方可用库存到 t_calendar_inventory 或 t_inventory_inbound。
价格同步第三方 → 本平台定时任务(30分钟)+ 商品上架前同步第三方市场价/销售价/底价,受五层价格体系约束。
下单同步本平台 → 第三方用户支付成功后将订单信息推送第三方占库/预订,返回第三方订单号。
核销同步双向核销/退款时本平台核销后通知第三方;第三方核销状态变更也同步回本平台。
退款同步本平台 → 第三方退款申请审核通过后调用第三方退款接口,按原支付方式原路退回。

12.17.3 同步异常处理

12.17.4 数据映射

12.19 AI 生成助手

12.19.1 适用字段

商品创建/编辑过程中,以下素材字段支持AI生成辅助,供应商可手动输入/上传,也可点击输入区旁的「AI生成」按钮获取候选内容:

字段AI生成内容输出形式
商品主图基于商品名称、分类、POI、卖点生成1张商品主图图片URL
商品轮播图基于商品信息生成3-9张场景图或卖点图图片URL数组
商品卖点提炼商品核心卖点,生成1-5条短文案文本标签数组
商品详情生成商品详情文案并推荐配图位置富文本HTML

12.19.2 交互流程

12.19.3 约束与兜底

12.18 异常处理

异常场景前端表现后端处理
SPU名称重复红框提示「商品名称已存在」400 + SPU_NAME_DUPLICATE
价格倒挂红框提示具体错误,如「底价不能高于售价」400 + PRICE_INVERSION
SKU规格组合超过200提示「规格组合过多,请精简」400 + SKU_COMBO_TOO_MANY
未选择末级分类提示「请选择三级分类」400 + CATEGORY_NOT_LEAF
必填扩展属性缺失对应字段红框提示400 + REQUIRED_ATTR_MISSING
已上架商品删除删除按钮禁用,hover提示「请先下架」400 + CANNOT_DELETE_ONSALE
特色商品库存不足提示「库存不足,请先入库」400 + STOCK_INSUFFICIENT
POI 未审核通过POI选择器仅展示 approved 状态的 POI400 + POI_NOT_APPROVED
区域外用户下单提示「当前商品仅限XX区域购买」400 + OUT_OF_SALE_REGION
第三方同步失败订单列表显示「同步失败」标签记录异常日志,支持手动重试

13效期与价格管理

本章覆盖商品退改规则模板、效期规则、五层价格体系、底价/专属价/佣金配置及全局限价规则,确保价格与退款逻辑可落地。

13.1 退改规则模板管理

13.1.1 业务规则

13.1.2 模板字段

字段类型说明
template_namevarchar(100)模板名称,如「演出开始前24小时可退」。
policy_jsonjson退改规则数组,见下方示例。
is_defaulttinyint是否为默认模板,每个租户最多1个默认。
statustinyint0禁用 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 退款金额计算

  1. 根据订单中商品的使用时间(如入园日期、入住日期)计算距使用时间的剩余小时数。
  2. 匹配最大 before_hours 且小于等于剩余小时数的规则。
  3. 退款金额 = 实付金额 × 退款比例。
  4. 若存在手续费,优先从退款金额中扣除,或按平台规则由用户承担。

13.2 收单规则管理

13.2.1 业务规则

13.2.2 状态流转

收单方式支付后状态供应商操作下一状态
自动收单已收单无需操作待核销/履约
手动收单/审核收单待收单确认收单已收单并生成核销凭证
手动收单/审核收单驳回待收单驳回/超时已退款

13.2.3 与核销规则的关系

13.3 购买区域限制规则

13.3.1 业务规则

13.3.2 技术实现

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 价格校验规则

13.6 底价/专属价/佣金配置

13.6.1 B端底价模式

13.6.2 专属价配置

13.6.3 个体佣金配置

13.7 全局限价规则

13.7.1 限价维度

维度优先级说明
商品级最高针对具体SKU/SPU设置限价。
品类级中针对某一品类统一设置限价。
全局级最低平台级默认规则。

13.7.2 限价规则字段

字段说明
rule_typeglobal/category/product
target_id品类ID或SPU/SKU ID,全局规则填0。
max_price最高售价,必须 > 底价。
effective_time生效时间。
status启用/禁用。

13.7.3 限价拦截

13.8 价格变更生效规则

变更类型是否需要重新审核生效时机
市场价、副标题、卖点等非价格敏感字段否保存即时生效。
售价、底价调整但未突破层级建议(可配置)已上架商品需重新审核或平台运营确认。
平台限价调整否保存即时生效,不追溯历史订单。
专属价调整否保存即时生效,已授权分销商立即看到新价。

13.8.1 调价留痕

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 业务规则

14.2 入库单管理

14.2.1 入库类型

入库类型说明
采购入库从供应商或厂家采购入库。
退货入库分销商/客户退货入库,需质检。
盘盈入库盘点发现实物多于系统库存。
调拨入库从其他仓库调入。

14.2.2 入库单字段

字段说明
inbound_no入库单号,IN + 日期 + 6位流水。
sku_id入库SKU。
batch_no批次号。
quantity入库数量,正整数。
warehouse_id入库仓库。
inbound_type入库类型。
supplier_remark供应商备注。
statuspending/submitted/approved/revoked。
auditor_id / audit_time审核人/时间。

14.2.3 入库流程

  1. 供应商运营选择SKU、仓库、批次,填写入库数量与类型。
  2. 提交后状态变更为「待审核」。
  3. 供应商管理员审核通过后,状态变更为「已入库」,库存增加。

14.3 出库单管理

14.3.1 出库类型

出库类型说明
销售出库订单发货后自动生成。
盘亏出库盘点发现实物少于系统库存。
调拨出库调出至其他仓库。

14.3.2 销售出库触发规则

14.4 库存盘点

14.5 库存调拨

14.6 库存预警

14.7 库存公式

可用库存 = 期初库存 + 累计入库 - 累计出库 - 锁定库存

14.8 库存日志

字段说明
log_id日志ID
sku_id / batch_noSKU与批次
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 详情内容安全

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 素材关联

15.2.3 素材水印

15.3 分销素材工坊

15.3.1 业务规则

15.3.2 素材模板管理

模板字段说明
template_name模板名称。
aspect_ratio宽高比,如1:1、9:16、2.35:1。
layout_json布局配置JSON(图片位置、文字位置、颜色)。
status启用/禁用。

15.3.3 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[财务结算中心]
模块依赖顺序

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/lockPOST订单中心锁定库存。
/api/inventory/releasePOST订单中心释放锁定库存。
/api/inventory/confirmPOST订单中心支付成功转移锁定到已售。
/api/inventory/verifyPOST订单中心核销后扣减已售库存。
/api/inventory/refundPOST订单中心退款释放库存。
/api/price/check-limitPOST分销中心、订单中心校验售价是否超过限价。
/api/price/snapshotPOST订单中心生成价格快照。

16.3.2 商品中心依赖接口

接口提供方用途
/api/auth/current-user权限中心获取当前用户租户、角色、数据范围。
/api/auth/permission/check权限中心校验按钮/菜单权限。
/api/distribution/authorization/list分销中心查询商品授权状态。
/api/order/order-status订单中心查询商品关联订单状态,用于下架判断。

16.4 数据初始化顺序

  1. 初始化平台租户与管理员账号(权限中心)。
  2. 初始化商品分类树与属性模板。
  3. 初始化退改规则模板与系统参数。
  4. 创建供应商租户与账号(权限中心)。
  5. 供应商创建商品、价格、库存、素材。
  6. 平台运营审核商品上架。
  7. 分销中心配置授权、可见范围、限价、佣金。
  8. 订单中心调用商品接口完成交易闭环。

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 ≤ 200msRedis预扣+MySQL落库。
价格校验接口P95 ≤ 100ms单SPU多SKU价格校验。
商品详情加载P95 ≤ 800ms含富文本、图片、SKU、库存。
并发库存扣减超卖率 = 01000并发同时抢购同一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