WangDL fe608da385 docs: 重构技术设计目录结构 + 更新待完成清单

- 文档从扁平结构迁移至分类目录 (api-server/ios-projects/web-projects/长期规划)
- 更新总待完成清单 (B1-B6 全部完成, I1-I7 全部完成)
- 新增后端实现状态、已实现功能汇总等已完成文档
- 新增 iOS 功能需求清单、架构设计、差距分析等文档
- 清理旧版未维护文档

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

2026-05-17 19:08:59 +08:00

2.1 KiB

Raw Blame History

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	✅	导入创建 + 状态查询（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 + 审计日志

2.1 KiB Raw Blame History Unescape Escape

知习 api-server 后端实现状态

模块完成度

基础设施

待推进

2.1 KiB

Raw Blame History