151 lines
7.5 KiB
Markdown
151 lines
7.5 KiB
Markdown
# 07 待修正文档清单
|
||
|
||
> 列出所有需要在已有系统地图文档中修正的条目，按优先级排序。
|
||
|
||
---
|
||
|
||
## P0 — 影响整体地图正确性（必须修正）
|
||
|
||
### P0-1：每日学习时长不持久化 → 02-iOS页面功能总表
|
||
|
||
- **涉及文档：** 02-iOS页面功能总表.md
|
||
- **位置：** 我的 Tab → "修改每日时长"
|
||
- **当前状态：** 已完成
|
||
- **修正为：** 部分完成
|
||
- **原因：** GoalSettingDetailView 中 dailyMins 只保存在本地 @State 变量，未通过 API 持久化。用户下次进入设置页时恢复默认值"30 分钟"。
|
||
- **备注栏补充：** "UI 选择完成，但选择结果不通过 API 保存"
|
||
|
||
### P0-2：分析页图表数据为占位实现 → 02-iOS页面功能总表
|
||
|
||
- **涉及文档：** 02-iOS页面功能总表.md
|
||
- **位置：** 分析 Tab → "查看掌握度趋势图" 和 "查看每周学习活跃"
|
||
- **当前状态：** 部分完成
|
||
- **修正为：** 占位实现
|
||
- **原因：** ZXChartView 使用硬编码 `[("一", 0.62), ...]` 数据，ZXWeekBarChart 使用硬编码 `[("一", 0.3), ...]` 数据。两组数据均未从 ViewModel 的 API 数据读取，属于完全占位实现。
|
||
- **备注栏补充：** "图表组件使用编译时硬编码的 7 天数据，未接入 ViewModel API 返回的真实数据"
|
||
|
||
### P0-3：设置页通知开关绑定 bug → 02-iOS页面功能总表
|
||
|
||
- **涉及文档：** 02-iOS页面功能总表.md
|
||
- **位置：** 我的 Tab → "切换导入完成通知"、"切换系统通知"
|
||
- **当前状态：** 暂未确认
|
||
- **修正为：** 部分完成（存在 bug）
|
||
- **原因：** SettingsView 中"复习提醒"、"导入完成通知"、"系统通知"三个 Toggle 全部绑定到同一个 `$reviewReminder` 变量（见 SettingsView.swift:61-65）。这不是"待确认"，而是明确的代码 bug。
|
||
- **修正状态描述：** "三个通知开关绑定到同一状态变量，需修复为各自独立绑定"
|
||
|
||
### P0-4：文档声称的页面总数与实际不符
|
||
|
||
- **涉及文档：** 00-iOS-C端总览.md
|
||
- **位置：** 第四节"页面总览"
|
||
- **当前描述：** "共盘点出 43 个页面/弹窗"（已完成 19 + 部分完成 13 + 占位实现 7 + 暂未确认 1 + 未完成 3）
|
||
- **实际：** 独立基线盘点出 38 个独立 Push 页面 + 10 个 Sheet/弹窗 + 8 个确认弹窗 + 1 个废弃页面 = 总计约 47 个可盘点对象（含弹窗）
|
||
- **说明：** 文档的"43"如果指页面+弹窗，则遗漏了 RecallTestPage（代码存在无入口）、部分 Alert 弹窗。建议明确统计口径并更新数字。
|
||
|
||
---
|
||
|
||
## P1 — 遗漏主要页面或业务能力
|
||
|
||
### P1-1：遗漏 RecallTestPage
|
||
|
||
- **涉及文档：** 01-iOS页面地图.md, 02-iOS页面功能总表.md
|
||
- **遗漏对象：** RecallTestPage (Features/AI/RecallTestPage.swift)
|
||
- **应补到位置：** 01 第六章 AI 辅助功能，新增 6.6 节"回忆测试页"
|
||
- **建议状态：** 占位实现（无导航入口 + 题目硬编码）
|
||
- **功能表补充：** 查看回忆测试题、输入回答、提交获取 AI 反馈（→ AIFeedbackPageView）
|
||
|
||
### P1-2：遗漏 AIChatPage 会话置顶功能
|
||
|
||
- **涉及文档：** 02-iOS页面功能总表.md
|
||
- **遗漏对象：** AI 对话页 → 会话列表 Sheet → 左滑置顶/取消置顶
|
||
- **应补到位置：** AI 辅助功能 → AI 对话页
|
||
- **新增行：** "置顶/取消置顶会话 | 左滑→置顶/取消置顶 | 切换会话置顶状态 | 已完成"
|
||
|
||
### P1-3：遗漏 WaitlistService API 已就绪但 C 端无入口
|
||
|
||
- **涉及文档：** 00-iOS-C端总览.md 或 03-C端业务能力初步清单.md
|
||
- **遗漏对象：** WaitlistService（/waitlist POST, /waitlist/stats GET）
|
||
- **说明：** API 服务代码完整但无任何 View/ViewModel 调用。应标注为"后端已就绪，C 端入口未实现"。
|
||
|
||
### P1-4：遗漏账号注销 API 已就绪但无入口
|
||
|
||
- **涉及文档：** 03-C端业务能力初步清单.md → 账号与用户
|
||
- **遗漏对象：** UserService.requestAccountDeletion() 和 cancelDeletion()
|
||
- **说明：** API 端点 /users/me/deletion-request POST/DELETE 已就绪，但设置页及其他页面均未提供注销账号入口。
|
||
- **建议：** 在"账号与用户"能力中补充"账号注销 API 已就绪，C 端入口未实现"
|
||
|
||
---
|
||
|
||
## P2 — 命名、描述、辅助状态问题
|
||
|
||
### P2-1：业务能力"会员与额度"命名不准确 → 03
|
||
|
||
- **涉及文档：** 03-C端业务能力初步清单.md
|
||
- **当前命名：** 17. 会员与额度
|
||
- **修正为：** 存储空间管理（或"存储与额度"）
|
||
- **原因：** 代码中无任何会员/订阅/付费墙/内购实现。该能力实际包含的功能仅为存储空间展示和学习资产统计。
|
||
|
||
### P2-2：建议合并"主动回忆"与"AI 学习分析" → 03
|
||
|
||
- **涉及文档：** 03-C端业务能力初步清单.md
|
||
- **当前：** 15. 主动回忆 和 12. AI 学习分析 为两个独立能力
|
||
- **建议：** 合并为"主动回忆与 AI 反馈"
|
||
- **原因：** 主动回忆 → AI 反馈是一个连续用户体验流程，不应拆分为两个独立业务能力
|
||
|
||
### P2-3：StudyHomeViewModel 错误状态永不可达 → 01
|
||
|
||
- **涉及文档：** 01-iOS页面地图.md
|
||
- **位置：** 2.1 学习主页 → 页面主要状态
|
||
- **当前描述：** "加载中 / 错误 / 已加载·有任务 / 已加载·空状态"
|
||
- **补充说明：** "注：View 支持 error 状态展示，但 ViewModel 中所有 API 调用使用 try? 吞错，error 状态在实际运行中永不可达"
|
||
|
||
### P2-4：DailyThinkingPage submitted 变量 bug → 01
|
||
|
||
- **涉及文档：** 01-iOS页面地图.md
|
||
- **位置：** 6.2 每日思考页
|
||
- **补充说明：** "注：submitted 状态变量在代码中从未被设置为 true，提交按钮始终可见，可能导致用户重复提交"
|
||
|
||
### P2-5：设置页自引用导航 → 01
|
||
|
||
- **涉及文档：** 01-iOS页面地图.md
|
||
- **位置：** 5.3 设置页
|
||
- **当前描述：** "存储空间"行和"登录设备管理"行 → Route.settings
|
||
- **补充说明：** "存储空间"和"登录设备管理"导航目标均为 Route.settings（指向设置页自身），形成无效的自引用
|
||
|
||
### P2-6：知识库详情页操作菜单"知识库管理"按钮 → 01
|
||
|
||
- **涉及文档：** 01-iOS页面地图.md
|
||
- **位置：** 3.3 知识库详情页
|
||
- **当前描述：** 用户可执行操作中未包含此按钮
|
||
- **补充说明：** 操作菜单中存在"知识库管理"按钮，但 action 为空（// TODO），属未实现功能
|
||
|
||
### P2-7：业务能力依赖关系图缺少交叉引用 → 03
|
||
|
||
- **涉及文档：** 03-C端业务能力初步清单.md
|
||
- **位置：** "业务能力依赖关系（初步）"
|
||
- **补充以下分支：**
|
||
- AI 对话 → 知识库管理（知识库范围对话）
|
||
- AI 对话 → 文档阅读（资料范围对话）
|
||
- 文档阅读 → 题目与测验（解析完成后进入测验）
|
||
- 阅读笔记 → 知识点管理（知识点详情页笔记入口）
|
||
- 主动回忆 → 间隔复习（AI 分析后加入待巩固 → 安排间隔复习）
|
||
- 学习分析 → 学习信息收集（分析依赖信息收集数据）
|
||
|
||
### P2-8：文件夹新建/重命名 Alert 未列入确认弹窗表 → 01
|
||
|
||
- **涉及文档：** 01-iOS页面地图.md 9.6 节"各类确认弹窗"表格
|
||
- **补充行：**
|
||
- 新建分类 | FolderManageView | 点击"新建"
|
||
- 重命名分类 | FolderManageView | 滑动→重命名
|
||
|
||
---
|
||
|
||
## 修正优先级汇总
|
||
|
||
| 优先级 | 数量 | 影响范围 |
|
||
|--------|------|---------|
|
||
| P0 | 4 | 状态误判会导致整体地图失真 |
|
||
| P1 | 4 | 遗漏主要页面/功能/API 入口 |
|
||
| P2 | 8 | 命名、描述、辅助状态完善 |
|
||
|
||
**总计待修正项：16 项**
|