API-ADMIN-INFO-000 P0 | 学习信息后台接口总设计【status:todo】 #138

New Issue

wangdl · 2026-06-07T12:33:20+08:00

wangdl commented

2026-06-07 12:33:20 +08:00

docs/admin-learning-info-api-design.md — 路由前缀 /admin/learning/*、管理员鉴权规则、权限角色、分页/筛选/排序规范、Dashboard/Event/Session/Progress/Activity/Record 查询结构、重放/重算/导出操作规范、审计日志规范、错误码。

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

## docs/admin-learning-info-api-design.md — 路由前缀 /admin/learning/*、管理员鉴权规则、权限角色、分页/筛选/排序规范、Dashboard/Event/Session/Progress/Activity/Record 查询结构、重放/重算/导出操作规范、审计日志规范、错误码。 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:20 +08:00

wangdl changed title from ~~API-ADMIN-INFO-000 P0 | 学习信息后台接口总设计~~ to API-ADMIN-INFO-000 P0 | 学习信息后台接口总设计【status:todo】

2026-06-07 19:07:48 +08:00

wangdl commented

2026-06-07 19:07:49 +08:00

审查结论：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: 设计文档不存在。但 admin 基础设施齐全：AdminAuthGuard、AdminRolesGuard、分页模式、audit log 模型、15个已有 admin 模块可参考。

标签: audit:reviewed audit:api-info status:todo work:contract,work:docs

## 审查结论：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**: 设计文档不存在。但 admin 基础设施齐全：AdminAuthGuard、AdminRolesGuard、分页模式、audit log 模型、15个已有 admin 模块可参考。 **标签**: audit:reviewed audit:api-info status:todo work:contract,work:docs

wangdl commented

2026-06-07 19:11:42 +08:00

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

本 Issue: 总设计文档可先做。无阻塞。

状态: status:todo
工作类型: work:docs,work:admin-api
阻塞: 无
标签: audit:reviewed audit:api-admin-info area:admin-api status:todo work:docs,work:admin-api

## 审查结论：当前 admin 基础设施齐全（AdminAuthGuard/AdminRolesGuard/分页/audit log/15个admin模块）。AdminLearningController 已有3个基础端点。但学习信息后台接口主要依赖 M-API-INFO 核心数据表与聚合服务。允许先做 DTO/Controller路由/权限装饰器/文档草案，但不得用 mock 数据作为最终验收。 **本 Issue**: 总设计文档可先做。无阻塞。 **状态**: status:todo **工作类型**: work:docs,work:admin-api **阻塞**: 无 **标签**: audit:reviewed audit:api-admin-info area:admin-api status:todo work:docs,work:admin-api

wangdl commented

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

完成报告

交付

docs/admin-learning-info-api-design.md — 后台接口总设计：

路由前缀 /admin/learning/*
AdminJwtGuard + ADMIN/SUPER_ADMIN 角色
17 个查询接口 + 5 个操作接口
分页/筛选/排序规范
Dashboard 数据结构
审计日志 + 错误码

## 完成报告 ### 交付 `docs/admin-learning-info-api-design.md` — 后台接口总设计： - 路由前缀 `/admin/learning/*` - AdminJwtGuard + ADMIN/SUPER_ADMIN 角色 - 17 个查询接口 + 5 个操作接口 - 分页/筛选/排序规范 - Dashboard 数据结构 - 审计日志 + 错误码

wangdl closed this issue

2026-06-09 21:36:17 +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#138

API-ADMIN-INFO-000 P0 | 学习信息后台接口总设计 【status:todo】 #138

docs/admin-learning-info-api-design.md — 路由前缀 /admin/learning/*、管理员鉴权规则、权限角色、分页/筛选/排序规范、Dashboard/Event/Session/Progress/Activity/Record 查询结构、重放/重算/导出操作规范、审计日志规范、错误码。

完成报告

交付

API-ADMIN-INFO-000 P0 | 学习信息后台接口总设计【status:todo】 #138