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

PC端商家主体与店铺管理中心 PRD v1.0
v1.0
2026-07-23
正式稿
内部机密

1. 文档元信息

1.1 文档标识

项目内容
文档名称云灵汐涉旅电商分销子系统 - PC端商家主体与店铺管理中心 PRD
版本号v1.0
编制日期2026-07-23
文档状态正式稿
密级内部机密
适用范围平台运营后台、供应商后台、分销商后台(个人/B端/OTA)

1.2 修订记录

版本日期修订人修订内容审核人
v1.02026-07-23产品团队初始版本,覆盖功能清单模块2全部14个功能项待审核
v1.12026-07-30产品团队新增3个功能项:12.5录入商家、13.4商家标签体系管理、15.5到期提醒配置,功能项总数更新为17个待审核

1.3 引用文档

  • 《云灵汐涉旅电商分销子系统 - 核心业务主流程图 v1.2》
  • 《涉旅电商分销子系统 - 功能清单整理版 v1.2》
  • 《涉旅电商分销子系统 - 菜单结构整理版 v1.3》
  • 《PRD-产出SOP与深度标准模板 v1.0》
  • 《云灵汐涉旅电商分销子系统 - PC端基础功能及权限中心 PRD v4.0(深化版)》
  • 《云灵汐涉旅电商分销子系统 - PC端分销中心模块 PRD v2.3》
  • 《云灵汐涉旅电商分销子系统 - PC端订单履约全链路管理中心 PRD v1.0》
  • 《云灵汐涉旅电商分销子系统 - PC端商品供应链管理中心 PRD v2.0》
  • 《云灵汐涉旅电商分销子系统 - PC端财务中心模块 PRD v2.0》

2. 术语表

本文档中使用的所有专业术语均在下表中定义,禁止在文档中出现未定义术语。

术语英文/缩写定义
商家Merchant在平台上开展经营活动的法人或组织,包括供应商和分销商两类主体
供应商Supplier向平台提供旅游资源商品(门票/酒店/线路/车队等)的商家主体
分销商Distributor从平台采购商品并向终端消费者或下级渠道销售的商家主体,分为个人分销商、B端分销商、OTA分销商三种
个人分销商Individual Distributor以个人身份入驻的分销商,包括司导、达人、C端游客等,通过推广链接获取佣金
B端分销商B-End Distributor以企业身份入驻的分销商,包括酒店、旅行社、代订商等,通过底价模式采购后加价销售,distributor_type=B
OTA分销商OTA Distributor在线旅游平台分销商,通过API接口与平台对接,实现商品同步和订单回传
店铺Shop / Store商家在平台上对外展示的经营门面,包含店铺名称、Logo、简介、轮播图、推荐商品等展示信息
入驻Onboarding商家(供应商或分销商)向平台提交资质资料,经平台审核通过后获得系统账号和经营权限的完整流程。一个商家可同时具备供应商和分销商身份(merchant_type 多选),入驻时可同时选择两种身份
双审机制Dual ReviewB端分销商入驻时,需先通过目标供应商的初审,再经平台运营终审的二级审核机制
平台公共协议Platform Public Agreement所有分销商入驻时必须签署的统一分销协议,签署后获得全平台通用商品分销权
供应商专属协议Supplier Exclusive Agreement分销商与特定供应商之间签署的专属分销协议,签署后获得该供应商的特定价格/商品分销权
证照Certificate / License商家开展经营活动所需的法定资质文件,包括营业执照、法人身份证、旅行社业务经营许可证等
供应商子类型supplier_type仅当 merchant_type 含 SUPPLIER 时填写,多选(逗号分隔),取值 TICKET(票务)/ HOTEL(酒店)/ VEHICLE(车辆)/ SPECIALTY(特产)/ ROUTE(线路)。决定商品管理菜单、资质上传、订单品类筛选、财务报表维度、分销授权范围、营销活动商品范围
商家等级Merchant Level平台对商家的综合评级,依据交易额、履约率、评价等多维度计算,影响商品曝光权重和佣金比例
电子签章E-Signature通过第三方电子签章服务完成的在线合同签署,具有法律效力
商家身份类型merchant_type多选(逗号分隔存储),取值 PLATFORM(平台运营)/ SUPPLIER(供应商)/ DISTRIBUTOR(分销商)。PLATFORM 互斥;SUPPLIER 和 DISTRIBUTOR 可同时选(如 SUPPLIER,DISTRIBUTOR 表示既是供应商又是分销商,一个账号登录后合并展示供应商菜单+分销商菜单)。与权限中心 PRD 完全对齐
入驻状态Onboarding Status描述商家在入驻流程中所处阶段的枚举值:待提交、审核中、审核通过、审核驳回、待签约、已激活、已停用
店铺运营状态Shop Operating Status描述店铺当前对外营业状态的枚举值:营业中、暂停营业、资料待审核、展示异常
合同续签Contract Renewal商家合同即将到期时,由商家主动发起或平台触发续签流程,经平台二次审核后生效

3. 需求背景

3.1 业务背景

云灵汐涉旅电商分销子系统采用 SaaS多租户架构,服务四类核心角色:平台运营、供应商、分销商、C端消费者。商家(含供应商和分销商)是整个平台业务运转的起点——没有商家的入驻和资质审核,后续的商品上架、分销推广、交易履约、资金结算等全部业务环节均无法开展。

在已有PRD体系中,分销中心PRD覆盖了分销商/分销员的管理与协议,订单履约PRD覆盖了交易履约,供应链PRD覆盖了商品管理,财务中心PRD覆盖了资金结算,基础功能与权限中心PRD覆盖了RBAC权限体系,但商家主体的入驻管理、档案管理、店铺管理、证照管理、合同管理等模块在所有已有PRD中均未被完整覆盖,形成明显的需求空白。

3.2 当前痛点

痛点一:商家入驻流程缺乏标准化定义

供应商、个人分销商、B端分销商、OTA分销商四种入驻类型各有不同的资料要求、审核流程和签约规则,但当前系统中缺乏统一、标准化的入驻流程定义,导致运营团队在审核时标准不统一,审核效率低,且无法追踪入驻进度。

痛点二:商家档案信息分散,缺乏统一管理视图

商家的企业信息、证照信息、联系人信息、经营类别、合同信息分散在不同模块中,平台运营侧没有一个统一的商家档案管理页面,无法快速查看商家的完整画像,也无法对商家进行统一管理(如停启用、等级调整)。

痛点三:店铺展示管理缺失

供应商和分销商入驻后需要对外展示店铺信息(名称、Logo、轮播图、推荐商品等),但当前缺乏店铺基础信息维护和展示配置功能,影响商家品牌形象和C端消费者的购物体验。

痛点四:证照与合同管理缺乏数字化支撑

商家的营业执照、法人身份证、旅行社经营许可证等证照的上传、审核、到期提醒,以及合同的上传、续签、模板管理,目前依赖人工线下操作,效率低、易遗漏,且缺乏系统化的到期预警机制。

3.3 不解决的后果

  • 业务无法闭环:商家入驻是所有后续业务的前置条件,入驻管理缺失导致供应商无法上架商品、分销商无法推广商品,整个平台业务链路断裂。
  • 合规风险:缺乏标准化的资质审核和合同管理,可能导致无资质商家进入平台,引发法律合规风险(尤其是旅游行业对旅行社经营资质的强制性要求)。
  • 运营效率低下:人工线下管理商家档案、证照和合同,运营团队工作量大,且容易出现证照过期未续、合同到期未签等情况。
  • 商家体验差:商家入驻后无法自主管理店铺信息和展示内容,影响商家对平台的满意度和留存率。

4. 目标与范围

4.1 总体目标

构建一套标准化、数字化、全生命周期的商家主体与店铺管理体系,覆盖从商家入驻申请、资质审核、电子签约、档案管理、店铺配置到证照合同管理的完整闭环,确保平台商家资质合规、档案完整、店铺可运营、合同可追溯,为后续商品上架、分销推广、交易履约等业务环节提供可靠的基础数据支撑。

4.2 核心设计原则

  1. 准入合规:所有商家入驻必须经过标准化的资质审核,未通过审核和电子签约的商家禁止开通任何业务权限。
  2. 生命周期管理:商家从入驻申请到退出平台的完整生命周期必须在系统中可追溯、可管理。
  3. 三端统一、差异适配:平台运营后台、供应商后台、分销商后台三端共用同一套商家主体数据模型,但各端根据角色差异展示不同的功能和数据范围。
  4. 双层协议架构:分销商入驻必须签署《平台公共分销协议》(第一层,必签),可选签署《供应商专属分销协议》(第二层,选签)。
  5. 数据隔离:商家只能查看和维护自己的主体资料、店铺信息和合同记录,平台运营可查看和管理全部商家数据。
  6. 到期预警:证照和合同必须设置到期提醒机制,提前N天通知相关方进行续期或续签。
  7. 操作留痕:商家资料变更、店铺状态变更、合同签署/续签等关键操作必须记录操作日志,支持审计追溯。
  8. 状态机驱动:所有涉及状态流转的功能(入驻、审核、合同续签等)必须有清晰的状态机定义,状态流转不可逆或需特定条件。

4.3 模块范围

本次PRD覆盖功能清单中模块2:商家主体、店铺、证照与合同的全部17个功能项(含v1.1新增3项)。

功能模块功能项适用后台优先级
入驻管理供应商入驻申请平台/供应商P0
分销商分类入驻平台/分销商P0
B端分销商双审平台/供应商P0
OTA入驻与接口验证平台/OTA分销商P0
商家档案与资料管理商家列表与详情平台P0
主体资料维护供应商/分销商P0
经营类别与等级平台P1
店铺管理店铺基础信息维护供应商/分销商P0
店铺展示配置供应商/分销商P1
店铺运营状态供应商/分销商P1
证照与合同管理证照上传与审核平台/供应商/分销商P0
合同记录管理平台/供应商/分销商P0
合同续签平台/供应商/分销商P0
合同模板平台P1

4.4 本次不纳入的功能

功能项不纳入原因归属模块
商家权限菜单配置归属基础功能与权限中心PRD(RBAC体系)权限中心
商家组织架构管理归属基础功能与权限中心PRD(部门/用户管理)权限中心
商家资金账户管理归属财务中心PRD(账户余额、充值、授信、提现)财务中心
分销商等级与佣金规则归属分销中心PRD(分销商等级体系、佣金结算规则)分销中心
商家数据统计看板归属数据运营模块(待后续PRD覆盖)数据运营

4.5 上下游模块关系

关系模块交互内容
上游依赖基础功能与权限中心提供RBAC权限体系、用户账号管理、角色分配能力;商家入驻激活后调用权限中心创建管理员账号和默认角色
上游依赖电子签章服务提供在线合同签署能力(第三方服务对接)
上游依赖OCR识别服务提供营业执照、法人身份证等证照的自动识别能力(第三方服务对接)
下游输出商品供应链管理中心输出商家入驻状态、经营类别、商家等级,作为商品上架的前置条件
下游输出分销中心输出商家入驻状态、分销商类型,作为分销协议签署和授权的前置条件
下游输出订单履约全链路输出商家基本信息、店铺信息,订单中展示商家/店铺名称和联系方式
下游输出财务中心输出商家主体信息(企业名称、税号、银行账号),用于分账结算和发票开具

5. 用户与角色

5.1 角色定义

本模块涉及的角色及数据权限范围如下表所示,禁止出现模糊的"所有用户"描述。

角色所属后台数据权限范围本模块核心操作
平台运营管理员平台运营后台全部商家数据(供应商+全部类型分销商)商家入驻审核(通过/驳回)、商家档案管理、店铺管理(查看/编辑)、证照审核、合同模板管理、合同续签审核、商家停启用
平台商家运营平台运营后台全部商家数据(供应商+全部类型分销商)商家入驻审核、商家档案查看与编辑、证照审核、合同记录管理、合同续签审核、经营类别与等级调整
供应商管理员供应商后台仅本供应商数据主体资料维护、店铺信息维护、店铺展示配置、店铺状态切换、证照上传/更新、合同查看/续签申请
供应商运营供应商后台仅本供应商数据(受管理员授权)主体资料查看、店铺信息查看、证照上传(受限)、合同查看
B端分销商管理员分销商后台仅本分销商数据主体资料维护、店铺信息维护、店铺展示配置、店铺状态切换、证照上传/更新、合同查看/续签申请
个人分销商分销商后台(移动端为主)仅本分销商数据简化版主体资料维护(个人实名信息)、简化版店铺信息维护、证照上传(身份证等)、协议签署
OTA分销商管理员分销商后台仅本OTA分销商数据主体资料维护(企业信息+接口信息)、合同查看/续签申请
分销商运营分销商后台仅本分销商数据(受管理员授权)主体资料查看、店铺信息查看、合同查看

5.2 三类分销商差异对照

差异维度个人分销商B端分销商OTA分销商
入驻资料要求简化(姓名、身份证号、手机号、银行卡)完整企业资质(营业执照、法人身份证、开户许可证、旅行社经营许可证)企业资质+接口资料(营业执照、OTA平台资质、接口对接授权书、技术联系人)
审核层级平台单审供应商初审+平台终审(双审)平台审核+接口验证
协议签署《平台公共分销协议》《平台公共分销协议》+可选《供应商专属分销协议》《OTA分销协议》
店铺管理简化(个人头像、昵称、简介)完整(店铺名称、Logo、轮播图、推荐商品、展示模块)不展示店铺(仅展示接口对接信息)
证照类型个人身份证营业执照、法人身份证、开户许可证、旅行社经营许可证营业执照、OTA平台资质、接口对接授权书
合同类型《平台公共分销协议》《平台公共分销协议》+《供应商专属分销协议》《OTA分销协议》
经营主体个人企业企业(OTA平台)

5.3 角色权限关键规则

  1. 平台运营管理员拥有本模块全部功能的操作权限;平台商家运营拥有除"商家停启用"之外的全部权限。
  2. 供应商管理员和B端分销商管理员拥有本商家全部资料、店铺、证照、合同的管理权限。
  3. 供应商运营和分销商运营的角色权限由各自管理员在权限中心配置,默认仅拥有查看权限。
  4. 个人分销商仅拥有简化版功能入口,不显示企业级字段(如统一社会信用代码、对公账户等)。
  5. OTA分销商不显示店铺管理功能入口,其"店铺"概念由接口对接信息替代。
  6. 商家资料处于"审核中"状态时,资料字段锁定不可编辑;审核驳回后开放编辑权限。
  7. 商家状态为"已停用"时,仅平台运营管理员可查看完整档案,商家自身仅保留查看权限(不可编辑)。

6. 功能清单

本模块共包含17个功能项,按功能域分为4组。每个功能项的描述包含功能定位、核心价值、适用角色和优先级。

6.1 入驻管理(5项)

序号功能项功能描述适用角色优先级
1供应商入驻申请供应商通过PC端填写企业基本信息、上传营业执照、法人身份证、旅行社经营许可证等资质文件,提交入驻申请。系统支持OCR自动识别营业执照信息,减少人工录入。提交后进入平台审核队列,运营人员可在后台查看申请资料并进行审核(通过/驳回)。审核通过后触发电子签章流程,签署《供应商入驻合同》。供应商管理员、平台商家运营P0
2分销商分类入驻分销商根据自身类型(个人/B端/OTA)选择对应的入驻入口,填写差异化的资料表单。个人分销商填写姓名、身份证号、手机号、银行卡信息;B端分销商填写企业信息并上传营业执照等资质;OTA分销商填写企业信息+接口对接资料。系统根据选择的类型自动加载对应的资料要求和审核流程。个人分销商、B端分销商管理员、OTA分销商管理员、平台商家运营P0
3B端分销商双审B端分销商提交入驻申请后,系统先将申请推送给该分销商选择合作的供应商进行初审(审核资质真实性和合作意愿)。供应商初审通过后,申请进入平台运营终审队列;若供应商初审驳回,申请直接终止并通知分销商。平台终审通过后,分销商签署《平台公共分销协议》,获得全平台通用分销权。B端分销商管理员、供应商管理员、平台商家运营P0
4OTA入驻与接口验证OTA分销商提交企业资质和接口对接资料(包括API密钥、回调地址、技术联系人等)。平台运营审核资质后,进行接口连通性验证(测试商品同步接口、订单回传接口、库存查询接口是否正常)。接口验证通过后,OTA分销商签署《OTA分销协议》,系统生成API密钥并开通接口权限。OTA分销商管理员、平台商家运营P0
5录入商家平台运营人员在后台手动录入商家信息,适用于线下招商签约后补录、历史数据迁移等场景。选择商家类型后填写基本信息(企业名称/信用代码/法人/联系人等),可选上传证照,提交后直接生成"已激活"状态的商家账号并自动生成初始密码,通过短信发送给商家联系人。支持批量导入(Excel模板下载→填写→上传→校验→批量创建)。平台运营管理员、平台商家运营P0

6.2 商家档案与资料管理(4项)

序号功能项功能描述适用角色优先级
5商家列表与详情平台运营后台提供统一的商家列表页面,支持按商家类型(供应商/个人/B端/OTA)、入驻状态、经营类别、商家等级、注册时间等维度筛选和搜索。列表展示商家名称、类型、状态、联系人、入驻时间、最近登录时间等关键信息。点击商家进入详情页,展示商家的完整档案:基本信息、证照信息、店铺信息、合同记录、操作日志等,支持编辑关键字段和停启用操作。平台运营管理员、平台商家运营P0
6主体资料维护商家(供应商/分销商)在各自后台维护本主体的基本信息,包括企业名称、统一社会信用代码、注册地址、经营范围、法人姓名、法人身份证号、联系人姓名、联系人手机号、联系人邮箱、客服电话等。资料修改后若涉及关键字段(企业名称、法人、经营范围)变更,需重新提交平台审核,审核通过前新资料不生效。供应商管理员、B端分销商管理员、个人分销商、OTA分销商管理员P0
7经营类别与等级平台运营根据商家的资质和入驻类型核定其经营类别(如景区门票、酒店客房、旅游线路、车队服务等),商家只能在其核定的经营类别范围内上架商品。商家等级由系统根据交易额、履约率、评价等多维度自动计算(每日更新),分为S/A/B/C/D五个等级,等级影响商品曝光权重和佣金比例。平台运营可手动调整商家等级,调整需填写原因并留痕。平台运营管理员、平台商家运营P1
8商家标签体系管理平台运营管理商家标签体系,支持标签的增删改查、分类分组、批量打标/移标。标签分为系统标签(基于交易额、履约率等维度自动打标,每日更新)和自定义标签(运营手动创建和打标)。标签属性包含名称、编码、分类(运营/风控/招商)、颜色标识、排序、状态。每个商家最多20个标签,每个标签最多关联10000个商家。标签用于商家分组运营、筛选查询和数据导出。平台运营管理员、平台商家运营P1

6.3 店铺管理(3项)

序号功能项功能描述适用角色优先级
8店铺基础信息维护商家在各自后台维护本店铺的基础信息,包括店铺名称、店铺Logo、店铺简介、客服电话、营业时间、店铺地址等。店铺名称全局唯一,不可与其他商家重复。店铺Logo支持上传图片(JPG/PNG,最大2MB,建议尺寸300x300px)。店铺简介最多500字。基础信息修改后即时生效,无需审核(除店铺名称变更需平台审核外)。供应商管理员、B端分销商管理员P0
9店铺展示配置商家可配置店铺对外展示的内容模块和排序,包括:轮播图(最多5张,建议尺寸1920x600px)、推荐商品(最多8个,从本商家已上架商品中选择)、店铺公告(最多200字)、自定义展示模块(如"热门线路""特价门票"等)。配置完成后支持预览功能,预览效果与C端消费者看到的店铺页一致。展示配置即时生效。供应商管理员、B端分销商管理员P1
10店铺运营状态商家可自主切换店铺的运营状态:营业中(正常对外展示和接单)、暂停营业(店铺页显示"暂停营业",消费者不可下单)。此外,系统会根据商家资料审核状态自动设置"资料待审核"状态,若商家证照过期或合同到期未续签,系统自动将店铺状态切换为"展示异常"并通知商家。供应商管理员、B端分销商管理员、平台运营管理员P1

6.4 证照与合同管理(5项)

序号功能项功能描述适用角色优先级
11证照上传与审核商家在各自后台上传各类证照文件(营业执照、法人身份证、旅行社经营许可证等),支持JPG/PNG/PDF格式,单文件最大10MB。上传后平台运营进行审核(通过/驳回),审核通过的证照在详情页展示缩略图,点击可预览原图。系统记录每张证照的有效期,到期前30天、7天、1天分别发送站内消息和短信提醒。证照被驳回后可重新上传。供应商管理员、B端分销商管理员、个人分销商、OTA分销商管理员、平台商家运营P0
12合同记录管理商家和平台均可查看本商家的全部合同记录,包括合同类型(入驻合同/分销协议/专属协议/OTA协议)、合同编号、签署时间、到期时间、签署状态(已签署/待签署/已过期)、合同文件预览。合同文件以PDF格式存储,支持在线预览和下载。平台运营可查看全部商家的合同记录,支持按合同类型、到期时间筛选。供应商管理员、B端分销商管理员、个人分销商、OTA分销商管理员、平台商家运营P0
13合同续签合同到期前30天,系统自动触发续签提醒(站内消息+短信)。商家可在后台发起续签申请,平台运营审核续签资料(如有变更),审核通过后双方重新签署电子合同。续签流程与原签署流程一致,但历史合同版本需保留,支持查看合同变更记录。若合同到期后仍未续签,系统自动限制商家的部分业务权限(如禁止上架新商品)。供应商管理员、B端分销商管理员、OTA分销商管理员、平台商家运营P0
14合同模板平台运营在后台管理各类合同模板,包括《供应商入驻合同》《平台公共分销协议》《供应商专属分销协议》《OTA分销协议》。支持模板的新增、编辑、启用/停用、预览。模板中支持变量占位符(如{merchant_name}{sign_date}等),签署时自动替换为实际值。模板变更后不影响已签署的历史合同。平台运营管理员P1
15到期提醒配置独立的到期提醒配置中心,覆盖证照到期和合同到期两种场景。支持运营自定义提醒规则:提醒时间节点(如到期前30/15/7/3/1天,每个节点可单独开关)、提醒渠道(站内消息/短信/邮件,每节点可配不同渠道组合)、提醒对象(商家联系人/平台对接人/平台负责人)、提醒模板(支持变量占位符)。系统每日凌晨3点扫描全量证照和合同有效期,匹配规则触发通知。提供提醒看板(即将到期列表+一键催办)和提醒统计报表。平台运营管理员、平台商家运营P1

6.5 功能依赖关系

功能项前置依赖后置影响
供应商入驻申请无商家列表与详情、主体资料维护、证照上传、合同记录
分销商分类入驻无商家列表与详情、主体资料维护、证照上传、合同记录
商家列表与详情供应商入驻申请 / 分销商分类入驻经营类别与等级、店铺基础信息维护
主体资料维护供应商入驻申请 / 分销商分类入驻财务中心(企业名称、税号、银行账号)
经营类别与等级商家列表与详情、主体资料维护供应链中心(商品上架权限)、分销中心(佣金比例)
店铺基础信息维护商家列表与详情订单履约(订单中展示店铺信息)
证照上传与审核供应商入驻申请 / 分销商分类入驻店铺运营状态(证照过期自动限制)
合同模板无合同记录管理、合同续签
合同续签合同记录管理、合同模板店铺运营状态(合同到期自动限制)

7. 系统架构图

本模块在整体系统架构中的定位是商家主体与店铺管理中心,作为平台运营后台、供应商后台、分销商后台三端的公共基础模块,向上依赖电子签章和OCR等第三方服务,向下为供应链、分销、订单、财务等核心业务模块提供商家基础数据。

flowchart TB
    subgraph 第三方服务["第三方服务"]
        ESign["电子签章服务"]
        OCR["OCR识别服务"]
        SMS["短信服务"]
    end

    subgraph 商家主体与店铺管理中心["商家主体与店铺管理中心"]
        IM["入驻管理"]
        AM["商家档案与资料"]
        SM["店铺管理"]
        CCM["证照与合同管理"]
    end

    subgraph 上游模块["上游模块"]
        Auth["基础功能与权限中心"]
    end

    subgraph 下游模块["下游核心业务模块"]
        SC["商品供应链管理中心"]
        DC["分销中心"]
        OC["订单履约中心"]
        FC["财务中心"]
    end

    subgraph 三端后台["三端后台"]
        PB["平台运营后台"]
        SB["供应商后台"]
        DB["分销商后台"]
    end

    ESign --> CCM
    OCR --> IM
    SMS --> IM
    SMS --> CCM

    Auth --> IM
    Auth --> AM

    PB --> IM
    PB --> AM
    PB --> SM
    PB --> CCM
    SB --> AM
    SB --> SM
    SB --> CCM
    DB --> AM
    DB --> SM
    DB --> CCM

    IM --> AM
    AM --> SM
    AM --> CCM

    AM --> SC
    AM --> DC
    AM --> OC
    AM --> FC
    SM --> OC
    CCM --> DC
    CCM --> FC
    
图7-1:商家主体与店铺管理中心系统架构图

8. 核心业务流程图

8.1 供应商入驻全流程

flowchart TB
    A[供应商填写入驻申请表单] --> B[上传证照文件]
    B --> C[OCR自动识别营业执照信息]
    C --> D{信息校验通过?}
    D -->|否| E[提示修正错误信息]
    E --> A
    D -->|是| F[提交入驻申请]
    F --> G[入驻状态: 待审核]
    G --> H[平台运营审核资料]
    H --> I{审核结果}
    I -->|驳回| J[填写驳回原因]
    J --> K[入驻状态: 审核驳回]
    K --> L[通知供应商]
    L --> M[供应商修改资料重新提交]
    M --> G
    I -->|通过| N[入驻状态: 审核通过]
    N --> O[触发电子签章流程]
    O --> P[供应商签署《供应商入驻合同》]
    P --> Q{签署完成?}
    Q -->|否| R[提醒签署]
    R --> O
    Q -->|是| S[入驻状态: 已激活]
    S --> T[创建管理员账号和默认角色]
    T --> U[开放供应商后台权限]
    U --> V[供应商可上架商品/管理订单]
    
图8-1:供应商入驻全流程(含异常回流路径)

8.2 B端分销商入驻全流程(双审机制)

flowchart TB
    A[B端分销商填写入驻申请表单] --> B[上传企业证照]
    B --> C[选择合作供应商]
    C --> D[提交入驻申请]
    D --> E[入驻状态: 待供应商初审]
    E --> F[供应商初审资料]
    F --> G{初审结果}
    G -->|驳回| H[填写驳回原因]
    H --> I[入驻状态: 初审驳回]
    I --> J[通知分销商]
    J --> K[分销商可重新选择供应商提交]
    K --> E
    G -->|通过| L[入驻状态: 待平台终审]
    L --> M[平台运营终审]
    M --> N{终审结果}
    N -->|驳回| O[填写驳回原因]
    O --> P[入驻状态: 终审驳回]
    P --> Q[通知分销商]
    Q --> R[分销商修改资料]
    R --> D
    N -->|通过| S[入驻状态: 审核通过]
    S --> T[签署《平台公共分销协议》]
    T --> U{签署完成?}
    U -->|否| V[提醒签署]
    V --> T
    U -->|是| W[入驻状态: 已激活]
    W --> X[创建管理员账号]
    X --> Y[开放分销商后台权限]
    Y --> Z[分销商可向供应商申请专属协议]
    
图8-2:B端分销商入驻全流程(双审机制)

8.3 商家生命周期状态流转

stateDiagram-v2
    [*] --> 待提交 : 商家开始填写入驻资料
    待提交 --> 审核中 : 商家提交入驻申请
    审核中 --> 审核通过 : 审核通过
    审核中 --> 审核驳回 : 审核驳回
    审核驳回 --> 审核中 : 商家修改后重新提交
    审核通过 --> 待签约 : 触发电子签章
    待签约 --> 已激活 : 合同签署完成
    待签约 --> 审核驳回 : 签约超时(7天未签)
    已激活 --> 已停用 : 平台运营手动停用 / 严重违规自动停用
    已停用 --> 已激活 : 平台运营手动恢复 / 违规整改后恢复
    已停用 --> [*] : 商家主动退出平台(注销账号)
    已激活 --> [*] : 商家主动退出平台(注销账号)
    
图8-3:商家生命周期状态流转图

8.4 合同续签流程

flowchart TB
    A[合同到期前30天] --> B[系统自动触发续签提醒]
    B --> C[站内消息通知商家]
    B --> D[短信通知商家联系人]
    C --> E{商家是否在到期前发起续签?}
    D --> E
    E -->|否| F[到期前7天再次提醒]
    F --> G{商家是否发起续签?}
    G -->|否| H[到期前1天最后提醒]
    H --> I{商家是否发起续签?}
    I -->|否| J[合同状态: 已过期]
    J --> K[系统自动限制商家业务权限]
    K --> L[禁止上架新商品]
    K --> M[店铺状态切换为展示异常]
    E -->|是| N[商家提交续签申请]
    G -->|是| N
    I -->|是| N
    N --> O[平台运营审核续签资料]
    O --> P{审核结果}
    P -->|驳回| Q[填写驳回原因]
    Q --> R[通知商家修改]
    R --> N
    P -->|通过| S[生成新合同版本]
    S --> T[双方电子签章]
    T --> U[合同状态: 已签署]
    U --> V[恢复商家全部业务权限]
    V --> W[店铺状态恢复正常]
    
