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

API-ADMIN-INFO-008 P0 | LearningRecord 查询 / 详情接口 【status:blocked】 #146

New Issue
Open
opened 2026-06-07 12:33:24 +08:00 by wangdl · 4 comments
wangdl commented 2026-06-07 12:33:24 +08:00
Owner
Copy Link

GET /admin/learning/records?page&pageSize&userId?&recordType?&clientSessionId?&sessionId?&targetType?&materialId?&knowledgeBaseId?&startTime?&endTime?。详情: 完整字段+关联Session/Event。支持按clientSessionId查重。

M-API-ADMIN-INFO 里程碑 issue。依赖 M-API-INFO 核心数据表和服务。对应 ADMIN-INFO-xxx。

## GET /admin/learning/records?page&pageSize&userId?&recordType?&clientSessionId?&sessionId?&targetType?&materialId?&knowledgeBaseId?&startTime?&endTime?。详情: 完整字段+关联Session/Event。支持按clientSessionId查重。 M-API-ADMIN-INFO 里程碑 issue。依赖 M-API-INFO 核心数据表和服务。对应 ADMIN-INFO-xxx。
wangdl added this to the M-API-ADMIN-INFO：学习信息管理后台接口 milestone 2026-06-07 12:33:24 +08:00
wangdl changed title from API-ADMIN-INFO-008 P0 | LearningRecord 查询 / 详情接口 to API-ADMIN-INFO-008 P0 | LearningRecord 查询 / 详情接口 【status:todo】 2026-06-07 19:07:52 +08:00
wangdl commented 2026-06-07 19:07:52 +08:00
Author
Owner
Copy Link

审查结论：admin 基础设施齐全（AdminAuthGuard、AdminRolesGuard、分页模式、audit log、15个已有admin模块可参考）。AdminLearningController 已有3个基础端点(GET sessions/analysis/ai-usage)。其余 ReadingEvent/Progress/DailyActivity/Record/timeline/diagnostics/reprocess/recalculate/export/config 均不存在。核心阻塞于 M-API-INFO schema 未建。

本 Issue: 接口不存在。需等 API-INFO-007 LR 模块。blocked-by:schema

标签: audit:reviewed audit:api-info status:todo work:api

## 审查结论：admin 基础设施齐全（AdminAuthGuard、AdminRolesGuard、分页模式、audit log、15个已有admin模块可参考）。AdminLearningController 已有3个基础端点(GET sessions/analysis/ai-usage)。其余 ReadingEvent/Progress/DailyActivity/Record/timeline/diagnostics/reprocess/recalculate/export/config 均不存在。核心阻塞于 M-API-INFO schema 未建。 **本 Issue**: 接口不存在。需等 API-INFO-007 LR 模块。blocked-by:schema **标签**: audit:reviewed audit:api-info status:todo work:api
wangdl changed title from API-ADMIN-INFO-008 P0 | LearningRecord 查询 / 详情接口 【status:todo】 to API-ADMIN-INFO-008 P0 | LearningRecord 查询 / 详情接口 【status:blocked】 2026-06-07 19:11:45 +08:00
wangdl commented 2026-06-07 19:11:45 +08:00
Author
Owner
Copy Link

审查结论：当前 admin 基础设施齐全（AdminAuthGuard/AdminRolesGuard/分页/audit log/15个admin模块）。AdminLearningController 已有3个基础端点。但学习信息后台接口主要依赖 M-API-INFO 核心数据表与聚合服务。允许先做 DTO/Controller路由/权限装饰器/文档草案，但不得用 mock 数据作为最终验收。

本 Issue: 表有 schema 但无 service/repository。

状态: status:blocked
工作类型: work:query
阻塞: blocked-by:api-info-core
标签: audit:reviewed audit:api-admin-info area:admin-api status:blocked work:query blocked-by:api-info-core

## 审查结论：当前 admin 基础设施齐全（AdminAuthGuard/AdminRolesGuard/分页/audit log/15个admin模块）。AdminLearningController 已有3个基础端点。但学习信息后台接口主要依赖 M-API-INFO 核心数据表与聚合服务。允许先做 DTO/Controller路由/权限装饰器/文档草案，但不得用 mock 数据作为最终验收。 **本 Issue**: 表有 schema 但无 service/repository。 **状态**: status:blocked **工作类型**: work:query **阻塞**: blocked-by:api-info-core **标签**: audit:reviewed audit:api-admin-info area:admin-api status:blocked work:query blocked-by:api-info-core
wangdl commented 2026-06-09 21:40:35 +08:00
Author
Owner
Copy Link

