298 lines
13 KiB
Markdown
298 lines
13 KiB
Markdown
# 03 C 端业务能力初步清单
|
||
|
||
> **本文档为第一阶段初步归类结果。正式业务能力分类以《04-C端正式业务能力树.md》为准。本文档仅用于保留盘点过程，不作为后续系统地图的主索引。**
|
||
|
||
> 基于 iOS 页面功能进行归并，形成业务能力目录。
|
||
> 本阶段仅分析 iOS 项目，不涉及 API、Rust、RAG 或 Admin 仓库。
|
||
|
||
---
|
||
|
||
## 1. 账号与用户
|
||
|
||
**能力说明：** 用户注册、登录、会话管理、账号状态管理、个人资料维护。
|
||
|
||
**关联页面：**
|
||
- 启动页（会话恢复）
|
||
- 登录页（Apple ID 登录）
|
||
- 账号状态页（禁用/注销展示）
|
||
- 编辑资料页（昵称、头像、学习身份、方向、目标、简介）
|
||
- 设置页（退出登录、账号信息）
|
||
|
||
**当前完成度：** 部分完成。核心登录和个人资料维护已完成。以下功能缺失或未接入：设备管理无 C 端入口、账号注销无 C 端入口（API 已就绪）、隐私政策和用户协议页面未接入。
|
||
|
||
---
|
||
|
||
## 2. 新手引导与目标设定
|
||
|
||
**能力说明：** 首次使用时的产品价值传递、学习目标和偏好配置。
|
||
|
||
**关联页面：**
|
||
- 欢迎页（功能介绍）
|
||
- 引导页（4 步产品引导）
|
||
- 目标设置页（学习目标/方法/时间）
|
||
- 学习目标设置页（后续修改）
|
||
- 方法偏好页（后续修改）
|
||
|
||
**当前完成度：** 部分完成。引导流程和目标设置 UI 已完成，但每日学习时长 dailyMins 仅保存在本地 @State 变量，不通过 API 持久化，用户下次进入恢复默认值。
|
||
|
||
---
|
||
|
||
## 3. 知识库管理
|
||
|
||
**能力说明：** 知识库的创建、浏览、搜索、筛选、订阅、删除，以及知识库级别的操作入口。
|
||
|
||
**关联页面：**
|
||
- 知识库首页（列表、筛选、搜索、创建入口）
|
||
- 知识库搜索页（搜索，待完善）
|
||
- 创建知识库页（封面、名称、描述）
|
||
- 发现公开库页（浏览、订阅/取消订阅）
|
||
- 知识库详情页（部分操作：删除知识库、文件夹管理入口）
|
||
|
||
**当前完成度：** 部分完成。搜索逻辑未实现，官方知识库筛选未支持，知识库管理页未实现。
|
||
|
||
---
|
||
|
||
## 4. 知识点管理
|
||
|
||
**能力说明：** 知识点是知识库的基本单元，支持增删改查、多种添加方式（手动/文件/图片/链接）、收藏、笔记。
|
||
|
||
**关联页面：**
|
||
- 知识库详情页·知识点 Tab（列表、排序、删除、批量删除、批量选择）
|
||
- 添加知识点页（手动、文件、图片）
|
||
- 知识点详情页（查看、收藏、笔记、原文）
|
||
- 编辑知识点页（修改标题和内容）
|
||
|
||
**当前完成度：** 部分完成。收藏功能后端 API 未支持，重命名 TODO，移动到文件夹 TODO。
|
||
|
||
---
|
||
|
||
## 5. 资料上传
|
||
|
||
**能力说明：** 将外部文件（PDF、文本、图片、链接）上传至知识库，支持多种导入方式，AI 自动提取知识点候选。
|
||
|
||
**关联页面：**
|
||
- 导入资料页（文件导入、相册导入、链接导入）
|
||
- 导入候选审核页（审核 AI 提取的知识点候选：接受/拒绝/全部接受）
|
||
|
||
**当前完成度：** 已完成。
|
||
|
||
---
|
||
|
||
## 6. 文档阅读
|
||
|
||
**能力说明：** 阅读学习资料，支持 Markdown、纯文本、PDF、EPUB、图片、Word、Excel、PowerPoint 等多种格式，具备阅读位置记录与恢复、阅读行为跟踪能力。
|
||
|
||
**关联页面：**
|
||
- 资料阅读页（多种格式渲染、标记已读、阅读位置恢复、阅读会话管理）
|
||
- 资料详情页（文件 AI 处理状态、元数据、阅读进度、关联学习内容统计）
|
||
- 系统预览（QuickLook，PDF/Office）
|
||
- 外部打开（ShareLink，PPT）
|
||
|
||
**当前完成度：** 已完成（核心阅读功能）。解析触发使用了 60×2s 硬编码轮询。
|
||
|
||
---
|
||
|
||
## 7. 阅读笔记
|
||
|
||
**能力说明：** 在阅读过程中快速创建笔记，自动记录锚点位置（材料/段落/行/页）。
|
||
|
||
**关联页面：**
|
||
- 快速笔记 Sheet（创建笔记、自动锚点记录）
|
||
- 知识点详情页（从知识点进入笔记）
|
||
|
||
**当前完成度：** 已完成。笔记存储在本地 UserDefaults。
|
||
|
||
---
|
||
|
||
## 8. 学习信息收集
|
||
|
||
**能力说明：** 收集用户在学习过程中的行为数据（阅读行为、学习时长、阅读位置、标记已读等），经客户端缓冲、批量上传、服务端聚合后，用于学习分析和继续学习推荐。这是学习数据管道的上位业务能力，包含以下子能力：
|
||
|
||
- **阅读行为采集：** 在资料阅读过程中自动跟踪用户的阅读事件（打开/关闭/翻页/心跳/标记已读），由 Rust Document Runtime V2 会话管理驱动，含崩溃恢复和离线重试队列。
|
||
- **专注学习会话：** 用户主动开始的计时学习，跟踪学习时长。
|
||
- **本地事件队列：** iOS 端通过本地上传队列管理阅读事件的暂存、去重和重试。
|
||
- **上传与重试：** 将阅读事件批量上传至服务端，含网络恢复自动重试机制。
|
||
- **服务端聚合：** 服务端将原始阅读事件聚合为学习会话、资料阅读进度、每日学习活动和学 习记录。
|
||
|
||
**关联页面：**
|
||
- 资料阅读页（阅读行为采集、阅读会话管理、位置记录、心跳上报、标记已读）
|
||
- 学习会话页（专注计时、暂停、结束）
|
||
- 分析页（学习摘要、趋势、连续统计等消费端展示）
|
||
- 学习主页（继续学习推荐、每周摘要）
|
||
|
||
**当前完成度：** 部分完成。阅读行为采集（Rust FFI V2 + 本地上传队列 + 服务端聚合）已完成；专注学习会话（LearningSessionView）的本地计时已完成，但代码中未发现调用 LearningSessionService API 保存学习记录的代码，服务端持久化暂未确认。
|
||
|
||
---
|
||
|
||
## 9. 继续学习
|
||
|
||
**能力说明：** 根据用户最近的学习状态，智能推荐下一步学习任务（继续阅读、今日复习、自我测试、开始学习）。
|
||
|
||
**关联页面：**
|
||
- 学习主页（优先级算法：继续学习 > 今日复习 > 自我测试 > 开始学习 > 空状态）
|
||
- 分析页（继续阅读入口）
|
||
|
||
**当前完成度：** 已完成。
|
||
|
||
---
|
||
|
||
## 10. AI 对话
|
||
|
||
**能力说明：** 与 AI 进行学习相关的自然语言对话，支持流式回复、思考过程展示、多会话管理、范围限定（知识库/资料/全局）。
|
||
|
||
**关联页面：**
|
||
- AI 对话页（发送消息、流式接收、思考过程、复制、重新生成、新建会话、会话列表与管理）
|
||
- AI 会话列表 Sheet（搜索、切换、删除、归档）
|
||
|
||
**当前完成度：** 已完成。
|
||
|
||
---
|
||
|
||
## 11. 主动回忆与 AI 反馈
|
||
|
||
**能力说明：** 用户对知识点进行主动输出（文字或语音回答），由 AI 评估掌握程度并给出评分、分析和改进建议。主动回忆 → AI 反馈是一个连续的用户体验流程。
|
||
|
||
**关联页面：**
|
||
- 主动回忆页（文字作答、语音作答占位、提交、AI 分析覆盖层、庆祝动画）
|
||
- AI 反馈页（分析动画、得分、答对/答错拆解、参考答案、加入待巩固、深入提问、再来一题）
|
||
- 每日思考页（查看思考题、提交回答获取 AI 反馈）
|
||
- 回忆测试页（查看测试题、提交获取 AI 反馈，无导航入口）
|
||
- 薄弱知识点页（薄弱点列表含掌握度分数和优先级）
|
||
- 分析页（AI 综合分析文字摘要）
|
||
|
||
**当前完成度：** 占位实现。主动回忆页使用 3 道硬编码问题，语音回答为占位 UI；AI 反馈页得分和文字硬编码（78/100）；薄弱知识点页 5 条数据硬编码；每日思考页和回忆测试页题目硬编码。上述页面均未接通真实 AI 分析 API。
|
||
|
||
---
|
||
|
||
## 12. 学习分析
|
||
|
||
**能力说明：** 以图表和数字形式展示用户的学习数据分析结果，包括掌握度趋势、阅读趋势、连续学习统计、学习推荐等。
|
||
|
||
**关联页面：**
|
||
- 学习分析页（统计徽章、掌握度趋势图、阅读时长趋势图、每周活跃图、连续统计、学习记录、学习推荐）
|
||
|
||
**当前完成度：** 部分完成。API 数据已接入，但掌握度趋势图和每周活跃柱状图的图表数据为硬编码 mock，未使用 API 返回的真实数据渲染。
|
||
|
||
---
|
||
|
||
## 13. 题目与测验
|
||
|
||
**能力说明：** AI 根据知识库内容生成测验题目，支持选择题、判断题、填空题，用户逐题作答，查看得分和逐题解析。
|
||
|
||
**关联页面：**
|
||
- 测验列表页（查看、生成）
|
||
- 测验作答页（选择/判断/填空、导航、提交）
|
||
- 测验结果页（得分、逐题详情、重新测验）
|
||
|
||
**当前完成度：** 已完成。
|
||
|
||
---
|
||
|
||
## 14. 间隔复习
|
||
|
||
**能力说明：** 基于间隔重复算法，以闪卡形式帮助用户复习知识点，用户自评掌握程度以调整复习计划。
|
||
|
||
**关联页面：**
|
||
- 复习卡片页（翻转卡片、自评四个等级、进度条、庆祝动画）
|
||
|
||
**当前完成度：** 占位实现。使用 3 张硬编码卡片，未接通 ReviewViewModel 和 API。ReviewViewModel 和 ReviewPlanViewModel 代码已就绪。
|
||
|
||
---
|
||
|
||
## 15. 存储空间管理
|
||
|
||
**能力说明：** 展示用户的存储空间使用情况和学习资产统计。注：当前代码中无会员/订阅/付费墙/内购实现。
|
||
|
||
**关联页面：**
|
||
- 个人中心页（存储空间展示、学习资产统计）
|
||
- 设置页（iCloud 同步开关，待确认）
|
||
|
||
**当前完成度：** 部分完成。存储展示基本完成，iCloud 同步实际后端能力待确认。
|
||
|
||
---
|
||
|
||
## 16. 消息与通知
|
||
|
||
**能力说明：** 系统通知的接收、列表查看、已读标记，以及通知偏好设置。
|
||
|
||
**关联页面：**
|
||
- 通知列表页（分组展示、标记已读、全部已读）
|
||
- 设置页（复习提醒、导入完成通知、系统通知开关）
|
||
|
||
**当前完成度：** 部分完成。通知开关绑定存在疑似 bug（多个开关共用同一个状态变量）。
|
||
|
||
---
|
||
|
||
## 17. 设置与合规
|
||
|
||
**能力说明：** 应用外观、语言、学习偏好、复习提醒、数据同步等全局设置，以及隐私政策、用户协议等合规入口。
|
||
|
||
**关联页面：**
|
||
- 设置页（外观切换、复习提醒、通知、存储、iCloud 同步、退出登录）
|
||
- 设置页合规入口（隐私政策、用户协议——导航未接入）
|
||
|
||
**当前完成度：** 部分完成。隐私政策、用户协议、设备管理页面入口无导航目标。
|
||
|
||
---
|
||
|
||
## 18. 帮助与反馈
|
||
|
||
**能力说明：** 用户提交 Bug 反馈、功能建议、内容问题等。
|
||
|
||
**关联页面：**
|
||
- 反馈页（选择反馈类型、输入描述、提交）
|
||
|
||
**当前完成度：** 已完成。
|
||
|
||
---
|
||
|
||
## 能力汇总
|
||
|
||
| 序号 | 能力名称 | 完成度 | 关键缺失 |
|
||
|------|---------|--------|---------|
|
||
| 1 | 账号与用户 | 部分完成 | 设备管理无入口、账号注销无 C 端入口、合规页面未接入 |
|
||
| 2 | 新手引导与目标设定 | 部分完成 | 每日学习时长缺乏可靠持久化 |
|
||
| 3 | 知识库管理 | 部分完成 | 搜索逻辑、官方库筛选、KB管理页 |
|
||
| 4 | 知识点管理 | 部分完成 | 收藏 API、重命名、移动到文件夹 |
|
||
| 5 | 资料上传 | 已完成 | — |
|
||
| 6 | 文档阅读 | 已完成 | 解析触发轮询可优化 |
|
||
| 7 | 阅读笔记 | 已完成 | 笔记存储在本地 UserDefaults |
|
||
| 8 | 学习信息收集 | 部分完成 | 阅读行为采集已完成；LearningSessionView 服务端持久化暂未确认 |
|
||
| 9 | 继续学习 | 已完成 | — |
|
||
| 10 | AI 对话 | 已完成 | — |
|
||
| 11 | 主动回忆与 AI 反馈 | 占位实现 | 全部数据硬编码，语音未实现，未接真实 AI API |
|
||
| 12 | 学习分析 | 部分完成 | 图表数据为 mock（占位实现） |
|
||
| 13 | 题目与测验 | 已完成 | — |
|
||
| 14 | 间隔复习 | 占位实现 | 全部数据硬编码，未接 API |
|
||
| 15 | 存储空间管理 | 部分完成 | iCloud 同步待确认 |
|
||
| 16 | 消息与通知 | 部分完成 | 通知开关绑定 bug |
|
||
| 17 | 设置与合规 | 部分完成 | 合规页面入口缺失 |
|
||
| 18 | 帮助与反馈 | 已完成 | — |
|
||
|
||
---
|
||
|
||
## 业务能力依赖关系（初步）
|
||
|
||
```
|
||
账号与用户
|
||
└─ 新手引导与目标设定
|
||
└─ 知识库管理
|
||
├─ 知识点管理
|
||
│ └─ 阅读笔记（知识点详情页笔记入口）
|
||
├─ 资料上传 → 文档阅读
|
||
│ ├─ 阅读笔记
|
||
│ ├─ 学习信息收集（阅读行为采集 → 服务端聚合）
|
||
│ │ └─ 学习分析
|
||
│ ├─ AI 对话（资料范围对话）
|
||
│ └─ 题目与测验（解析完成后进入测验）
|
||
└─ AI 对话（知识库范围对话）
|
||
├─ 继续学习 → 文档阅读 / 题目与测验
|
||
│ └─ 主动回忆与 AI 反馈 → 间隔复习（加入待巩固）
|
||
├─ 学习分析
|
||
└─ 存储空间管理
|
||
```
|
||
|
||
---
|
||
|
||
> **下一阶段待办：** 扩展到 API、Rust、RAG、Admin 仓库的业务能力分析。
|