Ruby Agent System PRD

Pop Up Notice

Pop Up Notice 功能 PRD,覆盖弹窗通知列表、日期范围、品牌/状态筛选和详情弹窗。

Pop Up Notice 用于查询弹窗类通知记录,并查看单条弹窗通知详情。

页面摘要

项目说明
页面性质弹窗通知记录查询页,当前只确认只读列表和详情弹窗
核心动作按 Date/Time、Brand、Status 查询弹窗通知,并打开详情弹窗查看内容
数据范围当前账号有权限查看的弹窗通知记录
当前状态列表、筛选、详情弹窗已定义;Add Domain 按设计错误处理,维护流程仍待确认

需求状态

状态内容
ConfirmedPop Up Notice 用于查询弹窗通知记录并查看详情,不定义用户端弹窗触发规则。
Inferred from Figma黄色 Add Domain 按设计错误处理,不纳入正式业务逻辑;Status 与时间关系按开放问题复核。
Open Question新增/编辑/删除/发布/停用、Status 命名、图片是否必填和移动端详情仍待确认,见 开放问题

1. Figma 原型

页面状态 Figma 截图

Notification

Notification - 1.1 Pop Up Notice 默认态

Pop Up Notice 默认列表,包含 Date/Time、Brand、Status 筛选,Search / Reset、黄色操作按钮、列表和分页。

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

Notification - 1.2 日期范围选择

点击 Date/Time 后展开双月日期范围选择器,支持起止日期、时间、Clear 和 Apply。

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

Notification - 1.3 Brand / Status 筛选

Brand 下拉显示 All、IKEA、Oh My God、The King+、W365;Status 下拉显示 All、Active、Inactive、Expiration。

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

Notification - 1.4 记录详情弹窗

点击 Popup Notice 记录后打开居中详情弹窗,背景遮罩置灰,弹窗展示标题、图片区域、正文和关闭按钮。

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

2. 概览

Pop Up Notice 是 Notification 模块中的弹窗通知查询页。它负责展示弹窗通知记录、按生效范围筛选记录、查看完整通知内容,不负责定义弹窗在用户端或其他业务页面的实际展示触发规则。

3. 页面组成

区域UI 表现对应功能说明
标签页导航Pop Up Notice 处于选中状态,旁边展示 One Line Notice Records、General Note、System Message标签页切换
筛选区Date/Time、Brand、Status、Search、Reset、黄色操作按钮筛选与查询
列表区Number、Brand、Title、Detail、Start Date、End Date列表字段
分页区Showing entries、每页条数、Previous、页码、Next分页
详情弹窗遮罩、标题、图片区域、正文、关闭按钮详情弹窗

4. 功能说明

4.1 标签页切换

点击其他标签页时进入对应子页面文档定义的通知类型列表。切换时不保留 Pop Up Notice 的筛选条件到其他通知类型。

4.2 筛选与查询

筛选项规则
Date/Time点击输入框打开双月日期范围选择器。选择起止日期和时间后点击 Apply 写入输入框;点击 Search 后才刷新列表。
Brand下拉展示 All 和当前账号可访问品牌,例如 IKEA、Oh My God、The King+、W365。
Status下拉展示 AllActiveInactiveExpiration。状态与 Start Date / End Date 的关系待确认。
Search按当前筛选条件刷新列表,并回到第 1 页。
Reset清空 Date/Time、Brand、Status,关闭已打开的下拉和日期选择器,恢复默认列表。

黄色操作按钮在 Figma 中显示为 Add Domain,当前按设计错误处理,不纳入正式业务逻辑。

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不能替代详情内容。
Start Date通知列表Confirmed弹窗开始生效日期。日期胶囊样式。No visible export entry状态计算候选字段。
End Date通知列表Confirmed弹窗结束生效日期。日期胶囊样式。No visible export entry状态计算候选字段。

4.5 分页

分页遵守共享表格规则。筛选条件变化后点击 Search 必须回到第 1 页;切换每页条数后同样回到第 1 页。

4.6 详情弹窗

元素规则
打开方式点击 Pop Up Notice 记录打开详情弹窗。
遮罩背景变暗,禁止操作底层列表。
标题展示弹窗通知标题。
图片区域展示通知图片或占位图;图片是否必填待确认。
正文区域展示完整通知内容,支持多段文本。
关闭按钮点击右上角关闭,回到列表并保留筛选、页码和滚动上下文。

详情弹窗只读,不提供编辑、删除或发布操作。

5. 业务规则

  • Pop Up Notice 只展示当前账号有权限查看的品牌通知。
  • Date/Time 查询口径必须明确是创建时间、生效时间还是展示时间;在未确认前,默认按生效时间筛选。
  • Active 表示当前时间处于通知有效期内;Inactive 表示未启用或暂停;Expiration 表示已过期,但命名需要设计确认。
  • 列表摘要不能替代详情内容;用户查看完整内容必须打开详情弹窗。
  • 详情弹窗关闭后不得重置筛选条件和分页。

6. 异常与空态

场景处理
无数据保留筛选区和表头,列表展示空态。
日期范围非法阻止查询,并提示用户修正日期范围。
品牌无权限不展示该品牌选项,也不返回该品牌记录。
详情加载失败保留弹窗,展示加载失败和重试入口。
图片不存在使用统一占位图,不影响标题和正文展示。

7. 开放问题

Pop Up Notice Figma 需补充 / 修正项

  • 右侧黄色按钮显示 Add Domain,与 Notification 不匹配;需要确认是否改为 Add NoticeAdd Pop Up Notice,或该入口不应出现在本页。
  • 详情弹窗使用占位图片和 lorem ipsum,需要补充真实字段:图片是否必填、正文长度、多语言字段、生效时间、所属品牌。
  • Date/Time 筛选需要确认查询的是创建时间、开始/结束生效时间,还是弹窗实际展示时间。
  • Status 中 Expiration 建议确认是否改为 Expired,并定义与 Start Date / End Date 的关系。
  • 当前未提供新增、编辑、删除、发布、停用、移动端详情弹窗原型;如需要实现,应补充 Figma。

本页目录