feat: 顶部通知铃铛与站内通知中心

openspec/changes/add-notification-center/proposal.md

@@ -0,0 +1,46 @@
+# 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 通知数据和无效的空操作按钮将被真实通知数据及接口行为替换。