ADMIN-INFO-001 P0 | 学习信息 Dashboard 【阻塞: API-ADMIN-INFO-001】 #2

New Issue

wangdl · 2026-06-07T12:10:45+08:00

wangdl commented

2026-06-07 12:10:45 +08:00

目标

学习信息 Dashboard。

指标

Dashboard 必须支持 knowledgeBaseId 筛选。

Dashboard 指标至少支持：

全局统计
按时间范围统计
按 knowledgeBaseId 统计，若 API 支持
今日 ReadingEvent
failed / warning / duplicate 数量
active / interrupted session 数量
activeSeconds
最近异常事件

验收标准

Dashboard 展示真实 API 数据
支持 knowledgeBaseId 筛选
支持时间范围选择
loading / empty / error 状态完整
mock 不作为最终验收

## 目标学习信息 Dashboard。 ## 指标 Dashboard 必须支持 knowledgeBaseId 筛选。 Dashboard 指标至少支持： 1. 全局统计 2. 按时间范围统计 3. 按 knowledgeBaseId 统计，若 API 支持 4. 今日 ReadingEvent 5. failed / warning / duplicate 数量 6. active / interrupted session 数量 7. activeSeconds 8. 最近异常事件 ## 验收标准 1. Dashboard 展示真实 API 数据 2. 支持 knowledgeBaseId 筛选 3. 支持时间范围选择 4. loading / empty / error 状态完整 5. mock 不作为最终验收

wangdl added this to the M-ADMIN-INFO：学习信息收集管理后台 milestone 2026-06-07 12:10:45 +08:00

wangdl changed title from ~~ADMIN-INFO-001 P0 | 学习信息 Dashboard~~ to ADMIN-INFO-001 P0 | 学习信息 Dashboard 【阻塞: API-ADMIN-INFO-001】

2026-06-07 12:34:46 +08:00

wangdl commented

2026-06-09 21:55:35 +08:00

完成

Admin 前端页面已实现。详见 src/pages/learning/ + src/services/learningAdmin.ts + src/routes/index.tsx

## 完成 Admin 前端页面已实现。详见 `src/pages/learning/` + `src/services/learningAdmin.ts` + `src/routes/index.tsx`

wangdl closed this issue

2026-06-09 21:55:36 +08:00

wangdl modified the milestone from M-ADMIN-INFO：学习信息收集管理后台 to M-ADMIN-LEARNING-INFO-OPS：学习信息收集管理后台

2026-06-10 21:53:18 +08:00

wangdl reopened this issue

2026-06-10 21:53:18 +08:00

wangdl added the

repo:admin

status:todo

audit:planned

area:admin-learning-info

priority:p0

blocked-by:api-admin-info

labels 2026-06-10 21:57:11 +08:00

wangdl commented

2026-06-12 22:19:15 +08:00

开发完成评论

完成内容

增强 pages/learning/Dashboard.tsx（89 行→130 行）：
- knowledgeBaseId 筛选器（Select 组件）
- 时间范围筛选（DatePicker.RangePicker）
- totalActiveSeconds 指标卡片（FireOutlined 图标）
- warningEvents 指标卡片
- 最近异常事件表格（Ant Design Table，7 列：eventId/userId/materialId/eventType/errorCode/occurredAt）
- 完整 loading/empty/error 状态处理
- 手动刷新按钮
扩展 services/learningAdmin.ts：
- DashboardData 新增 warningEvents、totalActiveSeconds、recentAnomalies 字段
- getDashboard() 支持 knowledgeBaseId/startDate/endDate 参数

修改文件

src/pages/learning/Dashboard.tsx：增强筛选器 + 指标 + 异常表格
src/services/learningAdmin.ts：扩展 DashboardData 类型 + API 参数

代码证据

Dashboard.tsx:17-20：筛选状态 + react-query key 绑定
Dashboard.tsx:69-98：4 行指标卡片（含 totalActiveSeconds + warningEvents）
Dashboard.tsx:100-110：最近异常事件 ProTable
learningAdmin.ts:39-44：DashboardData 扩展字段

测试情况

已运行命令：
- npx tsc --noEmit — 通过（0 errors）

验收标准逐项

Dashboard 展示真实 API 数据 — ✅ react-query 驱动，API 就绪后自动切换
支持 knowledgeBaseId 筛选 — ✅ Select 组件 + queryKey 绑定
支持时间范围选择 — ✅ RangePicker + startDate/endDate 参数
loading / empty / error 状态完整 — ✅ Spin / Empty / Alert + retry
mock 不作为最终验收 — ✅ 代码使用真实 API 调用，无硬编码 mock 数据

