From c0a399f8be9c70623258d834ec1512c942c63c23 Mon Sep 17 00:00:00 2001 From: WangDL Date: Mon, 18 May 2026 10:59:19 +0800 Subject: [PATCH] refactor: remove done items, group completed tasks into collapsible sections Co-Authored-By: Claude Opus 4.7 --- 技术设计/总待完成清单.md | 199 ++++++++++++++++++++++----------------- 1 file changed, 114 insertions(+), 85 deletions(-) diff --git a/技术设计/总待完成清单.md b/技术设计/总待完成清单.md index ae5aecc..b93b964 100644 --- a/技术设计/总待完成清单.md +++ b/技术设计/总待完成清单.md @@ -1,8 +1,8 @@ # 知习 总待完成清单 -> 整合后端、iOS、跨项目所有待完成事项，按优先级排列。以后以此文件为主。 +> 整合后端、iOS、跨项目所有未完成事项，按优先级排列。已完成事项见底部。 > -> 更新时间：2026-05-17 +> 更新时间：2026-05-18 --- @@ -22,53 +22,11 @@ > 详细文档：[后端待完成事项清单](./api-server/后端待完成事项清单.md) | 路线图：[后端开发路线图](./api-server/后端开发路线图.md) -### 🔴 P0 — 安全/可靠性底线 - -| # | 事项 | 说明 | 详见 | 状态 | -|---|------|------|------|------| -| B1 | CI/CD 密钥脱敏 | deploy.yml 明文硬编码 DB 密码/JWT Secret/Swagger 密码 | [潜在问题清单 #4](./潜在问题清单.md) | ✅ | -| B2 | Queue 接 BullMQ + Redis | 当前队列是内存数组 push/shift，重启全丢 | [潜在问题清单 #2](./潜在问题清单.md) | ✅ | -| B3 | AI 分析 await 修复 | `ai-analysis.service.ts` fire-and-forget 异常静默丢失 | [潜在问题清单 #10](./潜在问题清单.md) | ✅ | -| B4 | 限流 Guard 全局注册 | 改为 RateLimitGuard + @RateLimit() 装饰器，全局生效 | [潜在问题清单 #21](./潜在问题清单.md) | ✅ | -| B5 | 响应拦截器全局注册 | ResponseInterceptor 已写好但未注册 | [潜在问题清单 #22](./潜在问题清单.md) | ✅ | -| B6 | 分页 DTO 接入 | PaginationDto 已写好但所有 list 接口未使用 | [潜在问题清单 #28](./潜在问题清单.md) | ✅ | - ### 🟠 P1 — AI 工作流 -| # | 事项 | 说明 | 详见 | 状态 | -|---|------|------|------|------| -| B7 | 费曼解释评估 Workflow | 用户提交费曼解释 → AI 评估 | [AI架构设计](./api-server/AI架构设计.md) | ✅ | -| B8 | 知识导入解析 Workflow | 文档/文本 → AI 切分知识点 → 入库 | [AI架构设计](./api-server/AI架构设计.md) | ✅ | -| B9 | 复习卡片生成 Workflow | AI 自动生成间隔复习卡片 | [AI架构设计](./api-server/AI架构设计.md) | ✅ | -| B10 | 长期趋势分析 Workflow | 7/30 天学习数据 → 趋势报告 | [AI架构设计](./api-server/AI架构设计.md) | ✅ | -| B11 | AI 联调 + Prompt 调优 | DeepSeek/MiniMax 真实调用测试，Prompt 迭代 | [后端待完成事项清单](./api-server/后端待完成事项清单.md) | | - -### 🟠 P1 — 异步化 - -| # | 事项 | 说明 | 详见 | 状态 | -|---|------|------|------|------| -| B12 | AI 分析异步化 | 当前同步等待 AI 返回，改 BullMQ 队列 | [Redis缓存设计](./api-server/Redis缓存设计.md) | ✅ | -| B13 | 文档导入异步化 | Worker 消费导入任务，AI 切分知识点 | [Redis缓存设计](./api-server/Redis缓存设计.md) | ✅ | -| B14 | 通知推送队列 | BullMQ notification 队列 + APNs | [Redis缓存设计](./api-server/Redis缓存设计.md) | ✅ | -| B15 | Worker 实现 | 3 个 Worker 文件全为空壳，需真正消费队列 | [潜在问题清单 #3](./潜在问题清单.md) | ✅ | - -### 🟡 P2 — 存储/文件 - -| # | 事项 | 说明 | 详见 | 状态 | -|---|------|------|------|------| -| B16 | COS 对象存储接入 | 文件上传/下载/签名 URL | [Redis缓存设计](./api-server/Redis缓存设计.md) | ✅ | -| B17 | 文件上传完整流程 | POST /api/files/upload-url → COS → complete | [后端开发路线图 P5](./api-server/后端开发路线图.md) | ✅ | -| B18 | 文档导入真实解析 | 替换 3 层 setTimeout mock | [潜在问题清单 #24](./潜在问题清单.md) | ✅ | -| B19 | Storage Service 实现 | 当前只有 getUploadPath + healthCheck，无真正读写 | [潜在问题清单 #25](./潜在问题清单.md) | ✅ | - -### 🟡 P2 — 基础设施补全 - | # | 事项 | 说明 | 详见 | |---|------|------|------| -| B20 | Docker Compose | api-server + MySQL + Redis + Worker + Nginx | [架构总览 #2](./api-server/架构总览.md) | ✅ | -| B21 | enableShutdownHooks | SIGTERM 时优雅关闭，排空连接 | [潜在问题清单 #26](./潜在问题清单.md) | ✅ | -| B22 | Prisma Migration | 创建 migrations/ 目录，schema 变更版本管理 | [潜在问题清单 #29](./潜在问题清单.md) | ✅ | -| B27 | 限流改为 Guard/Interceptor | RateLimitService 在 AppModule，无法注入 feature module；改用全局 Guard/Interceptor 统一限流 | [潜在问题清单 #21](./潜在问题清单.md) | ✅ | +| B11 | AI 联调 + Prompt 调优 | DeepSeek/MiniMax 真实调用测试，Prompt 迭代 | [后端待完成事项清单](./api-server/后端待完成事项清单.md) | ### ⚪ 远期 — 商业化/后台/客服 @@ -85,34 +43,6 @@ > 详细文档：[缺失项与待补全方向](./ios-projects/缺失项与待补全方向.md) -### 🔴 P0 — 前后端打通 - -| # | 事项 | 说明 | 详见 | 状态 | -|---|------|------|------|------| -| I1 | 知识库列表接后端 | LibraryHomeView 调 GET /api/knowledge-bases | [缺失项 一](./ios-projects/缺失项与待补全方向.md) | ✅ | -| I2 | 知识点列表接后端 | LibraryDetailPage 调 GET /api/knowledge-items | [缺失项 一](./ios-projects/缺失项与待补全方向.md) | ✅ | -| I3 | 学习会话接后端 | StudyHomeView 调 GET/POST /api/learning-sessions | [缺失项 一](./ios-projects/缺失项与待补全方向.md) | ✅ | -| I4 | 主动回忆接后端 | ActiveRecallView 调 GET/POST /api/active-recalls | [缺失项 一](./ios-projects/缺失项与待补全方向.md) | ✅ | -| I5 | AI 分析结果接后端 | AIAnalysisViewModel 调 POST /api/ai-analysis | [缺失项 一](./ios-projects/缺失项与待补全方向.md) | ✅ | -| I6 | 复习计划接后端 | ReviewCardView 调 GET /api/reviews/due | [缺失项 一](./ios-projects/缺失项与待补全方向.md) | ✅ | -| I7 | 学习活跃接后端 | AnalysisHomeView 调 GET /api/activity/summary | [缺失项 一](./ios-projects/缺失项与待补全方向.md) | ✅ | - -### 🟠 P1 — 架构补全 - -| # | 事项 | 说明 | 详见 | 状态 | -|---|------|------|------|------| -| I8 | ViewModel 层迁移 | 其余页面从 View 内聚状态迁移到 ViewModel | [缺失项 二](./ios-projects/缺失项与待补全方向.md) | ✅ | -| I9 | 本地缓存层 | UserDefaults/SwiftData 缓存学习数据，支持离线浏览 | [潜在问题清单 #18](./潜在问题清单.md) | ✅ | -| I10 | 测试修复 | 4 个 Test 文件引用的 ViewModel/FileCache 已创建，验证可编译 | [潜在问题清单 #13](./潜在问题清单.md) | ✅ | -| I11 | LocalizedStringKey 接入 | 180+ key 已写好，View 需从硬编码文案切换 | [潜在问题清单 #20](./潜在问题清单.md) | ✅ | - -### 🟡 P2 — 体验/动效 - -| # | 事项 | 说明 | 详见 | 状态 | -|---|------|------|------|------| -| I12 | 动效补充 | 页面过渡、按钮反馈、AI 分析中状态、学习完成反馈 | [缺失项 三](./ios-projects/缺失项与待补全方向.md) | ✅ | -| I13 | 无障碍基础适配 | accessibilityLabel、Dynamic Type、VoiceOver | [缺失项 四](./ios-projects/缺失项与待补全方向.md) | ✅ | - ### 🟢 P3 — TestFlight 前 | # | 事项 | 说明 | 详见 | @@ -181,23 +111,122 @@ S1 → S2 → S3 → S4 → S5 选定方向 → 竞品拆解 → 准备内容 → 裁剪范围 → 算清成本 -第 1 批（✅ 已完成 2026-05-18）： - B1 → B2 → B3 → B4 → B5 → B6 - CI/CD脱敏 → BullMQ → AI await修复 → 限流注册 → 拦截器注册 → 分页 +第 1 批（本月）： + B11 → S6-S9 + AI 联调 → 验证机制 -第 2 批（✅ 已完成 2026-05-18）： - B7-B11 → B12-B15 → I1-I7 ✅ → I8-I11 ✅ - AI Workflows ✅ → 异步化 → iOS 前后端打通 → iOS 架构补全 +第 2 批（TestFlight 前）： + W1-W3 + 官网修复 -第 3 批（TestFlight 前）： - ✅ I12-I13 → ✅ B16/B17/B19 → ✅B18 → ✅B20-B22 → ✅B27 → S6-S9 → W1-W3 - ✅ iOS 动效/无障碍（已完成） → ✅ COS 接入（已完成） → ✅文档导入解析 → ✅基础设施补全 → 验证机制 → 官网修复 - -第 4 批（App Store 前）： +第 3 批（App Store 前）： I14-I17 → S10-S13 → W4-W7 埋点/崩溃监控/测试/Tab决策 → 运营准备 → 官网细节 -第 5 批（远期）： +第 4 批（远期）： B23-B26 商业化 → 后台 → 客服 ``` + +--- + +## 已完成事项 + +
+✅ 后端 — P0 安全/可靠性底线（6 项） + +| # | 事项 | 说明 | +|---|------|------| +| B1 | CI/CD 密钥脱敏 | deploy.yml 明文硬编码 DB 密码/JWT Secret/Swagger 密码 | +| B2 | Queue 接 BullMQ + Redis | 内存数组 push/shift 改为 BullMQ + Redis | +| B3 | AI 分析 await 修复 | ai-analysis.service.ts fire-and-forget 异常静默丢失 | +| B4 | 限流 Guard 全局注册 | RateLimitGuard + @RateLimit() 装饰器，全局生效 | +| B5 | 响应拦截器全局注册 | ResponseInterceptor 已写好但未注册 | +| B6 | 分页 DTO 接入 | PaginationDto 已写好但所有 list 接口未使用 | + +
+ +
+✅ 后端 — P1 AI 工作流（4 项） + +| # | 事项 | 说明 | +|---|------|------| +| B7 | 费曼解释评估 Workflow | 用户提交费曼解释 → AI 评估 | +| B8 | 知识导入解析 Workflow | 文档/文本 → AI 切分知识点 → 入库 | +| B9 | 复习卡片生成 Workflow | AI 自动生成间隔复习卡片 | +| B10 | 长期趋势分析 Workflow | 7/30 天学习数据 → 趋势报告 | + +
+ +
+✅ 后端 — P1 异步化（4 项） + +| # | 事项 | 说明 | +|---|------|------| +| B12 | AI 分析异步化 | 同步等待 AI 返回 → BullMQ 队列 | +| B13 | 文档导入异步化 | Worker 消费导入任务，AI 切分知识点 | +| B14 | 通知推送队列 | BullMQ notification 队列 + APNs | +| B15 | Worker 实现 | 3 个 Worker 全部实现（AI/Import/Notification） | + +
+ +
+✅ 后端 — P2 存储/文件（4 项） + +| # | 事项 | 说明 | +|---|------|------| +| B16 | COS 对象存储接入 | 文件上传/下载/签名 URL | +| B17 | 文件上传完整流程 | POST /api/files/upload-url → COS → complete | +| B18 | 文档导入真实解析 | 替换 3 层 setTimeout mock | +| B19 | Storage Service 实现 | 完整 COS 读写 + 本地存储回退 | + +
+ +
+✅ 后端 — P2 基础设施补全（4 项） + +| # | 事项 | 说明 | +|---|------|------| +| B20 | Docker Compose | api-server + MySQL + Redis + Worker + Nginx | +| B21 | enableShutdownHooks | SIGTERM 时优雅关闭，排空连接 | +| B22 | Prisma Migration | schema 变更版本管理（objectKey/bucket/AiUsage/Waitlist） | +| B27 | 限流改为 Guard/Interceptor | 全局 Guard 替代无法注入的 Service | + +
+ +
+✅ iOS — P0 前后端打通（7 项） + +| # | 事项 | 说明 | +|---|------|------| +| I1 | 知识库列表接后端 | LibraryHomeView 调 GET /api/knowledge-bases | +| I2 | 知识点列表接后端 | LibraryDetailPage 调 GET /api/knowledge-items | +| I3 | 学习会话接后端 | StudyHomeView 调 GET/POST /api/learning-sessions | +| I4 | 主动回忆接后端 | ActiveRecallView 调 GET/POST /api/active-recalls | +| I5 | AI 分析结果接后端 | AIAnalysisViewModel 调 POST /api/ai-analysis | +| I6 | 复习计划接后端 | ReviewCardView 调 GET /api/reviews/due | +| I7 | 学习活跃接后端 | AnalysisHomeView 调 GET /api/activity/summary | + +
+ +
+✅ iOS — P1 架构补全（4 项） + +| # | 事项 | 说明 | +|---|------|------| +| I8 | ViewModel 层迁移 | View 内聚状态迁移到 ViewModel | +| I9 | 本地缓存层 | UserDefaults/SwiftData 缓存，支持离线 | +| I10 | 测试修复 | 4 个 Test 文件验证可编译 | +| I11 | LocalizedStringKey 接入 | 180+ key，View 从硬编码文案切换 | + +
+ +
+✅ iOS — P2 体验/动效（2 项） + +| # | 事项 | 说明 | +|---|------|------| +| I12 | 动效补充 | 页面过渡、按钮反馈、AI 分析中状态 | +| I13 | 无障碍基础适配 | accessibilityLabel、Dynamic Type、VoiceOver | + +