feat(aihr): complete uni-app role workflows

docs/20260708/uni-app用户侧前端重建计划.md

@@ -0,0 +1,231 @@
+# uni-app 用户侧前端重建计划
+
+> 日期: 2026-07-08
+> 结论: 新建并行工程 `mobile-uni/`, 按真实页面栈重建用户侧。旧 `mobile/` 保留为当前演示版本, 不在原 4000 行单页上继续堆功能。
+
+## 1. 重建判断
+
+现有 H5 的主要问题不是单个按钮或样式,而是信息架构不成立: 三端、多个功能和临时面板被揉在一个 `App.vue` 里,靠锚点、状态开关和手写 history 模拟页面。它能撑住 MVP 演示,但不适合继续承载员工端 APP/H5/小程序。
+
+本轮重建目标:
+
+- 用 uni-app Vue3 先做 H5,后续保留 APP 和小程序转换空间。
+- 用户、主管、候选人按角色拆页面,不是同一长页面内切锚点。
+- API 优先接真实后端,不新增前端 mock 数据；后端已有 seed fallback 只作为服务端降级链保留。
+- 每个页面只解决一类任务,让用户得到明确反馈,减少心智负担。
+
+## 2. 工程结构
+
+并行目录:
+
+```text
+mobile-uni/
+  src/
+    pages/
+      auth/login/
+      user/today/
+      user/sop/
+      user/practice/
+      user/profile/
+      supervisor/index/
+      candidate/index/
+    services/
+      api.ts
+      auth.ts
+      home.ts
+      knowledge.ts
+    types/
+      api.ts
+    styles/
+      base.css
+    pages.json
+    manifest.json
+```
+
+关键约束:
+
+- `App.vue` 只放应用级生命周期和全局样式,不承载业务页面。
+- 页面跳转使用 uni-app 页面栈和 tabBar,不手写锚点切换。
+- 认证令牌沿用当前 H5 的 `aihr_mobile_access_token` 和 `aihr_mobile_client_id`。
+- 开发代理沿用 `/dev-api -> http://127.0.0.1:8080`。
+
+## 3. 三端页面计划
+
+### 用户端
+
+第一优先级。首页按“数字师傅”心智组织:
+
+- `pages/user/today`: 今日安排、首要训练、待办、常用入口。
+- `pages/user/sop`: 问师傅/SOP 检索、答案卡、引用、打勾打叉、总结卡。
+- `pages/user/practice`: 场景练习、每日三题、训练前预习和 SOP 求助,已接 `/api/train/practice/start|turn|finish`。
+- `pages/user/profile`: 训练历史、能力画像、个人信息。
+
+### 主管端
+
+不做员工端同款 tab。主管目标是看人、复盘、派活:
+
+- 团队概览: 完训率、低分项、预警。
+- 待复盘: 对练记录、逐句标注、标记已复盘。
+- 指派训练: 按岗位和短板派发专项。
+- 团队画像: 个人趋势和短板热力图。
+
+### 候选人端
+
+候选人是低频线性漏斗,不做复杂 tab:
+
+- 面试任务。
+- 补充资料。
+- 岗前预习。
+- 进度通知。
+
+## 4. 开发范围
+
+第一批已从“用户侧最小集合”扩展到三端主链路闭环。当前已完成:
+
+1. `mobile-uni/` 工程初始化,可 H5 构建。
+2. 手机号验证码登录,接真实 `/resource/sms/code` 和 `/auth/mobile/sms-login`。
+3. 员工今日页,接真实 `/api/aihr/mobile/home/user`。
+4. 问师傅页,接真实 `/api/knowledge/search`。
+5. 答案反馈,接真实 `/api/knowledge/answer-feedback`。
+6. 总结卡,接真实 `/api/knowledge/summary-card`。
+7. 员工对练、每日三题、个人画像和案例素材。
+8. 主管团队概览、复盘、派专项和员工回读。
+9. 候选人面试、资料上传、HR 审核状态回读和岗前预习。
+
+仍不做:
+
+- 不迁移管理端。
+- 不把旧 `mobile/src/App.vue` 直接拆搬到新工程。
+- 不新增前端 mock 数据掩盖后端接口问题。
+
+## 5. 验收口径
+
+第一批完成标准:
+
+- `npm --prefix mobile-uni run build:h5` 通过。
+- 本地后端启动后,能用 dev 固定验证码登录。
+- 今日页能展示后端返回的用户首页数据；接口失败时明确报错,不白屏。
+- 问师傅页能检索正式资料,展示答案、要点、引用和 caution。
+- 打勾/打叉提交后页面锁定反馈状态,失败时保留原状态。
+- 总结卡显式点击才生成,失败可重试。
+
+## 6. 当前进展
+
+- 第一批用户侧主链路已落地到 `mobile-uni/`: 登录、今日页、问师傅、答案反馈、总结卡、对练页、个人页。
+- 本机开发入口已切到 portless: `https://wygj-mobile-uni.localhost/h5/`。
+- README 和本地运行手册已对齐新用户侧工程: `mobile-uni/` 作为当前施工/测试入口,旧 `mobile/` 仅保留为 MVP 演示兜底;线上 H5 发布命令改为同步 `mobile-uni/dist/build/h5/`。
+- 演示验收和 API 对接文档已切到 `mobile-uni` 路由;`scripts/demo-check.sh` 的移动端预检默认检查 `https://wygj-mobile-uni.localhost/h5/` 与新工程 marker,不再用旧 `mobile/src/App.vue` 证明当前用户侧。
+- 快速启动口径已补齐: `./scripts/dev.sh` 明确只启动后端、管理端和旧移动端兜底,当前用户侧由 `portless` 启动;脚本输出同步提示 `wygj-mobile-uni.localhost`。
+- 主管端已接入最小复盘闭环: 团队概览、待复盘列表、复盘详情、标记已复盘。
+- 候选人端已接入最小闭环: 候选首页、结构化面试、最近面试记录、补充资料列表、文件上传、审核状态展示。
+- 主管到员工的训练闭环已接入: 主管指派专项、员工今日任务、每日三题提交与反馈。
+- 三端登录返回已修正: 从主管/候选人/员工子页进入登录后返回原任务页,已有登录态进入登录页时自动回跳。
+- 登录页已补方法级重复请求保护: 发验证码和登录除按钮禁用外,函数入口也会挡住重复触发。
+- H5 默认入口已改为用户今日页: `/h5/#/` 直接进入今日,登录页只在认证动作需要时出现。
+- H5 旧入口已补兼容重定向: `/h5/user`、`/h5/candidate`、`/h5/supervisor` 及 employee/admin/user 子路径会跳到对应 uni hash 页面,避免旧验收链接都落到员工首页。
+- H5 案例素材旧入口已补兼容重定向: `/h5/user/cases` 会跳到 `/pages/user/cases/index`,避免新增案例页直链落回默认首页。
+- 未实现入口已接通建设中整页: 今日页未迁移入口不再只 toast,会进入明确反馈页。
+- 三端页头基础样式已修正: `page-title/page-subtitle` 统一块级显示,避免 uni `text` 默认内联导致标题和副标题粘连。
+- H5 导航标题已统一 custom: 不再同时显示 uni 原生导航标题和页面内页头,避免“主管/主管”“候选人/候选人”这类重复标题。
+- 主管团队画像已补最小版: 团队预警接入 `/api/aihr/mobile/practice/alerts`,低分预警可带入专项派发。
+- 候选人面试记录已按当前候选人隔离: 启动面试传当前手机号/候选人名,最近面试按 `candidateId` 查询,不再共用内置李娜记录。
+- 候选人端已补进度通知和岗前预习: 进度由面试记录与资料审核状态计算,岗前预习复用正式 `/api/knowledge/search`。
+- 候选人端已移除“填参考”开发辅助按钮: 正式候选人流程只允许提交本人真实回答,避免样例答案污染面试数据。
+- 候选人端顶部主任务卡已改为真实状态派生: 按面试记录和资料审核状态显示待面试/待补资料/审核中/已通过,不再固定显示首页 seed 的 `0/1`。
+- 候选人面试重启状态已收敛: 重新生成题目前清空旧题和旧会话,提交评分增加会话状态保护,避免启动失败后残留不可编辑旧题。
+- 员工端“我”页已接成长证据包: 复用 `/api/aihr/mobile/profile/promotion-evidence`,展示等级、测评分、训练分钟、贡献度和证据条目。
+- 员工端“我”页已展示成长路径: 复用 `/api/aihr/mobile/profile` 的 `growthPath`,展示初/中/高级进度与达成依据,不自动给晋升结论。
+- 主管端复盘已接人工贡献分: 复用 `ReviewAdviceRequest.incentivePoint`,由主管手填后进入员工成长证据包,不自动给晋升结论。
+- 主管端已补团队画像: 复用真实待复盘记录和训练指派数据聚合个人风险、待复盘、待训练和最近得分,可一键带入专项指派。
+- 主管端从团队画像派专项时已保留员工姓名和外部 ID: 指派记录不再把已选员工统一写成“手机用户xxxx”。
+- 主管端复盘已支持顺手派下一次训练: 复用 `ReviewAdviceRequest.nextScenarioId/nextReason`,标记已复盘时可同步生成专项训练。
+- 主管端团队预警的聚合动作已改为“去画像”: 预警本身不含员工标识,点击后滚动定位团队画像,具体派发仍从画像员工行进入,避免一键误派给默认手机号。
+- 主管端指派专项已收敛操作面板: 默认不再把主管本人手机号当指派对象,必须选择员工或手动输入;历史记录只展示最近专项,不混入每日三题流水。
+- 主管端团队画像待训练口径已收敛: 只统计主管指派专项,不再把员工每日三题误算进主管待训练。
+- 主管端概览低分口径已收敛: 顶部低分预警直接跟随后端 `low_score` 预警数量,不再用当前画像截断列表推导高风险人数。
+- 主管端复盘详情已补回放承载: 对话片段存在 `audioUrl` 时展示原生音频控件;当前本地样本无音频 URL,浏览器已验证详情/标注/派发区域无回归。
+- 主管端写操作已补方法级重复提交保护: 指派专项和标记复盘除按钮禁用外,方法入口也会挡住重复调用。
+- 员工端每日三题已修正参考答案泄露: 新任务只存题干,旧数据返回时清洗 `reason/feedback`,未完成题只提示“提交后显示反馈与参考答案”,完成后才单独展示参考答案。
+- 员工端每日三题排序已改为按题目生成顺序展示: 后端 assignments 查询对 `source=daily` 按 ID 升序返回,不再把第 3 题排在最前。
+- 员工端专项训练已补完成回写: 主管指派返回真实专项 ID,员工从专项入口完成对练后对应 `aihr_practice_assignment` 会置为已完成,不再长期卡在“待训练”。
+- 员工端成长证据贡献度已收紧: 无训练记录且无主管人工加分时贡献度为 0,不再给空用户默认 20 分。
+- 员工端训练前预习卡已接入: 新 uni-app 对练页复用 `/api/train/practice/scenarios/{id}/prep-card`,开始前展示要点、红线和可说话术。
+- 员工端训练前预习卡与页头已收敛展示: 隐藏内部 promptVersion,训练卡标题跟随当前专项场景,页头不再固定写“投诉接待”。
+- 员工端训练中已接 SOP 求助: 新 uni-app 对练页复用 `/api/knowledge/search`,展示正式检索答案和引用,失败明确报错不兜假答案。
+- 员工端对练建议已接调节按钮: 老师傅建议生成后可按“再严肃/再温柔/更细致/更专业”调用 `turn` 的 `regenerate/style`,只替换建议不重复计分。
+- 员工端训练中已展示情绪/信任/红线纠偏: 新 uni-app 对练页直接渲染 `turn` 返回的 `emotion/trust/redFlag`,让员工看到话术对业主状态的影响。
+- 员工端红线话术已改为同轮重说: `redFlag=true` 时不推进下一轮、不结束评分,提示员工按老师傅建议重说当前轮;纠正提交会替换本轮旧话术,与后端覆盖语义一致。
+- 员工练习页已收敛重复触发: 每日三题提交中会禁用其他提交按钮,对练非空闲状态会禁用专项开始,避免重复请求覆盖当前训练会话。
+- 员工端训练闭环已用真实浏览器跑通: 登录员工开始练习、提交回应、结束评分后写入训练记录,个人页成长摘要/证据包/最近练过同步更新;每日三题提交后原地显示得分、反馈和参考答案。
+- 员工练习页写操作已补方法级 guard: 开始练习、SOP求助、建议调节、提交回应和结束评分除按钮状态外,函数入口也会挡住重复触发。
+- 员工今日页“我的地图”已改为优先渲染 `/api/aihr/mobile/home/user` 返回的工具项;SOP复习入口会把复习标题带入问师傅页,不再因标题关键词不匹配落到建设中。
+- 员工今日页已移除前端硬编码工具 fallback: 工具地图只渲染后端返回项,接口无工具时显示空态,不再用“问/练/学/报”假数据兜底。
+- 员工今日页师傅气泡已移除固定姓名 fallback: 未登录显示“同事”,登录后按手机号尾号提示,不再把 seed 姓名暴露给真实用户。
+- 员工今日页“查看全部”和小贴士箭头已接通动作: 分别进入练习页和带问题进入问师傅,不再保留看起来可点但无反馈的入口。
+- 员工今日页未登录视图已收敛: 公开 home 的 `primary/review` 不再渲染成私人“今日安排”,改为登录提示;工具区未登录时显示为“常用入口”。
+- 员工今日页问答入口文案已收敛: 当前 uni-app 首页只负责进入问师傅页,主按钮改为“问老师傅”,不再用“长按说话”暗示已实现录音交互。
+- 员工今日页训练文案已收敛: 首页主任务从“3分钟语音练习”改为“3分钟情景练习”,不再承诺当前 uni-app 尚未提供的语音对练入口。
+- 问师傅页已补登录守卫: 未登录检索会保留当前问题并跳登录,不再直接暴露“认证失败”。
+- 移动端认证清理已收敛到共享 `clearAuth()`: 主动退出和 401/403 会同时清掉 token、clientId、手机号和登录回跳,避免旧手机号残留。
+- 员工“我”页已补过期登录态反馈: 401/403 清理后会同步刷新当前页面为“未登录/去登录”,不再继续显示旧手机号和退出按钮。
+- 员工“我”页未登录视图已收敛: 最近练过面板只在登录后展示,未登录不再出现“暂无训练记录”私人空态。
+- 主管端已补过期登录态反馈: 加载、指派、打开复盘和标记复盘遇到 401/403 后会收起团队面板并提示重新登录。
+- 主管端过期登录态已清理表单草稿: 指派对象、复盘建议、贡献分和复盘后专项随私有数据一起重置,避免换主管登录后残留上一轮操作。
+- 候选人端、案例素材页、问师傅页已同步过期登录态反馈: 资料/面试/预习/案例/检索接口 401/403 后清空私有数据并提示重新登录。
+- 移动端上传和 XHR 响应已复用共享认证错误处理: 候选人资料、案例音频和普通请求遇到非 JSON 的 401/403 也会同步清登录态,不再绕过过期处理。
+- 成功态草稿已收敛: 案例素材入库后清空已选音频,主管专项指派成功后清空指派对象和原因,避免用户误点重复提交。
+- 问师傅页已补未登录入口面板: 未登录或登录过期时直接显示“需要登录/去登录”,不再只留一条提示文案。
+- 问师傅页已收敛重复检索: 检索中快捷问题会禁用,`search()` 和总结卡生成都有 loading 守卫,避免并发请求互相覆盖结果。
+- 问师傅页待问问题已停止未登录自动跳转: 从首页带问题进入时先展示问师傅页和登录面板,用户点查询/去登录后再保留问题回登录,减少突然跳页。
+- 问师傅页待问问题登录返回已补自动续查: 未登录时不提前清掉暂存问题,登录成功回到问师傅后再清理并自动检索。
+- 员工练习页已补未登录和过期态反馈: 未登录不再显示“暂无今日任务”假空态,401/403 后清空当前对练状态并回登录。
+- 员工练习页过期登录态已清理训练草稿: 对话、草稿、SOP求助答案、情绪/信任/红线状态和专项选择会一起重置,避免旧训练上下文残留。
+- 候选人端未登录视图已收敛: 主任务卡改为登录提示,最近面试和补充资料私有空态只在登录后展示,不再把公开 home seed 当真实任务。
+- 主管端和候选人端未登录页头已隐藏无意义刷新按钮: 未登录只保留登录入口,避免点击后无业务反馈。
+- 候选人岗前预习文案已收敛: 未登录按钮显示“登录查看”,登录后显示“生成预习”,空态说明从正式知识库生成要点,不再用“加载”暗示不明确动作。
+- 主管端和候选人端页头已停止直接渲染公开 home 的 seed 问候语,避免固定演示姓名出现在真实用户入口。
+- 主管端真实复盘/指派数据已去掉公开 home 依赖: 页面不再因未使用的首页 seed 请求失败而阻断团队画像、待复盘和专项列表。
+- 员工端已接案例素材页: `案例学习/提交素材` 入口进入 `/pages/user/cases/index`,复用 `/api/knowledge/case/upload|organize|curate|records` 完成语音转写、结构化整理、入库和最近案例展示。
+- 案例素材页已用真实接口和浏览器回读跑通: 临时语音经 ASR 返回 `real-asr`,整理返回 `real-llm`,入库后案例页“最近案例”显示已入库记录。
+- 案例素材页未登录刷新已改为跳登录: 最近案例不再出现点击无反馈的刷新按钮,空态提示登录后查看。
+- 案例素材页已补方法级重复触发保护: 处理流程中不能替换音频,最近案例加载中不会重复刷新。
+- 案例入库提示已从“预渲染样片”改为真实案例库口径,避免员工端继续暴露旧演示文案。
+- 员工训练/画像/证据包已移除前端 `mobile-user` 兜底身份: 个人数据必须来自登录手机号,缺登录信息时明确提示登录,不再读写共享假身份。
+- 候选人端认证边界已收紧: APP 候选人资料、面试启动和面试记录以后端登录手机号为准,前端 `candidateId/candidateName` 只作非 APP 场景兼容参数;HR 资料审核接口保留管理端角色口径。
+- 候选人资料上传-审核-回读闭环已用真实 multipart 走通: APP 候选人上传后写 `sys_oss/aihr_candidate_material`,管理端 HR 审核通过后,候选人端资料列表回读为 `已通过`;本地 dev 验证记录保留用于回归追踪。
+- 候选人资料进度已改为按最新资料行判定: 重新上传并通过后,历史驳回记录不再覆盖当前“资料已通过/等待通知”状态。
+- 候选人端已移除前端 `mobile-candidate` 兜底身份: 缺登录手机号时明确提示登录,不再读写共享候选人身份。
+- 移动端登录态判断已收紧为 token/clientId/手机号三者齐全: 旧缓存缺手机号时不再显示已登录,避免训练、画像和候选人资料读到空身份。
+- 候选人端写操作已补方法级重复触发保护: 资料上传、岗前预习检索和面试提交除按钮禁用外,函数入口也会挡住重复调用。
+- 候选人端主任务动作已按进度分流: 待补资料/资料驳回时主按钮走上传资料,不再把“重新提交资料”误导到重新面试。
+- 候选人端未登录主动作已改为可点击跳登录: 开始面试、岗前预习、上传资料不再因 disabled 造成无反馈。
+- 候选人端主链路已从 home seed 解耦: 公开首页接口异常时仍展示面试主动作,登录后的面试记录和资料列表继续走真实接口加载,不把非关键 home 错误暴露给用户。
+- 候选人端审核中主动作已收敛: 资料待审核/已通过时主按钮只刷新进度,不再提示“重新面试”造成阶段误导;待补资料/资料驳回仍走上传。
+- 主管端派专项已补场景自动匹配: 从团队画像选择员工时按投诉/报修/噪音/电梯/催缴等关键词选对应专项,不再把非催费低分默认派成催费沟通。
+- 主管端最近专项回读已修正: 后端专项列表改为非 daily 优先,避免每日三题占满前 10 条导致手工指派成功后页面仍显示 0 条。
+- 主管端团队画像派专项已用真实浏览器跑通: 从画像低分员工预填对象和场景后提交,最近专项立即回读新指派记录;低分预警“去画像”锚点已落到团队画像面板。
+- 候选人端页头称呼已收敛: 已登录副标题改为手机号尾号,不再和页面标题拼出“候选人候选人0001”。
+- 候选人端未登录主任务卡已收起: 未登录只保留登录面板,不再同时出现两处“去登录”入口。
+- 主管端低分预警已落到可操作对象: 待复盘列表优先返回低分记录,团队概览用全量预警数展示,避免“有低分预警但画像看不到低分员工”。
+- 主管端关键动作已补可见落点: 团队画像“派专项”会带到已预填的指派面板,待复盘记录会带到复盘详情;复盘后同时派专项时成功提示明确为“已复盘并派专项”。
+- 员工今日页未登录状态已停止加载公开 home: 未登录只显示登录提示和问师傅入口,不再渲染公开工具地图或空工具区。
+- 员工练习页未登录状态已收起训练卡: 未登录只保留登录提示,不再展示“今日小训/开始练习”业务卡。
+- 案例素材页未登录状态已收起最近案例面板: 未登录只保留登录提示,不再重复显示“登录查看”按钮和私人案例空态。
+- 问师傅页登出态已清理上次答案: `onShow` 发现未登录会清空答案、总结卡和反馈锁定态,避免已登录检索结果残留在未登录页面。
+- 问师傅页引用依据已兼容真实后端字段: `/api/knowledge/search` 返回的 `snippets.title/text` 会在服务层归一为 `docTitle/content`,移动端不再显示空白引用;长 ASR/文档片段只展示摘要,避免视频转写铺满页面。
+- 问师傅总结卡已补全展示字段: 页面现在渲染 `objections` 的“异议回应”,不再丢掉模型返回的常见异议和回应话术;真实浏览器已验证“业主投诉噪音怎么安抚”总结卡可见异议区。
+- 候选人端面试提交已收紧为全部题目必答: 真实浏览器验证只填 1/3 题时提示“请填写全部 3 题回答”,不生成评分记录。
+- 候选人端面试主链路已用真实 API 跑通: dev 手机号登录后 `/api/recruit/interview/start` 返回 `source=real-llm` 题目,3 题答完后 `/finish` 生成评分,`/records` 可回读最新面试记录。
+- 候选人端资料上传链路已用真实 multipart 跑通: dev 手机号登录后上传资料写入 `sys_oss/aihr_candidate_material`,候选人资料列表立即回读同一记录,状态为 `待审核`。
+- 候选人资料 HR 审核/候选人回读已用真实 API 复跑: 管理端 token 调 `/api/aihr/hr/candidate/materials/{id}/review` 审核通过后,候选人重新登录调用 `/api/aihr/mobile/candidate/materials` 回读到 `已通过`。
+- 员工端练习结束评分已补边界: 未提交回应前不能结束评分,红线纠偏时需先重说;真实浏览器验证提交一轮后可结束评分并写入主管待复盘。
+- 员工端每日三题提交/回读已用真实 API 跑通: 新手机号首次加载生成 3 条 daily 任务,提交一题后状态变 `已完成`,回读到用户答案、反馈和参考答案;未提交前参考答案为空。
+- 主管复盘-派专项-员工回读闭环已用真实 API 跑通: 员工完成一场对练生成 `待复盘`,主管读取复盘详情可见对话和标注,标记已复盘并带 `nextScenarioId` 后该记录不再出现在待复盘列表,员工专项列表立即回读复盘后手工专项。
+- PC 成长激励和组织权限页已收口真实数据边界: 派专项必须输入真实员工手机号或 extPartyId,不再写入 `mobile-user`;无项目范围接口时只显示空态,不再展示假项目样例。
+
+## 7. 风险
+
+- uni-app npm tag 不是普通语义化版本,依赖必须固定同一 `vue3` release train。
+- H5 路由和将来小程序路径不完全一致,页面命名要早期克制。
+- 旧 H5 在 Alpha 前仍承担演示兜底,新工程未完成替换前不能下线旧入口。
+- 如果后端某些接口仍要求管理端 token,需要后端补移动端认证口径,不能在新前端绕过认证。

