M4-02 Admin Data View Module #36

New Issue

wangdl · 2026-05-22T21:09:50+08:00

wangdl commented

2026-05-22 21:09:50 +08:00

目标

设计知习 Admin 数据视图模块，为 Admin 提供数据库中文业务视图，让非技术管理员能看懂用户、知识库、文件、学习和复习数据。

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

背景说明

Admin 管理员不一定懂技术，直接看 Prisma 的英文表名字段名会很困惑。Admin Data View 模块将数据库的英文字段映射为中文业务描述，提供用户/知识库/文件/学习/复习等维度的数据浏览。

模块职责

本模块负责：
- 用户数据视图（C 端用户详情、会员状态、设备列表）
- 知识库数据视图（知识库详情、资料数、知识点数统计）
- 文件数据视图（上传文件列表、COS 路径、状态）
- 学习数据视图（学习会话、AI 分析结果）
- 复习数据视图（复习卡片、调度状态、作答记录）
- AI 调用日志视图
- 字段中文解释（中文 Label 映射）
本模块不负责：
- 修改数据（只读视图）
- 数据导出（走 Reporting & Export）

基础设施依赖

纯视图聚合层，通过各模块 QueryService 只读查询。

禁止事项

禁止暴露裸数据库字段（必须中文映射）
禁止 Admin Data View 绕过 QueryService 直接查数据库
禁止展示用户隐私敏感信息（如完整手机号、邮箱全址）

不建议当前阶段实现

自定义数据视图配置
数据可视化图表（Dashboard 负责）

## 目标设计知习 Admin 数据视图模块，为 Admin 提供数据库中文业务视图，让非技术管理员能看懂用户、知识库、文件、学习和复习数据。本 Issue 只做模块架构设计，不直接实现代码。 ## 背景说明 Admin 管理员不一定懂技术，直接看 Prisma 的英文表名字段名会很困惑。Admin Data View 模块将数据库的英文字段映射为中文业务描述，提供用户/知识库/文件/学习/复习等维度的数据浏览。 ## 模块职责 1. 本模块负责： - 用户数据视图（C 端用户详情、会员状态、设备列表） - 知识库数据视图（知识库详情、资料数、知识点数统计） - 文件数据视图（上传文件列表、COS 路径、状态） - 学习数据视图（学习会话、AI 分析结果） - 复习数据视图（复习卡片、调度状态、作答记录） - AI 调用日志视图 - 字段中文解释（中文 Label 映射） 2. 本模块不负责： - 修改数据（只读视图） - 数据导出（走 Reporting & Export） ## 基础设施依赖纯视图聚合层，通过各模块 QueryService 只读查询。 ## 禁止事项 - 禁止暴露裸数据库字段（必须中文映射） - 禁止 Admin Data View 绕过 QueryService 直接查数据库 - 禁止展示用户隐私敏感信息（如完整手机号、邮箱全址） ## 不建议当前阶段实现 - 自定义数据视图配置 - 数据可视化图表（Dashboard 负责）

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

wangdl commented

2026-05-24 17:46:06 +08:00

✅ M4-02 实施完成

已有基础

大部分 admin 数据视图此前已存在：

用户数据（admin-users + MemberManagement）
知识库数据（admin-knowledge + KnowledgeBases）
文件数据（admin-files + FilesAdmin）
复习数据（admin-review + ReviewAdmin，M3-02 审计新增）
AI 网关/成本（AiGateway、Billing、Metrics）

本 Issue 新增

模块	说明
AdminLearningController	3 个只读端点：学习会话列表、AI 分析结果、AI 调用日志
LearningData 页面	Tabs：学习会话 / AI 分析结果 / AI 调用日志，支持按用户搜索
菜单	新增「学习数据」菜单项

AAPI 端点

端点	说明
GET /admin-api/learning/sessions	学习会话列表（userId/mode/status/duration）
GET /admin-api/learning/analysis	AI 分析结果（masteryScore/weaknesses/strengths）
GET /admin-api/learning/ai-usage	AI 调用日志（inputTokens/outputTokens/estimatedCost）

Admin 数据视图总览

视图	后端 Controller	前端页面	状态
用户数据	AdminUsersController + AdminUsersMgmtController	UserManagement + MemberManagement	✅
知识库数据	AdminKnowledgeController	KnowledgeBases + KnowledgeOps	✅
文件数据	AdminFilesController	FilesAdmin	✅
学习数据	AdminLearningController (新)	LearningData (新)	✅
复习数据	AdminReviewController	ReviewAdmin	✅
AI 调用日志	AdminLearningController (新)	LearningData (新)	✅
审计日志	AdminAuditLogController	AuditLog	✅
系统指标	AdminMetricsController	Metrics	✅

## ✅ M4-02 实施完成 ### 已有基础大部分 admin 数据视图此前已存在： - 用户数据（admin-users + MemberManagement） - 知识库数据（admin-knowledge + KnowledgeBases） - 文件数据（admin-files + FilesAdmin） - 复习数据（admin-review + ReviewAdmin，M3-02 审计新增） - AI 网关/成本（AiGateway、Billing、Metrics） ### 本 Issue 新增 | 模块 | 说明 | |------|------| | AdminLearningController | 3 个只读端点：学习会话列表、AI 分析结果、AI 调用日志 | | LearningData 页面 | Tabs：学习会话 / AI 分析结果 / AI 调用日志，支持按用户搜索 | | 菜单 | 新增「学习数据」菜单项 | ### AAPI 端点 | 端点 | 说明 | |------|------| | GET /admin-api/learning/sessions | 学习会话列表（userId/mode/status/duration） | | GET /admin-api/learning/analysis | AI 分析结果（masteryScore/weaknesses/strengths） | | GET /admin-api/learning/ai-usage | AI 调用日志（inputTokens/outputTokens/estimatedCost） | ### Admin 数据视图总览 | 视图 | 后端 Controller | 前端页面 | 状态 | |------|----------------|---------|------| | 用户数据 | AdminUsersController + AdminUsersMgmtController | UserManagement + MemberManagement | ✅ | | 知识库数据 | AdminKnowledgeController | KnowledgeBases + KnowledgeOps | ✅ | | 文件数据 | AdminFilesController | FilesAdmin | ✅ | | 学习数据 | AdminLearningController (新) | LearningData (新) | ✅ | | 复习数据 | AdminReviewController | ReviewAdmin | ✅ | | AI 调用日志 | AdminLearningController (新) | LearningData (新) | ✅ | | 审计日志 | AdminAuditLogController | AuditLog | ✅ | | 系统指标 | AdminMetricsController | Metrics | ✅ |

wangdl closed this issue

2026-06-06 14:43: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#36