# Change: 顶部通知铃铛与站内通知中心 ## Why 当前顶部通知组件仍使用硬编码 mock 数据,通知按钮也未启用,运营人员无法统一查看余额预警、临期提醒、审批结果和系统告警。需要建立真实的站内通知数据链路,并在全局导航和通知中心之间保持未读状态同步。 ## What Changes - 在顶部全局导航的设置按钮与用户头像入口区域增加通知铃铛。 - 铃铛展示未读数量,统一格式为 `0`、`1`~`99` 或 `99+`。 - 点击铃铛展示最近 10 条通知抽屉,支持全部、审批、临期、同步/系统分类。 - 抽屉提供进入 `/notifications` 通知中心的入口。 - 新增通知中心页面,支持分类、通知类型、严重级别、已读状态筛选和全部已读。 - 点击通知时先调用标记已读接口,再根据受控 `ref_type` 获取目标并跳转;未知目标只展示通知正文,不执行任意 URL 跳转。 - 接入未读数、未读摘要、通知列表、单条已读和全部已读接口。 - 替换现有 `ArtNotification` 硬编码 mock 数据实现,并复用现有顶部布局和设置/头像区域的视觉位置。 ## Impact - Affected specs: - `notification-center` - Affected code: - `src/components/core/layouts/art-header-bar/index.vue` - `src/components/core/layouts/art-notification/index.vue` - `src/components/core/layouts/art-notification/style.scss` - `src/views/notifications/index.vue` - `src/api/modules/notification.ts` - `src/types/api/notification.ts` - 路由、菜单和通知相关权限配置 - API contracts: - `GET /api/admin/notifications/unread-count` - `GET /api/admin/notifications/unread-summary` - `GET /api/admin/notifications` - `PUT /api/admin/notifications/{id}/read` - `PUT /api/admin/notifications/read-all` - `GET /api/admin/notifications/{id}/target` - Dependencies: - 后端按当前用户返回通知数据、未读统计和受控跳转目标。 - 后端明确通知分类、类型、严重级别、已读状态和 `ref_type` 枚举。 - 目标接口不得返回可被前端直接执行的任意外部 URL。 - Out of scope: - C 端 `/api/c/v1/notifications` 接口和页面。 - 前端创建、编辑或删除通知。 - 浏览器推送、WebSocket 或轮询之外的实时推送机制。 - Breaking changes: - 现有 `ArtNotification` mock 通知数据和无效的空操作按钮将被真实通知数据及接口行为替换。