docs/20260708/发布会演示候选题单.md

@@ -0,0 +1,72 @@
+# 发布会演示候选题单
+
+> 生成时间：2026-07-08
+> 来源口径：基于已入库正式资料生成，不使用本地 smoke 题作为验收依据。
+> 状态说明：本文件是开发方候选题单，最终题单需业务方确认后锁定。
+
+## 生成依据
+
+- 正式资料目录：`/Users/yuanjiantsui/workspace/项目-物业AI/补充资料`
+- 已入库知识库：`aihr_knowledge_attach` 共 106 个附件，`aihr_knowledge_fragment` 共 450 个片段。
+- 当前向量状态：450/450 片段已使用 `BAAI/bge-m3` 向量化，Qdrant 维度匹配。
+- 已处理视频：`生活顾问的一天.mp4` 已转写并可检索。
+- 暂不作为主依据：其余 27 个 MP4 仍为 `pending-transcribe`，转写前不纳入现场演示题主池。
+- 复跑命令：`node scripts/verify-demo-questions.mjs --prefix=Q`；业务测试扩展题可用 `--prefix=E` 验证。
+
+## 现场实操优先题
+
+以下 12 题适合发布会现场“问”模块演示，已于本地接口验证 12/12 可检索、可生成直给答案。
+
+| 编号 | 场景 | 候选问题 | 主要来源 | 验证状态 |
+|---|---|---|---|---|
+| Q01 | 生活顾问一天 | 生活顾问的一天有哪些关键动作，早晚分别要做什么？ | `生活顾问的一天.mp4`、`陈明- 银城物业新员工培训25.2.pptx` | 已验证 |
+| Q02 | 投诉接待 | 接到业主投诉保洁不满意，生活顾问第一步应该怎么处理？ | `生活顾问的一天.mp4`、`投诉处理 SOP v1.0` | 已验证 |
+| Q03 | 漏水拒缴 | 业主家楼上漏水还想拒交物业费，生活顾问应该怎么答？ | `楼上漏水，能拒缴物业费吗？.pptx` | 已验证 |
+| Q04 | 楼道堆物 | 楼道堆物影响通行和消防，生活顾问应该怎么处理并留痕？ | `楼道杂物添“堵”，物业公司公告后清理被起诉.pptx`、`放在楼道里的东西丢了，找物业赔偿，法院支持吗？.pptx` | 已验证 |
+| Q05 | 违规装修 | 发现业主违规装修，生活顾问怎么劝阻、上报和闭环？ | `客户违规装修.pptx` | 已验证 |
+| Q06 | 电梯舆情 | 电梯维保问题在业主群引发舆论，生活顾问应该先做什么？ | `电梯维保引发业主群舆论.pptx` | 已验证 |
+| Q07 | 地面摔伤 | 地砖或路面破损导致业主摔伤，生活顾问现场处理步骤是什么？ | `小区红线内骑车摔倒.pptx`、`物业未及时扫雪导致业主摔伤.pptx` | 已验证 |
+| Q08 | 消防通道 | 消防通道被车辆或杂物占用，生活顾问应该怎么处理？ | `消防通道堵塞.pptx`、`楼道杂物添“堵”，物业公司公告后清理被起诉.pptx` | 已验证 |
+| Q09 | 报修跟进 | 业主报修后反复催问进度，生活顾问应该怎么跟进？ | `报修跟进 SOP v1.0`、`客户违规装修.pptx` | 已验证 |
+| Q10 | 催缴沟通 | 催缴物业费时业主情绪抵触，生活顾问应该怎么开场沟通？ | `催缴沟通 SOP v1.0`、`楼上漏水，能拒缴物业费吗？.pptx` | 已验证 |
+| Q11 | 群内曝光 | 业主在微信群曝光他人不当行为，生活顾问应该如何引导？ | `微信群内曝光业主不当行为.pptx` | 已验证 |
+| Q12 | 高空坠物 | 高空抛物或外立面部件坠落砸车，生活顾问要做哪些动作？ | `高空抛坠物损害责任纠纷.pptx` | 已验证 |
+
+## 业务测试扩展题
+
+以下题目适合 07-10 到 07-12 业务方实测使用。建议业务方选出高频真实问题后，再进入正式演示锁题。
+
+| 编号 | 场景 | 候选问题 | 主要来源 | 建议用途 |
+|---|---|---|---|---|
+| E01 | 公共收益 | 小区公共收益能不能直接用于公共设施维修，生活顾问怎么解释？ | `小区内公共收益使用.pptx` | 问答准确性 |
+| E02 | 收费调整 | 物业公司能否自行调整物业收费标准，业主质疑时怎么答？ | `物业公司未经法定程序随意调整物业收费标准.pptx` | 问答准确性 |
+| E03 | 停水群诉 | 停水造成业主群诉时，生活顾问先做哪些动作？ | `停水造成业主群诉.pptx` | 投诉场景 |
+| E04 | 返水财损 | 管道堵塞或厨房污水返流造成室内财产损失，生活顾问怎么处理？ | `管道堵塞造成室内返水.pptx`、`一楼厨房污水返流财产受损事件.pptx` | 投诉场景 |
+| E05 | 车库财损 | 车库被淹或风管脱落砸坏车辆，生活顾问如何响应和留痕？ | `车库被淹车辆受损.pptx`、`车库风管脱落砸坏车辆.pptx` | 风险处置 |
+| E06 | 道闸事故 | 道闸损坏造成伤人伤车，现场应该如何处理？ | `道闸损坏伤人伤车.pptx` | 风险处置 |
+| E07 | 楼道灯损坏 | 楼道灯损坏导致业主摔伤，项目应承担什么处置动作？ | `楼道灯损坏导致他人摔伤.pptx` | 风险处置 |
+| E08 | 雪天摔伤 | 雪天小区内业主摔倒骨折，生活顾问怎么处理？ | `雪天小区内业主摔倒骨折要求物业赔偿.pptx` | 风险处置 |
+| E09 | 流浪动物 | 流浪猫狗伤人或投喂引发纠纷，生活顾问怎么处理？ | `流浪猫狗出没伤人.pptx`、`流浪猫伤人，投喂者是否承担责任.pptx` | 风险处置 |
+| E10 | 电动车火灾 | 电动车引发火灾导致他人财产损失，生活顾问怎么应对？ | `电动车引发火灾导致他人财产损失.pptx` | 消防风险 |
+| E11 | 烟花火灾 | 燃放烟花爆竹引发火灾，物业现场要做什么？ | `燃放烟花爆竹引发火灾.pptx` | 消防风险 |
+| E12 | 充电桩纠纷 | 业主申请安装充电桩产生纠纷，生活顾问怎么解释和引导？ | `充电桩安装的纠纷.pptx` | 客户沟通 |
+| E13 | 加装电梯 | 加装电梯受到相邻楼栋反对，生活顾问怎么说明边界？ | `依法加装电梯的业主有权请求相邻楼栋业主停止妨害加装电梯的行为.pptx` | 客户沟通 |
+| E14 | 采购比价 | 一万元以内采购是否需要三方比价，定标表怎么用？ | `中层级采购培训-25.6.pptx`、`附件一：三方比价定标表.docx` | 内控测试 |
+| E15 | 供应商推荐 | 新增供应商推荐需要填写哪些信息，谁来审批？ | `附件二：供应商推荐表.xlsx`、`采供内容补充.pptx` | 内控测试 |
+| E16 | 服务采购 | 保洁、安保、绿化、特种设备服务合同履约中，项目要盯哪些验收点？ | `日常保洁服务合同-202309版.docx`、`日常安保服务合同-202309版.docx`、`园林绿化养护合同-202309版.docx`、`特种设备养护合同-202309版.docx` | 内控测试 |
+| E17 | 印章管理 | 社区活动要盖章，生活顾问或项目应该怎么申请和留痕？ | `南京银城物业服务有限公司印章管理办法.pdf` | 行政制度 |
+| E18 | 公车管理 | 项目借用公车或发生车辆事故，需要注意哪些审批和登记？ | `南京银城物业服务有限公司公车管理制度.pdf` | 行政制度 |
+| E19 | 档案管理 | 项目档案归档、借阅、移交时有哪些要求？ | `南京银城物业服务有限公司档案管理制度.pdf` | 行政制度 |
+| E20 | 信息安全 | 业主电话、客户资料能不能随便发到微信群，生活顾问应注意什么？ | `信息安全管理培训.pptx` | 红线测试 |
+| E21 | 员工自助 | 员工自助系统里常见人事、考勤事项应该怎么操作？ | `员工自助操作手册2025_10.pdf` | 员工支持 |
+| E22 | 职业安全 | 一线员工在现场作业中有哪些职业安全要求？ | `员工职业安全（潘晓丽）25.3.13.pptx` | 员工支持 |
+| E23 | 租售业务 | 生活顾问遇到业主咨询租售业务时，如何记录和跟进？ | `租售业务培训(住宅）250305(1).pptx` | 非物业务 |
+| E24 | 传统非物 | 社区发展中心传统非物业务有哪些，生活顾问怎么引导业主？ | `社区发展中心传统非物业务知识2025.2.26.pptx` | 非物业务 |
+
+## 锁题建议
+
+1. 现场演示先从 Q01-Q12 中选 5 到 8 题，不要现场随机问未验证题。
+2. Q01、Q02、Q05、Q10 适合串成“生活顾问的一天”主线。
+3. Q03、Q04、Q06、Q08 适合展示直给式 SOP 问答能力。
+4. E14-E20 适合业务方测试内控制度和红线问题，不建议全部放进发布会现场演示。
+5. 待 27 个视频完成转写后，再补一版“视频微课专项题单”。