6.8 KiB
6.8 KiB
一期 MVP 演示与验收清单
本文件是 MVP 现场演示入口：先跑预检，再按演示流逐条点击。当前证明一期 MVP 路径可讲、可点、可截图；移动端员工端、候选人端、主管端首页已拆到独立 mobile/ 工程并按高保真原型实现，已接手机号短信登录，数据 API 优先请求 GET /api/aihr/mobile/home/{role} 并保留本地 fallback；员工端训练完成后写入 aihr_practice_session，用于训练历史、主管待复盘列表和能力画像；候选人端面试复用 AI 面试 API，补充资料上传写 sys_oss 和 aihr_candidate_material，HR 可在管理端审核通过/驳回；SOP 检索已可查本地 MySQL seed 片段，并支持 txt/md/PDF/Word/Excel/PPT 上传解析为本地 fragment，配置 vector 模型后会写入 embedding 并尽力同步 Qdrant，管理端 AI 面试和案例沉淀按真实模型/ASR 优先验收。
演示前预检
./scripts/demo-check.sh
预检通过只代表本地前端、基础接口、路由和关键标记在位。真实演示仍以浏览器点击为准。
现场演示脚本
| 顺序 | 页面 | 点击路径 | 必须看到 |
|---|---|---|---|
| 1 | 首页 /index |
打开首页 | 只展示“首页 / AI面试 / 三角色对练 / 案例沉淀 / SOP知识库 / 资料处理 / 系统设置-模型配置” |
| 2 | 移动端三端 http://127.0.0.1:5174/h5/user、/h5/candidate、/h5/supervisor |
打开后先手机号登录；已配置 AIHR_SMS_LOGIN_TEMPLATE_ID 时可真实收短信，新手机号会自动注册；员工端首页为「师傅区(头像+气泡+按住说话/打字问+快捷chips)→今日安排→我的地图(问/练/学/报四色块)→我的成长摘要」；点底部“练”进入 /h5/user/training，首屏必须先看到场景模拟、开始练习和最近练过，每日三题在下方；点“开始练习”必须切到 /h5/user/practice 对练页，完成两轮提交，再打开主管端；点快捷 chip 或「问」可文本/语音查 SOP，结果页点「生成总结卡·约10秒」弹出信息图卡（四步法/异议应对/开口话术/关键提醒+听一遍/开始跟读）；候选人端点“开始面试/面试练习”和“补充资料”；管理端 /recruit/interview 审核候选资料 |
员工端显示评分、“训练完成，主管端待复盘已更新”、训练历史和能力画像；底部 tab 整页切换（员工端为 今日/练/问/我，切换回顶），滚动后师傅头像收缩为右下悬浮球；未实现入口进「建设中」整页（返回首页按钮），无死按钮；主管端完训人数、“待复盘对练”计数和待复盘列表增加；训练页语音输入在浏览器录音失败时应切到“选择语音”而不是死按钮；点进待复盘记录可看评分、话术、导师改写，并可标记已复盘；候选人端可拉题/答题/评分，资料上传后显示“已提交资料”、OSS ...、待审核；HR 审核后候选人端显示 已通过/已驳回；接口不可用时走本地 fallback |
| 3 | AI面试 /recruit/interview |
生成题目 → 填满参考回答或输入真实回答 → 完成评分 | 配置 chat 模型时真实生成题目和评分；未配置时用本地 Rubric 估分，不返回固定候选人分数；应看到新增面试记录 |
| 4 | 三角色对练 /train/practice |
开始对练 → 填入参考回复或输入真实回复 → 继续一轮 → 结束并评分 | 已完成闭环、导师改写、新增对练记录；数据库已启用 chat 模型时，客户回复与评分为真实 LLM 生成（回复不再是固定台词，分数随话术变化），未配置时使用本地剧本兜底 |
| 5 | 案例沉淀 /knowledge/cases |
上传真实语音 → ASR 转写 → AI 整理 → 送审 → 入库 → 查看样片 | 已完成闭环，案例列表新增真实转写生成的记录；视频仍用样片兜底 |
| 6 | SOP知识库 /knowledge/sop |
上传 txt/md/PDF/Word/Excel/PPT 文档或使用 seed 文档 → 检索 → 生成训练题 | 已完成闭环、引用 SOP 原文片段、训练题已生成 |
| 7 | 资料处理 /knowledge/processing |
打开页面 → 查看解析任务 → 查看处理链路 → 可选点“服务端导入”导入 .data/import 下少量样例 |
可看到资料总量、等待/解析中/完成/失败、片段数、向量化状态和事件列表 |
AI陪练二期增量脚本
| 顺序 | 页面 | 点击路径 | 必须看到 |
|---|---|---|---|
| 1 | 管理端 /train/practice |
切换生活顾问场景 → 查看 Rubric/预习卡 → 开始对练 | 场景来自数据库 12 条 seed；Rubric、SOP 引用、预习卡可见；模型不可用时仍回退内置剧本 |
| 2 | 员工端 /h5/user |
今日安排 → 每日三题作答 → 开始训练 → 训练中点“求助” → 完成评分 | 每日三题即时反馈；求助命中 SOP 或明确报错；完成后画像、历史和主管端待复盘同步 |
| 3 | 主管端 /h5/supervisor |
预警/待复盘 → 进入复盘详情 → 听回放/看逐句标注 → 写复盘建议 → 派发再练 | 能看到评分、音频、逐句标注、主管建议；员工端今日安排出现专项/再练任务 |
| 4 | 管理端 /train/practice |
选择训练记录 → 人工校准评分 → 导出试点 CSV | 导出包含训练次数、完训率、平均分、预警数、主管复盘率、AI/人工分档一致率、SOP 可用率 |
| 5 | 模型成本闸门 | 设置 AIHR_AI_RUNTIME_ENABLED=false 后重启后端 → 调 /api/aihr/model/chat |
返回 cost-guard-fallback，chat/asr/tts 走现有文本兜底，不影响训练闭环 |
试点正式验收前，用 AIHR_PILOT_STRICT=true ./scripts/demo-check.sh 检查 M5 样本闸门；样本不足时应失败，不用静态演示 marker 代替真实试点数据。
录屏兜底
录屏只保留一条完整路径，不录框架后台配置。
- 从首页开始，左侧菜单依次进入四个页面。
- 每页只点上表的路径，停留 2 秒展示“必须看到”的验收文本。
- 若现场网络或浏览器状态异常，用本阶段通过验收的四张截图兜底：
/tmp/wygj-ai-interview-flow.png、/tmp/wygj-practice-flow.png、/tmp/wygj-cases-flow.png、/tmp/wygj-sop-flow.png。
不演示
- 不演示 SSO、权限配置、知识图谱、数字人视频生成、绩效挂钩。
- 不承诺管理端 AI 面试、案例沉淀已写入正式业务数据库；三角色对练（管理端与移动端）记录写入
aihr_practice_session；候选人补充资料写sys_oss+aihr_candidate_material，HR 可审核状态，但不做复杂审批流转；SOP 检索与文档上传使用aihr_knowledge_*本地表，失败时回退 seed。 - 大模型不作为演示硬依赖：模型管理已启用 chat 模型时，三角色对练为真实 LLM 生成与评分（asr/tts 配置后语音输入/播报可用）；未配置或现场调用失败时全链路自动回退 seed，演示不中断。