WangDL
fe608da385
- 文档从扁平结构迁移至分类目录 (api-server/ios-projects/web-projects/长期规划) - 更新总待完成清单 (B1-B6 全部完成, I1-I7 全部完成) - 新增后端实现状态、已实现功能汇总等已完成文档 - 新增 iOS 功能需求清单、架构设计、差距分析等文档 - 清理旧版未维护文档 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
88 lines
2.3 KiB
Markdown
88 lines
2.3 KiB
Markdown
# iOS 缺失项与待补全方向
|
||
|
||
> 仅列出当前未完成的项目。已完成内容见 [`已完成/[已完成]-已实现功能汇总.md`](./已完成/[已完成]-已实现功能汇总.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
|
||
|
||
---
|
||
|
||
## 当前最应该推进
|
||
|
||
```text
|
||
1. 后端 API 对接（知识库列表 → 学习会话 → 复习 → 学习活跃）
|
||
2. ViewModel 层逐步迁移（不阻塞功能）
|
||
3. 动效补充（页面过渡 + AI 分析中状态）
|
||
4. 无障碍基础适配
|
||
```
|