# 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 项**