wangdl/api-server
2
0
Fork 0
Code Issues 45 Pull Requests Actions Packages Projects Releases Wiki Activity

M4-01 Admin Dashboard Module #35

New Issue
Open
opened 2026-05-22 21:09:50 +08:00 by wangdl · 0 comments
wangdl commented 2026-05-22 21:09:50 +08:00
Owner
Copy Link

目标

设计知习 Admin 总控台首页模块，为 Admin 提供关键指标聚合视图、服务器摘要、待处理事项和 Hermes 待审批任务入口。

本 Issue 只做模块架构设计，不直接实现代码。

背景说明

Admin 登录后需要一个总览页面快速了解系统状态。Dashboard 不产生数据，只通过各模块的 QueryService 聚合数据展示。

模块职责

  1. 本模块负责：

    • 关键指标卡片（今日成本、今日导入任务数、活跃用户数、系统健康状态）
    • 服务器状态摘要（来自 Server Monitor）
    • 失败任务摘要（来自 Task Queue）
    • 即将到期服务提醒（来自 Secret & Vendor Asset）
    • Hermes 待审批任务摘要
    • 最近发布记录（来自 Release & Decision）

  2. 本模块不负责：

    • 各指标的数据采集（由各模块负责）
    • 具体管理操作（链接到对应 Admin 模块）

候选数据对象

  • DashboardMetric（聚合指标，可能来自缓存或实时查询）
  • SystemSummary
  • OpsAlert（运维提醒汇总）

基础设施依赖

纯视图聚合层，通过各模块 QueryService 读取 + Cache 缓存。

API 设计

AAPI：

  • Dashboard 聚合数据接口
  • 刷新缓存

Admin 视图设计

Dashboard 首页布局：

  • 顶栏：关键指标卡片行
  • 中间：任务状态概览 + 即将到期提醒
  • 侧栏：Hermes 待审批 + 最近发布记录

禁止事项

  • 禁止 Dashboard 直接查询各模块数据库（必须通过 QueryService）
  • 禁止 Dashboard 数据实时全量计算（应缓存，定时刷新）

不建议当前阶段实现

  • 可自定义的 Dashboard Widget
  • 实时 WebSocket 数据推送
## 目标 设计知习 Admin 总控台首页模块，为 Admin 提供关键指标聚合视图、服务器摘要、待处理事项和 Hermes 待审批任务入口。 本 Issue 只做模块架构设计，不直接实现代码。 ## 背景说明 Admin 登录后需要一个总览页面快速了解系统状态。Dashboard 不产生数据，只通过各模块的 QueryService 聚合数据展示。 ## 模块职责 1. 本模块负责： - 关键指标卡片（今日成本、今日导入任务数、活跃用户数、系统健康状态） - 服务器状态摘要（来自 Server Monitor） - 失败任务摘要（来自 Task Queue） - 即将到期服务提醒（来自 Secret & Vendor Asset） - Hermes 待审批任务摘要 - 最近发布记录（来自 Release & Decision） 2. 本模块不负责： - 各指标的数据采集（由各模块负责） - 具体管理操作（链接到对应 Admin 模块） ## 候选数据对象 - DashboardMetric（聚合指标，可能来自缓存或实时查询） - SystemSummary - OpsAlert（运维提醒汇总） ## 基础设施依赖 纯视图聚合层，通过各模块 QueryService 读取 + Cache 缓存。 ## API 设计 AAPI： - Dashboard 聚合数据接口 - 刷新缓存 ## Admin 视图设计 Dashboard 首页布局： - 顶栏：关键指标卡片行 - 中间：任务状态概览 + 即将到期提醒 - 侧栏：Hermes 待审批 + 最近发布记录 ## 禁止事项 - 禁止 Dashboard 直接查询各模块数据库（必须通过 QueryService） - 禁止 Dashboard 数据实时全量计算（应缓存，定时刷新） ## 不建议当前阶段实现 - 可自定义的 Dashboard Widget - 实时 WebSocket 数据推送
wangdl added this to the M4：Admin 生产级运维深化（P3） milestone 2026-05-22 21:09:50 +08:00
wangdl self-assigned this 2026-05-22 21:09:50 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone M4：Admin 生产级运维深化（P3）
Projects
Clear projects
No project
Assignees
Clear assignees
suyun-Claude wangdl
No Assignees wangdl
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: wangdl/api-server#35
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?