Ruby Agent System PRD

Global One Line Notice

全局顶部单行公告功能规则,覆盖维护公告、高优先级运营通知、显示规则和多语言规则。

Global One Line Notice 是登录后业务页面共用的全局顶部公告组件,用于展示系统维护、临时中断、财务风险或重要运营规则变更。Login 页面不展示该模块。

页面摘要

项目说明
页面性质登录后业务页面共用的全局顶部公告组件,不属于 Notification 记录列表
核心动作展示当前最高优先级有效公告,按配置决定文案、语言、有效期和可选跳转
数据范围后台公告配置、当前语言、当前登录页面和有效公告时间范围
当前状态单条有效公告的展示、隐藏、多语言和降级规则已定义;多公告优先级、关闭后记忆、过期规则、跳转目标和分品牌展示以本页字段模型和业务规则为准

参考区

页面状态 Figma 截图

Global / One Line Notice

Global / One Line Notice - One Line Notice 默认态

One Line Notice 使用高饱和红色横幅,在页面顶部集中提示系统维护或高优先级运营通知。

截图说明只作为 Figma 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

概览

Global One Line Notice 位于 Top 下方、页面面包屑或页签上方。它只承载高优先级通知,不用于普通营销文案、低优先级提示或页面内局部错误。

组件存在有效公告时展示;无有效公告时整体隐藏,不保留空白高度。

功能规则

功能地图只描述 UI 结构。显示条件、公告来源、点击行为和异常处理写在功能规则中。

元素UI 表现对应功能规则
公告容器高饱和红色横幅,横向铺满内容区公告容器
左侧图标白色通知图标公告图标
公告正文白色加粗文字,居中展示公告正文
右侧图标白色通知图标公告图标
可选跳转配置链接后整条公告可点击公告跳转

功能地图

公告容器

公告容器承载当前最高优先级的有效公告。

项目说明
显示位置位于 Top 下方,面包屑或页面页签上方。
显示条件当前存在有效 Global One Line Notice,并且当前页面不是 Login。
隐藏条件无有效公告、公告加载失败、当前页面是 Login。
布局规则展示时占用固定横幅高度;隐藏时不保留空白。
层级规则不遮挡 Top、侧边栏、面包屑、页签和页面主体内容。

公告图标

公告图标用于强化维护、告警或高优先级通知语义。

项目说明
图标位置公告正文左右两侧各展示一个白色通知图标。
功能定位只作为视觉强调,不单独承载点击行为。
响应式宽度不足时优先保留正文,图标可按产品规则缩减间距。
异常处理图标资源异常时不影响公告正文展示。

公告正文

公告正文展示当前生效公告的主要内容。

项目说明
内容来源后台公告配置。
公告类型系统维护、临时中断、财务风险、重要运营规则变更。
多语言支持中文、英文、韩文;当前语言缺失时按共享语言兜底规则展示。
长度规则默认单行静态展示;超长时截断,并通过详情、链接或提示查看完整内容,不能改变横幅高度。
更新规则页面刷新或轮询获取新公告后替换文案。

同一时间多条公告生效时,只展示一条。排序规则为:公告优先级 > 发布时间 > 公告类型。不能在同一横幅中堆叠多条公告。

本模块默认不使用跑马灯、循环滚动、显示次数、间隔时间或播放速度配置。运营后台如果后续新增动画配置,必须先补充动效规则、可读性限制和无障碍降级;在补充前,前端按静态单行公告实现。

公告跳转

公告默认不可点击。只有后台配置跳转目标时,整条公告才可点击。

项目说明
默认状态不可点击,仅展示公告内容。
可点击状态配置跳转链接后,鼠标悬停需要有明确 hover 状态。
内部跳转跳转到系统内页面时,需进入对应页面 PRD 定义的业务页面。
外部跳转打开外部链接时,需要遵守系统安全策略。
失败处理跳转失败时保留当前页面,并提示用户稍后重试。

业务规则

  • Global One Line Notice 是全局组件,除 Login 外,所有登录后业务页面都使用同一套显示规则。

  • 公告必须配置开始时间和结束时间;不在有效期内不得展示。

  • 公告内容必须来自后台配置,不允许前端写死固定维护文案。

  • 多语言文案必须按 共享规则 的语言兜底方式处理。

  • Global One Line Notice 可以来源于 Notification 下的 One Line Notice Records,但当前红色横幅本身不产生未读计数,也不计入 Top 右上角消息红点。

  • 高优先级公告展示期间,不应被普通页面提示、toast 或局部错误遮挡。

  • 无公告时组件完全隐藏,不影响页面顶部间距。

  • 多公告选择与关闭记忆: 同一时间多条公告生效时,只展示一条;默认排序为公告优先级、发布时间、公告类型。

  • 用户关闭公告后,默认在当前登录会话内记忆关闭状态;公告内容、语言或有效期变化后重新展示。

  • 公告过期后自动隐藏;配置跳转目标时整条公告可点击,未配置跳转目标时仅展示文本。

  • 分品牌公告默认只对当前账号有权限访问的品牌范围生效。

页面特例

场景处理
无有效公告不展示横幅,不保留占位。
公告加载失败不展示模拟公告;不中断用户当前页面操作。
当前语言缺失按语言兜底规则展示其他语言版本。
公告文案过长单行截断,并通过详情、链接或提示展示完整内容;默认不跑马灯。
跳转链接无效保留当前页面,提示稍后重试。
当前页面为 Login不展示 Global One Line Notice。

本页目录