WangDL 23a6999b56 docs: 推送所有未提交的文档更新

- 5/19-5/20 工作日志
- 后端实现状态更新
- 服务器部署方案更新
- 知识库设计更新
- 进行中文档更新
- 执行计划与任务清单更新

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-20 18:10:44 +08:00

updated

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 已对接，其他页面待接