feat: 完善接口19-顶部通知铃铛与站内通知中心

openspec/changes/add-admin-expiring-assets-notifications/proposal.md

@@ -0,0 +1,35 @@
+# Change: 增加管理端临期资产高亮、通知与续费入口
+
+## Why
+
+管理端目前缺少统一的临期资产查询入口，运营人员需要在普通资产列表中自行识别临近到期资产，且无法从临期记录快速进入续费操作。需要基于后端统一计算的预计最终到期结果，在管理端集中展示临期资产、标记普通列表并接入站内通知。
+
+## What Changes
+
+- 新增管理端临期资产列表，支持资产类型、关键字、店铺、套餐、剩余天数和预计到期时间筛选。
+- 临期列表按 0-3 天固定置顶，其余按预计最终到期时间升序；已过期和不可预计资产不进入列表。
+- 在卡列表、设备列表和资产相关列表中增加临期颜色高亮，但不改变普通列表原有排序。
+- 在代理首页增加临期卡数量和临期设备数量展示，并可跳转临期列表。
+- 在临期列表提供后端返回 `can_renew` 控制的续费入口，复用现有管理端续费/充值流程。
+- 接入通知中心中的 15 天、7 天、3 天临期提醒及通知跳转；管理端不展示企微临期消息。
+- 所有页面直接使用后端返回的预计最终到期字段和临期等级，不在前端重新计算最终到期时间。
+
+## Impact
+
+- Affected specs:
+  - `admin-expiring-assets`
+- Affected code:
+  - `src/api/modules` 和 `src/types/api` 中的临期资产接口及类型
+  - 管理端临期资产列表页面和路由
+  - 网卡列表、设备列表及资产信息展示组件
+  - 代理首页统计组件
+  - 通知中心跳转处理
+- API contracts:
+  - `GET /api/admin/expiring-assets`
+  - 现有代理首页/概览接口增加临期卡、设备数量字段，或提供等价的管理端统计响应
+  - 复用现有通知查询、已读和目标跳转接口
+- Out of scope:
+  - C 端资产页临期展示
+  - C 端续费按钮和 C 端续费流程
+  - 企微临期消息展示或企微通知改造
+  - 前端根据套餐明细自行推导预计最终到期时间