docs: adopt 2026-07-07 kickoff — phased master plan + practice plan v0.7

新增《银城员工端APP分阶段实施总纲》v0.2:三阶段(陪练→大喇叭+
知识学习平台→北森对接)、身份三轴模型与防遗漏分发策略;归档立项
会纪要。二期计划 v0.2→v0.7:客户反馈(传帮带/成长路径/提示词模板/
总结卡快速修复)与立项会增量(时间锚点/收费场景权重/每日三题/
knowledge_gap 钩子);确认管家=生活顾问、APP 形态=H5 套壳。BRD
同步传帮带与评级证据包口径。

docs/AI陪练二期开发推进计划.md

@@ -1,8 +1,13 @@
 # AI 陪练二期开发推进计划
 
-> 版本:v0.2 ｜ 日期:2026-07-06
+> 版本:v0.7 ｜ 日期:2026-07-07
 > 输入源:《AI陪练功能优化与缺口分析(修订版 · 2026-07-06)》+《物业行业 AI 人力资源系统 · BRD v1.1》。
 > v0.2 修订:与两份输入源逐项复核后补齐 6 处缺漏——#6/#9/#16/师徒演练的明确处置(§2)、#13 定向再练的里程碑落点(M4)、画像雷达图与 BRD L1「留」段验收承载(M4)、TechSpec P1 表映射与岗位身份前置(M1)、场景管理权限口径(M1/§7)、G6 成本上限量化(§7)。
+> v0.3 修订:补齐管理者“传帮带”角色和初/中/高级生活顾问成长路径;训练数据只作晋升评级证据包,不让 AI 自动决定晋升。
+> v0.4 修订:补后台提示词模板管理和生成文体绑定,减少总结卡、导师改写、逐句标注等输出的自由发挥。
+> v0.5 修订:理顺 4 处表述——师徒暂缓与 M4 传帮带的边界互指、总结卡"现在效果不好"补第 1 周快速修复(不等模板 CRUD)、预习卡纳入模板绑定清单、§8 登记 M1/M4 增量超载风险。
+> v0.6 修订:并入 2026-07-07 立项会结论(见《银城员工端APP分阶段实施总纲》)——本计划升格为总纲**阶段一**的执行文档;时间锚点对齐 Alpha/Beta/半年会/收费季;收费场景权重上调;新增新员工每日三题;埋 `knowledge_gap` 钩子;岗位术语待 M0 对齐。
+> v0.7 确认:客户方确认"管家"="生活顾问"(同一岗位,术语统一为"管家(生活顾问)",`position` 标签不迁移);APP 形态定为 H5 套壳(维持 D6)。M0 两项待确认项关闭。
 > 结论:二期不做“24 个缺口全量铺开”,先把 AI 陪练从 MVP 演示闭环推进到**生活顾问岗位试点可用**。
 
 ## 1. 二期目标
@@ -15,7 +20,7 @@
 |---|---|
 | 用 | 岗位 SOP 与训练场景绑定,训练前给预习卡和红线话术 |
 | 育 | 语音对手戏、多场景训练、求助、打断纠偏、训练记录 |
-| 留 | 画像扩展、复盘标注、主管预警、定向再练 |
+| 留 | 画像扩展、复盘标注、主管预警、定向再练、职级成长证据包 |
 
 二期不追求招聘、薪酬、绩效、知识图谱、原生 APP 的全量扩张。AI 分数仍定位为“辅助参考,人可否决”。
 
