Ruby Agent System PRD

Pop Up Notice

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

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

页面摘要

项目说明
页面性质弹窗通知记录查询页,定义只读列表和详情弹窗
核心动作按 Date/Time、Brand、Status 查询弹窗通知,并打开详情弹窗查看内容
数据范围当前账号有权限查看的弹窗通知记录
当前状态列表、筛选、详情弹窗已定义;右侧操作入口归属、维护流程、Status 命名、图片必填和详情字段以本页字段模型和业务规则为准

参考区

页面状态 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 证据摘要,不作为字段定义;字段口径、完整列、导出和权限规则以字段模型章节为准。

概览

Pop Up Notice 是 Notification 模块中的弹窗通知查询页。它负责展示弹窗通知记录、按生效范围筛选记录、查看完整通知内容,并定义代理商登录后有效弹窗通知的强制展示与已读关系。

功能规则

区域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分页
详情弹窗遮罩、标题、图片区域、正文、关闭按钮详情弹窗

功能地图

标签页切换

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

筛选与查询

筛选项规则
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,关闭已打开的下拉和日期选择器,恢复默认列表。

右侧操作入口不纳入 Pop Up Notice 查询范围;新增弹窗通知属于独立通知配置流程,不在本查询页内创建。本页只能出现通知查询、筛选和详情查看能力,不能跳转到 Domain Settings 或域名新增流程。

列表表格级定义

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

列表字段模型

字段所在区域定义 / 口径展示规则导出备注
Number通知列表当前页序号。当前页从 1 开始。不导出不作为唯一标识。
GUID / Record ID通知列表 / 详情数据弹窗通知唯一业务标识。如果作为可见列展示,使用可复制短文本;如果 Figma 未展示,也必须作为详情、已读和审计的后台字段存在。不导出不能用 Number 代替。
Brand通知列表弹窗通知所属品牌。品牌名称或标签。不导出只显示有权限品牌。
Title通知列表弹窗通知标题。文本展示,过长截断。不导出详情弹窗展示完整标题。
Detail通知列表弹窗正文摘要。列表中截断;详情弹窗展示完整内容。不导出不能替代详情内容。
Start Date通知列表弹窗开始生效日期。日期胶囊样式。不导出状态计算候选字段。
End Date通知列表弹窗结束生效日期。日期胶囊样式。不导出状态计算候选字段。

分页

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

详情弹窗

元素规则
打开方式点击 Pop Up Notice 记录打开详情弹窗。
遮罩背景变暗,禁止操作底层列表。
标题展示弹窗通知标题。
图片区域展示通知图片或占位图;图片默认非必填,除非通知类型要求图片。
正文区域展示完整通知内容,支持多段文本。
阅读结果用户打开并关闭详情后,该通知版本可标记为已读;已读结果需要同步 Top 未读角标。
关闭按钮点击右上角关闭,回到列表并保留筛选、页码和滚动上下文。

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

业务规则

  • Pop Up Notice 只展示当前账号有权限查看的品牌通知。

  • Date/Time 默认按公告生效时间筛选;创建时间和实际展示时间不作为本页筛选口径。

  • Active 表示当前时间处于通知有效期内;Inactive 表示未启用或暂停;Expiration 按本页默认文案统一为 Expired

  • 列表摘要不能替代详情内容;用户查看完整内容必须打开详情弹窗。

  • 详情弹窗关闭后不得重置筛选条件和分页。

  • Pop Up Notice 只能由运营后台或具备通知配置权限的系统流程创建,代理商前台不提供新增入口。

  • 登录后如果当前账号存在有效且未读的 Pop Up Notice,系统必须在进入业务页面前强制展示弹窗;同一通知版本已读或已关闭后,在当前版本内不再强制弹出。

  • Pop Up Notice 影响 Top 未读角标;用户读取或关闭当前通知版本后,未读数需要按 Notification 统一口径刷新。

  • Start Date / End Date 是弹窗生效窗口。End Date 后弹窗不再强制展示,也不再作为有效弹窗出现,但记录不自动删除,仍可在本页查询。

  • 右侧操作入口不属于 Pop Up Notice 查询页;新增 Pop Up Notice 使用独立通知配置流程。

  • 详情弹窗使用真实字段:图片为可选字段,正文按多语言内容展示,并显示生效时间和所属品牌。

  • Date/Time 筛选默认查询 Start Date / End Date 生效时间范围。

  • Status 中统一使用 Expired;当当前时间晚于 End Date 时进入过期状态。

  • 新增、编辑、删除、发布、停用不纳入 Pop Up Notice 查询页;如需要实现,放入独立通知配置流程。

页面特例

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

本页目录