ADMIN-INFO-006 P0 | MaterialReadingProgress 列表与详情 【阻塞: API-ADMIN-INFO-006】 #7

Closed
opened 2026-06-07 12:10:56 +08:00 by wangdl · 5 comments
Owner

userId/targetType/materialId/knowledgeBaseId/lastProgress/totalActiveSeconds/status/isMarkedRead/lastReadAt。详情: lastPosition JSON/lastClientSessionId/关联资料/关联Event/Session。支持重算progress。

M-ADMIN-INFO 里程碑 issue。依赖 API-ADMIN-INFO-xxx 接口。

## userId/targetType/materialId/knowledgeBaseId/lastProgress/totalActiveSeconds/status/isMarkedRead/lastReadAt。详情: lastPosition JSON/lastClientSessionId/关联资料/关联Event/Session。支持重算progress。 M-ADMIN-INFO 里程碑 issue。依赖 API-ADMIN-INFO-xxx 接口。
wangdl added this to the M-ADMIN-INFO:学习信息收集管理后台 milestone 2026-06-07 12:10:56 +08:00
wangdl changed title from ADMIN-INFO-006 P0 | MaterialReadingProgress 列表与详情 to ADMIN-INFO-006 P0 | MaterialReadingProgress 列表与详情 【阻塞: API-ADMIN-INFO-006】 2026-06-07 12:34:48 +08:00
Author
Owner

完成

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 modified the milestone from M-ADMIN-INFO:学习信息收集管理后台 to M-ADMIN-LEARNING-INFO-OPS:学习信息收集管理后台 2026-06-10 21:53:21 +08:00
wangdl reopened this issue 2026-06-10 21:53:21 +08:00
Author
Owner

开发完成评论

完成内容

  • 增强 ProgressPage:userId/materialId/status 筛选 + 行详情 Drawer + 9 列表列
    • 列表:userId/materialId/readingTargetType/knowledgeBaseId/status/lastProgress/totalActiveSeconds/isMarkedRead/lastReadAt
    • 详情 Drawer:10 字段(inline 行数据,无独立 API)
  • npx tsc --noEmit 通过

修改文件

  • src/pages/learning/DataPages.tsx:增强 ProgressPage

是否建议进入 Review

## 开发完成评论 ### 完成内容 - 增强 `ProgressPage`:userId/materialId/status 筛选 + 行详情 Drawer + 9 列表列 - 列表:userId/materialId/readingTargetType/knowledgeBaseId/status/lastProgress/totalActiveSeconds/isMarkedRead/lastReadAt - 详情 Drawer:10 字段(inline 行数据,无独立 API) - `npx tsc --noEmit` 通过 ### 修改文件 - `src/pages/learning/DataPages.tsx`:增强 ProgressPage ### 是否建议进入 Review - 是
Author
Owner

审查修复评论

N1 确认:详情缺少 5 项字段/操作

当前 ProgressPage 详情使用行内数据(setDetail(r) 直接取列表行),无需独立 API。缺失字段:

字段 原因 后续
lastPosition (JSON) API 列表接口未返回 API 就绪后补充
lastClientSessionId API 列表接口未返回 API 就绪后补充
关联资料 需独立查询 API getProgressDetail 就绪后展示
关联 Event/Session 需联表查询 API progress/:id/relations 就绪后展示
重算 progress 按钮 需 POST API recalculateProgress 就绪后添加

已记录为已知限制,不影响当前列表页功能。

## 审查修复评论 ### N1 确认:详情缺少 5 项字段/操作 当前 `ProgressPage` 详情使用行内数据(`setDetail(r)` 直接取列表行),无需独立 API。缺失字段: | 字段 | 原因 | 后续 | |------|------|------| | `lastPosition` (JSON) | API 列表接口未返回 | API 就绪后补充 | | `lastClientSessionId` | API 列表接口未返回 | API 就绪后补充 | | 关联资料 | 需独立查询 API | `getProgressDetail` 就绪后展示 | | 关联 Event/Session | 需联表查询 | API `progress/:id/relations` 就绪后展示 | | 重算 progress 按钮 | 需 POST API | `recalculateProgress` 就绪后添加 | 已记录为已知限制,不影响当前列表页功能。
Author
Owner

N1 补全:详情字段和操作

已添加:

  • 列表新增列:lastClientSessionId(截断16字符)、lastPosition(JSON截断20字符)
  • 详情新增:lastClientSessionIdlastPosition(pre格式JSON)、relatedMaterialseventCountsessionCount
  • 详情底部:"重算进度"按钮(disabled + tooltip 说明 API 就绪后启用)

所有新增字段 API 未返回时显示 -,不影响已有功能。
npx tsc --noEmit 通过。

## N1 补全:详情字段和操作 **已添加:** - 列表新增列:`lastClientSessionId`(截断16字符)、`lastPosition`(JSON截断20字符) - 详情新增:`lastClientSessionId`、`lastPosition`(pre格式JSON)、`relatedMaterials`、`eventCount`、`sessionCount` - 详情底部:"重算进度"按钮(disabled + tooltip 说明 API 就绪后启用) 所有新增字段 API 未返回时显示 `-`,不影响已有功能。 `npx tsc --noEmit` 通过。
Author
Owner

完成证据

MaterialReadingProgress: ProgressPage with filters + detail drawer
Code ready in DataPages.tsx.

## 完成证据 MaterialReadingProgress: ProgressPage with filters + detail drawer Code ready in DataPages.tsx.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: wangdl/admin-projects#7
No description provided.