@@ -43,8 +48,9 @@
 | 图片/视频情境输入(#9) | BRD 4.3.3 明列(拍照报修),vision 模型已就绪;但场景素材是瓶颈,待 12 条文本场景跑稳后独立评估,可与 B3 文生图联动 |
 | 环境噪音模拟(#6) | 前端混音成本不高但非试点闭环必需;噪音音源授权未解决 |
 | 自动案例沉淀(#16) | 挂 BRD 4.6/4.7 共创与 review_task 审核链;二期只保证"贡献度"有人工计分入口(见 M4),自动沉淀待案例量起来再评估 |
-| 师徒演练(BRD 4.4) | 依赖 mentor_assignment(P1)与真人师父运营;二期由"主管复盘 + 派发"承载师徒最小语义 |
+| 师徒演练(BRD 4.4) | 暂缓的是**真人师父指派体系**(`mentor_assignment` P1 表与师父角色运营);“传帮带”最小语义不暂缓,由 M4 主管传帮带工作台承载(看回放→写复盘建议→派下次训练) |
 | 动态难度调级(#1 后半 / BRD 4.5) | 场景表保留 difficulty 字段即可;自动升降级依赖画像数据稳定,分发规则 v1 不做 |
+| 大喇叭信息平台、知识学习平台(分身份文件摘要)、品检翻转、新问题挂榜 UI、北森对接 | 立项会新增需求,归属总纲**阶段二/三**(见《银城员工端APP分阶段实施总纲》);本阶段只埋 `knowledge_gap` 钩子 |
 
 ## 3. 技术路线
 
@@ -62,6 +68,7 @@
 | `aihr_practice_annotation` | finish 后逐句标注、好/差示例、证据 turn |
 | `aihr_practice_calibration` | 人工修正评分,沉淀一致率校准集 |
 | `aihr_practice_audio` 或 `audio_oss_id` 字段 | 对练录音 MinIO/sys_oss 回放 |
+| `aihr_prompt_template` | 按业务场景和生成文体管理 system prompt、模板、变量、输出格式、版本和启停 |
 
 注意:旧 TechSpec 中出现过 `practice_scenario` 等无前缀名称,二期实现时应同步修正文档或在 DDL 中明确采用 `aihr_practice_*`,避免和若依/未来模块冲突。
 
@@ -86,11 +93,12 @@
 
 目标:确认二期不再追 MVP 演示壳,而是追试点可用闭环。
 
-- 锁定首个岗位:生活顾问。
-- 锁定首批场景:投诉处理、催费/停车费、报修跟进、突发求助。
+- 锁定首个岗位:管家(生活顾问)。**已确认(2026-07-07)**:立项会所说"管家"与场景库"生活顾问"为同一岗位,`position` 标签沿用现有值不迁移;项目经理为第二波人设,不阻塞首批。
+- 锁定首批场景:投诉处理、催费/停车费、报修跟进、突发求助。**收费季权重上调:催费/预收/停车费类优先做深(预交折扣、历史欠费沟通等立项会举例场景入库),9 月收费季是上线动因。**
 - 每类至少 3 条场景,二期首批共 12 条。
 - 每条场景必须有:人设、开场、成功条件、雷点/爽点、SOP 引用、Rubric。
 - 明确试点指标:20 名员工、每人 10 次对练、完训率 80%、满意度 4/5。
+- **外部时间锚点对齐(立项会)**:2026-07-10(周五)Alpha 测试版 → 2026-07-13 当周 Beta 可发布版 → 半年会产品发布(须带一线真实使用数据)→ 9 月收费季前试点可用。M1/M2 的可用增量须提前放给种子用户试用,不等 M5 收口才见人。
 
 验收:
 
@@ -98,9 +106,13 @@
 - 内容负责人能提供或确认 12 条场景素材。
 - 开发不再把“实时旁听、录像、知识图谱、原生 APP”拉进二期。
 
-### M1. 场景与 Rubric 地基(第 1-2 周)
+### M1. 场景、Rubric 与提示词模板地基(第 1-2 周)
 
-目标:让“场景管理”和“评分标准版本”从代码 seed 变成可运营数据。
+目标:让“场景管理”“评分标准版本”和“生成文体模板”从代码 seed 变成可运营数据。
+
+第 1 周随手做(不等模板 CRUD 上线):
+
+- 总结卡“现在效果不好”先做内置 prompt 快速修复:把总结卡生成 prompt 硬编码为固定结构(参照督导图片分析“问题:建议:标准:”三段式的做法,定字段、定字数、定顺序),消除纯自由发挥。后续模板管理上线后,该内置 prompt 转为 `summary_card` 模板的默认版本,不白做。
 
 后端:
 
@@ -108,12 +120,14 @@
 - `backend/ruoyi-modules/ruoyi-aihr/src/main/java/org/dromara/aihr/domain/AihrPracticeDto.java`:补 scenario/rubric/assignment DTO。
 - 新增 `AihrPracticeScenarioService` 或扩展 `AihrPracticeSeedService`:优先读表,失败回退 seed。
 - `AihrPracticeController`:新增场景列表、详情、保存、启停、Rubric 查询接口。
+- 新增 `AihrPromptTemplateService` / `AihrPromptTemplateController`:按 `code + output_format` 管理模板,字段至少包含 `category/system_prompt/template/variables/enabled/version`。
 - `scripts/reset-dev-db.sh`:导入新 DDL 和 12 条生活顾问 seed。
 
 管理端:
 
 - `frontend/src/api/aihr/practice.ts`:补场景/Rubric API。
 - `frontend/src/views/train/practice.vue`:先加轻量场景选择和 Rubric 预览,不做复杂 CRUD。
+- 提示词模板管理可先挂在“系统设置-模型配置”下:支持名称、代码、分类、输出格式、系统提示词、提示词模板、描述、启用状态;模板变量用 `{{变量名}}`。
 
 移动端:
 
@@ -123,6 +137,8 @@
 
 - 管理端能选择不同生活顾问场景并开始对练。
 - API 可返回场景绑定的 SOP、Rubric、persona。
+- 总结卡、导师改写、逐句标注、训练前预习卡(M2 新增文体,提前登记)、图片督导分析等生成能力必须能绑定固定模板;未配置时回退内置模板并记录 `prompt_version`。
+- 总结卡内置 prompt 已完成固定结构改造,输出可稳定拆分展示(第 1 周快速修复项)。
 - 模型失败或表为空时,原 MVP 对练仍可跑。
 - 场景 CRUD 接口挂 `hr_operator` 角色权限(BACKLOG B1“出题”职责),普通员工端只读。
 - 员工进入训练时能按登录身份取到岗位(`position`),场景列表按岗位过滤——这是 M4 派发与分发规则的身份前置。
@@ -133,9 +149,9 @@
 
 功能:
 
-- 训练前预习卡:从场景 SOP 生成“要点 / 红线 / 可说话术”。
+- 训练前预习卡:从场景 SOP 生成“要点 / 红线 / 可说话术”,生成绑定 `prep_card` 提示词模板(固定三栏结构,不自由发挥)。
 - 每轮 emotion 由 LLM 输出并落入 turn/session,不再只用 seed 锚点。
-- 求助按钮:训练中弹出该场景 SOP 提示,记录一次求助事件。
+- 求助按钮:训练中弹出该场景 SOP 提示,记录一次求助事件。**求助/问答未命中知识库时记 `knowledge_gap` 日志(问题、岗位、时间)——为总纲阶段二"新问题挂榜共创"蓄水,本期不做挂榜 UI。**
 - 主动打断:COACH_CHECK 命中红线时中断本轮,提示纠正后重来。
 - 方言/多语气:先支持 `voice_profile.speed/emotion/dialect`,不做语音克隆。
 
@@ -188,7 +204,10 @@
 - 员工端画像以雷达图 + 趋势呈现单场四维分聚合(BRD 4.5 可视化口径,数据留跨期 `competency_assessment` 的入口)。
 - 主管端预警:连续低分、超期未训、分数下滑。
 - 批量训练任务派发:主管按岗位/短板派发专项。
+- 管理者“传帮带”工作台:主管从画像/预警进入员工详情,查看回放与标注,写复盘建议,派发下一次训练,形成“看见问题→带教→复训”的闭环(即 BRD 4.4 师徒演练的二期承载形态,边界见 §2 暂缓表;真人师父指派体系仍暂缓)。
+- 初/中/高级生活顾问成长路径:把场景难度、完训次数、人工校准分、主管复盘、案例贡献汇总成职级评级证据包;AI 等级只作参考,晋升结论由主管/HR 确认。
 - 定向再练(#13):低分维度自动生成 `source='retry'` 的待训任务,员工“今日安排”可见——错题本语义的最小实现。
+- 新员工每日三题(立项会):系统识别新员工(入职 3 个月内),每日派发 `source='daily'` 的 3 道微题(题干+参考答案+AI 秒评,轻量内容形态,区别于 12 条重对练场景);目标 3 个月覆盖 100 个常见场景。微题库内容由业务侧从管家培训材料拆分供给。
 - 人工评分校准:HR/主管可修正 AI 评分,形成校准集。
 - 训练数据脱敏:入库前处理姓名、手机号、房号等明显 PII。
 
@@ -204,7 +223,10 @@
 
 - 员工端能看到四项画像,不做同侪排名。
 - 主管端能看到待处理预警并派发训练。
+- 主管端能沉淀复盘建议和下一步训练任务,体现“传帮带”动作。
+- 员工端能看到初/中/高级成长路径进度;系统只生成评级证据包,不自动晋升。
 - 低分场景完成后,员工待训列表出现对应的再练任务。
+- 新员工登录后“今日安排”出现每日三题,作答后即时看到对错反馈。
 - 人工修正评分后,保留原 AI 分和修正分。
 - 入库文本中明显手机号/房号被脱敏。
 
@@ -233,9 +255,11 @@
 | 训练预习卡 | `GET /api/train/practice/scenarios/{id}/prep-card` |
 | 逐句标注 | `POST /api/train/practice/sessions/{sessionId}/annotations` |
 | 评分校准 | `POST /api/train/practice/sessions/{sessionId}/calibration` |
+| 提示词模板 | `GET/POST/PUT /api/aihr/prompt-templates` |
 | 主管预警 | `GET /api/aihr/mobile/practice/alerts` |
 | 派发训练 | `POST /api/aihr/mobile/practice/assignments` |
 | 员工待训 | `GET /api/aihr/mobile/practice/assignments` |
+| 成长证据包 | `GET /api/aihr/mobile/profile/promotion-evidence` |
 
 这些接口都应保留 seed fallback 或空数据兜底,但真实验收必须以数据库链路为准。
 
@@ -262,24 +286,27 @@
 | 决策 | 推荐口径 |
 |---|---|
 | 二期时长 | 8 周,每两周一个可验收增量 |
-| 首个岗位 | 生活顾问,四保一服后置 |
+| 首个岗位 | 管家(生活顾问)——已确认与立项会"管家"同一岗位;项目经理第二波,四保一服后置 |
 | 录音合规 | 二期只录音不录像;进入训练前给明确提示 |
 | 方言/TTS | 先扩 `voice_profile`,不做克隆;供应商稳定后再评估克隆 |
 | AI 排序 | 分发引擎 v1 用规则表,不上 AI 排序 |
 | 排名 | 先做自我对比和主管预警,不做同侪排名 |
 | 场景管理权限 | 场景/Rubric CRUD 归 `hr_operator` 与管理员;主管只派发不编场景 |
+| 职级挂钩 | 系统展示初/中/高级生活顾问成长进度和证据包;晋升评级必须由主管/HR 人工确认 |
 | G6 成本上限 | 试点期设 LLM/ASR/TTS 月度调用金额上限与告警阈值(具体数额由 HR 负责人与供应商账单确认);超限降级为文本对练 + 关闭逐句标注 |
 
 ## 8. 主要风险
 
 | 风险 | 控制 |
 |---|---|
-| 内容不足 | M0 先锁 12 条生活顾问场景,内容没到位不进 M2 |
+| 内容不足 | M0 先锁 12 条生活顾问场景,内容没到位不进 M2;**每日三题微题库依赖业务侧拆分管家培训材料,拆分没跟上则该项顺延、不阻塞主线** |
 | 移动端过大 | M1 同步拆 `mobile/src/App.vue` 的训练/画像/主管面板,不继续堆单文件 |
 | 成本失控 | 逐句标注只在 finish 后一次性做;总结卡/视频按需触发 |
 | 评分争议 | 原 AI 分和人工修正分并存;AI 分不挂绩效 |
 | 隐私问题 | 只做录音,不做录像;文本脱敏;音频存储权限明确 |
 | 范围膨胀 | 实时旁听、原生 APP、知识图谱、纯视觉检索全部不进二期主线 |
+| M1/M4 增量超载(v0.3/v0.4 新增项集中落在这两个里程碑,总时长未变) | M1 模板管理界面复用“系统设置-模型配置”页样式做最简版,只保 CRUD+启停,不做版本对比 UI;M4 传帮带工作台复用复盘详情页扩展,不新建独立页面;评级证据包导出降为表格导出(CSV/Excel),正式报告版式挪 M5;两周检查点发现落后即砍 M4 的证据包导出、保传帮带闭环 |
+| 半年会硬死线(立项会) | Alpha/Beta 节奏极紧;半年会演示止损口径=陪练闭环 + 总结卡 + 1 条示范视频,新增项(每日三题、传帮带工作台)不作为半年会演示承诺;演示与录屏兜底沿用一期做法 |
 
 ## 9. 交付物
 
@@ -287,7 +314,7 @@
 |---|---|
 | 产品 | 员工端训练前卡、语音对手戏、求助、回放、画像;主管端复盘、预警、派发 |
 | 后端 | 场景/Rubric/Assignment/Annotation/Calibration 数据与 API |
-| 管理端 | 场景选择/轻管理、Rubric 预览、评分校准 |
+| 管理端 | 场景选择/轻管理、Rubric 预览、提示词模板管理、评分校准 |
 | 内容 | 12 条生活顾问场景、SOP 引用、Rubric、标杆话术 |
 | 验收 | 20 条评分校准样本、试点数据导出、演示脚本更新 |
 
@@ -304,8 +331,9 @@
 **Steps**
 
 - [ ] 增加 `aihr_practice_scenario`、`aihr_practice_rubric`、`aihr_practice_rubric_dimension`。
+- [ ] 增加 `aihr_prompt_template`,内置 `summary_card`、`mentor_rewrite`、`review_annotation`、`prep_card`、`supervision_image_analysis_maintenance` 等模板。
 - [ ] 写入 12 条生活顾问场景 seed。
-- [ ] reset 后确认场景表和 rubric 表有数据。
+- [ ] reset 后确认场景、rubric 和 prompt template 表有数据。
 
 ### Task 2: 场景读取替换 seed
 
@@ -380,6 +408,8 @@
 - [ ] 画像补训练时长、贡献度、测评分、AI 等级。
 - [ ] 主管端补预警列表。
 - [ ] 主管可派发专项训练,员工端今日安排可见。
+- [ ] 主管端可记录复盘建议并派发下一步训练。
+- [ ] 员工端展示初/中/高级成长路径进度,管理端可导出评级证据包。
 
 ## 11. 二期完成定义
 
@@ -389,4 +419,5 @@
 - 员工能完成“预习 → 语音/文本训练 → 求助 → 评分 → 复盘”的闭环。
 - 主管能完成“看风险 → 听回放 → 看标注 → 派专项”的闭环。
 - 画像能支撑“下一步练什么”的规则分发。
+- 系统能产出初/中/高级生活顾问评级证据包,但不自动给出晋升结论。
 - 试点所需的合规、成本、人工校准底线已经留好。