完成

AdminReadingController.listRecords() + getRecord()

## 完成 `AdminReadingController.listRecords()` + `getRecord()`
wangdl reopened this issue 2026-06-15 21:31:54 +08:00
wangdl commented 2026-06-15 21:31:54 +08:00
Author
Owner
Copy Link

下游依赖：Admin 前端需要更多字段

ADMIN-INFO-008 (#9) 已完成 RecordPage，但以下字段 API 未返回，导致列表和详情有缺口：

列表缺失字段

  • recordId — 记录唯一标识
  • sessionId / clientSessionId — 跳转关联 session
  • targetType — 区分资料/知识点/知识库
  • knowledgeBaseId — 知识库维度筛选

详情缺失字段

  • sessionId / clientSessionId — 排查重复 record、跳转 session
  • knowledgeBaseId — 知识库诊断

功能缺失

  • 跳转 session：需 API 返回 sessionId 或 clientSessionId
  • 排查重复 record：需 API 支持去重查询或返回 recordId

优先级

P1 — 当前页面框架已完成（筛选+分页+详情），补字段即可。不阻塞 P0 关闭。

## 下游依赖：Admin 前端需要更多字段 ADMIN-INFO-008 (#9) 已完成 RecordPage，但以下字段 API 未返回，导致列表和详情有缺口： ### 列表缺失字段 - `recordId` — 记录唯一标识 - `sessionId` / `clientSessionId` — 跳转关联 session - `targetType` — 区分资料/知识点/知识库 - `knowledgeBaseId` — 知识库维度筛选 ### 详情缺失字段 - `sessionId` / `clientSessionId` — 排查重复 record、跳转 session - `knowledgeBaseId` — 知识库诊断 ### 功能缺失 - 跳转 session：需 API 返回 sessionId 或 clientSessionId - 排查重复 record：需 API 支持去重查询或返回 recordId ### 优先级 P1 — 当前页面框架已完成（筛选+分页+详情），补字段即可。不阻塞 P0 关闭。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
adr
Area: adr
architecture
Area: architecture
area:activity
活动/统计
area:admin
管理后台
area:admin-api
area:ai
AI/RAG
area:ai-runtime
AI Runtime / AI 分析体系相关
area:analytics
area:api
API 接口
area:auth
认证与授权
area:cos
对象存储
area:database
数据库/Migration
area:import
文件导入/解析
area:knowledge
知识库/知识点
area:learning-info
area:learning-session
area:quiz
测验/自测
area:reading-event
area:reading-progress
area:review
复习系统
area:security
安全相关
audit
Area: audit
audit:api-admin-info
audit:api-info
audit:planned
已完成宏观规划，尚未代码审查
audit:reviewed
backend
Area: backend
billing
Area: billing
blocked-by:api-info-aggregation
blocked-by:api-info-core
blocked-by:api-info-ops
blocked-by:api-info-schema
blocked-by:processor
blocked-by:schema
compatibility
Area: compatibility
gate
Area: gate
infrastructure
Area: infrastructure
priority:p0
最高优先级，阻塞发布
priority:p1
高优先级，里程碑必需
priority:p2
中优先级，后续版本
prisma
Area: prisma
release
Area: release
repo:api
API 仓库 Issue
status:blocked
被阻塞
status:done
已完成
status:partial
status:todo
type:aggregation
type:bug
缺陷修复
type:design
设计
type:docs
文档
type:feature
新功能
type:migration
type:refactor
重构
type:test
work:admin-api
work:aggregation
work:api
work:artifact
题目/卡片产物
work:audit
work:circuit-breaker
熔断
work:contract
work:design
架构/协议设计工作
work:docs
work:export
work:extend-existing
work:internal-api
Runtime 内部接口
work:job
Job 调度相关
work:new-module
work:new-table
work:ops
work:query
work:quota
额度/限流
work:schema
Prisma Schema 设计
work:security
work:service
Service 层实现
work:snapshot
Snapshot 构建
work:test
No Label
Milestone
No items
No Milestone M-API-ADMIN-INFO：学习信息管理后台接口
Projects
Clear projects
No project
Assignees
Clear assignees
suyun-Claude wangdl
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: wangdl/api-server#146
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?