图8-4:合同续签流程(含提醒机制和异常处理)

9. 全局通用规则

9.1 通用交互规则

规则编号规则描述适用场景
IR-01所有表单提交前必须进行前端必填校验和格式校验,校验不通过时阻止提交并在对应字段下方展示错误提示(红色文字)。全部表单
IR-02表单提交后显示加载状态(按钮变为"提交中..."并禁用),后端返回结果后根据成功/失败展示对应Toast提示(成功=绿色,失败=红色)。全部表单
IR-03列表页默认分页为每页20条,支持切换为10/50/100条。翻页后滚动条自动回到列表顶部。全部列表页
IR-04列表页筛选条件变更后自动触发查询,搜索框支持回车键触发。全部列表页
IR-05所有删除、停用、驳回等不可逆操作必须弹出二次确认弹窗,弹窗中明确说明操作后果。全部危险操作
IR-06图片上传支持拖拽和点击两种方式,上传后显示缩略图预览,支持删除和重新上传。证照上传、Logo上传、轮播图上传
IR-07页面加载数据时显示骨架屏,空数据状态显示空状态插图+引导文字。全部数据展示页
IR-08时间字段统一显示格式为:YYYY-MM-DD HH:mm:ss,日期字段为YYYY-MM-DD。全部时间展示

9.2 通用业务规则

规则编号规则描述适用场景
BR-01商家名称(企业名称/店铺名称)全局唯一,新增或修改时系统进行唯一性校验,重复则拒绝并提示。入驻申请、资料修改
BR-02统一社会信用代码全局唯一,且必须符合18位编码规则(由登记管理部门代码+机构类别代码+登记管理机关行政区划码+主体标识码+校验码组成)。供应商/B端/OTA入驻
BR-03手机号必须为中国大陆手机号格式(1[3-9]开头的11位数字),且全局唯一(一个手机号只能绑定一个商家账号)。全部入驻类型
BR-04法人身份证号必须符合18位居民身份证编码规则,且需通过校验码验证。供应商/B端/OTA入驻、个人分销商入驻
BR-05证照文件有效期必须大于当前日期,已过期的证照不允许上传(系统拦截并提示"证照已过期,请更新后上传")。证照上传
BR-06商家资料中涉及关键字段变更(企业名称、法人姓名、统一社会信用代码、经营范围)时,变更后的资料需重新提交平台审核,审核通过前原资料继续生效。主体资料维护
BR-07店铺名称变更需平台审核,审核通过前继续使用原店铺名称。其他店铺信息(Logo、简介、客服电话等)修改即时生效。店铺基础信息维护
BR-08合同续签时,新合同的起始日期为原合同到期日的次日,不允许出现合同空档期。合同续签
BR-09平台运营审核入驻申请时,SLA标准为:2小时内响应(首次审核)、24小时内完成审核(含驳回后的重新审核)。入驻审核
BR-10商家状态为"已停用"时,商家的全部业务权限冻结(不可上架商品、不可接单、不可推广),但商家仍可以登录后台查看历史数据和操作日志。商家停启用

9.3 通用异常规则

异常编号异常场景前端表现后端行为处理方案
EX-01网络中断导致表单提交失败Toast提示"网络异常,请检查网络后重试",提交按钮恢复可点击状态不记录任何数据变更,等待客户端重试用户点击重试按钮重新提交;若多次失败建议联系客服
EX-02并发操作导致数据冲突(如两人同时编辑同一商家资料)后提交者收到Toast提示"数据已被他人修改,请刷新页面后重试"后端使用乐观锁(version字段)检测冲突,拒绝后提交请求用户刷新页面获取最新数据后重新编辑
EX-03上传文件格式不符合要求文件选择后立即提示"仅支持JPG/PNG/PDF格式,请重新选择"前端拦截不上传,后端做二次校验用户重新选择符合要求的文件
EX-04上传文件超过大小限制文件选择后立即提示"文件大小超过10MB限制,请压缩后重新上传"前端拦截不上传,后端做二次校验用户压缩文件或重新扫描后上传
EX-05OCR识别失败或识别结果不准确上传后提示"自动识别完成,请核对识别结果,如有误请手动修正"OCR结果作为预填值写入表单,不强制要求与OCR结果一致用户核对并修正识别结果后提交
EX-06电子签章服务异常导致签约失败签约页面提示"签章服务暂不可用,请稍后重试或联系平台客服"记录签约失败日志,自动重试3次后标记为待人工处理用户稍后重试;若持续失败,平台运营人工介入处理
EX-07商家账号被停用后尝试登录登录页面提示"账号已被停用,请联系平台客服了解详情"拒绝登录请求,记录登录失败日志商家联系平台客服申诉或整改
EX-08证照到期后商家未及时更新商家后台首页显示红色警告横幅"您的XX证照已过期,请尽快更新,否则将影响店铺正常运营"系统每日扫描证照有效期,过期后自动标记并触发通知商家上传新的有效证照并通过审核

9.4 前端计算态声明

前端计算态字段清单(以下字段仅在前端计算展示,不入库)
  • 商家完整度百分比:根据已填写的资料字段数量 / 总必填字段数量计算,实时展示在商家资料页顶部。
  • 合同剩余天数:合同到期日期 - 当前日期,展示在合同列表和详情页。
  • 证照过期倒计时:证照有效期 - 当前日期,展示在证照列表,小于30天时标红。
  • 入驻进度百分比:根据当前入驻状态在完整入驻流程中的位置计算,展示在入驻申请页。
  • 店铺预览链接:拼接C端店铺页URL(含店铺ID参数),用于店铺配置页的预览功能。

10. 全局页面流转说明

以下表格描述本模块涉及的全部页面路径、入口条件、跳转目标和权限要求。

10.1 平台运营后台页面流转

页面路径所属菜单权限要求入口条件可跳转目标
/merchant/onboarding-audit商家管理-商家入驻审核平台商家运营/管理员无入驻详情页、商家列表页
/merchant/onboarding-detail/:id商家管理-商家入驻审核-详情平台商家运营/管理员从入驻审核列表点击入驻审核列表、商家详情页
/merchant/list商家管理-商家列表平台商家运营/管理员无商家详情页、店铺详情页、合同列表页
/merchant/detail/:id商家管理-商家列表-详情平台商家运营/管理员从商家列表点击商家列表、编辑商家资料、店铺详情、合同列表
/merchant/category-level商家管理-经营类别与等级平台商家运营/管理员无商家详情页(调整等级时)
/merchant/shop-detail/:id商家管理-商家店铺平台商家运营/管理员从商家详情或商家列表点击商家详情页
/merchant/shop-config/:id商家管理-店铺可视化配置平台商家运营/管理员从店铺详情页点击店铺详情页
/merchant/contract-template商家管理-合同模板平台运营管理员无合同模板编辑页
/merchant/contract-template-edit/:id商家管理-合同模板-编辑平台运营管理员从合同模板列表点击合同模板列表、合同模板预览
/merchant/contract-list商家管理-商家合同平台商家运营/管理员无合同详情页、商家详情页
/merchant/contract-detail/:id商家管理-商家合同-详情平台商家运营/管理员从合同列表点击合同列表

10.2 供应商后台页面流转

页面路径所属菜单权限要求入口条件可跳转目标
/supplier/onboarding商家管理-入驻申请未入驻状态新供应商首次访问后台入驻成功页
/supplier/profile商家管理-商家资料供应商管理员/运营已激活状态证照上传页、合同列表页
/supplier/profile-edit商家管理-商家资料-编辑供应商管理员从商家资料页点击编辑商家资料页
/supplier/shop商家管理-店铺管理供应商管理员/运营已激活状态店铺展示配置页
/supplier/shop-config商家管理-店铺管理-展示配置供应商管理员从店铺管理页点击店铺管理页、店铺预览页
/supplier/shop-preview店铺预览(弹窗/新标签页)供应商管理员从店铺配置页点击预览店铺配置页
/supplier/certificate商家管理-证照管理供应商管理员/运营已激活状态证照上传页
/supplier/contract商家管理-合同续签供应商管理员/运营已激活状态合同详情页、续签申请页
/supplier/contract-renew/:id商家管理-合同续签-申请供应商管理员从合同列表点击续签合同列表页

10.3 分销商后台页面流转

页面路径所属菜单适用分销商类型权限要求入口条件
/distributor/onboarding商家管理-入驻申请全部未入驻状态新分销商首次访问后台
/distributor/profile商家管理-商家资料全部已激活状态无
/distributor/profile-edit商家管理-商家资料-编辑全部已激活状态+管理员权限从商家资料页点击编辑
/distributor/shop商家管理-店铺管理个人/B端(OTA不显示)已激活状态无
/distributor/shop-config商家管理-店铺管理-展示配置个人/B端(OTA不显示)已激活状态+管理员权限从店铺管理页点击
/distributor/certificate商家管理-证照管理全部已激活状态无
/distributor/contract商家管理-合同续签全部已激活状态无

10.4 跨后台协作页面流转

协作场景发起方接收方页面流转
B端分销商入驻-供应商初审B端分销商后台供应商后台分销商提交申请 → 供应商后台"分销商审核"菜单收到待办 → 供应商点击审核 → 审核结果同步回分销商后台
合同续签-平台审核供应商/分销商后台平台运营后台商家提交续签申请 → 平台后台"商家合同"菜单收到待办 → 运营点击审核 → 审核结果同步回商家后台
商家资料变更-平台审核供应商/分销商后台平台运营后台商家修改关键字段并提交 → 平台后台"商家列表"该商家标记"资料变更待审" → 运营审核 → 审核结果同步回商家后台

11. 数据模型

11.1 实体关系图(ER图)

