WangDL
fe608da385
- 文档从扁平结构迁移至分类目录 (api-server/ios-projects/web-projects/长期规划) - 更新总待完成清单 (B1-B6 全部完成, I1-I7 全部完成) - 新增后端实现状态、已实现功能汇总等已完成文档 - 新增 iOS 功能需求清单、架构设计、差距分析等文档 - 清理旧版未维护文档 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
55 lines
2.1 KiB
Markdown
55 lines
2.1 KiB
Markdown
---
|
||
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 + 审计日志
|