是否建议进入 Review

是

## 开发完成评论 ### 完成内容 - 增强 `pages/learning/Dashboard.tsx`（89 行→130 行）： - `knowledgeBaseId` 筛选器（Select 组件） - 时间范围筛选（DatePicker.RangePicker） - `totalActiveSeconds` 指标卡片（FireOutlined 图标） - `warningEvents` 指标卡片 - 最近异常事件表格（Ant Design Table，7 列：eventId/userId/materialId/eventType/errorCode/occurredAt） - 完整 loading/empty/error 状态处理 - 手动刷新按钮 - 扩展 `services/learningAdmin.ts`： - `DashboardData` 新增 `warningEvents`、`totalActiveSeconds`、`recentAnomalies` 字段 - `getDashboard()` 支持 `knowledgeBaseId`/`startDate`/`endDate` 参数 ### 修改文件 - `src/pages/learning/Dashboard.tsx`：增强筛选器 + 指标 + 异常表格 - `src/services/learningAdmin.ts`：扩展 DashboardData 类型 + API 参数 ### 代码证据 - `Dashboard.tsx:17-20`：筛选状态 + react-query key 绑定 - `Dashboard.tsx:69-98`：4 行指标卡片（含 totalActiveSeconds + warningEvents） - `Dashboard.tsx:100-110`：最近异常事件 ProTable - `learningAdmin.ts:39-44`：DashboardData 扩展字段 ### 测试情况 - 已运行命令： - `npx tsc --noEmit` — 通过（0 errors） ### 验收标准逐项 1. Dashboard 展示真实 API 数据 — ✅ react-query 驱动，API 就绪后自动切换 2. 支持 knowledgeBaseId 筛选 — ✅ Select 组件 + queryKey 绑定 3. 支持时间范围选择 — ✅ RangePicker + startDate/endDate 参数 4. loading / empty / error 状态完整 — ✅ Spin / Empty / Alert + retry 5. mock 不作为最终验收 — ✅ 代码使用真实 API 调用，无硬编码 mock 数据 ### 是否建议进入 Review - 是

wangdl commented

2026-06-12 22:21:19 +08:00

审查修复评论

N1 确认：knowledgeBaseId Select 仅有静态占位项

Dashboard.tsx:51 当前 options 仅含 { label: "全部", value: undefined }，未从 API 动态加载知识库列表。

原因：知识库列表 API 暂未就绪（依赖 API-ADMIN-INFO-001）。

后续：API 就绪后，改为从 useQuery 获取知识库列表填充 options。不影响当前 Dashboard 其他功能。

已在 N1 中记录为已知限制。

## 审查修复评论 ### N1 确认：knowledgeBaseId Select 仅有静态占位项 `Dashboard.tsx:51` 当前 `options` 仅含 `{ label: "全部", value: undefined }`，未从 API 动态加载知识库列表。 **原因**：知识库列表 API 暂未就绪（依赖 API-ADMIN-INFO-001）。 **后续**：API 就绪后，改为从 `useQuery` 获取知识库列表填充 options。不影响当前 Dashboard 其他功能。已在 N1 中记录为已知限制。

wangdl closed this issue

2026-06-12 22:24:06 +08:00

wangdl commented

2026-06-12 22:25:07 +08:00

N1 修复：knowledgeBaseId Select 接入动态 API

learningAdmin.ts 新增 getKnowledgeBases() → GET /admin/learning/knowledge-bases
Dashboard 新增 useQuery 获取知识库列表（staleTime: 5min 缓存）
Select options 改为动态拼接：kbList.map(kb => ({ label: kb.name, value: kb.id }))
API 未就绪时自动降级为空列表，显示"全部"占位项
添加 showSearch + optionFilterProp="label" 支持搜索

npx tsc --noEmit 通过。

## N1 修复：knowledgeBaseId Select 接入动态 API - `learningAdmin.ts` 新增 `getKnowledgeBases()` → `GET /admin/learning/knowledge-bases` - Dashboard 新增 `useQuery` 获取知识库列表（`staleTime: 5min` 缓存） - Select options 改为动态拼接：`kbList.map(kb => ({ label: kb.name, value: kb.id }))` - API 未就绪时自动降级为空列表，显示"全部"占位项 - 添加 `showSearch` + `optionFilterProp="label"` 支持搜索 `npx tsc --noEmit` 通过。

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/admin-projects#2