内容发布是平台内容管理的统一聚合入口,将公告管理、文章管理、须知管理、帮助指南四种内容管理入口整合在同一页面下,通过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参数切换到对应Tab URL回退到上一个tab参数值
直接访问带tab参数的URL 在地址栏输入/粘贴URL 校验tab参数有效性,展示对应Tab;无权限则展示默认Tab URL保持不变
访问不带tab参数的URL 在地址栏输入不带?tab=的URL 重定向到默认Tab的URL /platform/content/publish → /platform/content/publish?tab=announcement
访问无效tab参数 URL的tab参数值不在枚举范围内 重定向到默认Tab tab参数重置为announcement
11A.3 页面布局
内容发布页面采用"侧边栏 + 面包屑 + Tab栏 + 内容区"的布局结构。侧边栏菜单中"内容管理"下展示"内容发布"菜单项(原"公告管理"菜单项替换为"内容发布"),点击进入后页面顶部展示Tab栏,Tab下方为对应内容类型的列表/表单区域。
11A.3.1 侧边栏与Tab布局原型
/platform/content/publish?tab=announcement
基础管理 / 内容管理 / 内容发布
公告管理 + 新增公告
公告标题
公告分类 全部分类 系统公告 活动公告 政策公告 运营公告
接收范围 全部 供应商 分销商
状态 全部 草稿 已发布 已下架
查询
重置
公告标题 公告分类 接收范围 状态 阅读统计 创建时间 最新发布时间 操作
系统升级维护通知 系统公告 全部 已发布 已读 128 / 未读 32 2026-08-09 17:20 2026-08-10 09:30 下架 取消置顶 阅读统计
暑期促销活动上线 活动公告 分销商 已发布 已读 86 / 未读 24 2026-08-08 10:00 2026-08-08 14:00 下架 置顶 阅读统计
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 / 未读 32 2026-08-09 17:20 2026-08-10 09:30 下架 取消置顶 阅读统计
暑期促销活动上线 活动公告 分销商 已发布 已读 86 / 未读 24 2026-08-08 10:00 2026-08-08 14:00 下架 置顶 阅读统计
分销佣金比例调整说明 政策公告 供应商 草稿 - 2026-08-04 16:30 - 编辑 发布 删除
平台服务协议更新公告 运营公告 全部 已下架 已读 120 / 未读 10 2026-07-30 15:00 2026-08-11 16:00 发布 删除 阅读统计
12.3.2 新增/编辑公告弹窗
公告标题 *
公告分类 * 请选择 系统公告 活动公告 政策公告 运营公告
接收范围 * 请选择 全部 供应商 分销商
12.3.3 阅读统计详情页
/platform/content/publish?tab=announcement&action=read-stats&id=123
基础管理 / 内容管理 / 内容发布 / 公告 / 阅读统计
系统升级维护通知 - 阅读统计 返回列表
用户类型 目标人数 已阅读 未阅读 阅读率
供应商 32 28 4 87.5%
分销商 124 78 46 62.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.2 2026-07-15 1,248 版本历史 新增版本 签署记录 预览
AGR20260601002 隐私协议 已生效 ● v2.0 2026-06-01 1,248 版本历史 新增版本 签署记录 预览
AGR20260720003 分销协议(平台公共) 已生效 ● v1.5 2026-07-20 156 版本历史 新增版本 签署记录 预览
AGR20260801004 会员协议 草稿 — 暂无生效版本 — 版本历史 新增版本 编辑 删除 预览
AGR20260501005 积分协议 已失效 ● 暂无生效版本 980 版本历史 新增版本 签署记录 预览
AGR20260801006 分销员协议 已生效 ● v2.1 2026-08-01 320 版本历史 新增版本 签署记录 预览
提示 :同一协议编码下同时仅允许一个版本处于"已生效"状态。有进行中版本(草稿/待审核/审核通过/已驳回/待生效)时,该编码行不可再新增版本。已生效/已生效过的协议无删除按钮;从未生效的协议可删除。
13.3.2 新增版本弹窗
13.3.3 审核弹窗
版本号: v3.3
变更说明: 更新退款条款第8条
提交人: 张法务
提交时间: 2026-08-10 14:00
云灵汐平台服务协议
版本号:v3.3
更新日期:2026年8月10日
第一条 服务条款的接受...
第八条 退款政策(更新)...用户在核销前申请退款,按商品退改规则计算退款金额,可能扣除手续费...
审核备注
13.3.4 签署记录页
共 1,248 条签署记录,当前第 1/125 页
签署方 用户类型 签署时间 IP地址 签署状态 操作
供应商A(ID:10086) 供应商 2026-07-15 10:23:45 192.168.1.100 已签署 查看协议详情
分销商B(ID:20068) 分销商 2026-07-15 14:56:12 10.0.12.55 已签署 查看协议详情
用户C(ID:30012) C端用户 2026-07-16 09:12:33 172.16.5.88 待重新确认 查看协议详情
供应商D(ID:10092) 供应商 2026-07-16 11:45:00 192.168.2.201 已签署 查看协议详情
分销商E(ID:20075) 分销商 2026-07-17 08:30:15 10.0.15.42 已重新签署 查看协议详情
每页 10 条
上一页
1
2
3
...
125
下一页
13.3.5 签署协议详情弹窗
签署方:供应商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
生效时间:2026-07-15
平台服务协议
版本 v3.2 | 生效时间:2026-07-15
第一条 服务范围
本协议适用于张三(以下简称"乙方")在云领犀平台(以下简称"甲方")开展的旅游产品分销业务。乙方入驻甲方平台后,可发布旅游产品并接受分销商代销。
第二条 权利义务
乙方应确保所发布旅游产品符合国家法律法规,产品信息真实有效。甲方有权对乙方产品进行审核,不符合要求的产品不予上架。
第三条 费用结算
甲方按月与乙方结算分销订单费用,结算周期为每月1日至月末,次月5个工作日内完成结算。佣金比例按产品类目约定执行。
第四条 协议期限
本协议自乙方签署之日起生效,有效期至甲方发布新版本协议时止。新版本生效后,乙方需重新签署确认。
变量为示例值(如"张三"),实际以用户签署时替换为准
关闭预览
预览内容来源规则
协议状态 展示内容
草稿(有 draft_content) draft_content(草稿内容)
草稿(无 draft_content) content(已提交内容)
待审核 / 审核通过 / 待生效 / 已生效 / 已失效 content(已提交内容)
13.3.7 版本历史页
共 3 个版本,按版本号倒序排列
协议编码 协议标题 版本号 状态 生效时间 失效时间 创建人 发布时间 变更说明 停用原因 操作
AGR20260715001 平台服务协议 v3.2 已生效 2026-07-15 00:00:00 — 法务专员A 2026-07-14 15:00:00 更新退款条款第8条,新增跨境游特殊规定 — 详情
AGR20260715001 平台服务协议 v3.1 已失效 2026-05-01 00:00:00 2026-07-15 00:00:00 法务专员A 2026-04-30 10:00:00 调整分销佣金比例说明 — 详情
AGR20260715001 平台服务协议 v3.0 已失效 2026-01-01 00:00:00 2026-05-01 00:00:00 法务专员B 2025-12-30 14:00:00 初版发布 — 详情
停用原因取自 t_agreement_config.stop_reason(协议编码级),同一协议编码下所有版本行显示相同值;协议处于启用状态时显示"—"
13.3.8 停用协议弹窗
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 双轨内容模型
协议版本内容采用"已提交内容"与"草稿内容"双轨分离设计,二者独立存储、互不覆盖:
已提交内容(submitted_content) :用户点击"提交审核"时写入的内容快照,是审核、发布、生效的实际对象。
草稿内容(draft_content) :用户在编辑弹窗中点击"保存草稿"时写入的内容,仅作为编辑暂存,不参与审核与发布流程。
操作 写入/读取轨道 对版本状态的影响
保存草稿 写入 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 这五个进行中状态均允许点击"编辑"打开编辑弹窗。编辑弹窗内提供两个操作:
保存草稿 :写入 draft_content,版本状态不变。
提交审核 :将 draft_content 提升为 submitted_content,版本状态变为 AUDITING,重新走审核流程。
无论原状态是什么,只要点击"提交审核",版本状态一律变为 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 字段。仅在版本状态=已生效时有效。
停用 :关闭签署入口,新用户不可签署该协议。已签署数据不受影响,版本状态不变。已生效协议因审计数据已产生,不可删除,停用是唯一关停手段。停用时必填停用原因(10-500字,存入 t_agreement_config.stop_reason)。
启用 :恢复签署入口,新用户可再次签署。前提是协议仍在生效日期内(版本状态=已生效)。
删除规则
删除操作针对整个协议编码(连同其下所有版本),需同时满足以下条件:
该协议编码无生效历史(从未出现过 EFFECTIVE 版本)。
当前进行中版本状态为 DRAFT 或 REJECTED,或协议编码下无版本(NOT_EFFECTIVE)。
13.5.7 签署记录流转(独立状态机)
签署记录与协议版本是两个独立的领域对象,各自维护独立的状态机。签署记录状态存储在 t_agreement_sign.sign_status 字段。
状态码 显示标签 含义
SIGNED 已签署 用户已完成当前版本签署
PENDING_RECONFIRM 待重新确认 原签署版本被新版本替代(旧版本 EXPIRED),需用户重新签署新版本
RESIGNED 已重新签署 用户对新版本完成重新签署
流转规则:
版本生效时,用户对该版本的签署记录状态为 SIGNED。
新版本生效导致旧版本 EXPIRED 时,旧版本的签署记录自动转为 PENDING_RECONFIRM。
用户对新版本完成签署后,签署记录转为 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 条
批量导入
+ 新增敏感词
敏感词汇
分类 全部 政治 色情 广告 欺诈 其他
处理级别 全部 拦截 替换 审核
状态 全部 启用 停用
查询
重置
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
基础管理 / 内容管理 / 关键词
关键词管理 + 新增关键词
关键词
类型 全部 热门搜索 推荐搜索 屏蔽搜索
状态 全部 启用 停用
查询
重置
批量删除
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 — 启用 编辑 新增子分类
▶ 平台公告二级 1 18 启用 编辑 新增子分类 停用 删除
▶ 供应商公告二级 2 12 启用 编辑 新增子分类 停用 删除
▶ 分销商公告二级 3 8 启用 编辑 新增子分类 停用 删除
▶ 文章 (系统预置) 一级 2 — 启用 编辑 新增子分类
▶ 须知 (系统预置) 一级 3 — 启用 编辑 新增子分类
▼ 帮助 (系统预置) 一级 4 — 启用 编辑 新增子分类
▶ 新手指南二级 1 5 启用 编辑 新增子分类 停用 删除
▶ 常见问题二级 2 3 启用 编辑 新增子分类 停用 删除
▶ 操作手册二级 3 0 停用 编辑 新增子分类 启用 删除
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
基础管理 / 内容管理 / 内容发布 / 文章
文章标题
文章类型 全部 新闻
内容分类 全部 文章管理 平台新闻 行业动态
状态 全部 草稿 已上架 已下架
查询
重置
15B.3.2 文章编辑页
/platform/content/publish?tab=article&action=edit&id=123
基础管理 / 内容管理 / 内容发布 / 文章 / 编辑
文章标题 *
摘要
推送范围 :上架时可选择推送至供应商/分销商后台收件箱,通过站内信通知。
取消
保存草稿
上架
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 列表页原型
/platform/content/publish?tab=notice
基础管理 / 内容管理 / 内容发布 / 须知管理
须知管理 + 新增须知
须知标题
须知类型 全部 购买须知 出行须知 退改须知 安全须知 使用须知 其他
归属方 全部 平台 供应商
状态 全部 草稿 已发布 已下架
查询
重置
须知标题 类型 归属方 状态 绑定SPU数 发布时间 操作
景区门票购买注意事项 购买须知 平台 已发布 36 2026-08-10 09:00 编辑 下架 绑定管理
跟团游出行必备物品 出行须知 平台 已发布 12 2026-08-08 14:30 编辑 下架 绑定管理
酒店退改政策说明 退改须知 供应商A 草稿 0 — 编辑 发布 删除
高风险项目安全提示 安全须知 平台 已下架 0 2026-08-05 10:00 编辑 上架 删除
15C.2.1 列表页操作说明
操作 前置条件 交互方式 后端行为 异常处理
新增须知 有须知创建权限 点击「+ 新增须知」→ 弹出新建弹窗 — —
编辑 状态=草稿或已下架 点击行内「编辑」→ 弹出编辑弹窗 加载须知详情数据 数据加载失败时提示重试
发布 状态=草稿 点击行内「发布」→ 二次确认弹窗 敏感词校验 → 更新status=已发布,写入publish_time 敏感词命中时拦截并提示具体敏感词
下架 状态=已发布 点击行内「下架」→ 二次确认弹窗 更新status=已下架,写入offline_time;C端即时停止展示 —
上架 状态=已下架 点击行内「上架」→ 二次确认弹窗 敏感词校验 → 更新status=已发布 敏感词命中时拦截
删除 状态=草稿或已下架 点击行内「删除」→ 二次确认弹窗 逻辑删除须知记录;解除全部SPU绑定 —
绑定管理 状态=已发布 点击行内「绑定管理」→ 弹出SPU绑定管理弹窗 加载须知已绑定SPU列表 —
15C.3 新增/编辑须知弹窗
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 绑定管理弹窗原型
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 列表页原型
/platform/content/publish?tab=help
基础管理 / 内容管理 / 内容发布 / 帮助指南
帮助管理 + 新增帮助
帮助标题
帮助类型 全部 新手指南 常见问题 操作手册 规则说明
展示范围 全部 供应商 分销商
状态 全部 草稿 已发布 已下架
查询
重置
帮助标题 类型 展示范围 状态 置顶 发布时间 阅读率 操作
供应商入驻操作指南 新手指南 供应商 已发布 是 2026-08-10 09:00 72% 编辑 下架 阅读统计
订单退款流程说明 操作手册 全部 已发布 否 2026-08-08 14:30 58% 编辑 下架 阅读统计
佣金结算规则FAQ 常见问题 分销商 草稿 否 — — 编辑 发布 删除
平台运营规范说明 规则说明 全部 已下架 否 2026-08-05 10:00 31% 编辑 上架 删除
15D.2.1 列表页操作说明
操作 前置条件 交互方式 后端行为 异常处理
新增帮助 有帮助创建权限 点击「+ 新增帮助」→ 弹出新建弹窗 — —
编辑 状态=草稿或已下架 点击行内「编辑」→ 弹出编辑弹窗 加载帮助详情数据 数据加载失败时提示重试
发布 状态=草稿 点击行内「发布」→ 二次确认弹窗 敏感词校验 → 更新status=已发布,写入publish_time;分发至各端 敏感词命中时拦截并提示具体敏感词
下架 状态=已发布 点击行内「下架」→ 二次确认弹窗 更新status=已下架,写入offline_time;各端即时停止展示 —
上架 状态=已下架 点击行内「上架」→ 二次确认弹窗 敏感词校验 → 更新status=已发布 敏感词命中时拦截
置顶/取消置顶 状态=已发布 点击行内「置顶」/「取消置顶」 更新is_pinned字段;置顶时需填写排序值 —
删除 状态=草稿或已下架 点击行内「删除」→ 二次确认弹窗 逻辑删除帮助记录 —
阅读统计 状态=已发布 点击行内「阅读统计」→ 跳转阅读统计详情页 查询 t_help_read 聚合数据 → 渲染统计页面 —
15D.3 新增/编辑帮助弹窗
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
基础管理 / 内容管理 / 内容发布 / 帮助 / 阅读统计
供应商入驻操作指南 - 阅读统计 返回列表
用户类型 阅读人数 阅读次数 阅读率
供应商 86 245 72%
分销商 42 111 68%
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
只读说明 :供应商后台帮助列表不展示"新增帮助"按钮、不展示状态列和展示范围列(仅展示已发布内容)、不展示编辑/下架/删除/置顶等操作列。点击帮助标题可弹出详情弹窗查看全文内容。
15D.8.2 分销商后台帮助查看页
/distributor/content/help
内容管理 / 帮助
帮助中心
帮助标题 类型 发布时间
分销商推广操作指南 新手指南 2026-08-09 09:00
订单退款流程说明 操作手册 2026-08-08 14:30
佣金结算规则FAQ 常见问题 2026-08-06 10:00
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 详情
16.3.2 发送站内信弹窗
16.3.3 供应商/分销商后台 - 收件箱
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_message t_insite_message_read 站内信表中 send_mode='立即发送' AND send_time <= NOW() AND target_scope 匹配当前用户,且已读记录表中不存在该用户对该消息的已读记录
公告未读数 t_announcement t_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下拉面板
全局Header组件(三端共用)
未读消息(5)
按时间倒序
订单
您的订单 ORD20260810001 已支付成功
5分钟前
佣金
8月佣金结算完成,佣金金额¥3,256.00
昨天
查看全部消息
消息类型色标签 :面板内每条消息左侧显示类型色标签,复用站内信 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分钟 启用 编辑 停用 执行日志 测试
退款完成-通知双方 退款处理完成 订单相关方 站内信+短信 即时 停用 编辑 启用 执行日志
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时重定向到默认Tab P1
AC-039 须知管理 须知新增与发布 平台和供应商各自可创建须知;归属方自动识别;草稿发布时触发敏感词校验,通过后状态变更为已发布 P1
AC-040 须知管理 须知状态流转 须知状态按草稿→已发布→已下架流转,已下架可重新上架;草稿和已下架状态可删除,已发布不可编辑和删除 P1
AC-041 须知管理 SPU绑定管理 已发布须知可绑定SPU;同一须知不可重复绑定同一SPU;同一归属方同一类型须知不可重复绑定同一SPU;支持批量绑定和解绑 P1
AC-042 须知管理 数据隔离 供应商后台仅展示平台须知和本供应商须知;供应商不可查看其他供应商须知;供应商须知仅可绑定本供应商SPU P1
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与深度标准模板的深度等级要求。文档可直接交付研发实施。