1003 B
1003 B
Notice Specification
Purpose
定义站内通知/公告域的行为:管理员发布公告,用户查看并追踪已读/未读。
Requirements
Requirement: 公告管理
系统 SHALL 支持管理员对通知做分页查询、新增、编辑、删除(软删回收唯一键)。
Scenario: 发布公告
- WHEN 管理员新增一条通知
- THEN 通知写入,status=enabled 时对本租户所有用户可见
Requirement: 用户通知与已读
系统 SHALL 支持当前用户分页查看可见通知(含已读状态)、查询未读数、标记单条/全部已读。
Scenario: 查看通知列表
- WHEN 用户查看通知
- THEN 返回其可见通知(status=enabled),未读的 readAt 为空
Scenario: 未读数
- WHEN 用户请求未读数
- THEN 返回 status=enabled 且当前用户未读的通知数
Scenario: 标记已读
- WHEN 用户标记某条或全部通知已读
- THEN 对应 notice_read 记录其 read_at