General Note
General Note 功能 PRD,覆盖定向普通消息查询、Recipient 搜索、已读状态和阅读时间。
General Note 用于查询定向普通消息,重点关注发送人、接收人、标题、已读状态、发送时间和阅读时间。
页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | 定向普通消息记录查询页,新增、编辑或主动标记已读流程不纳入当前范围 |
| 核心动作 | 按 Date/Time、Recipient、Category、Status 查询消息并核对发送人、接收人、标题和阅读时间 |
| 数据范围 | 当前账号有权限查看的普通消息记录和阅读状态 |
| 当前状态 | 列表、筛选和分页已定义;标题示例、Recipient 搜索字段和 Category 口径以本页字段模型和业务规则为准 |
参考区
页面状态 Figma 截图
Notification

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 留空或显示统一占位。 |
| 查询失败 | 保留上一成功数据和筛选条件,提示重试。 |
| 无权限接收人 | 不返回记录,不提示具体是否存在该用户。 |