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. 无障碍基础适配
|
|||
|
|
```
|