erDiagram
    MERCHANT ||--o| SHOP : has
    MERCHANT ||--o{ CERTIFICATE : owns
    MERCHANT ||--o{ CONTRACT : signs
    MERCHANT ||--|| MERCHANT_AUDIT_LOG : generates
    SHOP ||--o{ SHOP_BANNER : contains
    SHOP ||--o{ SHOP_RECOMMEND : contains
    CONTRACT }o--|| CONTRACT_TEMPLATE : based_on

    MERCHANT {
        bigint id PK
        varchar merchant_type
        varchar merchant_name
        varchar unified_code
        varchar legal_person_name
        varchar legal_person_idcard
        varchar contact_name
        varchar contact_phone
        varchar contact_email
        varchar business_scope
        varchar register_address
        varchar service_phone
        varchar status
        varchar level
        datetime created_at
        datetime updated_at
        bigint created_by
        bigint updated_by
        int version
    }

    SHOP {
        bigint id PK
        bigint merchant_id FK
        varchar shop_name
        varchar shop_logo
        text shop_intro
        varchar service_phone
        varchar business_hours
        varchar address
        varchar status
        datetime created_at
        datetime updated_at
    }

    CERTIFICATE {
        bigint id PK
        bigint merchant_id FK
        varchar cert_type
        varchar cert_name
        varchar file_url
        varchar file_type
        date valid_start
        date valid_end
        varchar status
        varchar audit_remark
        datetime created_at
        datetime updated_at
    }

    CONTRACT {
        bigint id PK
        bigint merchant_id FK
        bigint template_id FK
        varchar contract_type
        varchar contract_no
        varchar sign_status
        date valid_start
        date valid_end
        varchar file_url
        int version
        datetime created_at
        datetime updated_at
    }

    CONTRACT_TEMPLATE {
        bigint id PK
        varchar template_name
        varchar contract_type
        text template_content
        varchar status
        datetime created_at
        datetime updated_at
    }
    
图11-1:商家主体与店铺管理核心实体关系图

11.2 核心数据表结构

11.2.1 商家主体表(t_merchant)

字段名类型必填说明
idBIGINT是主键,自增
merchant_typeVARCHAR(50)是商家身份类型(多选逗号分隔):PLATFORM / SUPPLIER / DISTRIBUTOR。PLATFORM 互斥;SUPPLIER 和 DISTRIBUTOR 可同时选。决定菜单树加载与路由准入
distributor_typeVARCHAR(20)否分销商子类型(单选):INDIVIDUAL / B / OTA,仅 merchant_type 含 DISTRIBUTOR 时填写
supplier_typeVARCHAR(100)否供应商子类型(多选逗号分隔):TICKET / HOTEL / VEHICLE / SPECIALTY / ROUTE,仅 merchant_type 含 SUPPLIER 时填写,决定商品管理菜单与资质要求差异
tenant_idVARCHAR(32)是租户实例ID,ORM层行级数据隔离唯一注入字段,区分同 merchant_type 下的不同租户实例
merchant_nameVARCHAR(100)是商家名称(企业名称或个人姓名),全局唯一
unified_codeVARCHAR(18)否统一社会信用代码,企业类型必填,个人类型为空
legal_person_nameVARCHAR(50)是法人姓名(企业)或本人姓名(个人)
legal_person_idcardVARCHAR(18)是法人身份证号,加密存储(AES-256)
contact_nameVARCHAR(50)是联系人姓名
contact_phoneVARCHAR(11)是联系人手机号,全局唯一
contact_emailVARCHAR(100)否联系人邮箱
business_scopeVARCHAR(500)否经营范围
register_addressVARCHAR(200)否注册地址
service_phoneVARCHAR(20)否客服电话
statusVARCHAR(20)是入驻状态:待提交/审核中/审核通过/审核驳回/待签约/已激活/已停用
levelVARCHAR(2)否商家等级:S/A/B/C/D
onboarding_sourceVARCHAR(20)否入驻来源:PC自主申请/平台邀请/API导入
api_keyVARCHAR(64)否OTA分销商API密钥,哈希存储
api_callback_urlVARCHAR(500)否OTA回调地址
created_atDATETIME是创建时间
updated_atDATETIME是更新时间
created_byBIGINT否创建人ID
updated_byBIGINT否更新人ID
versionINT是乐观锁版本号,默认1

11.2.2 店铺信息表(t_shop)

字段名类型必填说明
idBIGINT是主键,自增
merchant_idBIGINT是外键,关联t_merchant.id
shop_nameVARCHAR(100)是店铺名称,全局唯一
shop_logoVARCHAR(500)否店铺Logo图片URL
shop_introTEXT否店铺简介,最多500字
service_phoneVARCHAR(20)否客服电话
business_hoursVARCHAR(100)否营业时间,如"09:00-18:00"
addressVARCHAR(200)否店铺地址
statusVARCHAR(20)是店铺运营状态:营业中/暂停营业/资料待审核/展示异常
announcementVARCHAR(200)否店铺公告
created_atDATETIME是创建时间
updated_atDATETIME是更新时间

11.2.3 证照信息表(t_certificate)

字段名类型必填说明
idBIGINT是主键,自增
merchant_idBIGINT是外键,关联t_merchant.id
cert_typeVARCHAR(30)是证照类型:营业执照/法人身份证/旅行社经营许可证/开户许可证/OTA平台资质/接口授权书
cert_nameVARCHAR(100)是证照名称
file_urlVARCHAR(500)是证照文件存储URL
file_typeVARCHAR(10)是文件类型:JPG/PNG/PDF
ocr_resultJSON否OCR识别结果JSON(营业执照时存储识别出的字段)
valid_startDATE否证照有效期起始日期
valid_endDATE否证照有效期截止日期
statusVARCHAR(20)是审核状态:待审核/审核通过/审核驳回
audit_remarkVARCHAR(500)否审核备注(驳回原因)
auditor_idBIGINT否审核人ID
audit_timeDATETIME否审核时间
created_atDATETIME是创建时间
updated_atDATETIME是更新时间

11.2.4 合同信息表(t_contract)

字段名类型必填说明
idBIGINT是主键,自增
merchant_idBIGINT是外键,关联t_merchant.id
template_idBIGINT是外键,关联t_contract_template.id
contract_typeVARCHAR(30)是合同类型:供应商入驻合同/平台公共分销协议/供应商专属协议/OTA分销协议
contract_noVARCHAR(50)是合同编号,全局唯一
sign_statusVARCHAR(20)是签署状态:待签署/已签署/已过期/续签中
valid_startDATE是合同生效日期
valid_endDATE是合同到期日期
file_urlVARCHAR(500)否签署后的合同PDF文件URL
versionINT是合同版本号,续签时递增
parent_idBIGINT否父合同ID(续签时指向原合同)
created_atDATETIME是创建时间
updated_atDATETIME是更新时间

11.2.5 合同模板表(t_contract_template)

字段名类型必填说明
idBIGINT是主键,自增
template_nameVARCHAR(100)是模板名称
contract_typeVARCHAR(30)是合同类型
template_contentTEXT是模板内容(HTML格式,含变量占位符)
variablesJSON否模板变量定义JSON数组
statusVARCHAR(20)是状态:启用/停用
created_atDATETIME是创建时间
updated_atDATETIME是更新时间

11.2.6 商家操作审计日志表(t_merchant_audit_log)

字段名类型必填说明
idBIGINT是主键,自增
merchant_idBIGINT是外键,关联t_merchant.id
operation_typeVARCHAR(50)是操作类型:入驻提交/资料修改/店铺修改/证照上传/合同签署/合同续签/商家停用/商家恢复
operation_detailJSON否操作详情JSON(变更前后的字段值)
operator_idBIGINT是操作人ID
operator_nameVARCHAR(50)是操作人姓名
operator_roleVARCHAR(30)是操作人角色
ip_addressVARCHAR(50)否操作IP地址
created_atDATETIME是操作时间

11.3 外键逻辑说明

  • t_shop.merchant_id -> t_merchant.id:每个商家最多拥有一个店铺(1:1关系),商家激活时自动创建默认店铺记录。商家删除时级联删除店铺记录。
  • t_certificate.merchant_id -> t_merchant.id:一个商家可拥有多个证照(1:N关系)。商家删除时级联删除全部证照记录。
  • t_contract.merchant_id -> t_merchant.id:一个商家可签署多个合同(1:N关系),包括历史版本。商家删除时保留合同记录(软删除商家)。
  • t_contract.template_id -> t_contract_template.id:合同基于模板生成(N:1关系)。模板停用不影响已生成的合同。
  • t_merchant_audit_log.merchant_id -> t_merchant.id:操作日志关联商家(N:1关系)。商家删除时保留审计日志。

11.4 索引设计建议

以下索引为建议项,实际由后端团队根据查询场景优化:

  • t_merchant:唯一索引(merchant_name)、唯一索引(contact_phone)、唯一索引(unified_code)、普通索引(tenant_id)、普通索引(merchant_type, status)、普通索引(distributor_type)、普通索引(supplier_type)、普通索引(level)
  • t_shop:唯一索引(shop_name)、普通索引(merchant_id)、普通索引(status)
  • t_certificate:普通索引(merchant_id)、普通索引(cert_type)、普通索引(status)、普通索引(valid_end)
  • t_contract:唯一索引(contract_no)、普通索引(merchant_id)、普通索引(sign_status)、普通索引(valid_end)

6. 功能清单

本模块共17个功能项,按4个子模块分组。每个功能项的描述包含业务目标、核心操作和适用角色。

6.1 入驻管理(5项)

序号功能名称功能描述适用角色优先级
6.1.1供应商入驻申请供应商通过PC端填写企业基本信息、上传营业执照/法人身份证等证照、提交入驻申请。平台运营在后台查看申请资料并进行审核(通过/驳回)。审核通过后,系统自动创建供应商租户、管理员账号和默认角色,供应商可登录后台开展经营。供应商管理员、平台商家运营P0
6.1.2分销商分类入驻支持个人分销商、B端分销商、OTA分销商三种类型的入驻申请。不同类型分销商填写不同的入驻资料表单,系统根据merchant_type字段路由到对应的审核流程。个人分销商简化流程,B端分销商需完整企业资质,OTA分销商需额外提供接口对接信息。个人分销商、B端分销商管理员、OTA分销商管理员、平台商家运营P0
6.1.3B端分销商双审B端分销商提交入驻申请后,系统根据申请时选择的目标供应商,将该申请推送至对应供应商进行初审(通过/驳回/备注)。供应商初审通过后,进入平台运营终审环节。双审均通过后,B端分销商方可签署协议并激活账号。B端分销商管理员、供应商管理员、平台商家运营P0
6.1.4OTA入驻与接口验证OTA分销商提交企业资质和接口对接信息后,平台运营进行资料审核。审核通过后,系统自动发起接口连通性验证(测试商品查询接口和订单创建接口)。接口验证通过后,OTA分销商签署《OTA分销协议》并激活API账号。OTA分销商管理员、平台商家运营P0
6.1.5录入商家平台运营人员在后台手动录入商家信息,适用于线下招商签约后补录、历史数据迁移等场景。选择商家类型后填写基本信息,可选上传证照,提交后直接生成已激活状态的商家账号并自动生成初始密码,通过短信发送给商家联系人。支持批量导入(Excel模板下载→填写→上传→校验→批量创建)。平台运营管理员、平台商家运营P0

6.2 商家档案与资料管理(4项)

序号功能名称功能描述适用角色优先级
6.2.1商家列表与详情平台运营后台提供商家统一列表页,支持按商家类型(供应商/个人/B端/OTA)、入驻状态、经营类别、商家等级等多维度筛选。列表展示商家名称、类型、状态、联系人、入驻时间、经营类别、等级等核心字段。点击可查看商家详情页,包含基本信息、证照信息、店铺信息、合同信息、操作日志等Tab页。平台运营管理员、平台商家运营P0
6.2.2主体资料维护商家入驻后,可在各自后台(供应商后台/分销商后台)维护主体资料,包括企业名称、统一社会信用代码、注册地址、经营范围、法人姓名、法人身份证号、联系人姓名、联系人手机号、联系人邮箱、对公账户信息等。资料修改后需重新提交平台审核(变更审核),审核期间字段锁定。供应商管理员、B端分销商管理员、OTA分销商管理员、个人分销商P0
6.2.3经营类别与等级平台运营根据商家资质核定经营类别(如景区门票、酒店客房、旅游线路、车队服务等),并设置商家的等级(S/A/B/C/D)。商家等级由系统根据交易额、履约率、好评率、投诉率等多维度自动计算,平台运营可手动调整(需填写调整原因并留痕)。经营类别和等级影响商品上架权限和分销佣金比例。平台运营管理员、平台商家运营P1
6.2.4商家标签体系管理平台运营管理商家标签体系,支持标签增删改查、分类分组、批量打标/移标。标签分为系统标签(自动打标,如高交易额、高履约率)和自定义标签(运营手动创建)。每个商家最多20个标签,每个标签最多关联10000个商家。标签用于商家分组运营、筛选查询和数据导出。平台运营管理员、平台商家运营P1

6.3 店铺管理(3项)

序号功能名称功能描述适用角色优先级
6.3.1店铺基础信息维护供应商和B端分销商在后台维护店铺基础信息,包括店铺名称、店铺Logo、店铺简介、客服电话、客服工作时间、店铺地址(选填)、店铺标签(最多5个)。店铺名称在平台范围内唯一,不可重复。店铺基础信息修改后即时生效,无需审核(但平台运营有权在发现违规信息后强制修改或停用店铺)。供应商管理员、B端分销商管理员P0
6.3.2店铺展示配置供应商和B端分销商可配置店铺首页的展示内容,包括轮播图(最多5张,建议尺寸1920x600)、推荐商品(最多8个,从已上架商品中选择)、展示模块排序(轮播图区/推荐商品区/店铺简介区/联系方式区)。配置完成后支持预览效果,确认后发布上线。供应商管理员、B端分销商管理员P1
6.3.3店铺运营状态商家可自主切换店铺运营状态:营业中(正常对外展示和接单)、暂停营业(店铺页面显示"暂停营业"状态,不可下单但可浏览)。平台运营可强制将店铺状态置为"资料待审核"(资料变更审核中)或"展示异常"(发现违规信息)。所有状态变更记录操作日志。供应商管理员、B端分销商管理员、平台运营管理员P1

6.4 证照与合同管理(5项)

序号功能名称功能描述适用角色优先级
6.4.1证照上传与审核商家在后台上传所需证照(如营业执照、法人身份证、旅行社经营许可证等),支持JPG/PNG/PDF格式,单文件不超过10MB。上传后,系统自动调用OCR识别服务提取证照关键信息(如企业名称、统一社会信用代码、有效期等),提取结果与商家填写的资料进行一致性校验。平台运营对证照进行人工审核(通过/驳回),审核结果通知商家。供应商管理员、B端分销商管理员、OTA分销商管理员、个人分销商、平台商家运营P0
6.4.2合同记录管理系统自动记录商家签署的所有合同,包括合同类型(入驻协议/分销协议/OTA协议/续签协议)、合同编号、签署时间、有效期、签署状态(待签署/已签署/已过期)、合同附件PDF。平台运营和商家均可查看合同记录列表和详情,支持下载合同PDF。合同到期前30天系统自动发送到期提醒。全部角色P0
6.4.3合同续签合同到期前30天,系统向商家发送续签提醒。商家可在后台发起续签申请,上传最新资质资料。平台运营对续签申请进行二次审核(审核标准与新入驻一致)。审核通过后,商家通过电子签章完成新合同签署。续签合同的合同类型标记为"续签协议",与原合同建立关联关系。供应商管理员、B端分销商管理员、OTA分销商管理员、平台商家运营P0
6.4.4合同模板平台运营在后台管理合同模板,包括模板名称、模板类型、模板内容(富文本编辑器,支持插入变量如{商家名称}、{签署日期}等)、生效状态(启用/停用)。模板修改后,仅影响新发起的合同,已签署的合同不受影响。支持模板预览功能。平台运营管理员、平台商家运营P1
6.4.5到期提醒配置独立的到期提醒配置中心,覆盖证照到期和合同到期两种场景。支持运营自定义提醒规则:提醒时间节点(如到期前30/15/7/3/1天,每个节点可单独开关)、提醒渠道(站内消息/短信/邮件,每节点可配不同渠道组合)、提醒对象(商家联系人/平台对接人/平台负责人)、提醒模板(支持变量占位符)。系统每日凌晨3点扫描全量证照和合同有效期,匹配规则触发通知。提供提醒看板(即将到期列表+一键催办)和提醒统计报表。平台运营管理员、平台商家运营P1

6.5 功能依赖关系

关键依赖说明
  • 入驻管理 → 商家档案:入驻审核通过后,系统自动创建商家档案记录,商家方可查看和维护主体资料。
  • 入驻管理 → 店铺管理:商家账号激活后,系统自动创建默认店铺,商家方可维护店铺信息。
  • 入驻管理 → 证照管理:入驻申请时上传的证照自动同步至证照管理模块。
  • 入驻管理 → 合同管理:入驻审核通过后,系统根据商家类型自动发起对应的合同签署流程。
  • 主体资料维护 → 证照管理:主体资料中的企业名称、统一社会信用代码变更时,需同步更新证照信息或要求商家重新上传证照。
  • 合同模板 → 合同记录:合同签署时,系统根据商家类型匹配对应的合同模板,填充变量后生成合同PDF。

7. 系统架构图

7.1 模块定位

商家主体与店铺管理中心位于云灵汐涉旅电商分销子系统的基础支撑层,是所有业务模块的前置依赖。它为上游角色(平台运营、供应商、分销商)提供商家全生命周期管理能力,为下游模块(供应链、分销、订单、财务)输出标准化的商家主体数据。

7.2 系统架构图

flowchart TB
    subgraph 用户层
        A1[平台运营]
        A2[供应商管理员]
        A3[分销商管理员]
    end

    subgraph 商家主体与店铺管理中心
        B1[入驻管理]
        B2[商家档案与资料]
        B3[店铺管理]
        B4[证照管理]
        B5[合同管理]
    end

    subgraph 外部服务
        C1[电子签章服务]
        C2[OCR识别服务]
        C3[短信/邮件服务]
    end

    subgraph 下游模块
        D1[商品供应链中心]
        D2[分销中心]
        D3[订单履约中心]
        D4[财务结算中心]
        D5[权限中心]
    end

    A1 --> B1 & B2 & B3 & B4 & B5
    A2 --> B2 & B3 & B4 & B5
    A3 --> B2 & B3 & B4 & B5

    B1 --> C1 & C2 & C3
    B5 --> C1 & C3
    B4 --> C2

    B1 --> D5
    B2 --> D1 & D2 & D3 & D4
    B3 --> D3
    B5 --> D2
    
图7-1:商家主体与店铺管理中心系统架构图

7.3 核心服务划分

服务职责核心接口
入驻服务处理各类商家的入驻申请、审核流程、状态流转提交入驻申请、查询入驻进度、审核入驻申请、激活商家账号
商家档案服务维护商家主体资料、经营类别、商家等级查询商家档案、更新主体资料、变更审核、等级调整
店铺服务管理店铺基础信息、展示配置、运营状态查询店铺信息、更新店铺信息、配置展示内容、切换运营状态
证照服务管理证照上传、OCR识别、审核、到期提醒上传证照、OCR识别、审核证照、查询证照列表、到期预警
合同服务管理合同模板、合同签署、合同续签、合同记录查询合同模板、生成合同、签署合同、续签申请、查询合同记录

8. 核心业务流程图

8.1 供应商入驻全流程

flowchart TD
    Start([开始]) --> F1[填写入驻资料]
    F1 --> F2[上传证照]
    F2 --> F3{资料完整性校验}
    F3 -->|不通过| F4[提示补充资料]
    F4 --> F1
    F3 -->|通过| F5[提交入驻申请]
    F5 --> F6[状态: 审核中]
    F6 --> F7[平台运营审核]
    F7 --> F8{审核结果}
    F8 -->|驳回| F9[填写驳回原因]
    F9 --> F10[状态: 审核驳回]
    F10 --> F11[商家修改资料]
    F11 --> F5
    F8 -->|通过| F12[状态: 审核通过]
    F12 --> F13[生成合同]
    F13 --> F14[电子签章签署]
    F14 --> F15{签署完成}
    F15 -->|未完成| F16[提醒签署]
    F16 --> F14
    F15 -->|已完成| F17[状态: 已激活]
    F17 --> F18[创建管理员账号]
    F18 --> F19[开通店铺]
    F19 --> End([结束])
    
图8-1:供应商入驻全流程

8.2 B端分销商入驻全流程(含双审)

flowchart TD
    Start([开始]) --> G1[填写入驻资料]
    G1 --> G2[选择目标供应商]
    G2 --> G3[上传证照]
    G3 --> G4{资料完整性校验}
    G4 -->|不通过| G5[提示补充资料]
    G5 --> G1
    G4 -->|通过| G6[提交入驻申请]
    G6 --> G7[状态: 供应商初审中]
    G7 --> G8[供应商初审]
    G8 --> G9{初审结果}
    G9 -->|驳回| G10[填写驳回原因]
    G10 --> G11[状态: 初审驳回]
    G11 --> G12[商家修改资料]
    G12 --> G6
    G9 -->|通过| G13[状态: 平台终审中]
    G13 --> G14[平台运营终审]
    G14 --> G15{终审结果}
    G15 -->|驳回| G16[填写驳回原因]
    G16 --> G17[状态: 终审驳回]
    G17 --> G12
    G15 -->|通过| G18[状态: 审核通过]
    G18 --> G19[签署《平台公共分销协议》]
    G19 --> G20{是否签署专属协议}
    G20 -->|是| G21[向目标供应商申请]
    G21 --> G22[供应商审核专属协议]
    G22 --> G23{审核结果}
    G23 -->|驳回| G24[状态: 专属协议驳回]
    G24 --> G25[重新申请或放弃]
    G25 --> G20
    G23 -->|通过| G26[签署《供应商专属分销协议》]
    G26 --> G27[状态: 已激活]
    G20 -->|否| G27
    G27 --> G28[创建管理员账号]
    G28 --> G29[开通店铺]
    G29 --> End([结束])
    
图8-2:B端分销商入驻全流程(双审机制)

8.3 合同续签全流程

flowchart TD
    Start([合同到期前30天]) --> H1[系统发送续签提醒]
    H1 --> H2{商家是否发起续签}
    H2 -->|否| H3[到期前15天再次提醒]
    H3 --> H4{商家是否发起续签}
    H4 -->|否| H5[到期前7天最终提醒]
    H5 --> H6{商家是否发起续签}
    H6 -->|否| H7[合同过期]
    H7 --> H8[商家状态: 合同过期]
    H8 --> H9[暂停业务权限]
    H2 -->|是| H10[商家提交续签申请]
    H4 -->|是| H10
    H6 -->|是| H10
    H10 --> H11[上传最新证照]
    H11 --> H12[状态: 续签审核中]
    H12 --> H13[平台运营二次审核]
    H13 --> H14{审核结果}
    H14 -->|驳回| H15[填写驳回原因]
    H15 --> H16[状态: 续签驳回]
    H16 --> H17[商家修改资料]
    H17 --> H10
    H14 -->|通过| H18[状态: 续签审核通过]
    H18 --> H19[生成新合同]
    H19 --> H20[电子签章签署]
    H20 --> H21{签署完成}
    H21 -->|未完成| H22[提醒签署]
    H22 --> H20
    H21 -->|已完成| H23[合同状态: 已生效]
    H23 --> H24[恢复业务权限]
    H24 --> End([结束])
    
图8-3:合同续签全流程

8.4 商家主体资料变更流程

flowchart TD
    Start([开始]) --> I1[商家编辑主体资料]
    I1 --> I2{是否修改核心字段}
    I2 -->|否| I3[保存变更]
    I3 --> I4[即时生效]
    I4 --> End([结束])
    I2 -->|是| I5[提交变更审核]
    I5 --> I6[状态: 资料变更审核中]
    I6 --> I7[字段锁定不可编辑]
    I7 --> I8[平台运营审核]
    I8 --> I9{审核结果}
    I9 -->|驳回| I10[填写驳回原因]
    I10 --> I11[状态: 变更驳回]
    I11 --> I12[字段解锁]
    I12 --> I1
    I9 -->|通过| I13[状态: 变更通过]
    I13 --> I14[更新档案数据]
    I14 --> I15[同步至下游模块]
    I15 --> I16[记录操作日志]
    I16 --> End
    
图8-4:商家主体资料变更流程

8.5 入驻状态机

stateDiagram-v2
    [*] --> 待提交 : 商家开始填写资料
    待提交 --> 审核中 : 商家提交申请
    审核中 --> 审核通过 : 平台审核通过
    审核中 --> 审核驳回 : 平台审核驳回
    审核驳回 --> 审核中 : 商家修改后重新提交
    审核通过 --> 待签约 : 生成合同
    待签约 --> 已激活 : 完成电子签章
    待签约 --> 审核驳回 : 签约超时/拒绝
    已激活 --> 已停用 : 平台停用/商家主动退出
    已停用 --> 已激活 : 平台重新启用
    已停用 --> [*] : 商家注销
    
图8-5:入驻状态机

9. 全局通用规则

9.1 通用交互规则

规则编号规则内容适用场景
INT-01所有表单提交前必须进行前端必填项校验,校验不通过时定位至第一个错误字段并显示错误提示全部表单
INT-02提交操作必须提供二次确认弹窗,确认后才执行后端请求,防止误操作审核通过/驳回、停启用、状态切换
INT-03列表页筛选条件变更后,自动触发查询,无需点击"搜索"按钮商家列表、合同列表、证照列表
INT-04表格支持点击表头排序,默认按创建时间降序排列全部列表页
INT-05分页组件固定在表格底部,每页默认20条,可选10/20/50/100条全部列表页
INT-06页面加载超过3秒未返回数据时,显示加载占位骨架屏;超过10秒显示"加载超时,请刷新重试"全部页面
INT-07图片上传支持拖拽和点击两种方式,上传过程中显示进度条,上传失败显示具体错误原因证照上传、Logo上传、轮播图上传
INT-08状态变更操作后,系统自动发送站内消息通知相关方(审核结果、合同到期提醒等)审核、合同、状态变更

9.2 通用业务规则

规则编号规则内容适用场景
BIZ-01商家名称(企业名称/店铺名称)在平台范围内唯一,提交时进行唯一性校验入驻申请、店铺信息维护
BIZ-02统一社会信用代码在平台范围内唯一,提交时进行唯一性校验供应商/B端/OTA入驻
BIZ-03法人身份证号在平台范围内唯一,同一法人最多关联3个商家主体全部入驻类型
BIZ-04入驻申请提交后,商家可在"入驻进度"页面查看当前审核状态和预计完成时间入驻管理
BIZ-05审核驳回后,商家需在7天内完成修改并重新提交,超期未提交自动关闭入驻申请入驻审核
BIZ-06电子签章签署链接有效期为72小时,超期未签署自动失效,需重新生成签署链接合同签署
BIZ-07证照有效期到期前30天、15天、7天分别发送提醒通知(站内消息+短信)证照管理
BIZ-08合同到期前30天、15天、7天分别发送续签提醒(站内消息+邮件)合同管理
BIZ-09商家等级每月1日00:00自动重算,平台运营手动调整的等级有效期至当月月底商家等级
BIZ-10主体资料中的核心字段(企业名称、统一社会信用代码、法人姓名)变更时,必须重新提交审核主体资料维护

9.3 通用异常规则

规则编号异常场景前端表现后端行为处理方案
EXP-01OCR识别失败显示"证照识别失败,请手动填写或重新上传",保留已上传图片记录OCR失败日志,不阻断流程商家手动填写证照信息或重新上传更清晰的图片
EXP-02电子签章服务不可用显示"签署服务暂时不可用,请稍后重试",提供"重试"按钮记录服务异常日志,标记合同状态为"签署异常"系统每5分钟自动重试,连续重试3次失败后通知技术团队
EXP-03商家名称重复输入框下方红色提示"该名称已被使用,请更换"返回唯一性校验失败错误码商家更换名称后重新提交
EXP-04审核期间商家尝试编辑资料编辑按钮置灰,tooltip提示"资料审核中,暂不可编辑"拒绝编辑请求,返回状态冲突错误等待审核完成后再编辑
EXP-05合同签署链接过期打开签署页面时显示"签署链接已过期,请联系平台重新发送"校验链接有效期,过期返回特定错误码商家联系平台运营或系统在后台重新生成签署链接
EXP-06商家被停用后尝试登录登录页面提示"您的账号已被停用,请联系平台客服"登录校验时检查商家状态,已停用拒绝登录平台运营在后台查看停用原因,决定是否重新启用

9.4 字段校验规则汇总

字段名称字段类型是否必填长度/格式校验规则
企业名称文本是2-100字符不能全为数字/符号;平台范围内唯一
统一社会信用代码文本是18位符合GB 32100-2015编码规则;平台范围内唯一
法人姓名文本是2-30字符只能包含中文或英文
法人身份证号文本是18位符合GB 11643-1999校验规则
联系人手机号文本是11位中国大陆手机号格式(1[3-9]开头)
联系人邮箱文本是5-100字符标准邮箱格式
店铺名称文本是2-50字符平台范围内唯一;不能包含违禁词
店铺简介文本否0-500字符不能包含违禁词
客服电话文本是7-20字符手机号或固话格式
对公账户开户行文本是2-100字符——
对公账户账号文本是10-30字符纯数字
证照文件文件是≤10MBJPG/PNG/PDF格式
店铺Logo图片是≤2MBJPG/PNG格式;建议尺寸400x400
轮播图图片否≤5MB/张JPG/PNG格式;建议尺寸1920x600

10. 全局页面流转说明

10.1 平台运营后台页面流转

页面路径所属菜单权限角色入口条件跳转目标
/merchant/onboarding-review商家管理 → 商家入驻审核平台运营管理员、平台商家运营登录平台运营后台审核详情页、商家档案页
/merchant/onboarding-review/:id商家入驻审核 → 审核详情平台运营管理员、平台商家运营从入驻审核列表点击"查看详情"审核操作(通过/驳回)、商家档案页
/merchant/list商家管理 → 商家列表平台运营管理员、平台商家运营登录平台运营后台商家详情页、店铺管理页
/merchant/detail/:id商家列表 → 商家详情平台运营管理员、平台商家运营从商家列表点击"查看详情"编辑商家资料、查看证照、查看合同
/merchant/shop/:id商家管理 → 商家店铺平台运营管理员、平台商家运营从商家详情点击"店铺信息"Tab编辑店铺信息、查看店铺配置
/merchant/shop-config/:id商家店铺 → 店铺可视化配置平台运营管理员、平台商家运营从商家店铺页点击"可视化配置"配置轮播图、推荐商品、预览
/merchant/category-level商家管理 → 经营类别与等级平台运营管理员、平台商家运营登录平台运营后台商家等级调整、经营类别配置
/contract/template合同管理 → 合同模板平台运营管理员、平台商家运营登录平台运营后台模板编辑页、模板预览页
/contract/list合同管理 → 商家合同平台运营管理员、平台商家运营登录平台运营后台合同详情页
/contract/detail/:id商家合同 → 合同详情平台运营管理员、平台商家运营从合同列表点击"查看详情"下载合同PDF
/certificate/list商家管理 → 证照审核平台运营管理员、平台商家运营登录平台运营后台证照详情页
/certificate/detail/:id证照审核 → 证照详情平台运营管理员、平台商家运营从证照列表点击"查看详情"审核证照(通过/驳回)

10.2 供应商后台页面流转

页面路径所属菜单权限角色入口条件跳转目标
/supplier/profile商家管理 → 商家资料供应商管理员、供应商运营登录供应商后台编辑资料页
/supplier/profile/edit商家资料 → 编辑供应商管理员从商家资料页点击"编辑"提交变更审核
/supplier/shop商家管理 → 店铺管理供应商管理员、供应商运营登录供应商后台编辑店铺信息、配置展示
/supplier/shop/edit店铺管理 → 编辑供应商管理员从店铺管理页点击"编辑"保存店铺信息
/supplier/shop/config店铺管理 → 展示配置供应商管理员从店铺管理页点击"展示配置"预览效果、发布上线
/supplier/certificate商家管理 → 证照管理供应商管理员、供应商运营登录供应商后台上传证照、查看审核状态
/supplier/contract商家管理 → 合同续签供应商管理员、供应商运营登录供应商后台查看合同详情、发起续签
/supplier/contract/renew/:id合同续签 → 续签申请供应商管理员从合同列表点击"发起续签"上传资料、提交审核

10.3 分销商后台页面流转

页面路径所属菜单权限角色入口条件跳转目标
/distributor/profile商家管理 → 商家资料分销商管理员、分销商运营登录分销商后台编辑资料页(B端/OTA完整版;个人简化版)
/distributor/shop商家管理 → 店铺管理B端分销商管理员、B端分销商运营登录分销商后台编辑店铺信息、配置展示
/distributor/certificate商家管理 → 证照管理分销商管理员、分销商运营登录分销商后台上传证照、查看审核状态
/distributor/contract商家管理 → 合同续签分销商管理员、分销商运营登录分销商后台查看合同详情、发起续签

10.4 跨后台协作页面流转

flowchart LR
    subgraph 平台运营后台
        P1[商家入驻审核]
        P2[商家列表]
        P3[证照审核]
        P4[合同模板]
        P5[合同列表]
    end
    subgraph 供应商后台
        S1[入驻申请]
        S2[商家资料]
        S3[店铺管理]
        S4[证照上传]
        S5[合同续签]
    end
    subgraph 分销商后台
        D1[入驻申请]
        D2[商家资料]
        D3[店铺管理]
        D4[证照上传]
        D5[合同续签]
    end

    S1 -->|提交申请| P1
    P1 -->|审核结果通知| S1
    S4 -->|提交审核| P3
    P3 -->|审核结果通知| S4
    S5 -->|续签申请| P5
    P5 -->|续签审核结果| S5

    D1 -->|提交申请| P1
    P1 -->|审核结果通知| D1
    D4 -->|提交审核| P3
    P3 -->|审核结果通知| D4
    D5 -->|续签申请| P5
    P5 -->|续签审核结果| D5

    P2 -.->|查看商家档案| S2
    P2 -.->|查看商家档案| D2
    
图10-1:跨后台页面协作流转图

11. 数据模型

11.1 实体关系图(ER图)

erDiagram
    MERCHANT ||--o{ SHOP : "拥有"
    MERCHANT ||--o{ CERTIFICATE : "拥有"
    MERCHANT ||--o{ CONTRACT : "签署"
    MERCHANT ||--o{ ONBOARDING_LOG : "产生"
    MERCHANT ||--o{ MERCHANT_LEVEL_HISTORY : "拥有"
    MERCHANT ||--|| MERCHANT_DETAIL : "扩展"
    CONTRACT ||--o{ CONTRACT_TEMPLATE : "基于"
    CONTRACT ||--o{ CONTRACT_RENEWAL : "续签产生"

    MERCHANT {
        bigint id PK
        varchar merchant_type "PLATFORM/SUPPLIER/DISTRIBUTOR 多选"
        varchar distributor_type "INDIVIDUAL/B/OTA 仅DISTRIBUTOR时"
        varchar supplier_type "TICKET/HOTEL/VEHICLE/SPECIALTY/ROUTE 多选 仅SUPPLIER时"
        varchar tenant_id "租户实例ID 隔离字段"
        varchar merchant_name
        varchar merchant_code "唯一编码"
        varchar status "入驻状态"
        varchar shop_status "店铺运营状态"
        varchar level "商家等级"
        datetime created_at
        datetime updated_at
        bigint created_by
    }

    MERCHANT_DETAIL {
        bigint id PK
        bigint merchant_id FK
        varchar unified_code "统一社会信用代码"
        varchar legal_name "法人姓名"
        varchar legal_idcard "法人身份证号"
        varchar contact_name
        varchar contact_phone
        varchar contact_email
        varchar registered_address
        varchar business_scope
        varchar bank_name
        varchar bank_account
        datetime created_at
        datetime updated_at
    }

    SHOP {
        bigint id PK
        bigint merchant_id FK
        varchar shop_name
        varchar shop_logo
        varchar shop_intro
        varchar service_phone
        varchar service_hours
        varchar shop_address
        jsonb display_config "展示配置JSON"
        varchar operating_status
        datetime created_at
        datetime updated_at
    }

    CERTIFICATE {
        bigint id PK
        bigint merchant_id FK
        varchar cert_type "证照类型"
        varchar cert_name "证照名称"
        varchar file_url "文件地址"
        varchar ocr_result "OCR识别结果JSON"
        varchar verify_status "审核状态"
        date valid_start
        date valid_end
        varchar reject_reason
        bigint reviewer_id
        datetime reviewed_at
        datetime created_at
    }

    CONTRACT {
        bigint id PK
        bigint merchant_id FK
        bigint template_id FK
        varchar contract_type "合同类型"
        varchar contract_no "合同编号"
        varchar status "合同状态"
        date sign_date
        date valid_start
        date valid_end
        varchar sign_url "签署链接"
        varchar file_url "合同PDF"
        bigint signed_by
        datetime created_at
        datetime updated_at
    }

    CONTRACT_TEMPLATE {
        bigint id PK
        varchar template_name
        varchar template_type
        text template_content
        jsonb variables "变量定义JSON"
        varchar status "启用/停用"
        datetime created_at
        datetime updated_at
    }

    ONBOARDING_LOG {
        bigint id PK
        bigint merchant_id FK
        varchar action_type "操作类型"
        varchar from_status
        varchar to_status
        varchar remark
        bigint operator_id
        datetime created_at
    }
    
图11-1:商家主体与店铺管理核心ER图

11.2 核心数据表结构

11.2.1 商家主表(t_merchant)

商家主表记录平台所有商家的核心信息,是其他所有商家相关表的根表。

字段名类型是否必填说明
idBIGINT是主键,自增
merchant_typeVARCHAR(50)是商家身份类型(多选逗号分隔):PLATFORM / SUPPLIER / DISTRIBUTOR。PLATFORM 互斥;SUPPLIER 和 DISTRIBUTOR 可同时选(如 SUPPLIER,DISTRIBUTOR)。与权限中心 PRD 对齐
distributor_typeVARCHAR(20)否分销商子类型(单选):INDIVIDUAL / B / OTA,仅 merchant_type 含 DISTRIBUTOR 时填写,决定分销商菜单树与结算模式
supplier_typeVARCHAR(100)否供应商子类型(多选逗号分隔):TICKET / HOTEL / VEHICLE / SPECIALTY / ROUTE,仅 merchant_type 含 SUPPLIER 时填写,决定商品管理菜单、资质要求、订单品类筛选(详见权限PRD 5C.1A)
tenant_idVARCHAR(32)是租户实例ID,ORM层行级隔离唯一注入字段
merchant_nameVARCHAR(100)是商家名称(企业名称/个人姓名),平台范围内唯一
merchant_codeVARCHAR(32)是商家编码,系统自动生成(格式:M + 年月日 + 4位流水号)
statusVARCHAR(20)是入驻状态:待提交、审核中、审核通过、审核驳回、待签约、已激活、已停用
shop_statusVARCHAR(20)否店铺运营状态:营业中、暂停营业、资料待审核、展示异常;此字段为前端计算态,不入库,由店铺表operating_status字段映射
levelVARCHAR(10)否商家等级:S、A、B、C、D,默认C
business_categoryVARCHAR(200)否经营类别(自由文本),记录商家营业执照上的经营范围描述。结构化品类选择见 supplier_type 字段
parent_merchant_idBIGINT否上级商家ID,用于关联分销商与其绑定的供应商(B端分销商双审时填充)
is_deletedTINYINT是是否删除:0=否,1=是,逻辑删除
created_atDATETIME是创建时间
updated_atDATETIME是更新时间
created_byBIGINT否创建人ID

11.2.2 商家详情扩展表(t_merchant_detail)

存储商家的详细主体资料,与主表一对一关系,分离存储是为了减少主表字段数量并支持资料版本管理。

字段名类型是否必填说明
idBIGINT是主键,自增
merchant_idBIGINT是外键,关联t_merchant.id
unified_codeVARCHAR(18)否统一社会信用代码,企业类型必填
legal_nameVARCHAR(30)是法人姓名/个人姓名
legal_idcardVARCHAR(18)是法人身份证号/个人身份证号,加密存储(AES-256)
contact_nameVARCHAR(30)是联系人姓名
contact_phoneVARCHAR(11)是联系人手机号
contact_emailVARCHAR(100)是联系人邮箱
registered_addressVARCHAR(200)否注册地址
business_scopeVARCHAR(500)否经营范围
bank_nameVARCHAR(100)否对公账户开户行,企业类型必填
bank_accountVARCHAR(30)否对公账户账号,企业类型必填,加密存储
bank_account_nameVARCHAR(100)否对公账户开户名
versionINT是资料版本号,每次变更审核通过后+1
created_atDATETIME是创建时间
updated_atDATETIME是更新时间

11.2.3 店铺表(t_shop)

字段名类型是否必填说明
idBIGINT是主键,自增
merchant_idBIGINT是外键,关联t_merchant.id,唯一
shop_nameVARCHAR(50)是店铺名称,平台范围内唯一
shop_logoVARCHAR(500)是店铺Logo图片URL
shop_introVARCHAR(500)否店铺简介
service_phoneVARCHAR(20)是客服电话
service_hoursVARCHAR(50)否客服工作时间,如"9:00-18:00"
shop_addressVARCHAR(200)否店铺地址
shop_tagsVARCHAR(200)否店铺标签,JSON数组字符串,最多5个
display_configJSON否展示配置JSON,包含轮播图数组、推荐商品数组、模块排序数组
operating_statusVARCHAR(20)是运营状态:营业中、暂停营业、资料待审核、展示异常
created_atDATETIME是创建时间
updated_atDATETIME是更新时间

11.2.4 证照表(t_certificate)

字段名类型是否必填说明
idBIGINT是主键,自增
merchant_idBIGINT是外键,关联t_merchant.id
cert_typeVARCHAR(50)是证照类型:营业执照、法人身份证、旅行社经营许可证、开户许可证、OTA平台资质、接口对接授权书等
cert_nameVARCHAR(100)是证照名称
file_urlVARCHAR(500)是证照文件存储URL
file_sizeINT是文件大小(字节)
ocr_resultJSON否OCR识别结果JSON,包含提取的各字段值
verify_statusVARCHAR(20)是审核状态:待审核、审核通过、审核驳回
valid_startDATE否证照有效期起始日期
valid_endDATE否证照有效期截止日期
reject_reasonVARCHAR(500)否驳回原因
reviewer_idBIGINT否审核人ID
reviewed_atDATETIME否审核时间
created_atDATETIME是创建时间

11.2.5 合同表(t_contract)

字段名类型是否必填说明
idBIGINT是主键,自增
merchant_idBIGINT是外键,关联t_merchant.id
template_idBIGINT是外键,关联t_contract_template.id
parent_contract_idBIGINT否父合同ID,续签合同时关联原合同
contract_typeVARCHAR(50)是合同类型:供应商入驻协议、平台公共分销协议、供应商专属分销协议、OTA分销协议、续签协议
contract_noVARCHAR(50)是合同编号,系统自动生成
statusVARCHAR(20)是合同状态:待签署、签署中、已签署、已过期、已作废
sign_urlVARCHAR(500)否电子签章签署链接
sign_url_expire_atDATETIME否签署链接过期时间,默认生成后72小时
file_urlVARCHAR(500)否签署完成的合同PDF文件URL
sign_dateDATE否实际签署日期
valid_startDATE是合同有效期起始日期
valid_endDATE是合同有效期截止日期
signed_byBIGINT否签署人ID
created_atDATETIME是创建时间
updated_atDATETIME是更新时间

11.2.6 合同模板表(t_contract_template)

字段名类型是否必填说明
idBIGINT是主键,自增
template_nameVARCHAR(100)是模板名称
template_typeVARCHAR(50)是模板类型:供应商入驻协议、平台公共分销协议、供应商专属分销协议、OTA分销协议
template_contentTEXT是模板内容(富文本HTML),支持变量占位符如{merchant_name}、{sign_date}等
variablesJSON否变量定义JSON,描述模板中使用的变量及其数据类型
statusVARCHAR(20)是状态:启用、停用
versionINT是模板版本号
created_atDATETIME是创建时间
updated_atDATETIME是更新时间

11.2.7 入驻操作日志表(t_onboarding_log)

字段名类型是否必填说明
idBIGINT是主键,自增
merchant_idBIGINT是外键,关联t_merchant.id
action_typeVARCHAR(50)是操作类型:提交申请、审核通过、审核驳回、修改资料、签约完成、状态变更等
from_statusVARCHAR(20)否操作前状态
to_statusVARCHAR(20)否操作后状态
remarkVARCHAR(500)否操作备注(如驳回原因)
operator_idBIGINT否操作人ID
operator_typeVARCHAR(20)是操作人类型:SYSTEM/PLATFORM/SUPPLIER/DISTRIBUTOR
created_atDATETIME是创建时间

11.3 外键逻辑说明

外键关系逻辑说明
t_merchant_detail.merchant_id → t_merchant.id一对一关系,每个商家有且仅有一条详情记录。当商家被逻辑删除时,详情记录同步标记删除。
t_shop.merchant_id → t_merchant.id一对一关系,每个商家有且仅有一个店铺。商家账号激活时自动创建默认店铺,店铺名称初始等于商家名称。
t_certificate.merchant_id → t_merchant.id一对多关系,每个商家可上传多张证照。证照审核通过后,关键信息(如有效期)同步至商家档案。
t_contract.merchant_id → t_merchant.id一对多关系,每个商家可签署多份合同(不同类型、不同有效期)。合同到期前触发续签提醒。
t_contract.template_id → t_contract_template.id多对一关系,多份合同可基于同一模板生成。模板修改不影响已签署合同。
t_contract.parent_contract_id → t_contract.id自关联关系,续签产生的新合同关联原合同,建立合同历史链条。
t_onboarding_log.merchant_id → t_merchant.id一对多关系,记录商家全生命周期的所有状态变更和操作行为,支持审计追溯。

11.4 前端计算态声明

前端计算态字段清单(不入库)
字段计算逻辑使用场景
店铺运营状态(shop_status)映射自t_shop.operating_status商家列表页展示
入驻进度百分比根据当前入驻状态计算进度:待提交=10%、审核中=40%、审核通过=70%、待签约=85%、已激活=100%商家端入驻进度页
证照到期天数当前日期 - t_certificate.valid_end证照列表页展示预警状态
合同到期天数当前日期 - t_contract.valid_end合同列表页展示预警状态
商家完整度评分根据必填字段填充率计算:基础资料30% + 证照30% + 店铺20% + 合同20%商家档案页展示

12. 入驻管理功能模块详解

入驻管理是商家生命周期的起点,涵盖四类商家的入驻申请、审核和账号激活流程。本章包含4个功能项的5层级详解。

12.1 供应商入驻申请

12.1.1 核心业务逻辑

  • 触发条件:供应商管理员访问供应商入驻页面,系统检测到当前用户尚未提交入驻申请(t_merchant.status = 待提交 或 无记录)。
  • 处理规则:
    1. 系统检测到 merchant_type 含 SUPPLIER,加载供应商专属入驻表单,表单字段包括:企业名称、统一社会信用代码、法人姓名、法人身份证号、联系人姓名、联系人手机号、联系人邮箱、注册地址、经营范围、对公账户开户行、对公账户账号、对公账户开户名。此外需增加"经营品类选择"步骤:供应商勾选 supplier_type 多选值(TICKET/HOTEL/VEHICLE/SPECIALTY/ROUTE),系统根据所选品类动态展示对应的资质上传要求(详见权限PRD 5C.1A.2),如选了HOTEL则需上传特种行业许可证+消防安全检查合格证+卫生许可证。
    2. 供应商填写资料并上传证照(营业执照、法人身份证正反面),系统调用OCR识别服务自动提取证照信息,并与填写资料进行一致性校验(企业名称、统一社会信用代码、法人姓名、法人身份证号必须完全一致)。
    3. 资料完整性校验通过后,供应商点击"提交入驻申请",系统生成商家记录(status = 审核中),创建入驻操作日志,并发送站内消息和短信通知平台运营。
    4. 平台运营在"商家入驻审核"页面查看申请,进行人工审核(通过/驳回)。审核通过时填写审核意见;审核驳回时填写驳回原因(必填,最少10个字符)。
    5. 审核通过后,系统生成《供应商入驻协议》合同,调用电子签章服务生成签署链接并发送至商家联系人邮箱。商家需在72小时内完成签署。
    6. 签署完成后,系统创建供应商租户、管理员账号(默认角色为"供应商管理员")、默认店铺(店铺名称 = 企业名称),status 更新为"已激活"。
  • 输出结果:供应商账号激活成功,可登录供应商后台开展商品上架、订单管理等经营活动。
  • 特殊情况:审核驳回后商家7天内未重新提交,系统自动关闭入驻申请,商家需重新发起入驻流程。电子签章签署链接72小时过期未签署,系统自动失效,平台运营需重新生成签署链接。

12.1.2 极细交互说明表

页面/组件用户动作系统行为备注
入驻表单页输入企业名称失焦时校验唯一性,若重复显示红色提示"该名称已被使用"平台范围内唯一
入驻表单页输入统一社会信用代码失焦时校验格式(GB 32100-2015)和唯一性18位,含校验码验证
入驻表单页上传营业执照显示上传进度条,上传完成后自动调用OCR识别,3秒内返回识别结果并填充至对应字段支持JPG/PNG/PDF,≤10MB
入驻表单页OCR识别结果与填写不一致在差异字段旁显示黄色警告图标和提示"OCR识别结果与填写内容不一致,请核对"不阻断提交
入驻表单页点击"提交入驻申请"前端校验必填项 → 确认弹窗 → 提交后端 → 显示"提交成功"Toast → 跳转至"入驻进度"页二次确认防误操作
入驻进度页查看进度展示当前状态、审核人、审核时间(如有)、预计完成时间、历史操作记录时间轴前端计算进度百分比
平台审核页点击"审核通过"弹出确认框(含审核意见输入框)→ 确认后状态变更为"审核通过" → 自动生成合同 → 发送签署链接审核意见必填,最少5字符
平台审核页点击"审核驳回"弹出确认框(含驳回原因输入框,最少10字符)→ 确认后状态变更为"审核驳回" → 发送驳回通知至商家驳回原因商家可见
合同签署页打开签署链接校验链接有效期 → 展示合同内容 → 提供"确认签署"按钮链接有效期72小时
合同签署页点击"确认签署"调用电子签章服务 → 签署成功后状态变更为"已激活" → 创建账号和店铺 → 发送激活成功通知签署过程约5-10秒

12.1.3 页面原型

供应商入驻申请表单页原型(供应商端)
供应商入驻申请
企业名称 *
统一社会信用代码 *
法人姓名 *
法人身份证号 *
联系人姓名 *
联系人手机号 *
联系人邮箱 *
营业执照 *
营业执照.jpg 已上传
OCR识别成功:企业名称/统一代码/法人姓名已自动填充
法人身份证正反面 *
身份证正面.jpg / 身份证反面.jpg 已上传

12.1.4 状态说明表

状态页面表现触发条件允许操作备注
待提交显示入驻表单,所有字段可编辑,"提交"按钮可点击商家首次访问入驻页面或保存草稿后填写资料、上传证照、保存草稿、提交申请草稿保存后7天有效
审核中显示"入驻进度"页,进度条40%,显示"平台审核中",表单字段锁定商家提交入驻申请后查看进度、查看历史记录平台运营SLA:2小时响应,24小时完成
审核通过显示"入驻进度"页,进度条70%,显示"审核已通过,请签署合同"平台运营审核通过后查看合同、点击签署链接签署链接发送至联系人邮箱
审核驳回显示"入驻进度"页,进度条回退,红色提示驳回原因,"修改资料"按钮可点击平台运营审核驳回后查看驳回原因、修改资料、重新提交7天内未重新提交自动关闭
待签约显示"入驻进度"页,进度条85%,显示"合同待签署",提供签署按钮审核通过后生成合同查看合同、签署合同签署链接72小时有效
已激活显示"入驻成功"页面,提供"进入后台"按钮,进度条100%电子签章签署完成后登录后台、维护资料、管理店铺系统自动创建账号和店铺
已停用登录页提示"账号已停用",商家后台不可访问平台运营停用商家后仅平台运营可重新启用停用原因记录至操作日志

12.1.5 异常处理

flowchart TD
    A[提交入驻申请] --> B{资料校验}
    B -->|通过| C[正常流程]
    B -->|不通过| D[显示校验错误]
    D --> A
    C --> E{OCR识别}
    E -->|成功| F[自动填充]
    E -->|失败| G[提示手动填写]
    G --> H{用户是否继续}
    H -->|是| C
    H -->|否| I[保存草稿]
    C --> J{企业名称重复}
    J -->|是| K[提示更换名称]
    K --> A
    J -->|否| L[提交成功]
    L --> M{审核超时}
    M -->|是| N[自动催单通知运营]
    M -->|否| O[正常审核]
    
图12-1:供应商入驻异常处理流程图
异常场景前端表现后端行为处理方案
企业名称/统一代码重复输入框下方红色提示"已被使用",提交按钮置灰返回唯一性校验错误,不入库商家更换名称/代码后重新提交
OCR识别失败显示警告"识别失败,请手动填写",保留上传图片记录失败日志,不阻断流程商家手动填写或重新上传清晰图片
审核超时(超过24小时)商家端显示"审核中(已超时,已催单)"自动发送催单通知给平台运营平台运营优先处理超时申请
签署链接过期打开链接显示"链接已过期,请联系平台"校验链接有效期,过期返回错误码平台运营重新生成签署链接
电子签章服务异常显示"签署服务暂不可用,请稍后重试"记录异常日志,标记合同状态"签署异常"系统每5分钟自动重试,3次失败后通知技术团队
驳回后超7天未重新提交显示"入驻申请已关闭,请重新申请"自动关闭申请,清除商家草稿数据商家重新填写资料发起入驻

12.2 分销商分类入驻

12.2.1 核心业务逻辑

  • 触发条件:分销商访问入驻页面,系统根据用户选择的入驻类型(个人/B端/OTA,对应 distributor_type=INDIVIDUAL/B/OTA,merchant_type 统一为 DISTRIBUTOR)加载对应的入驻表单。若商家同时选择供应商身份(merchant_type=SUPPLIER,DISTRIBUTOR),则需同时填写供应商入驻表单+分销商入驻表单。
  • 处理规则:
    1. 个人分销商:表单字段包括姓名、身份证号、手机号、邮箱、银行卡号、开户行。上传身份证正反面。平台单审。
    2. B端分销商:表单字段与供应商入驻类似(企业名称、统一代码、法人信息、联系人信息、对公账户),但需额外选择"目标供应商"(入驻后默认绑定)。上传完整企业证照。供应商初审+平台终审(双审)。
    3. OTA分销商:表单字段包括企业基本信息+接口对接信息(API Key、回调URL、技术联系人)。上传企业资质+接口对接授权书。平台审核+接口验证。
    4. 系统根据 merchant_type + distributor_type 路由到对应的审核流程和合同类型(merchant_type 含 DISTRIBUTOR 时按 distributor_type 区分:INDIVIDUAL=简化单审、B=双审、OTA=审核+接口验证)。
    5. 审核通过后,分销商签署对应协议(个人/B端签《平台公共分销协议》,OTA签《OTA分销协议》),激活账号。
  • 输出结果:分销商账号激活成功,可登录分销商后台开展推广或采购。
  • 特殊情况:B端分销商可选择是否同时申请《供应商专属分销协议》,若选择则需在平台终审通过后,额外向目标供应商发起专属协议申请。

12.2.2 极细交互说明表

页面/组件用户动作系统行为备注
入驻类型选择页选择"个人分销商"加载简化表单,隐藏企业字段,显示个人实名字段个人分销商默认 merchant_type=DISTRIBUTOR, distributor_type=INDIVIDUAL
入驻类型选择页选择"B端分销商"加载完整企业表单,显示"目标供应商"选择器目标供应商从已激活供应商列表中选择
入驻类型选择页选择"OTA分销商"加载企业表单+接口信息表单merchant_type=DISTRIBUTOR, distributor_type=OTA
B端表单页选择"同时申请供应商专属协议"勾选后,在平台终审通过后自动向目标供应商发起专属协议申请可选,默认不勾选
个人分销商表单上传身份证OCR识别姓名和身份证号,与填写内容一致性校验个人分销商只需身份证
全部类型提交入驻申请校验 → 确认弹窗 → 提交 → 生成记录 → 发送通知与个人/B端/OTA的审核人不同
个人分销商进度页查看进度显示平台审核状态,无双审环节进度:审核中=50%、审核通过=75%、待签约=90%
B端分销商进度页查看进度显示供应商初审状态+平台终审状态,双审时间轴初审通过后才进入终审

12.2.3 状态说明表

状态页面表现(个人/B端/OTA)触发条件允许操作
待提交显示对应类型表单,可编辑首次访问或保存草稿填写、上传、保存草稿、提交
审核中个人:进度50%;B端:显示"供应商初审中";OTA:显示"平台审核中"提交申请后查看进度
供应商初审通过B端专属:进度60%,显示"供应商初审已通过,进入平台终审"供应商初审通过后查看进度
审核通过个人:进度75%;B端:进度75%;OTA:进度75%;显示"请签署协议"平台审核通过后查看协议、签署
审核驳回红色提示驳回原因,显示"修改资料"按钮任意审核环节驳回后查看原因、修改、重新提交
待签约显示协议内容和签署按钮/链接审核通过后生成协议查看协议、签署
已激活显示"入驻成功",提供"进入后台"按钮签署完成后登录后台

12.2.4 异常处理

异常场景前端表现后端行为处理方案
B端选择的目标供应商已停用目标供应商下拉框中该选项置灰,hover显示"该供应商已停用"查询供应商状态,已停用的不返回至下拉列表商家选择其他供应商
OTA接口信息格式错误回调URL输入框红色提示"URL格式不正确"正则校验URL格式(需以http://或https://开头)商家修正URL格式
同一手机号已注册其他类型分销商手机号输入框提示"该手机号已注册,请更换或联系客服"校验手机号在全平台商户表中的唯一性商家更换手机号或联系平台处理
双审中供应商初审超时(超过48小时)B端进度页显示"供应商初审超时,已自动转交平台终审"48小时未初审自动通过,进入平台终审平台运营按正常终审流程处理
个人分销商身份证已被使用身份证号输入框提示"该身份证已关联其他账号"校验身份证号在平台的唯一性商家确认是否已有账号,或联系客服

12.3 B端分销商双审

12.3.1 核心业务逻辑

  • 触发条件:B端分销商提交入驻申请,系统检测到 merchant_type 含 DISTRIBUTOR, distributor_type=B 且已选择目标供应商。
  • 处理规则:
    1. B端分销商提交申请后,系统创建入驻记录(status = 供应商初审中),向目标供应商的管理员账号发送初审待办通知(站内消息+短信)。
    2. 目标供应商管理员登录供应商后台,在"分销商入驻审核"页面查看申请资料(企业名称、统一代码、法人信息、联系人信息、证照图片)。
    3. 供应商管理员进行初审:通过(填写初审意见)/ 驳回(填写驳回原因,最少10字符)。初审操作记录至入驻操作日志,操作人类型标记为 SUPPLIER。
    4. 初审通过后,系统自动将申请推送至平台运营终审队列(status = 平台终审中),向平台运营发送终审待办通知。
    5. 平台运营在"商家入驻审核"页面查看申请(含供应商初审意见),进行终审:通过/驳回。
    6. 终审通过后,B端分销商签署《平台公共分销协议》。若申请时勾选了"同时申请供应商专属协议",则额外向目标供应商发起专属协议申请。
    7. 双审全程SLA:供应商初审48小时(超时自动通过),平台终审24小时。
  • 输出结果:双审通过后B端分销商账号激活,获得平台公共分销权和(可选)目标供应商专属分销权。
  • 特殊情况:供应商初审驳回后,B端分销商修改资料重新提交,需重新走完整的双审流程(不保留初审结果)。

12.3.2 极细交互说明表

页面/组件用户动作系统行为备注
供应商后台-分销商入驻审核列表查看列表展示待初审的B端分销商申请,包含申请时间、企业名称、联系人、剩余审核时间(倒计时)按申请时间升序排列
供应商后台-审核详情页查看资料展示分销商填写的全部资料和证照图片,支持放大查看供应商仅可查看,不可编辑
供应商后台-审核详情页点击"初审通过"弹出确认框(含初审意见输入框,最少5字符)→ 确认后状态变更为"平台终审中" → 通知平台运营初审意见平台运营可见
供应商后台-审核详情页点击"初审驳回"弹出确认框(含驳回原因输入框,最少10字符)→ 确认后状态变更为"初审驳回" → 通知分销商驳回原因分销商可见
平台后台-入驻审核列表查看B端申请展示"供应商初审已通过"标签和初审意见,与其他类型申请区分显示B端申请在列表中显示双审标识
平台后台-审核详情页终审操作与供应商初审交互一致,通过/驳回+意见/原因终审为最终审核,通过后直接生成合同
B端分销商进度页查看双审进度时间轴展示:提交申请 → 供应商初审中 → 初审通过/驳回 → 平台终审中 → 终审通过/驳回每个节点显示操作人、时间、意见
B端分销商进度页初审驳回后修改显示驳回原因和"修改资料"按钮,点击后进入编辑模式修改后重新提交,重新走双审

12.3.3 状态说明表

状态页面表现触发条件允许操作
供应商初审中B端进度页显示"等待目标供应商初审",倒计时显示剩余48小时B端提交申请后查看进度、查看已提交资料(只读)
初审通过进度页显示"供应商初审已通过",进入"平台终审中"供应商初审通过后查看进度、查看初审意见
初审驳回进度页红色显示"供应商初审驳回"及驳回原因,提供"修改资料"按钮供应商初审驳回后查看原因、修改资料、重新提交
平台终审中进度页显示"等待平台终审",倒计时显示剩余24小时初审通过后查看进度、查看初审意见
终审通过进度页显示"平台终审已通过",进入"待签约"状态平台终审通过后查看协议、签署
终审驳回进度页红色显示"平台终审驳回"及驳回原因,提供"修改资料"按钮平台终审驳回后查看原因、修改资料、重新提交

12.3.4 异常处理

异常场景前端表现后端行为处理方案
目标供应商管理员未在48小时内初审分销商进度页显示"供应商初审超时,已自动通过"48小时自动通过,状态变更为"平台终审中"进入平台终审流程
目标供应商在初审期间被停用分销商进度页显示"目标供应商状态异常,已转交平台直接审核"检测到供应商停用,跳过初审直接进入平台终审平台运营按正常终审处理
供应商初审通过后目标供应商被停用不影响已进入终审的申请,继续走平台终审初审结果保持有效,终审正常进行平台运营正常终审
双审过程中分销商修改目标供应商修改目标供应商视为重新提交,弹窗确认"修改后将重新发起双审"重置审核状态为"供应商初审中",重新发送初审通知分销商确认后重新走双审
平台运营终审时发现供应商初审意见与资料不符平台运营可在终审时选择"退回供应商重新初审"状态回退至"供应商初审中",通知供应商重新审核供应商重新初审

12.4 OTA入驻与接口验证

12.4.1 核心业务逻辑

  • 触发条件:OTA分销商提交入驻申请,系统检测到 merchant_type 含 DISTRIBUTOR, distributor_type=OTA。
  • 处理规则:
    1. OTA分销商填写企业基本信息(同B端)和接口对接信息:API Base URL、API Key、API Secret、回调URL(用于接收订单状态变更通知)、技术联系人姓名和手机号。
    2. 上传企业资质证照(营业执照、OTA平台资质证明、接口对接授权书)。
    3. 提交申请后,平台运营进行资料审核(标准同B端终审)。
    4. 资料审核通过后,系统自动发起接口连通性验证:调用OTA提供的商品查询接口(测试查询1个商品),验证返回数据格式是否符合平台标准;调用订单创建接口(创建测试订单并立即取消),验证订单流程是否通畅。
    5. 接口验证通过后,系统生成《OTA分销协议》,OTA分销商完成电子签章。
    6. 签署完成后,系统创建OTA分销商租户、API账号(生成平台侧的API Key和Secret供OTA调用)、回调URL配置。
  • 输出结果:OTA分销商获得API接入能力,可通过接口同步商品和回传订单。
  • 特殊情况:接口验证失败时,系统向OTA技术联系人发送详细的错误报告(含请求参数、返回结果、错误原因),OTA修复后可在入驻进度页点击"重新验证"。

12.4.2 极细交互说明表

页面/组件用户动作系统行为备注
OTA入驻表单-接口信息输入API Base URL失焦时校验URL格式,必须以https://开头仅支持HTTPS
OTA入驻表单-接口信息输入API Key校验长度(32-64字符)和格式(字母数字组合)由OTA平台生成
OTA入驻表单-接口信息输入回调URL校验URL格式,必须与API Base URL不同域名时给出警告用于接收平台推送
平台审核页资料审核通过状态变更为"接口验证中",系统自动发起接口连通性测试无需人工触发验证
OTA进度页查看验证进度显示"接口验证中"及当前验证步骤(商品查询/订单创建)验证过程约30-60秒
OTA进度页接口验证失败显示失败原因和详细错误报告,提供"重新验证"按钮错误报告包含请求/响应详情
OTA进度页点击"重新验证"重新发起接口连通性测试,显示"验证中"状态每天最多重试5次
OTA后台查看API账号签署完成后,在"接口管理"页面展示平台分配的API Key、Secret、接口文档链接B端/个人分销商不显示此页面

12.4.3 状态说明表

状态页面表现触发条件允许操作
审核中显示"平台审核中",同其他类型提交申请后查看进度
审核通过显示"资料审核通过,正在进行接口验证"平台资料审核通过后查看进度、查看验证日志
接口验证中显示验证进度条和当前步骤系统自动发起验证后查看进度(不可操作)
接口验证通过显示"接口验证通过,请签署协议"商品查询和订单创建均验证通过后查看协议、签署
接口验证失败红色显示"接口验证失败",展示错误详情和"重新验证"按钮任一接口验证失败后查看错误报告、重新验证
待签约显示《OTA分销协议》和签署按钮接口验证通过后查看协议、签署
已激活显示"接入成功",展示API账号和接口文档签署完成后查看API信息、下载接口文档

12.4.4 异常处理

异常场景前端表现后端行为处理方案
商品查询接口超时(超过10秒)进度页显示"商品查询接口超时,请检查服务可用性"记录超时日志,返回验证失败OTA检查服务状态,修复后重新验证
返回数据格式不符合标准显示"返回数据格式错误,请对照接口文档调整",展示具体字段差异对比返回JSON与标准Schema,输出差异报告OTA按接口文档调整返回格式
订单创建接口返回错误码显示"订单创建失败:{具体错误码和错误信息}"记录完整请求和响应,便于排查OTA根据错误码排查问题
重新验证超过5次/天"重新验证"按钮置灰,tooltip显示"今日验证次数已用完,请明日再试"限制每日验证次数,防止滥用OTA次日再试或联系平台技术支持
接口验证期间OTA修改了接口信息提示"接口信息已变更,需重新提交审核"检测到接口信息与审核时不一致,要求重新走资料审核OTA确认信息后重新提交

12.5 录入商家 P0

功能定位

运营后台手动录入商家。与线上入驻流程不同,录入商家是平台运营人员在后台直接创建商家账号的方式,适用于线下招商、批量导入、历史数据迁移等场景。录入商家跳过入驻审核流程,直接生成"已激活"状态的商家账号;合同可后续补签。

12.5.1 核心业务逻辑

触发条件

平台运营人员在后台"商家管理 > 录入商家"页面手动创建商家,或通过"批量导入"入口上传Excel批量创建。

适用场景:线下招商签约后补录、历史数据迁移、批量导入、合作伙伴紧急开通。

录入流程:

  1. 选择商家类型(供应商 / 个人分销商 / B端分销商 / OTA)→ 不同类型对应不同的字段配置与证照要求
  2. 填写基本信息(企业名称、统一社会信用代码、法人、联系人、手机号等)
  3. 上传证照(可选,可后续补充;B端分销商与供应商推荐上传营业执照、经营许可证)
  4. 设置初始状态(默认"已激活",可手动调整为"待激活")
  5. 生成商家账号 → 系统自动生成商家编号和初始登录密码,通过短信发送给商家联系人
与线上入驻的核心区别
对比维度 线上入驻 录入商家
发起方 商家自助提交申请 平台运营人员后台创建
审核流程 需经过资质审核、风控审核、合同签署 跳过审核,直接生成账号
初始状态 待审核 → 待签约 → 已激活 默认已激活(可手动设为待激活)
合同签署 入驻流程内完成线上签约 可后续补签,录入时不强制
账号生成 商家自助设置密码 系统生成初始密码,短信下发
适用场景 线上自助入驻 线下招商补录、数据迁移、批量导入
业务规则
  • 唯一性校验:企业名称、统一社会信用代码在系统内全局唯一,重复则阻止创建。
  • 手机号唯一性:联系人手机号作为登录账号,不可与已有商家账号重复;同一手机号不可绑定多个商家主体。
  • 商家编号生成规则:按类型前缀 + 年月日 + 4位流水号生成,例如供应商 SUP-20260730-0001、个人分销商 PER-20260730-0001、B端分销商 BDS-20260730-0001、OTA OTA-20260730-0001。
  • 初始密码规则:系统随机生成8位密码(含大小写字母+数字),首次登录强制修改。
  • 短信通知:创建成功后通过短信网关向联系人手机号下发账号、密码、登录地址;短信发送失败不影响账号创建,可手动重发。
  • 批量导入:支持Excel模板下载 → 填写 → 上传 → 校验 → 预览 → 确认导入;单次导入上限1000条。
  • 审计日志:录入操作(含批量导入)全程记录审计日志,包含操作人、操作时间、商家编号、字段变更明细。
  • 录入后完善:商家可自行登录后台修改密码并完善资料(银行账户、结算信息、详细证照等)。
权限要求

仅"商家管理-录入"权限的运营人员可操作;批量导入需额外具备"批量导入"权限。所有录入操作均记录操作人、时间、IP,可追溯。

12.5.2 交互说明

序号 交互节点 触发方式 交互行为描述 系统响应/校验规则
1 进入录入页面 点击菜单"商家管理 > 录入商家" 打开录入表单页,默认展示"单个录入"Tab,商家类型选择卡片置空,表单字段全部为空,底部展示"重置"和"提交创建"按钮。 校验用户是否具备"商家管理-录入"权限;无权限则提示"无操作权限"并阻止进入。
2 选择商家类型 点击类型选择卡片(供应商/个人分销商/B端分销商/OTA) 选中后卡片高亮,下方表单动态加载对应字段配置。切换类型时若已填写内容,弹窗确认"切换将清空已填内容,是否继续?"。 不同类型字段差异:个人分销商无需统一社会信用代码与法人,仅需姓名+身份证号+手机号;供应商/B端分销商/OTA需企业名称、信用代码、法人、联系人等完整企业信息。
3 填写基本信息 输入框失焦/提交时 逐项填写企业名称、统一社会信用代码(个人分销商为身份证号)、法人姓名、联系人、联系人手机号、联系邮箱、所在地区、详细地址、主营品类等。必填项标注红色"*"。 失焦实时校验:手机号格式(11位数字)、邮箱格式、信用代码格式(18位)、身份证号格式(18位且校验位正确)。地区联动选择(省-市-区)。
4 唯一性校验 企业名称/信用代码输入框失焦 输入框失焦时异步校验企业名称与统一社会信用代码是否已存在,校验中显示loading,结果实时反馈在输入框下方。 调用后端校验接口;若已存在,输入框标红并提示"该企业名称已存在,请确认或前往商家列表查看";信用代码重复提示"该统一社会信用代码已被商家[编号]占用"。
5 上传证照(可选) 点击上传区/拖拽文件 支持上传营业执照、经营许可证、法人身份证等证照图片或PDF;点击对应证照项的上传区选择文件或直接拖拽上传。上传后展示文件名、大小、预览缩略图,支持删除和替换。证照为可选项,可标记"后续补充"。 限制:单文件≤10MB,格式JPG/PNG/PDF;上传中显示进度条;上传完成调用OCR自动识别(营业执照可回填企业名称、信用代码、法人,需用户确认)。
6 设置初始密码 切换"密码设置方式" 提供两种方式:①系统自动生成(默认,勾选后展示生成的8位密码,可点击刷新重新生成);②手动设置(需输入8-20位含大小写字母+数字的密码并二次确认)。同时提供"初始状态"下拉:已激活(默认)/待激活。 手动设置时实时校验密码强度与两次输入一致性;自动生成密码符合复杂度规则(大小写字母+数字,8位)。
7 提交创建 点击"提交创建"按钮 点击后前端先做必填项与格式校验,通过后弹窗二次确认"确认录入该商家?提交后将生成商家账号并通过短信下发登录信息",确认后按钮置loading并禁用,提交后端。 后端再次校验唯一性与字段合法性;创建成功生成商家编号、初始密码,写入审计日志;失败则返回错误信息并保留表单已填内容。
8 生成商家编号+发送短信 提交成功后 页面跳转至"录入成功"结果页,展示商家编号、登录账号(手机号)、初始密码(明文,提示复制保存)、商家类型、初始状态。结果页提供"继续录入""查看商家详情""重发短信"三个操作。 异步触发短信通知(内容含商家编号、账号、初始密码、登录地址);短信发送状态在结果页显示(成功/失败),失败可手动重发。
9 批量导入入口 切换至"批量导入"Tab 展示批量导入页:顶部"下载导入模板"按钮,中部文件上传区(支持拖拽),底部导入说明(字段要求、注意事项)。上传Excel后进入校验流程。 模板为系统预置标准Excel,含字段:商家类型、企业名称、信用代码、法人、联系人、手机号、邮箱、地区、地址、主营品类。校验文件格式(.xlsx/.xls,≤5MB)。
10 导入校验与预览 上传文件后自动校验 校验完成后展示预览表:每行一条数据,列含行号、商家类型、企业名称、手机号、校验结果(通过/失败)、失败原因。顶部统计"共X条,成功Y条,失败Z条"。失败行标红高亮。提供"仅导入成功数据""下载失败数据""确认导入"按钮。 逐行校验:必填项、格式、唯一性(企业名称/信用代码/手机号在本次导入内及系统内均不可重复)。单次上限1000条,超出提示分批导入。
11 导入结果展示 点击"确认导入"后 导入执行完成后展示结果汇总页:成功条数、失败条数、已生成商家编号列表(可复制)、失败明细(可下载Excel)。提供"返回列表""继续导入"操作。 批量创建为事务性操作,单条失败不影响其他成功条目;每条成功记录独立生成商家编号并发送短信;生成导入批次号并写入审计日志。
12 重置表单 点击"重置"按钮 弹窗确认"确认重置?已填内容将被清空",确认后清空所有表单字段与已上传证照,保留商家类型选择。 仅清空未提交数据,不影响已创建的商家。

12.5.3 原型

原型1:单个录入表单页

商家管理 / 录入商家
单个录入 批量导入
商家类型 *
供应商
提供旅游产品资源
个人分销商
自然人分销
B端分销商
企业分销渠道
OTA
在线旅游平台
基本信息
企业名称 *
请输入企业全称
该企业名称已存在,请确认
统一社会信用代码 *
请输入18位信用代码
法定代表人 *
请输入法人姓名
主营品类 *
请选择主营品类
联系人 *
请输入联系人姓名
联系人手机号 *
作为登录账号,请输入11位手机号
联系邮箱
请输入邮箱(选填)
所在地区 *
省 - 市 - 区
详细地址
请输入详细地址
证照上传(可选,可后续补充)
+ 营业执照
JPG/PNG/PDF ≤10MB
+ 经营许可证
JPG/PNG/PDF ≤10MB
+ 法人身份证
JPG/PNG/PDF ≤10MB
账号设置
密码设置方式
初始密码 aB3kM9xQ 刷新 首次登录强制修改
初始状态 已激活 下拉可选:已激活 / 待激活
重置 提交创建

原型2:批量导入页

商家管理 / 录入商家 / 批量导入
单个录入 批量导入
导入说明
  • 请先下载标准模板,按模板字段填写,勿修改表头顺序与名称。
  • 单次导入上限1000条;企业名称、信用代码、手机号须系统内唯一。
  • 商家类型填写:供应商/B端分销商/OTA/个人分销商(需与选项文字一致)。
  • 导入后系统自动生成商家编号并通过短信下发账号信息。
下载导入模板 最新模板版本 v2.1,更新于 2026-07-15
将Excel文件拖拽到此处,或点击选择文件
支持 .xlsx / .xls 格式,文件≤5MB
已上传: 商家批量导入_20260730.xlsx (128KB,共 56 条) 重新上传
校验结果预览
共 56 条 成功 53 条 失败 3 条
行号 商家类型 企业名称 联系人手机号 校验结果 失败原因
1 供应商 云灵山旅游开发有限公司 138****8888 通过 -
2 B端分销商 环球假期旅行社 139****6666 失败 统一社会信用代码格式错误(不足18位)
3 个人分销商 张三 137****1234 通过 -
4 供应商 漓江游船运营公司 135****0000 失败 该手机号已被商家 SUP-20260720-0012 占用
... (其余数据已折叠)
下载失败数据 仅导入成功数据(53) 确认导入

原型3:录入成功结果页

录入成功
✓
商家录入成功
账号信息已通过短信发送至联系人手机号
商家编号
SUP-20260730-0001
商家类型
供应商
企业名称
云灵山旅游开发有限公司
登录账号
138****8888(联系人手机号)
初始密码
aB3kM9xQ 请复制保存,首次登录需修改
初始状态
已激活
短信状态
已发送 重发
查看商家详情 继续录入 返回商家列表

12.5.4 状态说明

状态 状态标识 状态说明 进入条件 可执行操作
录入中(草稿态) 录入中 运营人员正在填写录入表单但尚未提交。仅在当前会话有效,关闭或刷新页面后草稿不保留(不持久化)。 进入录入页面开始填写 继续填写、提交创建、重置
已录入 已录入 商家账号已创建成功,商家编号已生成,初始密码已生成,短信已触发下发。此为创建瞬间的瞬时态,随后转为待激活或已激活。 提交创建后端处理成功 查看详情、重发短信、停用
待激活 待激活 商家账号已生成但商家尚未首次登录。运营在录入时手动选择"待激活"初始状态,或短信未送达导致商家未登录。账号可用但商家端未激活。 录入时初始状态选择"待激活",或商家未完成首次登录 查看详情、重发短信、编辑、停用、手动激活
已激活 已激活 商家已首次登录后台并完成密码修改,可正常使用商家端全部功能。此为录入商家默认初始状态(运营未手动调整时)。 录入时初始状态为"已激活"且商家完成首次登录改密,或由"待激活"转为已激活 查看详情、编辑、停用、重置密码
已停用 已停用 运营手动停用商家账号,商家无法登录后台,相关在售商品下架。停用为可逆操作,可重新启用恢复。 运营在商家列表或详情页点击"停用" 查看详情、启用、编辑
录入失败 录入失败 提交创建时校验不通过(唯一性冲突、必填缺失、格式错误等),商家账号未生成。前端保留表单已填内容并提示错误,不产生数据记录。 提交时后端校验未通过 修改后重新提交、重置
批量导入中 导入中 批量导入任务正在执行,展示导入进度。该状态为导入批次维度的状态,非单个商家状态。 点击"确认导入"后任务开始执行 查看进度(不可中断)
批量导入完成 导入完成 批量导入任务执行结束,展示成功/失败条数与明细。成功的商家各自进入"已录入"后续流转,失败的可在失败明细中查看原因并下载。 导入任务执行完毕 查看结果、下载失败数据、继续导入
状态流转说明

正常流转:录入中 → 已录入 → 已激活(默认)

手动待激活:录入中 → 已录入 → 待激活 → 已激活(商家首次登录改密后)

停用流转:已激活/待激活 → 已停用 → 启用后恢复原状态

异常流转:录入中 → 录入失败(不生成记录,回到录入中继续修改)

12.5.5 异常处理

异常场景 触发条件 处理方式 用户提示与后续操作
企业名称/信用代码重复 输入框失焦校验或提交时后端校验,发现企业名称或统一社会信用代码已被其他商家占用 前端失焦时异步查询并实时标红提示;提交时后端二次校验,若重复则拒绝创建并返回已占用商家编号。保留表单已填内容。 提示"该企业名称/信用代码已被商家[编号]占用,请确认或前往商家列表查看"。运营可修改名称/代码,或前往列表核查是否为同一主体。
手机号格式错误或已被使用 手机号格式不合法(非11位、非数字),或该手机号已绑定其他商家账号 前端失焦校验格式,格式错误标红提示;提交时后端校验唯一性,若已被使用则拒绝创建。 格式错误提示"请输入正确的11位手机号";已被使用提示"该手机号已被商家[编号]使用,请更换或核查"。运营需更换手机号或联系原商家处理。
批量导入Excel格式错误 上传文件非.xlsx/.xls格式,或文件超过5MB,或文件内容表头与模板不符 前端拦截非合规文件,不上传后端;表头不符在校验阶段整体判失败,不进入逐行校验。 提示"文件格式不支持,请使用标准模板"或"文件大小超限"或"表头与模板不符,请下载最新模板重新填写"。需重新下载模板填写。
批量导入部分行校验失败 Excel内部分行存在必填缺失、格式错误、唯一性冲突(含本次导入内重复及系统内重复) 逐行校验并标记结果,失败行标红展示失败原因;允许"仅导入成功数据"或"下载失败数据修改后重新导入"。单条失败不影响其他成功行。 预览表顶部统计成功/失败条数,失败行展示具体原因。运营可选择仅导入成功行,或下载失败数据修正后重新导入。
证照上传失败 文件超过10MB、格式不支持、网络中断或存储服务异常 前端校验大小与格式,超限直接拦截;上传中网络中断自动重试1次,仍失败则标记上传失败并保留其他已上传证照。证照为可选项,不影响提交创建。 提示"文件超过10MB"或"格式不支持"或"上传失败,请重试"。运营可重新上传或跳过证照后续补充(标记"后续补充")。
短信发送失败 商家账号创建成功,但短信网关下发失败(手机号空号、停机、网关异常等) 账号创建与短信发送解耦:账号创建成功即落库,短信异步发送;发送失败记录失败状态,不影响商家账号有效性。结果页展示短信发送状态,支持手动重发。 结果页/详情页提示"短信发送失败",提供"重发短信"按钮。重发仍失败建议运营电话通知商家并手动提供账号信息,或核实手机号是否正确。
提交创建接口超时/异常 点击"提交创建"后后端接口超时或返回500错误 按钮恢复可点击,保留表单已填内容;提示网络异常并建议重试。后端需保证提交接口幂等(基于企业名称+信用代码唯一约束防止重复创建)。 提示"网络异常,请重试"。运营可重新点击提交;若担心重复,可先前往商家列表搜索企业名称确认是否已创建。
批量导入数量超限 上传Excel数据条数超过1000条上限 校验阶段拦截,不进入预览,提示分批导入。 提示"单次导入上限1000条,当前共X条,请分批导入"。运营需拆分Excel后多次导入。
无操作权限 用户无"商家管理-录入"或"批量导入"权限 菜单与入口隐藏;直接访问URL时后端返回403,前端跳转无权限提示页。 提示"您无操作权限,请联系管理员开通"。需联系系统管理员分配相应权限角色。
补充说明
  • 幂等性设计:提交创建接口基于"企业名称+统一社会信用代码"唯一索引保证幂等,重复提交不会创建多个商家。
  • 批量导入事务策略:采用逐条独立事务而非整体事务,单条失败回滚单条,成功条目正常落库,避免因个别失败导致整批回滚。
  • 数据回滚:录入创建为即时生效操作,暂不支持撤销;如需撤销已创建商家,通过"停用"或联系管理员处理(不提供物理删除,保留审计痕迹)。
  • 并发控制:同一企业名称/信用代码若被两个运营人员同时录入,后提交者将被唯一性校验拦截,提示已被占用。

13. 商家档案与资料管理功能模块详解

商家档案与资料管理是平台运营对全量商家进行信息维护、查询、变更和分级管理的核心模块。本章包含3个功能项的5层级详解。

13.1 商家列表与详情查询

13.1.1 核心业务逻辑

  • 触发条件:平台运营人员访问"商家管理 > 商家列表"页面,系统加载全量商家数据。
  • 处理规则:
    1. 列表默认展示全部商家(供应商+B端分销商+个人分销商+OTA),按创建时间倒序排列,每页20条,支持分页和跳页。
    2. 查询条件包括:商家名称(模糊匹配)、统一社会信用代码/身份证号(精确匹配)、商家类型(下拉:全部/供应商/B端分销商/个人分销商/OTA)、状态(下拉:全部/已激活/审核中/已停用/已关闭)、经营类别(多选)、入驻时间范围(日期范围选择器)、所属店铺数量范围。
    3. 列表字段包括:商家ID、商家名称、商家类型、联系人/手机号、状态、入驻时间、最近修改时间、所属店铺数、操作列(查看详情/编辑/停用/启用)。
    4. 点击"查看详情"进入商家详情页,展示商家完整资料:基本信息(名称、类型、统一代码、法人、注册地址)、联系信息(联系人、手机号、邮箱)、经营信息(经营类别、等级、主营业务)、财务信息(对公账户/银行卡信息,脱敏显示)、关联店铺列表(可跳转)、历史操作日志(时间轴形式)。
    5. 商家详情页提供"编辑资料"入口(跳转至编辑页)和"操作记录"标签页(展示该商家的全部人工和系统操作记录,支持按操作类型筛选)。
    6. 列表和详情页的数据权限:平台运营可见全部商家;供应商管理员仅可见自身商家档案;分销商仅可见自身档案。
  • 输出结果:平台运营可高效检索、浏览和深入了解任意商家的完整档案信息。
  • 特殊情况:商家数量超过10万时,列表采用异步加载+虚拟滚动;模糊搜索统一社会信用代码时,若输入长度≥6位才触发后端搜索,避免全表扫描。

13.1.2 极细交互说明表

页面/组件用户动作系统行为备注
商家列表页进入页面默认加载第1页,展示最近创建的20条商家记录,显示总条数和加载耗时列表加载时间≤800ms
商家列表页-搜索输入商家名称关键字输入完成后500ms防抖触发模糊搜索,结果实时刷新列表支持拼音首字母搜索
商家列表页-筛选选择"商家类型=供应商"列表实时过滤,仅展示供应商,页码重置为1多条件组合筛选,AND逻辑
商家列表页-筛选选择"状态=已停用"已停用商家名称显示灰色,操作列仅显示"启用"按钮视觉区分不同状态
商家列表页点击"查看详情"新开标签页或抽屉展开(宽度800px),展示商家完整档案抽屉内支持左右滑动切换上一个/下一个商家
商家详情-基本信息查看统一社会信用代码默认脱敏显示(9153****XXXX),点击"显示完整"后展示完整号码,操作记录至日志敏感信息安全展示
商家详情-财务信息查看银行卡号仅展示后4位(****8888),点击"显示完整"需二次确认并记录审计日志满足财务信息安全合规
商家详情-关联店铺点击店铺名称跳转至店铺详情页(新标签页),展示该店铺的完整信息店铺页面包屑显示商家名称
商家详情-操作记录切换至操作记录标签加载该商家的全部操作日志,按时间倒序,支持按操作人、操作类型筛选操作类型包括:资料修改、状态变更、合同签署等
商家列表页点击"导出"弹出导出配置弹窗(选择字段、导出格式Excel/CSV)→ 提交后异步生成文件 → 站内消息通知下载单次导出上限10万条

13.1.3 页面原型

商家列表页原型(平台运营端)
商家ID商家名称类型联系人/手机状态入驻时间操作
M100001云南大理风花雪月旅行社供应商李四 / 138****8000已激活2024-01-15详情 编辑
M100002北京环球之旅科技B端分销商王五 / 139****9000已激活2024-02-20详情 编辑
M100003张三(个人)个人分销商张三 / 137****7000审核中2024-03-01详情
共 3,256 条 第 1/163 页

13.1.4 状态说明表

状态页面表现触发条件允许操作备注
已激活名称正常黑色显示,操作列显示"详情/编辑/停用"入驻审核通过且签署完成查看详情、编辑资料、停用、管理店铺正常经营状态
审核中名称显示为灰色斜体,操作列仅显示"详情"提交入驻申请后、审核完成前仅查看详情不可编辑和停用
待签约名称正常显示,操作列显示"详情/催签"审核通过、电子签章未完成查看详情、发送催签通知平台运营可手动催签
已停用名称灰色显示,行背景浅灰,操作列仅显示"详情/启用"平台运营手动停用或违规自动停用查看详情、启用停用期间不可登录后台
已关闭名称深灰色删除线,操作列仅显示"详情"商家主动注销或长期未经营自动关闭仅查看详情数据保留180天后归档
冻结中名称橙色显示,操作列显示"详情/解冻"触发风控规则(如投诉率过高)查看详情、解冻(需审批)资金结算暂停

13.1.5 异常处理

异常场景前端表现后端行为处理方案
列表加载超时(>3秒)显示骨架屏3秒后转"加载中"动画,5秒后提示"数据加载较慢,请稍后"后端优化查询索引,超过5秒返回部分数据+继续加载提示运营稍后刷新,技术团队监控慢查询
导出数据量超过10万条弹窗提示"数据量过大,请缩小筛选范围后重试"校验导出条数,超限返回错误码运营增加筛选条件缩小范围
商家详情页关联店铺数量过多(>100)店铺列表默认展示前20条,提供"加载更多"按钮分页加载店铺列表独立接口分页查询,不随详情一次性返回运营按需加载更多店铺
查询统一社会信用代码输入过短(<6位)输入框下方提示"请输入至少6位字符以触发搜索"前端拦截,不发起后端请求运营继续输入完整代码
商家资料查看时商家被其他运营修改抽屉顶部显示黄色提示"该商家资料已被修改,点击刷新查看最新数据"返回数据时携带version字段,前端对比本地version与返回version运营点击刷新获取最新数据
同时大量运营访问商家列表正常展示,无感知接口启用限流(每IP 100次/分钟),超限返回429超限后前端提示"请求过于频繁,请稍后"

13.2 商家主体资料维护

13.2.1 核心业务逻辑

  • 触发条件:平台运营在商家详情页点击"编辑资料",或商家管理员在自身后台"账号设置 > 主体资料"页面点击"修改资料"。
  • 处理规则:
    1. 系统根据当前用户角色判断编辑权限:平台运营可编辑全部字段;商家管理员仅可编辑非核心字段(核心字段包括:企业名称、统一社会信用代码、法人姓名、法人身份证号,修改需平台运营审核)。
    2. 编辑页面分区块展示:基本信息(名称、类型、统一代码)、法人信息(姓名、身份证号)、联系信息(联系人、手机号、邮箱)、经营信息(注册地址、经营范围)、财务信息(开户行、账号)。
    3. 商家管理员修改核心字段时,系统提示"修改核心资料需平台审核",提交后生成"资料变更申请"(status = 待审核),原资料保持不变,新资料存入变更记录表待审核。
    4. 平台运营审核资料变更:通过则更新主表资料,记录变更日志;驳回则保留原资料,通知商家驳回原因。
    5. 修改联系人手机号时,需对新手机号进行短信验证码校验(6位数字验证码,5分钟有效),防止账号被恶意接管。
    6. 所有资料修改操作记录至商家操作日志,包含修改前值、修改后值、修改人、修改时间、修改原因(如填写)。
  • 输出结果:商家档案信息得到及时、安全、可审计的维护更新。
  • 特殊情况:企业名称变更(如公司更名)需提供工商变更证明,平台运营审核时校验证明文件真实性与变更记录一致性。

13.2.2 极细交互说明表

页面/组件用户动作系统行为备注
资料编辑页进入编辑页加载当前商家资料,核心字段旁显示"修改需审核"标签,非核心字段可直接编辑不同角色加载的字段可编辑性不同
资料编辑页修改企业名称(商家端)输入框失焦时校验唯一性,点击保存时弹窗提示"修改核心资料需平台审核,确认提交?"提交后进入待审核状态
资料编辑页修改联系人手机号显示"获取验证码"按钮,点击后发送短信验证码,输入框校验6位数字验证码5分钟有效,每天最多5条
资料编辑页点击"保存"前端校验必填项 → 二次确认弹窗(平台端直接保存,商家端显示审核提示)→ 提交后端 → Toast提示平台端保存即时生效
资料编辑页点击"取消"检测是否有未保存修改 → 有则提示"有未保存的修改,确定离开?" → 确定后返回详情页防止误操作丢失修改
平台审核页-资料变更查看待审核变更展示变更字段对比(左侧原值红色删除线,右侧新值绿色高亮),显示变更原因和证明文件差异可视化,便于快速审核
平台审核页-资料变更点击"审核通过"确认弹窗 → 更新主表 → 记录变更日志 → 通知商家"资料已更新"变更即时生效
平台审核页-资料变更点击"审核驳回"确认弹窗(含驳回原因输入框,最少10字符)→ 保留原值 → 通知商家驳回原因商家可重新提交变更
商家端-资料变更记录查看历史变更展示该商家的全部历史变更记录,每条记录显示变更字段、原值、新值、审核状态、审核意见仅商家管理员可见自身记录

13.2.3 页面原型

商家资料编辑页原型(平台运营端)
基本信息
企业名称 *
统一社会信用代码 *
法人姓名 *
联系信息
联系人姓名 *
联系人手机号 *

13.2.4 状态说明表

状态页面表现触发条件允许操作备注
正常资料页显示当前生效资料,无待审核提示无待审核变更或变更已审核通过编辑资料、查看历史默认状态
有待审核变更资料页顶部显示黄色横幅"您有1条资料变更待平台审核",变更字段旁显示"待审核"标签商家提交核心资料变更后查看变更详情、撤回变更(撤回后恢复编辑)商家端可见
变更审核中平台运营端"资料变更审核"列表显示该条记录,状态为"待审核"商家提交变更后审核通过/驳回平台运营端可见
变更已通过资料页显示最新资料,历史记录中该条变更状态为"已通过"平台运营审核通过后正常编辑新资料生效
变更已驳回资料页显示原资料,顶部提示"资料变更被驳回:{原因}",提供"重新修改"入口平台运营审核驳回后查看驳回原因、重新提交变更原资料保持不变
变更已撤回资料页无待审核提示,历史记录中状态为"已撤回"商家在审核前主动撤回正常编辑撤回后可重新编辑提交

13.2.5 异常处理

异常场景前端表现后端行为处理方案
商家端同时提交多条资料变更若前一条变更仍在审核中,"保存"按钮置灰,提示"您有资料变更正在审核中,请等待审核完成后再提交"校验该商家是否存在status=待审核的变更记录,存在则拒绝新提交商家等待审核完成或撤回后重提
手机号验证码错误超过3次验证码输入框红色提示"验证码错误(3/3),请重新获取",按钮置灰60秒记录错误次数,超限后使当前验证码失效商家60秒后重新获取验证码
平台运营审核时发现证明文件与变更内容不符审核页显示红色警告"证明文件与变更内容不一致"不自动拦截,由运营人工判断,可驳回并填写原因运营驳回并要求商家补充正确证明
商家修改企业名称后与其他商家重复输入框失焦时红色提示"该名称已被使用"校验企业名称唯一性,重复返回错误商家更换名称或联系平台处理
资料修改过程中商家账号被停用提交时提示"您的账号已被停用,无法提交修改",跳转至登录页提交接口校验商家状态,已停用拒绝提交商家联系平台运营了解停用原因
平台运营修改资料时商家正在编辑运营保存时系统提示"该商家资料正在被其他用户修改,请刷新后重试"使用乐观锁(version字段)防止并发修改冲突运营刷新页面获取最新数据后重试

13.3 经营类别与等级管理

13.3.1 核心业务逻辑

  • 触发条件:平台运营在商家详情页编辑"经营类别"和"商家等级"字段,或系统在商家入驻审核通过后自动设置默认类别和等级。
  • 处理规则:
    1. 经营类别采用平台预设的三级类目体系(如:旅游服务 > 跟团游 > 国内跟团游;旅游服务 > 门票 > 景区门票),商家可关联多个三级类目(最少1个,最多10个)。
    2. 商家等级分为五级:普通、铜牌、银牌、金牌、钻石。等级由平台运营手动评定,或根据系统规则自动升降(如:月销售额≥100万自动升金牌,连续3个月投诉率>5%自动降一级)。
    3. 不同等级对应不同权益:普通-基础佣金比例;铜牌-佣金优惠5%;银牌-佣金优惠10%+优先展示;金牌-佣金优惠15%+专属客服;钻石-佣金优惠20%+专属运营+活动优先权。
    4. 平台运营修改商家等级时,需填写等级变更原因(最少5字符),变更记录存入商家等级历史表,权益变更次月1日生效(避免月中变更导致结算混乱)。
    5. 经营类别变更即时生效,影响商家在商品发布时的可选类目范围和分销商搜索时的类目筛选匹配。
    6. 商家等级在商家后台首页展示(等级徽章),在分销商选择供应商时作为筛选条件和排序权重因子。
  • 输出结果:商家按经营类别精准归类,按等级享受差异化权益,平台实现分层运营。
  • 特殊情况:商家连续6个月无订单,系统自动标记为"沉寂商家",等级保持不变但暂停部分权益,商家重新下单后自动恢复。

13.3.2 极细交互说明表

页面/组件用户动作系统行为备注
商家编辑页-经营类别点击"选择经营类别"弹出三级类目选择器,左侧一级类目、中间二级类目、右侧三级类目,支持多选(最多10个)已选类目以标签形式展示在输入框下方
三级类目选择器勾选三级类目该三级类目添加到已选列表,已选数量实时显示"已选3/10"超过10个时提示"最多选择10个经营类别"
三级类目选择器点击已选标签的"×"移除该三级类目,已选数量减1至少保留1个,移除最后一个时提示"至少选择1个经营类别"
商家编辑页-商家等级点击等级下拉框展示五级选项:普通/铜牌/银牌/金牌/钻石,每个选项旁显示对应权益简介默认当前等级高亮
商家编辑页-商家等级选择新等级弹出变更确认框,要求填写"等级变更原因"(最少5字符),显示"权益将于次月1日生效"提示防止误操作
商家详情页查看等级信息展示当前等级徽章、生效日期、历史等级变更记录(时间轴)商家后台首页也展示等级徽章
商家列表页筛选等级支持按等级筛选商家,可多选(如:金牌+钻石)筛选条件持久化至URL参数
商家后台首页查看等级徽章展示当前等级图标和名称,hover显示当前等级全部权益说明激励商家提升等级
平台运营-等级规则配置配置自动升降级规则提供规则编辑器,设置销售额阈值、投诉率阈值、连续月份等条件,支持启用/禁用单条规则仅平台超级管理员可配置

13.3.3 页面原型

经营类别与等级编辑原型(平台运营端)
经营类别 * 已选 3/10
旅游服务 > 跟团游 > 国内跟团游 × 旅游服务 > 门票 > 景区门票 × 旅游服务 > 酒店 > 度假酒店 ×
商家等级
银牌权益:佣金优惠10%、搜索优先展示、专属客服通道

13.3.4 状态说明表

等级状态页面表现触发条件权益生效备注
普通灰色徽章,无特殊标识新入驻商家默认等级或降级后基础佣金比例无特殊权益
铜牌铜色徽章,商家后台显示"铜牌商家"平台运营手动调整或达到铜牌自动规则佣金优惠5%次月1日生效
银牌银色徽章,搜索列表显示"银牌"标签平台运营手动调整或达到银牌自动规则佣金优惠10%+优先展示次月1日生效
金牌金色徽章,搜索列表显示"金牌"标签,优先排序平台运营手动调整或达到金牌自动规则佣金优惠15%+专属客服次月1日生效
钻石钻石徽章,搜索列表置顶展示"钻石商家"横幅平台运营手动调整或达到钻石自动规则佣金优惠20%+专属运营+活动优先权次月1日生效
等级变更中徽章旁显示"(次月1日生效)"灰色小字等级已修改但未到生效日期仍按原等级权益执行变更记录中显示"待生效"

13.3.5 异常处理

异常场景前端表现后端行为处理方案
商家经营类别与已发布商品类目冲突移除某类目时提示"该商家已发布X个此类目商品,移除后商品将下架,确认继续?"校验该类目下是否有上架商品,有则提示风险运营确认后移除类目并自动下架冲突商品
自动降级时商家当月已享受高等级优惠商家后台显示"您的等级将于次月调整为{新等级}",本月仍按原等级结算结算系统读取等级生效日期,按生效前等级计算本月佣金系统自动处理,无需人工干预
平台运营手动将钻石商家降级为普通弹出强确认框"钻石商家降级为普通将立即取消其专属运营和全部优惠,确认?",需二次确认记录重大变更审计日志,发送通知给商家和平台负责人运营确认后次月生效
经营类目体系更新(平台新增/删除类目)已删除类目在商家资料中显示为红色"[已失效]原类目名称",提示"请重新选择有效类目"保留历史关联关系但标记失效,不强制立即修改运营逐步引导商家更新类目,30天后强制要求更新
商家等级规则配置冲突规则配置页提示"当前规则存在冲突:规则A和规则B条件重叠",保存按钮置灰保存前校验规则集合是否存在条件重叠,存在则拒绝保存管理员调整规则条件消除冲突后保存
等级批量调整时部分商家状态异常批量操作结果页显示"成功95家,失败5家(原因:2家已停用、3家已关闭)"逐条校验商家状态,已停用/已关闭的跳过并记录失败原因运营对失败商家单独处理

13.4 商家标签体系管理 P1 商家管理 > 标签管理
功能概述

平台运营人员在"商家管理 > 标签管理"页面维护商家标签体系,支持标签的增删改查、分类分组、批量打标/移标。标签用于商家分组运营、列表筛选查询、差异化策略下发等场景。系统标签基于交易额、履约率、评价等维度自动计算打标,每日凌晨更新;自定义标签由运营手动创建并打标。每个商家最多持有 20 个标签(含系统标签),每个标签最多关联 10000 个商家。

13.4.1 核心业务逻辑

触发条件:平台运营人员登录管理后台,进入"商家管理 > 标签管理"页面,对商家标签体系进行维护操作。该页面仅对拥有"标签管理-查看"及以上权限的角色可见。

标签分类体系:标签按生成方式分为两大类——系统标签与自定义标签。系统标签由平台预置,基于交易额、履约率、评价等业务维度自动计算打标,每日凌晨 02:00 执行全量计算并更新;运营不可删除系统标签,但可调整规则阈值和颜色排序。自定义标签由运营人员手动创建,支持创建、编辑、停用、删除全生命周期管理;删除自定义标签时自动解除与所有商家的关联关系,关联解除操作记入操作日志。

标签属性字段:

字段名称 类型 必填 规则说明
标签名称 文本 是 2-20 字符,同一平台内不允许重复,支持中英文数字
标签编码 文本 是 2-30 字符,仅支持大写字母、数字、下划线,全局唯一,创建后不可修改
标签分类 枚举 是 运营标签 / 风控标签 / 招商标签,创建后不可修改
颜色标识 枚举 是 8 种预设色:红#F5222D、橙#FA8C16、金#FAAD14、绿#52C41A、青#13C2C2、蓝#1890FF、紫#722ED1、玫红#EB2F96
排序值 整数 是 1-999,值越小越靠前,用于商家详情页标签展示排序
描述 文本 否 最多 100 字符,用于说明标签用途和打标规则
状态 枚举 是 启用 / 停用 / 删除中 / 已删除 / 系统标签-生效中 / 系统标签-已暂停

标签与商家关系:一个商家可拥有多个标签,一个标签可关联多个商家,为多对多关系。系统标签的关联由系统每日自动计算维护,运营手动打标的自定义标签由运营维护。商家详情页按排序值升序展示所有标签,停用状态的标签灰色展示但仍保留。

系统标签规则引擎:系统标签内置规则引擎,支持以下维度的自动打标:

  • 高交易额:近 30 天累计交易额 ≥ [可配置阈值,默认 50 万],每日凌晨重新计算
  • 高履约率:近 30 天订单履约率 ≥ [可配置阈值,默认 95%],每日凌晨重新计算
  • 优质商家:近 90 天平均评分 ≥ [可配置阈值,默认 4.8],每日凌晨重新计算
  • 风险商家:近 30 天退款率 ≥ [可配置阈值,默认 15%] 或投诉次数 ≥ [可配置阈值,默认 3 次],每日凌晨重新计算

运营可在系统标签的"规则配置"弹窗中查看和调整阈值,保存后次日生效。不支持删除系统标签的规则,暂停系统标签即暂停其自动打标。

批量打标/移标:批量打标入口在商家列表页,勾选多个商家后选择标签执行打标;批量移标入口在标签关联商家列表页,勾选多个商家后执行移标。系统标签中由自动打标产生的关联不可手动移除,仅运营手动打标的部分可移除。

标签使用场景:

  • 商家列表筛选:商家列表页筛选栏增加标签多选筛选,支持按标签组合筛选商家(AND 逻辑)
  • 商家详情页展示:商家详情页头部展示该商家所有标签,按排序值排列,点击标签可跳转至该标签的关联商家列表
  • 数据导出:导出商家列表时附带标签信息列,多个标签以逗号分隔
  • 差异化策略:运营可根据标签分组下发差异化策略(如营销活动定向推送、费率调整等)

数量限制:每个商家最多持有 20 个标签(含系统标签和自定义标签),达到上限后不可再新增标签。每个标签最多关联 10000 个商家,达到上限后该标签不可再打标并提示运营。系统标签的自动打标不受 10000 上限约束,但超限后仅保留前 10000 个(按交易额/履约率降序)。

13.4.2 交互说明

序号 交互场景 触发入口 操作步骤 系统响应 约束规则
1 进入标签管理列表页 左侧导航"商家管理 > 标签管理" 点击菜单进入标签管理列表页 默认展示全部状态的标签,按排序值升序、创建时间倒序排列,每页 20 条。页面顶部展示筛选栏(标签名称、标签分类、标签类型、状态)和"新建标签"按钮。 仅"标签管理-查看"权限可见此菜单;无"新建"权限时隐藏新建按钮
2 新建标签 列表页右上角"新建标签"按钮 点击按钮 → 弹出新建标签弹窗 → 填写标签名称、标签编码、标签分类、颜色标识、排序值、描述 → 点击"保存" 前端校验字段格式和必填项 → 提交后端校验名称和编码唯一性 → 校验通过则创建成功,关闭弹窗并刷新列表,新标签默认状态为"启用" → Toast 提示"标签创建成功" 名称 2-20 字符且不重复;编码 2-30 字符仅大写字母/数字/下划线且全局唯一;排序 1-999;同一分类下建议不超过 50 个标签
3 编辑标签 列表页操作列"编辑"按钮 点击编辑 → 弹出编辑弹窗(回填已有数据) → 修改可编辑字段 → 点击"保存" 校验通过后更新标签信息 → 关闭弹窗并刷新列表 → 同步刷新所有已打标商家详情页的标签展示(名称/颜色/排序) → Toast 提示"标签更新成功" 自定义标签可编辑全部字段(编码除外);系统标签仅可编辑颜色标识、排序值和描述,名称/编码/分类不可修改
4 停用/启用标签 列表页操作列"停用"/"启用"按钮 点击"停用" → 弹出二次确认弹窗(提示影响:已关联 N 个商家的标签将灰色展示,不可再打标) → 点击"确认停用" 停用后标签状态变为"停用",已有商家标记保留但灰色展示,不可再对该标签执行打标操作 → Toast 提示"标签已停用"。启用后恢复"启用"状态,可正常打标。系统标签停用即暂停自动打标,状态变为"系统标签-已暂停"。 停用不影响已有关联关系;停用后标签仍出现在商家详情页(灰色);启用后恢复所有功能
5 删除标签 列表页操作列"删除"按钮 点击删除 → 弹出二次确认弹窗(显示关联商家数 N,提示将解除所有关联) → 在输入框输入"DELETE"确认 → 点击"确认删除" 删除标签及其与所有商家的关联关系 → 操作记录写入日志(含操作人、时间、影响的商家列表) → 刷新列表 → Toast 提示"标签已删除,已解除 N 个商家关联" 系统标签不可删除,操作列无"删除"按钮;自定义标签有关联商家时必须显示影响数量;需输入"DELETE"文字确认
6 查看标签关联商家列表 列表页操作列"查看"按钮或点击"关联商家数"链接 点击 → 跳转至标签关联商家列表页 展示该标签下所有关联商家,包含商家名称、商家编号、打标时间、打标人、打标方式(自动/手动),支持按商家名称搜索和分页(每页 20 条)。页面支持勾选商家执行"批量移标"。 仅展示当前标签的关联商家;自动打标的商家标记"自动"标签且不可移除;手动打标的可勾选移标
7 批量打标 商家列表页勾选多个商家 → 点击"批量打标" 勾选商家(支持跨页勾选) → 点击顶部"批量打标" → 弹出批量打标弹窗(展示已选商家数 + 标签选择区) → 勾选目标标签 → 点击"确认打标" 系统逐个校验商家状态和标签数上限 → 执行打标 → 返回打标结果摘要(成功 N 个,失败 M 个及失败原因列表) → 关闭弹窗并刷新商家列表 已停用/已关闭的商家自动跳过并计入失败;商家标签数达 20 个上限时该商家打标失败;仅可选择"启用"状态的标签;每次最多打标 200 个商家
8 批量移标 标签关联商家列表页勾选多个商家 → 点击"批量移标" 勾选商家 → 点击"批量移标" → 弹出二次确认弹窗(提示将移除 N 个商家的该标签) → 点击"确认移标" 解除选中商家与该标签的关联关系 → 刷新关联商家列表 → Toast 提示"已移除 N 个商家的标签" 系统标签中自动打标产生的关联不可手动移除(勾选框禁用);仅手动打标的关联可移除;每次最多移标 200 个商家
9 系统标签规则配置 系统标签列表行操作列"规则"按钮 点击"规则" → 弹出规则配置弹窗(展示当前规则维度和阈值) → 修改阈值 → 点击"保存规则" 校验阈值合法性 → 保存成功后 Toast 提示"规则已更新,将于明日 02:00 生效" → 记录规则变更日志(含操作人、原值、新值、时间) 交易额阈值范围 1 万-1000 万;履约率范围 0%-100%;评分范围 0-5;退款率范围 0%-100%;不支持删除规则维度;规则变更次日生效
10 标签使用统计 列表页"统计"按钮或标签详情页统计区 点击"统计" → 展开统计面板 → 查看各标签统计数据 展示统计面板:各标签当前关联商家数、近 30 天打标次数、近 30 天移标次数、活跃商家占比(近 30 天有交易的关联商家占比)。支持按分类汇总,支持导出 Excel。 统计数据 T+1 更新(每日凌晨计算前一日数据);统计面板仅"标签管理-统计"权限可见

13.4.3 原型

原型 1:标签列表页 — 筛选栏 + 数据表格 + 分页
标签名称 标签分类 标签类型 状态
序号 标签名称 标签编码 类型 分类 颜色 关联商家 排序 状态 操作
1 高交易额 系统 SYS_HIGH_TRADE 系统 运营标签 126 1 生效中 规则 查看 编辑
2 高履约率 系统 SYS_HIGH_FULFILL 系统 运营标签 203 2 生效中 规则 查看 编辑
3 优质商家 系统 SYS_PREMIUM 系统 运营标签 58 3 生效中 规则 查看 编辑
4 风险商家 系统 SYS_RISK 系统 风控标签 12 4 已暂停 规则 查看 编辑
5 招商重点 自定义 CUS_INVEST_KEY 自定义 招商标签 35 5 启用 查看 编辑 停用 删除
6 黑名单 自定义 CUS_BLACKLIST 自定义 风控标签 8 6 停用 查看 编辑 启用 删除
7 待观察 自定义 CUS_WATCH 自定义 运营标签 17 7 启用 查看 编辑 停用 删除
系统标签 4 个,自定义标签 3 个,共 48 条
1 2 3 每页 20 条 / 共 3 页
原型 2:新建/编辑标签弹窗 — 表单字段 + 颜色选择器 + 操作按钮
* 标签名称
* 标签编码 编码创建后不可修改
* 标签分类 分类创建后不可修改
* 颜色标识
✓
已选:紫色 #722ED1
* 排序值
描述 已输入 32 / 100 字符
原型 3:批量打标弹窗 — 已选商家列表 + 标签选择区 + 确认打标
已选商家(3 个)
商家名称 商家编号 当前标签数 状态
云南携程旅行社 MER20240001 3 / 20 正常
三亚海湾度假酒店 MER20240002 7 / 20 正常
丽江古城客栈联盟 MER20240003 20 / 20 已停用
提示:2 个商家状态正常可打标,1 个商家标签已达上限或状态异常将被跳过
选择标签(仅展示启用状态)
招商重点 关联 35
待观察 关联 17
高交易额 系统 不可手动打标
高履约率 系统 不可手动打标
已选择 1 个标签:招商重点
系统标签由规则引擎自动打标,不支持手动操作
预计成功打标 2 个商家,跳过 1 个(标签达上限 1 个)

13.4.4 状态说明

状态名称 状态标识 适用标签类型 可执行操作 业务表现 状态流转条件
启用 启用 自定义标签 编辑、停用、删除、查看关联商家、批量打标、批量移标 标签正常使用,可在商家列表筛选、商家详情页正常展示(彩色),可执行打标和移标操作 新建标签默认进入此状态;从"停用"状态点击"启用"可恢复
停用 停用 自定义标签 编辑(颜色/排序/描述)、启用、删除、查看关联商家 不可执行打标操作;已有商家标记保留但在商家详情页灰色展示;商家列表筛选中仍可见但标注"已停用" 从"启用"状态点击"停用"并二次确认后进入此状态
删除中 删除中 自定义标签 取消删除(返回停用/启用) 标签处于二次确认删除流程中,等待用户输入"DELETE"确认。此状态下标签不可编辑、不可打标,列表中以"删除中"状态标识 从"启用"或"停用"状态点击"删除"后进入此状态;取消则回退原状态
已删除 已删除 自定义标签 无(仅可在操作日志中查看删除记录) 标签及与所有商家的关联关系全部清除;商家详情页不再展示该标签;列表中不再展示。删除操作及影响的商家列表记入操作日志,保留 180 天 从"删除中"状态输入"DELETE"并确认后进入此状态,不可恢复
系统标签-生效中 生效中 系统标签 规则配置、编辑(颜色/排序/描述)、暂停、查看关联商家 规则引擎每日凌晨自动执行打标计算,自动关联/解除符合条件的商家。商家详情页正常彩色展示该标签,标注"自动"标识 系统标签创建后默认进入此状态;从"已暂停"状态点击"启用"恢复
系统标签-已暂停 已暂停 系统标签 规则配置、编辑(颜色/排序/描述)、启用、查看关联商家、手动移标 暂停自动打标计算,不再每日更新商家关联。已有的商家标记保留并灰色展示。运营可手动移标,但不支持手动打标。恢复后按最新规则重新计算 从"生效中"状态点击"暂停"并二次确认后进入此状态

13.4.5 异常处理

异常场景 触发条件 提示文案 处理逻辑 严重等级
标签名称重复 新建/编辑标签时,输入的名称与已有标签(非已删除状态)重名 "标签名称「XXX」已存在,请修改后重试" 前端失焦时实时校验 + 后端保存时二次校验。校验失败时名称输入框标红高亮,焦点自动定位到该字段,阻止提交。已删除状态的标签名称不参与重复校验,可复用。 P1
标签编码重复 新建标签时,输入的编码与已有标签(含已删除状态)重复 "标签编码「XXX」已被使用,请修改后重试" 前端失焦时实时校验编码格式(大写字母/数字/下划线,2-30 字符)+ 后端保存时校验全局唯一性。编码全局唯一包括已删除的标签,防止历史数据引用混乱。校验失败时编码输入框标红,阻止提交。 P1
删除标签时有关联商家 删除自定义标签时,该标签仍关联 N 个商家(N > 0) "该标签当前关联 {N} 个商家,删除后将自动解除所有关联且不可恢复。请在下方输入 DELETE 确认删除。" 弹窗中显示关联商家数量和前 10 个商家名称预览。要求用户在输入框中手动输入"DELETE"文字后方可点击"确认删除"。删除操作事务性执行:先解除所有关联关系,再删除标签,任一步骤失败则整体回滚。操作记录写入日志。 P0
商家标签数超上限 打标操作时,目标商家已持有 20 个标签(含系统标签和自定义标签) "商家「XXX」标签数已达上限(20 个),请先移除其他标签后再打标" 单商家打标时直接拦截并提示。批量打标时将该商家计入失败列表,在结果摘要中展示失败商家名称及原因,其余商家正常打标。商家详情页标签区域在达到 18 个时展示"即将达上限"提醒,达 20 个时打标按钮置灰。 P1
批量打标时部分商家状态异常 批量打标选中的商家中,包含已停用或已关闭状态的商家 "以下 {N} 个商家状态异常(已停用/已关闭),无法打标,将自动跳过:{商家名称列表}" 批量打标弹窗中实时校验已选商家状态,异常商家的勾选框标红并附原因提示。确认打标时自动跳过异常商家,仅对状态正常的商家执行打标。结果摘要中分别展示成功数和跳过数及明细。若全部商家异常则禁用"确认打标"按钮。 P1
系统标签规则配置值非法 系统标签规则配置时,输入的阈值超出合理范围(如交易额 < 1 万或 > 1000 万、履约率 < 0% 或 > 100%、评分 < 0 或 > 5) "阈值「{字段名}」取值范围为 {最小值}-{最大值},请修改后重试" 前端输入时实时校验范围,超出范围时输入框标红并展示范围提示。后端保存时二次校验。阈值保存后不立即生效,记录到规则变更日志,次日凌晨 02:00 按新阈值执行自动打标计算。若新阈值导致关联商家数超过 10000 上限,仅保留排名前 10000 的商家。 P2
标签关联商家数达上限 打标操作时,目标标签已关联 10000 个商家 "标签「XXX」关联商家数已达上限(10000 个),无法继续打标" 单商家打标时直接拦截并提示。批量打标时整体拦截该标签的打标操作,提示运营该标签已达上限。系统标签的自动打标不受此限制,但超限后仅保留前 10000 个(按对应维度降序)。运营可在标签管理列表中查看关联商家数,接近上限时(> 9500)展示预警标识。 P2

14. 店铺管理功能模块详解

店铺是商家在平台上开展经营的载体,一个商家可拥有多个店铺(如供应商可按目的地或品牌开设多店铺)。本章包含3个功能项的5层级详解。

14.1 店铺列表与详情查询

14.1.1 核心业务逻辑

  • 触发条件:平台运营访问"商家管理 > 店铺列表",或供应商管理员访问"店铺管理 > 我的店铺"。
  • 处理规则:
    1. 平台运营端展示全量店铺列表,字段包括:店铺ID、店铺名称、所属商家(可跳转商家详情)、店铺类型(直营/加盟/代销)、经营状态、创建时间、商品数量、最近上架时间、操作列。
    2. 供应商后台端仅展示当前商家旗下的店铺列表,字段与平台端一致但隐藏"所属商家"列,增加"设为默认店铺"操作。
    3. 查询条件:店铺名称(模糊)、所属商家(平台端,下拉选择)、店铺类型(下拉)、经营状态(下拉:营业中/休息中/已关闭)、商品数量范围、创建时间范围。
    4. 点击"查看详情"进入店铺详情页,展示:店铺基本信息(名称、LOGO、简介、类型、所属商家)、联系信息(客服电话、客服邮箱、工作时间)、经营设置(退货地址、发货时效、售后政策)、关联商品列表(可跳转商品详情)、经营数据统计(近30天订单数、销售额、退款率,前端计算展示)。
    5. 店铺详情页提供"编辑店铺"和"查看经营数据"入口,平台运营还可进行"关闭店铺"和"开启店铺"操作。
    6. 默认店铺机制:每个商家必须有且仅有1个默认店铺,新商品发布时默认归属默认店铺,商家可切换默认店铺。
  • 输出结果:平台运营和商家均可高效管理店铺资产,了解各店铺的经营状况。
  • 特殊情况:商家首次入驻时系统自动创建1个默认店铺(店铺名称=企业名称),商家后续可在后台新增更多店铺(需平台运营审核)。

14.1.2 极细交互说明表

页面/组件用户动作系统行为备注
店铺列表页进入页面加载店铺列表,默认按创建时间倒序,每页20条平台端加载全量,商家端加载当前商家旗下
店铺列表页-平台端点击"所属商家"名称新标签页打开该商家详情页,面包屑显示"店铺列表 > 商家详情"商家名称可跳转
店铺列表页-商家端点击"设为默认店铺"弹出确认框"设为默认后,新发布商品将默认归属此店铺,确认?" → 确认后更新默认店铺标记原默认店铺自动取消标记
店铺列表页点击"查看详情"抽屉展开(宽度800px)或新标签页,展示店铺完整信息商家端抽屉内支持左右切换店铺
店铺详情-基本信息查看LOGO点击LOGO放大预览,支持下载原图LOGO尺寸建议300×300px
店铺详情-经营数据查看近30天数据展示订单数、销售额、退款率,提供"查看趋势图"按钮跳转至数据报表数据每日凌晨3点统计更新
店铺详情-关联商品点击商品名称跳转至商品详情页(供应链PRD定义的商品管理模块)新标签页打开
店铺列表页筛选"经营状态=已关闭"已关闭店铺名称灰色删除线显示,操作列仅显示"详情/重新开启"视觉区分状态
店铺列表页-平台端点击"关闭店铺"强确认弹窗"关闭后该店铺所有商品将下架,已有订单不受影响,确认?" → 确认后店铺状态变更为"已关闭"需填写关闭原因(最少5字符)
店铺列表页点击"新增店铺"(商家端)跳转至新增店铺表单页,提交后进入平台审核流程商家最多可拥有10个店铺

14.1.3 页面原型

店铺列表页原型(供应商后台端)
店铺ID店铺名称类型状态商品数默认操作
S200001风花雪月旅行社旗舰店直营营业中128是详情 编辑
S200002风花雪月-丽江分店直营营业中45—详情 编辑 设默认

14.1.4 状态说明表

状态页面表现触发条件允许操作备注
营业中名称正常显示,商品正常展示销售店铺创建审核通过且商家未手动休息编辑资料、发布商品、手动休息、关闭店铺正常经营状态
休息中名称旁显示"休息中"灰色标签,商品列表显示"店铺休息,暂停接单"商家手动设置休息或到达预设休息时间编辑资料、查看数据、手动恢复营业休息期间不可下单,已有订单正常处理
审核中名称灰色斜体,显示"店铺创建审核中"商家提交新增店铺申请后仅查看详情审核通过前不可发布商品
已关闭名称灰色删除线,商品全部下架,页面显示"店铺已关闭"平台运营关闭或商家主动关闭查看详情、重新开启(需审核)关闭后商品自动下架
已冻结名称橙色显示,显示"店铺已冻结"触发风控(如售假、投诉率过高)仅查看详情,解冻需平台审批冻结期间资金结算暂停
筹备中名称显示"筹备中",提供"完善资料"入口入驻成功但店铺资料未完善完善资料、提交审核资料完善并审核通过后转为营业中

14.1.5 异常处理

异常场景前端表现后端行为处理方案
商家尝试创建第11个店铺"新增店铺"按钮置灰,hover提示"每个商家最多拥有10个店铺"创建接口校验当前商家店铺数量,≥10则拒绝商家关闭闲置店铺后释放额度
关闭默认店铺弹窗提示"该店铺为默认店铺,关闭后需先设置其他店铺为默认,确认继续?"校验是否默认店铺,是则要求先切换默认店铺商家先设置其他店铺为默认,再关闭
店铺关闭时存在未处理订单弹窗警告"该店铺有12笔待发货订单,关闭后仍需处理,确认?"校验待处理订单数量,有则提示风险但不阻断商家确认后关闭,仍需履行已有订单
店铺详情加载时商品列表超时商品区域显示"商品加载中..."独立加载,不影响店铺基本信息展示商品列表独立接口查询,超时后展示"加载失败,点击重试"用户点击重试或稍后再试
平台运营关闭店铺时商家正在编辑商家保存时提示"该店铺已被平台关闭,请刷新页面"使用乐观锁或状态校验,已关闭拒绝编辑保存商家刷新页面查看最新状态
设为默认店铺时该店铺已被关闭"设默认"按钮置灰,提示"该店铺已关闭,无法设为默认"接口校验店铺状态,非营业中店铺不可设为默认商家选择其他营业中店铺

14.2 店铺信息维护

14.2.1 核心业务逻辑

  • 触发条件:商家管理员在店铺详情页点击"编辑",或平台运营在店铺管理页面点击"编辑店铺信息"。
  • 处理规则:
    1. 店铺信息分为三类:基础信息(店铺名称、LOGO、店铺简介、店铺类型)、联系信息(客服电话、客服邮箱、客服工作时间、在线客服链接)、经营设置(退货地址、发货时效承诺、售后政策说明、运费模板选择)。
    2. 店铺名称在商家范围内唯一,修改时校验是否与其他店铺重复。店铺名称长度限制2-30个字符,不允许包含特殊符号(除括号、横线)。
    3. LOGO上传支持JPG/PNG格式,建议尺寸300×300px,文件≤2MB,上传后系统自动生成缩略图(80×80px用于列表,150×150px用于详情)。
    4. 店铺类型包括:直营(商家直接经营)、加盟(加盟商经营,需额外填写加盟授权信息)、代销(代销商经营,需填写委托代销协议编号)。类型变更需平台运营审核。
    5. 客服工作时间采用时间段设置(如 09:00-18:00),支持设置多个时段,非工作时间商品页显示"当前非工作时间,咨询可能延迟回复"。
    6. 退货地址关联商家的地址簿,支持从地址簿选择或新增地址。发货时效承诺选项:24小时发货、48小时发货、72小时发货、自定义(输入天数)。
    7. 所有修改即时生效(除店铺类型变更需审核),修改记录存入店铺操作日志。
  • 输出结果:店铺信息完整、准确,消费者可在商品页查看店铺资质和服务承诺。
  • 特殊情况:店铺简介支持富文本编辑(最多500字),可插入图片(最多3张),用于店铺首页展示。

14.2.2 极细交互说明表

页面/组件用户动作系统行为备注
店铺编辑页进入编辑页加载当前店铺全部信息,分标签页展示:基础信息/联系信息/经营设置未保存切换标签页时保留表单状态
基础信息-店铺名称输入新名称失焦时校验商家范围内唯一性和长度(2-30字符),非法字符红色提示正则校验:不允许@#$%^&*等
基础信息-LOGO上传选择图片文件前端校验格式和大小 → 上传显示进度条 → 上传完成后展示预览图和裁剪框 → 确认后保存支持拖拽上传
基础信息-店铺类型选择"加盟"展开加盟授权信息表单(授权方名称、授权书编号、授权有效期),提交后进入平台审核类型变更需审核
联系信息-客服电话输入电话号码校验手机号或固话格式,支持填写多个(以逗号分隔)至少填写1个
联系信息-工作时间添加时段弹出时间选择器,选择开始和结束时间,支持添加多个不重叠时段重叠时段红色提示
经营设置-退货地址点击"从地址簿选择"弹出地址选择弹窗,展示商家地址簿列表,选中后自动填充地址簿在商家资料模块维护
经营设置-发货时效选择"24小时发货"商品页和订单页展示"24h发货"绿色标签,作为消费者决策参考影响搜索排序权重
店铺编辑页点击"保存"前端校验 → 确认弹窗(类型变更时额外提示"类型变更需平台审核")→ 提交 → Toast提示非类型变更即时生效

14.2.3 页面原型

店铺信息编辑页原型(供应商后台端)
基础信息
联系信息
经营设置
店铺名称 *
店铺LOGO
LOGO
店铺简介
店铺类型

14.2.4 状态说明表

状态页面表现触发条件允许操作备注
已保存店铺信息展示最新内容,无待审核提示非类型变更的编辑保存后正常经营即时生效
类型变更待审核店铺页显示"店铺类型变更审核中"黄色提示,原类型继续生效商家提交类型变更后除类型外其他信息可正常编辑类型变更审核期间不影响经营
类型变更已通过店铺页显示新类型,历史记录中记录变更平台运营审核通过后正常经营新类型即时生效
类型变更已驳回店铺页显示原类型,提示"类型变更被驳回:{原因}"平台运营审核驳回后可重新提交类型变更原类型保持不变
LOGO审核中新LOGO显示"审核中"水印,旧LOGO继续展示LOGO涉及敏感内容需平台审核时正常经营仅敏感LOGO触发审核,常规LOGO即时生效
信息不完整店铺页顶部显示"请完善店铺信息"黄色横幅,部分功能受限必填项未填写(如客服电话、退货地址)编辑补充信息信息完善前不可发布商品

14.2.5 异常处理

异常场景前端表现后端行为处理方案
LOGO上传图片包含敏感内容上传后显示"审核中",系统提示"您的LOGO需平台审核,审核通过前将使用默认LOGO"调用图片内容审核API,检测到敏感内容则标记为待审核平台运营审核通过/驳回,驳回需重新上传
店铺名称与平台禁用词冲突输入框红色提示"店铺名称包含禁用词汇:{词汇},请修改"校验名称是否命中敏感词库,命中则拒绝保存商家修改名称后重新提交
店铺类型从直营改为代销但无代销协议表单校验提示"变更为代销类型需上传委托代销协议"提交时校验代销类型是否上传协议文件,未上传拒绝商家上传协议后重新提交
客服电话填写非工作时间紧急电话黄色警告"该号码疑似非客服电话,请确认",不阻断保存校验号码格式,不校验实际用途,仅提示商家确认无误后保存
编辑店铺时店铺被平台冻结保存时提示"该店铺已被冻结,无法修改信息"保存接口校验店铺状态,已冻结拒绝保存商家联系平台了解冻结原因
退货地址选择地址簿中已删除地址地址显示"[已删除]"红色标记,提示"该地址已被删除,请重新选择"加载地址时校验有效性,已删除地址标记但不阻断展示商家重新选择有效地址

14.3 店铺状态管理

14.3.1 核心业务逻辑

  • 触发条件:商家管理员手动操作店铺状态(营业/休息/关闭),或平台运营对店铺进行管控操作(冻结/解冻/关闭/开启),或系统根据预设规则自动切换状态。
  • 处理规则:
    1. 商家手动操作:在店铺管理页面可设置"今日营业""今日休息""定时休息"(设置休息开始和结束时间)。手动休息期间,店铺商品在C端显示"店铺休息,暂停接单",不可下单但可浏览。
    2. 平台运营操作:平台运营可在店铺详情页执行"冻结店铺"(需填写冻结原因,冻结期间商品下架、不可下单、资金结算暂停)、"解冻店铺"(需审批,解冻后恢复正常)、"关闭店铺"(不可逆,商品全部下架)、"重新开启"(针对已关闭店铺,需审核)。
    3. 系统自动规则:客服工作时间外自动显示"非工作时间"提示(不改变状态,仅提示);连续7天未登录后台且有待处理订单,系统自动标记"异常"并通知运营;售假投诉成立自动冻结3天。
    4. 状态流转权限:营业中↔休息中(商家可操作);营业中/休息中→冻结(平台运营可操作);冻结→营业中/休息中(平台运营解冻);营业中/休息中→关闭(平台运营或商家);关闭→营业中(平台运营重新开启,需审核)。
    5. 所有状态变更记录操作日志,包含操作人、操作时间、原状态、新状态、变更原因。
  • 输出结果:店铺状态精准管控,保障消费者权益的同时给予商家灵活的经营自主权。
  • 特殊情况:大促活动期间(如双11、国庆),平台可统一设置"活动期间禁止手动休息",防止商家临时休息影响平台整体销售。

14.3.2 极细交互说明表

页面/组件用户动作系统行为备注
店铺管理页-商家端点击"今日休息"弹出确认框"休息期间消费者无法下单,确认休息?" → 确认后店铺状态变更为"休息中",C端展示休息提示即时生效
店铺管理页-商家端点击"定时休息"弹出时间选择器,选择休息开始和结束时间 → 到达开始时间自动休息,到达结束时间自动恢复营业支持跨天设置
店铺管理页-商家端大促期间点击"今日休息"按钮置灰,tooltip显示"活动期间禁止手动休息,如有特殊原因请联系平台运营"平台统一管控
店铺详情页-平台端点击"冻结店铺"弹出确认框(含冻结原因输入框,最少10字符,含冻结时长选择:3天/7天/30天/永久)→ 确认后店铺冻结冻结即时生效
店铺详情页-平台端点击"解冻店铺"弹出确认框(含解冻原因输入框)→ 确认后恢复为"营业中"需平台运营权限
店铺详情页-平台端点击"关闭店铺"强确认弹窗(二次确认)"关闭后不可自行开启,需平台审核,确认?" → 确认后关闭关闭不可逆
店铺详情页-平台端点击"重新开启"(已关闭店铺)弹出审核流程,填写开启原因 → 提交后进入平台审核队列 → 审核通过后恢复"营业中"开启需审核
C端商品页浏览休息中店铺商品商品页展示"店铺休息中,暂停接单"灰色横幅,"立即购买"按钮置灰不影响商品浏览和收藏
C端商品页浏览冻结店铺商品商品下架,搜索不可见,直接访问链接显示"该店铺已被冻结"完全不可访问

14.3.3 页面原型

店铺状态管理原型(供应商后台端)
风花雪月旅行社旗舰店
当前状态:营业中
今日订单:23笔
客服在线:是(09:00-18:00)

14.3.4 状态说明表

状态流转触发条件操作人影响范围备注
营业中 → 休息中商家手动设置休息或定时休息到达开始时间商家/系统不可下单,可浏览已有订单正常处理
休息中 → 营业中商家手动恢复或定时休息到达结束时间商家/系统恢复正常下单即时生效
营业中/休息中 → 冻结平台运营冻结或系统自动触发(如售假)平台运营/系统商品下架,不可访问资金结算暂停
冻结 → 营业中平台运营解冻平台运营恢复上架和下单解冻即时生效
营业中/休息中 → 关闭平台运营关闭或商家主动关闭平台运营/商家商品全部下架关闭不可逆
关闭 → 营业中平台运营重新开启并通过审核平台运营恢复营业开启需审核
营业中 → 筹备中平台强制要求完善信息平台运营限制发布商品信息完善后恢复

14.3.5 异常处理

异常场景前端表现后端行为处理方案
商家设置休息时间与平台大促冲突提示"{日期}为平台大促日,建议保持营业,确认休息?"校验休息时段是否包含平台大促日,包含则提示但不阻断商家确认后仍可休息
冻结期间商家尝试发布商品"发布商品"按钮置灰,提示"店铺已被冻结,解冻后方可发布商品"发布接口校验店铺状态,冻结中拒绝发布商家联系平台申请解冻
定时休息设置时间已过系统提示"您设置的休息时间已过期,店铺已自动恢复营业"定时任务扫描过期休息设置,自动恢复营业状态商家如需休息需重新设置
店铺关闭后消费者仍尝试下单(缓存未刷新)C端显示"该店铺已关闭,无法下单"下单接口校验店铺状态,已关闭返回明确错误码消费者刷新页面或选择其他店铺
平台运营误操作关闭店铺关闭弹窗要求二次确认,并显示"关闭操作不可逆,请谨慎操作"红色警告关闭操作记录审计日志,发送通知给平台负责人如需恢复,走"重新开启"审核流程
多个运营同时对同一店铺操作状态后操作者收到提示"该店铺状态已被其他用户修改,请刷新后重试"使用乐观锁防止并发状态冲突运营刷新后查看最新状态再操作

15. 证照与合同管理功能模块详解

证照与合同管理是平台合规经营的基础保障,涵盖商家资质证照的全生命周期管理和分销协议/入驻协议的签署与维护。本章包含4个功能项的5层级详解。

15.1 证照上传与审核

15.1.1 核心业务逻辑

  • 触发条件:商家在入驻流程中上传证照,或入驻后在"证照管理"页补充/更新证照,或平台运营在审核页面查看和处理证照审核。
  • 处理规则:
    1. 证照类型根据商家类型自动适配:供应商需上传营业执照、法人身份证正反面、旅行社业务经营许可证(如涉及)、对公账户开户许可证;个人分销商需上传身份证正反面、银行卡;B端分销商需上传营业执照、法人身份证、对公账户证明;OTA需上传营业执照、OTA平台资质证明、接口对接授权书。
    2. 证照文件要求:JPG/PNG/PDF格式,单文件≤10MB,建议分辨率≥300dpi。系统对上传图片进行内容安全审核(涉黄涉暴涉政检测),违规图片拒绝上传并记录。
    3. 上传营业执照后,系统自动调用OCR识别服务提取:企业名称、统一社会信用代码、法人姓名、注册资本、成立日期、营业期限、经营范围。OCR结果与商家填写资料自动比对,不一致时标黄提示。
    4. 上传身份证后,OCR提取姓名、身份证号、住址、有效期。系统自动校验身份证有效期,过期证件标红提示"证件已过期,请更新"。
    5. 证照审核流程:商家上传→状态"待审核"→平台运营审核(通过/驳回)→通过后状态"已审核",驳回后状态"已驳回"并附带原因。审核通过后证照方可用于入驻审核和后续经营。
    6. 证照与商家主体绑定,多店铺共享同一套证照(店铺无独立证照体系)。
  • 输出结果:商家证照完整、真实、有效,平台合规风险可控。
  • 特殊情况:旅行社业务经营许可证仅在商家选择的经营类别包含"出境游"或"入境游"时为必填,其他类别可选。

15.1.2 极细交互说明表

页面/组件用户动作系统行为备注
证照管理页进入页面加载当前商家全部证照列表,按类型分组展示,每个证照显示缩略图、文件名、上传时间、状态缺失必填证照时顶部红色提示
证照管理页点击"上传证照"弹出上传弹窗,选择证照类型(下拉,已上传的类型置灰提示"已上传,如需更新请点击替换")同一类型证照最多保留3个历史版本
上传弹窗选择文件前端校验格式和大小 → 显示预览图 → 上传显示进度条 → 上传完成后自动触发OCR识别支持拖拽上传
上传弹窗OCR识别完成展示识别结果卡片,与已有资料比对:一致显示绿色"核验通过",不一致显示黄色"请核对:OCR识别XX与填写XX不一致"不一致不阻断,仅提示
证照管理页点击"提交审核"校验所有必填证照是否已上传且状态有效 → 确认弹窗 → 提交 → 状态变更为"待审核" → 通知平台运营有缺失时提示"请先上传全部必填证照"
平台审核页-证照查看证照详情展示证照原图(支持放大、旋转、下载)、OCR识别结果、与商家填写资料的比对差异提供"放大查看"按钮便于核验真伪
平台审核页-证照点击"审核通过"确认弹窗 → 状态变更为"已审核" → 通知商家"证照审核通过"通过后可继续入驻流程
平台审核页-证照点击"审核驳回"确认弹窗(含驳回原因输入框,最少10字符,含常见原因快捷选项:图片不清晰/信息不一致/证件过期/非有效证件)→ 状态变更为"已驳回" → 通知商家商家需重新上传
证照管理页点击"替换"(已审核证照)弹出上传弹窗,上传新证照 → 新证照状态为"待审核",旧证照保持"已审核"直至新证照审核通过避免审核空窗期

15.1.3 页面原型

证照管理页原型(供应商后台端)
审核状态:待审核(已提交,等待平台运营审核)
营业执照 *
营业执照.jpg
OCR识别成功
法人身份证 *
身份证.jpg
OCR识别成功

15.1.4 状态说明表

状态页面表现触发条件允许操作备注
未上传显示"请上传"灰色占位图,顶部提示缺失商家尚未上传该类型证照上传必填证照缺失时阻断入驻提交
待审核显示"待审核"黄色标签,OCR结果已展示商家提交审核后查看、撤回(撤回后恢复未上传状态)平台运营审核队列中
已审核显示"已审核"绿色标签,可用于入驻和经营平台运营审核通过后查看、替换(替换后进入待审核)有效期内正常可用
已驳回显示"已驳回"红色标签,展示驳回原因平台运营审核驳回后查看、重新上传需根据原因修正后重新上传
已过期显示"已过期"红色标签,顶部红色警告"该证照已过期,请尽快更新"系统每日扫描,证件有效期<当前日期查看、替换过期证照不影响历史经营,但阻断新商品发布
即将过期显示"即将过期"橙色标签,证件有效期30天内系统每日扫描,证件有效期-当前日期≤30天查看、替换触发预警通知

15.1.5 异常处理

异常场景前端表现后端行为处理方案
OCR识别结果与填写资料严重不符(如企业名称完全不同)上传后红色警告"OCR识别企业名称与填写内容严重不符,请确认是否上传了正确的证照"文本相似度算法比对,相似度<50%时触发强警告商家确认或重新上传正确证照
上传图片模糊导致OCR识别失败提示"图片清晰度不足,识别失败,请上传更清晰的图片"OCR返回置信度<0.7时标记识别失败商家重新拍摄/扫描上传
商家上传伪造/PS证照平台运营审核时发现疑点,可点击"疑似伪造"标记,系统自动增强风控评分运营标记后该商家进入重点观察名单,后续订单增加复核环节运营进一步核实,确认伪造则驳回入驻并封号
证照审核期间商家修改了主体资料资料页提示"您的主体资料已修改,与已审核证照信息可能不一致,建议重新上传证照"资料变更后系统自动比对与已审核证照的一致性商家重新上传证照确保一致性
同一张身份证被多个商家使用第二个商家上传时提示"该身份证已关联其他商家,请确认或联系客服"校验身份证号在平台商家表中的唯一性(个人分销商除外)商家确认或联系客服处理
证照存储服务异常导致上传失败上传进度条卡住,5秒后提示"上传服务暂不可用,请稍后重试"上传接口返回5xx时前端友好提示,后端记录异常日志商家稍后重试,技术团队排查存储服务

15.2 证照有效期预警

15.2.1 核心业务逻辑

  • 触发条件:系统每日凌晨3点执行定时任务,扫描全量商家证照的有效期,根据提前预警天数阈值触发不同级别的预警通知。
  • 处理规则:
    1. 预警分级:一级预警(到期前30天,橙色提示)、二级预警(到期前15天,橙色加粗提示)、三级预警(到期前7天,红色提示)、紧急预警(到期前3天,红色加粗+多渠道通知)、过期(已到期,红色阻断提示)。
    2. 通知渠道:一级/二级预警仅站内消息+商家后台横幅;三级预警增加短信通知;紧急预警增加短信+邮件+商家后台弹窗阻断(登录后必须看到)。
    3. 预警通知内容包含:证照类型、当前有效期、剩余天数、更新指引链接(跳转证照管理页)。
    4. 商家更新证照后,系统重新计算有效期,自动解除预警状态。
    5. 平台运营端"证照预警看板"展示全部预警商家列表,按预警级别倒序排列,支持按商家类型、证照类型筛选,支持一键发送催办通知。
    6. 证照过期后的处理:营业执照过期→商家状态标记"资质异常",禁止发布新商品,已有商品下架;身份证过期→仅提醒,不阻断经营(但影响提现审核);经营许可证过期→相关经营类别商品下架。
  • 输出结果:证照有效期风险提前感知、主动通知、及时处置,避免因证照过期导致的经营中断和合规风险。
  • 特殊情况:部分证照无明确有效期(如三证合一后的营业执照长期有效),系统识别"长期有效"标记后不纳入预警扫描。

15.2.2 极细交互说明表

页面/组件用户动作系统行为备注
商家后台首页登录后如有紧急预警,弹出模态框展示所有即将过期证照列表,提供"去更新"按钮,必须点击"我知道了"才能关闭(不强制立即更新)弹窗仅紧急预警时展示
商家后台首页查看预警横幅顶部显示预警横幅"您的营业执照将于7天后过期,请及时更新",点击跳转证照管理页三级及以上预警展示
证照管理页查看证照列表即将过期证照卡片边框变为橙色(30天)或红色(7天),显示倒计时"剩余X天"视觉层级清晰
平台运营-预警看板进入看板展示预警统计卡片(一级X家/二级X家/三级X家/紧急X家/已过期X家)+ 预警商家列表看板每日3点更新
平台运营-预警看板点击"发送催办"弹出确认框 → 向该商家发送催办站内消息和短信(内容:"您的XX证照即将过期,请及时更新,避免影响经营")同一商家每天最多催办1次
平台运营-预警看板点击"忽略本次预警"将该商家的本次预警标记为已忽略,不再发送通知,但看板仍展示适用于已线下沟通的商家
商家-站内消息查看预警消息消息标题"证照即将过期提醒",内容含证照类型、到期日、更新链接预警消息不可删除,更新后自动归档
证照管理页更新证照后新证照审核通过后,系统自动重新计算有效期,解除预警状态,发送"证照已更新,预警解除"通知自动解除,无需人工操作

15.2.3 页面原型

证照预警看板原型(平台运营端)
12
一级预警
8
二级预警
5
三级预警
3
紧急预警
2
已过期
商家名称证照类型到期日剩余天数预警级别操作
云南大理风花雪月旅行社营业执照2024-12-313天紧急

15.2.4 状态说明表

预警级别页面表现触发条件通知方式处理要求
一级预警证照卡片橙色边框,显示"剩余30天"到期前30天站内消息建议更新
二级预警证照卡片橙色加粗边框,显示"剩余15天"到期前15天站内消息+商家后台横幅尽快更新
三级预警证照卡片红色边框,显示"剩余7天",后台顶部红色横幅到期前7天站内消息+横幅+短信必须更新
紧急预警证照卡片红色加粗边框,显示"剩余3天",登录弹窗阻断到期前3天站内消息+横幅+短信+邮件+弹窗立即更新
已过期证照卡片灰色背景+删除线,显示"已过期",功能受限到期日当天及之后全部渠道通知更新前部分功能阻断
已解除证照卡片恢复正常绿色边框,显示新有效期更新证照并审核通过后发送"预警解除"通知恢复正常经营

15.2.5 异常处理

异常场景前端表现后端行为处理方案
OCR未识别到有效期(如图片模糊)证照状态显示"待补充有效期",提示"系统未识别到有效期,请手动填写"OCR未提取到日期字段时,要求商家手动补充,补充后纳入预警扫描商家手动填写有效期
商家在到期当天才更新证照更新上传后状态为"待审核",但原证照已过期 → 经营功能已受限新证照审核通过后立即恢复经营,审核期间保持受限商家尽早更新,避免审核空窗期
平台运营误操作忽略重要预警忽略操作记录至审计日志,平台负责人可在"预警操作记录"中查看全部忽略操作忽略操作需记录原因,支持事后审计负责人定期检查忽略记录
短信通知失败(手机号停机)平台运营端该商家预警记录旁显示"短信发送失败"红色图标短信发送失败时标记通知状态,运营可查看失败原因运营电话联系商家或更新商家手机号
商家已更新证照但平台运营未及时审核商家端显示"新证照待审核,审核通过前原证照状态继续生效"新证照未审核通过前,不过早失效原证照平台运营尽快审核新证照
证照有效期跨闰年2月29日计算错误系统正确显示剩余天数日期计算使用标准库处理闰年逻辑无需处理,系统已兼容

15.3 合同生成与签署

15.3.1 核心业务逻辑

  • 触发条件:商家入驻审核通过后,系统自动生成对应类型的合同;或平台运营在"合同管理"页面手动为特定商家生成合同;或分销协议签署时触发。
  • 处理规则:
    1. 合同类型与商家类型对应:供应商→《供应商入驻协议》;个人分销商→《平台公共分销协议(个人版)》;B端分销商→《平台公共分销协议(企业版)》;OTA→《OTA分销协议》。B端分销商与供应商建立专属分销关系时,额外生成《供应商专属分销协议》。
    2. 合同模板管理:平台运营在"合同模板"页面维护各类型合同模板,支持变量替换(如{{merchant_name}}、{{sign_date}}、{{commission_rate}})。模板变更后仅影响新生成的合同,已生成合同保持原内容。
    3. 合同生成流程:入驻审核通过→系统读取最新合同模板→替换商家变量→生成PDF合同文件→创建合同记录(status=待签署)→调用电子签章服务生成签署链接→发送至商家联系人邮箱和站内消息。
    4. 电子签章流程:商家点击签署链接→校验链接有效期(72小时)→展示合同全文→商家确认→调用电子签章服务完成签署→系统存储签署后的PDF文件和签章证书→合同状态变更为"已生效"。
    5. 合同生效条件:双方签署完成(平台方由系统自动签署,商家方由商家手动签署)。生效后合同不可修改,如需变更走"合同变更"流程。
    6. 合同存储:原始PDF、签署后PDF、签章证书、签署日志均永久存储,支持随时下载和验真。
  • 输出结果:合同生成规范、签署便捷、存证完整,保障平台和商家的合法权益。
  • 特殊情况:电子签章服务不可用时,系统允许平台运营选择"线下签署"模式,商家上传已盖章的合同扫描件,平台运营审核通过后手动标记"已生效"。

15.3.2 极细交互说明表

页面/组件用户动作系统行为备注
平台运营-合同模板页编辑模板提供富文本编辑器,支持插入变量(下拉选择变量名自动插入{{变量}}),预览时自动替换为示例数据模板保存后即时生效
商家入驻进度页审核通过后查看合同展示合同预览(HTML渲染),提供"查看完整PDF"和"去签署"按钮预览非正式合同,签署后生效
商家-合同签署链接点击邮件/站内消息中的签署链接校验链接有效期 → 校验商家身份 → 展示合同全文(不可编辑)→ 底部"确认签署"按钮链接72小时有效
合同签署页点击"确认签署"弹出二次确认"签署后合同即时生效,确认?" → 调用电子签章API → 显示签署进度 → 签署成功展示"签署成功"页面签署过程约5-10秒
平台运营-合同管理页查看合同列表展示全部合同,字段:合同编号、商家名称、合同类型、状态、生成时间、签署时间、操作(查看/下载/重发链接/作废)支持按类型和状态筛选
平台运营-合同管理页点击"重发签署链接"确认弹窗 → 重新生成签署链接 → 发送邮件和站内消息 → 原链接失效原链接立即失效,防止重复签署
平台运营-合同管理页点击"线下签署"弹出上传框,商家上传盖章扫描件 → 运营审核 → 通过后手动标记"已生效"电子签章不可用时的兜底方案
商家-合同管理页查看我的合同展示该商家的全部合同列表,可查看合同全文、下载PDF、查看签署证书商家仅可见自己的合同
合同签署页链接过期后访问显示"签署链接已过期,请联系平台运营重新发送"过期后不可签署

15.3.3 页面原型

合同签署页原型(商家端)
《供应商入驻协议》

供应商入驻协议

甲方(平台):云灵汐科技有限公司

乙方(供应商):云南大理风花雪月旅行社有限公司

签署日期:2024年1月15日

...(协议正文)...

我已阅读并同意以上协议内容

15.3.4 状态说明表

状态页面表现触发条件允许操作备注
待生成入驻审核通过前,合同页显示"审核通过后将自动生成合同"入驻审核通过前无系统等待审核通过
待签署显示合同预览和"去签署"按钮,发送签署链接至邮箱系统生成合同后查看、签署、下载预览版链接72小时有效
签署中显示"签署处理中"进度条,按钮置灰不可重复点击商家点击确认签署后仅查看防止重复提交
已生效显示"已生效"绿色标签,展示生效日期,提供下载正式版PDF和查看签章证书电子签章签署完成后查看、下载、验真合同正式生效
已过期显示"已过期"灰色标签,提示"合同已到期,请联系平台续签"合同有效期届满后查看、下载(历史版本)不影响历史订单,但阻断新合作
已作废显示"已作废"红色标签,展示作废原因和作废时间平台运营手动作废或合同变更后旧合同作废查看、下载(仅平台运营)作废后无法恢复
线下签署待审核显示"线下签署待审核"橙色标签,展示上传的扫描件商家上传线下签署扫描件后查看、审核通过/驳回仅平台运营可操作

15.3.5 异常处理

异常场景前端表现后端行为处理方案
电子签章服务超时(>30秒)签署页显示"签署处理中,请耐心等待...",60秒后提示"签署服务响应较慢,请勿关闭页面"后端异步轮询签章服务状态,超时后人工介入处理商家保持页面开放,系统自动完成或运营人工确认
商家签署时网络中断网络恢复后页面自动检测签署状态,如已签署成功则跳转成功页,如未签署则允许重新点击"确认签署"接口支持幂等性,同一合同同一商家多次签署仅生效一次商家重新点击签署即可
合同模板变量缺失(如模板用了{{contact_name}}但商家未填写联系人)合同生成时系统提示"模板变量contact_name无对应数据,请补充商家资料或修改模板"生成前校验全部模板变量是否有对应数据,缺失则阻断生成并通知运营运营补充资料或修改模板后重新生成
同一合同被重复生成平台运营端同一商家显示两条相同类型合同时,后生成的标记"重复生成"警告生成前校验该商家是否已有同类型待签署/已生效合同,有则提示是否覆盖运营选择覆盖或保留原合同
线下签署扫描件不清晰运营审核时提示"扫描件清晰度不足,请要求商家重新上传"人工判断扫描件质量,不清晰则驳回商家重新扫描上传
合同生效后商家要求查看历史版本商家端"合同管理"提供"历史版本"入口,展示该商家的全部历史合同(含已过期和已作废)历史合同记录永久保留,支持随时查阅商家自助查看

15.4 合同续签与变更

15.4.1 核心业务逻辑

  • 触发条件:合同即将到期前30天系统自动触发续签流程,或平台运营在"合同管理"页面主动发起续签/变更,或商家在合同到期前主动申请续签。
  • 处理规则:
    1. 自动续签提醒:合同到期前30天,系统向商家发送续签提醒通知(站内消息+邮件+短信),向平台运营发送"待续签合同"待办。商家可在"合同管理"页面点击"申请续签"。
    2. 续签流程:商家申请续签→平台运营审核(确认合作意愿和资质)→审核通过后生成新一期合同→商家签署→新合同生效,旧合同状态变更为"已过期"。新合同有效期默认1年,平台运营可修改。
    3. 合同变更流程:当合作条款需要调整时(如佣金比例变更、结算周期变更),平台运营发起"合同变更",填写变更内容(支持对比展示变更前后条款)→商家确认→签署变更协议→变更即时生效。变更协议作为原合同的补充附件。
    4. 商家不续签处理:合同到期前7天商家仍未申请续签,平台运营发送"最后提醒";到期当天仍未续签,系统自动将商家状态变更为"合同过期",商品下架、暂停新订单,已生效订单正常履约。商家在30天内可申请恢复(需重新签署合同)。
    5. 批量续签:平台运营可选择多个商家批量发起续签,生成批量合同文件,但签署仍需逐个完成(因电子签章需逐个商家认证)。
    6. 所有续签和变更记录存入合同历史表,支持追溯任意时间点的合同状态。
  • 输出结果:合同生命周期完整管理,合作关系平稳延续,条款变更有据可查。
  • 特殊情况:合同续签期间(旧合同已过期,新合同待签署),商家状态为"合同过期",但系统保留30天宽限期,宽限期内商家补缴合同后可恢复经营,无需重新走入驻流程。

15.4.2 极细交互说明表

页面/组件用户动作系统行为备注
商家-合同管理页收到续签提醒后进入显示"您的合同将于X天后到期,请及时续签"红色横幅,提供"申请续签"按钮到期前30天开始展示
商家-合同管理页点击"申请续签"弹出确认框"申请续签后,平台将生成新一期合同,确认?" → 提交申请 → 状态变更为"续签申请中"商家主动发起
平台运营-合同管理页点击"发起续签"弹出续签配置框(选择合同有效期、是否调整条款)→ 生成新合同 → 发送签署链接平台运营主动发起
平台运营-合同管理页点击"发起变更"弹出变更编辑器,左侧展示原合同条款,右侧编辑新条款,变更内容高亮标黄 → 提交后发送给商家确认变更需商家确认后生效
商家-合同变更确认页查看变更内容展示变更对比(左侧原条款红色删除线,右侧新条款绿色高亮),底部"同意变更"和"拒绝变更"按钮商家需明确确认或拒绝
商家-合同变更确认页点击"同意变更"弹出确认框 → 调用电子签章签署变更协议 → 变更即时生效同意后不可撤销
商家-合同变更确认页点击"拒绝变更"弹出原因输入框(最少10字符)→ 提交后通知平台运营,原合同继续有效拒绝后可协商后重新发起变更
平台运营-合同看板查看"待续签"列表展示全部即将到期和已到期的合同,按到期日升序排列,支持筛选"7天内到期"/"已过期"/"宽限期"便于运营主动跟进
系统-宽限期管理商家在宽限期内补缴合同合同签署后立即恢复"已激活"状态,商品自动重新上架(如之前因过期下架)30天宽限期

15.4.3 页面原型

合同变更确认页原型(商家端)
合同变更确认
变更原因:平台佣金政策调整
变更条款:佣金比例
原条款:佣金比例 15%
新条款:佣金比例 12%

15.4.4 状态说明表

状态页面表现触发条件允许操作备注
正常履约中合同显示"生效中",展示剩余有效期合同已生效且未到期查看、下载、申请续签正常状态
续签提醒中显示"即将到期"橙色标签,展示倒计时到期前30天查看、申请续签系统发送提醒
续签申请中显示"续签审核中"黄色标签商家或平台发起续签后查看、查看新合同预览等待签署
变更待确认显示"条款变更待确认"橙色标签,提供变更对比查看平台发起变更后查看、同意、拒绝商家需主动确认
已过期显示"已过期"红色标签,商品下架,功能受限合同到期且未续签查看、申请恢复(宽限期内)进入宽限期
宽限期显示"宽限期(剩余X天)"红色标签,提示"请尽快续签,宽限期结束后将关闭账号"合同过期后30天内查看、续签恢复30天后自动关闭
已关闭显示"合同关闭"灰色标签,账号不可登录宽限期结束后仅平台运营可查看历史需重新入驻

15.4.5 异常处理

异常场景前端表现后端行为处理方案
续签期间商家提交了新的证照变更系统提示"您有证照变更正在进行,建议完成变更后再续签,确保合同信息准确"不强制阻断,但建议商家先完成证照变更商家按需选择先后顺序
商家在宽限期内恢复经营后又要求退款历史订单按正常售后流程处理,合同过期不影响历史订单的售后权益售后系统独立校验订单状态,不受合同状态影响正常处理售后
平台运营发起变更后商家长期(>15天)未确认平台运营端显示"变更待确认已超15天"红色警告,提供"撤销变更"和"再次通知"按钮超期未确认自动发送催办通知,运营可撤销变更运营撤销后原合同继续有效
批量续签时部分商家已停用批量结果页显示"成功续签98家,失败2家(原因:商家已停用)"逐条校验商家状态,已停用商家跳过并记录运营对失败商家单独处理
合同变更涉及佣金比例,但财务系统未同步变更协议生效后,财务系统次日自动同步新佣金比例变更生效时发送消息队列通知财务系统更新结算规则次日0点后新订单按新比例结算
商家拒绝变更后双方协商达成新条款平台运营重新发起变更,填写新条款,商家再次确认每次变更独立记录,拒绝不影响后续新变更发起运营按协商结果重新发起

15.5 到期提醒配置

15.5.1 核心业务逻辑

功能定位

到期提醒配置是独立的到期提醒配置中心。虽然证照上传与审核(15.1)中已内置到期提醒逻辑,但本功能项将到期提醒抽取为独立配置模块,由平台运营人员在统一的配置中心自定义提醒规则、提醒渠道、提醒模板和提醒对象,同时覆盖证照到期(营业执照、法人身份证、旅行社经营许可证等)和合同到期(入驻合同、分销协议、OTA协议等)两种场景,实现提醒能力的复用、集中管控与精细化运营。

1. 触发条件与执行主体

  • 配置主体:平台运营人员,在"证照与合同管理 > 到期提醒配置"页面进行规则设置。
  • 执行主体:系统后台定时任务,每日凌晨 03:00 自动执行全量扫描,无需人工干预。
  • 扫描范围:全平台已录入且处于"有效"状态的证照与合同(已作废、已注销的数据不参与扫描)。

2. 提醒对象类型

  • 证照到期:营业执照、法人身份证、旅行社经营许可证、税务登记证、ICP 备案等。每类证照可独立配置是否纳入提醒。
  • 合同到期:入驻合同、分销协议、OTA 分销协议、补充协议等。支持按合同类型分别配置提醒规则。

3. 提醒规则配置

  • 提醒时间节点:支持配置多个提醒节点(如到期前 30 天、15 天、7 天、3 天、1 天),每个节点可单独开关。节点天数仅允许配置 1~365 的正整数,同一规则内不允许配置重复天数节点。
  • 提醒渠道:站内消息、短信、邮件三种渠道,每个节点可配置不同渠道组合(至少勾选一种)。站内消息为系统默认可用渠道;短信、邮件需依赖平台已接入的短信网关与邮件服务。
  • 提醒对象:商家联系人、平台运营对接人、平台运营负责人,支持多选。商家联系人取自店铺档案;平台对接人/负责人取自运营组织架构配置。
  • 提醒模板:每个渠道对应不同消息模板,支持变量占位符替换,包括 {merchant_name}(商家名称)、{cert_type}(证照/合同类型)、{cert_no}(证照/合同编号)、{expire_date}(到期日期)、{days_remaining}(剩余天数)、{shop_name}(店铺名称)、{contact_name}(联系人姓名)等。

4. 定时扫描任务

  • 系统每日凌晨 03:00 执行定时扫描任务,扫描全量证照和合同的有效期,按到期日与当前日期差值匹配提醒规则中已启用的提醒节点。
  • 命中节点后,根据该节点配置的渠道与对象生成提醒任务并推送;同一证照/合同在同一节点当日仅触发一次,避免重复发送。
  • 任务执行采用分批处理,单批处理量默认 1000 条,支持配置调整,避免大数据量下单次任务超时。

5. 提醒记录

  • 每次提醒生成一条记录,包含:提醒时间、提醒对象(证照/合同)、对象编号、对象类型、提醒节点、提醒渠道、接收人、消息内容、送达状态(成功/失败/待重试)。
  • 记录保留 12 个月,超期数据自动归档至历史库,支持按需查询导出。

6. 提醒看板

  • 平台运营端展示即将到期(30 天内)的证照/合同列表,按到期天数升序排序。
  • 支持一键催办:针对单条或多条记录向商家联系人再次推送催办消息(站内消息+短信)。
  • 看板顶部展示统计卡片:30 天内到期数、已过期数、本月提醒发送量。

7. 提醒统计

  • 按月统计各类型(证照/合同)提醒发送量、送达成功率、商家响应率(收到提醒后在到期前更新证照/完成续签的比例)。
  • 支持按时间范围、对象类型、渠道维度筛选,生成趋势图表。

8. 过期处理联动

  • 证照过期:联动店铺状态管理(15.3),证照过期后系统自动将关联店铺置为"资质异常"状态,限制店铺前台展示与交易。
  • 合同过期:联动合同续签与变更(15.4),合同过期后自动触发业务权限降级,暂停分销权限与结算权限,直至完成续签。
配置约束
  • 证照到期规则与合同到期规则相互独立,分别配置、分别生效,互不影响。
  • 同一对象类型下,同一证照/合同类型共享一套提醒规则,不支持按单个商家单独配置(如需定向催办,使用看板"一键催办"功能)。
  • 规则变更后次日生效(即下一次定时扫描任务执行时按新规则处理)。
  • 提醒模板修改不影响已发送的历史提醒记录。

15.5.2 交互说明

序号 操作场景 操作步骤 系统响应 约束/说明
1 进入到期提醒配置页 运营人员登录后台,依次点击"证照与合同管理 > 到期提醒配置"菜单 页面默认展示"证照到期"规则配置页签,加载已配置的提醒规则数据;若首次进入无配置数据,展示空状态引导"新建提醒规则" 需具备"到期提醒配置-查看"权限;无权限时菜单不展示
2 选择提醒对象类型 在页面顶部页签切换"证照到期"/"合同到期" 切换后加载对应类型的提醒规则配置内容,页签高亮显示当前选中类型;切换不丢失已编辑内容(自动暂存草稿) 两种类型规则独立存储;切换页签时若当前页有未保存修改,弹窗提示"有未保存的修改,是否确认离开?"
3 配置提醒时间节点 在"提醒时间节点"区域点击"新增节点",输入天数(如 30),选择是否启用该节点开关;可对已有节点编辑天数或删除 新增节点行实时渲染至节点配置表;输入天数时校验为 1~365 正整数且不与已有节点重复;删除节点二次确认"确认删除该提醒节点?" 同一规则至少保留 1 个启用节点,否则保存时提示"至少启用一个提醒节点";最多支持配置 10 个节点
4 配置提醒渠道 在每个节点行内勾选提醒渠道复选框:站内消息 / 短信 / 邮件 勾选后该渠道对应列高亮;取消勾选则该渠道不参与本节点提醒;至少勾选一种渠道 站内消息默认勾选且不可取消(保底渠道);短信/邮件依赖平台服务接入状态,未接入时复选框置灰并提示"短信服务未配置,请联系管理员"
5 配置提醒对象 在每个节点行内勾选提醒对象:商家联系人 / 平台运营对接人 / 平台运营负责人 勾选后对应接收人将收到该节点提醒;可多选 商家联系人取店铺档案中维护的联系人;若商家联系人手机号/邮箱为空,该对象在发送时跳过并记录"接收人信息缺失";至少勾选一种提醒对象
6 编辑提醒模板 点击节点行"编辑模板"按钮,弹出模板编辑弹窗;选择渠道标签页,编辑模板内容,可点击"插入变量"选择占位符;点击"预览"查看效果,点击"变量替换测试"输入测试数据 模板编辑器实时保存内容;预览时以示例数据替换变量展示最终消息样式;变量替换测试时校验变量是否全部被替换,未替换变量以红色高亮提示 每个渠道模板独立编辑;模板内容不超过 500 字符(短信单条 70 字,超出自动拆分);必填变量({merchant_name}、{expire_date})缺失时保存校验不通过
7 启用/停用提醒规则 在规则配置区顶部切换"规则状态"开关:启用 / 停用;或对单个节点切换"节点开关" 整体停用时所有节点停止触发提醒,规则状态标记为"已暂停";单节点关闭时该节点不触发,规则状态标记为"部分暂停";保存后即时生效状态标签更新 整体停用需二次确认"停用后将不再发送到期提醒,确认停用?";停用不影响已生成的历史提醒记录
8 查看提醒记录列表 切换至"提醒记录"页签,设置筛选条件:时间范围、对象类型(证照/合同)、渠道、送达状态,点击"查询" 列表展示提醒记录:提醒时间、对象类型、对象编号、对象名称、提醒节点、渠道、接收人、送达状态、操作(查看详情);支持分页、导出 Excel 默认查询最近 30 天数据;单次查询最多返回 10000 条,超出提示"数据量过大,请缩小时间范围";导出单次上限 50000 条
9 查看提醒看板 切换至"提醒看板"页签,查看顶部统计卡片与即将到期列表;点击"一键催办"按钮对选中记录催办 统计卡片展示:30 天内到期数、已过期数、本月提醒发送量;列表按到期天数升序展示证照/合同信息;勾选记录后点击"一键催办"向商家联系人推送站内消息+短信 看板数据每 10 分钟刷新一次;催办操作记录至提醒记录(标记为"催办");同一对象 24 小时内催办不超过 3 次,超出提示"该对象今日已达催办上限"
10 查看提醒统计报表 切换至"提醒统计"页签,选择统计月份、对象类型,点击"生成报表" 展示该月各类型提醒发送量、送达成功率、商家响应率;以柱状图+折线图展示趋势;支持导出报表 统计维度支持按证照/合同分别查看;响应率=到期前完成更新/续签的商家数 ÷ 收到提醒的商家数 ×100%;当月数据次月 1 日生成完整报表

15.5.3 原型

原型1:提醒规则配置页

到期提醒配置 - 规则配置
证照到期 合同到期
规则状态: 生效中 保存配置 重置
提醒时间节点配置 + 新增节点 至少启用 1 个节点
启用 到期前(天) 提醒渠道 提醒对象 模板状态 操作
天 站内消息 已配置 短信 已配置 编辑模板 删除
天 站内消息 已配置 短信 已配置 邮件 已配置 编辑模板 删除
天 站内消息 已配置 短信 已配置 编辑模板 删除
天 站内消息 已配置 短信 未配置 编辑模板 删除
模板预览(节点:到期前 15 天 / 短信) 切换渠道 变量替换测试

【云灵汐】尊敬的{merchant_name},您的{cert_type}(编号:{cert_no})将于{expire_date}到期,剩余{days_remaining}天。请及时更新以免影响店铺正常经营,如有疑问请联系平台运营对接人。

可用变量:{merchant_name} {cert_type} {cert_no} {expire_date} {days_remaining} {shop_name} {contact_name}

原型2:提醒看板页

到期提醒看板
30 天内到期数
128 条
证照 86 / 合同 42
已过期数
15 条
证照 9 / 合同 6
本月提醒发送量
3,562 条
送达成功率 98.5%
商家响应率(本月)
72.3%
较上月 +5.2%
对象类型: 到期范围: 一键催办 导出
商家/店铺名称 对象类型 证照/合同编号 到期日期 剩余天数 最近提醒 操作
杭州山水旅行社 证照 BL-20231015 2026-08-02 3 天 2026-07-28 催办
上海携程国际旅行社 合同 HT-20240101 2026-08-05 6 天 2026-07-25 催办
南京青旅假日旅行社 证照 ID-20230520 2026-08-10 11 天 2026-07-20 催办
成都熊猫文旅集团 合同 OTA-20231115 2026-08-18 19 天 2026-07-19 催办
广州广之旅国际旅行社 证照 BL-20220901 2026-07-28 已过期 2026-07-28 催办
数据更新时间:2026-07-30 03:00  |  每 10 分钟自动刷新

15.5.4 状态说明

状态名称 状态标识 触发条件 业务影响 后续流转
生效中 生效中 规则整体开关为"启用",且至少 1 个提醒节点处于启用状态,定时任务正常执行 每日凌晨 03:00 定时扫描,命中节点的证照/合同正常触发提醒推送;提醒记录正常生成 运营人员停用整体开关 → 转为"已暂停";关闭全部节点 → 转为"部分暂停"
已暂停 已暂停 运营人员手动将规则整体开关切换为"停用" 所有提醒节点均不触发,定时扫描任务跳过该类型规则;已生成的历史提醒记录保留;看板与统计正常展示 运营人员重新启用整体开关 → 转为"生效中"
部分暂停 部分暂停 规则整体开关为"启用",但部分提醒节点被关闭(至少 1 个节点关闭且至少 1 个节点启用) 仅启用节点触发提醒,关闭节点不触发;不影响其他节点正常推送;看板中关闭节点的提醒记录不再新增 关闭全部节点 → 转为"已暂停"(系统自动判定);启用全部关闭节点 → 转为"生效中"
待生效 待生效 规则已配置并保存,但尚未到下一次定时任务执行时间(凌晨 03:00) 规则已入库但未实际触发提醒;页面展示"待生效"提示"将于次日 03:00 首次执行" 到达定时任务执行时间并成功扫描 → 转为"生效中"
已触发 已触发 定时任务扫描命中提醒节点,且提醒消息已成功推送至全部配置渠道 提醒记录生成且送达状态为"成功";看板"最近提醒"时间更新;统计发送量+1 该状态为单次提醒的终态;下一节点到期时重新触发新的提醒
触发失败 触发失败 提醒消息推送时,短信/邮件渠道服务异常或接收人信息缺失,导致送达失败 提醒记录送达状态标记为"失败";系统自动进入重试队列(最多 3 次,间隔 10/30/60 分钟);站内消息渠道失败不影响其他渠道 重试成功 → 转为"已触发"(送达状态更新为"成功");重试 3 次仍失败 → 终态"失败",需人工介入处理

15.5.5 异常处理

异常场景 触发条件 处理策略 提示信息 重试/恢复机制
短信/邮件服务不可用 短信网关或邮件服务接口超时、返回错误码、服务宕机,导致提醒消息推送失败 该渠道提醒记录标记为"失败"并进入重试队列;站内消息渠道不受影响正常推送;运营端看板统计卡片展示"送达成功率"下降告警 系统告警通知平台运营负责人:"短信服务异常,到期提醒推送失败 N 条,已加入重试队列" 自动重试 3 次,间隔 10 分钟、30 分钟、60 分钟;重试期间服务恢复则自动补发;3 次仍失败转人工,运营人员可在提醒记录页手动"重新发送"
商家联系人手机号/邮箱为空 店铺档案中商家联系人手机号或邮箱字段为空,短信/邮件渠道无法推送 跳过该接收人的短信/邮件推送,仅推送站内消息;提醒记录中该接收人送达状态标记为"接收人信息缺失";不影响同节点其他接收人正常推送 提醒记录详情提示:"商家联系人手机号为空,短信提醒未发送,请前往店铺档案补充联系人信息" 不自动重试;运营人员补充联系人信息后,可在提醒记录页手动"重新发送";看板中该商家标记"信息缺失"标签
提醒模板变量未替换 模板中包含的变量占位符无法匹配到实际数据(如商家名称为空、证照编号缺失),导致变量未被替换 保存模板时校验必填变量是否存在;运行时若变量值为空,以"—"占位替换后正常发送,同时在提醒记录中标记"变量缺失"告警 模板编辑保存时:"模板缺少必填变量 {merchant_name},请检查模板内容";运行时告警:"提醒 ID xxx 存在未替换变量,请检查数据完整性" 不自动重试;运营人员检查对应证照/合同数据补全后,下次提醒自动正确替换;历史错误记录可在详情页查看未替换变量列表
多节点重复触发提醒 同一证照/合同在多个时间节点配置了相近天数(如 7 天和 6 天),导致连续多日重复推送;或定时任务异常重复执行 系统按"证照/合同编号 + 节点天数"维度去重,同一对象同一节点当日仅触发一次;任务执行前校验当日是否已生成同维度提醒记录,已存在则跳过 无前端提示(系统静默去重);提醒记录中可查看去重日志:"对象 xxx 节点 7 天已于今日触发,跳过重复推送" 不重试;去重逻辑在任务执行前校验;若运营人员误配相近天数节点,保存时提示"节点 7 天与 6 天较接近,可能造成重复提醒,建议合并"
定时任务执行超时 全平台证照/合同数据量过大(超过 50 万条),单次定时扫描任务执行时间超过 2 小时未完成 任务采用分批处理(单批 1000 条),支持断点续跑;超时后自动记录已处理进度,下一批次从断点继续;不影响已成功推送的提醒 系统告警通知平台运营负责人:"到期提醒扫描任务执行超时,已处理 N/M 条,将在下次任务周期续跑" 支持手动触发"立即执行"补全未处理部分;若连续 3 天超时,系统自动调小单批处理量并告警建议数据归档清理
提醒记录存储失败 提醒消息已成功推送,但提醒记录写入数据库失败(数据库连接异常、磁盘空间不足等) 消息推送与记录写入采用异步解耦;记录写入失败时暂存至本地消息队列/日志文件,待数据库恢复后异步补偿写入;不影响消息实际推送 系统告警通知运维:"到期提醒记录写入失败 N 条,已暂存至补偿队列,待数据库恢复后自动补录" 补偿任务每小时执行一次,检测数据库可用后自动补录暂存记录;补偿成功后记录状态正常;超过 7 天未补录的记录永久丢失并告警
关键风险提示
  • 数据准确性风险:证照/合同到期日期依赖商家上传与运营录入的准确性,若到期日期错误将导致提醒失效。建议定期抽检到期日期字段完整性。
  • 服务依赖风险:短信与邮件渠道为外部服务依赖,服务中断期间提醒将延迟。站内消息作为保底渠道必须始终保持可用,避免出现"零提醒"情况。
  • 合规风险:短信与邮件营销类通知需符合相关法规要求,提醒内容不得包含营销推广信息,仅限于到期事项告知。短信发送频次需控制,避免被运营商拦截。

16. 系统初始化与依赖顺序

本章明确商家与店铺管理模块上线前的初始化数据、外部系统依赖关系以及模块间的启动顺序,确保系统平稳上线。

16.1 初始化数据清单

初始化项数据内容负责方优先级备注
经营类目体系三级类目数据(一级类目10-15个、二级类目30-50个、三级类目100-200个),含类目编码、名称、层级关系、状态平台运营+产品P0类目体系确定后不易变更,需审慎规划
商家等级规则五级等级定义(普通/铜牌/银牌/金牌/钻石)、各等级权益配置、自动升降级阈值规则产品+运营P0权益配置影响结算系统,需财务确认
合同模板四类合同模板(供应商入驻协议/平台公共分销协议个人版/平台公共分销协议企业版/OTA分销协议),含全部变量和条款法务+产品P0需法务审核通过后方可上线
证照类型配置各类商家对应的必填/选填证照类型、文件格式要求、OCR识别字段映射产品+技术P1影响入驻表单和审核流程
敏感词库店铺名称禁用词汇、企业名称禁用词汇、证照审核敏感标记规则运营+风控P1需定期更新维护
平台运营账号创建平台超级管理员和运营审核人员账号,配置角色权限(商家审核、店铺审核、合同管理、证照预警看板)系统管理员P0权限配置参考《基础功能与权限管理PRD》
电子签章服务配置对接电子签章服务商(如e签宝/法大大),配置平台方签署证书、模板ID、回调地址技术P0测试环境需配置沙箱环境
OCR服务配置对接OCR识别服务商,配置营业执照识别、身份证识别接口,设置置信度阈值(0.7)技术P1需准备测试图片验证识别准确率
短信/邮件模板配置入驻通知、审核结果通知、合同签署通知、证照预警通知、续签提醒等全部消息模板运营+产品P1需通过消息平台审核
大促日历配置年度大促日期(双11、618、国庆等),用于店铺休息管控运营P2每年初更新

16.2 外部系统依赖关系

flowchart LR
    A[商家与店铺管理模块] --> B[电子签章服务]
    A --> C[OCR识别服务]
    A --> D[消息通知服务]
    A --> E[文件存储服务]
    A --> F[财务结算系统]
    A --> G[商品供应链系统]
    A --> H[订单履约系统]
    A --> I[权限管理系统]
    A --> J[C端商城系统]
    B -->|签署回调| A
    C -->|识别结果| A
    D -->|发送状态| A
    
图16-1:商家与店铺管理模块外部依赖关系图
依赖系统依赖内容调用方式降级策略
电子签章服务合同生成、签署链接、签章证书HTTP API切换线下签署模式,商家上传扫描件,运营手动标记
OCR识别服务营业执照识别、身份证识别HTTP API提示商家手动填写,不阻断入驻流程
消息通知服务短信、邮件、站内消息发送MQ/HTTP API记录发送失败日志,运营人工补发重要通知
文件存储服务证照图片、合同PDF、LOGO图片存储SDK/API上传失败提示稍后重试,技术排查存储服务
财务结算系统商家等级同步、佣金比例同步、结算账号校验MQ异步同步,失败时重试3次后告警
商品供应链系统店铺状态同步(休息/冻结/关闭时商品下架)MQ同步失败时人工介入处理商品状态
订单履约系统店铺关闭时校验未处理订单HTTP API超时重试,失败时允许关闭但记录风险订单
权限管理系统用户角色鉴权、菜单权限、数据权限RPC/HTTP本地缓存权限配置,缓存失效时降级为只读
C端商城系统店铺状态、等级徽章、客服信息展示缓存/HTTP缓存兜底,接口异常时展示缓存数据

16.3 模块启动与数据迁移顺序

顺序步骤前置条件验收标准
1部署商家与店铺管理数据库表结构(t_merchant、t_shop、t_certificate、t_contract、t_merchant_change_log等)数据库中间件就绪全部表创建成功,索引建立完成,无报错
2导入初始化数据(经营类目、商家等级、合同模板、证照类型配置、敏感词库)步骤1完成初始化数据查询正常,数量与清单一致
3配置外部服务连接(电子签章、OCR、消息通知、文件存储)外部服务账号已开通连通性测试通过,返回预期结果
4部署商家与店铺管理后端服务步骤1-3完成服务启动无报错,健康检查接口返回200
5部署商家与店铺管理前端页面(平台运营端+供应商后台+分销商后台)步骤4完成前端页面可正常访问,路由正确
6配置权限系统菜单和按钮权限步骤5完成,权限管理系统已上线各角色登录后可见对应菜单和功能按钮
7配置MQ消息队列(与财务、商品、订单系统的Topic/Exchange)消息中间件就绪消息发送和消费测试通过
8全链路集成测试(入驻→审核→签约→开店→经营→关闭完整流程)步骤1-7完成,关联系统已上线端到端流程跑通,数据一致性校验通过
9性能测试(商家列表查询、批量导出、证照上传并发)步骤8完成满足性能基线(列表查询≤800ms,上传≤5s)
10安全审计(敏感信息脱敏、权限边界、SQL注入/XSS防护)步骤8完成安全扫描无高危漏洞,脱敏规则生效

16.4 与已有PRD模块的衔接说明

衔接模块衔接点数据流向约束条件
基础功能与权限管理PRD用户注册/登录、角色权限、菜单管理商家与店铺管理模块调用权限系统鉴权,商家入驻成功后为商家创建账号和角色权限系统必须先于本模块上线
商品供应链管理中心PRD商品发布时选择店铺、店铺状态影响商品上下架店铺状态变更→MQ通知→商品系统下架/上架商品商品系统需订阅店铺状态变更消息
订单履约全链路PRD店铺关闭时校验未处理订单、订单中展示店铺信息店铺关闭前查询订单系统待处理订单数;订单详情页调用店铺信息接口订单系统需提供待处理订单查询接口
分销中心模块PRDB端分销商入驻绑定目标供应商、分销协议签署分销商入驻时读取供应商列表(已激活状态);分销协议签署调用合同管理模块供应商必须先入驻激活,才能被B端分销商选择
财务中心模块PRD商家等级影响佣金比例、结算账号管理、冻结时暂停结算商家等级变更→MQ通知→财务系统更新结算规则;店铺冻结→MQ通知→暂停结算财务系统需订阅等级变更和状态变更消息

17. 验收标准

本章定义商家与店铺管理模块的验收标准,覆盖功能验收、性能验收、安全验收和用户体验验收四个维度,确保交付质量可直接进入生产环境。

17.1 功能验收标准

功能项验收场景预期结果验收方法
供应商入驻申请供应商填写完整资料并提交入驻申请生成商家记录(status=审核中),平台运营收到审核通知,商家进入入驻进度页端到端流程测试
分销商分类入驻个人/B端/OTA分别提交入驻申请三种类型加载不同表单,提交后进入对应审核流程三类分销商分别测试
B端分销商双审B端分销商提交申请,供应商初审通过后平台终审初审通过后自动推送终审,双审时间轴正确展示,超时自动通过模拟双审全流程
OTA入驻与接口验证OTA资料审核通过后接口验证系统自动调用商品查询和订单创建接口,验证通过生成合同使用模拟OTA接口测试
商家列表与详情查询平台运营按多种条件组合查询商家查询结果准确,分页正常,详情页信息完整,敏感信息脱敏数据覆盖测试+边界测试
商家主体资料维护商家修改核心字段,平台运营审核核心字段修改生成待审核变更,审核通过后更新,驳回后保留原值正向+驳回场景测试
经营类别与等级管理平台运营修改商家等级和经营类别等级变更次月1日生效,类别变更即时生效,历史记录可追溯状态流转测试
店铺列表与详情查询商家查看旗下店铺列表,平台运营查看全量店铺数据权限正确,默认店铺机制生效,详情页经营数据准确角色权限交叉测试
店铺信息维护商家编辑店铺名称、LOGO、类型等信息非类型变更即时生效,类型变更需审核,LOGO生成多尺寸缩略图各类字段编辑测试
店铺状态管理商家设置休息/恢复,平台运营冻结/解冻/关闭状态流转符合权限规则,C端展示同步更新,操作日志完整全状态流转矩阵测试
证照上传与审核商家上传各类证照,平台运营审核OCR自动识别并比对,审核通过后证照可用,驳回后显示原因多类型证照上传测试
证照有效期预警模拟证照即将过期和已过期场景五级预警按时触发,通知渠道正确,过期后功能受限,更新后解除定时任务触发测试
合同生成与签署入驻审核通过后合同生成,商家电子签章签署合同PDF生成正确,变量替换无误,签署链接72小时有效,签署后生效电子签章全流程测试
合同续签与变更合同到期前续签提醒,商家申请续签,平台发起变更续签流程完整,变更对比展示正确,宽限期机制生效续签+变更+拒绝场景测试

17.2 性能验收标准

指标项基准值测试条件测试工具
商家列表查询响应时间≤800ms(P95)商家总量10万,每页20条,并发100用户JMeter
店铺列表查询响应时间≤600ms(P95)店铺总量20万,每页20条,并发100用户JMeter
商家详情页加载时间≤1000ms(P95)含关联店铺列表(100家)和操作日志(1000条)JMeter
证照上传处理时间≤5s(含OCR识别)单张10MB以内图片,网络正常手工+自动化
合同PDF生成时间≤3s标准合同模板,变量20个以内自动化测试
批量导出商家数据≤60s(10万条Excel)全量导出,异步生成手工测试
数据库查询QPS≥2000商家/店铺相关查询混合负载JMeter
前端首屏加载时间≤2s商家端首页,含等级徽章和经营数据Lighthouse

17.3 安全验收标准

安全项验收标准验收方法
敏感信息脱敏统一社会信用代码默认脱敏(显示前4后4),银行卡号仅显示后4位,法人身份证号脱敏;点击"显示完整"需二次确认并记录审计日志人工检查+日志审计
数据权限隔离平台运营可见全量商家;供应商仅可见自身档案和店铺;分销商仅可见自身档案;跨商家数据不可访问(水平越权测试)越权测试(修改URL参数尝试访问其他商家数据)
操作权限控制商家不可编辑核心字段(需平台审核);平台运营不可代商家签署合同;角色未授权功能不可见不可访问角色权限矩阵测试
SQL注入防护全部数据库操作使用参数化查询,禁止字符串拼接SQL;模糊搜索特殊字符转义SQLMap扫描+手工注入测试
XSS防护全部用户输入在展示时进行HTML转义;富文本编辑器输出进行XSS过滤手工XSS测试+自动化扫描
文件上传安全上传文件校验MIME类型、后缀白名单(jpg/png/pdf)、大小限制;存储路径不可预测;禁止执行权限上传恶意文件测试(php、exe等)
接口限流商家列表接口每IP限流100次/分钟,超限返回429;验证码错误3次后失效压力测试验证限流阈值
并发修改防护资料编辑使用乐观锁(version字段),并发保存时后提交者收到冲突提示并发请求测试
审计日志完整性全部写操作(增删改)记录审计日志,包含操作人、时间、IP、操作前值、操作后值;日志不可删除和修改日志查询+完整性校验

17.4 用户体验验收标准

体验项验收标准验收方法
页面响应全部页面操作在1秒内给出视觉反馈(按钮loading、Toast提示);超过3秒的操作显示进度条或骨架屏人工操作+计时
错误提示全部错误场景给出明确的中文提示,告知用户原因和下一步操作;禁止展示技术错误码和堆栈信息异常场景全覆盖测试
表单校验必填项失焦即时校验,格式错误实时提示;提交时汇总展示全部错误;长表单分区块展示进度表单边界测试
空状态处理列表无数据时展示空状态插图+引导文案(如"暂无店铺,点击新增");搜索无结果时提示"未找到符合条件的商家,建议更换搜索词"人工检查
移动端适配商家后台核心页面(入驻、证照上传、店铺管理)在1366×768及以上分辨率正常展示;关键操作在移动端浏览器可完成多分辨率测试
浏览器兼容支持Chrome 90+、Firefox 88+、Edge 90+、Safari 14+;IE11仅保证核心功能可用多浏览器测试
无障碍关键表单元素有关联label;图片有alt文本;颜色对比度≥4.5:1Lighthouse无障碍评分≥80

17.5 验收通过判定规则

  • P0功能:全部通过,不允许有阻塞性缺陷。P0功能包括:四类商家入驻申请、商家列表查询、店铺列表查询、合同生成与签署、证照上传与审核。
  • P1功能:允许存在≤2个非阻塞性缺陷,且缺陷必须有临时规避方案。P1功能包括:经营类别与等级管理、商家资料维护、店铺信息维护、店铺状态管理、证照有效期预警。
  • 性能指标:全部P0性能指标达到基准值,P1性能指标允许有1项偏差不超过20%。
  • 安全项:高危漏洞必须为0,中危漏洞≤3个且必须有修复计划,低危漏洞≤10个。
  • 用户体验:Lighthouse性能评分≥70,无障碍评分≥80,最佳实践评分≥85。
  • 文档:接口文档完整(Swagger/YApi),操作手册覆盖全部平台运营功能,商家帮助中心FAQ覆盖入驻、证照、合同常见问题。
验收负责人:产品经理主导,测试工程师执行测试用例,开发工程师修复缺陷,运维工程师验证部署和性能,安全工程师进行安全扫描,运营代表进行业务逻辑验收。全部验收项通过后由项目经理签字确认,方可上线生产环境。

附录A:质量自检清单

本文档在输出前已按照《PRD-产出SOP与深度标准模板》的要求进行自检,自检结果如下:

检查项标准是否满足说明
文档结构完整性包含文档元信息、术语表、需求背景、目标与范围、用户与角色、功能清单、系统架构、核心业务流程、全局规则、页面路由、数据模型、功能模块详解(≥3章)、系统初始化、验收标准是本文档共17章,结构完整
功能点覆盖度功能清单中的全部功能点在正文中均有对应章节覆盖是14个功能点全部覆盖(12.1-12.4、13.1-13.3、14.1-14.3、15.1-15.4)
五级深度要求每个功能点包含:业务逻辑、交互说明表(≥8行)、页面原型、状态说明表(≥6种)、异常处理(≥5种)是全部14个功能点均满足五级深度要求
状态码规范使用中文状态描述,不出现英文枚举值是全部状态使用中文描述
前端计算字段声明前端计算字段明确标注"不存储于数据库"是已在数据模型和交互表中声明
数据模型完整性核心实体包含字段定义、类型、约束、备注是第11章数据模型覆盖全部核心实体
流程图完整性核心业务流程使用Mermaid流程图/状态机表达是第8章及功能模块中均包含流程图
交互原型关键页面提供HTML/CSS交互原型是全部14个功能点均包含页面原型
与已有PRD衔接明确标注与已有PRD模块的衔接点和数据流向是第16.4节详细说明与5个已有PRD的衔接
可落地性需求描述无歧义、无模糊词汇、无可行性疑问是全部需求可量化、可测试、可验收

附录B:功能点与章节索引

功能清单编号功能名称所属模块PRD章节
2.1供应商入驻申请入驻管理12.1
2.2分销商分类入驻入驻管理12.2
2.3B端分销商双审入驻管理12.3
2.4OTA入驻与接口验证入驻管理12.4
2.5商家列表与详情查询商家档案13.1
2.6商家主体资料维护商家档案13.2
2.7经营类别与等级管理商家档案13.3
2.8店铺列表与详情查询店铺管理14.1
2.9店铺信息维护店铺管理14.2
2.10店铺状态管理店铺管理14.3
2.11证照上传与审核证照与合同15.1
2.12证照有效期预警证照与合同15.2
2.13合同生成与签署证照与合同15.3
2.14合同续签与变更证照与合同15.4