---
updated: 2026-05-17
---

# 知习 api-server 后端实现状态

> 记录当前已完成和部分完成的模块状态。完整架构设计见 `[进行中]-架构总览.md`。

## 模块完成度

| 模块 | 状态 | 备注 |
|------|------|------|
| Auth（Apple + JWT） | ✅ | Apple 登录、JWT、刷新、退出 |
| Role / Permission | ✅ | @Roles() + RolesGuard + USER/ADMIN/SUPER_ADMIN |
| Users | ✅ | 个人资料 CRUD、偏好设置（外观/语言/提醒） |
| Knowledge Base | ✅ | CRUD + 软删除，Prisma |
| Knowledge Items | ✅ | CRUD + 排序，Prisma |
| Learning Session | ✅ | 开始/结束/列表 |
| Active Recall | ✅ | 回答提交 + AI 分析集成 |
| AI Analysis | ✅ | 同步分析 + 结果存储 |
| AI Gateway | ✅ | 三层架构：Provider（DeepSeek+MiniMax+Mock）→ Gateway → Workflow |
| AI Workflows | 🔶 1/5 | 主动回忆分析完成，缺：费曼/导入/复习卡片/趋势 |
| Focus Items | ✅ | CRUD + 完成标记 |
| Review | ✅ | 到期卡片 + 提交复习 |
| Learning Activity | ✅ | 热力图 + 摘要统计 |
| Document Import | ✅ | 导入创建 + 状态查询（Redis 队列待接） |
| Notifications | ✅ | 列表 + 已读标记（推送待接） |
| Feedback | ✅ | 提交 + 列表 + 统计 |
| System | ✅ | 健康检查 |
| Redis | 🔶 | RedisService 可用，BullMQ 未接 |
| iOS 对接 | 🔶 | Auth 已对接，其他页面待接 |

## 基础设施

| 项目 | 状态 |
|------|------|
| NestJS + TypeScript | ✅ |
| Prisma + MySQL | ✅ |
| Docker + Nginx | ✅ api.longde.cloud |
| Let's Encrypt SSL | ✅ |
| Swagger（Basic Auth 保护） | ✅ |
| 全局 JwtAuthGuard（@Public 白名单） | ✅ |
| 全局 RolesGuard（角色层级） | ✅ |
| 全局 ExceptionFilter | ✅ |
| 全局 ValidationPipe | ✅ |
| `npx tsc --noEmit` | ✅ 0 errors |

## 待推进

- AI Workflows：费曼解释评估、知识导入解析、复习卡片生成、长期趋势分析
- BullMQ：队列 + Worker 异步处理
- Redis：缓存 + 限流接入
- iOS：知识库列表、学习会话、复习等页面接后端
- 管理员后台：Admin API + 审计日志
