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

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#36