56 lines
2.8 KiB
Markdown
56 lines
2.8 KiB
Markdown
## ADDED Requirements
|
||
|
||
### Requirement: Notification queries SHALL preserve backend current-asset expiry scope
|
||
|
||
H5 SHALL 保持 `GET /api/c/v1/notifications` 与 `GET /api/c/v1/notifications/unread-count` 的现有入参,使用后端返回的当前资产临期通知及未读计数。H5 SHALL NOT 扩大范围查询所有资产、为这些接口新增未声明参数,或将普通通知一并误过滤为仅当前资产。
|
||
|
||
#### Scenario: Customer views asset A
|
||
|
||
- **WHEN** 客户在资产 A 的认证上下文读取列表和未读数
|
||
- **THEN** H5 SHALL 展示后端结果,其中临期提醒按 A 过滤
|
||
- **AND** SHALL NOT 混入资产 B 的旧列表或计数
|
||
|
||
#### Scenario: Current asset changes
|
||
|
||
- **WHEN** 当前认证资产由 A 切换为 B
|
||
- **THEN** H5 SHALL 刷新列表和未读数,防止 A 的延迟响应覆盖 B
|
||
|
||
### Requirement: Mark-all-read SHALL use PUT and preserve other assets' expiry notifications
|
||
|
||
H5 SHALL 在用户主动点击通知中心“全部已读”时调用 `PUT /api/c/v1/notifications/read-all`,SHALL NOT 发送 POST 或用不同方法重试。其他资产的临期通知 SHALL 由后端保留未读;客户端成功后 SHALL 按服务端刷新结果更新当前视图,失败 SHALL 保留未读状态。单条已读 SHALL 继续使用 `PUT /api/c/v1/notifications/{id}/read`。
|
||
|
||
#### Scenario: User marks all notifications read on asset A
|
||
|
||
- **WHEN** 客户在 A 上主动执行全部已读
|
||
- **THEN** H5 SHALL 发送 PUT 并对齐当前视图
|
||
- **AND** 资产 B 的临期通知 SHALL 保持未读
|
||
|
||
#### Scenario: Mark-all-read fails
|
||
|
||
- **WHEN** PUT 全部已读请求失败
|
||
- **THEN** H5 SHALL 不提前清空未读计数或把本地项全部标成已读,也不改用 POST 重试
|
||
|
||
#### Scenario: User reads one notification
|
||
|
||
- **WHEN** 用户执行单条已读操作
|
||
- **THEN** H5 SHALL 继续发送对应通知的 PUT 请求
|
||
|
||
#### Scenario: Reminder or popup is displayed
|
||
|
||
- **WHEN** 临期、运营候选或风险换货弹窗展示或关闭
|
||
- **THEN** H5 SHALL 不自动调用 read-all 来结束展示链路
|
||
|
||
### Requirement: Notification cards SHALL show a right-aligned read-status button
|
||
|
||
H5 SHALL 在通知标题右侧显示小型“未读/已读”按钮,SHALL NOT 用左侧强调边框或小圆点表示未读。点击卡片或按钮 SHALL 对未读项调用现有单条已读 PUT,成功后切换为“已读”并刷新计数;失败 SHALL 保留未读状态,已读项不重复请求。
|
||
|
||
#### Scenario: User taps an unread card
|
||
|
||
- **WHEN** 用户点击未读通知卡片或标题右侧“未读”按钮,标记接口成功
|
||
- **THEN** 小按钮 SHALL 切换为“已读”,卡片不新增左侧边框
|
||
|
||
#### Scenario: Mark-read fails
|
||
|
||
- **WHEN** 点击未读通知后标记接口失败
|
||
- **THEN** 小按钮 SHALL 保持“未读”,用户仍可再次操作
|