Ruby Agent System PRD

System Message

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

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

页面摘要

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

需求状态

状态内容
ConfirmedSystem Message 只查询系统自动生成的消息记录,不承担人工公告、弹窗通知或定向普通消息维护。
Inferred from FigmaFigma 有 Status 筛选但表格无状态列,默认不启用状态逻辑,待产品确认后补充。
Open QuestionCategory 口径、Status 是否启用、详情是否可点击、Read / Unread 字段和移动端状态仍待确认,见 开放问题

1. Figma 原型

页面状态 Figma 截图

Notification

Notification - 4.1 System Message 默认态

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

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

2. 概览

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

3. 页面组成

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

4. 功能说明

4.1 标签页切换

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

4.2 筛选与查询

筛选项规则
Date/Time查询指定时间范围内的系统消息,默认按 Shipping Date 筛选。
Brand按品牌过滤系统消息,默认 All
Category按系统消息分类过滤;分类口径待确认。
StatusFigma 展示了 Status 筛选,但表格未展示状态字段;默认不启用状态逻辑,待确认后补充。
Search按当前条件刷新列表并回到第 1 页。
Reset清空筛选并恢复默认列表。

4.3 列表表格级定义

项目定义
行粒度每一行代表一条通知记录。
汇总粒度无 Total 汇总行;分页总数代表当前筛选范围内的通知记录数。
默认排序默认排序未在 Figma 中明确;未确认前建议按发送或生效时间倒序。
数据范围受当前通知类型、筛选条件、品牌权限和当前账号数据范围限制。
父子 / 展开关系无展开子行;详情弹窗如存在,必须单独定义字段模型。
导出关系当前列表未展示导出入口;导出字段为 Open Question,不默认等于可见列。

4.4 列表字段模型

字段所在区域状态定义 / 口径展示规则导出备注
Number通知列表Visible in Figma当前页序号。当前页从 1 开始。No visible export entry不作为唯一标识。
Brand通知列表Confirmed系统消息所属品牌。品牌名称或标签。No visible export entry只显示有权限品牌。
Title通知列表Confirmed系统消息标题。文本展示,过长截断。No visible export entry分类口径待确认。
Detail通知列表Confirmed系统消息摘要或事件说明。文本展示,过长截断。No visible export entry是否可点开详情待确认。
Shipping Date通知列表Confirmed系统消息进入通知中心的时间。统一时间格式。No visible export entry默认筛选候选字段。

4.5 分页

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

5. 业务规则

  • System Message 仅展示系统自动生成的消息,不混入运营手动创建的公告或普通消息。
  • Shipping Date 是系统消息进入通知中心的时间。
  • 如果后续确认需要已读状态,应补充 Status 列、Reading Date 列、未读角标和标记已读规则。
  • Brand 筛选只能展示当前账号有权限访问的品牌。
  • 系统消息详情是否可点击打开,需要 Figma 补充后再定义。

6. 异常与空态

场景处理
无系统消息保留筛选区和表头,列表展示空态。
分类为空Category 下拉显示 All 或禁用。
查询失败保留上一成功数据和筛选条件,提示重试。
状态口径未确认不显示错误状态,按全量系统消息查询处理。

7. 开放问题

System Message Figma 需补充 / 修正项

  • System Message 标签页选中时,页面标题仍显示 General Note,需要修正为 System Message
  • 页面有 Status 筛选,但表格没有 Status / Reading Date 列;需要确认系统消息是否需要已读/未读状态。
  • Category 筛选存在,但表格没有 Category 列;需要确认分类是否应展示。
  • 当前没有点击记录查看详情、标记已读、批量处理、导出和移动端状态原型。

本页目录