Ruby Agent System PRD

General Note

General Note 功能 PRD,覆盖定向普通消息查询、Recipient 搜索、已读状态和阅读时间。

General Note 用于查询定向普通消息,重点关注发送人、接收人、标题、已读状态、发送时间和阅读时间。

页面摘要

项目说明
页面性质定向普通消息记录查询页,新增、编辑或主动标记已读流程不纳入当前范围
核心动作按 Date/Time、Recipient、Category、Status 查询消息并核对发送人、接收人、标题和阅读时间
数据范围当前账号有权限查看的普通消息记录和阅读状态
当前状态列表、筛选和分页已定义;标题示例、Recipient 搜索字段和 Category 口径以本页字段模型和业务规则为准

参考区

页面状态 Figma 截图

Notification

Notification - 3.1 General Note 默认态

General Note 列表包含 Recipient 输入、Category / Status 筛选,以及 Sender、Recipient、Title、Status、Shipping Date、Reading Date 表格。

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

概览

General Note 是面向具体接收人的通知记录列表。它用于追踪消息是否已发送、是否已读以及阅读时间,不承担系统事件日志或全局公告展示职责。

功能规则

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

功能地图

标签页切换

切换通知类型时不继承 Recipient 搜索条件,避免定向消息条件污染其他通知列表。

筛选与查询

筛选项规则
Date/Time查询指定时间范围内的普通消息。默认按发送时间筛选;阅读时间筛选不纳入当前范围。
Recipient输入接收人账号、用户 ID 或昵称进行查询;具体支持字段以本页字段模型和业务规则为准。
Category按消息分类过滤,分类口径以本页字段模型和业务规则为准。
Status按 Read / Unread 筛选阅读状态。
Search按当前条件刷新列表并回到第 1 页。
Reset清空 Date/Time、Recipient、Category、Status,恢复默认列表。

列表表格级定义

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

列表字段模型

字段所在区域定义 / 口径展示规则导出备注
Number通知列表当前页序号。当前页从 1 开始。不导出不作为唯一标识。
GUID / Record ID通知列表 / 详情数据普通消息唯一业务标识。如果作为可见列展示,使用可复制短文本;Figma 未展示时仍作为后台字段存在。不导出用于详情、已读、审计和去重,不能用 Number 代替。
Brand通知列表消息所属品牌。品牌名称或标签。不导出受品牌权限限制。
Sender通知列表发送人账号或名称。文本展示。不导出发送人类型以本页字段模型和业务规则为准。
Recipient通知列表接收人账号、用户 ID 或昵称。文本展示。不导出具体搜索字段以本页字段模型和业务规则为准。
Title通知列表消息标题。当前语言标题,过长截断。不导出多语言缺失按共享回退规则。
Status通知列表接收人的阅读状态。Read 绿色标签,Unread 橙色标签。不导出不表示发送成功与否。
Shipping Date通知列表消息发送时间。统一时间格式。不导出默认筛选候选字段。
Reading Date通知列表用户阅读时间。未读时展示统一空值。不导出不得填充模拟时间。

分页

分页遵守共享表格规则。筛选后回到第 1 页,避免无数据页。

业务规则

  • General Note 只展示当前账号有权限查看的定向消息。

  • General Note 用于运营或系统向指定代理商 / 账号发送定向普通消息。Sender 是发起方账号、角色或系统名称,Recipient 是接收方账号、用户 ID 或昵称。

  • Read / Unread 只表示接收人是否阅读,不表示发送是否成功。

  • 未读消息不得填充模拟 Reading Date。

  • Recipient 搜索必须限定在当前账号权限范围内,不能通过模糊搜索泄露无权限用户。

  • 如果消息支持多语言,列表标题应展示当前语言版本;缺失时按共享国际化回退规则处理。

  • Title 使用消息标题字段,按当前语言展示,过长截断;详情入口展示完整内容。

  • Recipient 输入默认支持账号或用户 ID 精确搜索,不包含昵称、代理商 ID 和模糊搜索。

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

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

页面特例

场景处理
Recipient 无匹配保留筛选条件,列表展示空态。
未读消息Reading Date 留空或显示统一占位。
查询失败保留上一成功数据和筛选条件,提示重试。
无权限接收人不返回记录,不提示具体是否存在该用户。

本页目录