3.9 KiB
3.9 KiB
完成页「最终交付 · 逻辑回滚」审查报告（禁止应用）
审查对象：isFirstNodeInChapter 已恢复为含 .sorted { $0.order < $1.order } 的最终交付代码；确认不影响现有逻辑与展示。
结论：仅审查，不修改仓库内任何文件。
一、isFirstNodeInChapter 与当前仓库一致性
| 项目 | 当前仓库 | 本版交付 | 结论 |
|---|---|---|---|
| 排序 | validNodes = chapter.nodes.filter(...).sorted { $0.order < $1.order } |
同：.filter { $0.status != .locked }.sorted { $0.order < $1.order } |
✅ 一致 |
| 首节判定 | validNodes.first?.id == nodeId（在「包含 nodeId 的 chapter」内） |
validNodes.first?.id == nodeId（遍历每章，等价语义） |
✅ 等价 |
本版写法：对每章取 validNodes（filter + sort by order），若 validNodes.first?.id == nodeId 则返回 true。
当前写法：先找到包含 nodeId 的 chapter，再在该章内取 validNodes（filter + sort by order），返回 validNodes.first?.id == nodeId。
二者语义相同：「nodeId 是否为其所在章内按 order 排序后的第一个未锁定节点」。
结论：章节判定逻辑与现有实现保持 100% 一致，未改动核心逻辑。
二、loadMapData：无全局排序
- 本版：
realNodes = data.chapters.flatMap { $0.nodes }.filter { $0.status != .locked }，无.sorted。 - 当前：
allCourseNodes = data.chapters.flatMap { $0.nodes }.filter { $0.status != .locked }，无排序。
结论：保持「章节顺序 + 数组顺序」，未引入任何重排，与现有逻辑一致。
三、CompletionView
- 职责：仅 UI（粉紫勋章、共完成 N 节、底部「回到我的内容」）+
navStore.switchToGrowthTab()，无业务/数据逻辑。 - 接口：courseId / courseTitle / completedLessonCount 三参保留，与 CourseNavigation.completion 及三处 destination 兼容。
- 操作：全量替换
Views/CompletionView.swift即可。
结论：仅完结页 UI 更新，不影响现有逻辑与展示。
四、VerticalScreenPlayerView
4.1 已核对项
- Init：6 参未改，外部调用零影响。
- loadMapData：flatMap + filter，无 sort；allItems = realNodes.map(.lesson) + append(.completion)。
- isFirstNodeInChapter：含
.sorted { $0.order < $1.order }，与当前仓库等价。 - getChapterTitle：与当前一致。
- currentPositionProgress：仅按 lesson 项计算，忽略完结页。
- handleBack / 错误态 / toast / hideTabBar / showTabBar：均保留。
- LessonPageView：传
self.courseTitle ?? mapData?.courseTitle、navigationPath；headerConfig 仍用 isFirstNodeInChapter / getChapterTitle。 - CompletionView（内嵌）：courseId、courseTitle、completedLessonCount。
4.2 合并范围（再次强调）
- 仅替换
struct VerticalScreenPlayerView { ... }及内部的enum PlayerItem。 - 不得删除 同文件内的 HeaderConfig、DuolingoProgressBar、CourseProgressNavBar、LessonPageView、LessonSkeletonView、LessonErrorView、CompletionPlaceholderPage（或占位相关）等其余类型。
结论：在仅替换主视图 Struct 的前提下，现有逻辑与展示不受影响。
五、审查结论汇总
| 项目 | 结论 |
|---|---|
| isFirstNodeInChapter | 已恢复为含 .sorted { $0.order < $1.order } 的写法，与当前仓库语义一致，未改动核心判定逻辑。 |
| loadMapData | 无全局排序，保持原有顺序。 |
| CompletionView | 仅 UI 更新，可全量替换。 |
| VerticalScreenPlayerView | 仅替换主视图 Struct，保留同文件其余代码；其他逻辑与展示不变。 |
| 现有逻辑与展示 | 在按上述范围替换的前提下，不会受到影响。 |
未对仓库内任何文件进行修改。