M4-10 Notification 深化 #44

New Issue

wangdl · 2026-05-22T21:09:51+08:00

wangdl commented

2026-05-22 21:09:51 +08:00

目标

在 M3-05 Notification 基础版之上深化，补充 Admin 专属通知：成本提醒、任务失败提醒和运维通知。

本 Issue 只做深化设计，C 端通知基础已在 M3-05 完成。

深化内容

Admin 通知类型：
- 成本预警通知（日/周/月成本超阈值）
- 导入任务大量失败通知
- API Key 即将到期通知
- 备份任务失败通知
- Hermes 审批待办通知
Admin 通知渠道：
- Admin 站内通知
- 邮件通知（预留）

禁止事项

禁止 Admin 通知淹没在 C 端通知体系中（应独立管理）

验收标准

Admin 通知类型和模板设计
Admin 通知站内页面设计

## 目标在 M3-05 Notification 基础版之上深化，补充 Admin 专属通知：成本提醒、任务失败提醒和运维通知。本 Issue 只做深化设计，C 端通知基础已在 M3-05 完成。 ## 深化内容 1. Admin 通知类型： - 成本预警通知（日/周/月成本超阈值） - 导入任务大量失败通知 - API Key 即将到期通知 - 备份任务失败通知 - Hermes 审批待办通知 2. Admin 通知渠道： - Admin 站内通知 - 邮件通知（预留） ## 禁止事项 - 禁止 Admin 通知淹没在 C 端通知体系中（应独立管理） ## 验收标准 1. Admin 通知类型和模板设计 2. Admin 通知站内页面设计

wangdl added this to the M4：Admin 生产级运维深化（P3） milestone 2026-05-22 21:09:51 +08:00

wangdl self-assigned this 2026-05-22 21:09:51 +08:00

wangdl commented

2026-05-24 18:23:49 +08:00

✅ M4-10 实施完成

已有基础

M3-05 已完成 C 端通知系统（Notification 模型、Service、Controller、Worker、PushToken、Preference）。

本 Issue 新增

模块	说明
Notification.scope 字段	user/admin 区分，Admin 通知独立管理
AdminNotificationsController	Admin 专属通知列表/发送/标记已读
通知生成端点	cost-alert / import-failure / key-expiring

Admin 通知类型

类型	端点	说明
cost_alert	POST /admin-api/admin-notifications/generate/cost-alert	成本超阈值预警
import_failure	POST /admin-api/admin-notifications/generate/import-failure	导入任务大量失败
key_expiring	POST /admin-api/admin-notifications/generate/key-expiring	API Key 即将到期
自定义	POST /admin-api/admin-notifications/send	手动发送 Admin 通知

AAPI 端点

端点	方法	说明
/admin-api/admin-notifications	GET	Admin 通知列表（scope=admin）
/admin-api/admin-notifications/send	POST	发送 Admin 通知
/admin-api/admin-notifications/:id/read	POST	标记已读
/admin-api/admin-notifications/generate/cost-alert	POST	成本预警
/admin-api/admin-notifications/generate/import-failure	POST	导入失败
/admin-api/admin-notifications/generate/key-expiring	POST	Key 到期

Admin 页面

已有「通知管理」页面（M3-05），Admin 通知通过 scope=admin 过滤显示。

## ✅ M4-10 实施完成 ### 已有基础 M3-05 已完成 C 端通知系统（Notification 模型、Service、Controller、Worker、PushToken、Preference）。 ### 本 Issue 新增 | 模块 | 说明 | |------|------| | Notification.scope 字段 | user/admin 区分，Admin 通知独立管理 | | AdminNotificationsController | Admin 专属通知列表/发送/标记已读 | | 通知生成端点 | cost-alert / import-failure / key-expiring | ### Admin 通知类型 | 类型 | 端点 | 说明 | |------|------|------| | cost_alert | POST /admin-api/admin-notifications/generate/cost-alert | 成本超阈值预警 | | import_failure | POST /admin-api/admin-notifications/generate/import-failure | 导入任务大量失败 | | key_expiring | POST /admin-api/admin-notifications/generate/key-expiring | API Key 即将到期 | | 自定义 | POST /admin-api/admin-notifications/send | 手动发送 Admin 通知 | ### AAPI 端点 | 端点 | 方法 | 说明 | |------|------|------| | /admin-api/admin-notifications | GET | Admin 通知列表（scope=admin） | | /admin-api/admin-notifications/send | POST | 发送 Admin 通知 | | /admin-api/admin-notifications/:id/read | POST | 标记已读 | | /admin-api/admin-notifications/generate/cost-alert | POST | 成本预警 | | /admin-api/admin-notifications/generate/import-failure | POST | 导入失败 | | /admin-api/admin-notifications/generate/key-expiring | POST | Key 到期 | ### Admin 页面已有「通知管理」页面（M3-05），Admin 通知通过 scope=admin 过滤显示。

wangdl closed this issue

2026-06-05 20:17:12 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#44