25 lines
2.2 KiB
Markdown
25 lines
2.2 KiB
Markdown
# 07 — 冻结后台与 C 端通知前端契约及验收包
|
||
|
||
**What to build:** 前端仓库获得稳定、框架无关的后台铃铛、最近通知抽屉、通知中心和个人客户简化列表契约，以及可执行的验收数据。前端可以实现 30 秒未读轮询、页面隐藏暂停、失败保留旧值、筛选和全部已读，并按“先已读、再解析受控目标”的顺序处理点击，而无需猜测类别、级别或后端目标路径。
|
||
|
||
**Blocked by:**
|
||
|
||
- 02 — 交付后台通知筛选、分类汇总与全部已读
|
||
- 03 — 向个人客户投递并提供简化通知中心
|
||
- 05 — 交付通知受控目标解析与权限复核
|
||
|
||
**Status:** ready-for-agent
|
||
|
||
**架构通道:** 主通道为 Query/API 跨仓契约，辅助通道为前端验收契约。
|
||
|
||
**完整业务边界:** 本票收口当前后端仓库能够交付的 OpenAPI、交互状态、目标白名单说明和验收数据，不在本仓库实现前端组件。明确不引入 WebSocket/SSE，不承诺 Redis 未读计数，不为未知目标提供自由 URL，也不代替前端仓库自身的组件测试。
|
||
|
||
- [ ] 契约明确布局挂载后立即请求、每 30 秒刷新、页面不可见暂停、恢复立即刷新，以及失败保留上次成功未读数且不闪回零。
|
||
- [ ] 徽标验收覆盖 0、1、99、100，0 时隐藏、1～99 显示数字、100 显示 `99+`，并约定固定宽度避免布局抖动。
|
||
- [ ] 后台抽屉按最近 10 条和约定分类展示，通知中心支持类别、类型、严重级别、已读状态、服务端分页及当前类别全部已读。
|
||
- [ ] 点击顺序固定为先进入已读视觉状态并调用已读接口，再解析受控目标；已读失败以下次服务端刷新为准，目标失败不恢复未读。
|
||
- [ ] 前端目标白名单只根据 `target_type` 和结构化标识构造内部路由，未知类型或 `available=false` 只展示正文且不跳转。
|
||
- [ ] C 端契约只展示当前客户相关的审批结果、套餐、订单和资产消息，不暴露后台同步或系统运维分类。
|
||
- [ ] OpenAPI、中文契约文档、示例响应与验收矩阵保持一致，并明确前端代码位于外部仓库、需按对应仓库流程实施和联调。
|
||
|