Ruby Agent System PRD

System Message

System Message 功能 PRD,覆盖系统自动消息查询、筛选、列表字段和当前 Figma 缺口。

System Message 用于查询系统自动产生的消息记录,例如登录提示、审批提醒、系统事件通知。

页面摘要

项目说明
页面性质系统自动消息记录查询页,人工创建或编辑流程不纳入当前范围
核心动作按 Date/Time、Brand、Category、Status 查询系统消息并核对标题、摘要和发送时间
数据范围当前账号有权限查看的系统消息记录
当前状态只读列表已定义;Status 筛选、Category 口径和详情行为以本页字段模型和业务规则为准

参考区

页面状态 Figma 截图

Notification

Notification - 4.1 System Message 默认态

System Message 标签页展示系统消息列表,包含 Date/Time、Brand、Category、Status 筛选和 Number、Brand、Title、Detail、Shipping Date 表格。

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

概览

System Message 是系统事件消息查询页。它负责展示系统自动生成的消息标题、摘要和发送时间,不承担人工公告、弹窗通知或定向普通消息的创建与维护。

功能规则

区域UI 表现对应功能规则
标签页导航System Message 处于选中状态标签页切换
筛选区Date/Time、Brand、Recipient、Category、Status、Search、Reset筛选与查询
列表区Number、Brand、Recipient、Title、Detail、Shipping Date列表字段
分页区每页条数、页码和上一页/下一页分页

功能地图

标签页切换

System Message 与其他通知类型共享标签页导航。切换到其他标签页时,不保留当前页面内部筛选条件。

筛选与查询

筛选项规则
Date/Time查询指定时间范围内的系统消息,默认按 Shipping Date 筛选。
Brand按品牌过滤系统消息,默认 All
Recipient按接收人账号或用户 ID 精确查询;默认为空时查询当前账号权限范围内可见的系统消息。
Category按系统消息分类字典过滤;默认不在列表中额外展示 Category 列。
StatusFigma 展示了 Status 筛选,但表格未展示状态字段;默认不启用状态逻辑。
Search按当前条件刷新列表并回到第 1 页。
Reset清空筛选并恢复默认列表。

列表表格级定义

项目定义
行粒度每一行代表一条通知记录。
汇总粒度无 Total 汇总行;分页总数代表当前筛选范围内的通知记录数。
默认排序默认按发送或生效时间倒序。
数据范围受当前通知类型、筛选条件、品牌权限和当前账号数据范围限制。
父子 / 展开关系无展开子行;详情弹窗如存在,必须单独定义字段模型。
导出关系当前页面未提供导出入口;默认不导出。若后续新增导出入口,按当前筛选、字段模型和权限脱敏规则导出,选择列、操作列、按钮入口和内部字段不导出。

列表字段模型

字段所在区域定义 / 口径展示规则导出备注
Number通知列表当前页序号。当前页从 1 开始。不导出不作为唯一标识。
GUID / Record ID通知列表 / 详情数据系统消息唯一业务标识。如果作为可见列展示,使用可复制短文本;Figma 未展示时仍作为后台字段存在。不导出用于详情、审计和去重,不能用 Number 代替。
Brand通知列表系统消息所属品牌。品牌名称或标签。不导出只显示有权限品牌。
Recipient通知列表 / 筛选数据系统消息接收人账号、用户 ID 或系统可展示名称。列表默认可隐藏;如果显示,按权限脱敏。不导出Recipient 筛选使用精确匹配,不能暴露无权限用户是否存在。
Title通知列表系统消息标题。文本展示,过长截断。不导出标题与系统消息分类字典保持一致。
Detail通知列表系统消息摘要或事件说明。文本展示,过长截断;点击后打开只读详情弹窗。不导出无详情内容时只展示摘要文本。
Shipping Date通知列表系统消息进入通知中心的时间。统一时间格式。不导出默认筛选候选字段。

分页

分页遵守共享表格规则。筛选后回到第 1 页;无数据时保留表头和筛选条件。

业务规则

  • System Message 仅展示系统自动生成的消息,不混入运营手动创建的公告或普通消息。

  • Shipping Date 是系统消息进入通知中心的时间。

  • System Message 不启用已读状态,不展示 Status 列、Reading Date 列、未读角标或标记已读操作。

  • Brand 筛选只能展示当前账号有权限访问的品牌。

  • Recipient 筛选只在权限范围内查询,不返回或暗示无权限接收人是否存在。

  • 系统消息支持只读详情查看;详情不改变已读状态,也不提供回复或批量操作。

  • System Message 标题使用系统消息标题字段,详情入口独立于 General Note。

  • 页面保留 Status 筛选,但表格默认不展示 Status / Reading Date,System Message 不启用已读 / 未读状态。

  • Category 筛选保留,但表格默认不展示 Category 列。

  • 详情查看为只读;标记已读、批量处理和导出默认不纳入本页操作范围。

页面特例

场景处理
无系统消息保留筛选区和表头,列表展示空态。
分类为空Category 下拉显示 All 或禁用。
查询失败保留上一成功数据和筛选条件,提示重试。
状态口径以本页字段模型和业务规则为准不显示错误状态,按全量系统消息查询处理。

本页目录