版本对比

页面35-resume-versions.html · 简历版本对比 F5（P1）· 验收见 ⑧ · 分工见 ⓪

阅读方式：每条先写界面上是什么，再写元素 ID 与接口。

展示顺序（按角色 · 章节号固定）

• 产品 / 老板：⓪ → ①～⑤ → ⑧
• 测试：⑧ → ①～⑤ → ⑦
• 研发：接口速查 → ①～⑤ → ⑥ → ⑦
• UI：①～⑤（图标路径在控件下）
• 数据 / 增长：⑨ → ⑥
• 多态页：③ 内分态 · ⑥⑦⑧⑨ 号不变

接口本页共 2 个 · GET /resumes/{id}/versions · POST /resumes/{id}/restore · 原型静态 mock · 完整见 ⑥

⓪ 本页做什么 · 分工速查

一句话：同一份简历的多个历史版本左右对照，支持预览当前版、回滚到旧版（P1）。

• 产品 / 老板：⑧；≥2 版本才进对比；每份简历最多 15 条历史 → 开放项
• 测试：⑧ + 仅 1 版态 + 空态 + 回滚确认（上线后）
• UI：顶栏版本切换 chip + 双栏 diff 摘要 + 贴底双按钮
• 前端 / 后端：GET /resumes/{id}/versions · POST /resumes/{id}/restore · dev-notes · F5

① 顶栏

• 「←」返回箭头 · 顶栏左侧 · 可点击 → btn_nav_back
  • fallback 15-resume-list.html 或 33-resume-preview.html
• 「版本对比」 · 顶栏标题 → page_title
• 「F5」 · 顶栏右侧标签 → badge_f5

② 策略说明 · 标题下灰字

• 「多版本对比 · 每份简历最多 15 条 · 对齐 JD 后自动存版」 → copy_version_policy

③ 版本选择与双栏对比 · 默认 #compare 态

• 容器 → list_version_picker
• 版本 chip · 可点击切换对比列 → btn_version_left · btn_version_right
• 「秋招版 · v3 当前」 · 右列 chip · 高亮当前版 → btn_version_right
• 双栏容器 → panel_version_diff
• 左栏 · compare_col_left · label_version_left「v2」· diff_content_left「负责公众号排期」（删除线示意）
• 右栏 · 当前版边框强调 · label_version_right「v3 当前」· diff_content_right「使用 Excel 复盘 UV/转化，参与用户增长执行」

④ 说明卡片 · 其它态 Tab

• 「对比为模块级摘要示意…超出 15 条时自动删最旧版本。」 → copy_version_hint
• 「暂无可对比版本」 · 仅 1 版态 → state_single_version · copy_single_hint · btn_go_continue → F4
• 「加载版本列表…」 → state_versions_loading
• 「还没有简历版本」 · 空态 → state_versions_empty · btn_empty_create → F2

⑤ 贴底按钮栏 · 屏幕最底部

• 容器 → bar_f5_actions
• 「回滚到此版」 · 底栏左 · 可点击 → btn_restore_version · 二次确认 · Toast「已回滚」（原型 mock）
• 「预览当前版」 · 底栏右主按钮 → btn_preview_current → 33-resume-preview.html

⑥ 版本对比 · 本页共 2 个接口

说明：版本 chip 与双栏 diff 为静态 mock；上线由下列接口渲染 list_version_picker · panel_version_diff。替换清单 → dev-notes · 静态 mock → API。

• ① GET /resumes/{id}/versions
  • 何时调：进页 onLoad · 带 URL resume_id · 从列表/预览「版本」进入
  • 鉴权：需登录 · 401 → 登录后回跳
  • 响应 · versions[] → chip + diff · 字段 version_id · label · is_current · diff_summary
  • 响应示例：{ "versions": [{ "version_id": "v2", "label": "腾讯 JD · v2" }, { "version_id": "v3", "label": "秋招版 · v3 当前", "is_current": true }] }
  • 失败与边界：仅 1 条 → state_single_version · 0 条 → state_versions_empty · 最多 15 条 FIFO
• ② POST /resumes/{id}/restore
  • 何时调：点 btn_restore_version 且用户确认 HUD
  • 请求 · { "version_id": "v2" }
  • 成功：刷新列表 · Toast「已回滚」
  • 失败：409 / 5xx → Toast + 可重试 · 原型无真实交互

⑦ 入口 · 出口

• 入口：1.0 无 C 端入口 · 原型直开 35-resume-versions.html 或 index 研发目录 · 勿从列表/预览链入
• 出口：← fallback 列表或预览 · 「预览当前版」→ 33 · 回滚后留本页或回列表（上线交互见 ⑨ / dev-notes）

⑧ 怎么验收

1. 左右对照：chip「腾讯 JD · v2」/「秋招版 · v3 当前」· 双栏 diff 文案须与 ③ 开发说明一致。
2. 接口专章：打开说明滚到 ⑥，可见两接口何时调、字段映射、仅 1 版/空态边界。
3. 打开：Finder 双击 35-resume-versions.html（P1 原型 · 无用户路径入口）。
4. Tab：切「仅 1 版」「空态」「加载」对照引导 UI。
5. 机内交互：点版本 chip 切换高亮 · 点「回滚到此版」→ confirm + Toast。
6. 跨页：点「预览当前版」→ 33 张小雨完整预览。
7. 返回：← 应回简历列表（无历史时 fallback）。

⑨ 团队补充

• 图标资产（第二批） · app-image/ICON-CATALOG.md · 全站通用 §7 · 上传 §8 · 品牌 §9 · 本页见 §10 索引表
• 图标资产（第三批） · app-image/ICON-CATALOG.md · 状态栏 §11 · 增长/分享 §12 · 表单/附件 §13 · 法务 §14 · 订单/空态 §15 · 媒体/语音 §16 · 本页见 §10
• 图标资产（第四批） · app-image/ICON-CATALOG.md · F4 模块 §18 · 状态徽章 §19 · 弹窗/加载 §20 · 联系打码 §21 · 折叠/更多 §22 · 文件类型 §23 · 分享装饰 §24 · 账号 §25 · 本页见 §10
• 分期与排期 · 产品/研发见 launch-static-to-api · 开发说明 ②～⑦ 不写「阶段 N」
• 埋点 · version_compare_view · version_restore_click · version_restore_confirm
• 版本策略：F1 应用成功写入新版本；每份简历最多 15 条 → 开放项
• 原型限制：对比内容为静态示例；回滚为 Toast mock · 脚本 _f5-prototype.js · 正式上线 → launch-static-to-api

字段/API 见 dev-notes · F5；UX 见 mkq产品规则 · UX。