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.3 KiB

Raw Blame History

iOS 缺失项与待补全方向

仅列出当前未完成的项目。已完成内容见 已完成/[已完成]-已实现功能汇总.md

更新时间：2026-05-17

一、后端 API 对接（当前最优先）

Auth 已对接。以下页面仍使用静态 Mock 数据，待接后端：

页面	需对接的 API
LibraryHomeView	GET /api/knowledge-bases
LibraryDetailPage	GET /api/knowledge-bases/:id/items
StudyHomeView	GET /api/learning-sessions
DailyThinkingPage	POST /api/active-recall/answers
AIFeedbackPage	GET /api/ai-analysis/:id
ReviewPlanView	GET /api/reviews/due
AnalysisHomeView	GET /api/learning-activity/summary

二、架构层待推进

ViewModel 迁移（部分完成）

ReviewPlanViewModel、AIChatViewModel、StudyHomeViewModel 已完成。其余页面仍为 View 内聚状态，待逐步迁移。

Repository 层

当需要本地缓存 + 网络切换时再建，当前阶段不紧急。

三、动效

计划要求（P0）：页面过渡、按钮反馈、加载状态、AI 分析中状态、学习完成反馈。当前仅有基础 SwiftUI 隐式动画。

四、无障碍

关键按钮添加 .accessibilityLabel，确保 Dynamic Type 下布局不破碎，重点页面 VoiceOver 测试。

五、测试

ViewModel 单元测试
Service 层单元测试（Mock Repository）
关键 UI 流程 Snapshot 测试

六、CI/CD

GitHub Actions / Xcode Cloud 自动构建
TestFlight 自动分发
崩溃监控（Firebase Crashlytics 或类似）

七、Tab 结构调整（待决策）

当前 5-Tab（AI | 知识库 | 学习 | 分析 | 我的），存在 AI/学习边界模糊、分析 Tab 内容单薄等问题。

建议 MVP 阶段保持现状，收集用户反馈后优先尝试"分析并入学习"（4 Tab）。

八、数据埋点

产品行为事件追踪（app_opened、knowledge_base_created、active_recall_submitted 等）
可先用 PostHog / Firebase

当前最应该推进

1. 后端 API 对接（知识库列表 → 学习会话 → 复习 → 学习活跃）
2. ViewModel 层逐步迁移（不阻塞功能）
3. 动效补充（页面过渡 + AI 分析中状态）
4. 无障碍基础适配

2.3 KiB Raw Blame History Unescape Escape