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

PC端内容信息管理模块 PRD

版本:v1.2 日期:2026-08-13 状态:正式稿 密级:内部

1. 文档元信息

1.1 文档基本信息

属性内容
文档名称云灵汐涉旅电商分销子系统 - PC端内容信息管理模块PRD
文档编码ylx-pc-content-prd-v1
版本号v1.2
深度等级深度
发布日期2026-08-11
文档状态正式稿
密级内部
编写人产品经理
适用范围平台运营后台 - 基础管理下的内容管理与消息管理子模块

1.2 修订记录

版本日期修订人修订内容
v1.02026-08-11产品经理初版,覆盖公告管理、平台协议及声明、敏感词库、关键词管理、站内信管理、短信模板管理、通知规则管理7个功能模块,遵循PRD产出SOP v1.0深度等级标准
v1.12026-08-12产品经理移除短信模板管理(Ch17)和通知模板管理(Ch17A),短信模板管理由PC端商品供应链管理中心PRD承接;更新功能范围表、功能清单、数据模型、通知规则、验收标准、质量自检等相关章节
v1.22026-08-13产品经理新增内容发布聚合入口(Ch11A),将公告管理、文章/资讯管理、须知管理、帮助管理统一为内容发布聚合入口,Tab名称分别为公告管理/文章管理/须知管理/帮助指南;新增须知管理(Ch15C)和帮助管理(Ch15D)两个功能模块,含t_notice/t_notice_spu/t_help/t_help_read四张新表;取消公告管理和文章/资讯独立菜单入口;新增工作台公告发布入口(Ch11B);明确公告、文章、须知、帮助为四个独立数据表(t_announcement/t_article/t_notice/t_help);统一内容分类预置为公告管理/文章管理/须知管理/帮助指南四个一级分类;调整文章类型枚举为新闻(公告/须知/帮助已独立成表);更新导航、功能范围、功能清单、页面路由、数据模型、原型示例、系统初始化、验收标准、质量自检等相关章节

1.3 需求分类卡片

维度分类结果
需求类型新模块设计
复杂度中等(7个功能模块,跨三端触达,但无复杂资金/状态流转)
受众角色多角色(平台运营/法务/管理员为操作方;供应商/分销商为接收方)
行业属性综合涉旅
风险等级中(协议版本管理涉及合规,敏感词涉及内容风控,通知规则涉及多渠道消息分发)

2. 术语表

本章列出内容信息管理模块涉及的全部专业术语,确保全文档命名一致、指代明确。

术语定义
站内信平台通过后台系统向供应商、分销商等后台用户发送的系统内消息,支持已读/未读状态跟踪和业务页面跳转
公告平台面向全平台或指定范围用户发布的公开通知信息,支持置顶、下架,在后台首页或专属公告区展示
平台协议及声明平台运营所需的各类法律文本,以协议编码为唯一标识、协议标题为展示名称,采用版本管理机制
敏感词因合规、风控或运营需要而禁止或限制在商品名称、用户评价、站内信、公告等内容中使用的词汇,分拦截、替换、审核三个处理级别
关键词用于C端商城搜索运营的词汇集合,分为热门搜索词、推荐搜索词、屏蔽搜索词三类
短信模板由PC端商品供应链管理中心统一管理的短信发送模板,包含模板内容、触发场景和变量占位符。详见供应链管理中心PRD。
通知规则定义业务事件触发通知的配置规则,包含触发事件、接收对象、通知渠道(站内信/短信)、关联模板、启停状态
通知渠道通知消息的投递通道,本模块支持站内信和短信两个渠道,可单选或组合使用
触发事件业务系统中可引发通知的事件,如订单创建、支付成功、售后提交、佣金结算、协议即将到期等
协议版本同一协议编码在不同时间发布的修订版本,以版本号标识,同一时间同一协议编码仅一个版本处于生效状态
协议再确认当协议发布新版本后,已签署旧版本的用户在下次登录或操作时需重新确认新版本协议方可继续使用
命中记录敏感词在用户提交内容中被系统检测到并处理的记录,包含命中词汇、来源内容、处理方式、处理时间
阅读统计公告发布后对各端用户的阅读情况进行追踪统计,包含已读人数、未读人数、阅读率

3. 需求背景

3.1 业务背景

云灵汐涉旅电商分销子系统连接平台运营方、供应商、分销商三类主体,以及C端消费者。平台在日常运营中需要向供应商和分销商传递政策变更、系统维护、活动通知等信息;在合规层面需要管理服务协议、隐私协议等法律文本的版本与生效;在内容风控层面需要对商品名称、用户评价、站内信等UGC内容进行敏感词过滤;在搜索运营层面需要维护热门搜索词和推荐词以提升C端购物体验。这些能力分散在内容管理和消息管理两个子模块下,是平台基础管理的重要组成部分。

3.2 触发来源

3.3 用户现状与痛点

痛点现状描述影响
公告触达无管理平台通知依赖微信群或邮件逐个发送,无统一发布入口,无阅读统计重要通知遗漏率高,无法确认供应商/分销商是否已知晓
协议版本混乱协议文本散落在多个文档中,更新后无版本记录,用户签署状态不可追溯合规审计无法举证,协议变更后老用户未重新确认
敏感词无统一管理商品审核时人工判断违规词,无词库支撑,各审核人员标准不一违规内容漏审风险高,审核效率低
通知发送无规则订单状态变更、佣金结算等事件触发后,运营人员需手动发送站内信或短信通知不及时、易遗漏、人力成本高
短信发送无模板短信内容临时编写,变量替换靠人工,无审核流程短信内容不规范,变量错误频发,无法追溯发送记录

3.4 不做会怎样

4. 目标与范围

4.1 核心设计原则

六项设计原则
1. 统一管理、多端触达:内容与消息在平台运营后台统一管理,触达供应商后台、分销商后台及C端商城
2. 版本可追溯:协议文本采用版本管理,历史版本永久存档,生效版本同一时间唯一
3. 事件驱动通知:通知规则将业务事件与通知动作解耦,运营配置规则后由系统自动触发
4. 风控前置:敏感词库在内容提交时自动校验,拦截/替换/审核三级处理,不让违规内容进入展示
5. 合规留痕:公告发布、协议签署、通知发送等关键操作均记录操作日志,满足审计要求
6. 权限分离:内容发布、协议管理、敏感词维护等操作按角色分配权限,法务审核与运营发布分离

4.2 功能范围

序号功能模块优先级范围说明
1内容发布(聚合入口)P1公告管理、文章管理、须知管理、帮助指南四种内容管理入口的统一管理入口,通过Tab切换区分内容类型,取消公告管理和文章/资讯独立菜单入口
2公告管理P1公告的新建、编辑、发布、置顶、下架、阅读统计,支持按接收对象范围定向发布(通过内容发布-公告管理Tab进入)
3平台协议及声明P1六类协议文本的版本管理:草稿、审核、发布、生效、历史归档,支持协议再确认机制
4敏感词库管理P2敏感词的新增、编辑、启停、批量导入、分类管理、命中记录查询
5关键词管理P1热门搜索词、推荐搜索词、屏蔽搜索词的维护与排序,搜索统计
6内容分类管理P1多级内容分类树的新增、编辑、删除、启停与排序,系统预置公告管理/文章管理/须知管理/帮助指南四个一级分类,被文章引用时不可删除
7文章/资讯管理P1文章(新闻及后续扩展类型)的创建、编辑、删除、查询、上下架、置顶、推送、阅读统计(通过内容发布-文章管理Tab进入)
8须知管理P1须知的创建、编辑、发布、下架、删除,支持平台和供应商各自创建管理,须知绑定至商品SPU级,含购买须知/出行须知/退改须知/安全须知/使用须知/其他六种类型(通过内容发布-须知管理Tab进入)
9帮助管理P1帮助内容的创建、编辑、发布、下架、置顶、删除,含新手指南/常见问题/操作手册/规则说明四种类型,支持阅读统计(通过内容发布-帮助指南Tab进入)
10站内信管理P1站内信的手动发送与自动触达、已读未读跟踪、业务页面跳转、消息列表管理
11通知规则管理P1通知规则的创建、触发事件配置、接收对象配置、渠道选择、模板关联、启停管理
—短信模板管理—由PC端商品供应链管理中心PRD承接,本章不含。短信模板的创建、编辑、启停、预览、发送记录
—通知模板管理—已移除,站内信模板内容在站内信模块(第16章)中内联配置,不单独抽取模板管理
短信模板管理说明:短信模板管理由PC端商品供应链管理中心PRD统一承接,内容信息管理PRD不重复设计。通知模板管理已移除,站内信模板内容在站内信模块(第16章)中内联配置。

4.3 不在本次范围

排除项原因
App推送通知(Push)本期仅支持站内信和短信两个渠道,App推送通知待移动端PRD覆盖
邮件通知本期不做邮件渠道,后续按需扩展
微信订阅消息模板管理微信订阅消息属于移动端能力,由移动端PRD覆盖。甲方Excel功能清单中"模板消息-调用微信API发送模板消息"由移动端PRD承接,本PRD不覆盖,质量自检中不计为已覆盖项
AI内容生成与审核AI全场景助手已确认暂缓,本期敏感词采用词库匹配方式
内容素材库管理图片/视频素材管理归入商品管理中心-素材管理模块

4.4 上下游模块关系

上下游模块关系类型交互说明
权限中心上游依赖提供角色权限、按钮权限、数据权限,内容管理与消息管理各功能按钮按角色控制可见性
商家主体与店铺管理下游消费站内信和公告按商家类型(供应商/分销商/OTA)定向发送;协议签署状态关联商家档案
商品供应链管理中心下游消费敏感词库为商品名称、商品详情审核提供校验;关键词为C端搜索提供服务
订单履约全链路下游消费通知规则监听订单状态变更事件(创建、支付、收单、核销、售后),自动触发站内信和短信
分销中心下游消费通知规则监听佣金结算、提现审核、协议到期等事件,自动触发通知
财务中心下游消费通知规则监听结算单生成、对账完成、打款成功/失败等事件
营销中心下游消费通知规则监听活动开始、优惠券到账等事件
系统配置上游依赖提供短信网关配置、存储服务等基础设施配置

5. 用户与角色

本模块的操作方均为平台运营后台角色,供应商和分销商为内容与消息的接收方。各角色的数据权限范围和核心操作如下表。

角色所属后台数据权限范围核心操作
平台运营平台运营后台全平台内容与消息数据公告发布与管理、站内信发送、关键词维护、通知规则配置
法务专员平台运营后台协议文本数据协议文本编辑、协议版本审核、协议发布
平台管理员平台运营后台全平台配置数据敏感词库管理、通知规则启停、系统初始化配置
供应商供应商后台本供应商站内信与公告查看站内信、查看公告、协议签署确认(接收方)
分销商分销商后台本人/本租户站内信与公告查看站内信、查看公告、协议签署确认(接收方)
权限分离原则:法务专员负责协议文本的内容编写与审核,平台运营负责公告和站内信的发布,平台管理员负责敏感词库管理。协议发布需法务审核通过后方可生效,运营人员不可直接发布未经审核的协议。

6. 功能清单

下表列出内容信息管理模块的全部功能点,每个功能点包含所属模块、功能名称、功能描述、适用角色和优先级。

序号所属模块功能名称功能描述适用角色优先级
1公告管理公告列表与筛选提供平台全部公告的列表视图,支持按公告标题、公告分类、接收范围、状态筛选。列表展示标题、公告分类、接收范围、状态、阅读统计、创建时间、最新发布时间和操作入口。支持分页和导出平台运营P1
2公告管理公告新建与编辑平台运营通过富文本编辑器创建公告内容,配置公告分类(内容分类树)、接收对象范围(全部/供应商/分销商)、置顶。支持草稿保存和预览;已发布公告仅可编辑置顶与排序平台运营P1
3公告管理公告发布与下架草稿状态的公告可发布,发布后在各接收端展示;已发布的公告可下架,下架后各端不再展示该公告。下架后可重新上架平台运营P1
4公告管理公告置顶管理已发布公告可设置置顶,同一接收范围下最多同时置顶3条公告,置顶公告在列表顶部优先展示。可在编辑弹窗中通过置顶开关和排序设置,也可在列表行内执行置顶/取消置顶操作平台运营P1
5公告管理公告阅读统计对已发布公告统计各接收端的阅读情况,包含已读人数、未读人数、阅读率,支持按接收对象类型(供应商/分销商)分组查看明细平台运营P1
6平台协议及声明协议列表与版本管理按协议编码分组展示各协议的当前生效版本、历史版本。支持按协议编码/标题筛选,查看版本详情、生效状态、版本变更记录法务专员/平台运营P1
7平台协议及声明协议版本编辑与审核法务专员创建新版本协议,填写协议标题、版本号、协议内容(富文本)、生效方式(立即生效/定时生效)、变更说明,协议编码由系统自动生成。提交后进入审核流程,审核通过后方可发布法务专员P1
8平台协议及声明协议发布与生效审核通过的协议版本可发布生效,同编码旧版本自动失效;支持手动停用已生效版本。已发布生效过的版本不可删除。新版本生效或旧版本停用后触发已签署用户的再确认流程法务/平台管理员P1
9敏感词库管理敏感词列表与筛选展示全部敏感词列表,支持按词汇、分类(政治/色情/广告/欺诈/其他)、级别(拦截/替换/审核)、状态筛选。列表展示词汇、分类、级别、状态、命中次数、创建时间平台管理员/运营P2
10敏感词库管理敏感词新增与编辑支持单个新增和批量导入(Excel/文本)敏感词,配置词汇分类、处理级别、替换词(替换级别适用)。编辑时记录修改前后值平台管理员P2
11敏感词库管理敏感词启停与命中记录支持敏感词的启用/停用,停用后不再参与内容校验。命中记录展示敏感词被检测到的来源内容、处理方式、命中时间,支持筛选查询平台管理员P2
12关键词管理关键词列表与分类展示热门搜索词、推荐搜索词、屏蔽搜索词三类关键词列表,支持按类型、状态筛选。列表展示词汇、类型、排序权重、搜索次数、状态平台运营P1
13关键词管理关键词维护与排序支持新增、编辑、删除关键词,配置排序权重(数值越小越靠前)。热门词和推荐词支持批量导入,屏蔽词支持批量导入平台运营P1
14站内信管理站内信列表与筛选展示平台已发送的站内信列表,支持按标题、消息类型(系统/订单/售后/佣金/协议/公告)、发送时间、接收对象筛选。列表展示标题、类型、接收对象、已读率、发送时间和操作入口平台运营P1
15站内信管理站内信手动发送平台运营手动创建站内信,填写标题、内容、消息类型、接收对象(全部/指定角色/指定商家),可选择是否携带业务跳转链接。支持立即发送和定时发送平台运营P1
16站内信管理站内信已读跟踪与详情查看站内信发送详情,包含已读人数、未读人数、已读率,支持查看未读用户列表。接收端支持标记已读和点击跳转至关联业务页面平台运营P1
20通知规则管理通知规则列表与筛选展示全部通知规则列表,支持按规则名称、触发事件、状态筛选。列表展示规则名称、触发事件、接收对象、渠道、关联模板、状态平台运营P1
21通知规则管理通知规则创建与编辑创建通知规则,配置触发事件(订单创建/支付成功/售后提交/佣金结算/协议到期等)、接收对象、通知渠道(站内信/短信/两者)、关联站内信模板和短信模板、发送时机(即时/延迟)平台运营P1
22通知规则管理通知规则启停与执行日志支持通知规则的启用/停用,停用后该事件不再触发通知。执行日志展示规则触发记录、通知发送结果、失败原因平台运营P1
23内容分类管理分类树展示与查询树形结构展示全部分类,支持展开/折叠、按名称搜索。列表展示分类名称、层级、排序、文章引用数、状态。系统预置公告管理/文章管理/须知管理/帮助指南四个一级分类平台运营P1
24内容分类管理分类新增与编辑选择父分类后新增子分类(最多3级),填写分类名称、排序权重。编辑分类名称、排序权重(一级分类可改名不可删除)。同层级下分类名称唯一平台运营P1
25内容分类管理分类删除与启停删除未被文章引用且无子分类的分类节点(系统预置一级分类不可删除);支持启用/停用,停用后该分类及子分类在文章创建时不可选平台运营P1
26文章/资讯管理文章列表与筛选分页查询文章,支持按标题、文章类型(新闻及后续扩展类型)、内容分类、上下架状态、创建时间范围筛选平台运营P1
27文章/资讯管理文章创建与编辑通过富文本编辑器创建文章,选择文章类型和内容分类,填写标题、正文、封面图、摘要、作者。支持草稿保存和预览平台运营P1
28文章/资讯管理文章上下架草稿/已下架状态的文章可上架展示;已上架文章可下架,下架后C端不再展示。上下架操作记录操作日志平台运营P1
29文章/资讯管理文章置顶已上架文章可设置置顶,同一分类下最多置顶5篇,置顶文章在列表顶部优先展示平台运营P1
30文章/资讯管理文章删除支持单个删除和批量删除文章,删除后不可恢复需二次确认。已上架文章不可直接删除,需先下架平台运营P1
31文章/资讯管理文章推送上架文章时可选择推送至供应商/分销商后台收件箱,通过站内信通知。支持按接收对象范围定向推送平台运营P1
32文章/资讯管理文章阅读统计统计文章在各端的阅读情况,包含阅读人数、阅读次数、阅读率,支持按接收对象类型分组查看平台运营P1
33须知管理须知列表与筛选分页查询须知,支持按标题、须知类型(购买/出行/退改/安全/使用/其他)、创建方(平台/供应商)、状态筛选。列表展示标题、类型、创建方、供应商名称、状态、绑定SPU数、创建时间平台运营P1
34须知管理须知创建与编辑通过富文本编辑器创建须知,选择须知类型,填写标题和正文。平台运营创建的须知owner_type=platform;供应商在供应商后台创建的须知owner_type=supplier。支持草稿保存平台运营/供应商P1
35须知管理须知发布与下架草稿状态的须知可发布,已发布的须知可下架,下架后已绑定的SPU前端不再展示该须知。下架后可重新上架平台运营/供应商P1
37须知管理须知-SPU绑定管理从须知列表点击"绑定管理"打开绑定弹窗,左侧展示已绑定SPU列表(含解绑操作),右侧搜索SPU进行绑定。平台须知可绑定任意SPU,供应商须知只能绑定自有SPU。同一SPU同一类型下平台和供应商各最多1条平台运营/供应商P1
38须知管理须知删除草稿和已下架状态的须知可删除,已绑定SPU的须知需先解除绑定后删除。删除后不可恢复需二次确认平台运营/供应商P1
39帮助管理帮助列表与筛选分页查询帮助内容,支持按标题、帮助类型(新手指南/常见问题/操作手册/规则说明)、状态筛选。列表展示标题、类型、展示范围、状态、阅读人数、创建时间平台运营P1
40帮助管理帮助创建与编辑通过富文本编辑器创建帮助内容,选择帮助类型,填写标题、正文、封面图、摘要、排序权重、展示范围。支持草稿保存和预览平台运营P1
41帮助管理帮助发布与下架草稿状态的帮助可发布,发布后在各端帮助中心展示;已发布的帮助可下架,下架后各端不再展示。下架后可重新上架平台运营P1
42帮助管理帮助置顶已发布帮助可设置置顶,同一帮助类型下最多置顶5篇,置顶帮助在列表顶部优先展示平台运营P1
43帮助管理帮助删除草稿和已下架状态的帮助可删除,删除后不可恢复需二次确认。已发布帮助不可直接删除需先下架平台运营P1
44帮助管理帮助阅读统计统计帮助内容在各端的阅读情况,包含阅读人数(去重)、阅读次数(总点击),支持按接收对象类型分组查看平台运营P1
36公告管理公告标记已读接收端(供应商/分销商后台)展示公告时,用户点击公告查看详情后自动标记为已读,记录已读时间。未读公告以角标提示平台运营/供应商/分销商P1
说明:短信模板管理由PC端商品供应链管理中心PRD(63533_ylx-pc-supplychain-prd-v2)承接,内容信息管理PRD不含短信模板功能。站内信模板内容在站内信模块(第16章)中内联配置,不单独抽取模板管理。

7. 系统架构

7.1 内容信息管理在系统中的定位

内容信息管理模块位于平台运营后台的基础管理层,向上对接权限中心获取角色权限,向下为商品供应链、订单履约、分销中心、财务中心、营销中心等业务模块提供内容审核(敏感词)、消息触达(站内信+短信)、协议管理三类基础服务。该模块本身不处理业务逻辑,而是为业务模块提供内容治理和消息通知的基础能力。

flowchart TB
  subgraph 客户端层
    A1["平台运营后台<br/>内容管理与消息管理"]
    A2["供应商后台<br/>收件箱-站内信/公告"]
    A3["分销商后台<br/>收件箱-站内信/公告"]
    A4["C端商城<br/>协议展示/搜索关键词"]
  end
  subgraph 网关与认证层
    GW["API Gateway<br/>JWT认证 + RBAC权限校验"]
  end
  subgraph 业务服务层
    B1["内容服务<br/>公告/协议/敏感词/关键词"]
    B2["消息服务<br/>站内信/通知规则"]
    B3["通知调度服务<br/>事件监听+规则匹配+渠道分发"]
  end
  subgraph 数据存储层
    D1["内容数据库<br/>公告/协议/敏感词/关键词"]
    D2["消息数据库<br/>站内信/短信记录/通知日志"]
    D3["文件存储<br/>协议附件"]
  end
  A1 --> GW
  A2 --> GW
  A3 --> GW
  A4 --> GW
  GW --> B1
  GW --> B2
  B1 --> D1
  B1 --> D3
  B2 --> D2
  B3 --> B2
  B3 --> D2
图7-1:内容信息管理系统架构图

7.2 与已有模块的交互边界

交互模块交互方向交互内容
权限中心本模块 ← 权限中心角色权限、按钮权限、数据权限校验;操作日志写入审计
商品供应链管理中心本模块 → 商品中心敏感词库接口供商品名称/详情审核时调用;关键词接口供C端搜索调用
订单履约全链路订单模块 → 本模块订单状态变更事件上报通知调度服务,触发通知规则
分销中心分销模块 → 本模块佣金结算、提现审核、协议到期事件上报
财务中心财务模块 → 本模块结算单生成、打款结果事件上报
营销中心营销模块 → 本模块活动开始、优惠券到账事件上报
商家主体管理本模块 → 商家模块站内信和公告按商家类型定向发送时查询商家列表
系统配置本模块 ← 系统配置短信网关参数、存储服务地址

8. 核心业务流程

8.1 公告发布与触达流程

flowchart LR
  A["平台运营<br/>创建公告"] --> B{"保存类型"}
  B -->|"草稿"| C["存入草稿箱<br/>可继续编辑"]
  B -->|"直接发布"| D["内容校验<br/>敏感词检查"]
  C --> D
  D -->|"含拦截级敏感词"| E["拦截并提示<br/>修改后重新提交"]
  D -->|"含审核级敏感词"| F["提示警告<br/>运营确认是否继续"]
  D -->|"通过"| G["写入公告表<br/>状态=已发布"]
  F -->|"确认继续"| G
  F -->|"取消"| C
  G --> H["分发至各端<br/>供应商/分销商后台"]
  H --> I["各端展示公告<br/>记录阅读状态"]
  G --> J{"是否置顶"}
  J -->|"是"| K["置顶展示<br/>校验置顶数量上限"]
  J -->|"否"| I
  I --> O{"是否下架"}
  O -->|"是"| P["执行下架<br/>各端移除展示"]
  O -->|"否"| N["持续展示"]
  P --> Q{"是否重新上架"}
  Q -->|"是"| G
  Q -->|"否"| R["保持已下架状态"]
图8-1:公告发布与触达流程

8.2 协议版本管理与再确认流程

flowchart LR
  A["法务专员<br/>编辑新版本协议"] --> B["提交审核<br/>草稿内容提升为已提交内容"]
  B --> C{"平台管理员审核"}
  C -->|"驳回"| D["退回法务修改<br/>填写驳回原因"]
  C -->|"通过"| E["版本状态=待生效"]
  D --> A
  A -.->|"编辑闭环:草稿/待审核/审核通过<br/>已驳回/待生效均可编辑"| A
  E --> F{"生效方式"}
  F -->|"立即生效"| G["发布生效<br/>旧版本自动失效"]
  F -->|"定时生效"| H["到达生效时间<br/>自动发布"]
  H --> G
  G --> I["标记已签署旧版本用户<br/>需重新确认<br/>签署记录→PENDING_RECONFIRM"]
  I --> J["用户下次登录时<br/>弹出协议确认弹窗"]
  J --> K{"用户操作"}
  K -->|"同意"| L["记录签署新版本<br/>签署记录→RESIGNED<br/>正常使用系统"]
  K -->|"拒绝"| M["限制功能<br/>仅可查看不可操作"]
  K -->|"关闭弹窗"| N["每次登录重复弹出<br/>直至同意或拒绝"]
