7.5 KiB
7.5 KiB
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 项