---
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 | ✅ | 导入创建 + 状态查询（claim/heartbeat/stale recovery） |
| Knowledge Source | ✅ | 资料来源 CRUD + DocumentImport 自动生成 |
| Import Candidate | ✅ | 候选知识点管理 + KnowledgeItem 自动生成 |
| RAG (内部 API) | ✅ | 7 个端点，@Public 绕过 JWT |
| Python RAG Worker | 🔶 | 代码已部署（10 文件），systemd 待创建，依赖待补全 |
| UploadedFile | ✅ | sha256 去重 |
| Notifications | ✅ | 列表 + 已读标记（推送待接） |
| Feedback | ✅ | 提交 + 列表 + 统计 |
| System | ✅ | 健康检查 |
| Redis | 🔶 | RedisService 可用，BullMQ 未接 |
| iOS 对接 | 🔶 | Auth 已对接，其他页面待接 |

## 基础设施

| 项目 | 状态 |
|------|------|
| NestJS + TypeScript | ✅ |
| Prisma + MySQL | ✅ |
| Docker + Nginx | ✅ api.longde.cloud（8核32G） |
| Let's Encrypt SSL | ✅ |
| Swagger（Basic Auth 保护） | ✅ |
| 全局 JwtAuthGuard（@Public 白名单） | ✅ |
| 全局 RolesGuard（角色层级） | ✅ |
| 全局 ExceptionFilter | ✅ |
| 全局 ValidationPipe | ✅ |
| `npx tsc --noEmit` | ✅ 0 errors |
| CI/CD Pipeline（api-server） | ✅ gitea-runner + deploy.yml |
| CI/CD Pipeline（web-projects） | ✅ gitea-runner + deploy.yml（今日 13:38 部署） |

## 待推进

- AI Workflows：费曼解释评估、知识导入解析、复习卡片生成、长期趋势分析
- BullMQ：队列 + Worker 异步处理
- Redis：缓存 + 限流接入
- Python RAG Worker：补全依赖 + 创建 systemd 服务（代码已部署）
- iOS：知识库列表、学习会话、复习等页面接后端
- CI/CD：4核4G 安装 gitea-runner-web + web-projects workflow
- COS Bucket 验证 + 百度 OCR 开通
- 管理员后台：Admin API + 审计日志