图8-2:协议版本管理与再确认流程

8.3 通知规则自动触达流程

flowchart TB
  A["业务模块产生事件<br/>如:订单支付成功"] --> B["事件上报通知调度服务"]
  B --> C["匹配通知规则<br/>trigger_event=订单支付成功"]
  C --> D{"匹配到规则?"}
  D -->|"是"| E["获取规则配置<br/>接收对象+渠道+模板"]
  D -->|"否"| F["记录未匹配日志<br/>流程结束"]
  E --> G{"渠道包含站内信?"}
  G -->|"是"| H["渲染站内信模板<br/>写入站内信表"]
  G -->|"否"| I
  H --> I{"渠道包含短信?"}
  I -->|"是"| J["渲染短信模板<br/>调用短信网关发送"]
  I -->|"否"| K["流程结束"]
  J --> L["记录发送结果<br/>成功/失败"]
  L --> M{"发送失败?"}
  M -->|"是"| N["自动重试3次<br/>3次失败后标记失败"]
  M -->|"否"| K
  N --> K
图8-3:通知规则自动触达流程

8.4 敏感词校验流程

flowchart TD
  A["业务模块提交内容<br/>商品名称/评价/站内信等"] --> B["通知调度服务调用<br/>敏感词校验接口"]
  B --> C["加载已启用敏感词库<br/>按分类构建匹配树"]
  C --> D{"内容是否命中敏感词?"}
  D -->|"未命中"| E["返回校验通过<br/>内容正常处理"]
  D -->|"命中拦截级"| F["拦截提交<br/>返回命中词汇列表"]
  D -->|"命中替换级"| G["自动替换为指定替换词<br/>返回替换后内容"]
  D -->|"命中审核级"| H["放行但标记待审<br/>写入命中记录"]
  F --> I["记录命中日志<br/>前端提示修改"]
  G --> J["记录命中日志<br/>继续后续流程"]
  H --> K["记录命中日志<br/>通知审核人员"]
图8-4:敏感词校验流程

9. 全局规则

9.1 通用交互规则

规则编号规则说明
CM-001所有列表页默认按创建时间倒序排列,默认每页20条,支持切换为50/100条
CM-002所有列表页筛选条件支持「查询」和「重置」操作,重置后清空全部筛选项并刷新列表
CM-003所有新增/编辑操作采用弹窗形式,弹窗支持点击遮罩、ESC键、关闭按钮三种方式关闭
CM-004所有富文本内容(公告正文、协议正文)编辑器支持基础格式(加粗/斜体/列表/链接/图片)、字数统计、敏感词实时校验
CM-005所有操作按钮按角色按钮权限控制可见性,无权限时按钮不渲染(非置灰)
CM-006所有删除操作必须二次确认,确认弹窗中显示操作影响说明
CM-007所有关键操作(发布、下架、审核、启停)记录操作日志,包含操作人、操作时间、操作类型、目标对象、操作前后值
CM-008时间字段统一展示格式为 YYYY-MM-DD HH:mm:ss,日期字段为 YYYY-MM-DD
CM-009状态标签统一颜色:正常/启用/已发布=绿色,待审核/草稿=黄色,已下架/已停用/已失效=灰色,拦截/失败/驳回=红色,进行中=蓝色
CM-010分页器展示总条数、当前页/总页数、每页条数切换、首页/上页/下页/末页跳转

9.2 通用业务规则

规则编号规则说明
CM-B01同一时间同一协议编码仅允许一个版本处于「已生效」状态;新版本发布时旧版本自动变更为「已失效」,失效时间等于新版本生效时间;已生效版本支持手动停用
CM-B02公告置顶数量上限:同一接收范围下最多3条置顶公告,超出时提示「置顶数量已达上限,请先取消其他置顶」
CM-B03敏感词库更新后,缓存需在5分钟内刷新生效;已提交并放行的内容不追溯校验
CM-B04通知规则启停即时生效:启用后新事件立即触发通知,停用后新事件不再触发;已触发未发送的通知继续执行
CM-B05短信模板管理由PC端商品供应链管理中心PRD承接,通知规则在短信渠道发送时引用供应链PRD中已审核通过的短信模板ID
CM-B06站内信保留期限为180天,超过180天的已读站内信自动归档,未读站内信不自动清理
CM-B07短信发送失败自动重试3次,间隔为1分钟/5分钟/30分钟,3次失败后标记为发送失败并记录失败原因
CM-B08协议再确认弹窗在用户每次登录时展示,直至用户点击「同意」或「拒绝」,不可关闭跳过

9.3 通用异常处理规则

异常类型前端表现后端行为恢复方案
业务校验异常对应字段下方红色提示;弹窗不关闭返回400 + field_errors用户修正后重新提交
系统异常全局提示"系统异常,请稍后重试"记录错误栈;返回500等待后重试;连续3次后提供联系技术支持入口
网络异常弹出"网络异常,请检查网络连接"Gateway超时返回504自动重试1次;提供手动重试按钮
权限异常弹出"您没有执行此操作的权限"返回403 + FORBIDDEN引导用户联系管理员
数据异常弹出"数据不存在或已被删除"返回404列表刷新后重新操作

10. 页面路由

10.1 平台运营后台 - 内容管理

页面路径对应菜单权限要求入口条件跳转目标
/platform/content/publish基础管理 > 内容管理 > 内容发布content:publish:view已登录平台后台聚合入口,默认展示公告管理Tab;通过?tab=announcement/article/notice/help切换Tab
/platform/content/publish?tab=announcement同上(公告管理Tab)content:announcement:view已登录平台后台新建弹窗、编辑弹窗、阅读统计详情
/platform/content/publish?tab=article同上(文章管理Tab)content:article:view已登录平台后台文章编辑页、阅读统计详情
/platform/content/publish?tab=notice同上(须知管理Tab)content:notice:view已登录平台后台新建弹窗、编辑弹窗、绑定管理弹窗
/platform/content/publish?tab=help同上(帮助指南Tab)content:help:view已登录平台后台新建弹窗、编辑弹窗、阅读统计详情
/platform/content/agreement基础管理 > 内容管理 > 平台协议及声明content:agreement:view已登录平台后台版本编辑弹窗、审核弹窗、版本详情页
/platform/content/sensitive-word基础管理 > 内容管理 > 敏感词库content:sensitive:view已登录平台后台新增弹窗、导入弹窗、命中记录页
/platform/content/keyword基础管理 > 内容管理 > 关键词content:keyword:view已登录平台后台新增弹窗、编辑弹窗
/platform/content/category基础管理 > 内容管理 > 内容分类content:category:view已登录平台后台分类树编辑弹窗

10.2 平台运营后台 - 消息管理

页面路径对应菜单权限要求入口条件跳转目标
/platform/message/insite基础管理 > 消息管理 > 站内信message:insite:view已登录平台后台发送弹窗、站内信详情、已读跟踪
/platform/message/inbox基础管理 > 消息管理 > 收件箱message:inbox:view已登录平台后台站内信收件箱列表、已读/未读筛选、批量已读、消息详情、跳转业务页
/platform/message/notify-rule基础管理 > 消息管理 > 通知规则message:rule:view已登录平台后台新建弹窗、编辑弹窗、执行日志页

10.3 供应商后台 - 内容管理

页面路径对应菜单权限要求入口条件跳转目标
/supplier/content/notice内容管理 > 须知管理content:notice:view已登录供应商后台须知列表、新建弹窗、编辑弹窗、绑定管理弹窗(仅展示平台须知和本供应商须知)
/supplier/content/help内容管理 > 帮助content:help:view已登录供应商后台帮助列表(只读)、帮助详情弹窗(仅展示target_scope含"全部"或"供应商"的已发布帮助)

10.4 分销商后台 - 内容管理

页面路径对应菜单权限要求入口条件跳转目标
/distributor/content/help内容管理 > 帮助content:help:view已登录分销商后台帮助列表(只读)、帮助详情弹窗(仅展示target_scope含"全部"或"分销商"的已发布帮助)

10.5 供应商后台 / 分销商后台 - 消息中心

页面路径对应菜单权限要求入口条件跳转目标
/supplier/message/inbox消息中心 > 收件箱message:inbox:view已登录供应商后台消息详情、业务跳转页
/distributor/message/inbox消息中心 > 收件箱message:inbox:view已登录分销商后台消息详情、业务跳转页

10.6 全局Header组件 - 铃铛Icon(三端共用)

组件位置适用端权限要求入口条件跳转目标
顶部导航栏右侧(紧邻用户头像)平台运营端 / 供应商端 / 分销商端已登录即可见,无独立权限项用户登录成功点击铃铛展开下拉面板(16.4.7);面板内消息点击跳转对应业务页;面板底部「查看全部消息」跳转各端收件箱(/platform/message/inbox、/supplier/message/inbox、/distributor/message/inbox)

11. 数据模型

11.1 核心实体关系图

