Files
one-pipe-system/openspec/changes/add-admin-expiring-assets-notifications/proposal.md
luo 9289a6e940
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 4m5s
feat: 完善接口19-顶部通知铃铛与站内通知中心
2026-07-25 10:20:53 +08:00

2.0 KiB

Change: 增加管理端临期资产高亮、通知与续费入口

Why

管理端目前缺少统一的临期资产查询入口,运营人员需要在普通资产列表中自行识别临近到期资产,且无法从临期记录快速进入续费操作。需要基于后端统一计算的预计最终到期结果,在管理端集中展示临期资产、标记普通列表并接入站内通知。

What Changes

  • 新增管理端临期资产列表,支持资产类型、关键字、店铺、套餐、剩余天数和预计到期时间筛选。
  • 临期列表按 0-3 天固定置顶,其余按预计最终到期时间升序;已过期和不可预计资产不进入列表。
  • 在卡列表、设备列表和资产相关列表中增加临期颜色高亮,但不改变普通列表原有排序。
  • 在代理首页增加临期卡数量和临期设备数量展示,并可跳转临期列表。
  • 在临期列表提供后端返回 can_renew 控制的续费入口,复用现有管理端续费/充值流程。
  • 接入通知中心中的 15 天、7 天、3 天临期提醒及通知跳转;管理端不展示企微临期消息。
  • 所有页面直接使用后端返回的预计最终到期字段和临期等级,不在前端重新计算最终到期时间。

Impact

  • Affected specs:
    • admin-expiring-assets
  • Affected code:
    • src/api/modulessrc/types/api 中的临期资产接口及类型
    • 管理端临期资产列表页面和路由
    • 网卡列表、设备列表及资产信息展示组件
    • 代理首页统计组件
    • 通知中心跳转处理
  • API contracts:
    • GET /api/admin/expiring-assets
    • 现有代理首页/概览接口增加临期卡、设备数量字段,或提供等价的管理端统计响应
    • 复用现有通知查询、已读和目标跳转接口
  • Out of scope:
    • C 端资产页临期展示
    • C 端续费按钮和 C 端续费流程
    • 企微临期消息展示或企微通知改造
    • 前端根据套餐明细自行推导预计最终到期时间