ios-projects/docs/system-map/ios/review/06-页面能力覆盖矩阵.md

105 lines
7.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 06 页面能力覆盖矩阵
> 双向覆盖检查:页面→能力 + 能力→页面
---
## 一、页面→能力覆盖(每个页面至少归属一个业务能力)
| 页面 | 归属业务能力 | 主要功能 | 文档是否覆盖 | 状态判断是否正确 |
|------|------------|---------|------------|----------------|
| P01 启动页 | 账号注册与登录 | 自动恢复会话 | 是 | 是 |
| P02 欢迎页 | 新手引导与目标设定 | 产品介绍、引导登录 | 是 | 是 |
| P03 登录页 | 账号注册与登录 | Apple ID 登录 | 是 | 是 |
| P04/P05 账号状态页 | 账号注册与登录 | 禁用/注销状态展示 | 是 | 是 |
| P06 引导页 | 新手引导与目标设定 | 4 步产品引导 | 是 | 是 |
| P07 目标设置页 | 新手引导与目标设定 | 设定目标/方法/时间 | 是 | 是 |
| P08 学习主页 | 继续学习、学习分析 | 优先级算法、今日任务、每周摘要 | 是 | 是 |
| P09 学习会话页 | 学习信息收集 | 专注计时 | 是 | 状态偏乐观API 保存待确认) |
| P10 复习卡片页 | 间隔复习 | 闪卡翻转、自评 | 是 | 是(标记为占位实现) |
| P11 主动回忆页 | 主动回忆与 AI 反馈 | 文字/语音作答 | 是 | 是(标记为占位实现) |
| P12 知识库首页 | 知识库浏览与管理 | 列表/筛选/分页 | 是 | 是 |
| P13 知识库搜索页 | 知识库浏览与管理 | 搜索 | 是 | 是 |
| P14 知识库详情页 | 知识库浏览与管理、知识点管理 | 双 Tab/排序/批量操作/删除 | 是 | 是 |
| P15 创建知识库页 | 知识库浏览与管理 | 创建知识库 | 是 | 是 |
| P16 添加知识点页 | 知识点管理 | 手动/文件/图片添加 | 是 | 是 |
| P17 知识点详情页 | 知识点管理、文档阅读 | 查看/渲染/收藏/笔记 | 是 | 部分(收藏 API 未支持) |
| P18 编辑知识点页 | 知识点管理 | 编辑标题/内容 | 是 | 是 |
| P19 导入资料页 | 资料上传与处理 | 文件/相册/链接导入 | 是 | 是 |
| P20 导入候选审核页 | 资料上传与处理 | 候选审批 | 是 | 是 |
| P21 发现公开库页 | 知识库浏览与管理 | 浏览/订阅公开库 | 是 | 是 |
| P22 学习分析页 | 学习分析 | 统计/趋势图/记录/推荐/薄弱点 | 是 | 部分(趋势图为占位) |
| P23 个人中心页 | 个人资料维护、设置与应用偏好 | 资料/菜单/资产/存储 | 是 | 是 |
| P24 编辑资料页 | 个人资料维护 | 头像/昵称/身份/目标 | 是 | 是 |
| P25 设置页 | 设置与应用偏好、消息与通知 | 外观/复习/通知/存储/退出 | 是 | 部分(通知开关 bug合规入口缺失 |
| P26 学习目标设置页 | 新手引导与目标设定 | 修改目标/时长 | 是 | 否dailyMins 不持久化,文档标已完成) |
| P27 方法偏好页 | 新手引导与目标设定 | 多选方法 | 是 | 是 |
| P28 通知列表页 | 消息与通知 | 查看/标记已读/全部已读 | 是 | 是 |
| P29 帮助与反馈页 | 帮助与反馈 | 选择类型/输入/提交 | 是 | 是 |
| P30 AI 对话页 | AI 对话 | 流式对话/会话管理 | 是 | 是 |
| P31 每日思考页 | 主动回忆与 AI 反馈 | 查看题目/提交回答 | 是 | 是(标记为占位) |
| P32 AI 反馈页 | 主动回忆与 AI 反馈 | 分析评分/建议/导航 | 是 | 是(标记为占位) |
| P33 薄弱知识点页 | 学习分析 | 查看薄弱点列表 | 是 | 是(标记为占位) |
| (废) AIHomeView | AI 对话、主动回忆、间隔复习、学习分析 | 快速操作/思考题/推荐 | 是(标记为废弃) | 是 |
| P34 测验列表页 | 题目与测验 | 查看/生成测验 | 是 | 是 |
| P35 测验作答页 | 题目与测验 | 选择/判断/填空作答 | 是 | 是 |
| P36 测验结果页 | 题目与测验 | 得分/逐题详情/重测 | 是 | 是 |
| P37 资料阅读页 | 文档阅读、阅读笔记、阅读行为跟踪、学习信息收集、AI 对话 | 多格式渲染/位置恢复/标记已读/AI/笔记 | 是 | 是 |
| P38 资料详情页 | 文档阅读 | AI 处理状态/元数据/进度 | 是 | 是 |
| S01 会话列表 Sheet | AI 对话 | 会话搜索/切换/删除/归档/置顶 | 是 | 遗漏置顶功能 |
| S02 快速笔记 Sheet | 阅读笔记 | 创建笔记/锚点记录 | 是 | 是 |
| S03 系统预览 | 文档阅读 | PDF/Office 预览 | 是 | 是 |
| S04 封面选择 Sheet | 知识库浏览与管理 | 相册选择封面 | 是 | 是 |
| S05 文件夹管理 Sheet | 知识库浏览与管理 | 文件夹 CRUD | 是 | 是 |
| (无入口) RecallTestPage | 主动回忆与 AI 反馈 | 回忆测试 | 否 | 遗漏 |
| (无入口) WaitlistService | 未归类 | waitlist 加入/统计 | 否 | 遗漏API 存在但无 C 端入口) |
---
## 二、能力→页面覆盖(每个能力是否有实际页面入口)
| 业务能力 | 有页面入口? | 关联页面 | 遗漏关联页面 | 错误关联 |
|---------|------------|---------|------------|---------|
| 账号注册与登录 | 是 | P01,P03,P04,P05 | 无 | 无 |
| 新手引导与目标设定 | 是 | P02,P06,P07,P26,P27 | 无 | 无 |
| 知识库浏览与管理 | 是 | P12,P14,P15,P21,S04,S05 | 遗漏 P13搜索页 | 无 |
| 知识点管理 | 是 | P14,P16,P17,P18 | 无 | 无 |
| 资料上传与处理 | 是 | P19,P20 | 无 | 无 |
| 文档阅读 | 是 | P17,P37,P38,S03 | 无 | 无 |
| 阅读笔记 | 是 | S02,P37 | 遗漏 P17知识点详情页笔记入口 | 无 |
| 阅读行为跟踪 | 是(自动) | P37 | 无 | 无 |
| 学习信息收集 | 是(自动) | P09,P37 | 无 | 无 |
| 继续学习 | 是 | P08,P22 | 无 | 无 |
| AI 对话 | 是 | P30,S01,P37 | 遗漏 P14知识库范围 AI 对话) | 无 |
| 题目与测验 | 是 | P34,P35,P36 | 无 | 无 |
| 学习分析 | 是 | P22,P33 | 无 | 无 |
| 主动回忆与 AI 反馈 | 是(占位) | P11,P31,P32 | 遗漏 RecallTestPage | 无 |
| 间隔复习 | 是(占位) | P10 | 无 | 无 |
| 学习会话计时 | 是 | P09 | 无 | 无 |
| 消息与通知 | 是 | P28,P25 | 无 | 无 |
| 设置与应用偏好 | 是 | P25,P26,P27 | 无 | 无 |
| 帮助与反馈 | 是 | P29 | 无 | 无 |
| 存储空间管理 | 是 | P23,P25 | 无 | 无 |
| 会员与额度(文档命名) | — | — | 无实际会员/订阅代码 | 文档将存储+资产归入此项不准确 |
---
## 三、无法归类的页面或功能
| 对象 | 问题 | 建议 |
|------|------|------|
| WaitlistService | API 完整但无 C 端入口 | 在系统地图中标注为"后端已就绪C 端未接入" |
| RecallTestPage | 代码存在但无导航入口 | 归类到"主动回忆与 AI 反馈",标注为占位实现 |
| AIHomeView | 已废弃,无法归类到实际能力 | 保持现状,作为废弃页面参考 |
| UserService.requestAccountDeletion | API 存在但无页面入口 | 在"账号与用户"能力中标注"账号注销 API 已就绪C 端入口未实现" |
---
## 四、双向覆盖检查结论
- **页面→能力:** 43/43 个可访问页面均已归属至少一个业务能力。RecallTestPage无入口未归属。
- **能力→页面:** 19/20 个能力有实际页面入口。"会员与额度"能力无实际会员/订阅代码支持。
- **遗漏关联页面:** 5 处(知识库搜索页、知识点详情页笔记入口、知识库范围 AI 对话、RecallTestPage、WaitlistService
- **错误关联:** 无
- **状态判断错误:** 2 处(学习会话 API 保存、GoalSetting dailyMins 持久化)