erDiagram
  t_announcement ||--o{ t_announcement_read : "阅读记录"
  t_platform_agreement ||--o{ t_agreement_sign : "签署记录"
  t_sensitive_word ||--o{ t_sensitive_hit_log : "命中记录"
  t_keyword ||--o{ t_keyword_stat : "搜索统计"
  t_insite_message ||--o{ t_insite_message_read : "已读记录"
  t_notification_rule ||--o{ t_notification_log : "执行日志"
  t_notification_rule }o--|| t_insite_message : "关联站内信模板"
  t_content_category ||--o{ t_article : "分类归属"
  t_content_category ||--o{ t_content_category : "父子分类"
  t_article ||--o{ t_article_read : "阅读记录"

  t_announcement {
    bigint id PK
    varchar title
    text content
    varchar category_id
    varchar target_scope
    varchar status
    int is_pinned
    datetime publish_time
    datetime offline_time
  }
  t_announcement_read {
    bigint id PK
    bigint announcement_id FK
    bigint user_id
    varchar user_type
    datetime read_time
  }
  t_platform_agreement {
    bigint id PK
    varchar agreement_code
    varchar title
    varchar version_no
    text content
    varchar status
    varchar effective_mode
    datetime effective_time
    datetime expire_time
    datetime published_at
    varchar change_summary
  }
  t_agreement_config {
    bigint id PK
    varchar agreement_code UK
    boolean enabled
    varchar stop_reason
    boolean deleted
    datetime created_at
    datetime updated_at
  }
  t_agreement_sign {
    bigint id PK
    varchar agreement_code
    bigint agreement_id FK
    bigint user_id
    varchar user_type
    datetime sign_time
    varchar ip_address
    text sign_content
  }
  t_sensitive_word {
    bigint id PK
    varchar word
    varchar category
    varchar level
    varchar replace_word
    int hit_count
    boolean is_enabled
  }
  t_sensitive_hit_log {
    bigint id PK
    bigint word_id FK
    varchar source_type
    varchar source_content
    varchar action
    datetime hit_time
  }
  t_keyword {
    bigint id PK
    varchar word
    varchar keyword_type
    int sort_weight
    int search_count
    boolean is_enabled
  }
  t_keyword_stat {
    bigint id PK
    bigint keyword_id FK
    date stat_date
    int search_count
    int click_count
  }
  t_insite_message {
    bigint id PK
    varchar title
    text content
    varchar message_type
    varchar target_scope
    varchar jump_url
    varchar send_mode
    datetime send_time
    varchar source_rule_id FK
  }
  t_insite_message_read {
    bigint id PK
    bigint message_id FK
    bigint user_id
    varchar user_type
    datetime read_time
  }
  t_notification_rule {
    bigint id PK
    varchar rule_name
    varchar trigger_event
    varchar target_scope
    varchar channels
    bigint insite_template_id FK
    bigint sms_template_id FK "引用供应链PRD短信模板"
    boolean is_enabled
  }
  t_notification_log {
    bigint id PK
    bigint rule_id FK
    varchar trigger_event
    varchar target_info
    varchar channel
    varchar send_status
    datetime execute_time
    varchar fail_reason
  }
  t_content_category {
    bigint id PK
    varchar category_name
    bigint parent_id FK
    varchar tree_path
    int level
    boolean is_system
    int sort_weight
    boolean is_enabled
    int article_count
    datetime created_at
    datetime updated_at
  }
  t_article {
    bigint id PK
    varchar title
    varchar article_type
    bigint category_id FK
    text content
    varchar cover_image
    varchar summary
    varchar author
    varchar status
    boolean is_pinned
    int pin_sort
    datetime publish_time
    varchar target_scope
    int view_count
    int reader_count
    bigint created_by
    datetime created_at
    datetime updated_at
  }
  t_article_read {
    bigint id PK
    bigint article_id FK
    bigint user_id
    varchar user_type
    datetime read_time
  }
  t_notice ||--o{ t_notice_spu : "SPU绑定"
  t_help ||--o{ t_help_read : "阅读记录"
  t_notice {
    bigint id PK
    varchar title
    text content
    varchar notice_type
    varchar owner_type
    bigint owner_id
    varchar status
    datetime publish_time
    datetime offline_time
  }
  t_notice_spu {
    bigint id PK
    bigint notice_id FK
    bigint spu_id
    varchar spu_name
    bigint bind_by
    datetime bind_time
  }
  t_help {
    bigint id PK
    varchar title
    text content
    varchar help_type
    varchar target_scope
    varchar status
    int is_pinned
    datetime publish_time
    datetime offline_time
  }
  t_help_read {
    bigint id PK
    bigint help_id FK
    bigint user_id
    varchar user_type
    datetime read_time
  }
图11-1:内容信息管理核心实体关系图

11.2 核心数据表结构

11.2.1 公告表 t_announcement

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
titlevarchar(100)NOT NULL公告标题,长度2-100字符
contenttextNOT NULL公告正文,富文本HTML格式
category_idvarchar(50)NOT NULL公告分类ID,关联内容分类树中“公告管理”下的分类
target_scopevarchar(50)NOT NULL接收范围:全部/供应商/分销商
target_detailvarchar(500)NULL接收对象明细,预留扩展字段
statusvarchar(20)NOT NULL状态:草稿/已发布/已下架
is_pinnedbooleanDEFAULT false是否置顶
pin_sortintDEFAULT 0置顶排序,数值越小越靠前
publish_timedatetimeNULL发布时间,发布时写入
offline_timedatetimeNULL下架时间,下架时写入
created_bybigintNOT NULL创建人ID,关联用户表
created_atdatetimeNOT NULL创建时间
updated_atdatetimeNULL最后修改时间

11.2.2 公告阅读记录表 t_announcement_read

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
announcement_idbigintNOT NULL, FK关联 t_announcement.id
user_idbigintNOT NULL阅读用户ID
user_typevarchar(20)NOT NULL用户类型:供应商/分销商/平台
read_timedatetimeNOT NULL阅读时间

11.2.3 平台协议表 t_platform_agreement

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
agreement_codevarchar(50)NOT NULL, UK协议编码,系统自动生成(格式:AGR+YYYYMMDD+3位序号),全局唯一,业务锚定字段,不可修改
titlevarchar(100)NOT NULL协议标题,展示用,可修改
version_novarchar(20)NOT NULL版本号,格式 vX.Y,须大于该编码下历史最大版本号
contenttextNOT NULL协议正文(已提交内容 submitted_content),富文本HTML格式。提交审核时写入此字段,是审核、发布、生效的实际对象
draft_contenttextNULL协议正文(草稿内容 draft_content),编辑弹窗"保存草稿"时写入此字段。仅作编辑暂存,不参与审核与发布。打开编辑弹窗时优先加载此字段,无则加载 content
statusvarchar(20)NOT NULL版本状态:DRAFT草稿 / AUDITING待审核 / AUDIT_PASSED审核通过 / REJECTED已驳回 / PENDING_PUBLISH待生效 / EFFECTIVE已生效 / EXPIRED已失效
effective_modevarchar(20)NULL生效方式:立即生效/定时生效
effective_timedatetimeNULL生效时间
expire_timedatetimeNULL失效时间,新版本生效或手动停用时写入
published_atdatetimeNULL发布时间
change_summaryvarchar(500)NULL版本变更说明
audit_remarkvarchar(200)NULL审核备注,驳回时填写驳回原因
created_bybigintNOT NULL创建人ID
created_atdatetimeNOT NULL创建时间
updated_atdatetimeNULL更新时间

11.2.4 协议签署记录表 t_agreement_sign

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
agreement_codevarchar(50)NOT NULL协议编码,用于按协议聚合统计
agreement_idbigintNOT NULL, FK关联 t_platform_agreement.id
user_idbigintNOT NULL签署用户ID
user_typevarchar(20)NOT NULL用户类型:供应商/分销商/C端用户
sign_timedatetimeNOT NULL签署时间
ip_addressvarchar(50)NULL签署时IP地址
user_agentvarchar(200)NULL签署时浏览器标识
reconfirm_timedatetimeNULL再确认时间
sign_statusvarchar(20)NOT NULL, DEFAULT 'SIGNED'签署记录状态:SIGNED已签署 / PENDING_RECONFIRM待重新确认(原签署版本被新版本替代)/ RESIGNED已重新签署。详见 13.5.7 签署记录流转
sign_contentmediumtextNULL签署快照:用户签署时协议正文变量替换后的最终渲染文本,用于归档。历史签署记录不受后续版本修改影响

11.2.5 协议编码配置表 t_agreement_config

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
agreement_codevarchar(50)NOT NULL, UK协议编码,与 t_platform_agreement.agreement_code 对应
enabledtinyint(1)NOT NULL, DEFAULT 1协议是否可签署:1=启用(可签署),0=停用(不可签署)。仅在版本状态=已生效时有效,已签署数据不受影响
stop_reasonvarchar(500)NULL停用原因,停用协议时选填。启用时清空
deletedtinyint(1)NOT NULL, DEFAULT 0协议编码是否删除:1=已删除,0=未删除
created_atdatetimeNOT NULL创建时间
updated_atdatetimeNULL更新时间

11.2.6 敏感词表 t_sensitive_word

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
wordvarchar(50)NOT NULL, UNIQUE敏感词汇,全局唯一
categoryvarchar(20)NOT NULL分类:政治/色情/广告/欺诈/其他
levelvarchar(20)NOT NULL处理级别:拦截/替换/审核
replace_wordvarchar(50)NULL替换词,仅 level=替换 时使用
hit_countintDEFAULT 0累计命中次数
is_enabledbooleanDEFAULT true是否启用
created_bybigintNOT NULL创建人ID
created_atdatetimeNOT NULL创建时间

11.2.7 敏感词命中记录表 t_sensitive_hit_log

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
word_idbigintNOT NULL, FK关联 t_sensitive_word.id
wordvarchar(50)NOT NULL命中的敏感词(冗余存储)
source_typevarchar(30)NOT NULL来源类型:商品名称/商品详情/用户评价/站内信/公告
source_idbigintNULL来源对象ID
source_contentvarchar(500)NULL来源内容片段(命中上下文)
actionvarchar(20)NOT NULL处理方式:拦截/替换/审核
hit_timedatetimeNOT NULL命中时间

11.2.8 关键词表 t_keyword

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
wordvarchar(50)NOT NULL关键词
keyword_typevarchar(20)NOT NULL类型:热门搜索/推荐搜索/屏蔽搜索
sort_weightintDEFAULT 0排序权重,数值越小越靠前
search_countintDEFAULT 0累计搜索次数(前端计算态,不入库;实际由统计表汇总)
is_enabledbooleanDEFAULT true是否启用
created_atdatetimeNOT NULL创建时间

11.2.9 站内信表 t_insite_message

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
titlevarchar(100)NOT NULL消息标题
contenttextNOT NULL消息内容,支持HTML格式
message_typevarchar(20)NOT NULL消息类型:系统/订单/售后/佣金/协议/公告
target_scopevarchar(50)NOT NULL接收范围:全部/指定角色/指定商家
target_detailvarchar(500)NULL接收对象明细JSON
jump_urlvarchar(200)NULL业务跳转链接
send_modevarchar(20)NOT NULL发送方式:立即发送/定时发送
send_timedatetimeNOT NULL发送时间
source_rule_idbigintNULL, FK来源规则ID,关联 t_notification_rule.id;手动发送时为空
created_bybigintNULL创建人ID,自动发送时为空
created_atdatetimeNOT NULL创建时间

11.2.10 通知规则表 t_notification_rule

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
rule_namevarchar(50)NOT NULL规则名称
trigger_eventvarchar(50)NOT NULL触发事件编码,如 order_paid, commission_settled
target_scopevarchar(50)NOT NULL接收对象:全部/供应商/分销商/订单相关方/指定角色
channelsvarchar(50)NOT NULL通知渠道:站内信/短信/站内信+短信
insite_template_titlevarchar(100)NULL站内信标题模板
insite_template_contenttextNULL站内信内容模板,含变量占位符
sms_template_idbigintNULL, FK引用PC端商品供应链管理中心PRD的短信模板ID
send_timingvarchar(20)DEFAULT '即时'发送时机:即时/延迟
delay_minutesintNULL延迟分钟数,仅 send_timing=延迟 时使用
is_enabledbooleanDEFAULT true是否启用
created_bybigintNOT NULL创建人ID
created_atdatetimeNOT NULL创建时间

11.2.11 通知执行日志表 t_notification_log

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
rule_idbigintNOT NULL, FK关联 t_notification_rule.id
trigger_eventvarchar(50)NOT NULL触发的业务事件
source_idbigintNULL触发源对象ID(如订单ID)
target_infovarchar(200)NOT NULL接收对象信息
channelvarchar(20)NOT NULL通知渠道:站内信/短信
send_statusvarchar(20)NOT NULL发送状态:成功/失败/重试中
retry_countintDEFAULT 0重试次数
execute_timedatetimeNOT NULL执行时间
fail_reasonvarchar(200)NULL失败原因

11.2.12 内容分类表 t_content_category

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
category_namevarchar(50)NOT NULL分类名称,同层级下唯一,长度1-50字符
parent_idbigintNULL, FK父分类ID,关联 t_content_category.id;一级分类 parent_id=NULL
tree_pathvarchar(500)NULL分类路径,如"/1/5/12/",用于快速查询子树
levelintNOT NULL层级:1-3,一级为系统预置分类
is_systembooleanDEFAULT false是否系统预置:一级分类为true,其余false。系统预置分类不可删除
sort_weightintDEFAULT 0排序权重,同级间数值越小越靠前
is_enabledbooleanDEFAULT true启用状态:true启用/false停用
article_countintDEFAULT 0文章引用数,缓存字段,定期与t_article实际关联数同步
created_atdatetimeNOT NULL创建时间
updated_atdatetimeNOT NULL更新时间

11.2.13 文章/资讯表 t_article

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
titlevarchar(200)NOT NULL文章标题,长度2-200字符
article_typevarchar(20)NOT NULL文章类型:news新闻;预留扩展字段,后续可新增行业资讯、公司动态等其他非重叠类型,但不得与公告(announcement)、须知(notice)、帮助(help)重复
category_idbigintNOT NULL, FK内容分类ID,关联 t_content_category.id
contenttextNOT NULL正文内容,富文本HTML格式
cover_imagevarchar(500)NULL封面图URL
summaryvarchar(500)NULL摘要,未填写时自动从正文截取前200字符
authorvarchar(50)NULL作者
statusvarchar(20)NOT NULL状态:draft草稿/published已上架/offline已下架/deleted已删除
is_pinnedbooleanDEFAULT false是否置顶
pin_sortintDEFAULT 0置顶排序,数值越小越靠前
publish_timedatetimeNULL上架时间
target_scopevarchar(50)DEFAULT 'all'推送范围:all全部/supplier供应商/distributor分销商
view_countintDEFAULT 0阅读次数(总点击数)
reader_countintDEFAULT 0阅读人数(去重用户数)
created_bybigintNOT NULL创建人ID
created_atdatetimeNOT NULL创建时间
updated_atdatetimeNOT NULL更新时间

11.2.14 文章阅读记录表 t_article_read

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
article_idbigintNOT NULL, FK文章ID,关联 t_article.id
user_idbigintNOT NULL阅读用户ID
user_typevarchar(20)NOT NULL用户类型:supplier供应商/distributor分销商/customerC端用户
read_timedatetimeNOT NULL阅读时间
索引建议:t_article_read 表建议建立联合唯一索引 (article_id, user_id, user_type) 用于阅读人数去重统计,建立普通索引 (article_id) 用于按文章查询阅读记录。

11.2.15 须知表 t_notice

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
titlevarchar(100)NOT NULL须知标题,长度2-100字符
contenttextNOT NULL须知正文,富文本HTML格式
notice_typevarchar(20)NOT NULL须知类型:purchase购买须知/travel出行须知/refund退改须知/safety安全须知/usage使用须知/other其他
owner_typevarchar(20)NOT NULL归属类型:platform平台/supplier供应商
owner_idbigintNOT NULL归属主体ID:owner_type=platform时为0(平台),owner_type=supplier时为供应商ID
statusvarchar(20)NOT NULL状态:草稿/已发布/已下架
publish_timedatetimeNULL发布时间,发布时写入
offline_timedatetimeNULL下架时间,下架时写入
created_bybigintNOT NULL创建人ID,关联用户表
created_atdatetimeNOT NULL创建时间
updated_atdatetimeNULL最后修改时间
索引建议:t_notice 表建议建立联合索引 (owner_type, owner_id, status) 用于按归属主体查询须知列表,建立普通索引 (notice_type) 用于按类型筛选,建立普通索引 (status) 用于按状态筛选。

11.2.16 须知-SPU关联表 t_notice_spu

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
notice_idbigintNOT NULL, FK须知ID,关联 t_notice.id
spu_idbigintNOT NULL商品SPU ID,关联商品中心SPU表
spu_namevarchar(200)NULL商品SPU名称快照,冗余字段便于列表展示
bind_bybigintNOT NULL绑定操作人ID
bind_timedatetimeNOT NULL绑定时间
索引建议:t_notice_spu 表建议建立联合唯一索引 (notice_id, spu_id) 防止同一须知重复绑定同一SPU,建立普通索引 (spu_id) 用于按SPU反查关联须知,建立普通索引 (notice_id) 用于按须知查询绑定SPU列表。
数据一致性说明:须知下架或删除时,系统自动解除该须知关联的全部 t_notice_spu 绑定记录。SPU前端详情页展示须知时,需同时校验须知状态=已发布,已下架或已删除的须知不展示。

11.2.17 帮助内容表 t_help

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
titlevarchar(100)NOT NULL帮助标题,长度2-100字符
contenttextNOT NULL帮助正文,富文本HTML格式
help_typevarchar(20)NOT NULL帮助类型:guide新手指南/faq常见问题/manual操作手册/rule规则说明
target_scopevarchar(50)DEFAULT 'all'展示范围:all全部/supplier供应商/distributor分销商
statusvarchar(20)NOT NULL状态:草稿/已发布/已下架
is_pinnedbooleanDEFAULT false是否置顶
pin_sortintDEFAULT 0置顶排序,数值越小越靠前
publish_timedatetimeNULL发布时间,发布时写入
offline_timedatetimeNULL下架时间,下架时写入
view_countintDEFAULT 0阅读次数(总点击数)
reader_countintDEFAULT 0阅读人数(去重用户数)
created_bybigintNOT NULL创建人ID,关联用户表
created_atdatetimeNOT NULL创建时间
updated_atdatetimeNULL最后修改时间
索引建议:t_help 表建议建立联合索引 (help_type, status) 用于按类型和状态筛选,建立普通索引 (is_pinned, pin_sort) 用于置顶排序查询,建立普通索引 (target_scope) 用于按展示范围筛选。

11.2.18 帮助阅读记录表 t_help_read

字段名类型约束说明
idbigintPK, AUTO_INCREMENT主键
help_idbigintNOT NULL, FK帮助ID,关联 t_help.id
user_idbigintNOT NULL阅读用户ID
user_typevarchar(20)NOT NULL用户类型:supplier供应商/distributor分销商/customerC端用户
read_timedatetimeNOT NULL阅读时间
索引建议:t_help_read 表建议建立联合唯一索引 (help_id, user_id, user_type) 用于阅读人数去重统计,建立普通索引 (help_id) 用于按帮助内容查询阅读记录。
短信模板数据表说明:t_sms_template 数据表由PC端商品供应链管理中心PRD定义和维护,本章不重复定义。通知规则模块(第18章)在短信渠道发送时,引用供应链PRD的短信模板ID。
前端计算态声明:t_keyword.search_count 为前端计算态,不入库,由后端实时从统计表聚合计算后返回。t_announcement_read、t_insite_message_read 的已读率为前端计算态,不入库,由后端实时统计已读记录数与目标接收人数计算得出。t_article.view_count 和 t_article.reader_count 同为前端计算态,由后端从 t_article_read 表实时聚合计算。t_help.view_count 和 t_help.reader_count 同为前端计算态,由后端从 t_help_read 表实时聚合计算。

11A. 内容发布(聚合入口)

11A.1 核心业务逻辑

内容发布是平台内容管理的统一聚合入口,将公告管理、文章管理、须知管理、帮助指南四种内容管理入口整合在同一页面下,通过Tab标签切换不同内容类型的管理界面。该入口替代原"公告管理"和"文章/资讯"独立菜单入口,减少菜单层级,统一内容管理操作体验。

设计原则:
1. 菜单精简:取消"公告管理"和"文章/资讯"独立菜单入口,统一归入"内容发布"菜单项
2. Tab隔离:每个Tab对应一个独立的内容类型,列表数据、筛选条件、操作按钮互不干扰
3. URL同步:Tab切换时URL同步更新query参数(?tab=xxx),支持浏览器前进/后退、书签收藏、直接链接分享
4. 权限联动:Tab的可见性受权限控制,用户无某内容类型查看权限时该Tab不展示
5. 默认Tab:进入内容发布页面时默认展示第一个有权限的Tab,通常为"公告管理"

11A.2 Tab切换逻辑

Tab名称tab参数值对应章节权限标识说明
公告announcement第12章 公告管理content:announcement:view平台向供应商/分销商发布的系统公告、活动公告、政策公告、运营公告等
文章article第15B章 文章/资讯管理content:article:view新闻、资讯等内容管理,支持分类、推送
须知notice第15C章 须知管理content:notice:view平台和供应商各自创建的须知内容,绑定至SPU级
帮助help第15D章 帮助管理content:help:view新手指南、常见问题、操作手册、规则说明

11A.2.1 Tab切换交互规则

场景触发动作系统行为URL变化
进入内容发布页面点击侧边栏"内容发布"菜单展示默认Tab(第一个有权限的Tab)/platform/content/publish?tab=announcement(默认)
切换Tab点击Tab标签加载对应Tab的列表数据,清空筛选条件URL的query参数tab值更新
浏览器前进/后退点击浏览器前进/后退按钮根据URL的tab参数切换到对应TabURL回退到上一个tab参数值
直接访问带tab参数的URL在地址栏输入/粘贴URL校验tab参数有效性,展示对应Tab;无权限则展示默认TabURL保持不变
访问不带tab参数的URL在地址栏输入不带?tab=的URL重定向到默认Tab的URL/platform/content/publish → /platform/content/publish?tab=announcement
访问无效tab参数URL的tab参数值不在枚举范围内重定向到默认Tabtab参数重置为announcement

11A.3 页面布局

内容发布页面采用"侧边栏 + 面包屑 + Tab栏 + 内容区"的布局结构。侧边栏菜单中"内容管理"下展示"内容发布"菜单项(原"公告管理"菜单项替换为"内容发布"),点击进入后页面顶部展示Tab栏,Tab下方为对应内容类型的列表/表单区域。

11A.3.1 侧边栏与Tab布局原型

内容发布 - 聚合入口(默认公告管理Tab)
/platform/content/publish?tab=announcement
基础管理 / 内容管理 / 内容发布
公告管理
文章管理
须知管理
帮助指南
公告管理
公告标题公告分类接收范围状态阅读统计创建时间最新发布时间操作
系统升级维护通知系统公告全部已发布已读 128 / 未读 322026-08-09 17:202026-08-10 09:30下架取消置顶阅读统计
暑期促销活动上线活动公告分销商已发布已读 86 / 未读 242026-08-08 10:002026-08-08 14:00下架置顶阅读统计
共 48 条 1 每页 条
Tab栏样式规范:
1. Tab栏位于面包屑下方、页面标题上方
2. 当前激活Tab底部为2px实色边框(主题色#0d9488),文字为主题色加粗
3. 非激活Tab文字为灰色(#64748b),hover时文字加深
4. Tab切换时不刷新整页,仅刷新Tab下方内容区
5. 每个Tab的筛选条件、分页状态独立维护,切换Tab时重置

11A.4 权限控制

权限标识权限名称说明
content:publish:view内容发布-查看访问内容发布聚合入口页面的基础权限,控制侧边栏"内容发布"菜单项是否可见
content:announcement:view公告-查看公告管理Tab可见权限,无此权限时公告管理Tab不展示
content:article:view文章-查看文章管理Tab可见权限,无此权限时文章管理Tab不展示
content:notice:view须知-查看须知管理Tab可见权限,无此权限时须知管理Tab不展示
content:help:view帮助-查看帮助指南Tab可见权限,无此权限时帮助指南Tab不展示
Tab可见性逻辑:系统根据当前用户拥有的内容类型查看权限,动态渲染Tab栏。若用户仅有content:announcement:view权限,则Tab栏只展示"公告管理"一个Tab,且不展示Tab栏本身(单一Tab时隐藏Tab栏)。若用户无任何内容类型查看权限但有content:publish:view权限,展示空状态提示"暂无可管理的内容类型"。

11A.5 与各内容类型模块的关系

聚合入口与子模块关系说明:内容发布聚合入口本身不承载业务逻辑,仅提供Tab切换框架和统一入口。各Tab内的列表、表单、状态机、业务规则由对应章节独立定义:
• 公告管理Tab → 第12章 公告管理
• 文章管理Tab → 第15B章 文章/资讯管理
• 须知管理Tab → 第15C章 须知管理
• 帮助指南Tab → 第15D章 帮助管理
聚合入口章节仅定义Tab切换逻辑、URL路由规则、权限控制和页面布局框架,不重复定义各内容类型的具体业务规则。

11B. 工作台公告发布入口

11B.1 核心业务逻辑

工作台首页为平台运营人员提供独立的「发布公告」入口,便于运营人员在不进入「内容管理 > 内容发布」菜单的情况下快速发起公告。该入口独立于工作台「快捷操作区」之外,放置于工作台顶部操作栏或公告待办模块的显著位置。

业务边界:工作台公告发布入口仅作为公告发布的快捷入口,不承载公告编辑、阅读统计等完整管理功能。点击后跳转至「内容发布」聚合入口的公告管理Tab(/platform/content/publish?tab=announcement),运营人员在公告管理Tab内完成新建、编辑、发布等操作。

11B.2 入口位置与交互

入口位置展示条件点击行为跳转目标
工作台顶部操作栏用户拥有 content:announcement:create 权限点击「发布公告」按钮新标签页/当前页跳转至 /platform/content/publish?tab=announcement
公告待办/最近公告卡片用户拥有 content:announcement:view 权限点击「发布公告」文字链跳转至 /platform/content/publish?tab=announcement

11B.3 权限控制

权限标识权限名称说明
content:announcement:create公告-新建控制工作台「发布公告」入口是否可见;无权限时不展示该入口

11B.4 与内容发布入口的关系

入口关系说明:工作台公告发布入口是内容发布聚合入口的快捷跳转,两者共用公告管理模块的业务逻辑和数据模型。工作台入口点击后进入内容发布-公告管理Tab,后续新建/编辑/发布操作均在该Tab内完成,不再返回工作台。工作台入口本身不维护独立的状态或数据。

12. 公告管理

12.1 核心业务逻辑

公告管理是平台运营人员向供应商、分销商发布系统公告、活动公告、政策公告、运营公告等分类公告的统一入口。公告创建后可选择保存为草稿或直接发布,发布前必须通过敏感词校验。已发布公告按接收范围分发至各端展示,支持置顶和下架。

业务边界:公告管理仅平台运营后台可操作,供应商和分销商后台仅作为接收端展示公告。公告与站内信是两套独立体系——公告面向全体或范围群体广播,站内信面向个体或指定对象推送。

12.1.1 功能清单

功能项说明操作角色优先级
公告列表分页查询公告,支持按标题、公告分类、接收范围、状态筛选平台运营P1
新增公告填写标题、正文、公告分类、接收范围、置顶后保存为草稿或直接发布平台运营P1
编辑公告草稿或已下架状态可编辑全部字段;已发布状态仅可编辑置顶与排序平台运营P1
发布公告草稿状态公告执行发布,触发敏感词校验通过后状态变更为已发布平台运营P1
下架公告已发布状态公告执行下架,下架后各端不再展示平台运营P1
置顶/取消置顶已发布公告可设置置顶,同一接收范围最多3条置顶;可在编辑弹窗中设置,也可在列表行内操作平台运营P1
删除公告草稿或已下架状态公告可删除,删除后不可恢复平台运营P1
阅读统计查看公告阅读人数、未读人数、阅读率,支持按用户类型筛选平台运营P1

12.1.2 字段说明

字段类型必填校验规则说明
公告标题文本是2-100字符展示在公告列表和详情页标题位
公告正文富文本是不少于10字符,不超过10000字符支持加粗、斜体、列表、链接、图片上传
公告分类下拉单选是关联内容分类树中“公告管理”下的二级分类用于列表筛选和前端分类标签展示
接收范围下拉单选是枚举:全部/供应商/分销商选择公告的分发范围
是否置顶开关否默认关闭开启后需校验同接收范围置顶数量上限
置顶排序数字否0-999,默认0数值越小越靠前

12.2 交互逻辑表

触发入口前置条件操作步骤系统响应结果状态
列表页「新增公告」按钮用户拥有 content:announcement:create 权限点击按钮 → 弹出新增弹窗 → 填写字段 → 点击「保存草稿」或「发布」保存草稿:校验必填项 → 写入数据库 status=草稿;发布:校验必填项 → 敏感词校验 → 写入数据库 status=已发布 → 分发至各端草稿 / 已发布
列表页「编辑」操作草稿/已下架状态可编辑全部字段;已发布状态仅可编辑置顶与排序点击行内「编辑」→ 弹出编辑弹窗 → 修改字段 → 点击「保存」校验必填项 → 更新数据库 → 刷新列表草稿 / 已下架 / 已发布
列表页「发布」操作公告状态=草稿;用户拥有 content:announcement:publish 权限点击行内「发布」→ 二次确认弹窗 → 点击「确认发布」敏感词校验 → 通过则更新 status=已发布,写入 publish_time → 分发至各端 → 刷新列表已发布
列表页「下架」操作公告状态=已发布;用户拥有 content:announcement:offline 权限点击行内「下架」→ 二次确认弹窗"下架后各端将不再展示,确认下架?" → 点击「确认下架」更新 status=已下架,写入 offline_time → 各端移除展示 → 刷新列表已下架
列表页「置顶」操作公告状态=已发布;用户拥有 content:announcement:pin 权限点击行内「置顶」,或在编辑弹窗中开启置顶开关并保存校验同接收范围置顶数 < 3 → 通过则更新 is_pinned=true → 刷新列表已发布(置顶)
列表页「取消置顶」操作公告 is_pinned=true点击行内「取消置顶」,或在编辑弹窗中关闭置顶开关并保存更新 is_pinned=false → 刷新列表已发布(非置顶)
列表页「删除」操作公告状态=草稿 或 已下架点击行内「删除」→ 二次确认弹窗 → 点击「确认删除」物理删除公告记录及阅读记录 → 刷新列表已删除
列表页「阅读统计」操作公告状态=已发布点击行内「阅读统计」→ 跳转阅读统计详情页查询 t_announcement_read 聚合数据 → 渲染统计页面—

12.3 页面原型

12.3.1 公告列表页

公告管理 - 列表页
/platform/content/publish?tab=announcement
基础管理 / 内容管理 / 内容发布 / 公告
公告管理
公告标题公告分类接收范围状态阅读统计创建时间最新发布时间操作
系统升级维护通知系统公告全部已发布已读 128 / 未读 322026-08-09 17:202026-08-10 09:30下架取消置顶阅读统计
暑期促销活动上线活动公告分销商已发布已读 86 / 未读 242026-08-08 10:002026-08-08 14:00下架置顶阅读统计
分销佣金比例调整说明政策公告供应商草稿-2026-08-04 16:30-编辑发布删除
平台服务协议更新公告运营公告全部已下架已读 120 / 未读 102026-07-30 15:002026-08-11 16:00发布删除阅读统计
共 48 条 1 每页 条

12.3.2 新增/编辑公告弹窗

新增公告 - 弹窗
新增公告×
BI列表链接图片
请输入公告正文...
字数:0 / 10000
关闭

12.3.3 阅读统计详情页

阅读统计 - 详情页
/platform/content/publish?tab=announcement&action=read-stats&id=123
基础管理 / 内容管理 / 内容发布 / 公告 / 阅读统计
系统升级维护通知 - 阅读统计
156
目标接收人数
106
已阅读
50
未阅读
68%
阅读率
用户类型目标人数已阅读未阅读阅读率
供应商3228487.5%
分销商124784662.9%

12.4 状态机定义

当前状态触发动作目标状态前置条件副作用
—(不存在)新增保存草稿草稿必填项校验通过写入 t_announcement,status=草稿
—(不存在)新增直接发布已发布必填项校验 + 敏感词校验通过写入 t_announcement,status=已发布,写入 publish_time;分发至各端
草稿发布已发布敏感词校验通过更新 status=已发布,写入 publish_time;分发至各端
草稿删除—(已删除)无物理删除记录
已发布下架已下架用户确认下架更新 status=已下架,写入 offline_time;各端移除展示
已下架上架已发布敏感词校验通过更新 status=已发布,写入 publish_time;分发至各端
已下架删除—(已删除)无物理删除记录
已发布编辑已发布仅允许修改置顶与排序更新对应字段
状态流转约束:已发布状态下架后变为已下架,可重新上架。已下架状态下不可编辑正文,需重新上架后展示。删除操作不可恢复。

12.5 异常处理

异常场景触发条件前端表现系统处理恢复方案
敏感词拦截公告正文命中拦截级敏感词弹窗不关闭,正文下方红色提示"内容包含违禁词汇:XXX,请修改后提交"返回命中的拦截级敏感词列表用户修改正文内容后重新提交
敏感词审核级提示公告正文命中审核级敏感词弹窗不关闭,弹出二次确认"内容包含敏感词汇:XXX,是否确认发布?"提供「确认发布」和「取消」按钮返回命中的审核级敏感词列表用户点击确认后继续发布,或取消修改内容
置顶超限同接收范围已置顶3条公告,再次置顶提示"该接收范围下置顶公告已达上限(3条),请先取消其他置顶"拒绝置顶操作,返回 CM-B02 规则约束用户先取消已有置顶公告后再置顶
重复发布公告状态非草稿时点击发布提示"当前公告状态不支持发布操作"校验状态不通过,返回400刷新列表后操作有效状态公告
编辑已发布公告公告状态=已发布时点击编辑编辑弹窗中除置顶开关与排序外,其余字段置灰不可编辑,标题上方提示"已发布公告仅可编辑置顶与排序"仅允许修改置顶与排序如需修改正文内容请先下架后重新编辑
富文本图片上传失败图片上传超时或格式不支持编辑器内图片位置显示"上传失败",下方提示"图片上传失败,请重试"记录上传失败日志用户重新上传或更换图片

13. 平台协议及声明

13.1 核心业务逻辑

平台协议及声明管理是法务/运营人员维护平台各类协议文本的版本管理模块。每个协议以协议编码(由系统自动生成,格式 AGR+YYYYMMDD+3位序号)为唯一标识、协议标题为展示名称,采用版本制管理;同一协议编码下同时仅允许一个版本处于"已生效"状态。协议编码维度支持启用/停用控制(仅控制已生效协议是否允许用户签署,不影响版本状态机):已启用协议用户可签署,已停用协议新用户不可签署(已签署数据不受影响)。新版本发布生效后同编码旧版本自动失效(失效时间 = 新版本生效时间);已生效/已生效过的协议不可删除。已签署旧版本的用户需重新确认签署。

协议版本内容采用双轨内容模型(详见 13.5.2 节):"已提交内容"(submitted_content)与"草稿内容"(draft_content)独立存储。保存草稿仅写入草稿轨,不影响已提交内容和版本状态;发布操作始终使用已提交内容,草稿内容不会被发布。进行中状态(草稿/待审核/审核通过/已驳回/待生效)均支持编辑,编辑弹窗内"保存草稿"保持状态不变,"提交审核"将草稿提升为已提交内容并重置为待审核状态。

业务边界:协议管理仅平台运营后台可操作。协议签署/确认行为发生在各端用户侧(供应商入驻时签署分销协议、C端用户注册时签署服务协议等),本模块仅管理协议文本与版本,签署记录为只读查询。

13.1.1 功能清单

功能项说明操作角色优先级
协议列表按协议编码分组展示,显示协议状态(草稿/待审核/审核通过/已驳回/待生效/已生效/已失效)、启用/停用开关、当前生效版本、历史版本法务/运营P1
新增协议列表页右上角入口,创建新协议(协议编码由系统自动生成)并填写首版标题、版本号、正文等,保存草稿或提交审核法务专员P1
新增版本在已有协议编码下新增一个版本,继承编码和标题(可修改标题),填写版本号、正文等法务专员P1
编辑版本进行中状态(草稿/待审核/审核通过/已驳回/待生效)均可编辑;编辑弹窗内"保存草稿"写入草稿轨、状态不变,"提交审核"将草稿提升为已提交内容并重置为待审核;协议编码不可修改法务专员P1
提交审核草稿状态版本提交平台管理员审核法务专员P1
审核操作审核通过或驳回,驳回时填写驳回原因平台管理员P1
发布生效审核通过版本发布生效,同编码旧版本自动失效。新版本生效后标记已签署用户需重新确认法务/运营P1
停用/启用协议通过列表「启用/停用」列开关切换:控制已生效协议是否允许用户签署。停用后新用户不可签署(已签署数据不受影响),启用后恢复签署。不影响版本状态机法务/运营P1
删除协议仅协议编码下从未有过已生效版本的协议可删除;已生效/已生效过的协议无删除按钮法务专员P1
版本历史查看某协议编码下的全部历史版本,展示协议编码、协议标题、版本号、状态、生效时间、失效时间、创建人、发布时间、变更说明、停用原因;支持点击「详情」查看历史版本协议正文法务/运营P1
签署记录查看某版本协议的签署记录列表,含签署人、签署时间、IP;支持查看每个签署方签署时的协议详情(签署快照)进行归档法务/运营P2
预览协议以C端展示样式预览协议正文内容(变量替换为示例值)。草稿状态优先展示草稿内容,其他状态展示已提交内容;页面顶部显示版本状态提示条法务/运营P1

13.1.2 协议类型与适用场景示例

说明:协议编码由系统自动生成(格式:AGR + YYYYMMDD + 3位序号,如 AGR20260821001),用户无需手动填写。以下为预置协议类型与适用场景示例,实际编码以系统生成为准。
协议类型协议标题签署方签署时机再确认机制
平台服务协议平台服务协议C端用户/供应商/分销商注册时勾选确认版本更新后下次登录弹出确认
隐私协议隐私协议C端用户/供应商/分销商注册时勾选确认版本更新后下次登录弹出确认
分销协议(平台公共)分销协议(平台公共)分销商入驻时签署版本更新后下次登录弹出确认
会员协议会员协议C端用户开通会员时签署版本更新后开通/使用会员功能时弹出确认
积分协议积分协议C端用户首次获取积分时签署版本更新后积分相关操作时弹出确认
分销员协议分销员协议个体分销员申请分销员时签署版本更新后下次登录弹出确认

13.1.3 字段说明

字段类型必填校验规则说明
协议编码文本系统生成格式 AGR+YYYYMMDD+3位序号,如 AGR20260821001;全局唯一,不可修改业务锚定字段,用于前端调用、版本唯一性约束、签署记录关联。由系统在创建协议时自动生成,用户不可编辑
协议标题文本是2-100字符展示用名称,可修改
版本号文本是格式 vX.Y,如 v2.1版本号须大于该编码下历史最大版本号
变更说明文本域是10-500字符描述本版本相较上一版本的变更内容
协议正文富文本是不少于100字符,不超过50000字符支持加粗、列表、标题层级、链接
生效方式下拉单选否立即生效/定时生效;默认立即生效选择定时生效时需填写生效时间
生效时间日期时间条件必填不早于当前时间+1小时仅生效方式=定时生效时必填
停用原因文本域是10-500字符停用协议时必填,记录停用原因;启用时清空。仅在列表页「停用」操作时弹出填写

13.2 交互逻辑表

触发入口前置条件操作步骤系统响应结果状态
列表页右上角「新增协议」按钮用户拥有 content:agreement:create 权限点击按钮 → 弹出新增弹窗 → 填写标题、版本号、正文等(协议编码由系统自动生成)→ 点击「保存草稿」或「提交审核」保存草稿:系统自动生成协议编码,写入 status=草稿,同时在 t_agreement_config 写入编码配置(enabled=1);提交审核:敏感词校验 → 写入 status=待审核 → 通知管理员审核草稿 / 待审核
列表页行内「新增版本」按钮用户拥有 content:agreement:create 权限;该协议编码下无进行中版本(草稿/待审核/审核通过/已驳回/待生效任一)点击按钮 → 弹窗中协议编码已锁定为该协议 → 填写版本号、正文等 → 点击「保存草稿」或「提交审核」保存草稿:写入 status=草稿,draft_content 写入当前内容;提交审核:敏感词校验 → submitted_content 写入当前内容、清空 draft_content → 写入 status=待审核 → 通知管理员审核草稿 / 待审核
列表页「编辑」操作版本状态为进行中状态(草稿/待审核/审核通过/已驳回/待生效);用户拥有 content:agreement:edit 权限点击行内「编辑」→ 弹出编辑弹窗(优先加载 draft_content,无则加载 submitted_content)→ 修改字段 → 点击「保存草稿」或「提交审核」保存草稿:写入 draft_content,submitted_content 不变,版本状态不变;提交审核:draft_content 提升为 submitted_content 并清空 draft_content → 敏感词校验 → 更新 status=待审核 → 发送站内信通知审核人。若原状态为待生效,自动取消定时发布任务原状态不变 / 待审核
列表页「提交审核」操作版本状态=草稿点击行内「提交审核」→ 二次确认 → 点击「确认」敏感词校验 → 更新 status=待审核 → 发送站内信通知审核人待审核
列表页「审核」操作版本状态=待审核;用户拥有 content:agreement:audit 权限点击行内「审核」→ 弹出审核弹窗 → 查看协议正文 → 点击「通过」或「驳回」通过:更新 status=审核通过;驳回:填写驳回原因 → 更新 status=已驳回,写入 audit_remark → 站内信通知提交人审核通过 / 已驳回
列表页「发布生效」操作版本状态=审核通过;用户拥有 content:agreement:publish 权限;协议编码处于启用状态点击行内「发布生效」→ 二次确认弹窗(提示旧版本将失效)→ 点击「确认发布」立即生效:更新 status=已生效,写入 effective_time 和 published_at → 同编码旧版本 status=已失效,expire_time = 新版本 effective_time → 标记已签署用户需重新确认;定时生效:创建定时任务,到达后执行相同逻辑已生效
列表页「启用/停用」开关切换用户拥有 content:agreement:stop(关闭)/ content:agreement:publish(开启)权限;协议状态=已生效点击「启用/停用」列开关切换协议的签署能力停用:弹出停用弹窗(必填停用原因,10-500字)→ t_agreement_config.enabled=0,写入 stop_reason,新用户不可签署,版本状态不变;启用:t_agreement_config.enabled=1,清空 stop_reason,恢复签署—
列表页「删除协议」操作协议编码下从未有过已生效版本;用户拥有 content:agreement:delete 权限点击行内「删除」→ 二次确认 → 点击「确认删除」物理删除该编码下所有草稿/待审核/已驳回版本,t_agreement_config.deleted=1协议编码删除
列表页「版本历史」操作—点击协议编码行「版本历史」→ 跳转版本历史页查询该编码下全部版本 → 按版本号倒序展示:协议编码、协议标题、版本号、状态、生效时间、失效时间、创建人、发布时间、变更说明、停用原因、操作(详情)—
版本历史页「详情」操作—点击行内「详情」→ 新开标签页展示该版本协议正文(C端样式,只读)读取 t_platform_agreement.content → 渲染富文本为C端展示样式;顶部显示版本状态提示条—
列表页「签署记录」操作版本状态=已生效 / 已失效点击行内「签署记录」→ 跳转签署记录页查询 t_agreement_sign → 分页展示签署方列表—
签署记录页「查看协议详情」操作—点击行内「查看协议详情」→ 弹窗展示签署快照读取 t_agreement_sign.sign_content → 渲染富文本为签署时的协议正文(含变量替换后的实际值)—
列表页「预览」操作—点击行内「预览」→ 新开标签页展示协议正文(C端样式)1. 内容来源:草稿状态优先读 draft_content,无则读 content;其他状态读 content(已提交内容) 2. 变量替换为示例值(如 ${userName}→张三) 3. 顶部显示版本状态提示条(草稿预览/待审核预览/审核通过预览/待生效预览/当前生效版本/已失效版本预览) 4. 页头显示协议标题、版本号、生效时间(如有)—

13.3 页面原型

13.3.1 协议列表页

平台协议及声明 - 列表页
/platform/content/agreement
基础管理 / 内容管理 / 平台协议及声明
平台协议及声明
协议编码协议标题协议状态启用/停用当前生效版本生效时间签署人数操作
AGR20260715001平台服务协议已生效●v3.22026-07-151,248版本历史新增版本签署记录预览
AGR20260601002隐私协议已生效●v2.02026-06-011,248版本历史新增版本签署记录预览
AGR20260720003分销协议(平台公共)已生效●v1.52026-07-20156版本历史新增版本签署记录预览
AGR20260801004会员协议草稿—暂无生效版本—版本历史新增版本编辑删除预览
AGR20260501005积分协议已失效●暂无生效版本980版本历史新增版本签署记录预览
AGR20260801006分销员协议已生效●v2.12026-08-01320版本历史新增版本签署记录预览
提示:同一协议编码下同时仅允许一个版本处于"已生效"状态。有进行中版本(草稿/待审核/审核通过/已驳回/待生效)时,该编码行不可再新增版本。已生效/已生效过的协议无删除按钮;从未生效的协议可删除。

13.3.2 新增版本弹窗

新增协议/版本 - 弹窗
新增协议/版本×
新增协议时由系统自动生成,不可编辑;新增版本时显示所属协议编码
H1H2B列表链接
请输入协议正文...
字数:0 / 50000

13.3.3 审核弹窗

协议审核 - 弹窗
协议审核 - 平台服务协议 v3.3×
版本号:v3.3
变更说明:更新退款条款第8条
提交人:张法务
提交时间:2026-08-10 14:00

云灵汐平台服务协议

版本号:v3.3

更新日期:2026年8月10日

第一条 服务条款的接受...

第八条 退款政策(更新)...用户在核销前申请退款,按商品退改规则计算退款金额,可能扣除手续费...

13.3.4 签署记录页

签署记录 - 平台服务协议 v3.2
共 1,248 条签署记录,当前第 1/125 页
签署方用户类型签署时间IP地址签署状态操作
供应商A(ID:10086)供应商2026-07-15 10:23:45192.168.1.100已签署查看协议详情
分销商B(ID:20068)分销商2026-07-15 14:56:1210.0.12.55已签署查看协议详情
用户C(ID:30012)C端用户2026-07-16 09:12:33172.16.5.88待重新确认查看协议详情
供应商D(ID:10092)供应商2026-07-16 11:45:00192.168.2.201已签署查看协议详情
分销商E(ID:20075)分销商2026-07-17 08:30:1510.0.15.42已重新签署查看协议详情
每页 10 条
上一页 1 2 3 ... 125 下一页

13.3.5 签署协议详情弹窗

签署协议详情(签署快照) - 供应商A
签署协议详情 - 平台服务协议 v3.2×
签署方:供应商A(ID:10086)
签署时间:2026-07-15 10:23:45 | IP:192.168.1.100
签署状态:已签署

平台服务协议

版本 v3.2 | 生效时间:2026-07-15


第一条 服务范围

本协议适用于供应商A(以下简称"乙方")在云领犀平台(以下简称"甲方")开展的旅游产品分销业务。乙方入驻甲方平台后,可发布旅游产品并接受分销商代销。

第二条 权利义务

乙方应确保所发布旅游产品符合国家法律法规,产品信息真实有效。甲方有权对乙方产品进行审核,不符合要求的产品不予上架。

以上为签署时协议正文快照(变量已替换为实际值),仅供归档查阅,不作为当前生效版本。

13.3.6 协议预览页

协议预览 - 平台服务协议 v3.2(已生效)
当前生效版本:用户正在签署的版本
协议标题:平台服务协议 版本号:v3.2 生效时间:2026-07-15

平台服务协议

版本 v3.2 | 生效时间:2026-07-15


第一条 服务范围

本协议适用于张三(以下简称"乙方")在云领犀平台(以下简称"甲方")开展的旅游产品分销业务。乙方入驻甲方平台后,可发布旅游产品并接受分销商代销。

第二条 权利义务

乙方应确保所发布旅游产品符合国家法律法规,产品信息真实有效。甲方有权对乙方产品进行审核,不符合要求的产品不予上架。

第三条 费用结算

甲方按月与乙方结算分销订单费用,结算周期为每月1日至月末,次月5个工作日内完成结算。佣金比例按产品类目约定执行。

第四条 协议期限

本协议自乙方签署之日起生效,有效期至甲方发布新版本协议时止。新版本生效后,乙方需重新签署确认。


变量为示例值(如"张三"),实际以用户签署时替换为准

预览内容来源规则

协议状态展示内容
草稿(有 draft_content)draft_content(草稿内容)
草稿(无 draft_content)content(已提交内容)
待审核 / 审核通过 / 待生效 / 已生效 / 已失效content(已提交内容)

13.3.7 版本历史页

版本历史 - AGR20260715001 平台服务协议
共 3 个版本,按版本号倒序排列
协议编码协议标题版本号状态生效时间失效时间创建人发布时间变更说明停用原因操作
AGR20260715001平台服务协议v3.2已生效2026-07-15 00:00:00—法务专员A2026-07-14 15:00:00更新退款条款第8条,新增跨境游特殊规定—详情
AGR20260715001平台服务协议v3.1已失效2026-05-01 00:00:002026-07-15 00:00:00法务专员A2026-04-30 10:00:00调整分销佣金比例说明—详情
AGR20260715001平台服务协议v3.0已失效2026-01-01 00:00:002026-05-01 00:00:00法务专员B2025-12-30 14:00:00初版发布—详情
停用原因取自 t_agreement_config.stop_reason(协议编码级),同一协议编码下所有版本行显示相同值;协议处于启用状态时显示"—"

13.3.8 停用协议弹窗

停用协议 - 弹窗
停用协议×
0/500

13.4 协议变量占位符

协议正文支持变量占位符机制,通过 ${变量名} 格式在协议正文中嵌入动态变量,系统在签署协议时自动将变量替换为实际值并存储签署快照。该机制适用于全部协议编码。

13.4.1 变量定义

协议正文中支持 ${变量名} 格式的变量占位符,例如"本协议由 ${platform_name} 与 ${merchant_name} 于 ${sign_date} 签署"。变量占位符在协议编辑时以高亮形式展示,保存时系统自动提取正文中全部 ${变量名} 格式的占位符。

13.4.2 预置变量列表

变量名说明示例值
${platform_name}平台名称,取系统配置中的平台全称云灵汐涉旅电商分销平台
${merchant_name}商家名称,签署时取当前签署商家的名称三亚旅行社有限公司
${sign_date}签署日期,签署时取当前日期2026年8月11日
${agreement_version}协议版本号,取当前签署协议的版本号v3.2
${contact_phone}联系电话,取系统配置中的客服电话400-888-8888

13.4.3 变量校验

保存协议正文时,系统自动提取正文中的全部变量占位符,与预置变量列表进行比对。识别到的预置变量自动展示在变量列表中;未识别的变量(不在预置变量列表中)以红色标红提示,并阻止提交审核,需法务人员修正后重新保存。

校验规则:提交审核时系统再次校验变量合法性,存在未识别变量的协议版本不可提交审核。审核通过后变量列表锁定,不可再修改正文中的变量占位符。

13.4.4 变量预览

编辑协议正文时点击「预览」按钮,系统使用示例数据渲染协议正文,展示变量替换后的效果。预览页面顶部标注"此为示例预览,实际签署时变量值以用户实际信息为准"。预览不修改协议正文内容,仅用于法务人员确认变量替换效果。

13.4.5 渲染时机

用户签署协议时,系统将协议正文中的变量占位符替换为实际值后存储签署快照。签署快照为渲染后的最终文本(非模板原文),确保历史签署记录不受后续协议版本修改影响。签署快照存储在 t_agreement_sign 表的 sign_content 快照字段中。

渲染规则:变量替换在服务端完成,前端仅展示渲染后的最终文本。若变量值获取失败(如商家名称为空),该变量保留占位符原文并记录 warning 日志,不影响签署流程。

13.4.6 适用范围

变量占位符机制适用于全部协议编码。各协议编码均可使用预置变量列表中的全部变量,无需按协议编码区分可用变量。

13.5 状态机定义

13.5.1 状态枚举

协议版本状态分为版本级状态(由用户操作直接驱动)和协议编码级派生状态(由下属版本状态聚合计算得出)两个维度。

版本级状态(Version Status)

状态码显示标签Tag颜色含义
DRAFT草稿warning(黄)新建/编辑未提交审核
AUDITING待审核primary(蓝)已提交审核,等待审核员操作
AUDIT_PASSED审核通过success(绿)审核通过,待发布
REJECTED已驳回danger(红)审核驳回,需修改后重新提交
PENDING_PUBLISH待生效primary(蓝)定时发布后等待到达生效时间
EFFECTIVE已生效success(绿)当前正在生效的版本
EXPIRED已失效info(灰)被新版本替代的旧生效版本

协议编码级派生状态(Protocol Code Status)

协议编码级状态不由用户操作直接设置,由其下属版本的版本级状态聚合计算得出,用于列表页协议编码行的状态展示:

派生状态码显示标签含义计算规则
NOT_EFFECTIVE未生效协议编码下无任何版本版本列表为空
IN_EFFECT生效中存在 EFFECTIVE 版本任一版本状态 = EFFECTIVE
NO_EFFECTIVE_VERSION无生效版本有版本但无 EFFECTIVE版本均处于非 EFFECTIVE 状态(EXPIRED/DRAFT 等)

13.5.2 双轨内容模型

协议版本内容采用"已提交内容"与"草稿内容"双轨分离设计,二者独立存储、互不覆盖:

操作写入/读取轨道对版本状态的影响
保存草稿写入 draft_content状态不变
提交审核draft_content 提升为 submitted_content,清空 draft_content状态变为 AUDITING(待审核)
发布读取 submitted_content 进行发布状态变为 EFFECTIVE 或 PENDING_PUBLISH
预览(列表页)读取 submitted_content—
预览(编辑弹窗内)读取当前编辑中的内容—

发布操作始终使用已提交内容(submitted_content),即使草稿内容存在且与已提交内容不同,草稿内容不会被发布。若点击"发布"时检测到 draft_content 与 submitted_content 存在差异,弹窗提示"当前有未提交的草稿内容,发布将使用已审核内容"。

编辑弹窗加载规则:打开编辑弹窗时,优先加载 draft_content(若存在),否则加载 submitted_content。

13.5.3 状态流转规则

正向主流程

新增版本 → DRAFT(草稿)
         → 点击"提交审核" → AUDITING(待审核)
         → 审核员点击"审核通过" → AUDIT_PASSED(审核通过)
         → 点击"发布"
            ├─ 立即生效 → EFFECTIVE(已生效)
            └─ 定时生效 → PENDING_PUBLISH(待生效)→ 到达生效时间 → EFFECTIVE(已生效)

审核驳回流程

AUDITING(待审核)→ 审核员点击"审核驳回" → REJECTED(已驳回)
         → 编辑修改 → 点击"提交审核" → AUDITING(重新走审核)

编辑闭环

DRAFT、AUDITING、AUDIT_PASSED、REJECTED、PENDING_PUBLISH 这五个进行中状态均允许点击"编辑"打开编辑弹窗。编辑弹窗内提供两个操作:

无论原状态是什么,只要点击"提交审核",版本状态一律变为 AUDITING。

终态流转

原状态流转条件目标状态
已生效 EFFECTIVE新版本生效,当前版本被替代已失效 EXPIRED
待生效 PENDING_PUBLISH到达定时生效时间已生效 EFFECTIVE

EXPIRED 为终态,不可再流转到其他版本级状态,仅允许在其下新增版本。

定时器处置规则:版本状态离开 PENDING_PUBLISH(待生效)时(如通过编辑弹窗"提交审核"流转至 AUDITING),系统自动取消该版本关联的定时发布任务,定时器不可再触发任何状态变更。

13.5.4 状态流转表

当前状态触发动作目标状态前置条件副作用
—(不存在)新增保存草稿草稿 DRAFT必填项校验通过;该协议编码下无进行中版本(DRAFT/AUDITING/AUDIT_PASSED/REJECTED/PENDING_PUBLISH 任一)写入 t_platform_agreement,status=DRAFT;submitted_content 为空,draft_content 写入当前内容
—(不存在)新增提交审核待审核 AUDITING必填项 + 敏感词校验通过;该协议编码下无进行中版本写入 t_platform_agreement,status=AUDITING;submitted_content 写入当前内容,draft_content 清空;站内信通知审核人
草稿 DRAFT编辑-保存草稿草稿 DRAFT用户拥有 content:agreement:edit 权限写入 draft_content,submitted_content 不变,状态不变
草稿 DRAFT提交审核(列表/弹窗)待审核 AUDITING敏感词校验通过draft_content 提升为 submitted_content,清空 draft_content;更新 status=AUDITING;站内信通知审核人
草稿 DRAFT删除—(已删除)该协议编码无生效历史物理删除记录
待审核 AUDITING编辑-保存草稿待审核 AUDITING用户拥有 content:agreement:edit 权限写入 draft_content,submitted_content 不变,状态不变
待审核 AUDITING编辑-提交审核待审核 AUDITING敏感词校验通过draft_content 提升为 submitted_content,清空 draft_content;更新 status=AUDITING;站内信通知审核人
待审核 AUDITING审核通过审核通过 AUDIT_PASSED审核人拥有 content:agreement:audit 权限更新 status=AUDIT_PASSED,写入 audited_at
待审核 AUDITING审核驳回已驳回 REJECTED填写驳回原因更新 status=REJECTED,写入 audit_remark;站内信通知提交人
已驳回 REJECTED编辑-保存草稿已驳回 REJECTED用户拥有 content:agreement:edit 权限写入 draft_content,submitted_content 不变,状态不变
已驳回 REJECTED编辑-提交审核待审核 AUDITING敏感词校验通过draft_content 提升为 submitted_content,清空 draft_content;更新 status=AUDITING
已驳回 REJECTED删除—(已删除)该协议编码无生效历史物理删除记录
审核通过 AUDIT_PASSED编辑-保存草稿审核通过 AUDIT_PASSED用户拥有 content:agreement:edit 权限写入 draft_content,submitted_content 不变,状态不变
审核通过 AUDIT_PASSED编辑-提交审核待审核 AUDITING敏感词校验通过draft_content 提升为 submitted_content,清空 draft_content;更新 status=AUDITING
审核通过 AUDIT_PASSED发布生效(立即)已生效 EFFECTIVE用户拥有 content:agreement:publish 权限;协议编码处于启用状态更新 status=EFFECTIVE,写入 effective_time 和 published_at(读取 submitted_content 发布);同编码旧版本 status=EXPIRED,expire_time = 新版本 effective_time;标记已签署用户需重新确认
审核通过 AUDIT_PASSED发布生效(定时)待生效 PENDING_PUBLISH填写生效时间(不早于当前时间+1小时)创建定时任务;到达时间后自动执行生效逻辑
待生效 PENDING_PUBLISH编辑-保存草稿待生效 PENDING_PUBLISH用户拥有 content:agreement:edit 权限写入 draft_content,submitted_content 不变,定时器保持运行
待生效 PENDING_PUBLISH编辑-提交审核待审核 AUDITING敏感词校验通过draft_content 提升为 submitted_content,清空 draft_content;更新 status=AUDITING;自动取消定时发布任务
待生效 PENDING_PUBLISH定时任务执行已生效 EFFECTIVE到达生效时间更新 status=EFFECTIVE,写入 effective_time 和 published_at(读取 submitted_content 发布);同编码旧版本 status=EXPIRED,expire_time = 新版本 effective_time;标记已签署用户需重新确认
已生效 EFFECTIVE新版本发布生效已失效 EXPIRED同编码新版本执行发布生效自动更新 status=EXPIRED,expire_time = 新版本 effective_time

13.5.5 各状态列表操作按钮矩阵

状态编辑提交审核(列表)审核发布新增版本删除签署预览
草稿 DRAFT✓✓———✓(无生效历史时)—✓
待审核 AUDITING✓—✓————✓
审核通过 AUDIT_PASSED✓——✓———✓
已驳回 REJECTED✓————✓(无生效历史时)—✓
待生效 PENDING_PUBLISH✓——————✓
已生效 EFFECTIVE————✓—✓✓
已失效 EXPIRED————✓——✓
未生效 NOT_EFFECTIVE————✓✓—✓
说明:"提交审核(列表)"仅 DRAFT 状态在列表页可直接操作,其余进行中状态需通过编辑弹窗内"提交审核"按钮提交。NOT_EFFECTIVE 为协议编码级状态,其下无版本行,"新增版本"即创建该协议编码的第一个版本,"删除"即删除空协议编码本身。

13.5.6 附加业务规则

新增版本互斥

同一协议编码下存在进行中版本(DRAFT / AUDITING / AUDIT_PASSED / REJECTED / PENDING_PUBLISH 任一)时,不可新增版本。必须等当前版本到达终态(EFFECTIVE / EXPIRED)后,或该协议编码下无版本(NOT_EFFECTIVE)时,才可新增。

版本号约束

新版本号必须为 vX.Y 格式,且大于该协议编码下历史最大版本号。

生效互斥

同一协议编码同时只能有一个 EFFECTIVE 版本。新版本生效时,旧 EFFECTIVE 版本自动转为 EXPIRED,失效时间等于新版本生效时间。

启用/停用开关

启用/停用开关为协议编码级操作,仅控制已生效协议是否允许用户签署,不影响版本状态机。开关状态存储在 t_agreement_config.enabled 字段。仅在版本状态=已生效时有效。

删除规则

删除操作针对整个协议编码(连同其下所有版本),需同时满足以下条件:

  1. 该协议编码无生效历史(从未出现过 EFFECTIVE 版本)。
  2. 当前进行中版本状态为 DRAFT 或 REJECTED,或协议编码下无版本(NOT_EFFECTIVE)。

13.5.7 签署记录流转(独立状态机)

签署记录与协议版本是两个独立的领域对象,各自维护独立的状态机。签署记录状态存储在 t_agreement_sign.sign_status 字段。

状态码显示标签含义
SIGNED已签署用户已完成当前版本签署
PENDING_RECONFIRM待重新确认原签署版本被新版本替代(旧版本 EXPIRED),需用户重新签署新版本
RESIGNED已重新签署用户对新版本完成重新签署

流转规则:

13.6 异常处理

异常场景触发条件前端表现系统处理恢复方案
重复新增同编码版本该协议编码下已存在进行中版本(草稿/待审核/审核通过/已驳回/待生效任一)协议编码下拉框中该选项置灰并标注"已有进行中版本"前端加载时查询该编码状态,拦截重复新增用户先处理已有进行中版本(审核/发布/删除)后再新增
版本号不合法版本号格式不符合 vX.Y 或不大于历史最大版本号版本号字段下方红色提示"版本号格式不正确"或"版本号须大于当前编码下最新版本 vX.Y"返回 field_error用户修改版本号后重新提交
敏感词拦截协议正文命中拦截级敏感词弹窗不关闭,正文下方红色提示命中的敏感词列表返回命中的拦截级敏感词列表用户修改正文后重新提交
未识别变量协议正文中包含不在预置变量列表中的变量占位符未识别变量以红色标红提示,列出未识别变量名称阻止提交审核,返回未识别变量列表法务人员修正变量名或删除未识别变量后重新保存
审核驳回未填原因审核人点击驳回但未填写驳回原因驳回按钮置灰,审核备注下方提示"驳回时必须填写原因"前端校验审核人填写原因后点击驳回
删除已生效/已生效过的协议用户尝试删除协议编码下已有过已生效版本的协议删除按钮不展示或点击后提示"已生效/已生效过的协议不可删除"前端校验 t_agreement_config 中是否存在已生效历史如需下线请使用「停用」操作关闭签署入口
启用无审核通过版本的协议已移除启用/停用仅控制签署入口,不涉及版本发布——
发布生效时旧版本签署中新版本发布生效时,旧版本有用户正在签署(极小概率并发场景)—后端事务保证:旧版本先置为已失效并写入 expire_time,新版本置为已生效,中间事务窗口内用户签署将记录到新版本—
定时生效任务失败定时任务执行时系统异常—记录任务失败日志;重试3次,间隔5分钟;3次失败后通知法务/运营负责人管理员手动执行发布生效,或取消本次定时发布
停用未填原因或字数不足用户点击「确认停用」但停用原因为空或少于10字「确认停用」按钮禁用或点击后提示"请输入停用原因(10-500字)"前端校验 stop_reason 长度—
停用后无生效版本已移除启用/停用仅控制签署入口,不影响版本状态,不产生此场景——

14. 敏感词库

14.1 核心业务逻辑

敏感词库是平台内容治理的基础设施,为公告、协议、商品名称、商品详情、用户评价、站内信等内容提供统一的敏感词校验服务。平台运营/风控人员维护敏感词库,每个敏感词设置分类(政治/色情/广告/欺诈/其他)和处理级别(拦截/替换/审核)。业务模块提交内容时调用敏感词校验接口,接口按处理级别返回对应结果。

业务边界:敏感词库仅平台运营后台可操作。敏感词校验接口为内部服务,被各业务模块调用(商品管理中心、订单中心、营销中心、站内信等)。命中记录由各业务模块调用时自动写入,本模块仅提供查询。

14.1.1 功能清单

功能项说明操作角色优先级
敏感词列表分页查询敏感词,支持按词汇、分类、级别、状态筛选平台运营/风控P2
新增敏感词填写词汇、分类、级别、替换词后保存平台运营/风控P2
编辑敏感词修改词汇分类、级别、替换词平台运营/风控P2
启停敏感词启用/停用单个敏感词平台运营/风控P2
批量导入通过Excel文件批量导入敏感词平台运营/风控P2
批量启停列表勾选多条敏感词后批量启用/停用平台运营/风控P2
命中记录查看敏感词命中记录,含来源类型、来源内容、处理方式平台运营/风控P2

14.1.2 字段说明

字段类型必填校验规则说明
敏感词汇文本是1-50字符,全局唯一敏感词内容,不区分大小写
分类下拉单选是枚举:政治/色情/广告/欺诈/其他用于分类管理和统计
处理级别下拉单选是枚举:拦截/替换/审核拦截:阻止提交;替换:自动替换为替换词;审核:放行但标记待审
替换词文本条件必填1-50字符;仅处理级别=替换时必填命中后自动替换的目标词,常用***

14.2 交互逻辑表

触发入口前置条件操作步骤系统响应结果状态
列表页「新增敏感词」按钮用户拥有 content:sensitive:create 权限点击按钮 → 弹出新增弹窗 → 填写字段 → 点击「保存」校验必填项 + 唯一性校验 → 写入数据库 is_enabled=true → 刷新敏感词缓存启用
列表页「编辑」操作用户拥有 content:sensitive:edit 权限点击行内「编辑」→ 弹出编辑弹窗 → 修改字段 → 点击「保存」校验必填项 → 更新数据库 → 刷新敏感词缓存保持原状态
列表页「停用」操作敏感词 is_enabled=true点击行内「停用」更新 is_enabled=false → 5分钟内刷新缓存生效(CM-B03)停用
列表页「启用」操作敏感词 is_enabled=false点击行内「启用」更新 is_enabled=true → 5分钟内刷新缓存生效启用
列表页「批量导入」按钮用户拥有 content:sensitive:import 权限点击按钮 → 弹出导入弹窗 → 下载模板 → 填写后上传Excel → 点击「确认导入」解析Excel → 逐行校验(必填项+唯一性) → 写入数据库 → 返回导入结果(成功X条/失败X条/失败明细) → 刷新缓存启用
列表页「批量启停」操作列表已勾选至少1条敏感词勾选多条 → 点击「批量启用」或「批量停用」批量更新 is_enabled → 刷新缓存启用/停用
列表页「命中记录」操作—点击行内「命中记录」→ 跳转命中记录页查询 t_sensitive_hit_log → 分页展示—

14.3 页面原型

14.3.1 敏感词列表页

敏感词库 - 列表页
/platform/content/sensitive-word
基础管理 / 内容管理 / 敏感词库
敏感词库 共 1,256 条,启用 1,180 条
敏感词汇分类处理级别替换词命中次数状态创建时间操作
违规词A政治拦截—12启用2026-07-01编辑停用命中记录
广告词B广告替换***286启用2026-07-01编辑停用命中记录
疑似词C其他审核—5停用2026-06-15编辑启用命中记录
共 1,256 条 1 每页 条

14.3.2 批量导入弹窗

批量导入敏感词 - 弹窗
批量导入敏感词×
导入说明:请先下载模板,按模板格式填写后上传。支持 .xlsx 格式,单次最多导入 1000 条。
将Excel文件拖拽到此处,或
仅支持 .xlsx 格式,文件不超过 5MB
下载导入模板
字段:敏感词汇* | 分类* | 处理级别* | 替换词

14.4 状态机定义

当前状态触发动作目标状态前置条件副作用
—(不存在)新增启用必填项 + 唯一性校验通过写入 t_sensitive_word,is_enabled=true;刷新缓存
启用停用停用无更新 is_enabled=false;5分钟内刷新缓存(CM-B03)
停用启用启用无更新 is_enabled=true;5分钟内刷新缓存
缓存刷新机制:敏感词库在内存中构建匹配树(DFA/AC自动机),更新后通过消息队列通知各服务节点刷新本地缓存,最长延迟5分钟。已提交并放行的内容不追溯校验(CM-B03)。

14.5 异常处理

异常场景触发条件前端表现系统处理恢复方案
重复敏感词新增/导入的词汇已存在词汇字段下方红色提示"该敏感词已存在"返回 field_error: word_duplicate用户修改词汇或编辑已有记录
替换词未填处理级别选择"替换"但未填写替换词替换词字段下方红色提示"处理级别为替换时必须填写替换词"前端校验用户填写替换词后保存
导入文件格式错误上传文件非 .xlsx 格式或超过 5MB上传区域红色提示"文件格式不支持"或"文件大小超过限制"前端拦截用户更换文件后重新上传
导入数据校验失败Excel中部分行必填项为空或词汇重复导入完成后显示结果弹窗:"成功导入 X 条,失败 X 条",下方展示失败明细表(行号-词汇-失败原因)逐行校验,合法行写入数据库,非法行跳过并记录用户修正Excel中失败行后重新导入
缓存刷新延迟敏感词更新后5分钟内仍使用旧缓存—属于预期行为(CM-B03),不报错等待5分钟后自动生效

15. 关键词管理

15.1 核心业务逻辑

关键词管理是平台运营人员维护移动端(C端)搜索关键词的工具,包括热门搜索词、推荐搜索词和屏蔽搜索词三类。热门搜索词展示在移动端搜索页默认推荐位,推荐搜索词用于搜索联想词推荐,屏蔽搜索词用于过滤不当搜索内容。关键词通过排序权重控制展示顺序。

业务边界:关键词管理仅平台运营后台可操作。关键词数据通过接口提供给移动端搜索引擎使用,搜索统计(搜索次数、点击次数)由移动端搜索服务写入统计表,本模块仅提供查询展示。

15.1.1 功能清单

功能项说明操作角色优先级
关键词列表分页查询关键词,支持按词汇、类型、状态筛选平台运营P1
新增关键词填写词汇、类型、排序权重后保存平台运营P1
编辑关键词修改词汇类型、排序权重平台运营P1
启停关键词启用/停用单个关键词平台运营P1
批量排序列表中直接修改排序权重值并保存平台运营P1
搜索统计查看关键词搜索次数、点击次数统计平台运营P1
删除关键词删除单个选中的关键词,需二次确认平台运营P1
批量删除关键词勾选多个关键词后批量删除,需二次确认平台运营P1
查看搜索结果点击关键词查看该词对应的C端商品搜索结果和分销商搜索结果平台运营P1

15.1.2 关键词类型说明

类型keyword_type编码移动端展示位说明
热门搜索hot搜索页默认展示,最多展示10个用户点击搜索框时直接展示的热门词列表
推荐搜索recommend搜索输入时联想词推荐用户输入时根据输入内容匹配推荐词
屏蔽搜索block不展示用户搜索该词时不返回结果,提示"暂无相关商品"

15.1.3 字段说明

字段类型必填校验规则说明
关键词文本是1-50字符,全局唯一关键词内容
类型下拉单选是枚举:热门搜索/推荐搜索/屏蔽搜索决定关键词在移动端的行为
排序权重数字否0-999,默认0数值越小越靠前,仅热门搜索和推荐搜索生效

15.2 交互逻辑表

触发入口前置条件操作步骤系统响应结果状态
列表页「新增关键词」按钮用户拥有 content:keyword:create 权限点击按钮 → 弹出新增弹窗 → 填写字段 → 点击「保存」校验必填项 + 唯一性校验 → 写入数据库 is_enabled=true → 刷新列表启用
列表页「编辑」操作用户拥有 content:keyword:edit 权限点击行内「编辑」→ 弹出编辑弹窗 → 修改字段 → 点击「保存」校验必填项 → 更新数据库 → 刷新列表保持原状态
列表页「停用」操作关键词 is_enabled=true点击行内「停用」更新 is_enabled=false → 移动端不再展示该词停用
列表页「启用」操作关键词 is_enabled=false点击行内「启用」更新 is_enabled=true → 移动端恢复展示启用
列表页内联排序修改关键词 is_enabled=true 且类型非屏蔽搜索直接修改排序列输入框数值 → 失焦自动保存校验数值范围 → 更新 sort_weight → 刷新列表顺序启用
列表页「搜索统计」操作—点击行内「搜索统计」→ 弹出统计弹窗查询 t_keyword_stat → 展示近7天/30天搜索次数和点击次数趋势—
列表页「删除」操作用户拥有 content:keyword:delete 权限点击行内「删除」→ 弹出确认弹窗"删除后不可恢复,确认删除?" → 点击「确认」校验关键词是否被引用(热门/推荐词无引用限制)→ 逻辑删除 t_keyword → 刷新列表已删除
列表页「批量删除」操作用户拥有 content:keyword:delete 权限且选中至少1条勾选多行 → 点击「批量删除」→ 弹出确认弹窗 → 点击「确认」批量逻辑删除 → 刷新列表已删除
列表页「查看搜索结果」操作关键词存在搜索统计点击行内「搜索结果」→ 新开标签页跳转至商品搜索结果页查询该关键词对应的C端商品列表和分销商信息列表 → 展示搜索结果页—

15.3 页面原型

15.3.1 关键词列表页

关键词管理 - 列表页
/platform/content/keyword
基础管理 / 内容管理 / 关键词
关键词管理
关键词类型排序权重搜索次数状态创建时间操作
三亚旅游热门搜索3,256启用2026-07-01编辑停用搜索统计搜索结果删除
海南酒店热门搜索1,892启用2026-07-01编辑停用搜索统计搜索结果删除
三亚推荐搜索5,102启用2026-06-15编辑停用搜索统计搜索结果删除
违禁词D屏蔽搜索——启用2026-06-20编辑停用删除
共 86 条 1 每页 条

15.4 状态机定义

当前状态触发动作目标状态前置条件副作用
—(不存在)新增启用必填项 + 唯一性校验通过写入 t_keyword,is_enabled=true
启用停用停用无更新 is_enabled=false;移动端不再展示
停用启用启用无更新 is_enabled=true;移动端恢复展示
启用删除已删除用户确认删除逻辑删除 is_deleted=true;移动端不再展示
停用删除已删除用户确认删除逻辑删除 is_deleted=true

15.5 异常处理

异常场景触发条件前端表现系统处理恢复方案
重复关键词新增的关键词已存在关键词字段下方红色提示"该关键词已存在"返回 field_error: word_duplicate用户修改关键词或编辑已有记录
排序权重越界排序权重值不在0-999范围内排序字段下方红色提示"排序权重须为0-999的整数"前端校验用户修正后重新保存
屏蔽词设排序类型为屏蔽搜索时修改排序权重排序权重输入框为只读,提示"屏蔽搜索词不需要排序"前端控制—
删除被引用关键词尝试删除仍被C端搜索统计引用的关键词—允许删除(逻辑删除不影响历史统计)—
批量删除包含屏蔽词批量选中包含不同类型关键词提示"选中项包含不同类型关键词,确认全部删除?"前端确认用户确认或取消

15A. 内容分类管理

15A.1 核心业务逻辑

内容分类管理是平台运营人员对平台发布的各类内容进行分类组织的工具,采用多级分类树结构管理分类层级。系统预置四个一级分类:公告管理、文章管理、须知管理、帮助指南,每个一级分类下可创建多级子分类(最多3级)。文章创建时必须归属一个最末级分类节点。分类被文章引用时不可删除,需先解除引用关系后方可删除。

业务边界:内容分类管理仅平台运营后台可操作。一级分类(公告管理/文章管理/须知管理/帮助指南)为系统预置,不可删除,可编辑名称。子分类由运营人员按需创建。分类树数据用于文章创建时的分类选择和各端内容列表的分类筛选。内容分类主要服务于文章/资讯管理,同时为公告、须知、帮助提供可选的分类归属参考,但不强制要求后三种类型必须选择分类。

15A.1.1 功能清单

功能项说明操作角色优先级
分类树展示树形结构展示全部分类,支持展开/折叠、按名称搜索平台运营P1
新增子分类选择父分类后新增子分类,填写名称、排序权重。最多3级平台运营P1
编辑分类修改分类名称、排序权重(一级分类可改名,不可删除)平台运营P1
删除分类删除未被文章引用的分类节点(仅子分类可删除,一级分类不可删除)平台运营P1
启停分类启用/停用分类节点,停用后文章创建时该分类及子分类不可选平台运营P1
排序管理同级分类间拖拽排序或修改排序权重平台运营P1

15A.1.2 字段说明

字段类型必填校验规则说明
分类名称文本是1-50字符,同层级下唯一分类节点的显示名称
父分类下拉树选是选择父级分类节点;一级分类父为"根节点"决定分类在树中的层级位置
层级数字(只读)—系统自动计算,1-3级一级=预置分类,二级/三级=用户创建
排序权重数字否0-999,默认0同级分类间的展示顺序,数值越小越靠前
状态下拉单选是枚举:启用/停用;默认启用停用后该分类及子分类在文章创建时不可选
文章引用数数字(只读)—系统自动统计该分类下关联的文章数量,删除前校验
是否系统预置布尔(只读)—一级分类为true,其余false系统预置分类不可删除

15A.2 交互逻辑表

触发入口前置条件操作步骤系统响应结果状态
列表页「新增子分类」按钮用户拥有 content:category:create 权限;选中一个父分类节点点击父分类行内「新增子分类」→ 弹出新增弹窗 → 填写名称、排序 → 点击「保存」校验层级≤3 + 同层级唯一性 → 写入数据库 parent_id=父分类ID → 刷新树启用
列表页「编辑」操作用户拥有 content:category:edit 权限点击行内「编辑」→ 弹出编辑弹窗 → 修改名称/排序 → 点击「保存」校验必填项 + 唯一性 → 更新数据库 → 刷新树保持原状态
列表页「删除」操作用户拥有 content:category:delete 权限;分类非系统预置;文章引用数=0点击行内「删除」→ 二次确认 → 点击「确认删除」校验非系统预置 + 引用数=0 + 无子分类 → 逻辑删除 → 刷新树已删除
列表页「停用」操作分类 is_enabled=true点击行内「停用」更新 is_enabled=false → 该分类及子分类在文章创建时不可选停用
列表页「启用」操作分类 is_enabled=false点击行内「启用」更新 is_enabled=true → 该分类及子分类在文章创建时可选启用
列表页拖拽排序同级分类间拖拽拖拽分类行到目标位置更新 sort_weight → 刷新树保持原状态

15A.3 页面原型

15A.3.1 内容分类列表页

内容分类管理 - 列表页
/platform/content/category
基础管理 / 内容管理 / 内容分类
内容分类管理
分类名称层级排序权重文章引用数状态操作
▼ 公告 (系统预置)一级1—启用编辑新增子分类
▶ 平台公告二级118启用编辑新增子分类停用删除
▶ 供应商公告二级212启用编辑新增子分类停用删除
▶ 分销商公告二级38启用编辑新增子分类停用删除
▶ 文章 (系统预置)一级2—启用编辑新增子分类
▶ 须知 (系统预置)一级3—启用编辑新增子分类
▼ 帮助 (系统预置)一级4—启用编辑新增子分类
▶ 新手指南二级15启用编辑新增子分类停用删除
▶ 常见问题二级23启用编辑新增子分类停用删除
▶ 操作手册二级30停用编辑新增子分类启用删除
共 10 条 每页 条

15A.4 状态机定义

当前状态触发动作目标状态前置条件副作用
—(不存在)新增子分类启用必填项 + 层级≤3 + 同层级唯一性写入 t_content_category,parent_id=父分类ID
启用停用停用无更新 is_enabled=false;该分类及子分类在文章创建时不可选
停用启用启用无更新 is_enabled=true
启用删除已删除非系统预置 + 文章引用数=0 + 无子分类;用户确认逻辑删除记录
停用删除已删除非系统预置 + 文章引用数=0 + 无子分类;用户确认逻辑删除记录
状态流转约束:系统预置的一级分类(公告管理/文章管理/须知管理/帮助指南)不可删除,仅可编辑名称。子分类被文章引用时不可删除,需先迁移文章至其他分类。删除有子分类的节点时,需先删除全部子分类。停用父分类时子分类一并不可选,但子分类的 is_enabled 字段不变。

15A.5 异常处理

异常场景触发条件前端表现系统处理恢复方案
同层级分类名称重复新增/编辑的分类名称在同一层级下已存在名称字段下方红色提示"该层级下分类名称已存在"返回 field_error: name_duplicate用户修改名称
删除系统预置分类尝试删除一级分类提示"系统预置分类不可删除"前端校验拦截—
删除有子分类的节点删除仍有子分类的节点提示"该分类下有N个子分类,请先删除子分类"校验子分类数>0时拒绝先删除子分类
层级超限在第3级分类下新增子分类新增按钮置灰或提示"已达最大层级(3级),不可继续添加"前端按层级控制—
删除被引用分类删除仍被文章引用的分类提示"该分类被X篇文章引用,请先迁移文章后删除"校验 article_count>0时拒绝先迁移文章

15B. 文章/资讯管理

15B.1 核心业务逻辑

文章/资讯管理是平台运营人员向供应商、分销商及C端用户发布新闻类资讯内容的入口。文章通过富文本编辑器创建,可配置文章类型、内容分类、封面图、摘要等信息。文章支持草稿保存、上下架管理、置顶展示、定向推送和阅读统计。文章类型仅保留新闻,公告、须知、帮助已从文章中剥离,分别作为独立内容体系使用独立数据表(t_announcement、t_notice、t_help)。

业务边界:文章/资讯管理仅平台运营后台可操作。文章发布后按推送范围分发至供应商后台、分销商后台及C端商城展示。文章与公告管理模块、须知管理模块、帮助管理模块相互独立,详见15B.8。

15B.1.1 功能清单

功能项说明操作角色优先级
文章列表分页查询文章,支持按标题、类型、分类、上下架状态筛选平台运营P1
新增文章通过富文本编辑器创建文章,选择类型和分类,填写标题、正文、封面图、摘要、作者平台运营P1
编辑文章草稿/已下架状态可编辑全部字段平台运营P1
文章上架草稿/已下架状态文章执行上架,可选推送至供应商/分销商收件箱平台运营P1
文章下架已上架文章执行下架,下架后各端不再展示平台运营P1
文章置顶已上架文章设置置顶,同一分类下最多5篇置顶平台运营P1
删除文章单个或批量删除文章,已上架文章需先下架平台运营P1
文章推送上架文章时可推送至供应商/分销商后台收件箱平台运营P1
阅读统计统计文章阅读人数、阅读次数、阅读率平台运营P1

15B.1.2 字段说明

字段类型必填校验规则说明
文章标题文本是2-200字符展示在文章列表和详情页标题位
文章类型下拉单选是枚举:新闻(可扩展其他非重叠类型)决定文章在各端的展示位置和分类标签;不得与公告、须知、帮助等独立类型重复
内容分类下拉单选是从已启用的内容分类中选择文章归属的内容分类
正文内容富文本是不少于10字符,不超过20000字符支持加粗、斜体、列表、链接、图片上传
封面图图片上传否JPG/PNG,不超过2MB文章列表展示的缩略图
摘要文本域否不超过500字符文章列表中展示的简介内容
作者文本否不超过50字符文章的作者信息
排序权重数字否0-999,默认0数值越小越靠前
置顶标识开关否默认关闭开启后需校验同分类置顶数量上限
上下架状态系统状态—草稿/已上架/已下架控制文章在各端的展示状态

15B.1.3 文章类型说明

文章类型article_type编码展示位置说明
新闻news平台后台/供应商后台/分销商后台新闻栏目平台发布的行业新闻、公司动态等资讯内容
类型边界说明:公告、须知、帮助已从文章中剥离,分别作为独立内容体系使用独立数据表(t_announcement、t_notice、t_help)。文章类型仅保留新闻,后续如需扩展其他资讯类型,应确保与公告、须知、帮助的编码不重复、语义不重叠。

15B.2 交互逻辑表

触发入口前置条件操作步骤系统响应结果状态
列表页「新增文章」按钮用户拥有 content:article:create 权限点击按钮 → 跳转编辑页 → 填写字段 → 点击「保存草稿」或「上架」保存草稿:校验必填项 → 写入数据库 status=草稿;上架:校验必填项 + 敏感词校验 → 写入数据库 status=已上架 → 可选推送至收件箱草稿 / 已上架
列表页「编辑」操作文章状态=草稿 或 已下架;用户拥有 content:article:edit 权限点击行内「编辑」→ 跳转编辑页 → 修改字段 → 点击「保存」校验必填项 → 更新数据库 → 刷新列表草稿 / 已下架
列表页「上架」操作文章状态=草稿 或 已下架;用户拥有 content:article:publish 权限点击行内「上架」→ 弹出推送配置弹窗(可选推送范围)→ 点击「确认上架」敏感词校验 → 更新 status=已上架,写入 publish_time → 按推送范围发送站内信 → 各端展示已上架
列表页「下架」操作文章状态=已上架;用户拥有 content:article:offline 权限点击行内「下架」→ 二次确认弹窗 → 点击「确认下架」更新 status=已下架 → 各端移除展示 → 刷新列表已下架
列表页「置顶」操作文章状态=已上架;用户拥有 content:article:pin 权限点击行内「置顶」校验同分类置顶数 < 5 → 通过则更新 is_pinned=true → 刷新列表已上架(置顶)
列表页「取消置顶」操作文章 is_pinned=true点击行内「取消置顶」更新 is_pinned=false → 刷新列表已上架(非置顶)
列表页「删除」操作文章状态=草稿 或 已下架点击行内「删除」→ 二次确认弹窗 → 点击「确认删除」逻辑删除文章记录 → 刷新列表已删除
列表页「批量删除」操作列表已勾选至少1条且状态均为草稿或已下架勾选多行 → 点击「批量删除」→ 二次确认 → 点击「确认」批量逻辑删除 → 刷新列表已删除
列表页「阅读统计」操作文章状态=已上架点击行内「阅读统计」→ 跳转阅读统计详情页查询 t_article_read 聚合数据 → 渲染统计页面—

15B.3 页面原型

15B.3.1 文章列表页

文章/资讯管理 - 列表页
/platform/content/publish?tab=article
基础管理 / 内容管理 / 内容发布 / 文章
文章/资讯管理
文章标题类型分类状态置顶阅读率发布时间操作
2026暑期旅游旺季运营策略新闻平台新闻已上架是68%2026-08-10 09:00编辑下架取消置顶阅读统计
供应商入驻流程优化解读新闻行业动态已上架否45%2026-08-08 14:30编辑下架置顶阅读统计
平台分销佣金政策调整说明新闻平台新闻草稿否——编辑上架删除
暑期亲子游产品推荐新闻行业动态已下架否32%2026-08-05 10:00编辑上架删除
共 86 条 1 每页 条

15B.3.2 文章编辑页

文章/资讯管理 - 编辑页
/platform/content/publish?tab=article&action=edit&id=123
基础管理 / 内容管理 / 内容发布 / 文章 / 编辑
编辑文章
点击上传或拖拽图片到此处
JPG/PNG,不超过2MB
BI列表链接图片
请输入文章正文...
字数:0 / 20000
关闭
推送范围:上架时可选择推送至供应商/分销商后台收件箱,通过站内信通知。

15B.4 状态机定义

当前状态触发动作目标状态前置条件副作用
—(不存在)新增保存草稿草稿必填项校验通过写入 t_article,status=草稿
—(不存在)新增直接上架已上架必填项 + 敏感词校验通过写入 t_article,status=已上架,写入 publish_time;分发至各端
草稿上架已上架敏感词校验通过更新 status=已上架,写入 publish_time;分发至各端;可选推送站内信
已上架下架已下架用户确认下架更新 status=已下架;各端移除展示
已下架上架已上架敏感词校验通过更新 status=已上架,写入 publish_time;分发至各端
草稿删除已删除用户确认删除逻辑删除记录
已下架删除已删除用户确认删除逻辑删除记录
状态流转约束:已上架文章不可直接删除,需先下架后再删除。已下架文章可重新上架。删除操作不可恢复,需二次确认。

15B.5 异常处理

异常场景触发条件前端表现系统处理恢复方案
敏感词拦截文章正文命中拦截级敏感词弹窗不关闭,正文下方红色提示"内容包含违禁词汇:XXX,请修改后提交"返回命中的拦截级敏感词列表用户修改正文内容后重新提交
置顶超限同分类下已置顶5篇文章,再次置顶提示"该分类下置顶文章已达上限(5篇),请先取消其他置顶"拒绝置顶操作用户先取消已有置顶文章后再置顶
删除已上架文章文章状态=已上架时点击删除删除按钮不展示或置灰前端按状态控制按钮可见性用户先下架文章后再删除
批量删除包含已上架批量选中包含已上架状态文章提示"选中项包含已上架文章,请先下架后再删除"前端校验拦截用户取消已上架文章勾选或先下架
分类被停用编辑文章时原关联分类已被停用分类字段展示原值并标注"该分类已停用",提示"请重新选择分类"前端加载时校验分类状态用户重新选择已启用的分类
富文本图片上传失败图片上传超时或格式不支持编辑器内图片位置显示"上传失败"记录上传失败日志用户重新上传或更换图片

15B.6 阅读统计

已上架文章支持阅读统计,统计维度包括阅读人数(去重用户数)、阅读次数(总点击数)、阅读率(阅读人数/目标接收人数)。阅读记录写入 t_article_read 表,支持按接收对象类型(供应商/分销商/C端用户)分组查看。

15B.7 文章推送逻辑

文章上架时可选择推送至供应商/分销商后台收件箱,通过站内信通知。推送范围支持全部供应商、全部分销商、全部供应商和分销商三种选项。推送后系统自动生成站内信,消息类型为"公告",跳转链接指向文章详情页。

15B.8 与公告管理模块的关系

公告与文章的关系说明:公告管理与文章/资讯管理是两个独立的内容管理体系。公告管理使用独立的 t_announcement 数据表,专注于平台向供应商/分销商发布的系统通知、运营公告、活动通知和政策变更,支持接收范围定向、置顶和阅读统计。文章/资讯管理使用 t_article 数据表,用于新闻、资讯、帮助指南等内容的创建、分类、推送和阅读统计。公告 Tab 与文章 Tab 在「内容发布」聚合入口中并列展示,但底层数据表、业务字段和状态流各自独立,运营人员通过不同 Tab 进入对应管理界面。

15C. 须知管理

15C.1 核心业务逻辑

须知管理是平台和供应商各自创建、管理商品相关须知内容的功能模块。须知绑定至商品SPU级,在C端商品详情页展示,用于向消费者传达购买注意事项、出行要求、退改政策、安全提示等关键信息。须知分为六种类型:购买须知、出行须知、退改须知、安全须知、使用须知、其他。

业务边界:
1. 归属隔离:平台创建的须知(owner_type=platform)所有供应商SPU均可绑定;供应商创建的须知(owner_type=supplier)仅该供应商自己的SPU可绑定
2. 操作权限:平台运营人员可管理平台须知;供应商仅可管理本供应商的须知;供应商无权操作平台须知
3. 绑定关系:一条须知可绑定多个SPU;一个SPU可绑定多条不同类型的须知;同一类型同一归属方的须知不可重复绑定同一SPU
4. 展示逻辑:C端商品详情页展示该SPU绑定的全部已发布须知,平台须知和供应商须知合并展示,按类型分组
5. 入口:平台后台通过内容发布-须知管理Tab进入,URL: /platform/content/publish?tab=notice;供应商后台通过"内容管理 > 须知管理"菜单进入,URL: /supplier/content/notice

15C.1.1 功能清单

功能项端说明操作角色优先级
须知列表平台后台/供应商后台查看须知列表,支持按类型、状态、归属方筛选平台运营/供应商P1
新增须知平台后台/供应商后台创建须知,选择类型、填写标题和正文内容平台运营/供应商P1
编辑须知平台后台/供应商后台修改须知内容(草稿/已下架状态可编辑)平台运营/供应商P1
发布须知平台后台/供应商后台将草稿须知发布,发布前需通过敏感词校验平台运营/供应商P1
下架须知平台后台/供应商后台将已发布须知下架,下架后C端不再展示平台运营/供应商P1
删除须知平台后台/供应商后台删除须知(仅草稿/已下架状态可删除)平台运营/供应商P1
SPU绑定管理平台后台/供应商后台管理须知与SPU的绑定关系,支持批量绑定/解绑平台运营/供应商P1

15C.1.2 字段说明

字段类型必填校验规则说明
须知标题文本是2-100字符展示在须知列表和C端商品详情页须知区域标题位
须知正文富文本是不少于10字符,不超过10000字符支持加粗、列表、链接、图片上传(最多5张)
须知类型下拉单选是枚举:购买须知/出行须知/退改须知/安全须知/使用须知/其他用于分类展示和筛选,C端按类型分组展示
归属类型系统自动是platform/supplier根据操作人身份自动判定,平台运营=platform,供应商=supplier

15C.2 列表页原型

须知管理 - 列表页(须知管理Tab)
/platform/content/publish?tab=notice
基础管理 / 内容管理 / 内容发布 / 须知管理
公告管理
文章管理
须知管理
帮助指南
须知管理
须知标题类型归属方状态绑定SPU数发布时间操作
景区门票购买注意事项购买须知平台已发布362026-08-10 09:00编辑下架绑定管理
跟团游出行必备物品出行须知平台已发布122026-08-08 14:30编辑下架绑定管理
酒店退改政策说明退改须知供应商A草稿0—编辑发布删除
高风险项目安全提示安全须知平台已下架02026-08-05 10:00编辑上架删除
共 23 条 1 每页 条

15C.2.1 列表页操作说明

操作前置条件交互方式后端行为异常处理
新增须知有须知创建权限点击「+ 新增须知」→ 弹出新建弹窗——
编辑状态=草稿或已下架点击行内「编辑」→ 弹出编辑弹窗加载须知详情数据数据加载失败时提示重试
发布状态=草稿点击行内「发布」→ 二次确认弹窗敏感词校验 → 更新status=已发布,写入publish_time敏感词命中时拦截并提示具体敏感词
下架状态=已发布点击行内「下架」→ 二次确认弹窗更新status=已下架,写入offline_time;C端即时停止展示—
上架状态=已下架点击行内「上架」→ 二次确认弹窗敏感词校验 → 更新status=已发布敏感词命中时拦截
删除状态=草稿或已下架点击行内「删除」→ 二次确认弹窗逻辑删除须知记录;解除全部SPU绑定—
绑定管理状态=已发布点击行内「绑定管理」→ 弹出SPU绑定管理弹窗加载须知已绑定SPU列表—

15C.3 新增/编辑须知弹窗

新增须知 - 弹窗
新增须知×
BI•🔗🖼
请输入须知正文内容...

15C.4 状态机

stateDiagram-v2
  [*] --> 草稿 : 新增保存草稿
  [*] --> 已发布 : 新增直接发布
  草稿 --> 已发布 : 发布(敏感词校验通过)
  已发布 --> 已下架 : 下架
  已下架 --> 已发布 : 重新上架(敏感词校验通过)
  草稿 --> [*] : 删除
  已下架 --> [*] : 删除
图15C-1:须知状态机

15C.4.1 状态流转说明

当前状态操作目标状态前置条件后端处理
—(不存在)新增保存草稿草稿必填项校验通过写入 t_notice,status=草稿
—(不存在)新增直接发布已发布必填项校验 + 敏感词校验通过写入 t_notice,status=已发布,写入 publish_time
草稿发布已发布敏感词校验通过更新 status=已发布,写入 publish_time
已发布下架已下架—更新 status=已下架,写入 offline_time;C端停止展示
已下架重新上架已发布敏感词校验通过更新 status=已发布
草稿删除—(已删除)—逻辑删除记录;解除全部SPU绑定
已下架删除—(已删除)—逻辑删除记录;解除全部SPU绑定
已发布状态不可编辑:须知处于已发布状态时,不可直接编辑内容。需先下架再编辑,或创建新须知替换。此规则确保C端展示内容的稳定性。

15C.5 SPU绑定管理

须知发布后,可通过"绑定管理"功能将须知绑定到商品SPU。绑定关系存储在 t_notice_spu 表。一条须知可绑定多个SPU,一个SPU可绑定多条不同类型的须知。

15C.5.1 绑定管理弹窗原型

SPU绑定管理 - 弹窗
SPU绑定管理 - 景区门票购买注意事项×
SPU IDSPU名称供应商绑定状态绑定时间操作
SPU100234故宫门票成人票供应商A已绑定2026-08-10 10:00解绑
SPU100235故宫门票学生票供应商A已绑定2026-08-10 10:00解绑
SPU100312颐和园联票供应商B未绑定—绑定
SPU100313天坛公园门票供应商B未绑定—绑定
共 36 条已绑定 1

15C.5.2 绑定规则

规则说明
绑定权限平台须知:平台运营可绑定任意SPU;供应商须知:仅供应商可绑定自己的SPU
绑定前置条件须知状态必须为"已发布";SPU状态必须为"已上架"
重复绑定校验同一须知不可重复绑定同一SPU(t_notice_spu 联合唯一索引 notice_id+spu_id)
类型冲突校验同一归属方(平台或同一供应商)的同一类型须知,不可重复绑定同一SPU
解绑影响解绑后C端商品详情页即时停止展示该须知
须知下架联动须知下架时,C端停止展示但绑定关系保留;须知删除时,自动解除全部绑定
批量绑定支持勾选多个未绑定SPU,点击"批量绑定"一键绑定
批量解绑支持勾选多个已绑定SPU,点击"批量解绑"一键解绑

15C.6 权限控制

权限标识权限名称平台运营供应商说明
content:notice:view须知-查看✓✓须知管理Tab可见权限
content:notice:create须知-新增✓✓创建须知,归属方自动识别
content:notice:edit须知-编辑✓(平台须知)✓(本供应商须知)编辑须知内容
content:notice:publish须知-发布/下架✓(平台须知)✓(本供应商须知)发布、下架、上架操作
content:notice:delete须知-删除✓(平台须知)✓(本供应商须知)删除须知
content:notice:bind须知-SPU绑定✓(全部SPU)✓(本供应商SPU)管理须知与SPU的绑定关系
数据隔离:供应商后台查询须知列表时,后端自动附加 owner_type=platform OR (owner_type=supplier AND owner_id=当前供应商ID) 过滤条件,确保供应商只能看到平台须知和自己的须知,不可查看其他供应商的须知。

15C.7 C端展示逻辑

C端展示规则:
1. 商品详情页"须知"区域展示该SPU绑定的全部已发布须知,按类型分组展示
2. 展示顺序:平台须知在前,供应商须知在后;同归属方内按须知类型固定顺序排列
3. 须知标题可点击展开/折叠,默认折叠,仅展示标题
4. 若SPU无任何已发布须知绑定,不展示"须知"区域
5. 平台须知和供应商须知合并展示,不区分标签,仅按类型分组

15D. 帮助管理

15D.1 核心业务逻辑

帮助管理是平台运营人员创建、发布帮助内容的功能模块,面向供应商、分销商提供新手指南、常见问题、操作手册、规则说明等帮助文档。帮助内容发布后在供应商后台、分销商后台的"帮助中心"页面展示,支持按类型分类浏览和关键词搜索。

业务边界:
1. 操作权限:帮助内容的创建、编辑、发布、下架、删除、置顶仅平台运营后台可操作;供应商后台和分销商后台通过"内容管理 > 帮助"菜单查看平台发布的帮助内容(只读),不可创建或编辑
2. 展示范围:帮助内容可设置展示范围(全部/供应商/分销商),按范围分发至对应端
3. 阅读统计:已发布帮助内容支持阅读统计,记录阅读人数和阅读次数
4. 置顶:帮助内容支持置顶,置顶内容在各端帮助中心列表顶部展示
5. 入口:通过内容发布-帮助指南Tab进入,URL: /platform/content/publish?tab=help

15D.1.1 功能清单

功能项端说明操作角色优先级
帮助列表平台后台查看帮助内容列表,支持按类型、状态、展示范围筛选平台运营P1
新增帮助平台后台创建帮助内容,选择类型、展示范围、填写标题和正文平台运营P1
编辑帮助平台后台修改帮助内容(草稿/已下架状态可编辑)平台运营P1
发布帮助平台后台将草稿帮助发布,发布前需通过敏感词校验平台运营P1
下架帮助平台后台将已发布帮助下架平台运营P1
置顶/取消置顶平台后台设置帮助内容置顶,支持排序平台运营P2
删除帮助平台后台删除帮助内容(仅草稿/已下架状态可删除)平台运营P1
阅读统计平台后台查看帮助内容的阅读人数、阅读次数、阅读率平台运营P2
帮助列表(只读)供应商后台查看平台发布的帮助内容列表,支持按类型筛选和关键词搜索,仅展示已发布状态供应商全员P1
帮助列表(只读)分销商后台查看平台发布的帮助内容列表,支持按类型筛选和关键词搜索,仅展示已发布状态分销商全员P1

15D.1.2 字段说明

字段类型必填校验规则说明
帮助标题文本是2-100字符展示在帮助列表和详情页标题位
帮助正文富文本是不少于10字符,不超过20000字符支持加粗、列表、链接、图片上传(最多20张)
帮助类型下拉单选是枚举:新手指南/常见问题/操作手册/规则说明用于分类展示和筛选
展示范围下拉单选是枚举:全部/供应商/分销商控制帮助内容分发至哪些端展示
置顶开关否默认关闭开启后该内容在帮助中心列表置顶展示
置顶排序数字条件必填0-9999,数值越小越靠前仅置顶=开启时必填

15D.2 列表页原型

帮助管理 - 列表页(帮助指南Tab)
/platform/content/publish?tab=help
基础管理 / 内容管理 / 内容发布 / 帮助指南
公告管理
文章管理
须知管理
帮助指南
帮助管理
帮助标题类型展示范围状态置顶发布时间阅读率操作
供应商入驻操作指南新手指南供应商已发布是2026-08-10 09:0072%编辑下架阅读统计
订单退款流程说明操作手册全部已发布否2026-08-08 14:3058%编辑下架阅读统计
佣金结算规则FAQ常见问题分销商草稿否——编辑发布删除
平台运营规范说明规则说明全部已下架否2026-08-05 10:0031%编辑上架删除
共 18 条 1 每页 条

15D.2.1 列表页操作说明

操作前置条件交互方式后端行为异常处理
新增帮助有帮助创建权限点击「+ 新增帮助」→ 弹出新建弹窗——
编辑状态=草稿或已下架点击行内「编辑」→ 弹出编辑弹窗加载帮助详情数据数据加载失败时提示重试
发布状态=草稿点击行内「发布」→ 二次确认弹窗敏感词校验 → 更新status=已发布,写入publish_time;分发至各端敏感词命中时拦截并提示具体敏感词
下架状态=已发布点击行内「下架」→ 二次确认弹窗更新status=已下架,写入offline_time;各端即时停止展示—
上架状态=已下架点击行内「上架」→ 二次确认弹窗敏感词校验 → 更新status=已发布敏感词命中时拦截
置顶/取消置顶状态=已发布点击行内「置顶」/「取消置顶」更新is_pinned字段;置顶时需填写排序值—
删除状态=草稿或已下架点击行内「删除」→ 二次确认弹窗逻辑删除帮助记录—
阅读统计状态=已发布点击行内「阅读统计」→ 跳转阅读统计详情页查询 t_help_read 聚合数据 → 渲染统计页面—

15D.3 新增/编辑帮助弹窗

新增帮助 - 弹窗
新增帮助×
排序值:
BI•🔗🖼
请输入帮助正文内容...

15D.4 状态机

stateDiagram-v2
  [*] --> 草稿 : 新增保存草稿
  [*] --> 已发布 : 新增直接发布
  草稿 --> 已发布 : 发布(敏感词校验通过)
  已发布 --> 已下架 : 下架
  已下架 --> 已发布 : 重新上架(敏感词校验通过)
  草稿 --> [*] : 删除
  已下架 --> [*] : 删除
图15D-1:帮助内容状态机

15D.4.1 状态流转说明

当前状态操作目标状态前置条件后端处理
—(不存在)新增保存草稿草稿必填项校验通过写入 t_help,status=草稿
—(不存在)新增直接发布已发布必填项校验 + 敏感词校验通过写入 t_help,status=已发布,写入 publish_time;分发至各端
草稿发布已发布敏感词校验通过更新 status=已发布,写入 publish_time;分发至各端
已发布下架已下架—更新 status=已下架,写入 offline_time;各端停止展示
已下架重新上架已发布敏感词校验通过更新 status=已发布
草稿删除—(已删除)—逻辑删除记录
已下架删除—(已删除)—逻辑删除记录
已发布状态不可编辑:帮助内容处于已发布状态时,不可直接编辑内容。需先下架再编辑,或创建新内容替换。此规则确保各端展示内容的稳定性。

15D.5 阅读统计

已发布帮助内容支持阅读统计,统计维度包括阅读人数(去重用户数)、阅读次数(总点击数)、阅读率(阅读人数/目标接收人数)。阅读记录写入 t_help_read 表,支持按接收对象类型(供应商/分销商/C端用户)分组查看。

15D.5.1 阅读统计详情页原型

帮助阅读统计 - 详情页
/platform/content/publish?tab=help&action=read-stats&id=123
基础管理 / 内容管理 / 内容发布 / 帮助 / 阅读统计
供应商入驻操作指南 - 阅读统计
128
阅读人数
356
阅读次数
72%
阅读率
用户类型阅读人数阅读次数阅读率
供应商8624572%
分销商4211168%

15D.6 权限控制

权限标识权限名称平台运营供应商分销商说明
content:help:view帮助-查看✓✓(仅展示范围含供应商)✓(仅展示范围含分销商)帮助指南Tab可见权限
content:help:create帮助-新增✓——创建帮助内容
content:help:edit帮助-编辑✓——编辑帮助内容
content:help:publish帮助-发布/下架✓——发布、下架、上架操作
content:help:delete帮助-删除✓——删除帮助内容
content:help:pin帮助-置顶✓——设置/取消置顶

15D.7 各端展示逻辑

各端帮助中心展示规则:
1. 供应商后台:通过"内容管理 > 帮助"菜单进入,展示target_scope含"全部"或"供应商"的已发布帮助内容,按类型分组展示,支持关键词搜索
2. 分销商后台:通过"内容管理 > 帮助"菜单进入,展示target_scope含"全部"或"分销商"的已发布帮助内容,按类型分组展示,支持关键词搜索
3. 排序规则:置顶内容按pin_sort升序排列在前,非置顶内容按publish_time倒序排列
4. 搜索:各端帮助中心支持按标题关键词搜索
5. 阅读记录:用户点击查看帮助详情时,自动写入 t_help_read 阅读记录(同一用户同一帮助仅记录一次去重阅读人数)
6. 只读限制:供应商/分销商后台帮助列表不展示"新增帮助"按钮、不展示状态列(仅展示已发布内容)、不展示编辑/下架/删除等操作列

15D.8 供应商/分销商后台 - 帮助查看页原型

供应商后台和分销商后台的帮助查看页为只读页面,仅展示平台已发布的帮助内容,不支持创建、编辑、删除等操作。供应商后台展示target_scope含"全部"或"供应商"的帮助;分销商后台展示target_scope含"全部"或"分销商"的帮助。

15D.8.1 供应商后台帮助查看页

帮助中心 - 供应商后台(只读)
/supplier/content/help
内容管理 / 帮助
帮助中心
帮助标题类型发布时间
供应商入驻操作指南新手指南2026-08-10 09:00
订单退款流程说明操作手册2026-08-08 14:30
平台运营规范说明规则说明2026-08-05 10:00
共 12 条 1 每页 条
只读说明:供应商后台帮助列表不展示"新增帮助"按钮、不展示状态列和展示范围列(仅展示已发布内容)、不展示编辑/下架/删除/置顶等操作列。点击帮助标题可弹出详情弹窗查看全文内容。

15D.8.2 分销商后台帮助查看页

帮助中心 - 分销商后台(只读)
/distributor/content/help
内容管理 / 帮助
帮助中心
帮助标题类型发布时间
分销商推广操作指南新手指南2026-08-09 09:00
订单退款流程说明操作手册2026-08-08 14:30
佣金结算规则FAQ常见问题2026-08-06 10:00
共 8 条 1 每页 条

15D.8.3 帮助详情弹窗(供应商/分销商共用)

帮助详情 - 弹窗(只读)
供应商入驻操作指南×
类型:新手指南 | 发布时间:2026-08-10 09:00

一、入驻流程

1. 登录供应商后台,进入"商家管理 > 商家资料"页面...

2. 填写主体资料、上传营业执照...

3. 提交审核,等待平台确认...

(详情内容省略)

详情弹窗说明:供应商/分销商后台点击帮助标题弹出详情弹窗,展示帮助标题、类型、发布时间和正文内容。弹窗仅提供"关闭"按钮,无编辑、删除等操作。打开详情弹窗时自动写入 t_help_read 阅读记录。

16. 站内信

16.1 核心业务逻辑

站内信是平台向供应商、分销商推送系统消息、订单通知、售后通知、佣金通知、协议通知等内容的站内消息通道。站内信来源两种:一是平台运营人员手动发送(指定接收对象、消息类型、跳转链接),二是通知规则自动触发(业务事件发生时按规则配置自动生成站内信)。供应商和分销商后台通过收件箱查看站内信。

业务边界:站内信发送端仅平台运营后台可操作;供应商/分销商后台仅提供收件箱查看功能。通知规则自动触发的站内信,其接收对象由规则配置决定,手动发送的站内信由发送人指定。站内信与公告是两套独立体系——站内信面向个体或指定对象推送,公告面向全体或范围群体广播。

16.1.1 功能清单

功能项端说明操作角色优先级
站内信列表平台后台查看全部站内信记录,含手动发送和自动触发平台运营P1
发送站内信平台后台手动发送站内信,选择接收范围、消息类型、跳转链接平台运营P1
站内信详情平台后台查看站内信内容、接收对象、已读情况平台运营P1
删除站内信平台后台删除站内信记录(仅手动发送的)平台运营P1
收件箱供应商/分销商后台查看站内信列表、已读/未读、消息详情、跳转业务页全员P1
标记已读供应商/分销商后台点击消息自动标记已读全员P1
批量已读供应商/分销商后台勾选多条消息批量标记已读全员P1
未读计数供应商/分销商后台顶部导航栏展示未读消息数全员P1

16.1.2 字段说明

字段类型必填校验规则说明
消息标题文本是2-100字符展示在收件箱列表和详情页标题位
消息内容富文本是不少于10字符,不超过5000字符支持加粗、列表、链接;不支持图片上传
消息类型下拉单选是枚举:系统/订单/售后/佣金/协议/公告用于收件箱分类筛选和标签展示
接收范围下拉单选是枚举:全部/指定角色/指定商家选择"指定商家"时展开商家选择器
指定商家多选搜索条件必填接收范围=指定商家时必填从供应商/分销商列表中搜索选择
跳转链接文本否合法URL格式用户点击"查看详情"时跳转的业务页面地址
发送方式下拉单选是立即发送/定时发送定时发送需选择发送时间
发送时间日期时间条件必填不早于当前时间+5分钟仅发送方式=定时发送时必填

16.2 交互逻辑表

触发入口端前置条件操作步骤系统响应
平台列表页「发送站内信」按钮平台后台用户拥有 message:insite:send 权限点击按钮 → 弹出发送弹窗 → 填写字段 → 点击「立即发送」或「定时发送」立即发送:校验必填项 + 敏感词校验 → 写入 t_insite_message,send_mode=立即发送,send_time=当前时间 → 分发至接收对象收件箱;定时发送:创建定时任务
平台列表页「详情」操作平台后台—点击行内「详情」→ 跳转详情页查询站内信内容 + 已读统计 → 渲染详情页
平台列表页「删除」操作平台后台消息来源为手动发送(source_rule_id 为空)点击行内「删除」→ 二次确认 → 点击「确认删除」物理删除站内信及已读记录 → 刷新列表
通知规则自动触发系统通知规则启用且渠道包含站内信业务事件发生 → 匹配规则 → 渲染模板 → 写入站内信写入 t_insite_message,source_rule_id=规则ID → 分发至接收对象收件箱
收件箱点击消息供应商/分销商后台—点击收件箱列表中消息 → 展示详情写入 t_insite_message_read 记录 → 消息标记为已读 → 更新未读计数
收件箱「批量已读」操作供应商/分销商后台列表已勾选至少1条未读消息勾选多条 → 点击「批量已读」批量写入已读记录 → 刷新列表
收件箱「查看详情」操作供应商/分销商后台消息配置了 jump_url点击消息详情中「查看详情」按钮新标签页打开 jump_url 对应的业务页面

16.3 页面原型

16.3.1 平台后台 - 站内信列表页

站内信管理 - 列表页
/platform/message/insite
基础管理 / 消息管理 / 站内信
站内信管理
消息标题类型接收范围来源已读率发送时间操作
订单支付成功通知订单订单相关方自动触发92%2026-08-10 15:30详情
暑期运营补贴政策通知系统全部供应商手动发送76%2026-08-09 10:00详情删除
佣金结算完成通知佣金指定分销商自动触发88%2026-08-08 18:00详情
协议版本更新通知协议全部自动触发65%2026-08-07 09:00详情
共 326 条 1 每页 条

16.3.2 发送站内信弹窗

发送站内信 - 弹窗
发送站内信×
B列表链接
请输入消息内容...

16.3.3 供应商/分销商后台 - 收件箱

收件箱 - 供应商/分销商后台
/supplier/message/inbox
消息中心 / 收件箱
收件箱 未读 5 条
全部
系统
订单
售后
佣金
协议
类型标题发送时间状态操作
订单您的订单 ORD20260810001 已支付成功2026-08-10 15:30未读查看
系统暑期运营补贴政策通知2026-08-09 10:00未读查看
佣金8月佣金结算完成,佣金金额¥3,256.002026-08-08 18:00已读查看
协议分销协议已更新至v1.5版本,请及时确认2026-08-07 09:00已读查看
共 48 条 1 每页 条

16.4 顶部导航消息中心入口(铃铛Icon)

顶部导航栏右侧的铃铛图标是统一消息中心入口,聚合展示站内信与公告的未读消息,不区分消息体系。平台运营端、供应商端、分销商端三端共用同一Header组件,各端仅展示当前用户可见的消息(按 target_scope 过滤)。铃铛Icon承接站内信和公告两类消息的未读提示与快捷预览,与收件箱页面(16.3.3)形成"角标提示→面板预览→收件箱详情"的三级触达链路。

业务边界:铃铛Icon仅聚合展示未读消息的角标提示和快捷预览,不提供消息发送、编辑、删除等管理操作。消息的创建、分发、已读标记等核心逻辑由站内信管理(16.1-16.3)和公告管理(第12章)承接,铃铛Icon仅消费这些模块产出的数据。协议再确认弹窗(CM-B08)独立于铃铛Icon,不通过铃铛展示。

16.4.0 平台端需求分析

虽然第16.1.1功能清单中"收件箱"、"标记已读"、"批量已读"、"未读计数"四个功能项的端列标注为"供应商/分销商后台",但经业务场景分析,平台运营人员同样需要铃铛Icon通知入口。平台运营人员作为系统管理者,承担入驻审核、售后仲裁、提现审核等职责,需要及时获知待处理事项的通知,而非逐个刷新各管理列表页发现新任务。

结论:平台方需要铃铛Icon。16.1.1功能清单中收件箱的端列未包含平台后台,属于PRD原文的遗漏,铃铛Icon作为新增功能正好补齐该遗漏。已在第10.2节补充 /platform/message/inbox 路由行,使平台端"查看全部消息"跳转目标完整可用。

平台运营人员的实际业务场景如下表所示,若没有铃铛Icon,平台运营人员只能靠逐个刷新各个管理列表页来发现待处理事项,实际运营效率极低:

业务场景触发事件平台运营人员需要做什么不看铃铛会怎样
供应商提交入驻申请merchant_approved / merchant_rejected审核入驻资质、审核通过或驳回需要不停刷新入驻审核列表页才知道有新申请
售后申请提交且供应商未处理或需仲裁after_sale_created介入仲裁、判定退款责任需要不停刷新售后仲裁列表页才知道有新仲裁
提现申请提交withdraw_result审核提现、打款需要不停刷新提现管理列表页才知道有新申请
协议版本更新agreement_updated确认协议已发布生效需要刷新协议管理页
系统异常告警(自定义事件)及时介入处理可能错过关键告警

PRD原文中存在以下支撑依据,表明平台端需要消息通知的设计预留:

支撑依据PRD位置原文内容说明
通知规则接收对象枚举包含"指定角色"第18章 18.1.3 字段说明接收对象枚举:全部/供应商/分销商/订单相关方/指定角色"指定角色"可以指定平台运营角色,说明通知规则设计上预留了向平台运营人员发送通知的通道
站内信面向对象描述第16章 16.1 核心业务逻辑"站内信是平台向供应商、分销商推送系统消息"平台运营人员作为系统管理者,自身也需要接收系统级通知(如系统异常告警、入驻审核提醒等)
公告 target_scope="全部"第11章 数据模型 t_announcement.target_scope取值:全部/供应商/分销商"全部"包含平台运营人员,平台运营人员也需要看到自己发布的公告是否已读

16.4.1 功能清单

功能项端说明操作角色优先级
未读角标展示三端共用铃铛右上角显示未读总数角标(站内信未读数+公告未读数),超过99显示99+全员P1
下拉面板预览三端共用点击铃铛弹出Popover面板,展示最近5条未读消息(站内信+公告合并),按时间倒序全员P1
消息点击跳转三端共用点击面板内单条消息:标记已读→关闭面板→跳转对应业务页面全员P1
查看全部入口三端共用面板底部「查看全部消息」链接,跳转收件箱页面全员P1
实时刷新三端共用WebSocket推送新消息时角标即时+1;页面加载时拉取未读总数;面板展开时刷新消息列表全员P1

16.4.2 数据来源与未读计算

铃铛Icon的未读总数由站内信未读数和公告未读数合并计算,数据来源严格遵循第11章数据模型定义的双表模式(消息主体表+已读记录表分离)。

数据来源主体表已读记录表未读判断逻辑
站内信未读数t_insite_messaget_insite_message_read站内信表中 send_mode='立即发送' AND send_time <= NOW() AND target_scope 匹配当前用户,且已读记录表中不存在该用户对该消息的已读记录
公告未读数t_announcementt_announcement_read公告表中 status='已发布' AND target_scope 匹配当前用户,且已读记录表中不存在该用户对该公告的已读记录
合并未读总数站内信未读数 + 公告未读数,合并去重统计,实时刷新。超过99显示"99+"。
SQL示意:站内信未读数 = SELECT COUNT(1) FROM t_insite_message m WHERE m.send_mode='立即发送' AND m.send_time <= NOW() AND [target_scope匹配条件] AND NOT EXISTS (SELECT 1 FROM t_insite_message_read r WHERE r.message_id = m.id AND r.user_id = #{当前用户ID})。公告未读数 = SELECT COUNT(1) FROM t_announcement a WHERE a.status='已发布' AND [target_scope匹配条件] AND NOT EXISTS (SELECT 1 FROM t_announcement_read r WHERE r.announcement_id = a.id AND r.user_id = #{当前用户ID})。

16.4.3 target_scope 匹配规则

铃铛Icon展示的消息范围由站内信和公告各自的 target_scope 字段决定,各端根据当前登录用户的 tenant_type 和 tenant_id 自动匹配。

消息类型target_scope 取值匹配逻辑
站内信全部所有登录用户可见
站内信指定角色解析 target_detail JSON 中的角色ID列表,匹配当前用户角色ID
站内信指定商家解析 target_detail JSON 中的商家ID列表,匹配当前用户所属租户ID
公告全部三端所有登录用户可见
公告供应商仅供应商端用户可见(user_type=供应商)
公告分销商仅分销商端用户可见(user_type=分销商)

16.4.4 三端消息范围

端可见站内信可见公告典型消息示例
平台运营端target_scope=全部 + 指定角色(匹配平台角色)target_scope=全部供应商入驻申请、售后仲裁、系统异常、证照过期预警
供应商端target_scope=全部 + 指定商家(匹配当前供应商ID)target_scope=全部 + 供应商新订单待收单、售后申请待处理、佣金结算到账、协议再确认
分销商端target_scope=全部 + 指定商家(匹配当前分销商ID)target_scope=全部 + 分销商采购订单状态变更、退款处理结果、佣金到账、授信额度变更

16.4.5 视觉状态设计

状态触发条件视觉表现
静默态未读总数 = 0灰色空心铃铛,无角标
未读提示态未读总数 ≥ 1铃铛右上角红色数字角标(背景色 #EF4444,白色数字)。1-99显示具体数字,超过99显示"99+"。1位数圆形角标直径18px,2位数椭圆胶囊,"99+"为宽胶囊。定位偏移 top:-2px right:-2px
新消息到达动效WebSocket推送新消息时角标数字+1,铃铛轻微摇晃动画0.5秒(仅播放一次,不循环)
面板展开态用户点击铃铛下拉Popover面板展开,铃铛Icon变为蓝色填充态

16.4.6 交互逻辑表

触发入口端前置条件操作步骤系统响应
点击铃铛Icon三端共用已登录点击Header右侧铃铛图标展开下拉Popover面板(宽度400px,最大高度420px,定位bottom-right);调用 GET /api/v1/message/unread-list?limit=5 拉取最近5条未读消息(站内信+公告合并,按时间倒序);铃铛Icon变为蓝色填充态
点击面板内站内信消息三端共用消息来源为站内信点击面板内某条站内信消息行关闭面板 → 写入 t_insite_message_read(message_id+user_id+read_time=NOW())→ 角标数-1 → 若 jump_url 有值则跳转 jump_url 对应业务页面,若 jump_url 为空则跳转收件箱详情页展示消息全文
点击面板内公告消息三端共用消息来源为公告点击面板内某条公告消息行关闭面板 → 写入 t_announcement_read(announcement_id+user_id+user_type+read_time=NOW())→ 角标数-1 → 跳转公告详情页;若公告已下架则跳转收件箱页面
点击「查看全部消息」三端共用面板已展开点击面板底部「查看全部消息」链接关闭面板 → 跳转收件箱页面(平台端:/platform/message/inbox;供应商端:/supplier/message/inbox;分销商端:/distributor/message/inbox)
点击面板外区域三端共用面板已展开点击Popover面板外的任意区域面板自动收起,铃铛恢复为未读提示态或静默态(取决于是否还有未读)
按ESC键三端共用面板已展开按下ESC键面板自动收起,同上
WebSocket推送新消息三端共用WebSocket连接正常通知规则执行生成站内信后,通知服务通过WS推送事件前端收到 {type:"new_message", unread_count: N} 事件 → 角标更新为N → 播放铃铛摇晃动画0.5秒(仅一次)
页面加载/刷新三端共用用户登录后首次进入或刷新页面页面初始化时自动拉取调用 GET /api/v1/message/unread-count → 后端合并计算站内信+公告未读总数返回 → 前端渲染角标(0时隐藏,1-99显示数字,>99显示"99+")

16.4.7 页面原型 - 铃铛Icon下拉面板

铃铛Icon - 下拉面板(未读提示态)
全局Header组件(三端共用)
🔔 5
云
供应商管理员 ▾
未读消息(5) 按时间倒序
订单
您的订单 ORD20260810001 已支付成功
5分钟前
公告
暑期运营补贴政策调整通知
2小时前
佣金
8月佣金结算完成,佣金金额¥3,256.00
昨天
协议
分销协议已更新至v1.5版本,请及时确认
1天前
售后
售后申请已提交,等待供应商处理
2天前
查看全部消息
消息类型色标签:面板内每条消息左侧显示类型色标签,复用站内信 message_type 枚举(第11章 t_insite_message.message_type 字段)。标签样式:系统(灰 #94A3B8)、订单(蓝 #3B82F6)、售后(橙 #F59E0B)、佣金(绿 #22C55E)、协议(紫 #8B5CF6)、公告(青 #06B6D4)。公告消息的类型标签固定为"公告",站内信消息按其 message_type 字段值显示对应标签。
时间文案规则:消息时间展示为相对时间。< 1分钟显示"刚刚";< 60分钟显示"X分钟前";< 24小时显示"X小时前";< 48小时显示"昨天";其余显示"X天前"。站内信取 send_time 字段,公告取 publish_time 字段。
空状态:无未读消息时(未读总数=0),面板内展示空状态文案"暂无未读消息",同时铃铛角标隐藏(静默态)。

16.4.8 实时刷新机制

机制触发时机实现方式延迟
WebSocket推送通知规则执行生成站内信后(第18章业务事件自动触发)通知服务写入 t_insite_message 后,通过WS推送 {type:"new_message", unread_count:N} 事件至在线用户前端,前端收到后角标更新为N并播放动效实时
页面加载拉取用户登录后首次进入页面或刷新页面调用 GET /api/v1/message/unread-count,后端合并计算站内信+公告未读总数返回,前端渲染角标页面加载完成即渲染
面板展开刷新用户点击铃铛展开面板时调用 GET /api/v1/message/unread-list?limit=5,后端合并查询站内信+公告最新5条未读返回,前端渲染消息列表点击即刷新
定时轮询(降级)WebSocket连接断开时每60秒轮询一次 GET /api/v1/message/unread-count,WS恢复后停止轮询最多60秒延迟
WebSocket连接生命周期:用户登录后建立WS连接,登出或关闭浏览器时断开。断线自动重连策略:间隔3秒/6秒/12秒/30秒,最多重试4次。4次失败后降级为60秒定时轮询模式。WS恢复连接后停止轮询,切换回实时推送模式。

16.4.9 关联规则

规则说明
CM-B06(180天已读归档)仅影响收件箱列表展示,不影响铃铛未读计数。已读站内信超过180天后在收件箱列表中归档不展示,但已读记录仍保留在 t_insite_message_read 表中,不影响铃铛的未读数计算(已读消息本就不计入未读)
公告下架不计未读公告 status 变为"已下架"后,不计入铃铛未读数。后端查询时 WHERE 条件 status='已发布' 自动过滤已下架公告。已在面板中展示的公告行在下次刷新面板时移除,角标数同步-1
站内信定时发送不计未读send_mode='定时发送' 且 send_time > NOW() 的站内信不计入未读数。后端查询时 WHERE 条件 send_mode='立即发送' AND send_time <= NOW() 自动过滤未到时间的定时消息。到达发送时间后自动计入
角标上限99+未读总数超过99时角标显示"99+",面板仍仅展示最近5条未读消息。用户需通过收件箱查看完整未读列表
面板展开时不实时刷新面板展开期间收到新消息时,面板列表不实时刷新(避免列表跳动),仅角标数+1并播放动效。面板关闭后再次展开时可见新消息

16.4.10 状态扭转规则

扭转路径触发动作数据变化角标表现
未读 → 已读(站内信)用户点击面板内站内信消息行,或在收件箱页面点击消息写入 t_insite_message_read(message_id, user_id, user_type, read_time=NOW())角标数-1;若降至0则角标消失,铃铛恢复静默态
未读 → 已读(公告)用户点击面板内公告消息行,或在收件箱/公告列表查看公告详情写入 t_announcement_read(announcement_id, user_id, user_type, read_time=NOW())同上
未读 → 不展示(公告下架)平台运营下架公告t_announcement.status 变更为"已下架",写入 offline_time下次查询时该公告不计入未读;角标数同步-1
未读 → 已发送(定时站内信到达)定时发送站内信到达 send_time定时任务触发,更新 send_time,分发至接收对象该消息开始计入未读数;角标数+1
已读不可回退:消息一旦标记已读(写入 _read 表),不可回退为未读。同一 message_id 或 announcement_id 对同一 user_id 多次写入已读记录时,后端通过联合唯一索引 (message_id+user_id / announcement_id+user_id) 保证幂等,重复操作只生效一次。

16.4.11 异常处理

异常场景触发条件前端表现系统处理恢复方案
未读数超过99站内信未读数+公告未读数 > 99角标显示"99+",面板展示最近5条未读消息后端返回 unread_count 实际值,前端超过99时渲染"99+"用户通过收件箱批量已读减少未读数
WebSocket连接失败WS建立失败或连接中断铃铛功能不受影响,角标可能存在最多60秒延迟自动重试4次(3秒/6秒/12秒/30秒间隔),4次失败后降级为60秒定时轮询 GET /api/v1/message/unread-count网络恢复后WS自动重连成功,停止轮询切换回实时推送
面板展开时新消息到达面板展开期间WebSocket推送新消息事件面板列表不刷新(不跳动),角标数+1并播放动效前端收到WS事件后仅更新角标数字,不重新请求面板列表接口用户关闭面板后再次展开,可见新消息
jump_url对应业务页面已下线站内信 jump_url 指向的路由不存在或已废弃跳转后展示404页面或"页面不存在"提示前端路由守卫拦截无效路径,展示通用404提示用户从收件箱详情页查看消息全文,或从业务模块菜单入口进入
公告在面板展示期间被下架用户展开面板后,该公告被平台运营下架当前面板中该条仍展示(不实时移除),下次展开面板时该条消失后端查询时已过滤 status='已发布',下次请求面板列表时该公告不返回用户关闭面板后再次展开,下架公告不再展示
并发已读(多端同时操作)用户在多个浏览器标签页或不同设备同时点击同一条消息各端面板分别关闭并跳转,角标数各自-1后端通过 t_insite_message_read / t_announcement_read 的联合唯一索引 (message_id+user_id / announcement_id+user_id) 保证幂等,重复写入只生效一次—
用户长时间未登录后首次登录用户超过7天未登录后重新登录页面加载时一次性拉取未读总数并渲染角标调用 GET /api/v1/message/unread-count 获取当前未读总数—

16.5 状态机定义

当前状态触发动作目标状态前置条件副作用
—(不存在)立即发送已发送必填项 + 敏感词校验通过写入 t_insite_message,send_mode=立即发送,send_time=当前时间;分发至接收对象
—(不存在)定时发送待发送必填项 + 敏感词校验通过;发送时间有效写入 t_insite_message,send_mode=定时发送;创建定时任务
待发送到达发送时间已发送定时任务触发更新 send_time;分发至接收对象
已发送用户点击消息已发送(已读)接收对象用户点击写入 t_insite_message_read;更新未读计数
已发送超过180天已归档已读消息(CM-B06)定时任务归档;收件箱不再展示
已发送平台删除—(已删除)手动发送来源;二次确认物理删除记录及已读记录

16.6 异常处理

异常场景触发条件前端表现系统处理恢复方案
敏感词拦截消息内容命中拦截级敏感词弹窗不关闭,内容下方红色提示命中的敏感词列表返回命中的拦截级敏感词列表用户修改内容后重新发送
定时发送时间过期定时发送时间早于当前时间发送时间字段下方红色提示"发送时间不能早于当前时间"前端校验用户修正发送时间后保存
接收范围为空选择指定商家但未选择任何商家接收范围字段下方提示"请至少选择一个接收对象"前端校验用户选择接收对象后发送
删除自动触发的站内信站内信 source_rule_id 不为空时点击删除删除按钮不展示前端按来源控制按钮可见性—
跳转链接无效jump_url 格式不合法或指向不存在的页面用户点击"查看详情"时提示"页面不存在或已失效"跳转时校验URL合法性;无效则提示用户从业务模块入口进入对应页面
定时发送任务失败定时任务执行时系统异常—记录任务失败日志;重试3次;3次失败后标记发送失败并通知管理员管理员手动重新发送

18. 通知规则

18.1 核心业务逻辑

短信渠道说明:通知规则支持站内信和短信两个渠道。站内信内容由本模块的站内信功能(第16章)承接;短信模板和短信发送由PC端商品供应链管理中心PRD承接。通知规则在触发短信渠道时,调用供应链PRD中定义的短信模板ID,通过短信网关发送。

通知规则是平台业务事件与消息通道之间的自动化桥梁。平台运营人员配置通知规则,将业务事件(如订单支付成功、佣金结算完成、协议版本更新等)与通知渠道(站内信/短信)、接收对象、模板内容绑定。当业务模块产生事件时,系统自动匹配通知规则并执行通知发送。通知规则支持即时和延迟两种发送时机。

业务边界:通知规则管理仅平台运营后台可操作。通知规则触发依赖各业务模块上报事件(通过消息队列或API调用),本模块负责规则配置、匹配和执行。站内信模板在规则中内联配置;短信渠道引用PC端商品供应链管理中心PRD中定义的短信模板ID。
WebSocket推送说明:通知规则执行生成站内信后,通知服务通过WebSocket长连接向在线用户前端推送 {type:"new_message", unread_count:N} 事件,前端铃铛Icon角标即时更新。WS连接断开时降级为60秒定时轮询。详见第16章16.4.8实时刷新机制。

18.1.1 功能清单

功能项说明操作角色优先级
通知规则列表分页查询通知规则,支持按名称、触发事件、状态筛选平台运营P1
新增规则配置规则名称、触发事件、接收对象、渠道、模板内容平台运营P1
编辑规则修改规则配置(启用状态规则编辑后即时生效)平台运营P1
启停规则启用/停用通知规则平台运营P1
执行日志查看规则执行记录,含触发事件、接收对象、发送状态平台运营P1
测试触发手动模拟事件触发,验证规则配置是否正确平台运营P2

18.1.2 触发事件清单

事件编码事件名称来源模块默认接收对象可用变量
order_paid订单支付成功订单中心订单相关方(供应商+分销商)${orderNo} ${amount} ${productName} ${payTime}
order_completed订单核销完成订单中心订单相关方${orderNo} ${productName} ${verifyTime}
order_refund退款处理完成售后中心订单相关方${orderNo} ${refundAmount} ${refundTime}
commission_settled佣金结算完成财务中心佣金归属方${month} ${amount} ${settleTime}
agreement_updated协议版本更新内容管理协议签署方${agreementType} ${versionNo} ${effectiveTime}
merchant_approved商家入驻审核通过商家管理入驻商家${merchantName} ${merchantType}
merchant_rejected商家入驻审核驳回商家管理入驻商家${merchantName} ${rejectReason}
withdraw_result提现审核结果财务中心提现申请人${amount} ${result} ${processTime}
after_sale_created售后申请已提交售后中心供应商${orderNo} ${reason}
after_sale_resolved售后处理结果售后中心售后申请方${orderNo} ${result} ${processTime}
事件扩展:触发事件清单可通过系统配置扩展,新增业务模块时由研发在事件总线注册新事件编码并通知运营配置对应规则。本表列出本期全部已支持事件。

18.1.3 字段说明

字段类型必填校验规则说明
规则名称文本是2-50字符用于列表展示和管理识别
触发事件下拉单选是枚举见18.1.2选择业务事件
接收对象下拉单选是枚举:全部/供应商/分销商/订单相关方/指定角色"订单相关方"由事件上下文动态确定
通知渠道下拉单选是枚举:站内信/短信/站内信+短信决定通知发送方式
站内信标题模板文本条件必填渠道包含站内信时必填;2-100字符支持变量占位符
站内信内容模板富文本条件必填渠道包含站内信时必填;10-5000字符支持变量占位符和基础格式
短信模板下拉选择条件必填渠道包含短信时必填;仅审核通过的模板可选选择短信渠道时,引用PC端商品供应链管理中心PRD中定义的短信模板ID。短信模板管理不在本PRD范围内。
发送时机下拉单选是即时/延迟;默认即时延迟发送需配置延迟分钟数
延迟分钟数数字条件必填1-1440;仅发送时机=延迟时必填事件发生后延迟指定分钟发送通知

18.2 交互逻辑表

触发入口前置条件操作步骤系统响应结果状态
列表页「新增规则」按钮用户拥有 message:rule:create 权限点击按钮 → 弹出新增弹窗 → 填写字段 → 点击「保存」校验必填项 → 写入数据库 is_enabled=true → 刷新列表启用
列表页「编辑」操作用户拥有 message:rule:edit 权限点击行内「编辑」→ 弹出编辑弹窗 → 修改字段 → 点击「保存」校验必填项 → 更新数据库 → 即时刷新规则缓存(CM-B05)→ 刷新列表保持原状态
列表页「停用」操作规则 is_enabled=true点击行内「停用」更新 is_enabled=false → 即时生效(CM-B05):新事件不再触发该规则;已触发未发送的通知继续执行停用
列表页「启用」操作规则 is_enabled=false点击行内「启用」更新 is_enabled=true → 即时生效:新事件开始触发该规则启用
列表页「执行日志」操作—点击行内「执行日志」→ 跳转执行日志页查询 t_notification_log → 分页展示—
列表页「测试触发」操作规则 is_enabled=true点击行内「测试触发」→ 弹出测试弹窗 → 填入变量示例值 → 点击「发送测试」使用示例值渲染模板 → 向当前用户发送测试通知 → 记录测试日志—
业务事件自动触发规则启用且事件匹配业务模块产生事件 → 上报事件总线 → 匹配规则获取规则配置 → 确定接收对象 → 渲染模板 → 按渠道发送站内信/短信 → 记录执行日志—

18.3 页面原型

18.3.1 通知规则列表页

通知规则 - 列表页
/platform/message/notify-rule
基础管理 / 消息管理 / 通知规则
通知规则
规则名称触发事件接收对象渠道发送时机状态操作
订单支付成功-通知双方订单支付成功订单相关方站内信+短信即时启用编辑停用执行日志测试
佣金结算完成-通知分销商佣金结算完成佣金归属方站内信即时启用编辑停用执行日志测试
协议更新-通知签署方协议版本更新协议签署方站内信延迟 30分钟启用编辑停用执行日志测试
退款完成-通知双方退款处理完成订单相关方站内信+短信即时停用编辑启用执行日志
共 12 条 1 每页 条

18.3.2 新增规则弹窗

新增通知规则 - 弹窗
新增通知规则×
可用变量:${orderNo} 订单号 | ${amount} 支付金额 | ${productName} 商品名称 | ${payTime} 支付时间
短信模板由商品供应链管理中心维护

18.4 状态机定义

当前状态触发动作目标状态前置条件副作用
—(不存在)新增启用必填项校验通过写入 t_notification_rule,is_enabled=true
启用停用停用无更新 is_enabled=false;新事件不再触发;已触发未发送的通知继续执行(CM-B05)
停用启用启用无更新 is_enabled=true;新事件开始触发

18.5 异常处理

异常场景触发条件前端表现系统处理恢复方案
模板变量缺失事件上报时未提供模板所需的全部变量值—缺失变量保留占位符原文发送;同时记录warning日志开发排查事件上报时变量传参链路
接收对象为空事件触发时动态确定的接收对象为空(如订单已删除)—记录日志"接收对象为空,跳过通知";不发送—
短信发送失败短信网关返回失败—按CM-B07重试3次(1分钟/5分钟/30分钟);3次失败后标记发送失败,记录fail_reason查看失败原因,必要时联系短信网关服务商
引用的短信模板被驳回规则引用的短信模板审核状态变更为已驳回—规则自动降级:仅发送站内信,跳过短信;记录warning日志"短信模板已驳回,仅发送站内信"运营人员更换短信模板或修改模板后重新提交审核
规则匹配冲突同一事件匹配到多条启用的规则—多条规则并行执行,互不影响;同一接收对象可能收到多条通知运营人员检查规则配置,避免重复通知
延迟发送任务失败延迟发送定时任务执行异常—记录任务失败日志;重试3次;3次失败后通知管理员管理员手动触发或检查事件数据

19. 系统初始化

19.1 初始化数据清单

系统首次部署时需预置以下初始化数据,确保内容信息管理模块开箱可用。初始化数据通过数据库迁移脚本写入,部署时自动执行。

19.1.1 协议初始化数据

协议编码协议标题版本号状态生效方式内容要求
platform_service平台服务协议v1.0已生效立即生效包含服务条款、用户权利义务、争议处理等基础条款
privacy隐私协议v1.0已生效立即生效包含个人信息收集范围、使用目的、保护措施等条款
distribution_public分销协议(平台公共)v1.0已生效立即生效包含分销商准入、佣金规则、结算周期、退出机制等条款
membership会员协议v1.0已生效立即生效包含会员等级、权益范围、退会机制等条款
points积分协议v1.0已生效立即生效包含积分获取、消耗、过期规则等条款
distributor_agent分销员协议v1.0已生效立即生效包含分销员行为规范、佣金结算、合规条款等

19.1.2 通知规则初始化数据

规则名称触发事件接收对象渠道发送时机默认状态
订单支付成功-站内信通知order_paid订单相关方站内信即时启用
订单核销完成-站内信通知order_completed订单相关方站内信即时启用
退款处理完成-站内信通知order_refund订单相关方站内信即时启用
佣金结算完成-站内信通知commission_settled佣金归属方站内信即时启用
协议版本更新-站内信通知agreement_updated协议签署方站内信延迟 30分钟启用
商家入驻审核通过-站内信通知merchant_approved入驻商家站内信即时启用
商家入驻审核驳回-站内信通知merchant_rejected入驻商家站内信即时启用
提现审核结果-站内信通知withdraw_result提现申请人站内信即时启用
售后申请已提交-站内信通知after_sale_created供应商站内信即时启用
售后处理结果-站内信通知after_sale_resolved售后申请方站内信即时启用

19.1.3 敏感词库初始化数据

初始化内容说明数据来源
基础敏感词集包含政治敏感词、色情敏感词、广告违禁词等约200-500条基础敏感词系统预置SQL脚本
分类覆盖覆盖政治、色情、广告、欺诈、其他五个分类—
处理级别政治类默认拦截级;色情类默认拦截级;广告类默认替换级(替换为***);欺诈类默认拦截级—
初始化数据维护:敏感词库初始化数据仅作为系统启动基础,上线后由平台运营/风控人员持续维护和补充。协议文本内容由法务团队在系统上线前审核确认后替换初始模板文本。

19.2 权限初始化

权限编码权限名称默认角色说明
content:announcement:view公告管理-查看平台运营查看公告列表和详情
content:announcement:create公告管理-新增平台运营新增公告
content:announcement:edit公告管理-编辑平台运营编辑草稿公告
content:announcement:publish公告管理-发布平台运营发布公告
content:announcement:offline公告管理-下架平台运营下架已发布公告
content:announcement:pin公告管理-置顶平台运营置顶/取消置顶公告
content:publish:view内容发布-查看平台运营访问内容发布聚合入口,控制侧边栏"内容发布"菜单项可见性
content:article:view文章-查看平台运营文章管理Tab可见权限
content:notice:view须知-查看平台运营/供应商须知管理Tab可见权限,供应商仅查看平台须知和本供应商须知
content:notice:create须知-新增平台运营/供应商创建须知,归属方自动识别
content:notice:edit须知-编辑平台运营/供应商编辑须知内容(草稿/已下架状态)
content:notice:publish须知-发布/下架平台运营/供应商发布、下架、上架操作
content:notice:delete须知-删除平台运营/供应商删除须知(仅草稿/已下架)
content:notice:bind须知-SPU绑定平台运营/供应商管理须知与SPU的绑定关系
content:help:view帮助-查看平台运营/供应商/分销商帮助指南Tab可见权限(平台);供应商/分销商后台帮助列表查看权限
content:help:create帮助-新增平台运营创建帮助内容
content:help:edit帮助-编辑平台运营编辑帮助内容(草稿/已下架状态)
content:help:publish帮助-发布/下架平台运营发布、下架、上架操作
content:help:delete帮助-删除平台运营删除帮助内容(仅草稿/已下架)
content:help:pin帮助-置顶平台运营设置/取消置顶
content:agreement:view协议管理-查看法务/运营查看协议列表和版本
content:agreement:create协议管理-新增法务专员新增协议/版本(协议编码由系统自动生成)
content:agreement:edit协议管理-编辑法务专员编辑草稿/已驳回版本
content:agreement:delete协议管理-删除法务专员删除从未生效的协议编码
content:agreement:audit协议管理-审核平台管理员审核协议版本
content:agreement:publish协议管理-发布法务/运营发布协议版本生效
content:agreement:stop协议管理-停用法务/运营停用已生效协议(关闭签署入口,已签署数据不受影响)
content:sensitive:view敏感词库-查看平台运营/风控查看敏感词列表
content:sensitive:create敏感词库-新增平台运营/风控新增敏感词
content:sensitive:edit敏感词库-编辑平台运营/风控编辑敏感词
content:sensitive:import敏感词库-导入平台运营/风控批量导入敏感词
content:keyword:view关键词-查看平台运营查看关键词列表
content:keyword:create关键词-新增平台运营新增关键词
content:keyword:edit关键词-编辑平台运营编辑关键词
message:insite:view站内信-查看平台运营查看站内信列表
message:insite:send站内信-发送平台运营手动发送站内信
message:inbox:view收件箱-查看供应商/分销商全员查看收件箱
message:rule:view通知规则-查看平台运营查看通知规则列表
message:rule:create通知规则-新增平台运营新增通知规则
message:rule:edit通知规则-编辑平台运营编辑通知规则

20. 验收标准

20.1 功能验收标准

编号模块验收项验收标准优先级
AC-001公告管理公告新增与发布新增公告填写必填项后保存草稿成功;草稿发布时触发敏感词校验,通过后状态变更为已发布P1
AC-002公告管理公告下架已发布公告可下架,下架后各端不再展示该公告;已下架公告可重新上架展示P1
AC-003公告管理公告置顶已发布公告可置顶,同接收范围最多3条置顶,超出时提示限制信息P1
AC-004公告管理公告状态流转公告状态按草稿→已发布→已下架流转,已下架可重新上架;草稿和已下架状态可删除,已发布不可删除P1
AC-005公告管理阅读统计已发布公告可查看阅读统计,包含目标人数、已读人数、未读人数、阅读率,支持按用户类型筛选P1
AC-006平台协议协议新增与审核新增协议版本后保存草稿或提交审核;提交审核后审核人可审核通过或驳回(驳回需填原因)P1
AC-007平台协议协议发布生效审核通过版本发布生效后,同编码旧版本自动变更为已失效(expire_time = 新版本生效时间);已签署旧版本用户下次登录时弹出再确认弹窗P1
AC-008平台协议版本唯一性同一协议编码下同时仅允许一个版本处于已生效状态;有草稿/待审核版本时不可重复新增同编码版本;已生效/已生效过的协议不可删除;启用/停用仅控制签署入口,不影响版本状态P1
AC-009敏感词库敏感词新增与启停新增敏感词全局唯一校验生效;启停操作后5分钟内缓存刷新生效P2
AC-010敏感词库批量导入Excel导入支持模板下载;导入时逐行校验,合法行写入数据库,非法行跳过并记录失败明细P2
AC-011敏感词库敏感词校验公告/协议/站内信提交时调用敏感词校验接口:拦截级阻止提交,替换级自动替换,审核级放行并记录P1
AC-012关键词管理关键词增删改新增关键词全局唯一校验生效;支持编辑类型和排序权重;删除需二次确认;启停后移动端同步生效P1
AC-013站内信手动发送手动发送站内信时触发敏感词校验;立即发送即时到达接收对象收件箱;定时发送到达指定时间后发送P1
AC-014站内信收件箱供应商/分销商后台收件箱展示站内信列表;点击消息标记已读;支持批量已读;顶部导航栏展示未读计数P1
AC-015站内信站内信归档已读站内信超过180天后自动归档,收件箱不再展示;未读站内信不自动清理P1
AC-016铃铛Icon未读角标展示铃铛右上角显示站内信未读数+公告未读数之和的红色角标;0时无角标;1-99显示数字;超过99显示"99+";三端均生效P1
AC-017铃铛Icon下拉面板预览点击铃铛弹出面板展示最近5条未读消息(站内信+公告合并,按时间倒序);消息类型标签正确显示(系统/订单/售后/佣金/协议/公告);无未读时展示"暂无未读消息"P1
AC-018铃铛Icon消息点击跳转与已读标记点击站内信消息:写入t_insite_message_read→跳转jump_url(或收件箱详情);点击公告消息:写入t_announcement_read→跳转公告详情(或收件箱);角标数-1;已读不可回退P1
AC-019通知规则规则配置与触发新增规则配置触发事件、接收对象、渠道、模板后保存成功;业务事件发生时自动匹配规则并执行通知P1
AC-020通知规则规则启停停用规则后新事件不再触发;已触发未发送的通知继续执行;启用后新事件恢复触发P1
AC-021通知规则短信发送重试短信发送失败后自动重试3次(1分钟/5分钟/30分钟),3次失败后标记发送失败并记录原因P1
AC-022通知规则执行日志每条规则执行记录可在执行日志页查看,含触发事件、接收对象、渠道、发送状态、失败原因P1
AC-023全局权限控制所有操作按钮按角色按钮权限控制可见性,无权限时按钮不渲染(非置灰)P0
AC-024全局操作日志所有关键操作(发布、下架、审核、启停)记录操作日志,包含操作人、操作时间、操作类型、目标对象P1
AC-025内容分类管理分类新增与唯一性新增子分类名称在同层级下唯一校验生效;分类名称长度1-50字符;层级最多3级;系统预置一级分类不可删除P1
AC-026内容分类管理分类删除约束系统预置分类不可删除;子分类被文章引用时不可删除,需先迁移文章;有子分类的节点需先删除子分类;未被引用且无子分类的分类删除后不可恢复P1
AC-027内容分类管理分类树展示与排序分类树支持展开/折叠、按名称搜索;同级分类按排序权重升序展示,支持拖拽调整排序P1
AC-028文章/资讯管理文章创建与草稿通过富文本编辑器创建文章,选择类型和分类,支持草稿保存和预览;草稿不含敏感词校验P1
AC-029文章/资讯管理文章上架与推送上架文章时触发敏感词校验通过后状态变为已上架;可选择推送至供应商/分销商收件箱,通过站内信通知P1
AC-030文章/资讯管理文章置顶限制同一分类下最多置顶5篇,超出时提示限制;置顶文章在列表顶部按pin_sort排序展示P1
AC-031文章/资讯管理文章删除约束已上架文章不可直接删除,需先下架;删除操作需二次确认,删除后不可恢复P1
AC-032文章/资讯管理阅读统计统计阅读人数(去重)和阅读次数(总点击),支持按接收对象类型分组查看;阅读率=阅读人数/目标接收人数P1
AC-036平台协议协议变量占位符协议正文支持${变量名}格式变量;保存时自动提取变量与预置列表比对;预览时用示例数据渲染;签署时替换为实际值存储快照P1
AC-037内容发布聚合入口Tab切换通过内容发布入口进入页面后默认展示公告管理Tab;点击Tab切换时URL同步更新?tab=参数;切换Tab后筛选条件和分页状态重置P1
AC-038内容发布Tab权限控制无某内容类型查看权限时对应Tab不展示;无任何内容类型查看权限时展示空状态提示;直接访问无权限Tab的URL时重定向到默认TabP1
AC-039须知管理须知新增与发布平台和供应商各自可创建须知;归属方自动识别;草稿发布时触发敏感词校验,通过后状态变更为已发布P1
AC-040须知管理须知状态流转须知状态按草稿→已发布→已下架流转,已下架可重新上架;草稿和已下架状态可删除,已发布不可编辑和删除P1
AC-041须知管理SPU绑定管理已发布须知可绑定SPU;同一须知不可重复绑定同一SPU;同一归属方同一类型须知不可重复绑定同一SPU;支持批量绑定和解绑P1
AC-042须知管理数据隔离供应商后台仅展示平台须知和本供应商须知;供应商不可查看其他供应商须知;供应商须知仅可绑定本供应商SPUP1
AC-043须知管理须知下架联动须知下架后C端商品详情页即时停止展示该须知但绑定关系保留;须知删除时自动解除全部SPU绑定关系P1
AC-044帮助管理帮助新增与发布创建帮助内容选择类型和展示范围后保存草稿或直接发布;发布时触发敏感词校验,通过后状态变更为已发布并分发至对应端P1
AC-045帮助管理帮助状态流转帮助状态按草稿→已发布→已下架流转,已下架可重新上架;草稿和已下架状态可删除,已发布不可编辑和删除P1
AC-046帮助管理展示范围分发展示范围=供应商的仅在供应商后台帮助中心展示;展示范围=分销商的仅在分销商后台展示;展示范围=全部的在两端均展示P1
AC-047帮助管理置顶与排序已发布帮助内容可置顶,置顶内容按pin_sort升序排列在列表顶部,非置顶内容按publish_time倒序排列P2
AC-048帮助管理阅读统计已发布帮助内容可查看阅读统计,包含阅读人数(去重)、阅读次数、阅读率,支持按用户类型分组查看P2
AC-049帮助管理供应商后台帮助查看供应商后台"内容管理 > 帮助"菜单可见;列表仅展示target_scope含"全部"或"供应商"的已发布帮助;支持按类型筛选和关键词搜索;无新增/编辑/删除按钮;点击标题可查看详情并记录阅读P1
AC-050帮助管理分销商后台帮助查看分销商后台"内容管理 > 帮助"菜单可见;列表仅展示target_scope含"全部"或"分销商"的已发布帮助;支持按类型筛选和关键词搜索;无新增/编辑/删除按钮;点击标题可查看详情并记录阅读P1
说明:短信模板管理相关验收标准由PC端商品供应链管理中心PRD定义,本章不重复。

20.2 性能验收标准

验收项指标说明
列表查询响应时间≤ 1秒(20条/页)含筛选条件查询,数据量10万条以内
公告发布延迟≤ 3秒从点击发布到各端可见
敏感词校验延迟≤ 200毫秒单次内容校验(5000字符以内)
站内信分发延迟≤ 5秒从发送到接收对象收件箱可见
通知规则匹配延迟≤ 2秒从事件上报到通知发送
短信发送延迟≤ 10秒从调用短信网关到短信发出

21. 质量自检

21.1 PRD完整性自检

检查项检查内容结果
文档元信息包含文档编码、版本号、深度等级、编写人、审核人、变更记录通过
术语表定义了内容信息管理模块涉及的专有术语和缩写通过
需求背景与目标明确业务背景、痛点、目标和范围边界通过
用户与角色定义全部操作角色及其权限范围通过
功能清单覆盖功能清单中消息与内容模块的全部功能项通过
系统架构包含模块架构图和与外部模块交互关系通过
核心业务流程包含公告发布、协议版本管理、通知规则触发、敏感词校验四条核心流程图通过
全局规则定义通用交互规则、业务规则和异常处理规则通过
页面路由覆盖平台后台、供应商后台、分销商后台全部页面路径通过
数据模型包含ER图和17张核心数据表结构定义(t_sms_template、t_notification_template由供应链PRD承接/已移除)通过
功能模块详解11个子模块均包含核心业务逻辑、交互逻辑表、页面原型、状态机、异常处理五层内容(含内容发布聚合入口、须知管理、帮助管理新增模块)通过
系统初始化定义初始化数据(协议、通知规则、敏感词)和权限初始化(含须知、帮助权限项)通过
验收标准包含功能验收标准(42项)和性能验收标准(短信模板相关验收标准由供应链PRD定义)通过

21.2 功能覆盖度自检

功能清单条目对应PRD章节覆盖状态
内容管理 - 通知公告(发布、置顶、下架、阅读状态)第12章 公告管理已覆盖
内容管理 - 平台协议及声明(协议文本、版本、生效、历史)第13章 平台协议及声明已覆盖
内容管理 - 敏感词库(新增、编辑、启停、命中记录)第14章 敏感词库已覆盖
内容管理 - 关键词(搜索关键词、热门词、推荐词、屏蔽词)第15章 关键词管理已覆盖
消息中心 - 站内信(消息列表、详情、已读、跳业务页)第16章 站内信已覆盖
消息中心 - 短信模板(模板、变量、审核状态、发送记录)供应链PRD承接排除-由其他PRD承接
消息中心 - 通知规则(触发条件、接收人、渠道、启停)第18章 通知规则已覆盖
供应商后台 - 消息中心收件箱第16章 16.3.3 收件箱原型已覆盖
分销商后台 - 消息中心收件箱第16章 16.3.3 收件箱原型已覆盖
供应商后台 - 系统设置通知偏好第10章 页面路由 10.3 已定义路由路由覆盖
内容管理 - 内容分类管理(分类树、新增子分类、编辑、删除、启停、排序)第15a章 内容分类管理已覆盖
内容管理 - 文章/资讯管理(创建、编辑、上下架、置顶、推送、阅读统计)第15b章 文章/资讯管理已覆盖
内容管理 - 内容发布聚合入口(Tab切换、公告管理/文章管理/须知管理/帮助指南统一管理)第11a章 内容发布(聚合入口)已覆盖
内容管理 - 须知管理(平台/供应商创建、SPU绑定、六种类型)第15c章 须知管理已覆盖
内容管理 - 帮助管理(四种类型、展示范围、置顶、阅读统计)第15d章 帮助管理已覆盖
内容管理 - 供应商后台帮助查看(只读、按展示范围分发)第15d章 15d.8 供应商后台帮助查看页已覆盖
内容管理 - 分销商后台帮助查看(只读、按展示范围分发)第15d章 15d.8 分销商后台帮助查看页已覆盖
内容管理 - 文章类型(新闻,公告/须知/帮助已独立成表)第15b章 15b.1.2 / 15b.1.3 文章类型说明已覆盖
内容管理 - 公告标记已读(接收端角标提示)第12章 12.1 功能清单 + 第15b章 文章推送已覆盖
内容管理 - 关键词删除/批量删除/查看搜索结果第15章 15.1.1 功能清单已覆盖
内容管理 - 协议变量占位符第13章 13.x 协议变量占位符已覆盖
内容管理 - 微信订阅消息模板第4.3 不在本次范围已排除
内容管理 - AI内容生成第4.3 不在本次范围已排除
通知偏好说明:供应商/分销商后台的"系统设置 > 通知偏好"(P2优先级)在本期PRD中仅定义页面路由和入口,具体功能逻辑将在后续迭代中补充。该功能允许商家按消息类型配置接收渠道偏好(站内信/短信),属于通知规则在商家侧的个性化配置入口。

21.3 数据模型一致性自检

数据表对应功能模块字段与功能一致性
t_announcement第12章 公告管理一致 - 字段覆盖标题、正文、分类、范围、状态、置顶、下架时间
t_announcement_read第12章 阅读统计一致 - 记录阅读用户和时间
t_platform_agreement第13章 平台协议一致 - 字段覆盖协议编码、标题、版本、内容、状态、生效/失效时间、变更说明
t_agreement_config第13章 协议编码配置一致 - 记录协议编码启用/停用/删除状态、停用原因
t_agreement_sign第13章 签署记录一致 - 记录协议编码、版本、签署用户、时间、IP、再确认时间、签署快照
t_sensitive_word第14章 敏感词库一致 - 字段覆盖词汇、分类、级别、替换词、命中次数、启停
t_sensitive_hit_log第14章 命中记录一致 - 记录命中来源、内容、处理方式
t_keyword第15章 关键词管理一致 - 字段覆盖词汇、类型、排序、启停
t_insite_message第16章 站内信一致 - 字段覆盖标题、内容、类型、范围、跳转、发送方式、来源
t_insite_message_read第16章 收件箱已读一致 - 记录已读用户和时间
t_notification_rule第18章 通知规则一致 - 字段覆盖名称、事件、对象、渠道、模板、时机、启停
t_notification_log第18章 执行日志一致 - 记录规则、事件、对象、渠道、状态、失败原因
t_content_category第15a章 内容分类管理一致 - 字段覆盖分类名称、父分类、层级、分类路径、系统预置标识、排序权重、状态、文章引用数
t_article第15b章 文章/资讯管理一致 - 字段覆盖标题、类型、分类、正文、封面、摘要、作者、状态、置顶、推送范围、阅读统计
t_article_read第15b章 阅读统计一致 - 记录文章ID、用户ID、用户类型、阅读时间
t_notice第15c章 须知管理一致 - 字段覆盖标题、正文、类型、归属类型、归属ID、状态、发布/下架时间
t_notice_spu第15c章 SPU绑定管理一致 - 记录须知ID、SPU ID、SPU名称快照、绑定操作人、绑定时间
t_help第15d章 帮助管理一致 - 字段覆盖标题、正文、类型、展示范围、状态、置顶、发布/下架时间、阅读统计
t_help_read第15d章 阅读统计一致 - 记录帮助ID、用户ID、用户类型、阅读时间
说明:t_sms_template由供应链PRD定义,本章不检查。t_notification_template已移除,站内信模板内容在站内信模块(第16章)中内联配置。

21.4 与其他模块PRD接口一致性

接口对接模块接口说明一致性
敏感词校验接口商品供应链管理中心商品名称、商品详情提交时调用敏感词校验一致
敏感词校验接口订单中心用户评价提交时调用敏感词校验一致
通知规则事件接口订单中心订单支付成功、核销完成、退款完成事件上报一致
通知规则事件接口财务中心佣金结算完成、提现审核结果事件上报一致
通知规则事件接口商家管理中心商家入驻审核通过/驳回事件上报一致
通知规则事件接口售后中心售后申请提交、售后处理结果事件上报一致
协议签署接口基础功能与权限管理用户注册/登录时调用协议确认一致
协议签署接口商家管理中心商家入驻时调用协议签署一致
站内信分发接口各业务模块各端通过统一接口拉取站内信列表一致
质量自检结论:本PRD覆盖甲方功能清单中内容管理和消息管理中的站内信和通知规则(短信模板管理由PC端商品供应链管理中心PRD承接,通知模板管理已移除)。v1.2版本新增内容发布聚合入口(Tab切换公告管理/文章管理/须知管理/帮助指南)、须知管理(平台和供应商各自创建、SPU级绑定)、帮助管理(四种类型、展示范围分发、阅读统计)三个新模块,取消公告管理和文章/资讯独立菜单入口,统一归入内容发布聚合入口。数据模型新增t_notice、t_notice_spu、t_help、t_help_read四张表,共计17张核心数据表。数据模型与功能设计一致,与其他模块PRD接口定义一致,符合PRD产出SOP与深度标准模板的深度等级要求。文档可直接交付研发实施。