JD 镜像对齐

页面06-f1-align.html · JD 镜像对齐（主路径第 4 步 / 共 7 步）· 验收见 ⑧ · 分工见 ⓪

阅读方式：每条先写界面上是什么，再写元素 ID 与接口；多态页打开说明时只展示当前态 + ⓪①⑧⑨。

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

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

接口本页共 2 个 · POST /ai/f1/align · POST /ai/f1/apply · 完整见下方 ⑥

⓪ 本页做什么 · 分工速查

一句话：对比 JD 与简历，给出匹配度、关键词缺口与改写建议，用户勾选后部分/全部应用。

• 产品 / 老板：⑧；必须写清「非官方 ATS」；用户须核对 AI 建议真实性
• 测试：部分应用未勾选 Toast · 全部/部分应用 → E2 · 失败不扣点 · 额度不足引导充值
• UI：匹配度 + 标签云 + 可勾选建议列表 + 贴底双按钮
• 前端 / 后端：POST /ai/f1/align、POST /ai/f1/apply · dev-notes · F1
• 已拍板：部分/全部应用成功 **写入版本历史**（每份简历最多 **15** 条）→ 开放项

① 顶栏

• 「←」返回箭头 · 顶栏左侧 · 可点击 → btn_nav_back
  • fallback 05-jd-paste.html
• 「JD 镜像对齐」 · 顶栏标题 → page_title
• 「步骤 4/7 · 10 能量点」 · 小字随态变化 → label_f1_step（加载「对齐中…」/ 失败「对齐未成功」）
• 「AI」 · 顶栏右侧合规标签 · 只展示 → copy_ai_disclaimer

⑥ JD 对齐 · 本页共 2 个接口

说明：匹配度「68/100」、关键词缺口与 3 条建议由 _f1-prototype.js mock；上线 align 渲染结果区、apply 写版本。替换清单 → dev-notes · 静态 mock → API。

• ① POST /ai/f1/align · 生成对齐结果
  • 何时调：从 JD 进入（?from=jd）· 失败页 btn_retry_f1 · 同 resume_id+jd_id 未变可不重复请求
  • 鉴权：需登录 · 余额 ≥ 10 · 不足 → state_quota_empty
  • 入参：resume_id · jd_id（或 jd_text）
  • 响应 → 控件
    • match_score（0～100）→ display_match_score · 免责声明 copy_match_disclaimer
    • keyword_gaps[] · term + status（miss/hit/weak）→ list_keyword_gaps
    • suggestions[] → list_f1_suggestions · chk_apply_item · card_suggestion
  • 响应示例：{ "match_score": 68, "keyword_gaps": [{ "term": "Python", "status": "miss" }, { "term": "Excel", "status": "hit" }], "suggestions": [{ "suggestion_id": "s1", "original": "…", "suggested": "…" }] }
  • 扣点：align 成功扣 10 点；失败/超时不扣 · jd 为空不调模型
• ② POST /ai/f1/apply · 应用改写
  • 何时调：结果态点 btn_apply_partial 或 btn_apply_all
  • 入参：resume_id · apply_type=partial|all · partial 时 suggestion_ids[]（≥1 条勾选）
  • 出参：version_id · 写入版本历史（每份简历最多 15 条）
  • 边界：partial 未勾选 → Toast，不调 API；apply 失败不生成新版本
• 失败与边界：401 → 跳登录；网络/5xx → state_ai_error

⑦ 入口 · 出口

• 入口：JD 页「开始 JD 对齐」→ 本页先 state_ai_loading（?from=jd）
• 出口：apply 成功 → 07-e2-hr-preview.html?from=f1；← fallback 05-jd-paste.html

⑧ 怎么验收

1. 左右对照：结果态「68/100」匹配度、关键词标签（Python ✗ / Excel ✓）、3 条可勾选建议须与 ②～④ 及 ⑥ 响应示例一致。
2. 接口专章：打开说明滚到 ⑥，可见 align/apply 何时调、字段→控件、扣点与版本上限。
3. Finder 双击 06-f1-align.html，或从 JD 页「开始 JD 对齐」进入（先 loading 再结果）。
4. 取消全部勾选 → 点「部分应用」→ Toast；点「全部应用」→ Toast → 跳转 E2。
5. Tab 切「失败」「额度不足」对照 UI；失败页「重试」回结果；← 回 JD 页。

⑨ 团队补充

• 图标资产（第二批） · 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」
• 埋点 · f1_apply（附 apply_type）
• 合规：须保留「非官方 ATS · 仅供参考」· 用户须核对 AI 建议真实性
• 原型限制：align/apply mock · 替换 _f1-prototype.js · 正式上线 → launch-static-to-api

字段/API 见 dev-notes · F1。