职业规划

页面19-career-plan.html · 职业规划 · 1.1 · 验收见 ⑧ · 分工见 ⓪

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

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

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

接口本页唯一 · POST /ai/career/plan → display_plan_report · 原型 mock · 完整见 ⑥

⓪ 本页做什么 · 分工速查

一句话：简历+意向生成简版职业路径建议，非 Offer/猎头承诺。

• 产品 / 老板：⑧；≥15% 完成报告 · 链技能课
• 测试：⑧ + 介绍/表单/生成中/报告四态 Tab
• UI：介绍卡 + 表单 + AI 报告 + 推荐课入口
• 前端：规划 AI· 详 ⑥
• 合规：「非猎头/职业担保」· AI 仅供参考

① 顶栏 · 屏幕最上方

• 返回箭头 → btn_nav_back · 优先 history.back() · fallback 23-assistant-tab.html · index 机模 data-embed-back="shell" 回当前 Tab 壳层
• 「职业规划」 · 顶栏标题 · 无 1.1 角标
• 「简版路径建议 · 非猎头/职业担保」 · 副说明（介绍态）

② 介绍态 · 主内容（#intro）

• 「3 分钟了解你的方向」 · 卡片标题
• 说明 bullet · 「适合：已导出简历…」 · 「约 3 分钟完成一份可执行路径」 · 只展示
• 「开始采集」 · 橙色主按钮 → btn_start_form

③ 信息采集 · 主内容（#form）

• 表单 → form_career_intake · 意向行业/城市/困惑
• 「当前困惑（选填）」 · 多行 → input_career_concern
  • 长度：0～500 字 · maxlength="500"
  • 格式：纯文本 · 提交前 trim · 不解析 HTML
  • 选填：可不填 · 点「生成规划报告」不因本框为空红框
  • 非空提交后：有内容随请求 concern 提交 · 成功切 loading → 报告态 · 原型保留输入
• 「生成规划报告」 · 贴底主按钮 → btn_generate_plan

④ 生成中 · 全屏（#loading）

• 「AI 分析中…」 · 主文案 · 只展示
• 「通义企业版 · 待上线」 → 已改为 「预计还需片刻，请稍候」 · loading 灰色小字 · 不上屏供应商

⑤ 报告态 · 主内容（#report）

• 「AI 规划建议 · 仅供参考」 · 报告头
• 「建议路径：产品运营 → 用户增长」 → display_plan_report
• 3～6 个月行动 bullet · mock
• 「去看推荐技能课」 · 列表行 → link_career_to_courses · 链 20-skill-courses.html
  • published_count=0（PRD Q8）→ 隐藏本行 · 原型 mock 仍展示
  • 有课但无缺口匹配 → 仍展示 · 进 20 见 ③「暂无与你简历缺口匹配的课程」
• 「AI 生成」 · 徽章 · 只展示

⑥ 职业规划 · POST /ai/career/plan（本页唯一）

说明：表单 + 简历摘要生成报告；原型 mock 报告区。上线渲染 display_plan_report。替换清单 → dev-notes · 静态 mock → API。

• 何时调 · btn_generate_plan · 非进页 GET
• 鉴权 · 需登录 · 扣点规则见 dev-notes
• 请求 · industry · cities · concern · resume_id
• 响应→控件 · report.sections[] → display_plan_report · show_course_cta（boolean，或进页读 GET /courses 的 published_count）→ 控制 link_career_to_courses 显隐
• 课程出口 · 联动 20-skill-courses ⑥
  • show_course_cta=false 或 published_count=0 → 不渲染 link_career_to_courses
  • 展示时点击 → 20 列表或 20 ③ 空态 · 不由本页重复做空态 UI
• 失败与边界 · 空校验红框 · 超时 Toast · 可重试

⑦ 入口 · 出口

• 入口：助手 · 能力中心 1.1 扩展
• 出口：20-skill-courses.html · 返回能力中心

⑧ 怎么验收

1. 左右对照：报告态「建议路径：产品运营 → 用户增长」须与 ⑤ 一致。
2. 接口专章：滚到 ⑥ · 可见 POST /ai/career/plan 请求体与报告区映射。
3. 打开：双击 19-career-plan.html · 四态 Tab 可切换。
4. 介绍：见「开始采集」与非担保文案。
5. 流程：「开始采集」→ 表单 · 「生成规划报告」→ loading → 报告 · Toast mock。
6. 跨页：报告「去看推荐技能课」→ 20-skill-courses.html · 全站无课时本行隐藏 · 无匹配时在 20 见 ③。

⑨ 团队补充

• 图标资产（第二批） · 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」
• 埋点 · career_plan_start · career_plan_done · career_to_course
• 原型限制：静态报告 · _career-prototype.js mock 流程 · 正式上线 AI + 课程 published_count 控 CTA → launch-static-to-api