36 lines
2.0 KiB
Markdown
36 lines
2.0 KiB
Markdown
# 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 端续费流程
|
|
- 企微临期消息展示或企微通知改造
|
|
- 前端根据套餐明细自行推导预计最终到期时间
|