2026-05-17 19:08:59 +08:00
|
|
|
|
---
|
|
|
|
|
|
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 | ✅ | 热力图 + 摘要统计 |
|
2026-05-20 18:10:44 +08:00
|
|
|
|
| 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 去重 |
|
2026-05-17 19:08:59 +08:00
|
|
|
|
| Notifications | ✅ | 列表 + 已读标记（推送待接） |
|
|
|
|
|
|
| Feedback | ✅ | 提交 + 列表 + 统计 |
|
|
|
|
|
|
| System | ✅ | 健康检查 |
|
|
|
|
|
|
| Redis | 🔶 | RedisService 可用，BullMQ 未接 |
|
|
|
|
|
|
| iOS 对接 | 🔶 | Auth 已对接，其他页面待接 |
|
|
|
|
|
|
|
|
|
|
|
|
## 基础设施
|
|
|
|
|
|
|
|
|
|
|
|
| 项目 | 状态 |
|
|
|
|
|
|
|------|------|
|
|
|
|
|
|
| NestJS + TypeScript | ✅ |
|
|
|
|
|
|
| Prisma + MySQL | ✅ |
|
2026-05-20 18:10:44 +08:00
|
|
|
|
| Docker + Nginx | ✅ api.longde.cloud（8核32G） |
|
2026-05-17 19:08:59 +08:00
|
|
|
|
| Let's Encrypt SSL | ✅ |
|
|
|
|
|
|
| Swagger（Basic Auth 保护） | ✅ |
|
|
|
|
|
|
| 全局 JwtAuthGuard（@Public 白名单） | ✅ |
|
|
|
|
|
|
| 全局 RolesGuard（角色层级） | ✅ |
|
|
|
|
|
|
| 全局 ExceptionFilter | ✅ |
|
|
|
|
|
|
| 全局 ValidationPipe | ✅ |
|
|
|
|
|
|
| `npx tsc --noEmit` | ✅ 0 errors |
|
2026-05-20 18:10:44 +08:00
|
|
|
|
| CI/CD Pipeline（api-server） | ✅ gitea-runner + deploy.yml |
|
|
|
|
|
|
| CI/CD Pipeline（web-projects） | ✅ gitea-runner + deploy.yml（今日 13:38 部署） |
|
2026-05-17 19:08:59 +08:00
|
|
|
|
|
|
|
|
|
|
## 待推进
|
|
|
|
|
|
|
|
|
|
|
|
- AI Workflows：费曼解释评估、知识导入解析、复习卡片生成、长期趋势分析
|
|
|
|
|
|
- BullMQ：队列 + Worker 异步处理
|
|
|
|
|
|
- Redis：缓存 + 限流接入
|
2026-05-20 18:10:44 +08:00
|
|
|
|
- Python RAG Worker：补全依赖 + 创建 systemd 服务（代码已部署）
|
2026-05-17 19:08:59 +08:00
|
|
|
|
- iOS：知识库列表、学习会话、复习等页面接后端
|
2026-05-20 18:10:44 +08:00
|
|
|
|
- CI/CD：4核4G 安装 gitea-runner-web + web-projects workflow
|
|
|
|
|
|
- COS Bucket 验证 + 百度 OCR 开通
|
2026-05-17 19:08:59 +08:00
|
|
|
|
- 管理员后台：Admin API + 审计日志
|
