feat(aihr): finalize practice growth and access boundaries

docs/20260708/数字师傅学练问报整合方案.md

@@ -10,7 +10,7 @@
 > v1.6 更新(2026-07-19):“记一下”升级为确认式统一采集。系统先建议服务线索、住户画像、优秀案例、个人想法、待跟进事项或工作记录,用户选择仅自己保存或提交公司处理;位置字段缺失不阻断保存,公司处理在正式接口接入前只标记待流转。
 > v1.7 收口(2026-07-21):日常工作采集统一归“工作助手”,按自然日汇总为“今日工作成果”;现有 CASE/VIDEO/SOP/KNOWLEDGE 审核链产品语义收敛为“成果投稿”,当前页面和 API 名称仍保留“工作上报”。项目工作记录后续必须从项目名称下拉列表确认当前项目,不要求用户输入项目编码。施工顺序见[专项迭代计划](../工作助手与今日工作成果迭代计划-20260721.md)。
 > v1.8 更新(2026-07-24):“问”从单一 RAG 问答升级为数字师傅 Agent 入口。服务端先识别知识、实时工作、训练、确认式记录、媒体、全网、澄清或闲聊意图，再按固定权限策略调用既有领域服务；SOP 检索是受控工具之一，不再是所有消息的默认去向。完整边界见[专项设计](../superpowers/specs/2026-07-24-digital-master-agent-design.md)。
-> 与《银城员工端APP分阶段实施总纲》《AI陪练二期开发推进计划》的关系:本方案是增量修订,不推翻既有阶段划分;§4.2 回写清单已于 2026-07-08 执行——总纲升 v0.3、二期计划升 v0.8。BRD 已升至 v1.4,同步个人助理与工作上报交互定案;BRD 4.4 师徒演练等旧口径仍待后续版本继续修订。
+> 与《银城员工端APP分阶段实施总纲》《AI陪练二期开发推进计划》的关系:本方案是增量修订,不推翻既有阶段划分;§4.2 回写清单已于 2026-07-08 执行——总纲升 v0.3、二期计划升 v0.8。2026-07-24 起，阶段一后续施工范围统一以[《AI陪练完整交付计划》](../AI陪练完整交付计划-20260724.md)为准，旧二期计划仅保留工程追溯。BRD 已升至 v1.4,同步个人助理与工作上报交互定案;BRD 4.4 师徒演练等旧口径仍待后续版本继续修订。
 
 ---
 

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

@@ -1,6 +1,7 @@
 # AI 陪练二期开发推进计划
 
 > 版本:v0.10 ｜ 日期:2026-07-11
+> 状态同步(2026-07-24):本文件保留 M0-M5 的历史推进和工程追溯；阶段一后续施工、范围控制与结项标准统一以[《AI陪练完整交付计划》](AI陪练完整交付计划-20260724.md)为准。
 > 输入源:《AI陪练功能优化与缺口分析(修订版 · 2026-07-06)》+《物业行业 AI 人力资源系统 · BRD v1.2》。
 > v0.2 修订:与两份输入源逐项复核后补齐 6 处缺漏——#6/#9/#16/师徒演练的明确处置(§2)、#13 定向再练的里程碑落点(M4)、画像雷达图与 BRD L1「留」段验收承载(M4)、TechSpec P1 表映射与岗位身份前置(M1)、场景管理权限口径(M1/§7)、G6 成本上限量化(§7)。
 > v0.3 修订:补齐管理者“传帮带”角色和初/中/高级生活顾问成长路径;训练数据只作晋升评级证据包,不让 AI 自动决定晋升。

docs/AI陪练完整交付计划-20260724.md

@@ -0,0 +1,297 @@
+# AI陪练完整交付计划（固定范围版）
+
+> 版本：v1.0 ｜ 日期：2026-07-24 ｜ 状态：工程实施中；内容校审与真实试点未完成
+>
+> 本文是总纲“阶段一：陪练”的唯一后续施工范围。它不新开一个“第 N 期”，也不因每次发现差异而继续拆分产品期数；后续工作只是在本计划的固定范围内完成、验收或明确取消。
+
+## 1. 结论先行
+
+### 1.1 当前版本处在什么位置
+
+当前已上线的“练”不是零散 Demo，而是**五岗位基础训练闭环**：场景、评分标准、每日/专项/再练任务、2-6 回合对练、训练总结、训练历史、主管复盘和任务运营均已有主链路。
+
+它仍不是“练模块完整交付”，原因不是缺少更多页面，而是缺少一套被业务确认的成长语义：
+
+- 场景有 `position`、`project_type` 和 `difficulty`，但没有正式的“住宅物业 + 岗位 + 初/中/高级 + 能力项”目录；
+- 每日/专项题类型与 `daily/camp/retry/manual` 任务来源都已存在，不能被误当作能力等级；
+- 员工尚不能清楚知道自己处于哪个成长层、下一步该练什么、为什么被解锁或暂未解锁；
+- 现有场景需要完成业务校审和矩阵归类，不能以“库里有多少条”替代内容可用。
+
+因此，本计划的完成目标是：
+
+> **把“练”收口为住宅物业五岗位、三级成长、可运营、可复盘、可证明的训练体系；生活顾问是首个深度试点岗位，不是唯一岗位。**
+
+### 1.2 阶段口径一次定清
+
+| 名称 | 含义 | 是否再拆成产品期 |
+|---|---|---|
+| 系统阶段一“陪练” | 银城员工端三阶段总纲中的第一个业务阶段 | 否。本文就是其完整收口范围。 |
+| 当前五岗位基础闭环 | 已实现的工程与运营底座 | 不是新一期，是本计划的起点。 |
+| 三级成长 | 同一陪练阶段内的内容组织和员工进阶规则 | 不是三个发布期，三层共同构成一个目标。 |
+| 执行序列 | 为降低风险而安排的开发、内容、试点顺序 | 只是施工顺序，不产生新的产品边界。 |
+
+除非业务明确批准“新增行业”或“新增岗位”，否则后续不再另列“陪练三期、四期……”。未完成项只按本文的交付清单标记为“未开始 / 实施中 / 已验收 / 取消”。
+
+## 2. 固定范围：一个三维矩阵
+
+| 维度 | 本计划固定值 | 处理原则 |
+|---|---|---|
+| 行业/业态 | **住宅物业** | 先跑通住宅场景，不纳入写字楼、园区、医院、学校等新业态。 |
+| 岗位 | **生活顾问、保安、保洁、保修（工程）、客服** | 沿用系统现有岗位值和别名归一，不迁移历史 `position`。 |
+| 成长层级 | **初级、中级、高级** | 代表训练复杂度和可练内容，不等于自动职级晋升。 |
+| 能力项 | 每个场景归属一个岗位能力项 | 能力项是任务分配、进度展示和复盘聚合的共同语言。 |
+
+### 2.1 “生活顾问做深”的正确含义
+
+生活顾问是第一条深度主线：优先完成内容校审、三级成长规则、种子用户试点和指标验证。其余四岗不是只练“与生活顾问配合”这一件事；各岗位都必须保留与自身安全、服务和专业职责相关的核心训练，再补跨岗位协同场景。
+
+例如，保修（工程）不能只练“接到生活顾问派单后如何说话”，还必须有安全确认、报修诊断、上门沟通和完工交接等经业务批准的专业场景。这样既避免首期铺得过大，也不会把岗位训练做成表面覆盖。
+
+### 2.2 固定能力目录
+
+下表定义固定交付范围必须覆盖的能力域。它是内容校审清单，不要求为了凑数新造场景；先将现有场景归位，只补缺失单元。
+
+| 岗位 | 初级：能上岗 | 中级：能独立处理 | 高级：能处理复杂协同 | 首批深度优先级 |
+|---|---|---|---|---|
+| 生活顾问 | 接待与记录、日常巡检、报事报修受理、基础服务规范 | 投诉/催费/停车费沟通、跨部门跟进、回访闭环 | 重大投诉服务恢复、复杂协同、群体沟通与风险预判 | 最高 |
+| 保安 | 门岗礼仪、访客/车辆、巡查和异常上报 | 纠纷初处、夜间/高峰处置、与管家协同 | 突发事件协同、现场秩序组织、复盘交接 | 第二梯队 |
+| 保洁 | 作业标准、工具安全、现场反馈 | 异常卫生/投诉处理、时间与区域协调 | 重大活动保障、跨工种协同、品质复盘 | 第二梯队 |
+| 保修（工程） | 安全确认、报修受理、上门服务与完工说明 | 故障初判、延期沟通、跨部门转办 | 高风险故障协同、服务恢复、复杂工单闭环 | 第二梯队 |
+| 客服 | 咨询受理、信息记录、基础话术 | 投诉分级、情绪安抚、跟进协调 | 复杂客诉、群体沟通、服务升级与复盘 | 第二梯队 |
+
+每个能力域至少要有：一条经审批的对练场景、一套可追溯 SOP/制度依据、一份对应 Rubric，以及一个明确的“不应这样做”的红线。生活顾问优先完成所有三级能力域；其余四岗先完成初级全部能力域和高频跨岗位协同，再补中/高级内容。
+
+## 3. 当前实现基线与明确缺口
+
+以下结论来自当前代码、迁移脚本和已发布的五岗位内容运营闭环；它说明“从哪里继续”，不把源码存在等同于业务验收完成。
+
+| 能力 | 当前基线 | 本计划的收口动作 |
+|---|---|---|
+| 场景库 | 已有岗位、场景类型、项目类型、难度、人设、SOP、回合内容、启停和内容版本。 | 用既有 `project_type` 固定住宅范围；补成长层、能力项、协同岗位、内容审核状态，并完成现有内容归类。 |
+| 对练 | 已支持 2-6 回合、文字/语音、LLM 失败时 seed 回退、训练前预习和训练中求助。 | 在生成上下文中带入住宅项目类型/岗位/层级/能力项；保证 seed 回退拥有同一语义。 |
+| 评分 | 已有 Rubric、五维评分和会话评分规则快照。 | Rubric 与能力项、成长层绑定；评分只决定训练建议/解锁资格，不自动决定职级。 |
+| 任务 | 已有 `daily`、`camp`、`retry`、`manual` 来源和主管批量派发。 | 按当前成长层和短板选题；保留来源含义，绝不拿来源代替等级。 |
+| 复盘 | 已有训练总结、逐句标注、主管查看与复盘后再派专项；本机增量已可把主管的可选“下一训练层级确认”附着在本次复盘会话上。 | 复盘页显示能力项、所属层级、下一步推荐；主管可人工确认“可进入下一层”。 |
+| 员工视图 | 已有今日训练、训练历史、能力画像和训练反馈。 | 增加“当前层级、已完成能力项、下一解锁条件、推荐训练”四项，不新建第二个学习入口。 |
+| 管理运营 | 已有训练内容、题库、Rubric、任务管理页和权限控制。 | 在现有页面加矩阵筛选、审核状态、覆盖缺口和内容版本追踪，不另建平行后台。 |
+| 试点证明 | 已有按日期导出、唯一在职组织身份和每人至少 10 次完训的严格统计口径。 | 用同一口径完成真实住宅项目试点，不以 seed、测试账号或截图替代。 |
+
+### 3.1 代码与数据复用边界
+
+本计划不新建第二套培训引擎。继续复用：
+
+- `aihr_practice_scenario`：唯一的场景内容载体；
+- `aihr_practice_rubric` / `aihr_practice_rubric_dimension`：唯一的评分标准载体；
+- `aihr_practice_assignment`：唯一的每日、专项、再练、人工任务载体；
+- `aihr_practice_session`：唯一的训练与历史快照载体；
+- 现有 `/api/train/practice/**`、管理端训练运营页面和员工/主管端页面。
+
+首轮只在既有 `scenario` 与 `session` 上增加必要元数据和历史快照：`growth_level`、`competency_code`、`collaboration_positions`、`review_status`、`risk_level`、首/第二审核人的稳定用户 ID、显示名及时间、`curriculum_version`。主管确认只保存到支撑该判断的原训练会话：`growth_confirmation_level`、`growth_confirmed_by`、`growth_confirmed_time`，不新建第二套成长引擎，也不改写原训练层级。住宅物业是本计划固定范围，直接复用既有 `project_type`，不新加一个永远只有单值的 `industry` 字段。任务从场景继承这些信息，不复制出另一张课程或训练营表。
+
+## 4. 目标功能安排
+
+### 4.1 内容运营：先让内容能被管理和证明
+
+1. 在现有“训练内容”页为场景增加以下字段和筛选：既有住宅 `project_type`、岗位、初/中/高级、能力项、协同岗位、审核状态、风险级别、版本。
+2. 审核状态固定为 `草稿 → 待业务审核 → 已发布 → 已下线`。员工只可看到“已发布且启用”的场景，且不可读取审核人身份和审核时间；管理员停用不是删除历史。运营可标注“常规”或“高风险”，但收费、安全、投诉等受控词及所有训练回合会由服务端自动升级为高风险，待评估内容不可发布；高风险场景的第一位审核人只会留下带稳定用户 ID 的待复核记录，必须由第二位不同的已认证运营人员复核同一内容版本才会发布。
+3. 每条场景保存：业务来源/SOP 引用、目标、成功条件、红线、业主人设、回合数、Rubric、风险级别、首/第二审核人及时间和版本。
+4. 内容修改后只影响新会话；既有 `session` 保存当时的课程/评分快照，避免历史成绩被新规则改写。
+5. 后台提供“矩阵缺口”视图：按住宅物业 × 岗位 × 层级 × 能力项列出已发布、待审核、缺失，成为内容补齐的唯一清单。
+
+### 4.2 员工端：从“有训练”变成“知道为什么练”
+
+员工仍从底栏“练”进入，不增加“成长学院”等第二入口。页面由上到下固定为：
+
+1. **我的成长位置**：当前岗位、当前层级、已覆盖能力项和本层待完成项；
+2. **今天该练什么**：优先显示已派发专项、到期再练、当前层级的每日训练；
+3. **场景训练**：按当前可练内容展示；未解锁的中/高级场景显示原因和所需条件，不做假进度；
+4. **训练后总结**：沿用五维评分、证据句、红线、可说话术和下一步建议；
+5. **我的历史**：按能力项与层级看趋势，且可回看主管已给出的复盘建议。
+
+员工能够跳过或重练已开放的内容；“锁定”只用于业务确认需要前置训练的复杂场景，绝不能拦住紧急 SOP 查询或实际工作求助。
+
+### 4.3 任务分配：来源与成长层各司其职
+
+| 任务来源 | 产生规则 | 与成长层的关系 |
+|---|---|---|
+| 每日训练 `daily` | 从当前层级尚未覆盖或需巩固的能力项中选取。 | 是日常练习，不等于“初级”。 |
+| 专项训练 `camp` / 人工 `manual` | 主管根据真实问题、复盘或业务活动派发。 | 可跨层派发，但需说明原因并留痕。 |
+| 定向再练 `retry` | 同一能力项持续低分、触发红线或主管要求后生成。 | 用于巩固，不把一次低分直接降级。 |
+| 自主训练 | 员工从已开放场景选择。 | 计入能力覆盖和成长证据。 |
+
+成长规则采用一套**固定、可审计的规则版本**，不建设复杂的可视化规则引擎：
+
+- 初级：完成岗位基础能力项的训练与业务确认；
+- 中级：满足规定的初级能力覆盖、最低有效评分和必要复盘；
+- 高级：满足规定的中级能力覆盖、复杂协同场景和主管复盘证据；
+- 阈值由业务负责人和 HR 在开发前一次确认，写入版本化规则；规则调整只影响之后的训练推荐，不反写已完成历史；
+- 主管的人工确认仅可基于其有权限查看的已完成会话，且只能从会话快照的初级确认至中级、或从中级确认至高级；它是训练证据，不能绕过尚待业务确认的正式解锁阈值；
+- 系统给出“达到训练层级条件”的提示，**绝不自动调整员工职级、薪酬、晋升或资格结论**。
+
+### 4.4 主管与运营端：把带教做成闭环，而非定向师徒
+
+1. 主管查看员工时，先看到岗位、当前层级、能力缺口、连续低分/逾期风险和待复盘会话；
+2. 进入训练详情后，沿用音频、逐句标注、五维评分和复盘建议；
+3. 主管可一次完成“写建议 → 选能力项/场景 → 派下一次专项 → 标记已复盘”，并可选确认“可进入下一训练层级”；服务端按已绑定的主管范围与本次会话原始层级校验，只记录会话证据，不生成职级、薪酬或资格结论；
+4. 运营端可按岗位/层级/能力项查看覆盖率、完训率、低分聚集和内容未命中；
+5. 不做员工与员工之间的强制“师带徒”关系。员工经验共创仍由“问题榜/案例”承接，主管带教由训练复盘和任务派发承接。
+
+### 4.5 AI 与知识边界
+
+- LLM 提示词必须携带经过服务端校验的住宅 `project_type`、岗位、层级、场景、SOP 和 Rubric，不相信客户端自报的岗位或等级；
+- 输出继续保持结构化：角色回复、情绪/信任、红线/纠偏、证据、总结与下一步训练建议；
+- 模型不可用时，seed 回退也必须按同一场景元数据运行，不能退回跨岗位通用话术；
+- “问”模块可在训练中提供已授权的 SOP 提示，未命中问题进入知识缺口，但不将问答回答伪装成员工真实待办；
+- 案例/问题榜被采纳后可作为成长证据输入，是否计入学分或晋升资格仍遵循既有人工审核与规则，不由模型直接判定。
+
+## 5. 固定实施序列
+
+以下是完成本计划的施工顺序，不是新的产品分期。每一项的退出条件满足后才进入下一项；任何未通过项仍留在同一计划内处理。
+
+### A. 冻结目录和业务规则
+
+**工作**
+
+- 确认住宅物业、五岗位、三级成长和上表能力域为唯一范围；
+- 为每一能力域指定业务内容负责人和审核人；
+- 将存量场景逐条归入矩阵，标记“可发布 / 待补资料 / 不适用 / 下线”；
+- 一次确认初/中/高级的解锁阈值、是否需要主管复盘、试点项目与种子人员。
+
+**退出条件**：矩阵没有未归属的已发布场景；每个待补单元有明确内容责任人；不再讨论新增行业/岗位作为本轮插单。
+
+### B. 补齐最小数据语义与兼容迁移
+
+**工作**
+
+- 扩展现有场景、会话 DTO/SQL/服务端校验和筛选；
+- 写可重复执行的迁移：不重写历史 `project_type`；成长层和能力项只能由内容运营确认后发布；
+- 启动新会话时复制课程语义与版本到会话快照；
+- 保持现有 `daily/camp/retry/manual`、场景编码、Rubric、已完成会话和训练历史可用。
+
+**退出条件**：旧接口兼容；新字段可查、可筛、可审计；历史训练不因内容更新改变所属版本。
+
+### C. 在既有页面完成运营与员工体验
+
+**工作**
+
+- 管理端训练内容、Rubric、任务管理页增加矩阵筛选、审核状态和覆盖缺口；
+- 员工“练”页增加当前层级、能力进度、下一步训练和可解释锁定；
+- 主管复盘与派发页展示层级/能力项/推荐再练；
+- 完成手机 H5 常用尺寸的布局、可访问名称、登录/空态/错误态与文字对齐检查。
+
+**退出条件**：员工、主管、运营三种身份都能从同一条真实数据看到一致的岗位/层级/能力信息，并完成一轮“发布内容 → 派发 → 训练 → 复盘 → 再练”。
+
+### D. 内容补齐与质量校审
+
+**工作**
+
+- 先完整发布生活顾问三级能力域；
+- 再完成四岗位初级能力域与高频协同，再补中/高级；
+- 每条内容按“来源资料 → 场景卡 → 业务审核 → 模型回归 → 发布”流转；
+- 对红线、高风险话术、收费/安全/投诉内容执行双人审核；
+- 用真实但脱敏的典型对话做回归集，验证不同模型与 seed 回退。
+
+**退出条件**：矩阵中每个承诺的能力域均有已发布、可运行、可追溯的内容；不存在仅靠 LLM 临时生成且未审核的正式训练场景。
+
+### E. 真实试点、复盘和结项
+
+**工作**
+
+- 在同一住宅项目/组织窗口内，用真实在职身份开展试点；
+- 跟踪完训、评分校准、主管复盘、内容反馈、知识缺口与异常中断；
+- 用现有显式起止日期导出统计，复核唯一组织身份和每人至少 10 次已完成训练；
+- 召开一次内容与产品复盘，只允许作“规则/内容修订”，不把未证实需求扩进范围。
+
+**退出条件**：达到下文“完成定义”的工程、内容、试点三类门槛，并形成结项报告与继续/暂停/扩行业的正式决策。
+
+## 6. 完成定义与验收证据
+
+“计划完成”必须同时满足以下三层；任一层未满足，都只能称已实现或已部署，不能称整个练模块已完成。
+
+| 层级 | 必须通过的证据 |
+|---|---|
+| 工程完成 | 数据迁移可重复执行；后端单元/集成测试通过；管理员、员工、主管真实接口贯通；H5/admin 构建通过；受影响页面实际操作并截图检查。 |
+| 发布完成 | 静态管理端、移动 H5、后端 AIHR 模块和远端 schema 同时通过完整 `release-preflight`；生产健康检查通过；不把单纯 H5 发布写成完整发布。 |
+| 业务试点完成 | 在同一明确起止日内，使用真实在职组织身份；每人至少 10 次已完成训练；有业务内容审核、主管复盘样本、满意度/有效性结论和问题清单。测试账号、seed 会话、开发固定验证码流程都不能充当此证据。 |
+
+试点结项还应回答四个业务问题：
+
+1. 生活顾问是否能用训练解决真实高频服务场景，而非只完成题目？
+2. 主管是否能根据复盘和任务进行下一次带教？
+3. 五岗位内容是否各自符合岗位职责和安全边界？
+4. 知识缺口、低分能力项和业务反馈是否能推动下一次内容修订？
+
+## 7. 明确不在本计划内
+
+- 新行业：写字楼/园区、医院、学校、城市服务等；
+- 新岗位：项目经理及第六个以后的岗位；
+- 自动晋升、自动绩效、薪酬/资格自动决策；
+- 员工间强制定向师徒关系；
+- 实时主管旁听、全量录像、完整离线对练；
+- 视觉/视频情境作为正式训练主链路，或方言能力的正式验收；
+- 学模块课程/考试、问题榜、案例运营、北森对接的独立建设。
+
+这些内容并非否定，而是要在本计划完成并经真实试点证明后，由新的、显式批准的需求进入阶段二或阶段三。不得以“顺手补一下”为由混入当前陪练收口。
+
+## 8. 变更控制
+
+本计划冻结后，任何新增请求先按下列规则处理：
+
+| 请求类型 | 处理方式 |
+|---|---|
+| 能使住宅五岗位三级矩阵某一单元可验收 | 允许进入对应工作项，并更新矩阵状态。 |
+| 改善已存在链路的缺陷、性能、可访问性或安全 | 允许作为缺陷修复，不改变范围。 |
+| 新岗位、新行业、新业务模块、自动人事决策 | 记录为后续候选项，不插入当前计划。 |
+| 仅有演示需要、没有业务审核素材 | 只可做受控 Demo，不能标为正式已发布内容。 |
+
+## 9. 相关事实源与实现入口
+
+- 总阶段边界：[银城员工端APP分阶段实施总纲](银城员工端APP分阶段实施总纲.md)
+- 历史实施记录（保留追溯，不再作为后续范围切分依据）：[AI陪练二期开发推进计划](AI陪练二期开发推进计划.md)
+- 当前接口与训练闭环：[API_INTEGRATION](API_INTEGRATION.md)
+- 当前生产/试点证据边界：[BRD_IMPLEMENTATION_AUDIT](BRD_IMPLEMENTATION_AUDIT.md)
+- 场景、任务和评分的实际实现：[`AihrPracticeController`](../backend/ruoyi-modules/ruoyi-aihr/src/main/java/org/dromara/aihr/controller/AihrPracticeController.java)、[`AihrPracticeSeedService`](../backend/ruoyi-modules/ruoyi-aihr/src/main/java/org/dromara/aihr/service/AihrPracticeSeedService.java)、[`aihr_practice_mysql8.sql`](../backend/script/sql/aihr_practice_mysql8.sql)
+
+> 执行原则：先完成矩阵内已承诺的能力，再以试点证据决定是否扩展；不再把“发现一个差异”误包装成“又要开一个新一期”。
+
+## 10. 本次工程实施记录（2026-07-24）
+
+本节只记录已落地的工程事实，不能替代业务内容审核或真实试点结项。
+
+| 固定实施序列 | 当前工程状态 | 已落地内容 | 尚需业务动作 |
+|---|---|---|---|
+| A. 冻结目录和业务规则 | 待业务确认 | 五岗位、三级与能力目录已固化为服务端目录；矩阵会明确显示“待归类”。 | 指定内容负责人/审核人；逐条归类存量场景；确认真实解锁阈值与试点名单。 |
+| B. 最小数据语义与兼容迁移 | 已实现、已本机回归 | `scenario` 增长层/能力项/协同岗位/审核/风险/版本；首/第二审核人同时保存稳定用户 ID、显示名和时间；`session` 保存岗位、项目类型与课程快照，以及可选的 `growth_confirmation_level/growth_confirmed_by/growth_confirmed_time`。确认只能写在被复盘会话上，不能覆盖原层级快照；迁移可重复执行，且不会清空高风险内容已完成首审、正在等待第二人复核的审核轨迹。旧 `enabled` 场景一律进入“待业务审核”，不从启停状态推断“已发布”；历史详情只读会话快照，缺失时明确标注“历史未记录/未归类”。已完成会话的重复 `/finish` 仅回读持久化评分与快照，绝不按当前场景重新归类或写回。运行环境的全部 `ensure*` 路径默认只校验 schema、绝不执行 DDL；派发请求的幂等唯一键与最近内容索引必须同时满足唯一性、完整列序和无前缀，偏离即失败关闭。远端完整预检会同时校验这两个索引定义及 `wygj-aihr.service` 的有效环境未开启 runtime bootstrap。 | 在目标环境按发布顺序执行正式迁移；内容运营逐条归类、审核后再发布。 |
+| C. 既有页面体验 | 已实现、已本机真实页面验收（部分） | 管理端场景页新增目录字段、审核流、风险选择、审核轨迹与缺口矩阵；新增场景弹窗已在本机真实登录后的页面检查，风险下拉明确展示“待评估 / 常规 / 高风险（需两位不同审核人）”。员工“练”页显示成长位置、能力证据和已发布场景，无可用场景或目录加载失败时清空旧卡片并禁止开始；每日三题只会从已发布、已启用、风险审核完成的同岗位场景题库取题，并优先补当前最低未覆盖的成长层/能力项（仅作训练推荐，不自动改职级或形成硬性解锁）。主管复盘页对初级/中级会话提供可选的下一层确认，员工画像回显该会话证据；服务端只接受初级→中级或中级→高级，且复用既有主管范围校验。移动端仅按认证手机号精确解析 `person_phone`；后台不得向 `/api/aihr/mobile/**` 传入 `ext_party_id` 读取个人训练或主管数据，后台运营仅通过独立 `/api/train/practice/**` 契约以及不绑定员工身份的 `operator:{userId}`、`mode=preview` 预览完成；`/me` 与问师傅主体不再使用组织模糊查询。若手机号与其他人在职外部 ID 碰撞、同手机号关联多名在职员工，或同一外部 ID 映射多个在职手机号，则拒绝猜测、读取或写入任务；员工历史、画像、成长进度和晋升证据只从同一服务端核验的别名集合聚合。主管范围只保存外部 ID；旧手机号必须唯一映射到一个外部 ID，且该外部 ID 也唯一拥有该手机号，才可读出和统计；这一规范化结果复用于团队列表、详情、复盘、音频授权与后续任务，歧义记录一律排除。案例项目范围与岗位 SOP 同样复用已验证 APP 主体的精确项目范围，不再以手机号/外部 ID 混合查询或组织模糊快照兜底。员工端账号由服务端强制按 `mobile` 模式和组织岗位校验。管理端对练看板可走服务端绑定的 `preview` 运营预览，但不能传入或读取员工身份，预览记录不进入员工/主管/试点统计。主管复盘显示本次课程快照，只在有岗位快照时加载同岗再练场景。 | 用具备主管权限的真实身份，且至少有一条经业务审批的已发布场景，走完发布→训练→复盘（含可选下一层确认）→再练。 |
+| D. 内容补齐与质量校审 | 工程门禁已实现，业务内容未开始 | 后台已提供内容归类、审核、下线、风险分类、版本和审核轨迹入口；发布前强制校验业务来源/SOP、红线、目标、成功标准、回合、能力项和五维 Rubric；待评估风险不能发布，高风险内容必须由两位不同审核人完成双审。 | 先完成生活顾问三级内容与四岗初级内容的来源、Rubric、红线和实际双人审核；不得将测试/seed 内容标为正式发布。 |
+| E. 真实试点与结项 | 未开始 | 已保留既有导出和严格试点统计口径。 | 在同一项目、明确日期、真实在职身份下完成每人至少 10 次训练与结项复盘。 |
+
+#### 10.1 管理端与移动端的权限收口（2026-07-24）
+
+> 以下为本地待发布的安全收口，尚未部署到生产环境。
+
+- `/api/aihr/mobile/**` 的员工历史、画像、任务、主管复盘和团队难题仅由认证 APP 身份使用；员工端不采信客户端传入的 `extPartyId`，主管端从当前 APP 手机号解析项目范围。
+- 对练录音下载同样只接受经 APP 身份和会话范围校验的请求；后台账号不能通过移动端 OSS 路径按对象编号读取员工录音。
+- 管理端预览固定为 `operator:{userId}` 与 `mode=preview`，只能验证场景、模型和评分链路；不得读取员工身份、训练历史、主管复盘、成长证据或试点统计。
+- 原后台“复盘校准 / 常见难题 / 成长激励”个人数据入口已撤出菜单并重定向到“任务运营”。后台继续保留已授权的内容审核、场景/Rubric 管理与批量任务运营；真实复盘、团队难题和定向再练由主管 APP 完成。
+
+### 本次验证证据
+
+- `mvn -pl ruoyi-modules/ruoyi-aihr -am -DskipTests=false -Dtest=AihrDashboardServiceTest,AihrPracticeSeedServiceTest,AihrPracticeLlmServiceTest -Dsurefire.failIfNoSpecifiedTests=false test`：96 项通过；
+- `mvn -pl ruoyi-modules/ruoyi-aihr -am -DskipTests=false -Dtest=AihrPracticeSeedServiceTest -Dsurefire.failIfNoSpecifiedTests=false test`：本轮每日三题、题库审核失效与移动身份别名回归 89 项通过；
+- `bash scripts/tests/aihr-schema-migrations.test.sh`：隔离 MySQL 数据库内重复执行迁移通过；成长目录迁移会补齐并修复派发幂等唯一键和最近内容索引。
+- `pnpm --dir frontend build:dev`：管理端构建通过；
+- `npm --prefix mobile-uni run typecheck && npm --prefix mobile-uni run build:h5`：员工/主管 H5 类型检查与构建通过。
+- `node --test mobile-uni/tests/mobile-user-pages.test.mjs`：本轮新增的“当前已选场景启动”和“目录加载失败禁用开始”断言通过；全套仍有 3 条既有语音/方言断言与当前语音源码不一致，未在本计划中改写无关语音行为。
+- 本机浏览器：管理端已认证打开“场景与评分”，验证矩阵刷新与场景元数据编辑对话框；员工端按“获取验证码 → 开发固定码 → 登录”完成认证，查看“我的成长位置 / 场景训练 / 错题练习 / 每日三题”。当前账号没有已发布场景时，页面明确提示需内容运营审核发布；员工身份直达“待复盘”返回“当前账号无主管权限”，未显示团队数据。登录手机号和验证码输入已改为 `tel`，保留数字键盘并避免浏览器将手机号当数值近似显示或丢失验证码前导零语义。
+- `mvn -pl ruoyi-modules/ruoyi-aihr -am -Dtest=AihrPracticeSeedServiceTest,AihrKnowledgePrincipalResolverTest,AihrCaseServiceTest,AihrSopSeedServiceTest,AihrSchemaMigrationGuardTest,AihrRuntimeSchemaBootstrapContractTest -Dsurefire.failIfNoSpecifiedTests=false -DskipTests=false -Dmaven.test.skip=false test`：164 项通过，覆盖 APP/组织身份分流、历史手机号团队映射、案例范围、岗位 SOP 范围与 runtime schema 守卫。
+- `mvn -q -pl ruoyi-modules/ruoyi-aihr -am -DskipTests=false test`：AIHR 模块全量 588 项通过。过程中修正了“问”模块训练数据工具的旧单测 mock：它必须先验证 APP 手机号，再读本人训练或经验证主管范围，不能继续按旧组织身份契约断言。
+- `mvn -pl ruoyi-modules/ruoyi-aihr -am -Dtest=AihrSchemaMigrationGuardTest,AihrRuntimeSchemaBootstrapContractTest,AihrPracticeSeedServiceTest,AihrLearningContractTest,AihrExamIdempotencyTest -Dsurefire.failIfNoSpecifiedTests=false -DskipTests=false -Dmaven.test.skip=false test`：116 项通过；覆盖表/列/索引缺失时失败、派发幂等唯一键或最近内容索引存在但唯一性/列序/前缀错误时在任何 DDL 前失败、全部运行时 DDL 服务的静态门禁以及 Spring 实际属性缺省为关闭的行为。
+- `mvn -pl ruoyi-modules/ruoyi-aihr -am -Dtest=AihrPracticeSeedServiceTest,AihrRuntimeSchemaBootstrapContractTest,AihrSchemaMigrationGuardTest -Dsurefire.failIfNoSpecifiedTests=false -DskipTests=false -Dmaven.test.skip=false test`：109 项通过；覆盖主管确认只能写入下一训练层级、确认写入原复盘会话、员工画像回显和新增字段的 schema 守卫。
+- `bash scripts/tests/aihr-schema-migrations.test.sh`：在隔离 MySQL 内重跑通过，包含 `growth_confirmation_level/growth_confirmed_by/growth_confirmed_time` 三列的重复迁移。
+- `FRONTEND_URL=http://127.0.0.1:4347 MOBILE_URL=http://127.0.0.1:4408 bash scripts/demo-check.sh`：通过；包含管理端、移动端 H5、租户/验证码接口、真实流程标记与严格试点门槛检查。门槛输出仍显示业务内容与真实试点未完成，不能把该通过当作试点结论。
+- 本地开发库只读快照：五岗位各 20 条场景，全部为“初级 / 草稿 / 待评估”；正式训练会话 5 条、已复盘 3 条、达到每人 10 次完训的人数为 0。这些是开发 seed/本机验证数据，不可作为内容审核或试点证据。
+- 线上 H5 静态包可访问，但只读检查仍显示登录字段为 `type=\"number\"`；本机 `tel` 修复尚未部署。当前工作区含其他未提交改动，不能以整包静态发布替代经过发布预检的受控版本。
+- 独立本机后端以 `AIHR_PRACTICE_RUNTIME_SCHEMA_BOOTSTRAP=false` 启动并监听 `127.0.0.1:4910`；启动日志显示学习/考试仅查询 `information_schema`，未执行 `CREATE/ALTER`，`GET /api/aihr/mobile/home/employee` 返回 HTTP/业务码 `200`。这是本机运行态证据，尚未部署或复核生产服务环境。
+
+上述均为本机构建、隔离数据库或本机认证页面证据；当前尚未完成生产发布、主管身份的真实复盘链路、业务内容签字或严格试点，不能称“陪练模块完整交付完成”。

docs/API_INTEGRATION.md

@@ -8,26 +8,28 @@
 |---|---|---|
 | AI面试 `/recruit/interview` | `POST /api/recruit/interview/start`、`/answer`、`/finish`、`GET /records`、`POST /records/{sessionId}/review` | 已接入真实模型优先链路：配置 chat 模型后 `/start` 动态生成面试题，`/finish` 按前端提交的真实回答做结构化评分；未配置模型时使用本地 Rubric 估分，不返回固定候选人分数。AI 分数只作辅助参考，HR/管理员可提交 `reviewedScore/reviewNote` 完成人工复核；记录同时保留 AI 分、人工复核分、最终采用分和复核状态 |
 | 候选人入职主体关联 `/recruit/interview` | `GET/POST /api/recruit/interview/candidate-links` | HR/管理员在当前租户范围内把本地候选人 ID 关联到已同步的在职 `ext_party_id`；只保存外部主体 ID，不复制姓名、部门等组织字段，重复关联同一主体幂等，候选人更换主体或同一主体已关联其他候选人会拒绝 |
-| 三角色对练 `/train/practice` | `POST /api/train/practice/start`、`/turn`、`/finish` | 已接入编排 API；数据库启用 chat 模型后，`/turn` 客户回复按人设走真 LLM 生成（seed 剧本作剧情锚点），`/finish` 走单次 temperature=0 结构化评分（4 维分+导师改写+点评）；移动端 `turn/finish` 校验当前手机号与启动会话归属，未知或他人会话拒绝；模型未配置或调用失败自动回退 seed，契约不变 |
-| M2 训练预习与求助 | `GET /api/train/practice/scenarios/{id}/prep-card`、`POST /api/train/practice/sessions/{sessionId}/help` | 均要求已登录；预习卡只使用当前租户已启用的 `prep_card/json_prep` 模板，模型返回必须严格为 3 条要点、3 条红线、2 条话术，否则回退场景卡。求助接口只允许 APP 员工访问其本人、同租户的活动训练会话；客户端可传 `roundIndex` 仅为兼容字段，服务端按会话实际进度落库，返回 `{sessionId,scenarioId,roundIndex,recordedAt}`。迁移表为 `aihr_practice_help_event`，不在请求路径执行 DDL。该契约当前仅完成本地实现与验证，线上尚未有该表。 |
+| 三角色对练 `/train/practice` | `POST /api/train/practice/start`、`/turn`、`/finish` | 已接入编排 API；数据库启用 chat 模型后，`/turn` 客户回复按人设走真 LLM 生成（seed 剧本作剧情锚点），`/finish` 走单次 temperature=0 结构化评分（五维分、导师改写、点评）。APP 员工请求由服务端绑定当前登录手机号并强制 `mode=mobile`，不信任客户端的身份或模式；`turn/finish` 只允许该员工操作本人活动/已完成会话。`superadmin` 或 `hr_operator` 的管理端预览可复用同一路径，但服务端固定为 `operator:{userId}` 与 `mode=preview`，忽略客户端 `extPartyId/mode/assignmentId`；预览记录不进入员工历史、主管复盘、成长、试点或正式校准统计。其他后台身份拒绝。已完成会话的重复 `/finish` 只读取持久化结果，绝不按当前场景目录重算或回写历史快照；模型未配置或调用失败自动回退 seed，契约不变。 |
+| 训练场景运营 `/train/scenarios` | 内容读取 `GET /api/train/practice/scenarios`、`GET /scenarios/{id}`；管理写入 `POST /scenarios`、`PATCH /scenarios/{id}/enabled`、`PATCH /scenarios/{id}/review-status`；目录 `GET /curriculum/capabilities`、`GET /curriculum/matrix` | 读取默认只返回当前租户“已发布且启用”的场景，且不返回审核人、稳定用户 ID 或审核时间；仅 `superadmin/hr_operator` 可请求 `includeDisabled=true`、编辑、启停和推进审核。状态只能按 `草稿 → 待业务审核 → 已发布 → 已下线` 流转；发布时服务端重新读取场景并校验住宅范围、固定五岗位、成长能力项、业务来源/SOP、服务红线、目标、成功标准、至少两轮回合和完整五维 Rubric，不信任客户端传入的发布内容。每次编辑已发布内容会退回待业务审核并刷新内容版本/哈希及审核留痕。运营可以选择风险级别，但服务端会对收费、安全、投诉等受控词及全部回合文本自动升级为“高风险”；待评估内容不可发布。高风险场景先记录第一位审核人的稳定用户 ID 和显示名并保持待业务审核，只有第二位不同的已认证运营人员复核同一内容版本后才发布；迁移重跑不得清空等待复核的首审记录。员工可见和可启动路径始终同时要求 `review_status=已发布 AND enabled=1`。 |
+| M2 训练预习与求助 | `GET /api/train/practice/scenarios/{id}/prep-card`、`POST /api/train/practice/sessions/{sessionId}/help` | 均要求已登录；预习卡只使用当前租户已启用的 `prep_card/json_prep` 模板，模型返回必须严格为 3 条要点、3 条红线、2 条话术，否则回退场景卡。求助接口只允许 APP 员工访问其本人、同租户的活动训练会话；客户端可传 `roundIndex` 仅为兼容字段，服务端按会话实际进度落库，返回 `{sessionId,scenarioId,roundIndex,recordedAt}`。迁移表为 `aihr_practice_help_event`，不在请求路径执行 DDL。该表已随 2026-07-24 完整包发布并纳入远端 `62/62` 结构预检；完整训练写入与正式试点仍需另验。 |
 | 正式试点数据导出 | `GET /api/train/practice/export?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD` | 起止日期必填且包含结束日；只统计窗口内能通过唯一手机号或外部 ID 映射到在职组织快照的正式会话，排除重复手机号和身份碰撞。完训定义为每人至少 10 次，校准必须关联同一窗口内正式会话；CSV 同时给出校准命中数、SOP 可用数、满意度响应数/平均分，以及明细级 AI 分、人工校准分、校准人、校准时间、最终采用分、满意度分和意见，避免用四舍五入后的比率反推门禁状态；汇总和明细均携带正式人员及项目口径，不混入历史 seed/开发身份 |
-| 对练语音 | `POST /api/ai/asr`（multipart 字段 `file`，≤5MB）、`POST /api/ai/tts`（JSON `{text≤300字, voice?, voiceProfile?:{role,voice?,speed?,emotion?,dialect?}, practiceContext?:{sessionId,turnIndex,role:'customer'}}`，`dialect` 仅接受 `mandarin/cantonese/sichuanese`，非法值返回业务码 `400`；旧 `voice` 兼容；成功返回 `ossId`，客户端播放地址为受控的内联 `data:audio/*`，不返回原始 OSS URL）、`GET /api/aihr/mobile/oss/{ossId}` | 走 OpenAI-compatible audio 接口；生产 SiliconFlow CosyVoice2 按角色映射老师傅/业主/面试官音色，业主对练再按已有情绪分切换平静/严肃/强烈语气和语速；dialect 作为语气提示传给支持表现力提示词的 TTS，不含克隆，也不等同于方言正式验收。`practiceContext` 仅允许已认证 APP 员工把本次服务端生成的业主 TTS 绑定到本人当前或刚完成会话的指定原话术回合；服务端重新校验租户、员工身份、回合和文本，不接受员工端传 OSS ID 或任意角色。设备语音降级按方言选择语言：粤语使用 `zh-HK`，四川话无法由设备语音可靠模拟时明确提示用户转用服务端语音或文字，不伪装成普通话。模型管理需启用 `category=asr/tts` 配置；移动端优先用浏览器录音，`getUserMedia/MediaRecorder` 不可用或麦克风权限失败时，用 `audio/*` file input 选择/录制音频后继续调同一 ASR 接口；ASR/TTS 未配置或失败返回 fail，前端降级设备语音或文本；训练/每日题录音只通过 `audioOssId` 走受保护下载，历史客户端传入的 HTTP `audioUrl` 不再回显；TTS 成功音频仍写入 `sys_oss` 留痕，同时用内联 data URL 保持旧客户端可播放；音频下载按员工本人或主管项目范围授权，系统管理端保持后台访问 |
-| 案例沉淀 `/knowledge/cases` | `GET /api/knowledge/case/capabilities`、`POST /api/knowledge/case/upload`、`/organize`、`/curate`、`GET /records`、`GET /records/{caseId}`、`POST /records/{caseId}/review`、`GET /records/{caseId}/media` | `/capabilities` 返回服务端判定的案例提交/查看能力，移动端不再向普通员工展示无权提交的素材表单；`/upload` 改为 multipart 真实语音上传并走 ASR，服务端只接受 MP3/WAV/M4A/WebM/OGG/AAC/FLAC，成功后原始音频写入 `sys_oss`，案例记录只保存 `mediaOssId` 供受保护媒体接口读取，不向客户端回传原始 `mediaUrl`；`/organize` 用真实转写调 chat 模型整理案例，未配置模型时按真实 transcript 本地结构化，并从背景外的真实摘要项提取学习点；APP 用户的项目范围从 `aihr_org_snapshot` 登录身份解析，上传、整理、入库、列表和详情均按项目范围校验，未完成正式组织映射时安全拒绝，不接受前端伪造项目范围；员工列表/详情只返回 `已入库` 案例，管理端系统用户保留全局运营视图；移动端和管理端案例详情通过受保护媒体接口回放原始音频，主管/项目负责人可提交脱敏点评；预渲染视频样片仍待正式媒体资产接入 |
+| 对练语音 | `POST /api/ai/asr`（multipart 字段 `file`，≤5MB）、`POST /api/ai/tts`（JSON `{text≤300字, voice?, voiceProfile?:{role,voice?,speed?,emotion?,dialect?}, practiceContext?:{sessionId,turnIndex,role:'customer'}}`，`dialect` 仅接受 `mandarin/cantonese/sichuanese`，非法值返回业务码 `400`；旧 `voice` 兼容；成功返回 `ossId`，客户端播放地址为受控的内联 `data:audio/*`，不返回原始 OSS URL）、`GET /api/aihr/mobile/oss/{ossId}` | 走 OpenAI-compatible audio 接口；生产 SiliconFlow CosyVoice2 按角色映射老师傅/业主/面试官音色，业主对练再按已有情绪分切换平静/严肃/强烈语气和语速；dialect 作为语气提示传给支持表现力提示词的 TTS，不含克隆，也不等同于方言正式验收。`practiceContext` 仅允许已认证 APP 员工把本次服务端生成的业主 TTS 绑定到本人当前或刚完成会话的指定原话术回合；服务端重新校验租户、员工身份、回合和文本，不接受员工端传 OSS ID 或任意角色。设备语音降级按方言选择语言：粤语使用 `zh-HK`，四川话无法由设备语音可靠模拟时明确提示用户转用服务端语音或文字，不伪装成普通话。模型管理需启用 `category=asr/tts` 配置；移动端优先用浏览器录音，`getUserMedia/MediaRecorder` 不可用或麦克风权限失败时，用 `audio/*` file input 选择/录制音频后继续调同一 ASR 接口；ASR/TTS 未配置或失败返回 fail，前端降级设备语音或文本；训练/每日题录音只通过 `audioOssId` 走受保护下载，历史客户端传入的 HTTP `audioUrl` 不再回显；TTS 成功音频仍写入 `sys_oss` 留痕，同时用内联 data URL 保持旧客户端可播放；移动端 OSS 下载只允许经本人或主管项目范围验证的 APP 身份，后台账号若需回放必须使用未来独立、受审计的管理端契约。 |
+| 案例沉淀 `/knowledge/cases` | `GET /api/knowledge/case/capabilities`、`POST /api/knowledge/case/upload`、`/organize`、`/curate`、`GET /records`、`GET /records/{caseId}`、`POST /records/{caseId}/review`、`GET /records/{caseId}/media` | `/capabilities` 返回服务端判定的案例提交/查看能力，移动端不再向普通员工展示无权提交的素材表单；`/upload` 改为 multipart 真实语音上传并走 ASR，服务端只接受 MP3/WAV/M4A/WebM/OGG/AAC/FLAC，成功后原始音频写入 `sys_oss`，案例记录只保存 `mediaOssId` 供受保护媒体接口读取，不向客户端回传原始 `mediaUrl`；`/organize` 用真实转写调 chat 模型整理案例，未配置模型时按真实 transcript 本地结构化，并从背景外的真实摘要项提取学习点；APP 用户必须先以认证手机号精确校验在职 `person_phone`，再由可信主体解析 `aihr_org_snapshot` 项目范围；案例 SQL 不得把 `person_phone` 与 `ext_party_id` 作为替代查询键。上传、整理、入库、列表和详情均按该项目范围校验，未完成正式组织映射时安全拒绝，不接受前端伪造项目范围；员工列表/详情只返回 `已入库` 案例，管理端系统用户保留全局运营视图；移动端和管理端案例详情通过受保护媒体接口回放原始音频，主管/项目负责人可提交脱敏点评；预渲染视频样片仍待正式媒体资产接入 |
 | 案例媒体安全 | `GET /api/knowledge/case/records/{caseId}/media` | 案例详情只返回 `mediaOssId`，不返回原始 `sys_oss.url`；媒体下载会重复执行登录、后台角色或 APP 项目范围校验，再由服务端流式读取 OSS。管理端与 `mobile-uni` 通过鉴权 blob/temp 文件播放，关闭详情页时释放本地对象 URL |
 | 问·数字师傅工作 Agent `/pages/user/sop/index` | `POST /api/aihr/agent/messages`、`POST /api/aihr/agent/messages/media`、`POST /api/aihr/agent/actions/{draftId}/confirm`、`POST /api/aihr/agent/actions/{draftId}/dismiss` | 移动端文字、ASR 转写和图片/视频统一进入 Agent。服务端根据消息规划 `KNOWLEDGE_QA/RESOURCE_DELIVERY/LIVE_MY_WORK/LIVE_TEAM_WORK/PRACTICE_COACHING/CAPTURE_FACT/MEDIA_UNDERSTANDING/WEB_RESEARCH/CLARIFY/SOCIAL`，再由固定策略校验当前登录身份和工具权限；客户端不提交 `toolCode`，模型也不能自由指定身份、SQL、URL 或任意工具。知识、训练概况、当前待办、确认式记忆、媒体分析和全网查询均复用现有领域服务；普通图片问答只做本次视觉分析，不要求先具备知识空间，用户明确问现场制度/流程时才校验授权空间并补充 SOP。全网查询先返回 `NEEDS_INPUT`，只有用户明确同意后才调用外部服务。统一响应使用结构化 `status/sourceSummary/citations/resources/actionDraft/clarification`；按钮不从答案文本推断。写入动作只接受 30 分钟有效的不透明 `draftId`，最终确认继续复用既有版本、幂等与可见性规则。每次运行只审计租户、主体、意图、工具、状态、来源类型、耗时和错误码，不保存原始问题、答案或附件。 |
-| SOP 知识底层服务 `/knowledge/sop` 与旧客户端兼容 | `POST /api/knowledge/query`、`POST /api/knowledge/query-media`、`GET /api/knowledge/resources/{attachmentId}/content`、`POST /api/knowledge/answer-feedback`、`GET /api/knowledge/position-sop`、`GET /api/aihr/mobile/onboard/tasks`、`POST /api/aihr/mobile/onboard/tasks/{id}/complete`、`GET /api/aihr/mobile/qualification`、`POST /api/knowledge/doc/upload` | Agent 按规划结果调用该层；管理端和旧客户端接口继续兼容。文字/现场附件查询走统一知识空间授权和 MySQL Fulltext + Qdrant 混合召回；内部登录端可选传 `conversationId/contextVersion`，服务端保留 30 分钟不活跃过期、最近 6 轮脱敏截断上下文，用现有 chat 模型或保守规则输出 `QA/FILE/VIDEO/DATA_TOOL` 和 `rewrittenQuery`，旧版本冲突返回 `409`。员工从银城大喇叭详情追问时，只传 `broadcastMessageId`，服务端每轮按当前 APP 在职员工、当前租户和 `PUBLISHED` 状态重新取消息；撤回、跨租户或非在职员工均拒绝。原文件/视频仅从当前命中且仍有授权的附件返回，内容接口每次重新计算租户、应用和主体权限；无资源时明确返回空列表，不生成假链接。搜索继续返回 `reviewId/promptVersion`，员工反馈保存评审批次；详细边界见 [专项设计](20260718/问师傅多轮会话与原始资料交付设计.md)。 |
-| 工作助手确认式统一采集 `/pages/user/sop/index`、`/pages/user/assistant/memories` | Agent 主入口返回 `actionDraft`，确认/忽略走 `/api/aihr/agent/actions/{draftId}/confirm|dismiss`；旧接口 `POST /api/knowledge/query`、`POST /api/knowledge/query-media`、`GET /api/aihr/personal-assistant/memory-candidates?status=DRAFT`、`POST /api/aihr/personal-assistant/memory-candidates/{id}/confirm|dismiss` 继续兼容；确认记录读写仍使用 `/api/aihr/personal-assistant/**`，旧项目记录继续使用 `/api/aihr/service-memories` | 文字、ASR 转写和现场媒体复用同一候选检测。项目工作必须从 `/api/aihr/mobile/me` 返回的项目名称列表选择当前项目，内部 `projectCode` 仍由服务端按当前登录主体授权收窄；个人笔记可以不绑定项目。显式“记一下”生成 `ASSISTANT_CAPTURE/DRAFT`，系统建议 `ATTENDANCE/INSPECTION/SERVICE_LEAD/RESIDENT_PROFILE/CASE/PERSONAL_NOTE/FOLLOW_UP/PROJECT_NOTE`。确认必须带 `expectedVersion + idempotencyKey + saveScope(PRIVATE|COMPANY)`；PRIVATE 仅本人可见，COMPANY 写入 PENDING 待流转。状态更新只允许 `RECORDED/PENDING/IN_PROGRESS/COMPLETED/VOID`，幂等键不得跨记录或目标状态复用。来源文件重新鉴权交付；正式外部接收端未配置前不得显示已送达 |
+| SOP 知识底层服务 `/knowledge/sop` 与旧客户端兼容 | `POST /api/knowledge/query`、`POST /api/knowledge/query-media`、`GET /api/knowledge/resources/{attachmentId}/content`、`POST /api/knowledge/answer-feedback`、`GET /api/knowledge/position-sop`、`GET /api/aihr/mobile/onboard/tasks`、`POST /api/aihr/mobile/onboard/tasks/{id}/complete`、`GET /api/aihr/mobile/qualification`、`POST /api/knowledge/doc/upload` | Agent 按规划结果调用该层；管理端和旧客户端接口继续兼容。文字/现场附件查询走统一知识空间授权和 MySQL Fulltext + Qdrant 混合召回；内部登录端可选传 `conversationId/contextVersion`，服务端保留 30 分钟不活跃过期、最近 6 轮脱敏截断上下文，用现有 chat 模型或保守规则输出 `QA/FILE/VIDEO/DATA_TOOL` 和 `rewrittenQuery`，旧版本冲突返回 `409`。员工从银城大喇叭详情追问时只传 `broadcastMessageId`：服务端每轮按当前 APP 在职员工、当前租户和 `PUBLISHED` 状态重新取消息，响应仅回显 `{messageId,title,publishedAt}`，消息正文不写入客户端存储、会话 JSON 或查询审计；同一会话的消息来源不可改绑，撤回、跨租户或非在职员工均拒绝。该上下文只说明公司消息，不可据此捏造个人任务；上下文模式拒绝现场媒体和数据工具，外部无状态 API 不接受该参数。岗位 SOP 的项目范围复用当前 APP 已验证主体的 `projectCodes`，不得以管理端组织快照的模糊/别名查询作为后备。原文件/视频仅从当前命中且仍有授权的附件返回，内容接口每次重新计算租户、应用和主体权限；无资源时明确返回空列表，不生成假链接。搜索继续返回 `reviewId/promptVersion`，员工反馈保存评审批次；员工学习页按当前 APP 身份读取正式岗前/入职任务，资格证据无正式数据时明确返回 `NOT_CONFIGURED`。详细边界见 [专项设计](20260718/问师傅多轮会话与原始资料交付设计.md)。 |
+| 工作助手确认式统一采集 `/pages/user/sop/index`、`/pages/user/assistant/memories` | Agent 主入口返回 `actionDraft`，确认/忽略走 `/api/aihr/agent/actions/{draftId}/confirm|dismiss`；旧接口 `POST /api/knowledge/query`、`POST /api/knowledge/query-media`、`GET /api/aihr/personal-assistant/memory-candidates?status=DRAFT`、`POST /api/aihr/personal-assistant/memory-candidates/{id}/confirm|dismiss` 继续兼容；确认记录读写使用 `GET /api/aihr/personal-assistant/assistant-captures?limit=50`、`POST /assistant-captures/{id}/status`、`GET /assistant-captures/{id}/status-history`、`GET /assistant-captures/{id}/source`，旧项目记录继续使用 `/api/aihr/service-memories` | 文字、ASR 转写和现场媒体复用同一候选检测。项目工作必须从 `/api/aihr/mobile/me` 返回的项目名称列表选择当前项目，内部 `projectCode` 仍由服务端按当前登录主体授权收窄；个人笔记可以不绑定项目。显式“记一下”生成 `ASSISTANT_CAPTURE/DRAFT`，系统建议 `ATTENDANCE/INSPECTION/SERVICE_LEAD/RESIDENT_PROFILE/CASE/PERSONAL_NOTE/FOLLOW_UP/PROJECT_NOTE`。确认必须带 `expectedVersion + idempotencyKey + saveScope(PRIVATE|COMPANY)`；PRIVATE 仅本人可见，COMPANY 写入 PENDING 待流转。状态更新只允许 `RECORDED/PENDING/IN_PROGRESS/COMPLETED/VOID`，幂等键不得跨记录或目标状态复用。来源文件重新鉴权交付；正式外部接收端未配置前不得显示已送达。 |
 | 今日工作成果 `/pages/user/work-results/index`、`/pages/supervisor/work-results/index` | 员工 `POST /api/aihr/work-results/mine/generate?projectCode=...&workDate=YYYY-MM-DD`；主管 `GET /api/aihr/work-results/project?projectCode=...&workDate=YYYY-MM-DD` | 按员工 + 项目 + Asia/Shanghai 自然日确定性聚合已确认记录；两页默认当天并可按日期查看历史成果，客户端禁止选择未来日期。内容未变化时重复生成不增加版本，记录或状态变化后版本递增。主管只可查看本人在目标项目具备主管身份的团队结果；APP 登录身份同时兼容组织快照中的外部人员 ID 与手机号，普通员工或跨项目请求返回 403。外部接口未接通时只显示本地状态和 PENDING，不伪造派单或考勤同步成功 |
-| 银城大喇叭 | 员工 `GET /api/aihr/broadcast/unread-count`、`GET /api/aihr/broadcast/messages?pageNum=&pageSize=`、`GET /api/aihr/broadcast/messages/{id}`、`POST /api/aihr/broadcast/messages/{id}/read`；员工详情可经统一 `POST /api/knowledge/query` 的 `broadcastMessageId` 发起文字追问；管理 `GET /api/aihr/broadcast/admin/messages?pageNum=&pageSize=&status=PUBLISHED|WITHDRAWN|all`（响应含服务端确认的 `tenantId`）、`POST /api/aihr/broadcast/messages`（`{requestId,title,content,expectedTenantId}`）、`POST /api/aihr/broadcast/messages/{id}/withdraw`（`{reason,expectedTenantId}`） | 员工端只返回当前登录租户的 `PUBLISHED` 公开消息，租户和阅读用户均由服务端登录身份取得；阅读表以 `(tenant_id,message_id,user_id)` 唯一约束保证重复打开幂等。详情“问这条消息”只在本地暂存消息 ID，问模块重新读取并由服务端可信解析消息；撤回、跨租户或非在职员工均不可继续追问。管理读写使用服务端当前有效租户（动态租户优先）；`expectedTenantId` 只能回显刚读取的服务端范围，不用于选择租户，若另一标签页已切换范围则返回 `409`，避免旧页面误发或误撤回。发布以 `(tenant_id,published_by,requestId)` 幂等：同键同内容重放原 `{id,version:1}`，同键异内容返回 `409`；一个事务内写主消息和不可变 v1 内容快照。管理列表可按已发布/已撤回筛选并返回正文、发布/撤回审计与固定 `currentVersion=1`。撤回原因必填、去首尾空白且最多 500 字符；首次只允许 `PUBLISHED -> WITHDRAWN`，重复撤回成功但不得覆盖原撤回人、时间或原因。管理端将未知发布请求按“有效租户 + 管理员”的 `v2` 本地记录保存，存储不可用时拒绝发起发布。首版不含修订、定向目标、附件或 AI 摘要；管理接口只允许 `superadmin` 或 `hr_operator`。 |
+| 银城大喇叭 | 员工 `GET /api/aihr/broadcast/unread-count`、`GET /api/aihr/broadcast/messages?pageNum=&pageSize=`、`GET /api/aihr/broadcast/messages/{id}`、`POST /api/aihr/broadcast/messages/{id}/read`、`GET /api/aihr/broadcast/attachments/{id}/content`；员工详情可经统一 `POST /api/knowledge/query` 的 `broadcastMessageId` 发起文字追问；管理 `GET /api/aihr/broadcast/admin/messages`、`POST /api/aihr/broadcast/admin/attachments`、`GET /api/aihr/broadcast/admin/attachments/{id}`、`POST /api/aihr/broadcast/messages`、`POST /api/aihr/broadcast/messages/{id}/withdraw` | 发布支持全员或按部门/岗位/人员定向、必读、单个公司文件与异步提炼。文件支持 txt/md/PDF/Word/Excel/PPT，100MB 内；先受控写入 OSS，再异步解析并复用现有模型生成摘要，只有 `READY` 且未绑定、属于当前租户和上传人的文件才可随消息发布。员工详情只返回摘要和受控下载信息，不返回提取全文或原始 OSS 地址；下载和追问每次重新校验当前 APP 在职身份、租户和消息状态，追问上下文由服务端拼接消息正文与提取文本，客户端仍只传 `broadcastMessageId`。定向目标用于“与我有关”和必读提醒，不改变全租户公开频道的可见性。发布、阅读和撤回保持既有幂等与审计约束；管理接口只允许 `superadmin` 或 `hr_operator`。当前仍不包含消息修订、撤回后补推或短信/电话强触达。 |
+| 员工直通车 `/pages/user/direct/index`、管理端 `/content/direct` | 员工 `GET /api/aihr/direct/channels`、`POST /api/aihr/direct/feedback`、`GET /api/aihr/direct/mine`、`GET /api/aihr/direct/mine/{id}`；处理端 `GET /api/aihr/direct/admin/feedback`、`POST /api/aihr/direct/admin/feedback/{id}/reply` | 员工可选择总裁、财务、人力、审计、运营并点对点提交。总裁/审计默认匿名；匿名仅表示业务处理界面不显示提交人，系统仍保存内部账号和姓名快照供本人查询、幂等与审计。`direct_president/direct_finance/direct_hr/direct_audit/direct_operations` 仅处理各自频道，`superadmin` 可处理全部；列表、详情和回复均由服务端按角色收窄。一个反馈只允许一次正式回复，员工可在“我的反馈”查看状态和回复；当前不扩展为工单 SLA、转派或多轮聊天。 |
 | 成果投稿（当前页面名“工作上报”）`/pages/user/report/index` | `POST /api/aihr/work-report/organize`、`POST /attachment`、`POST /reports`、`GET /reports/mine`；主管/运营另有列表和审核接口 | 只承载 CASE/VIDEO/SOP/KNOWLEDGE 四类投稿。会话式页面、无状态整理、附件、幂等正式提交和历史状态已部署；审核通过不自动入知识库。当前整理服务不读取图片/视频内容，只把附件名称作为不可信元数据；不得与日常工作记录或“今日工作成果”混用 |
 | 资料处理 `/knowledge/processing` | `GET /api/knowledge/processing/overview`、`POST /api/knowledge/doc/upload-async`、`GET /api/knowledge/doc/upload-items`、`POST /api/knowledge/doc/upload-items/{id}/retry` | 已接入解析任务状态聚合；页面只保留“批量导入”，接口暂存+入队即秒回，后台 worker（并发 2）逐条解析/归类/向量化；ZIP 在 worker 内安全解压后把支持的子文件继续入同一批次队列，页面按批次轮询进度、失败可单文件重试；不提供浏览器目录选择或服务端目录导入入口 |
 | 组织人员同步 | `POST /api/aihr/org/sync` | 从开放组织同步系统的 `/api/open/v1/sync/snapshot` 拉取 `company/department/employee/employee_project_assignment` 快照，分页参数使用 `limit`；员工手机号只落 `person_phone` 用于移动端身份映射，不在组织列表响应暴露；岗位识别 `position/job_title/post/job_name/role/title` 等字段。`dryRun` 必须显式传入 `true`（预检）或 `false`（写入），省略或传 `null` 直接拒绝，避免空请求意外写库；默认 `replaceExisting=true`，写入前必须先用 `{"dryRun":true}`；dry-run 不访问本地快照表、不执行 DDL/写库，返回 `phoneLinked/maskedPhone/suspectText/warnings` 且 `syncedCount=0`。非 dry-run 覆盖写入遇到员工被跳过、手机号不完整、脱敏手机号或疑似乱码时默认拒绝，只有确认 dry-run 结果后显式传 `allowPartialReplace=true` 才允许覆盖。相同员工可由多条有效项目分配展开为多个项目成员行，唯一约束为 `tenant_id + project_code + ext_party_id`；只拒绝同一项目内的重复成员关系。`replaceExisting=false` 不触发不完整快照覆盖闸门，但仍拒绝同项目重复关系。2026-07-15 线上已用 `/api/open/v1` 前缀完成配置、dry-run 和覆盖同步：开放平台返回公司 17、部门 963、员工 3417；生产 `aihr_org_snapshot` 为 3417 行，`phoneLinked=3392`、`maskedPhone=25`、`suspectText=0`，在职 2943、离职 474。该统计发生在多项目成员迁移前；发布迁移后必须重新 dry-run 并核对展开后的项目成员行数。当前剩余 25 人手机号不可用属于上游数据质量问题 |
 | 移动端手机号登录 | `GET /resource/sms/code`、`POST /auth/mobile/sms-login` | 已复用 sms4j 阿里云配置 `config1` 和 RuoYi `sms` 授权策略；移动专用接口固定服务端默认租户，客户端不传也不能选择 `tenantId`；验证码按“默认租户 + 手机号”隔离。校验在手机号粒度的分布式锁内完成：仅匹配成功才消费，输错不会作废原验证码。移动端令牌只关联 `app_user`；若同一手机号存在任何后台/系统账号（即使同时存在 `app_user`），一律拒绝登录而不复用或并置身份；手机号完全不存在时才自动注册 `app_user`。`aihr.sms.dev-fixed-code` 非空时不真发短信、验证码固定（dev 默认 `123456`）。prod 默认关闭，试点期只有同时设置 `AIHR_SMS_DEV_FIXED_CODE` 与 `AIHR_SMS_PROD_FIXED_CODE_ENABLED=true` 才启用固定码。 |
 | 用户侧三端首页 `mobile-uni` hash 路由；旧 `/h5/user`、`/h5/candidate`、`/h5/supervisor` 兼容重定向 | `GET /api/aihr/mobile/home/{role}` | 未登录请求只返回不读取租户业务统计的公开首屏 seed；已登录移动端请求自动携带 `Authorization/clientid`，才返回员工/主管真实统计；移动端本地 fallback 保演示 |
-| 移动端登录后角色识别 | `GET /api/aihr/mobile/me` | 认证后按手机号匹配组织快照；`position_level` 为“主管/项目经理”时进入主管端，否则进入员工端。响应返回去重后的 `projects[]` 供页面按项目名称选择，不要求用户输入或记忆编码；同一人员在多个项目的快照行按 `tenant_id + project_code + ext_party_id` 保留。接口失败回退员工端 |
-| 移动端员工训练与主管复盘闭环 | 员工复用 `POST /api/train/practice/start`、`/turn`、`/finish`，查询 `GET /api/aihr/mobile/practice/history`、`/practice/mistakes`、`/profile`；训练完成后提交 `POST /api/aihr/mobile/practice/satisfaction`；主管查询 `GET /api/aihr/mobile/practice/team`、`/practice/alerts`、`/practice/reviews`、`/practice/reviews/{id}`，标记 `POST /api/aihr/mobile/practice/reviews/{id}/reviewed`，指派 `POST /api/aihr/mobile/practice/assignments` | 员工端登录后带 `Authorization` 与 `clientid` 调用；`mode=mobile` 完成后写入 `aihr_practice_session`。满意度接口只接受本人已完成训练的 1-5 分，意见脱敏后落库，未填写不补默认值。错题本按员工本人聚合低分/红线回合，并关联已有 `retry` assignment，不伪造错题结论。主管 `/practice/team` 在同一项目权限范围内额外返回 `mistakes` 聚合，按场景/归因统计次数、影响人数、平均分和最近发生时间；普通员工返回“无主管权限”。主管接口以后端当前登录手机号映射在职组织快照，仅允许岗位为“主管/项目经理”的账号，并按租户和项目范围返回真实成员、全状态训练记录及非 daily 专项。复盘标记只允许首次 `待复盘 -> 已复盘` 创建后续专项，并发重复提交幂等；可带 `incentivePoint` 写入贡献度。每日三题正式只对 `hire_date` 在当前日期前三个月内的在职员工派发；没有入职日期时不使用训练次数推断，开发 Demo 的旧回退只有在 `dev/local` profile 且由 `aihr.practice.allow-legacy-daily-drill-fallback` 显式开启时生效，生产 profile 强制关闭。 |
+| 移动端登录后角色识别 | `GET /api/aihr/mobile/me` | 认证后仅以手机号精确查询 `person_phone`（`activeByMobilePhone`，不使用组织模糊搜索）；`position_level` 为“主管/项目经理”时进入主管端，否则进入员工端。响应返回去重后的 `projects[]` 供页面按项目名称选择，不要求用户输入或记忆编码；同一人员在多个项目的快照行按 `tenant_id + project_code + ext_party_id` 保留。接口失败回退员工端。 |
+| 移动端员工训练与主管复盘闭环 | 员工复用 `POST /api/train/practice/start`、`/turn`、`/finish`，查询 `GET /api/aihr/mobile/practice/history`、`/practice/mistakes`、`/profile`；训练完成后提交 `POST /api/aihr/mobile/practice/satisfaction`；主管查询 `GET /api/aihr/mobile/practice/team`、`/practice/alerts`、`/practice/reviews`、`/practice/reviews/{id}`，标记 `POST /api/aihr/mobile/practice/reviews/{id}/reviewed`，指派 `POST /api/aihr/mobile/practice/assignments` | 员工端登录后带 `Authorization` 与 `clientid` 调用；服务端固定身份和 `mode=mobile` 后才写入 `aihr_practice_session` 并进入员工/主管统计。员工历史、错题、画像、成长进度、晋升证据和满意度均只使用当前认证手机号经服务端验证得到的受控历史别名；后台内容/任务运营只通过独立 `/api/train/practice/**` 契约，不得向 `/api/aihr/mobile/**` 传入外部 ID 读取个人或主管数据。主管 `/practice/team` 的范围只含已验证外部 ID；历史训练或任务若存的是同一员工的旧手机号，只在该手机号能无碰撞规范化到团队外部 ID 时才展示/统计，避免把另一人的外部 ID 误并入团队。管理端 `mode=preview` 仅是运营调试记录，不能伪装成员工训练、满意度、复盘、成长或试点证据。满意度接口只接受本人已完成训练的 1-5 分，意见脱敏后落库，未填写不补默认值。错题本按员工本人聚合低分/红线回合，并关联已有 `retry` assignment，不伪造错题结论。主管 `/practice/team` 在同一项目权限范围内额外返回 `mistakes` 聚合，按场景/归因统计次数、影响人数、平均分和最近发生时间；普通员工返回“无主管权限”。主管接口以后端当前登录手机号先解析为在职组织外部 ID，仅允许岗位为“主管/项目经理”的账号，并按租户和项目范围返回真实成员、全状态训练记录及非 daily 专项。复盘标记只允许首次 `待复盘 -> 已复盘` 创建后续专项，并发重复提交幂等；可带 `incentivePoint` 写入贡献度。每日三题正式只对 `hire_date` 在当前日期前三个月内的在职员工派发，且只会从已发布、已启用、风险审核完成的同岗位场景题库取题；选择时优先补最低未覆盖的成长层/能力项，仅作为训练推荐，不自动调整职级或形成硬性解锁。没有入职日期时不使用训练次数推断，开发 Demo 的旧回退只有在 `dev/local` profile 且由 `aihr.practice.allow-legacy-daily-drill-fallback` 显式开启时生效，生产 profile 强制关闭。 |
 | 移动端候选人闭环 | 页面拆为 `/pages/candidate/index/index`、`/interview/index`、`/materials/index`、`/progress/index`、`/study/index`；面试复用 `POST /api/recruit/interview/start`、`/answer`、`/finish` 和 `GET /records`；资料 `POST/GET /api/aihr/mobile/candidate/materials`；预习 `POST /api/knowledge/search`；HR 审核 `GET /api/aihr/hr/candidate/materials`、`POST /api/aihr/hr/candidate/materials/{id}/review` | 候选人端登录后带 `Authorization` 与 `clientid` 调用；首页只按当前手机号对应的真实面试记录和最新资料状态分流，不读取公开 home seed。APP 候选人身份以后端登录手机号为准，前端 `candidateId/candidateName` 只作非 APP 场景兼容参数；面试支持文字作答和复用 `/api/ai/asr` 的录音转文字/选音频，`/answer` 可带可选 `answerAudioOssId`，服务端只接受当前候选人名下处于 `staged/bound` 状态的音频并将 `ossId` 写入问题快照，不向客户端暴露原始 OSS URL；`/answer` 与 `/finish` 还会校验当前 APP 手机号与启动会话的候选人 ID 一致，未知或他人会话直接拒绝；面试拉题/评分走真实模型优先；资料写 `sys_oss`/MinIO 和 `aihr_candidate_material`，HR 审核后进度页同步三态；岗前预习查询正式 SOP，不兜前端示例答案 |
-| 每日题反馈与常见难题 | `POST /api/aihr/mobile/practice/assignments/{id}/feedback`、`GET /api/aihr/mobile/practice/difficulties`、`POST /api/aihr/mobile/practice/difficulties/assign` | 反馈区分题目有用性与答案正确性；主管/管理端按岗位、时间、次数、人数和均分聚合，并可基于难题创建专项；身份和项目范围由服务端解析 |
+| 每日题反馈与常见难题 | `POST /api/aihr/mobile/practice/assignments/{id}/feedback`、`GET /api/aihr/mobile/practice/difficulties`、`POST /api/aihr/mobile/practice/difficulties/assign` | 反馈区分题目有用性与答案正确性；仅认证 APP 主管可按其项目范围聚合岗位、时间、次数、人数和均分，并基于难题创建专项。管理端不得调用移动主管接口；后台人工任务只走受角色保护的 `/api/train/practice/assignments/manage/**`。 |
 | 岗位考试 | 员工 `GET /api/aihr/mobile/exams`、`GET /exams/{id}`、`POST /exams/{id}/submit`；主管 `GET/POST /exams/supervisor`、`GET/PUT /exams/supervisor/{id}`、`POST /exams/supervisor/{id}/publish`、`GET /exams/supervisor/{id}/results` | 主管按项目范围选择真实员工、组卷、发布和查成绩；员工只读本人目标考试。发布和提交接受请求 ID 并保持幂等，不得重复生成成绩或奖励 |
 | 开放问题榜与积分 | 移动端 `/api/aihr/community/questions`、`questions/{id}`、`questions/{id}/answers`、`questions/{id}/best-answer`、`points/me`；后台 `/api/aihr/question-admin/**`、`/api/aihr/incentive-admin/rules` | 问题、答案、最佳答案和奖励全程按租户/身份授权；重复选优不重复入账。奖励只有积分与学习学分，不代表现金或提现 |
 | 全网 AI | 员工 `GET /api/aihr/web-ai/capabilities`、`POST /api/aihr/web-ai/query`；提供方管理 `/api/aihr/web-search/providers/**` | 与企业知识问答分入口和来源。仅接受公网 HTTPS 提供方，地址或密钥变更后必须重新连接测试；未配置/未启用时返回明确不可用，不生成假答案 |
@@ -68,6 +70,15 @@ curl -fsS -X POST "$API_BASE/api/aihr/agent/actions/<draftId>/dismiss" \
 
 校验失败返回业务码 `400`；角色/工具/项目/知识空间越权返回 `403`；会话版本、候选版本或幂等冲突返回 `409`；草稿票据 30 分钟过期后必须重新生成。Agent 审计只记录最小路由元数据，不保存上述问题、回答或附件。
 
+### 练模块身份映射
+
+#### 训练层级确认补充契约
+
+- 主管在 `POST /api/aihr/mobile/practice/reviews/{id}/reviewed` 的既有复盘请求中可选传 `confirmedGrowthLevel`，仅可为 `中级` 或 `高级`。服务端先按当前登录的 APP 主管身份及项目范围校验该会话，再锁定并读取该会话的 `growth_level`：只允许 `初级 → 中级`、`中级 → 高级`，其他值或跨级均返回业务错误。
+- 确认只会写入该 `aihr_practice_session` 的 `growth_confirmation_level/growth_confirmed_by/growth_confirmed_time`，并随主管复盘详情和员工 `GET /api/aihr/mobile/profile` 的 `growthConfirmations[]` 回显。它是可追溯的训练带教证据，不创建独立人事记录，不自动变更职级、薪酬、晋升、上岗或资格结论，也不替代待业务确认的正式解锁阈值。
+
+移动端登录主体只按认证手机号精确匹配 `person_phone`；`/me`、问师傅主体和移动训练入口均使用该精确映射，不得回落到组织模糊搜索。`/api/aihr/mobile/**` 的员工历史、画像、成长进度、任务、主管带教和对练录音下载只接受 APP 身份：员工端忽略客户端 `extPartyId`，主管端从当前 APP 手机号解析其组织外部 ID；`SYS_USER` 不得借这些接口传入员工标识读取、复盘、派发、聚合个人训练数据或按 OSS 对象编号下载录音。管理端运营预览固定为 `operator:{userId}` 与 `mode=preview`，不进入员工历史、主管复盘、成长或试点统计；后台仅通过受角色保护的 `/api/train/practice/**` 内容与任务运营契约工作。两个身份来源绝不互作替代查询键。训练任务的读取、启动、完成、每日题、画像、成长进度和晋升证据由服务端按该来源生成受控的历史别名集合，客户端不能传入替代身份。主管团队范围只保存外部 ID；旧手机号存储的记录仅当它唯一映射到一个外部 ID，且该外部 ID 在全部在职快照中也只映射到该一个手机号时，才可规范化到团队范围。规范化结果必须在团队列表、详情、复盘、音频授权与后续任务创建中复用；任一碰撞或多映射都返回无身份、拒绝猜测或读写任务。新任务仅使用唯一映射后的存储身份，旧任务仅能在同一受控别名集合内读取。
+
 ## 后端落点
 
 - 业务模块：`backend/ruoyi-modules/ruoyi-aihr`

docs/BRD_IMPLEMENTATION_AUDIT.md

@@ -1,6 +1,12 @@
 # BRD 功能审查与未完成项记录
 
-> 当前基线：2026-07-24。最新完整发布源仍为 `f023417a`（含“大喇叭 + 问模块纠偏”业务提交 `4b31848e`）；2026-07-24 的数字师傅 Agent 为本地实现，尚未发布。当前真相以本文件、[生产迁移 Runbook](BRD_PRODUCTION_MIGRATION_RUNBOOK.md)和每次发布的只读预检为准。
+> 当前基线：2026-07-24。最新完整发布源为 `342f84a9`，包含五岗位训练内容运营、M2—M3 训练闭环，以及公司消息 R1—R3；当前真相以本文件、[生产迁移 Runbook](BRD_PRODUCTION_MIGRATION_RUNBOOK.md)和每次发布的只读预检为准。
+>
+> 2026-07-24 的数字师傅 Agent、`aihr_agent_run` 和对应移动端改造已完成本地实现与分支合并，但尚未发布；不得把本地验证外推为生产部署。
+>
+> 2026-07-24 本地待发布修订：后台不再暴露个人训练、主管复盘或成长证据入口；这些能力仅留在认证 APP。本文的历史生产证据不代表该修订已上线。
+>
+> 2026-07-24 已发布修订：公司消息 R1—R3 已补齐员工直通车、部门分频道处理、业务匿名、一次正式回复，以及大喇叭单文件上传、异步提炼、摘要展示、受控下载和文件内容追问；生产认证态闭环已验证。
 >
 > 本文只维护当前结论、证据层级和剩余门槛。逐提交发布流水已从当前真相文档移除，需要追溯时使用 Git 历史；不得再用 2026-07-14/15 的“尚未发布”记录判断现网。
 
@@ -12,28 +18,26 @@
 
 | 层级 | 当前状态 | 证据与边界 |
 |---|---|---|
-| 已实现 | 是 | 已有阶段一主功能，并新增大喇叭最小闭环、消息上下文追问和“问”模块的待办/会话区纠偏；接口事实见 [API_INTEGRATION.md](API_INTEGRATION.md) |
-| 本地自动化/API 验证 | 是 | 本批定向后端测试 `91` 项、管理端测试 `18` 项、移动端测试 `129` 项及三端构建通过；具体范围仍以各测试与专项方案为准 |
-| 本地浏览器/视觉验证 | 部分 | 既有移动端和管理端视觉回归已完成；本批最终生产截图只复核未登录 H5 页面，不能替代正式认证态消息/追问流程的视觉验收 |
-| 已部署 | 是 | 管理端、H5、后端和本批四个迁移已发布；线上静态资源及 AIHR 模块与本地构建一致 |
-| 生产基础验证 | 是 | 服务 `active`；根站、H5、租户接口和员工首页 API 正常；发布时的远端 schema 清单为 `57/57`，后续只读复核确认 M1 定向表与必读字段存在；私有个人资料存储配置有效 |
-| 生产完整业务验收 | 否 | 未用正式认证账号重放管理发布—员工阅读—消息追问，也未在真实手机复验麦克风、文件/相册、下载、读屏和设备语音；严格试点窗口同样未完成 |
+| 已实现 | 是 | 已有阶段一主功能，公司消息 R1—R3 已实现直通车与公司文件提炼闭环；接口事实见 [API_INTEGRATION.md](API_INTEGRATION.md) |
+| 本地自动化/API 验证 | 是 | 训练运营定向后端测试 `76` 项；公司消息新增后端 `30` 项、管理端 `2` 项、移动端 `2` 项；管理端/H5 构建通过 |
+| 本地浏览器/视觉验证 | 部分 | 已检查管理端目录/任务、两轮动态对练、岗位不匹配拦截、直通处理和文件消息；线上已以认证态员工完成公司消息回归。训练完整写入和真机验收仍未完成 |
+| 已部署 | 是 | 管理端、H5、后端、公司消息 R1—R3、训练内容运营、M2 求助事件和租户组织治理迁移已发布；线上静态资源及 AIHR 模块与本地构建一致 |
+| 生产基础验证 | 是 | 服务 `active`；根站、H5、租户接口和员工首页 API 正常；远端完整预检为 `64/64`，且管理端/H5 资源、AIHR 模块与本地构建匹配 |
+| 生产完整业务验收 | 部分 | 公司消息已完成认证态全员文件消息和直通车闭环；训练写入、主管复盘、定向人群正反例、正式处理人绑定、真机媒体与严格试点窗口仍未完成 |
 
 “已部署”不等于“正式试点通过”。当前可以确认生产包和基础运行状态，不能把未执行的正式账号、真机和业务窗口验收写成已完成。
 
-### 2026-07-23 大喇叭与问模块增量边界
+### 2026-07-24 公司消息 R1—R3 发布边界
 
-本批已部署的公司消息能力是全员公开频道、未读/已读、当前租户的管理发布/撤回，以及以 `broadcastMessageId` 进入“问”的受控文字追问。服务端每轮重新校验租户、在职身份和消息状态，不把正文或附件文本信任为客户端上下文；消息撤回后续问即被拒绝。
+当前公司消息能力包括全员公开频道、目标快照、必读、未读/已读、管理端发布/撤回、单文件异步提炼，以及以 `broadcastMessageId` 进入“问”的受控追问。服务端每轮重新校验租户、在职身份和消息状态，正文与附件内容均由服务端加载；消息撤回后续问和文件访问即被拒绝。
 
-“问”页面将连续会话设为主体，消息/知识回答不再把通用培训或岗位资料伪造成当前员工待办。M1 的必读和目标快照 schema 已由线上只读查询确认，但正式认证态的定向发布、阅读和必读闭环尚未在本轮重放；附件、AI 摘要、“与我有关”、修订、补推、强触达和外部流程仍不在已验收范围内。
+“问”页面将连续会话设为主体，消息/知识回答不再把通用培训或岗位资料伪造成当前员工待办。生产已验证全员文件消息发布、摘要、认证下载、文件内容追问和撤回；测试消息已撤回。直通车按高管、财务、人力、审计和运营五个通道分权，处理端只见“匿名员工”，系统保留内部身份审计，每条仅一次正式回复；生产已验证员工提交、审计处理和员工查看回复。定向人群正反例、正式处理人绑定、修订、补推、强触达和外部流程仍待补齐。
 
-### 2026-07-23 M2 本地实现边界
+### 2026-07-24 M2—M3 与五岗位训练运营发布边界
 
-训练预习/求助、知识缺口留痕、动态情绪与红线纠偏、回复风格重生成、答案反馈屏蔽和方言语气参数均在本地工作区实现并按本地模型配置验证。它们尚未进入本次生产包：线上虽已有既有的录音/标注表，但缺少本批 `aihr_practice_help_event` 表；不得将 M2 的本地测试或模型配置同步写成生产部署或正式试点验收。
+当前完整包已包含训练预习/求助、知识缺口留痕、动态纠偏、受控录音/回放、逐句标注和五岗位内容运营。生产迁移包含 `aihr_practice_help_event`，并落入当前 `64/64` 远端结构预检；五岗位共 `100` 个场景，其中 `86` 个启用、`14` 个高风险场景保持禁用，另有 `100` 条启用 Rubric 与 `500` 条评分维度。
 
-### 2026-07-23 M3 本地实现边界
-
-对练的员工录音 OSS 关联、业主 TTS 的受控会话/回合绑定、主管复盘详情的受保护回放及 finish 后一次性逐句标注均已在本地实现并完成浏览器闭环。该验收使用本机项目经理与员工测试身份，只确认同项目权限范围、OSS 引用和页面交互；尚未发布生产，也未在真机麦克风、弱网或正式试点账号下验收。
+上述证据只说明代码、结构、内置内容和认证态训练入口已经发布。尚未在生产写入完整训练会话、完成主管复盘或验证真实手机麦克风、弱网、方言与正式试点账号，不能把本地浏览器验证外推为正式业务验收。
 
 ### 2026-07-24 数字师傅 Agent 本地实现边界
 
@@ -62,9 +66,10 @@
 | 不同角色/岗位内容 | 员工、候选人、主管独立入口；岗位来自组织系统，主管可切换学员模式但不改变组织身份 | 生产包已部署；全岗位内容矩阵和正式权限正反例仍需业务数据 |
 | 字号适老化 | 标准/大字/超大字全局持久化，同一页面结构响应式增高 | 本地多视口视觉通过；真实手机触控、键盘和读屏未验收 |
 | 问师傅语音与播报 | 录音、选择音频、ASR、TTS/设备语音降级恢复；答案、总结卡、每日题、点评等关键内容可播报 | 生产包已部署；生产 CosyVoice2 已按老师傅/业主/面试官区分音色，业主情绪语气与语速已在生产 H5 验证；真实手机权限、弱网、方言和正式 ASR 仍未验收 |
-| 问师傅连续对话与资料 | 认证用户短期会话保留 30 分钟/最近 6 轮，追问改写并路由 `QA/FILE/VIDEO/DATA_TOOL`；原文件/视频只从当前命中且实时授权的附件交付，无资源不造假链接 | 生产包、schema、哈希和匿名“新对话”页面已验证；正式 OTP 认证态三轮与真机下载未在生产重放 |
-| 问页面有效会话区与消息追问 | 会话开始后收起占位辅助区；大喇叭详情仅以消息 ID 受控进入短会话，消息/知识回答不伪造待办 | 当前完整包和未登录 H5 页面已生产复核；正式认证态发布—阅读—追问与 390×844 最终截图仍待验收 |
-| 银城大喇叭 | 全员公开消息、未读/已读、当前租户的管理发布/撤回已部署 | 未实现定向、附件、摘要、相关性、修订和补推；不得表述为完整公司消息运营系统 |
+| 问师傅连续对话与资料 | 认证用户短期会话保留 30 分钟/最近 6 轮，追问改写并路由 `QA/FILE/VIDEO/DATA_TOOL`；原文件/视频只从当前命中且实时授权的附件交付，无资源不造假链接 | 公司文件消息的认证下载与追问已生产验证；一般知识命中文件/视频的真机下载仍待复验 |
+| 问页面有效会话区与消息追问 | 会话开始后收起占位辅助区；大喇叭详情仅以消息 ID 受控进入短会话，消息/知识回答不伪造待办 | 生产认证态发布—阅读—文件追问已验证；390×844 最终截图和真机体验仍待补 |
+| 银城大喇叭 | 全员/定向、必读、未读/已读、发布/撤回、单文件异步提炼、摘要、受控下载和文件追问已部署 | 全员文件消息闭环已生产认证验证，测试消息已撤回；仍不含修订、补推和外部强触达，定向正反例待补 |
+| 员工直通车 | 已部署高管、财务、人力、审计、运营五个点对点频道，业务匿名、分角色收件和一次正式回复 | 生产已验证员工提交—审计处理—员工查看；五类角色已建，真实处理人员仍须按业务名单绑定 |
 | 图片/视频与总结卡图片 | 问师傅附件仅用于本次现场分析；总结卡可下载 PNG | 生产包已部署；iOS/Android H5 下载和相册/文件权限未复验 |
 | 录音归属、提交无反馈、筛选错位 | 账号/页面代次隔离、旧请求回写保护、明确加载/失败状态和窄屏布局已修 | 本地双账号/交互测试通过；生产认证态未重放 |
 | 每日题变化与题目反馈 | 五岗位题库按日期、岗位和员工身份轮换；每日题/专项支持有用/无用反馈 | 生产 schema 和包已部署；正式题库内容审核与业务样本待补 |
@@ -80,25 +85,25 @@
 ### P0：生产认证与正式试点
 
 1. 选定 1–2 个真实项目、正式员工名单和起止日期，固定试点窗口。
-2. 用正式短信 OTP 完成员工、主管、候选人和后台角色正反例；不得用开发固定验证码替代生产安全验收。
+2. 使用已授权的生产登录方式完成员工、主管、候选人和后台角色正反例；当前受控登录方式可用于验收，不再作为“无法验收”的理由。
 3. 在真实手机复验录音/选音频、TTS/设备语音、图片/视频附件、总结卡下载、三级字号、键盘和读屏。
 4. 以同一窗口收集训练、人工校准、SOP 评审、满意度和案例样本，再运行 `AIHR_PILOT_STRICT=true ./scripts/demo-check.sh`。
 
 ### P1：业务配置与终态能力
 
 1. 由业务确认五岗位正式场景、题库、SOP、资格规则及当前禁用高风险内容；seed 不能代替内容验收。
-2. 完成项目权限正例/反例、岗位内容映射和大团队批量派发验收。
+2. 完成项目权限正例/反例、岗位内容映射、大团队批量派发，以及直通车五类真实处理人员绑定。
 3. 继续用真实手机复验正式 ASR、麦克风权限、弱网、方言与全网 AI 提供方；密钥只从安全环境注入。
 4. BRD 终态仍缺员工对练图像/视频情境、服务录像回放、四川话/粤语真实样本和响应时延证据。
 5. 多租户知识平台完成正式租户 ID、空间、授权、外部应用、内容迁移和标准题签字后，才可称业务上线。
 
-## 5. 2026-07-23 当前生产发布证据
+## 5. 2026-07-24 当前生产发布证据
 
-- 发布源：`codex/broadcast-question-correction` 的 `f023417a`；本批业务改动为 `4b31848e`。
-- 生产地址：`https://peilian.njzhmj.top/`、`https://peilian.njzhmj.top/h5/`；完整备份：`/opt/wygj/backups/aihr-full-20260723-094600-f023417a`。
-- 数据库：知识分类、大喇叭、消息上下文和个人资料迁移已执行；发布时 schema 清单为 `57/57`，后续只读复核确认大喇叭发布/已读/版本幂等、M1 定向表/必读字段、消息上下文和私有个人资料存储配置。该记录不包含 M2 的训练求助事件表。
-- 产物与服务：管理端/H5 资源、后端 AIHR 模块均与当前本地构建一致，`wygj-aihr.service` 为 `active`；根站、H5、租户接口和员工首页 API 返回正常业务结果。
-- 视觉证据：最终只重新查看了未登录 H5 页面。该证据说明当前产物可达，不说明认证态的消息发布、阅读、追问或真机体验已经验收。
+- 发布源：`342f84a9 feat(aihr): complete company message R1-R3`，包含此前训练运营与公司消息增量。
+- 生产地址：`https://peilian.njzhmj.top/`、`https://peilian.njzhmj.top/h5/`；本次完整备份：`/opt/wygj/backups/company-message-r13-20260724232701`。
+- 数据库：训练、组织、`aihr_broadcast_attachment`、`aihr_direct_feedback` 和五类处理角色迁移已执行；远端 `release-preflight` 对结构的只读核验为 `64/64`。
+- 产物与服务：管理端/H5 资源、后端 AIHR 模块均与本地构建一致，`wygj-aihr.service` 为 `active`；根站、H5、租户接口和员工首页 API 返回正常业务结果。
+- 认证态生产已验证员工直通匿名提交、审计角色回复、员工查看回复，以及全员文件消息发布、摘要、下载、内容追问和撤回。直通测试记录按审计要求保留；该证据不包含完整训练写入、主管复盘、定向人群正反例或真机媒体体验验收。
 
 ## 6. 当前事实源
 
@@ -106,6 +111,7 @@
 - 客户反馈与版本连续性：[员工端版本功能对比与功能对齐清单-20260717.md](员工端版本功能对比与功能对齐清单-20260717.md)。
 - Figma 视觉与实现状态：[FIGMA需求覆盖与版本偏差审计-20260717.md](FIGMA需求覆盖与版本偏差审计-20260717.md)、[FIGMA_IMPLEMENTATION_MATRIX.md](FIGMA_IMPLEMENTATION_MATRIX.md)。
 - API 契约：[API_INTEGRATION.md](API_INTEGRATION.md)。
+- 阶段一“练”的当前范围与验收门槛：[AI陪练完整交付计划-20260724.md](AI陪练完整交付计划-20260724.md)。
 - 生产迁移与回滚：[BRD_PRODUCTION_MIGRATION_RUNBOOK.md](BRD_PRODUCTION_MIGRATION_RUNBOOK.md)。
 - 正式试点门禁：[DEMO_ACCEPTANCE.md](DEMO_ACCEPTANCE.md)。
 

docs/BRD_PRODUCTION_MIGRATION_RUNBOOK.md

@@ -14,6 +14,8 @@
 
 上述事实只证明本批版本和 schema 已发布。正式 OTP、真机能力、角色权限正反例和严格试点窗口仍需按发布后回归及 `DEMO_ACCEPTANCE.md` 验收。
 
+2026-07-24 后续新增的主管“下一训练层级确认”仍是**本地待发布增量**：同一成长目录迁移新增 `aihr_practice_session.growth_confirmation_level/growth_confirmed_by/growth_confirmed_time` 三列，供复盘会话保存可追溯训练证据。此前线上 `62/62` 预检不能证明这三列已存在；必须按本文件重新执行完整发布、远端 schema 预检和认证态复盘回归后，才可更新线上状态。该确认不改变人事职级、薪酬、上岗或资格结论。
+
 2026-07-20 增量把“项目服务记忆最小切片”扩展为工作助手确认式统一采集：显式“记一下”生成候选，用户确认后按 `PRIVATE/COMPANY` 写入 `aihr_assistant_capture`；个人记录仅本人可见，公司记录先保持 `PENDING`，正式接收端和回执尚未实现。旧 `aihr_service_memory/version` 继续兼容项目记录；同批会话式“工作上报”继续使用既有 `aihr_work_report`，并补 `request_key/request_hash` 和唯一索引。
 
 2026-07-21 已在生产发布项目化工作助手与今日工作成果提交 `4536d607`，并发布确认卡首屏修正 `11250811`：
@@ -33,6 +35,13 @@
 - 本次完整备份位于 `/opt/wygj/backups/aihr-full-20260723-094600-f023417a`，包含数据库、旧静态资源和旧 JAR；
 - 发布后仅完成公开接口和未登录 H5 页面的基础检查。正式认证账号的“管理发布—员工阅读—消息追问”闭环、真机媒体及完整个人资料能力仍未作为生产验收完成。
 
+2026-07-24 已完成五岗位训练内容运营的完整发布，发布源为 `faa2a77e`：
+
+- 在既有完整迁移序列上执行训练内容运营、M2 求助事件和租户组织治理迁移；当前远端 `release-preflight` 只读核验为 schema `62/62`，且管理端/H5 静态资源、后端 AIHR 模块均与本地构建一致，`wygj-aihr.service` 为 `active`；
+- 训练内置内容为五岗位共 `100` 个场景，`86` 个启用、`14` 个高风险场景保持禁用，另有 `100` 条启用 Rubric 和 `500` 条评分维度；这只是结构与内置内容事实，不替代业务内容签字；
+- 认证态员工 H5 已到达训练预检页；未在本次发布验证完整训练写入、主管复盘、真机麦克风/弱网或严格试点；
+- 本次完整备份位于 `/opt/wygj/backups/practice-ops-20260724003337`，包含数据库、旧静态资源和旧 JAR。
+
 2026-07-24 的数字师傅 Agent、`aihr_agent_run` 和对应移动端改造当前仅是本地发布候选；下文列入迁移顺序是为了下一次完整包发布，不代表生产已存在或已验收。
 
 ## 发布前置条件
@@ -70,6 +79,7 @@ mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aih
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260717_learning_closure_mysql8.sql
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260717_practice_five_position_catalog_mysql8.sql
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260723_practice_content_operations_mysql8.sql
+mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260724_practice_growth_curriculum_mysql8.sql
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260717_web_ai_question_reward_mysql8.sql
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260718_knowledge_conversation_mysql8.sql
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260718_release_collation_compat_mysql8.sql
@@ -91,7 +101,7 @@ mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aih
 mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/aihr_personal_knowledge_mysql8.sql
 ```
 
-顺序原因：场景补充依赖三张场景/Rubric 基础表；五维迁移依赖场景和 Rubric；五岗位题库之后的内容运营迁移为每个场景补齐唯一的初始 Rubric、五个稳定评分维度与训练时评分规则快照列，并只修正仍处于待训练状态的旧每日题场景编号，不重写已完成记录。岗位/SOP/任务/资格迁移只补正式数据契约，不写业务行，也不代表岗位适用范围、任务规则或资格标准已经获得 HR 确认。住宅 SOP 和 Prompt 迁移只补内置内容，不代表内容已完成业务复核。知识会话迁移只新增短期上下文表，不生成业务对话。排序规则兼容迁移先对齐本批发布表，全量排序规则迁移再统一历史 `aihr_*` 表；两者都读取目标库 `aihr_knowledge_info.tenant_id` 的实际排序规则。服务记忆迁移创建候选、统一采集、兼容项目记录和版本留痕四张表；工作上报幂等迁移随后只补原表列与唯一索引；知识分类迁移新增空间内分类表及附件成员的可空 `category_id`，不迁移、删除或扩大任何空间授权与检索范围；银城大喇叭 M0 迁移创建消息、阅读和不可变 v1 快照三表，为已存在消息补一次快照，并补发布请求键/载荷哈希、撤回原因及 `(tenant_id,published_by,publish_request_key)` 唯一约束。紧接着 M1 定向迁移补充必读与目标载荷字段，以及规则快照、命中对象快照两表；它只决定提醒/必读对象，不改变全租户公开频道的可见性。随后，消息追问迁移只给短期会话增加可空 `broadcast_message_id`；它不保存消息正文，并用于约束同一会话不能切换公司消息。历史普通会话保持 `NULL`。Agent 迁移只新增最小运行审计表，不保存问题、答案、密钥或模型推理。个人资料迁移最后创建独立 `aihr_personal_*` 表，并从当前租户既有 MinIO 配置派生私有 `personal-minio` 配置；`ruoyi-personal` bucket 必须由受控运维流程创建和验证，不能在文档或日志中输出访问密钥。它们同样对齐目标排序规则，兼容历史生产库与全新 MySQL 8 数据库。
+顺序原因：场景补充依赖三张场景/Rubric 基础表；五维迁移依赖场景和 Rubric；五岗位题库之后的内容运营迁移为每个场景补齐唯一的初始 Rubric、五个稳定评分维度与训练时评分规则快照列，并只修正仍处于待训练状态的旧每日题场景编号，不重写已完成记录。紧随其后的成长目录迁移只在既有场景和会话表上增加岗位/层级/能力项/审核状态与会话快照，以及复盘会话专用的 `growth_confirmation_level/growth_confirmed_by/growth_confirmed_time`；它只允许记录主管对当前会话下一训练层级的确认，不改写原训练快照或人事结论，并补齐/修复派发请求的 `(tenant_id,request_key,ext_party_id)` 唯一键与最近内容过滤索引。它保留既有启停可用性和历史会话，不把迁移结果写成业务内容签字。生产环境不得设置 `AIHR_PRACTICE_RUNTIME_SCHEMA_BOOTSTRAP=true`：应用请求只读校验表、列和关键索引，任何缺失都必须先执行本节正式 SQL，不能由任一用户请求触发补列、补索引或状态回填。岗位/SOP/任务/资格迁移只补正式数据契约，不写业务行，也不代表岗位适用范围、任务规则或资格标准已经获得 HR 确认。住宅 SOP 和 Prompt 迁移只补内置内容，不代表内容已完成业务复核。知识会话迁移只新增短期上下文表，不生成业务对话。排序规则兼容迁移先对齐本批发布表，全量排序规则迁移再统一历史 `aihr_*` 表；两者都读取目标库 `aihr_knowledge_info.tenant_id` 的实际排序规则。服务记忆迁移创建候选、统一采集、兼容项目记录和版本留痕四张表；工作上报幂等迁移随后只补原表列与唯一索引；知识分类迁移新增空间内分类表及附件成员的可空 `category_id`，不迁移、删除或扩大任何空间授权与检索范围；银城大喇叭 M0 迁移创建消息、阅读和不可变 v1 快照三表，为已存在消息补一次快照，并补发布请求键/载荷哈希、撤回原因及 `(tenant_id,published_by,publish_request_key)` 唯一约束。紧接着 M1 定向迁移补充必读与目标载荷字段，以及规则快照、命中对象快照两表；它只决定提醒/必读对象，不改变全租户公开频道的可见性。直通车迁移创建点对点反馈表，并给正式租户 `000000` 幂等预置总裁、财务、人力、审计、运营五个处理角色；人员仍须由管理员按职责分配，业务匿名不抹除内部审计身份。公司文件迁移创建异步提炼表并给消息增加可空 `attachment_id`，不迁移或公开已有文件。随后，消息追问迁移只给短期会话增加可空 `broadcast_message_id`；它不保存消息正文，并用于约束同一会话不能切换公司消息。历史普通会话保持 `NULL`。Agent 迁移只新增最小运行审计表，不保存问题、答案、密钥或模型推理。个人资料迁移最后创建独立 `aihr_personal_*` 表，并从当前租户既有 MinIO 配置派生私有 `personal-minio` 配置；`ruoyi-personal` bucket 必须由受控运维流程创建和验证，不能在文档或日志中输出访问密钥。它们同样对齐目标排序规则，兼容历史生产库与全新 MySQL 8 数据库。
 
 ## 迁移后只读核验
 
@@ -135,8 +145,8 @@ FROM information_schema.columns
 WHERE table_schema = DATABASE()
   AND (
     (table_name = 'aihr_case_record' AND column_name IN ('media_oss_id', 'media_url', 'learning_points', 'supervisor_comment'))
-    OR (table_name = 'aihr_practice_session' AND column_name IN ('dim_task_completion', 'dim_response_timeliness', 'response_latency_ms', 'rubric_code', 'rubric_version', 'rubric_snapshot_json', 'annotations_json', 'review_advice', 'incentive_point', 'satisfaction_score', 'satisfaction_comment'))
-    OR (table_name = 'aihr_practice_scenario' AND column_name IN ('content_version', 'content_hash'))
+    OR (table_name = 'aihr_practice_session' AND column_name IN ('dim_task_completion', 'dim_response_timeliness', 'response_latency_ms', 'rubric_code', 'rubric_version', 'rubric_snapshot_json', 'annotations_json', 'review_advice', 'incentive_point', 'satisfaction_score', 'satisfaction_comment', 'position_snapshot', 'project_type_snapshot', 'growth_level', 'competency_code', 'collaboration_positions', 'curriculum_version', 'growth_confirmation_level', 'growth_confirmed_by', 'growth_confirmed_time'))
+    OR (table_name = 'aihr_practice_scenario' AND column_name IN ('content_version', 'content_hash', 'growth_level', 'competency_code', 'collaboration_positions', 'review_status', 'risk_level', 'curriculum_version', 'reviewer', 'reviewer_user_id', 'reviewed_time', 'second_reviewer', 'second_reviewer_user_id', 'second_reviewed_time'))
     OR (table_name = 'aihr_practice_assignment' AND column_name IN ('score', 'score_mode', 'due_date', 'request_key', 'content_version', 'question_snapshot', 'reference_answer_snapshot', 'content_hash'))
     OR (table_name = 'aihr_sop_answer_review' AND column_name IN ('prompt_version', 'requester_ext_party_id'))
     OR (table_name = 'aihr_knowledge_info' AND column_name IN ('code', 'space_type', 'sensitivity_level', 'status'))
@@ -160,6 +170,16 @@ WHERE table_schema = DATABASE()
   )
 ORDER BY table_name, column_name;
 
+SELECT MIN(non_unique) AS non_unique,
+       GROUP_CONCAT(column_name ORDER BY seq_in_index) AS indexed_columns,
+       SUM(sub_part IS NOT NULL) AS prefix_columns
+FROM information_schema.statistics
+WHERE table_schema = DATABASE()
+  AND table_name = 'aihr_practice_assignment'
+  AND index_name IN ('uk_aihr_assignment_request', 'idx_aihr_assignment_recent_content')
+GROUP BY index_name
+ORDER BY index_name;
+
 SELECT MIN(non_unique) AS non_unique,
        GROUP_CONCAT(column_name ORDER BY seq_in_index) AS indexed_columns,
        SUM(sub_part IS NOT NULL) AS prefix_columns
@@ -219,7 +239,7 @@ ORDER BY d.dimension_code;
 
 1. 重启 `wygj-aihr.service`，确认状态为 `active`。
 2. 检查根站、`/h5/`、租户接口和员工首页 API 的 HTTP 与业务码均为 `200`。
-3. 用正式测试账号完成员工端训练、主管复盘和管理端五岗位场景、每日/专项题库、Rubric 与任务运营检查；确认停用内容不会被下发，任务创建保留题目/参考答案版本快照，训练完成记录保留开始时 Rubric 快照。不要使用开发固定验证码验证生产安全策略。
+3. 用正式测试账号完成员工端训练、主管复盘和管理端五岗位场景、每日/专项题库、Rubric 与任务运营检查；确认停用内容不会被下发，任务创建保留题目/参考答案版本快照，训练完成记录保留开始时 Rubric 快照。对初级或中级会话，主管可选确认下一训练层级；确认必须仅接受初级→中级或中级→高级，并同时在该复盘详情与员工画像中回显，且不得改变职级、薪酬、上岗或资格数据。不要使用开发固定验证码验证生产安全策略。
 4. 用正式测试账号在“工作助手”选择当前项目并说“帮我记一下三栋 3203 需要保洁服务”；确认前 `aihr_assistant_capture` 不得新增。分别验证 `PRIVATE` 仅本人可召回、`COMPANY` 只显示 `PENDING` 且没有虚假送达回执；新开对话按房号查询必须只命中对应项目记录，双击确认不得重复写入。测试表达如不需长期保留，应在确认卡选择“暂不保存”，不要直接删除生产审计记录。
 5. 在“今日工作成果”按员工 + 项目 + 日期重复生成两次，内容不变时版本哈希必须一致；员工访问团队结果、主管访问非授权项目必须被拒绝。生产无主管正式测试账号时必须明确记录未验收，不以本地 seed 代替。
 6. 用员工测试账号进入“成果投稿”，确认其仍只承载优秀案例、操作视频、完整 SOP 和有用知识，不回退为日常事实表单。重复提交同一 `request_key` 只有一条 `PENDING` 记录；普通员工审核仍为 `403`，审核通过不自动写入案例、知识或积分表。

docs/DEMO_ACCEPTANCE.md

@@ -23,17 +23,19 @@
 | 7 | 资料处理 `/knowledge/processing` | 打开页面 → 查看解析任务 → 查看处理链路 → 点“批量导入”选择少量文件或 ZIP | 可看到资料总量、等待/解析中/完成/失败、片段数、向量化状态、批次进度和事件列表；页面不出现“选择目录”“服务端导入” |
 | 8 | 员工端工作助手 `/h5/#/pages/user/sop/index` | 语音或文字说“帮我记一下三栋 3203 需要保洁服务” → 查看系统建议卡 → 在缺少单元时分别验证“暂不保存”和“仅自己保存” → 再建一条选择“提交公司处理” → 打开“我的资料与记忆” | 一级只显示“工作助手 / 查全网”；位置缺失是可选提示而非阻断；卡片可修改、暂不保存、仅自己保存、提交公司处理，提醒默认关闭；同一会话重复描述更新原卡，“另外记一条”才生成新卡；个人记录显示仅自己，公司记录显示待流转，不能显示已送达 |
 
-## AI陪练二期增量脚本
+## 陪练训练运营补充验收
+
+本节只补充当前阶段一“练”的演示/接口路径；固定范围、内容审核门槛和完整结项定义以 [AI陪练完整交付计划](AI陪练完整交付计划-20260724.md) 为准，不再将这里的历史“二期”称谓视为新的产品分期。
 
 | 顺序 | 页面 | 点击路径 | 必须看到 |
 |---|---|---|---|
-| 1 | 管理端 `/train/practice` | 切换生活顾问场景 → 查看 Rubric/预习卡 → 开始对练 | 场景来自数据库 12 条 seed；Rubric、SOP 引用、预习卡可见；模型不可用时仍回退内置剧本 |
+| 1 | 管理端 `/train/practice` | 选择已发布且启用的场景 → 查看 Rubric/预习卡 → 开始对练 | Rubric、SOP 引用、预习卡可见；无已发布内容时明确显示空态；模型不可用时仍回退内置剧本 |
 | 2 | 员工端 `/h5/#/pages/user/practice/index` | 今日任务 → 每日三题文字或录音作答 → 开始训练 → 训练中点“求助” → 完成评分 | 每日三题即时反馈且语音有回放留痕；求助命中 SOP 或明确报错；完成后画像、历史和主管端待复盘同步 |
 | 3 | 主管端 `/h5/#/pages/supervisor/index/index` | 团队画像/待复盘 → 进入复盘详情 → 看逐句标注 → 写复盘建议 → 派发再练 | 能看到评分、音频、逐句标注、主管建议；从团队画像派专项后员工端出现专项/再练任务 |
-| 4 | 管理端 `/train/practice` | 选择训练记录 → 人工校准评分 → 选择试点起止日期 → 导出试点 CSV | 导出只统计批次内能唯一匹配在职组织的正式数据，包含训练次数、每人 10 次完训率、平均分、预警数、主管复盘率、AI/人工分档一致率、SOP 可用率及正式身份明细 |
+| 4 | 服务端试点导出契约（当前管理端不展示个人训练或导出入口） | 以受角色保护的自动化/HTTP 客户端显式传入试点起止日期，调用 `GET /api/train/practice/export` | 导出只统计批次内能唯一匹配在职组织的正式数据，包含训练次数、每人 10 次完训率、平均分、预警数、主管复盘率、AI/人工分档一致率、SOP 可用率及正式身份明细 |
 | 5 | 模型成本闸门 | 设置 `AIHR_AI_RUNTIME_ENABLED=false` 后重启后端 → 调 `/api/aihr/model/chat` 或资料处理视觉链路 | 返回 `cost-guard-fallback` 或“待处理”，chat/asr/tts/vision 不再外发，不影响训练闭环 |
 
-试点正式验收前，用 `AIHR_PILOT_TENANT_ID=000000 AIHR_PILOT_START_DATE=2026-07-07 AIHR_PILOT_END_DATE=2026-07-10 AIHR_PILOT_STRICT=true ./scripts/demo-check.sh` 检查 M5 样本闸门，租户和日期替换为本批试点的真实值。闸门只统计目标租户、该时间窗内的数据；正式试点人员必须通过唯一手机号映射到在职组织快照，达到 10 次已完成对练的人数需覆盖试点人员的 80% 以上。校准样本、AI/人工分档一致率和 SOP 可用率未达标时同样失败，不用静态演示 marker 或历史 seed 数据代替真实试点数据。
+试点正式验收前，用 `AIHR_PILOT_TENANT_ID=<租户> AIHR_PILOT_START_DATE=<YYYY-MM-DD> AIHR_PILOT_END_DATE=<YYYY-MM-DD> AIHR_PILOT_STRICT=true ./scripts/demo-check.sh` 检查样本闸门。闸门只统计目标租户、该时间窗内的数据；正式试点人员必须通过唯一手机号映射到在职组织快照，达到 10 次已完成对练的人数需覆盖试点人员的 80% 以上。校准样本、AI/人工分档一致率和 SOP 可用率未达标时同样失败，不用静态演示 marker 或历史 seed 数据代替真实试点数据。
 
 2026-07-15 线上组织同步快照：开放平台返回 17 个公司、963 个部门、3417 名员工；生产 `aihr_org_snapshot` 已覆盖为 3417 行，其中 3392 人具备可用于手机号登录映射的号码，25 人手机号仍不可用，疑似乱码为 0，在职 2943 人、离职 474 人。组织同步能力和“至少 20 名正式人员可映射”的发布门槛已具备；25 人属于上游数据质量问题，不阻塞功能发布。严格试点验收仍必须用真实批次窗口产生训练、人工校准和 SOP 评审样本；旧窗口 `2026-07-07..2026-07-10` 没有人达到 10 次对练，不能作为一期业务验收完成证据。
 

docs/DEV_SETUP.md

@@ -58,7 +58,7 @@ Qdrant 默认本地无需配置；远端或自定义 collection 可用 `AIHR_QDR
 
 正式试点预检必须指定当前批次租户和时间窗，例如：`AIHR_PILOT_TENANT_ID=000000 AIHR_PILOT_START_DATE=2026-07-07 AIHR_PILOT_END_DATE=2026-07-10 AIHR_PILOT_STRICT=true ./scripts/demo-check.sh`。脚本只接受安全租户编号和 `YYYY-MM-DD` 日期，只统计目标租户窗口内完成的训练、校准和 SOP 评审；人员先按唯一手机号映射到在职组织快照，完训口径为每人至少 10 次已完成对练。
 
-管理端正式试点 CSV 也必须显式选择同一批次日期。可用真实 API 验证其日期拒绝、CSV 契约和正式身份范围：`node scripts/verify-demo-questions.mjs --pilot-export --start-date=2026-07-07 --end-date=2026-07-10`。
+服务端正式试点 CSV 也必须显式指定同一批次日期；当前管理端不展示个人训练或试点导出入口。可用受角色保护的真实 API 验证其日期拒绝、CSV 契约和正式身份范围：`node scripts/verify-demo-questions.mjs --pilot-export --start-date=2026-07-07 --end-date=2026-07-10`。
 
 本地 `.env.local` 示例：
 
@@ -139,7 +139,7 @@ AIHR_AI_SPEECH_ENABLED=true
 - 前端依赖已安装，Vite 已通过 portless 暴露为 `https://wygj-admin.localhost/`
 - 当前用户侧由 `./scripts/dev.sh` 通过 portless 启动 `mobile-uni`，入口 `https://wygj-mobile-uni.localhost/h5/`；旧移动端兜底仅在 `PORTLESS=0` 调试时启动到 `5174`
 - 移动端手机号登录页已接 `/resource/sms/code` 与 `/auth/mobile/sms-login`；未配置真实 `ALIYUN_SMS_ACCESS_KEY_ID`、`ALIYUN_SMS_ACCESS_KEY_SECRET`、`ALIYUN_SMS_SIGN_NAME`、`AIHR_SMS_LOGIN_TEMPLATE_ID` 时不会发送阿里云短信；手机号不存在时会自动注册为 `app_user`
-- 移动端员工端“开始训练”已复用 `/api/train/practice/start`、`/turn`、`/finish`；移动端请求需带登录返回的 `Authorization` 与 `clientid`；完成后主管端完训人数、“待复盘对练”计数、复盘列表、复盘详情、员工训练历史和能力画像会变化
+- 移动端员工端“开始训练”已复用 `/api/train/practice/start`、`/turn`、`/finish`；移动端请求需带登录返回的 `Authorization` 与 `clientid`，服务端会强制当前 APP 身份和 `mode=mobile`，完成后才会改变主管端完训人数、“待复盘对练”计数、复盘列表、复盘详情、员工训练历史和能力画像。管理端训练看板的同一路径只允许 `superadmin/hr_operator` 做服务端绑定的 `mode=preview` 运营预览；预览不会冒用员工身份，也不计入上述统计、复盘或试点。
 - 移动端候选人端“开始面试/面试练习”已复用 `/api/recruit/interview/start`、`/answer`、`/finish`；“补充资料”需带移动端 `Authorization` 与 `clientid`，上传后写 `sys_oss` 和 `aihr_candidate_material`，管理端 `/recruit/interview` 可审核为 `已通过/已驳回`
 - `/dev-api/auth/tenant/list` 与 `/dev-api/auth/code` 已通过前端代理返回 `200`
 - `000000 / admin / admin123` 已通过真实加密登录接口返回 `access_token`
@@ -194,7 +194,7 @@ RELEASE_REMOTE_URL=https://peilian.njzhmj.top RELEASE_VERIFY_REMOTE_MATCH=true R
 RELEASE_REMOTE_URL=https://peilian.njzhmj.top RELEASE_VERIFY_REMOTE_MATCH=true RELEASE_VERIFY_REMOTE_BACKEND=true RELEASE_VERIFY_REMOTE_SCHEMA=true ./scripts/release-preflight.sh
 ```
 
-`RELEASE_VERIFY_REMOTE_BACKEND=true` 必须与 `RELEASE_VERIFY_REMOTE_MATCH=true` 同时使用；预检会同时打印整包 jar SHA-256 和 `ruoyi-aihr` 模块内容 SHA-256，实际匹配以模块内容 hash 为准。远端后端默认核对 `/opt/wygj/app/ruoyi-admin.jar`，如发布路径不同可通过 `RELEASE_REMOTE_BACKEND_PATH` 覆盖；路径必须是安全的绝对路径。
+`RELEASE_VERIFY_REMOTE_BACKEND=true` 必须与 `RELEASE_VERIFY_REMOTE_MATCH=true` 同时使用；预检会同时打印整包 jar SHA-256 和 `ruoyi-aihr` 模块内容 SHA-256，实际匹配以模块内容 hash 为准。远端后端默认核对 `/opt/wygj/app/ruoyi-admin.jar`，如发布路径不同可通过 `RELEASE_REMOTE_BACKEND_PATH` 覆盖；路径必须是安全的绝对路径。开启远端后端或 schema 核验时，预检还会只读检查 `wygj-aihr.service` 及其 `EnvironmentFile` 的有效配置，`AIHR_PRACTICE_RUNTIME_SCHEMA_BOOTSTRAP` 必须为 `false` 或未设置；无法读取引用的环境文件会失败关闭，而不会把本机环境变量当作线上证据。
 
 带 `RELEASE_REMOTE_URL` 时，预检同时校验租户接口 JSON 的业务 `code=200`；HTTP 200 但业务返回 401/405 会判定失败。
 

docs/FIGMA_DESIGN_INVENTORY.md

@@ -2,7 +2,7 @@
 
 > Figma 文件：[银城员工端与个人 AI 助理设计](https://www.figma.com/design/30hFiKtieGYraOZvJPJcPd)
 >
-> 对照来源：`docs/物业AI人力资源系统业务需求文档BRD.md`、一期 MVP 作战清单、`docs/AI陪练二期开发推进计划.md`、`docs/20260708/AI陪练功能优化与缺口分析 三期.docx`。
+> 对照来源：`docs/物业AI人力资源系统业务需求文档BRD.md`、一期 MVP 作战清单、`docs/AI陪练二期开发推进计划.md`（历史工作包）、`docs/AI陪练完整交付计划-20260724.md`（当前阶段一范围）、`docs/20260708/AI陪练功能优化与缺口分析 三期.docx`。
 
 ## 状态说明
 

docs/FIGMA_IMPLEMENTATION_MATRIX.md

@@ -14,16 +14,16 @@
 - `已部署待业务验收`：代码和生产包已对齐，但正式账号、真机、外部提供方或真实业务数据尚未验收。
 - “Figma 位置”使用设计清单中的 node id；未标 node id 的项目不是正式画板。
 
-## 与《AI陪练二期开发推进计划》对账
+## 与当前《AI陪练完整交付计划》对账
 
 这两份文档不是同一张验收表：
 
-- 本矩阵回答“Figma 设计的页面在代码/线上完成到什么程度”，覆盖 MVP、二期、阶段二/三和已取消设计。
-- 二期计划回答“生活顾问 AI 陪练阶段一的工程闭环和 M5 试点条件是否满足”，不要求实现索引原口径下的全部 70 张 Figma 正式画板。
-- 因此，矩阵中的“未实现”不等于二期延期。开放问题榜和积分基础能力已因 2026-07-17 客户明确要求提前实现并发布；工作助手确认式采集也已在 2026-07-20 增量中部署。矩阵中仍未实现的“个人 AI 助理”主要指个人文件/网页、独立个人知识空间、分享和 PPT 页面；完整徽章荣誉和完整偏好体系仍属阶段二/三。
-- 矩阵中的“已实现”也不等于 M5 业务验收通过；评分校准、SOP 评审、正式组织身份和真实试点数据仍以严格预检为准。
+- 本矩阵回答“Figma 设计的页面在代码/线上完成到什么程度”，覆盖 MVP、阶段一、阶段二/三和已取消设计。
+- 当前计划回答“住宅物业 × 五岗位 × 三级成长”的陪练收口和真实试点条件，不要求实现索引原口径下的全部 70 张 Figma 正式画板；旧 M1-M5 仅用于追溯已完成工程工作包。
+- 因此，矩阵中的“未实现”不等于当前陪练范围延期。开放问题榜和积分基础能力已因 2026-07-17 客户明确要求提前实现并发布；工作助手确认式采集也已在 2026-07-20 增量中部署。矩阵中仍未实现的“个人 AI 助理”主要指个人文件/网页、独立个人知识空间、分享和 PPT 页面；完整徽章荣誉和完整偏好体系仍属阶段二/三。
+- 矩阵中的“已实现”也不等于正式业务验收通过；评分校准、SOP 评审、正式组织身份和真实试点数据仍以严格预检为准。
 
-与二期计划的主要对应关系：
+与当前计划的主要对应关系（M1-M5 为历史工作包标识）：
 
 | 计划范围 | 矩阵行 | 对账结论 |
 |---|---:|---|
@@ -31,9 +31,9 @@
 | M2 预习卡、情绪/红线、求助、知识缺口 | 5、6、7、27、28 | 代码闭环和问答反馈已实现；当前 Figma 差异主要是独立画板中的收藏持久化尚无后端契约，以及完整视觉状态仍需按正式画板继续复核。开放问题榜不属于本期。 |
 | M3 录音、回放、逐句标注 | 8、11、27 | 工程能力已实现；线上主管角色路由和真实音频/线上包仍需验证。 |
 | M4 画像、预警、派发、复盘建议、校准 | 9—14、26、46—47、50、61—62 | 主链路已实现；完整 Figma 看板、晋升和游戏化页面不属于本期必做。 |
-| M5 试点收口 | 26 | 只有工程闸门和导出能力已实现；正式业务是否通过不能由本矩阵判定，必须看真实组织数据和人工评审样本。 |
+| 试点收口 | 26 | 只有工程闸门和导出能力已实现；正式业务是否通过不能由本矩阵判定，必须看真实组织数据和人工评审样本。 |
 
-结论：本矩阵与二期计划**功能边界基本一致，但原表缺少计划对账层**；本节已补上，后续不再把 Figma 全量完成度当成二期完成度。
+结论：本矩阵与当前陪练计划**功能边界基本一致，但原表缺少计划对账层**；本节已补上，后续不再把 Figma 全量完成度当成陪练完成度。
 
 ## 当前剩余动作
 
@@ -74,7 +74,7 @@
 | 23 | 场景库列表/编辑/启停 | `71:628` | `frontend/src/views/train/scenarios.vue` | [x] 已实现 | 已按 Figma 独立工作台实现筛选、分页、列表、Rubric/状态展示、编辑、新增和启停；真实浏览器已验证编辑保存及停用/启用恢复 |
 | 24 | Rubric 维度/版本管理 | `72:2` | `frontend/src/views/train/rubrics.vue` | [x] 已实现 | 已按 Figma 实现版本列表、维度权重编辑、保存发布、复制版本与启停；真实浏览器已验证权重保存、复制版本落库及启用/停用恢复 |
 | 25 | 提示词模板管理 | `73:2` | `frontend/src/views/system/prompts.vue` | [x] 已实现 | 已按 Figma 独立工作台实现模板列表、名称/代码/输出文体/系统提示词/模板/变量编辑、保存草稿、保存并启用；真实浏览器已验证编辑保存、新增启用、刷新持久化，临时样本已清理 |
-| 26 | 人工评分校准/指标导出 | `74:2` | `frontend/src/views/train/reviews.vue`、`frontend/src/views/train/practice.vue` | [x] 已实现 | 已按 Figma 补齐日期窗口、岗位/组织范围、校准样本指标卡和独立 CSV 导出；真实浏览器已验证页面加载、导出下载和复盘校准表单，正式试点数据仍需真实样本 |
+| 26 | 人工评分校准/指标导出 | `74:2` | `mobile-uni/src/pages/supervisor/review/index.vue`、`frontend/src/views/train/practice.vue` | 部分实现 | 主管 APP 保留真实复盘；管理端仅保留不绑定员工身份的对练预览校准。本地待发布变更已于 2026-07-24 移除原后台复盘列表、个人训练详情和试点导出入口，避免后台账号借移动主管接口读取或操作员工数据；正式试点导出仍由受角色保护的后端接口保留，待明确独立后台契约后再暴露。 |
 | 27 | SOP 回答结果 | `79:11` | `mobile-uni/src/pages/user/sop/index.vue` | [x] 已实现 | 已按 Figma 补齐「师傅回答/我的问题/答案卡/引用依据/反馈」层级，保留真实检索、引用和反馈接口；浏览器已验证登录、真实答案展示和“有用”反馈状态 |
 | 28 | SOP 好评/差评反馈 | `79:674` | `mobile-uni/src/pages/user/sop/index.vue` | [x] 已实现；Figma 已修 | 已按 Figma 语义对齐为「有帮助/没解决」双按钮，保留真实反馈接口、提交后状态提示与按钮锁定；浏览器已验证真实搜索、点击反馈、结果提示和两个按钮 disabled。Figma 已补足画板高度并重新截图复核；其中「收藏」当前仍无后端持久化接口，未添加假按钮 |
 | 29 | SOP 后台待复核 | `80:655` | `frontend/src/views/knowledge/sop.vue` | [x] 已实现 | 已补真实答案反馈待复核队列、待复核/已复核筛选、状态展示与「标记已复核」动作；浏览器已验证刷新加载临时待复核样本、点击复核后从待办移除并清理测试数据 |
@@ -94,11 +94,11 @@
 | 43 | 工作思路整理输入 | `87:770` | — | 未实现 | 未修正，阶段二 |
 | 44 | 结论/行动项结果 | `87:815` | — | 未实现 | 未修正，阶段二 |
 | 45 | 摘要/可编辑文字生成 | `87:865` | — | 未实现 | 未修正，阶段二 |
-| 46 | 员工工作量化看板 | `89:9` | `frontend/src/views/competency/growth.vue` | 按二期计划已实现；按 Figma 部分对齐 | 已有训练时长、贡献度、测评分、等级、证据包、预警和派发；完整三期量化指标暂不补 |
+| 46 | 员工工作量化看板 | `89:9` | `mobile-uni/src/pages/user/practice/index.vue`、`mobile-uni/src/pages/supervisor/team/index.vue` | 部分实现 | 员工仅在 APP 查看本人训练画像，主管仅在 APP 项目范围查看团队训练证据；本地待发布变更中后台个人画像/证据包页面已于 2026-07-24 下线，避免混用移动身份接口。完整绩效量化指标仍不在当前范围。 |
 | 47 | 主管团队量化看板 | `89:776` | `mobile-uni/src/pages/supervisor/team/index.vue` | 按二期计划已实现；按 Figma 部分对齐 | 已有团队成员、风险、训练记录、成长证据和按项目范围聚合的团队错题本；完整团队经营指标仍需正式组织数据 |
 | 48 | HR/运营绩效看板 | `90:2` | — | 未实现 | 未修正，三期 |
 | 49 | 工作积分排行榜 | `90:91` | — | 未实现；Figma 已修 | 三期；排行榜行组件已按真实尺寸缩放头像，6 行改为可区分姓名并重新截图复核；代码仍未实现，不进入当前阶段主线 |
-| 50 | 等级/晋升条件/进度 | `90:867` | `frontend/src/views/competency/growth.vue` | 按二期计划已实现；按 Figma 部分对齐 | 已有初/中/高级成长路径和评级证据包；正式晋升申请/审核属于后续范围 |
+| 50 | 等级/晋升条件/进度 | `90:867` | `mobile-uni/src/pages/user/practice/index.vue`、`mobile-uni/src/pages/supervisor/review/index.vue` | 部分实现 | 员工 APP 展示训练成长位置；主管 APP 可将“可进入下一训练层级”作为本次复盘会话证据确认。它不等于人事晋升，本地待发布变更中后台个人评级证据包已下线；正式晋升申请/审核属于后续范围。 |
 | 51 | 破格晋升申请/审核 | `91:2` | — | 未实现 | 未修正，三期 |
 | 52 | 荣誉墙/成长档案导出 | `91:765` | — | 未实现；Figma 已修 | 徽章示例已去除重复占位文案，等级文案字符级换行已修；仍属三期，代码未实现 |
 | 53 | 七维回复风格调节 | `93:6` | `mobile-uni/src/pages/user/practice/index.vue` | 按二期计划已实现首期形态；按 Figma 部分对齐 | 已有训练内“再严肃/更温柔/更细致/更专业”重生成；偏好持久化和七维设置属于后续范围 |

docs/FIGMA需求覆盖与版本偏差审计-20260717.md

@@ -3,6 +3,8 @@
 > 生产状态更新（2026-07-18）：本文记录的 Figma 修复、代码恢复和新增学习能力已随 `32fa376d` 发布。管理端/H5/后端产物、21 个迁移、目标 schema 与关键生产页面已经验证；正式 OTP 写链路、真实手机权限、外部模型和严格试点仍未验收。文中带日期的“本轮未发布”仅描述当时批次，不再代表当前现网。
 >
 > 后续边界更新（2026-07-21）：工作助手确认式采集已实现并部署；本文“个人 AI 助理未实现”仅继续适用于个人文件/网页、独立个人知识空间、分享和 PPT 等完整页面。项目名称选择、今日工作成果和主管项目汇总仍按[后续迭代计划](工作助手与今日工作成果迭代计划-20260721.md)管理。
+>
+> 历史快照说明（2026-07-24）：本文关于管理端常见难题等页面的浏览器证据仅指当时批次；当前“练”模块的入口和身份边界以[《AI陪练完整交付计划》](AI陪练完整交付计划-20260724.md)和[API 集成契约](API_INTEGRATION.md)为准。
 
 > 日期：2026-07-17
 > Figma 文件：[银城员工端与个人 AI 助理设计](https://www.figma.com/design/30hFiKtieGYraOZvJPJcPd)

docs/P0_PILOT_ACCEPTANCE_CHECKLIST.md

@@ -1,92 +1,75 @@
-# P0 试点验收执行清单
+# P0 试点验收模板
 
-> 版本: v1.0 | 日期: 2026-07-18 | 试点窗口: 2026-07-01 至 2026-07-31 | 项目: TEST_PROJECT_001
+> 用途：每个正式试点窗口的执行清单。2026-07-18 的旧名单、旧时间窗和固定码说明不再在仓库留存；需要追溯时查 Git 历史。
+>
+> 当前范围和完成定义以 [AI陪练完整交付计划](AI陪练完整交付计划-20260724.md) 为准，生产发布/回归以 [BRD 生产迁移 Runbook](BRD_PRODUCTION_MIGRATION_RUNBOOK.md) 为准。本模板不能将本地开发固定验证码、seed 或测试账号写成正式试点证据。
 
-## 一、试点名单(生产库实际数据)
+## 一、试点批次与角色清单
 
-### 管理侧(10人)
-| 手机号 | 姓名 | 岗位 | 职级 | 验收角色 |
-|---|---|---|---|---|
-| 13800010004 | (空) | 项目经理 | 项目经理 | P0-1主管权限正例 |
-| 13016991920 | (空) | 保洁主管 | 主管 | P0-1主管权限正例 |
-| 13800010005 | (空) | 客服主管 | 主管 | P0-1主管权限正例 |
-| 13900011001 | (空) | 客服主管 | 主管 | P0-1主管权限正例 |
-| 13900012001 | (空) | 运营主管 | 主管 | P0-1主管权限正例 |
-| 13900012002 | (空) | 品质主管 | 主管 | P0-1主管权限正例 |
-| 13358160602 | (空) | 保洁主管 | 主管 | P0-1切换学员模式 |
-| 13506235116 | (空) | 保洁主管 | 主管 | P0-1派发专项 |
-| 13775002281 | (空) | 保洁主管 | 主管 | P0-1创建考试 |
-| 13800010006 | (空) | 外包负责人 | 主管 | P0-1查看团队 |
+在启动窗口前由项目负责人在受控系统登记项目、起止日、负责人和测试账号；本仓库只保留角色要求，不保存姓名、手机号、验证码或 token。
 
-### 员工侧(10人)
-| 手机号 | 姓名 | 岗位 | 职级 | 验收角色 |
-|---|---|---|---|---|
-| 13003451669 | (空) | 保洁员 | 一线 | P0-1员工权限正例 |
-| 13003671780 | (空) | 保洁员 | 一线 | P0-2语音录音+播报 |
-| 13003690513 | (空) | 保洁员 | 一线 | P0-2图片上传+下载 |
-| 13032658127 | (空) | 保洁班长 | 一线 | P0-2视频上传 |
-| 13052906326 | (空) | 保洁员 | 一线 | P0-2全局字号三档 |
-| 13060783130 | (空) | 保洁员 | 一线 | P0-1每日题去重 |
-| 13062915370 | (空) | 保洁员 | 一线 | P0-1问题榜提问 |
-| 13063972397 | (空) | 保洁员 | 一线 | P0-1问题榜回答 |
-| 13067806180 | (空) | 保洁员 | 一线 | P0-1问师傅+问AI |
-| 13069016922 | (空) | 保洁员 | 一线 | P0-1答题+积分 |
+| 验收角色 | 最小数量 | 必须具备的能力 |
+|---|---:|---|
+| 员工正例 | 1 | 当前项目在职、可完成训练与每日题 |
+| 主管正例 | 1 | 当前项目带教范围、可查看复盘并派发专项 |
+| 员工越权反例 | 1 | 无主管权限，用于验证主管页与写接口均被拒绝 |
+| 真机体验样本 | iOS/Android 各 1 | 已获测试同意，用于媒体、下载、字号与读屏验证 |
 
-### 越权反例(3人)
-| 手机号 | 姓名 | 岗位 | 职级 | 验收角色 |
-|---|---|---|---|---|
-| 13075084167 | (空) | 保洁员 | 一线 | P0-1越权:员工访问主管工作台 |
-| 13093179363 | (空) | 保洁员 | 一线 | P0-1越权:员工访问派发页 |
-| 13101885639 | (空) | 保洁员 | 一线 | P0-1越权:员工访问考试管理 |
+试点批次：`<项目名称>`
+
+统计窗口：`<YYYY-MM-DD>` 至 `<YYYY-MM-DD>`
+
+内容负责人 / 业务审核人 / 试点负责人：`<在受控系统登记>`
 
 ---
 
 ## 二、P0-1 正式 OTP 权限正反例
 
 ### 登录验收
-**固定验证码**: 123456(生产环境 `AIHR_SMS_PROD_FIXED_CODE_ENABLED=true` 时生效)
+
+使用生产短信 OTP 的实际流程，先触发获取验证码再登录。获明确风险批准的固定码试点可验证功能链路，但不能作为生产安全验收；手机号码和验证码仅留在受控测试系统，不能写入本文件、截图或提交记录。
 
 #### 正例:员工端登录流程
-- [ ] **13003451669**(保洁员) → 输入手机号 → 获取验证码 → 输入123456 → 登录成功
+- [ ] **员工正例账号**（当前项目一线员工）→ 输入手机号 → 获取验证码 → 完成正式 OTP → 登录成功
 - [ ] 自动跳转"同步岗位"页 → 匹配成功(岗位:保洁员,职级:一线) → 自动跳转"每日安排"(today页)
 - [ ] 底部tabBar显示:每日安排、对练、问师傅、我的(4个tab,无主管工作台)
 - [ ] "我的"页显示:岗位=保洁员,无"进入主管工作台"按钮
 
 #### 正例:主管端登录流程
-- [ ] **13800010004**(项目经理) → 输入手机号 → 获取验证码 → 输入123456 → 登录成功
+- [ ] **主管正例账号**（当前项目主管/项目经理）→ 输入手机号 → 获取验证码 → 完成正式 OTP → 登录成功
 - [ ] 自动跳转"同步岗位"页 → 匹配成功(岗位:项目经理,职级:项目经理) → 自动跳转"主管工作台"(supervisor/index页)
 - [ ] 顶部显示:工作台、指派、团队、复盘(4个主管tab)
 - [ ] "我的"页有"进入学员模式"按钮
 
 #### 正例:主管切换学员模式
-- [ ] **13358160602**(保洁主管) → 登录主管工作台 → 点击"我的" → "进入学员模式"
+- [ ] **主管正例账号** → 登录主管工作台 → 点击"我的" → "进入学员模式"
 - [ ] 跳转至员工端"每日安排"页,底部tabBar变为员工侧4个tab
 - [ ] 左上角显示"当前为学员模式" + "返回主管工作台"按钮
 - [ ] 点击"返回主管工作台" → 跳回主管工作台,岗位身份未改变(仍为主管)
 
 ### 权限正例:主管功能访问
-- [ ] **13506235116**(保洁主管) → 主管工作台 → 点击"指派" → 进入派发专项页
+- [ ] **主管正例账号** → 主管工作台 → 点击"指派" → 进入派发专项页
 - [ ] 支持多选团队成员(≤100人),显示当前项目在职成员列表
 - [ ] 快捷日期选择器显示:当天、明天、3天内、7天内
 - [ ] 场景下拉框显示已启用场景(如生活顾问等)
 - [ ] "派发"按钮可用,点击后显示loading → 成功提示"已派发给X人"
 
-- [ ] **13775002281**(保洁主管) → 主管工作台 → 点击"考试" → 进入考试管理页
+- [ ] **主管正例账号** → 主管工作台 → 点击"考试" → 进入考试管理页
 - [ ] 点击"创建考试" → 输入考试标题、选择岗位、添加题目 → "发布"按钮可用
 - [ ] 发布后显示"已发布" → 返回考试列表,新考试出现在列表中
 
-- [ ] **13800010006**(外包负责人) → 主管工作台 → 点击"团队" → 显示团队成员列表
+- [ ] **主管正例账号** → 主管工作台 → 点击"团队" → 显示团队成员列表
 - [ ] 列表显示成员姓名(非编号)、岗位、最近训练时间
 - [ ] 点击某成员 → 进入成员详情页,显示训练记录、得分趋势
 
 ### 权限反例:越权访问拦截
-- [ ] **13075084167**(保洁员,员工权限) → 手动构造URL访问 `/pages/supervisor/index` → 被路由守卫拦截,跳转回员工端today页,显示toast"无权访问"
-- [ ] **13093179363**(保洁员) → 手动构造URL访问 `/pages/supervisor/assign/index` → 被拦截,提示"无权访问"
-- [ ] **13101885639**(保洁员) → 手动构造URL访问 `/pages/supervisor/exams/index` → 被拦截,提示"无权访问"
+- [ ] **员工越权反例账号**（无主管权限）→ 手动构造URL访问 `/pages/supervisor/index` → 被路由守卫拦截,跳转回员工端today页,显示toast"无权访问"
+- [ ] **员工越权反例账号** → 手动构造URL访问 `/pages/supervisor/assign/index` → 被拦截,提示"无权访问"
+- [ ] **员工越权反例账号** → 手动构造URL访问 `/pages/supervisor/exams/index` → 被拦截,提示"无权访问"
 - [ ] 验证后端接口:用员工token调用 `/api/aihr/mobile/practice/assignments/batch`(派发接口) → 返回403或业务错误"权限不足"
 
 ### 每日题去重与轮换
-- [ ] **13060783130**(保洁员) → 连续7天登录 → 每天查看"每日安排"的每日题
+- [ ] **员工正例账号** → 连续7天登录 → 每天查看"每日安排"的每日题
 - [ ] 记录每天的3道题目(题面/场景),验证:
   - 7天内无重复题面(即使同一场景)
   - 同一天刷新页面,题目不变(确定性)
@@ -101,29 +84,29 @@
 - Android真机(Android 10+,微信内置浏览器 + Chrome各一台)
 
 ### 语音输入与播报
-- [ ] **13003671780**(保洁员) → 问师傅页 → 点击麦克风图标 → 允许麦克风权限
+- [ ] **真机体验样本** → 问师傅页 → 点击麦克风图标 → 允许麦克风权限
 - [ ] 说话5秒("今天客户投诉了停车费问题怎么处理") → 停止录音 → 文本框自动填入识别后的文字
 - [ ] 点击"搜索" → 等待回答 → 点击"播报"按钮 → 听到TTS语音播报回答内容
 - [ ] 真机验证降级:飞行模式 → 点击"播报" → 检查是否降级到浏览器`speechSynthesis`(iOS Safari可能无声,属已知限制)
 - [ ] 真机验证录音兜底:长按5秒说话但ASR接口超时 → 检查是否显示"选择音频文件"兜底选项
 
 ### 图片/视频上传
-- [ ] **13003690513**(保洁员) → 问师傅页 → 点击"上传图片"图标 → 从相册选择一张图片(≤10MB)
+- [ ] **真机体验样本** → 问师傅页 → 点击"上传图片"图标 → 从相册选择一张图片(≤10MB)
 - [ ] 页面显示图片预览缩略图 + "仅用于本次现场分析"提示
 - [ ] 输入问题"这个地方怎么清洁" → 点击"搜索" → 回答中包含对图片内容的分析
 
-- [ ] **13032658127**(保洁班长) → 问师傅页 → 点击"上传视频"图标 → 从相册选择一段视频(≤100MB,<30秒)
+- [ ] **真机体验样本** → 问师傅页 → 点击"上传视频"图标 → 从相册选择一段视频(≤100MB,<30秒)
 - [ ] 页面显示视频预览 + "仅用于本次现场分析"提示
 - [ ] 输入问题"这个操作对吗" → 点击"搜索" → 回答中包含对视频内容的分析
 
 ### 总结卡下载
-- [ ] **13003690513**(保洁员) → 完成一次对练 → 查看训练总结页
+- [ ] **真机体验样本** → 完成一次对练 → 查看训练总结页
 - [ ] 点击"下载总结卡"按钮 → loading状态显示
 - [ ] iOS:检查是否弹出系统分享菜单,选择"存储图像" → 打开相册验证PNG图片已保存
 - [ ] Android:检查是否弹出下载确认,点击"下载" → 打开文件管理器验证PNG图片已保存到Downloads目录
 
 ### 全局字号三档
-- [ ] **13052906326**(保洁员) → 登录员工端 → 点击"我的" → 点击"字体大小"
+- [ ] **真机体验样本** → 登录员工端 → 点击"我的" → 点击"字体大小"
 - [ ] 选择"标准" → 返回today页,目测卡片标题、正文字号正常(16px/14px左右)
 - [ ] 再次进入"字体大小" → 选择"大" → 返回today页,目测字号明显增大(约1.12倍)
 - [ ] 再次进入"字体大小" → 选择"超大" → 返回today页,目测字号最大(约1.25倍)
@@ -140,23 +123,22 @@
 
 ## 四、P0-3 严格试点窗口统计
 
-**试点窗口**: 2026-07-01 至 2026-07-31(31天)
+**试点窗口**: 以本批已登记的起止日期为准
 **完成定义**: 每人≥10次训练(对练 + 每日题,不含问师傅单次查询)
 **样本目标**: 20人完成,≥80%完成率
 
 ### 训练量统计
-- [ ] 截至2026-07-18,已有1人登录,2次训练,0人达标(当前完成率0%)
-- [ ] 窗口结束前5天(2026-07-26)复查:已完成人数/目标20人,完成率是否≥80%
+- [ ] 以正式 CSV 导出记录当前已完成人数、试点总人数和完成率，不把 seed 或旧批次数据计入
+- [ ] 窗口结束前 5 天复查:已完成人数/目标20人,完成率是否≥80%
 - [ ] 若完成率<80%,召集主管催促:每位主管至少带2名员工完成10次训练
 
 ### 人工校准样本
 - [ ] 目标:20份对练录音 → 主管先打分 → AI再打分 → 对比分差
-- [ ] 当前:0份校准样本
-- [ ] 窗口结束前7天(2026-07-24)复查:已收集校准样本数/20,AI-人工分数段一致率是否≥70%
+- [ ] 窗口结束前 7 天复查:已收集校准样本数/20,AI-人工分数段一致率是否≥70%
 
 ### SOP评审样本
 - [ ] 目标:问师傅回答可用率≥80%
-- [ ] 当前:2份样本,2份可用,可用率100%(已达标✅)
+- [ ] 以本批已签字样本计算可用率，不沿用历史样本结论
 - [ ] 窗口结束时再抽查20份问师傅记录,验证可用率稳定在80%+
 
 ### 满意度收集
@@ -192,27 +174,26 @@
 
 ## 六、验收执行时间表
 
-| 日期 | 里程碑 | 责任人 | 状态 |
+| 相对时间 | 里程碑 | 责任人 | 状态 |
 |---|---|---|---|
-| 2026-07-18 | P0清单起草完成 | 开发 | ✅ |
-| 2026-07-19 | P0-1权限正反例全部验证 | 开发+测试 | 待执行 |
-| 2026-07-19 | P0-2真机能力验证(iOS+Android各2台) | 测试 | 待执行 |
-| 2026-07-24 | P0-3中期检查(完成率/校准样本) | 项目经理 | 待执行 |
-| 2026-07-26 | P0-3末期检查(完成率冲刺) | 主管团队 | 待执行 |
-| 2026-07-31 | 试点窗口结束,统计最终数据 | 项目经理 | 待执行 |
-| 2026-08-07 | 满意度问卷收集完成 | 项目经理 | 待执行 |
-| 2026-08-08 | P0验收报告输出 | 开发+项目经理 | 待执行 |
+| 窗口开始前 | P0-1权限正反例全部验证 | 开发+测试 | 待执行 |
+| 窗口开始前 | P0-2真机能力验证(iOS+Android各2台) | 测试 | 待执行 |
+| 窗口中点 | P0-3中期检查(完成率/校准样本) | 项目经理 | 待执行 |
+| 窗口结束前 5 天 | P0-3末期检查(完成率冲刺) | 主管团队 | 待执行 |
+| 窗口结束日 | 统计最终数据 | 项目经理 | 待执行 |
+| 窗口结束后 7 天 | 满意度问卷收集完成 | 项目经理 | 待执行 |
+| 问卷完成后 | P0验收报告输出 | 开发+项目经理 | 待执行 |
 
 ---
 
 ## 七、风险与应急预案
 
 ### 风险1:完成率不达标
-- **触发条件**: 2026-07-26时完成率<50%
+- **触发条件**: 窗口结束前 5 天完成率<50%
 - **应急预案**: 
   - 主管团队每人认领2-3名员工,1对1催促
   - 开放"每日题+1次对练"任务包,完成即可算2次训练(加速达标)
-  - 必要时延长试点窗口至2026-08-07(+7天)
+  - 必要时经业务负责人批准延长窗口，并重新登记起止日期
 
 ### 风险2:真机能力不可用
 - **触发条件**: P0-2验证时iOS/Android某项能力失败率>50%
@@ -231,4 +212,4 @@
 
 ---
 
-**清单版本**: v1.0 | **最后更新**: 2026-07-18 02:45 | **下次更新**: 2026-07-19(P0-1执行后)
+**模板状态**: 等待本批项目、窗口、受控测试身份和业务审核人登记；具体完成事实只回写到对应试点报告与 [BRD_IMPLEMENTATION_AUDIT.md](BRD_IMPLEMENTATION_AUDIT.md)。

docs/README.md

@@ -11,7 +11,7 @@
 3. 专项 TechSpec 细化单个领域；实施计划可记录本地实现与验证，但部署和生产状态仍以审查文档、接口事实和真实环境证据为准。
 4. `prototypes/` 只作视觉回归基准；会议纪要、历史 Prompt、`legacy/` 与 `archive/` 只作需求来源和追溯材料。
 
-“问”模块的最终 Agent 边界见[《数字师傅工作 Agent 总体设计》](superpowers/specs/2026-07-24-digital-master-agent-design.md)，本地实施与验证进度见[《实施计划》](superpowers/plans/2026-07-24-digital-master-agent.md)；工作助手相关术语和领域数据关系见[《工作助手与今日工作成果迭代计划》](工作助手与今日工作成果迭代计划-20260721.md)。不得把本地验证外推为已部署 Agent、完整个人知识空间、完整大喇叭运营能力或外部流转已经实现。
+“问”模块的最终 Agent 边界见[《数字师傅工作 Agent 总体设计》](superpowers/specs/2026-07-24-digital-master-agent-design.md)，本地实施与验证进度见[《实施计划》](superpowers/plans/2026-07-24-digital-master-agent.md)；工作助手相关术语、实施状态与文档关系集中在[《工作助手与今日工作成果迭代计划》](工作助手与今日工作成果迭代计划-20260721.md)。当前产品优先级与本轮增量见[《银城帮道产品功能优先级与实施计划》](银城帮道产品功能优先级与实施计划-20260721.md)，阶段一“练”的唯一后续施工范围见[《AI陪练完整交付计划》](AI陪练完整交付计划-20260724.md)，公司消息现状见[九项能力设计](superpowers/specs/2026-07-24-company-message-nine-capabilities-design.md)与[大喇叭纠偏增量方案](银城大喇叭与问模块纠偏增量方案-20260722.md)。不得把本地 Agent 验证或已验证的全员文件消息和直通车闭环外推为已部署 Agent、消息修订、强触达、工单流转、完整个人知识空间或完整试点已经完成。
 
 ## 当前项目文档
 
@@ -29,7 +29,8 @@
 | [API_INTEGRATION.md](API_INTEGRATION.md) | 后端 API 对接顺序、数字师傅 Agent、正式试点 CSV、移动端训练/复盘、候选资料和 SOP 接口 |
 | [superpowers/specs/2026-07-24-digital-master-agent-design.md](superpowers/specs/2026-07-24-digital-master-agent-design.md) | “问”模块最终 Agent 产品/架构边界，以及当前已实现与后续工具范围 |
 | [superpowers/plans/2026-07-24-digital-master-agent.md](superpowers/plans/2026-07-24-digital-master-agent.md) | Agent 本地实施、自动化/H5/浏览器验证记录和剩余部署/正式验收边界 |
-| [20260718/问师傅多轮会话与原始资料交付设计.md](20260718/问师傅多轮会话与原始资料交付设计.md) | Agent 底层复用的知识短会话、指代改写和受控原文件/视频交付契约 |
+| [P0_PILOT_ACCEPTANCE_CHECKLIST.md](P0_PILOT_ACCEPTANCE_CHECKLIST.md) | 正式试点执行模板：按当前批次填写角色、窗口与证据；不在仓库保存个人身份、验证码或旧窗口结论 |
+| [20260718/问师傅多轮会话与原始资料交付设计.md](20260718/问师傅多轮会话与原始资料交付设计.md) | Agent 底层复用的知识短会话、指代改写、意图路由和受控原文件/视频交付契约 |
 | [KNOWLEDGE_PLATFORM_RUNBOOK.md](KNOWLEDGE_PLATFORM_RUNBOOK.md) | 银城/美途知识空间初始化、授权、令牌、内容迁移、监控验证和安全回滚手册 |
 | [RUOYI_AI_INCREMENTAL_MIGRATION.md](RUOYI_AI_INCREMENTAL_MIGRATION.md) | 从 `ageerle/ruoyi-ai` 分片迁移知识库、模型能力、文档解析、Qdrant/RAG 和 chat 的执行边界 |
 | [superpowers/specs/2026-07-16-multi-tenant-knowledge-platform-design.md](superpowers/specs/2026-07-16-multi-tenant-knowledge-platform-design.md) | 银城/美途独立租户、多知识空间、多调用应用统一问答、授权交集、受控数据工具和安全验收的完整需求方案 |
@@ -39,7 +40,8 @@
 | [个人AI助理阶段二专项TechSpec.md](个人AI助理阶段二专项TechSpec.md) | 工作助手确认式统一采集的当前契约，以及后续个人知识空间的数据分域、检索、权限、安全和测试规格 |
 | [工作助手与今日工作成果迭代计划-20260721.md](工作助手与今日工作成果迭代计划-20260721.md) | 工作助手项目选择、统一采集、来源追溯、今日成果、主管视图、成果投稿和外部流转的分阶段计划；含本地实施状态、390×844 证据和剩余生产边界 |
 | [银城帮道产品功能优先级与实施计划-20260721.md](银城帮道产品功能优先级与实施计划-20260721.md) | 对《银城帮道介绍》十项能力进行事实校正，给出 P0-P3、明确不做项、发布批次和本轮实施记录；产品全景施工入口 |
-| [银城大喇叭与问模块纠偏增量方案-20260722.md](银城大喇叭与问模块纠偏增量方案-20260722.md) | 已部署的大喇叭核心、消息追问与“问”模块纠偏范围，以及尚未纳入首版的定向、附件、摘要和运营能力 |
+| [银城大喇叭与问模块纠偏增量方案-20260722.md](银城大喇叭与问模块纠偏增量方案-20260722.md) | 已部署的大喇叭、单文件提炼、消息追问和独立五通道直通车边界，以及仍待补齐的定向正反例、修订、补推和强触达 |
+| [superpowers/specs/2026-07-24-company-message-nine-capabilities-design.md](superpowers/specs/2026-07-24-company-message-nine-capabilities-design.md) | 图示九项公司消息能力的归并口径、R1—R3 当前架构与明确不承担的聊天、工单、SLA 边界 |
 | [M0自动化验收说明.md](M0自动化验收说明.md) | 本机受控写入的“发布—阅读—追问—撤回”接口验收边界、运行方式与清理约束 |
 | [个人AI助理阶段二开发推进计划.md](个人AI助理阶段二开发推进计划.md) | 后续个人资料/网页/PPT 能力的 P0/P1 任务计划；“记一下”当前实现以专项 TechSpec 为准 |
 | [prototypes/personal-assistant-work-helper-voice-first-v2.png](prototypes/personal-assistant-work-helper-voice-first-v2.png) | 个人助理并入「问 · 数字师傅」后的语音优先会话、自动内部路由与确认记忆卡实现基准 |
@@ -47,10 +49,11 @@
 | [prototypes/work-assistant-project-context-v3.png](prototypes/work-assistant-project-context-v3.png) | 工作助手多项目、项目化确认卡与今日成果的权威高保真输入；运行截图另见迭代计划 §1.5 |
 | [visual-evidence/20260721/](visual-evidence/20260721/) | 工作助手项目选择、确认卡、员工今日成果和主管项目成果的 390×844 本地运行截图证据 |
 | [presentations/数字师傅工作助手迭代汇报-20260721.pptx](presentations/数字师傅工作助手迭代汇报-20260721.pptx) | 工作助手、多项目、今日成果、权限与发布边界的 5 页内部汇报稿 |
-| [AI陪练二期开发推进计划.md](AI陪练二期开发推进计划.md) | 总纲阶段一执行文档:AI 陪练从 MVP 演示闭环推进到管家(生活顾问)岗位试点可用；区分工程就绪与正式业务试点证据 |
+| [AI陪练完整交付计划-20260724.md](AI陪练完整交付计划-20260724.md) | 当前阶段一“练”模块的唯一后续施工范围：住宅物业 × 五岗位 × 三级成长；定义现有基线、收口动作、验收门槛与明确不做项 |
+| [AI陪练二期开发推进计划.md](AI陪练二期开发推进计划.md) | 2026-07-11 历史推进记录；保留 M0-M5 的工程追溯，不再作为当前施工范围 |
 | [员工端版本功能对比与功能对齐清单-20260717.md](员工端版本功能对比与功能对齐清单-20260717.md) | 旧版/历史需求/当前实现/生产验收的版本对比，以及 2026-07-17 客户反馈逐项处理结果 |
 | [BRD_IMPLEMENTATION_AUDIT.md](BRD_IMPLEMENTATION_AUDIT.md) | 当前生产基线、三端输入/BRD 匹配、客户反馈完成分层和正式试点剩余硬门槛；旧发布流水从当前真相源移除 |
-| [BRD_PRODUCTION_MIGRATION_RUNBOOK.md](BRD_PRODUCTION_MIGRATION_RUNBOOK.md) | AIHR BRD 生产 schema/内置内容迁移顺序、57 项结构核验、私有个人资料存储配置和发布后回归口径 |
+| [BRD_PRODUCTION_MIGRATION_RUNBOOK.md](BRD_PRODUCTION_MIGRATION_RUNBOOK.md) | AIHR BRD 生产 schema/内置内容迁移顺序、64 项结构核验、私有个人资料存储配置和发布后回归口径 |
 | [20260708/uni-app用户侧前端重建计划.md](20260708/uni-app用户侧前端重建计划.md) | `mobile-uni/` 重建阶段留档；当前完成状态以 BRD 审查和版本功能对比为准 |
 | [20260708/数字师傅学练问报整合方案.md](20260708/数字师傅学练问报整合方案.md) | 产品定义(学练问报+问题榜+学分晋升+个人 AI 助理)及 v1.8 “问”模块 Agent 关联与实施边界 |
 | [20260708/发布会演示候选题单.md](20260708/发布会演示候选题单.md) | 2026-07-08 发布会演示候选题单，作为产品讨论留档，不作为阶段一开发入口 |

docs/superpowers/plans/2026-07-16-multi-tenant-knowledge-platform.md

@@ -40,7 +40,7 @@
 - 财务专业、经营决策只预留方案，有真实内容、负责人和授权矩阵后再启用。
 - 不做跨租户共享、个人知识空间、任意 SQL、工资财务明细、美途订单查询。
 - 第一版数据工具仅 `MY_PRACTICE_SUMMARY` 和 `TEAM_PRACTICE_SUMMARY`。
-- 当前阶段一验收继续按 `docs/DEMO_ACCEPTANCE.md` 和 `docs/AI陪练二期开发推进计划.md`，本计划不改变其范围。
+- 当前阶段一验收继续按 `docs/DEMO_ACCEPTANCE.md` 和 `docs/AI陪练完整交付计划-20260724.md`；旧二期计划只用于追溯已完成工程工作包，本计划不改变当前阶段一范围。
 
 ### 0.3 实施总顺序
 

docs/superpowers/plans/2026-07-24-company-message-r1-r3.md

@@ -1,6 +1,7 @@
 # 公司消息系统 R1–R3 实施计划
 
 > 依据：`docs/superpowers/specs/2026-07-24-company-message-nine-capabilities-design.md`
+> 状态：2026-07-24 已完成实现、发布与生产认证验收；本文件只保留实施拆分供追溯
 
 ## R1：统一直通车
 
@@ -13,7 +14,7 @@
 
 ## R2：公司文件提炼
 
-1. 新增正式 SQL 迁移：大喇叭附件和片段表。
+1. 新增正式 SQL 迁移：大喇叭附件表及消息附件关联列。
 2. 复用现有 OSS、文档解析器和模型配置，实现大喇叭附件异步处理服务。
 3. 扩展管理端发布接口：先上传附件，处理完成后带附件 ID 发布。
 4. 扩展员工详情和原文件下载接口，按当前身份重新鉴权。
@@ -27,4 +28,4 @@
 3. 运行后端、前端、移动端和脚本验证。
 4. 启动本地界面，完成移动端和管理端截图及交互验证。
 5. 构建完整制品并按发布 Runbook 发布。
-6. 使用线上已有手机号和验证码 `123456` 完成生产认证闭环，复核远端 schema、静态资源、后端模块和服务状态。
+6. 使用线上已有受控账号完成生产认证闭环，复核远端 schema、静态资源、后端模块和服务状态。

docs/superpowers/specs/2026-07-24-company-message-nine-capabilities-design.md

@@ -2,6 +2,7 @@
 
 > 日期：2026-07-24
 > 范围：R1 统一直通车、R2 公司文件提炼、R3 系统整合与验收
+> 状态：已实现、发布并完成生产认证闭环；五个处理角色已预置，具体人员仍由管理员按实际职责绑定
 
 ## 1. 九项能力落位
 
@@ -37,9 +38,9 @@
 
 ## 3. R2：公司文件提炼
 
-管理端发布大喇叭消息时可上传一个文件。文件先进入 OSS，再由现有解析器异步提取正文、切片并生成公共摘要。解析结果保存在大喇叭专属附件和片段表，不自动进入企业知识库。
+管理端发布大喇叭消息时可上传一个文件。文件先进入 OSS，再由现有解析器异步提取正文并生成公共摘要。提取文本和摘要保存在大喇叭专属附件表，不自动进入企业知识库。
 
-文件状态为 `QUEUED/PARSING/READY/FAILED`。只有 `READY` 文件可随消息发布；失败时明确显示原因，不生成假摘要。员工详情显示摘要、目标命中原因和原文件入口。客户端下载原文件时服务端按租户、消息发布状态和当前员工身份重新鉴权。
+文件状态为 `QUEUED/PROCESSING/READY/FAILED`。只有 `READY` 文件可随消息发布；失败时明确显示原因，不生成假摘要。员工详情显示摘要、目标命中原因和原文件入口。客户端下载原文件时服务端按租户、消息发布状态和当前员工身份重新鉴权。
 
 客户端追问仍只传 `broadcastMessageId`。服务端重新加载消息及其已就绪附件片段，把受控文本加入现有消息上下文；撤回、跨租户或附件不可用时立即拒绝继续使用。
 
@@ -60,7 +61,7 @@
 
 ## 6. 验收
 
-生产认证验收直接使用线上系统已有手机号和验证码 `123456`，手机号不得出现在报告、截图或命令输出中。
+生产认证验收使用线上系统已有受控账号；账号标识不得出现在报告、截图或命令输出中。
 
 - 五渠道提交、收件和回复闭环。
 - 匿名反馈不向业务处理端泄露提交人。

docs/下一步工作计划-BRD对齐-20260715.md

@@ -93,7 +93,7 @@
 | 项 | 依据 |
 |---|---|
 | 个人 AI 助理/个人知识空间(文字/图片/文件/链接收藏、混合问答、PPT) | BRD 4.8 明确阶段二;有独立 TechSpec 与推进计划 |
-| 员工端图片/视频训练输入(4.3.3 终态缺口) | 《AI陪练二期开发推进计划》约定文本场景稳定后独立评估;届时只落有业务目的的场景(拍照报修、品检) |
+| 员工端图片/视频训练输入(4.3.3 终态缺口) | 当前《AI陪练完整交付计划》明确不纳入住宅五岗位三级训练收口；后续仅在该计划完成并经独立业务批准后，评估有明确目的的场景（拍照报修、品检） |
 | 开放问题榜、积分/排行榜/荣誉墙运营化 | 总纲阶段二;07-08 定案排行榜默认关 |
 | 师徒关系/拜师池/带徒福利 | 业务已否决(07-08) |
 | G5 情绪树洞 | 业务/法务/安全决策未定,在匿名边界与零落库合同明确前保持未实现,不用陪练情绪数据冒充 |

docs/员工端版本功能对比与功能对齐清单-20260717.md

@@ -3,6 +3,8 @@
 > 客户反馈基线：2026-07-17；当前工程与生产状态更新：2026-07-18。
 >
 > 本清单用于区分“旧版真有、历史规划、本轮新增、当前实现和生产验收”。视觉事实以 Figma 正式画板为准，功能事实以业务文档、当前代码和真实运行证据为准；Figma 未画不等于可以删除，Figma 已画也不等于已经开发或属于当前阶段。
+>
+> 历史快照说明（2026-07-24）：本文的“管理端常见难题”等描述记录 2026-07-18 的版本验证，不代表当前后台入口。当前“练”模块的范围和权限以[《AI陪练完整交付计划》](AI陪练完整交付计划-20260724.md)及其 API 契约为准。
 
 ## 1. 客观结论
 

docs/银城员工端APP分阶段实施总纲.md

@@ -1,8 +1,8 @@
 # 银城员工端 APP 分阶段实施总纲
 
-> 版本:v0.6 ｜ 日期:2026-07-21
+> 版本:v0.6 ｜ 核心边界冻结:2026-07-21 ｜ 阶段一执行入口同步:2026-07-24
 > 输入源:《基于AI的银城员工端APP项目立项与开发规划会议(2026-07-07)》纪要 +《BRD v1.1》+《AI陪练二期开发推进计划 v0.8》+《数字师傅学练问报整合方案 v1.1》(docs/20260708/)。
-> 定位:立项会把交付物从"AI 人力资源系统"升级为**银城员工端 APP**(员工服务载体)。本总纲定义三阶段顺序与边界;各阶段的执行细节仍由对应专项计划承载(阶段一 = 二期推进计划)。
+> 定位:立项会把交付物从"AI 人力资源系统"升级为**银城员工端 APP**(员工服务载体)。本总纲定义三阶段顺序与边界；阶段一当前执行入口为《AI陪练完整交付计划》，旧《AI陪练二期开发推进计划》仅保留已完成工作的追溯。
 > 分阶段口径(已定):**第一步陪练相关全部工作 → 第二步银城大喇叭 + 知识学习平台 → 第三步北森人事考勤对接**。
 > v0.2 确认(2026-07-07,客户方):①"管家"与场景库"生活顾问"为**同一岗位**,术语统一为"管家(生活顾问)",`position` 标签沿用现有值不迁移;②APP 形态定为 **H5 套壳 APP**(WebView 包装可安装),原生重写不做,D6 决策维持。
 > v0.3 修订(2026-07-08,客户产品讨论):①阶段二"知识学习平台"扩充**学模块**——标准学习计划/课程/防快进视频/最短阅读时长/不定期考试,见 §4.5;②"新问题挂榜共创"产品形态定案为**开放问题榜**,定向师带徒经会议否决不做,见 §4.4;③新增知识分级访问权限工程需求;④三项待确认已获客户回复(2026-07-08):多端跳转暂缓(只保证能打开小程序页面,D6 不动)、排行榜保留为可选开关、员工评管理层按组织架构权限控制,见 §8 与《数字师傅学练问报整合方案 v1.2》§3.3。
@@ -27,15 +27,15 @@
 
 | 阶段 | 内容 | 时间锚点 | 承载文档 |
 |---|---|---|---|
-| **一、陪练** | 陪练相关全部工作:场景库、语音对手戏、复盘、画像、派发、新员工每日三题、传帮带 | 2026-07-10 Alpha → 2026-07-13 当周 Beta → 半年会发布 → 9 月收费季前试点可用 | 《AI陪练二期开发推进计划》v0.8 |
+| **一、陪练** | 住宅物业五岗位、三级成长的场景库、语音对手戏、复盘、画像、派发、每日训练与主管带教闭环 | 2026-07-10 Alpha → 2026-07-13 当周 Beta → 半年会发布 → 9 月收费季前试点可用 | [《AI陪练完整交付计划》](AI陪练完整交付计划-20260724.md) |
 | **二、大喇叭 + 知识学习平台** | 下行:公司信息直达推送(不过滤);每份文件 AI 总结 + 分身份"跟我相关"提取(见 §4 身份模型);**学模块:标准学习计划 + 知识课程 + 不定期考试(见 §4.5)**;**个人 AI 助理:个人资料/链接收藏、检索、总结与分析(见 §4.6)**;上行:品检翻转(员工拍照上报+AI分析+积分)、开放问题榜(见 §4.4) | 半年会后启动,与阶段一试点并行推进;**学模块岗前课程最小版视资源提前到阶段一试点后** | 本总纲 §4/§5 +《数字师傅学练问报整合方案》(后续出专项计划) |
 | **三、北森对接** | SSO/组织人员同步、考勤请假入口整合;报事闭环接口对接("一键走天下") | 阶段二稳定后;报事流程梳理由闫鑫牵头业务侧先行 | 本总纲 §6(后续出集成方案) |
 
 排序理由(立项会原话):先陪练可倒逼知识沉淀 + 缓解 9 月收费压力;不求大求全,先做员工必用核心功能。
 
-## 3. 阶段一:陪练(对二期计划的增量调整)
+## 3. 阶段一：陪练（当前固定范围）
 
-二期计划主体不变,立项会带来 6 处调整(已并入 v0.6,岗位与 APP 形态两项确认已并入 v0.7,2026-07-08 产品讨论增量已并入 v0.8,详见该文档):
+当前施工和结项以[《AI陪练完整交付计划》](AI陪练完整交付计划-20260724.md)为准：范围固定为“住宅物业 × 五岗位 × 三级成长”，不因发现差异继续另开产品期。以下保留立项会对旧二期计划的调整记录；如与当前计划冲突，以当前计划为准：
 
 1. **时间锚点收紧**:8 周里程碑映射到 Alpha(2026-07-10)/Beta(2026-07-13 当周)/半年会发布/9 月收费季四个外部节点;半年会前必须收集到一线员工真实使用数据 → M1/M2 的可用增量要提前放给种子用户,不能等 M5 才见人。
 2. **岗位口径**:**已确认(2026-07-07)**——立项会所说"管家"与场景库"生活顾问"为同一岗位,文档统一写"管家(生活顾问)",`position` 标签沿用现有值不迁移;**项目经理为第二波人设**,场景由内容侧供给,不阻塞第一波。

docs/银城大喇叭与问模块纠偏增量方案-20260722.md

@@ -1,8 +1,8 @@
 # “银城大喇叭 + 问模块纠偏”增量方案
 
-> 版本：v1.1
-> 日期：2026-07-23
-> 状态：A 的事实纠偏、B 的最小消息闭环和 C 的消息上下文追问已部署，并完成当前构建、线上产物、后端模块和 `57/57` schema 的一致性核验；本方案列出的完整 B 能力和 D—E 仍待实施。
+> 版本：v1.2
+> 日期：2026-07-24
+> 状态：问模块纠偏、大喇叭发布/阅读/追问、定向/必读结构、单文件提炼，以及独立五通道直通车均已部署；当前完整包已通过线上静态资源、后端模块和 `64/64` schema 一致性核验，并完成全员文件消息与直通车的生产认证态回归。定向人群正反例、正式处理人绑定、消息修订/补推和强触达仍待补齐。
 > 适用范围：银城帮道员工端、管理端与 `ruoyi-aihr` 业务模块
 > 关联方案：[产品功能优先级与实施计划](银城帮道产品功能优先级与实施计划-20260721.md)、[员工端 APP 分阶段实施总纲](银城员工端APP分阶段实施总纲.md)、[问师傅多轮会话与原始资料交付设计](20260718/问师傅多轮会话与原始资料交付设计.md)
 
@@ -14,19 +14,20 @@
 2. 已发布的首版消息面向本租户全员可查；按项目、岗位、层级的匹配用于**置顶、提醒和排序**，不应导致员工完全看不到公司公开信息。
 3. 员工可在消息详情中点击“就这条消息问数字师傅”，带着受服务端校验的消息上下文进入现有“问”模块。
 4. “问”回答“我现在该做什么”时，必须先查该员工当前真实任务；没有任务就明确说明“当前没有查到待办”，只能给非强制建议，不能把通用培训内容伪装为已下发工作。
-5. 首版不包含高管直通、匿名建议、企业微信/短信强触达、考勤请假审批、工单派发或自动创建任务。这些能力另立流程和权限，不混入大喇叭 MVP。
+5. 员工直通车已作为独立领域实现，不复用大喇叭消息表；企业微信/短信强触达、考勤请假审批、工单派发或自动创建任务仍不纳入大喇叭。
 
 这项增量同时服务两个目的：一是让制度、通知、文件不再散落在群聊中；二是让员工在接收信息后能基于原文继续追问，并获得有来源、不过度承诺的回答。
 
-### 0.1 2026-07-23 实际交付边界
+### 0.1 2026-07-24 实际交付边界
 
 | 范围 | 当前状态 | 证据边界 |
 |---|---|---|
-| A：问模块纠偏 | 已实现并部署 | 会话开始后收起占位辅助区；消息与知识回答不得伪造员工待办，强行动入口只接受服务端真实任务事实。认证态的完整生产回归仍待执行。 |
-| B：大喇叭最小闭环 | 已实现并部署 | 员工可查看本租户已发布消息、读取未读数和写入幂等已读；管理端可按当前租户发布、列表查看和撤回。首版不含定向规则、附件、AI 摘要、“与我有关”、修订版本和人工补推。 |
-| C：消息上下文追问 | 已实现并部署 | 详情页只传 `broadcastMessageId`；服务端重验当前身份、租户、在职状态和 `PUBLISHED` 状态，同一短会话不可改绑消息，撤回后续问即拒绝。 |
-| 发布基础验证 | 已完成 | 当前构建、线上 H5/管理端资源、后端模块与 schema 已核验；服务处于 `active`。最终发布后只查看了未登录 H5 页面，尚未以正式认证账号重放“发布—阅读—追问”闭环。 |
-| 后续范围 | 未实施 | 项目/岗位/层级定向、附件与摘要、相关性说明、修订/补推、强触达和外部流程仍按本方案后续批次处理。 |
+| A：问模块纠偏 | 已实现、部署并回归 | 会话开始后收起占位辅助区；消息与知识回答不得伪造员工待办，强行动入口只接受服务端真实任务事实。 |
+| B：大喇叭消息闭环 | 已实现、部署并回归 | 支持全员公开、项目/岗位/层级目标快照、必读、已读、撤回，以及单文件上传、异步提炼、摘要展示和受控下载。生产已验证全员文件消息，测试消息随后撤回。 |
+| C：消息上下文追问 | 已实现、部署并回归 | 详情页只传 `broadcastMessageId`；服务端重验身份、租户、在职状态和消息状态，并从服务端加载附件内容。生产已验证基于文件内容回答；撤回后不可继续访问。 |
+| D：员工直通车 | 已实现、部署并回归 | 员工选择高管、财务、人力、审计或运营后业务匿名提交；内部保留身份审计，五类角色分权处理，每条仅一次正式回复。生产已验证匿名提交、审计处理、员工查看回复。 |
+| 发布基础验证 | 已完成 | 当前构建与线上 H5/管理端资源、后端模块一致，服务 `active`，schema 只读预检为 `64/64`。 |
+| 后续范围 | 部分待补 | 定向人群正反例、正式处理人绑定、消息修订/补推、强触达和外部流程仍待完成。 |
 
 本节是当前实现状态的唯一摘要；第 1—11 节保留目标设计和验收标准，不能因其中的完整设计而推断所有能力均已上线。
 
@@ -71,7 +72,7 @@
 | 银城大喇叭 | 公司信息如何可靠触达、回看和理解 | 消息发布、频道浏览、定向提醒/置顶、阅读审计、附件与摘要 | 审批流、工单系统、即时聊天、匿名建议箱 |
 | 问 · 数字师傅 | 员工如何理解制度、消息和工作知识 | 有来源的消息解读、SOP/知识问答、真实任务状态说明 | 擅自派工、自动创建任务、承诺外部部门已经处理 |
 | 学 / 练 | 员工如何获得并完成训练 | 已有学习、陪练、训练任务承接 | 承担公司通知分发 |
-| 后续员工直达 | 员工如何向管理层提出敏感意见或求助 | 后续单独设计匿名、实名、收件人、回复 SLA 与审计 | 复用大喇叭消息表“顺手实现” |
+| 员工直通车 | 员工如何向明确职能负责人提出敏感意见或求助 | 五个固定通道、业务匿名、内部审计、分权处理和一次正式回复 | 复用大喇叭消息表、即时聊天、工单转派或承诺 SLA |
 | 北森/外部 HR | 请假、考勤、正式人事流程如何办理 | 后续有正式接口合同后承接 | 用问答或大喇叭模拟审批成功 |
 
 ### 2.2 本次纳入范围
@@ -85,7 +86,7 @@
 
 ### 2.3 明确不纳入首版
 
-- 高管直通、财务/人力/审计直达、匿名建议、投诉受理及其工单分派。
+- 直通反馈的附件、多轮聊天、工单转派和 SLA。
 - 企业微信、短信、电话等强触达渠道；H5 的页面内提醒不能被表述为系统级推送。
 - 正式请假、考勤、排班、工单、线索、客户画像和北森审批。
 - 依据一条消息自动创建训练任务、工作任务、成果记录或 `COMPANY/PENDING` 外部流转。
@@ -297,14 +298,13 @@ flowchart LR
 | B：大喇叭核心 | 消息领域模型、发布/修订/撤回、首页入口、列表、详情、已读未读 | 发布角色、可公开内容范围、组织匹配字段确认 | 发布—阅读—版本—审计闭环；390×844 页面截图与交互记录 |
 | C：消息追问融合 | `messageId` 受控上下文、来源条、消息引用、附件再鉴权 | B 已有可审计的消息版本和资源引用 | 员工从详情追问、连续追问、撤回/换版本/越权三类回归 |
 | D：运营增强 | AI 摘要、相关性说明、人工补推、失败队列与报表 | 核心阅读与组织匹配运行稳定 | 摘要可回原件、低置信提示、补推审计与失败可见 |
-| E：另案能力 | 员工直达/匿名建议、企业微信或短信、北森/审批/工单 | 业务负责人、权限、回执与 SLA 明确 | 独立 BRD、TechSpec、接口和正式环境验收 |
+| E：另案能力 | 独立五通道直通车；企业微信或短信、北森/审批/工单仍另案 | 直通车依赖五类处理角色；外部流程另需接口和回执契约 | 直通车已完成生产认证闭环；外部流程仍待独立验收 |
 
-### 8.1 建议实施顺序
+### 8.1 当前实施状态
 
-1. 先完成 A：解决“问”会误导员工的质量问题，并为消息追问准备可信任务结论。
-2. 再完成 B：让消息具有稳定的发布、版本、阅读和权限事实。
-3. 完成 C：将“就这条消息问”接入成熟的短会话机制。
-4. 最后才做 D 的 AI 摘要和智能相关性。即使 AI 服务不可用，B/C 的原文阅读和人工提问仍应可用。
+1. A、B、C 已实现并完成生产回归；当前 B 不含发布后版本修订。
+2. D 已实现单文件摘要与受控下载，人工补推、失败报表和强触达仍待后续。
+3. E 中直通车已独立实现；企业微信/短信、北森、审批和工单仍保持另案。
 
 ### 8.2 代码与页面影响面（实施前复核）
 

docs/银城帮道-练与大喇叭功能介绍.md

@@ -0,0 +1,279 @@
+# 银城帮道：“练”与“银城大喇叭”功能介绍
+
+> 文档用途：产品介绍、项目汇报和员工/主管使用说明。
+>
+> 版本：v1.0 ｜ 日期：2026-07-24
+>
+> 状态说明：本文以当前实施计划、接口契约和发布审计为依据。文中的“已具备”指已有实现或已发布基础闭环；业务内容校审、真实用户试点和正式验收仍须以相应证据单独确认。
+
+## 1. 产品全景：让信息被理解，让标准被练会
+
+银城帮道中的“练”和“银城大喇叭”不是两套孤立功能。
+
+- **银城大喇叭**：把公司的通知、制度和重要提醒可靠地送到员工手中；
+- **问 · 数字师傅**：让员工读完后还能继续问清楚“这是什么意思、与我有什么关系、应该如何理解”；
+- **练**：把需要掌握的岗位标准变成可反复训练、可复盘提升的服务能力。
+
+```mermaid
+flowchart LR
+  A[公司发布制度或通知] --> B[银城大喇叭]
+  B --> C[员工阅读]
+  C --> D[问：围绕消息追问]
+  D --> E[理解规则与SOP]
+  E --> F[练：场景化对练]
+  F --> G[评分、复盘、再练]
+  G --> H[主管带教与内容优化]
+```
+
+| 模块 | 解决的问题 | 主要使用者 | 形成的闭环 |
+|---|---|---|---|
+| 练 | 服务标准如何变成员工真正会做的动作 | 员工、主管、内容运营人员 | 任务 → 对练 → 反馈 → 复盘 → 再练 |
+| 银城大喇叭 | 公司重要信息如何统一发布、阅读和回看 | 员工、内容运营人员 | 发布 → 阅读 → 已读记录 → 撤回审计 |
+| 问 · 数字师傅 | 员工看完消息后如何获得可信解释 | 员工 | 消息上下文 → 追问 → 有依据的回答 |
+
+## 2. 当前范围与口径
+
+| 能力 | 当前定位 | 不能误认为已经完成的内容 |
+|---|---|---|
+| 练 | 住宅物业五岗位的基础训练闭环，并按初级、中级、高级组织成长内容 | 全部训练内容已经业务审核、真实试点已通过、自动人事决策 |
+| 银城大喇叭 M0 | 当前租户全员公开文本消息、发布/撤回、未读与已读、列表/详情、消息追问 | 定向发布、强制必读、附件、AI 摘要、修订重发、外部强触达 |
+| 问 | 对通知、制度和内部知识进行解释；消息追问由服务端校验上下文 | 凭 AI 猜测或生成员工真实待办、工单、审批结果 |
+
+“已发布的基础能力”不等同于“已完成全部业务验收”。尤其是“练”，还需要完成场景内容校审、真实员工训练数据、主管复盘样本和正式试点证据。
+
+---
+
+## 3. “练”：AI 陪练与岗位能力提升
+
+### 3.1 产品定位
+
+“练”不是简单的题库，也不是把员工拉进一个聊天机器人。它将岗位 SOP、服务规范、常见风险和客户沟通情境组织成模拟训练，让员工在低风险环境中先练会，再用于真实服务。
+
+它的目标是帮助员工完成三件事：
+
+1. **知道标准**：理解服务步骤、关键话术和不能触碰的红线；
+2. **练出反应**：在业主、客户或协作岗位的连续追问中作出应对；
+3. **形成改进**：知道这次哪里做得好、哪里有风险、下一次具体怎样表达。
+
+初级、中级、高级只表示训练复杂度和内容进阶，不会自动改变员工职级、薪酬、晋升资格或人事档案。
+
+### 3.2 场景与岗位范围
+
+当前固定聚焦**住宅物业**，覆盖以下五个岗位。
+
+| 岗位 | 初级：能上岗 | 中级：能独立处理 | 高级：能处理复杂协同 |
+|---|---|---|---|
+| 生活顾问 | 接待与记录、巡检、报事报修受理、基础服务规范 | 投诉、催费、停车费沟通、跨部门跟进、回访 | 重大投诉服务恢复、群体沟通、风险预判 |
+| 保安 | 门岗礼仪、访客车辆、巡查与异常上报 | 纠纷初处、夜间/高峰处置、与管家协同 | 突发事件协同、现场秩序组织、复盘交接 |
+| 保洁 | 作业标准、工具安全、现场反馈 | 卫生异常、投诉处理、时间与区域协调 | 重大活动保障、跨工种协同、品质复盘 |
+| 保修（工程） | 安全确认、报修受理、上门服务、完工说明 | 故障初判、延期沟通、跨部门转办 | 高风险故障协同、复杂工单、服务恢复 |
+| 客服 | 咨询受理、信息记录、基础话术 | 投诉分级、情绪安抚、跟进协调 | 复杂客诉、群体沟通、服务升级与复盘 |
+
+每个可开放给员工的训练单元都应具备四项基础：经审核的场景、可追溯的 SOP/制度依据、对应的评分标准，以及明确的服务或安全红线。
+
+### 3.3 员工端功能与用法
+
+#### 训练任务
+
+员工在“练”模块中可以看到以下来源的训练：
+
+| 任务类型 | 适用场景 | 员工看到的含义 |
+|---|---|---|
+| 每日训练 | 按当前成长层和待巩固能力安排 | 今天建议优先完成的练习 |
+| 专项训练 | 主管针对某一服务问题或活动安排 | 需要重点提升的具体能力 |
+| 再练任务 | 分数偏低、触发红线或主管要求强化 | 应针对上一次问题重新练习 |
+| 自主练习 | 已开放的场景 | 员工可主动选择需要巩固的内容 |
+
+任务来源不等于能力等级。例如，专项训练可以跨越员工当前层级，但应有明确的业务或带教原因。
+
+#### 一次训练怎么完成
+
+1. 进入“练”，选择今日任务或自主练习场景。
+2. 先查看训练准备卡：核心注意点、服务红线和推荐表达。
+3. 通过文字或语音，和 AI 扮演的业主、客户或协作岗位进行多轮模拟对话。
+4. 训练过程中可请求与当前场景相关的 SOP 提示；它只帮助理解，不会替员工虚构真实任务。
+5. 结束训练后，查看总结并决定是否立即再练。
+
+语音训练与文字训练使用同一业务闭环：语音可以转写为对话输入，也可以播放角色回复。麦克风不可用时，客户端仍应提供可选择/录制音频后继续识别的后备路径。
+
+#### 训练结束后能看到什么
+
+一份训练总结至少应包含：
+
+- 多维能力评分；
+- 本次表现较好的证据句；
+- 需要注意的服务、安全或沟通红线；
+- 更合适的表达建议；
+- 下一步推荐训练、是否需要重练；
+- 个人训练历史、易错点和能力进度。
+
+典型例子：生活顾问练习“业主投诉维修迟迟未完成”。员工先练习安抚与信息确认，再练习与工程协同、解释时限和回访承诺。训练总结会指出是否遗漏风险说明、是否过度承诺时限，以及下一次可如何表达得更准确。
+
+### 3.4 主管端功能与用法
+
+主管的作用不是只查看分数，而是完成带教闭环：
+
+1. 查看团队训练完成情况、风险提醒和待复盘记录；
+2. 打开训练详情，回听录音并查看关键对话、评分依据和逐句标注；
+3. 写下复盘建议，指出员工应改善的服务动作或表达；
+4. 为员工派发专项训练或再练任务；
+5. 在有训练证据的前提下，人工确认员工可以尝试下一层训练内容。
+
+主管确认只是一项训练带教证据，不会自动写入 HR 等级、薪酬、任职资格或晋升结论。
+
+### 3.5 内容运营功能与用法
+
+内容运营人员在既有训练运营后台中管理“练”的内容，而不是另建一套培训系统：
+
+- 配置岗位、能力项、场景、目标、角色人设和多轮对话；
+- 绑定 SOP、制度或业务来源；
+- 配置 Rubric 和服务红线；
+- 管理场景生命周期：`草稿 → 待业务审核 → 已发布 → 已下线`；
+- 对收费、安全、投诉等高风险内容执行双人审核；
+- 按“住宅物业 × 岗位 × 成长层 × 能力项”查看内容覆盖缺口；
+- 保留内容版本与训练会话快照，避免新规则改写历史训练结论。
+
+员工只能看到“已发布且启用”的内容；未审核、下线或高风险审核未完成的内容不能作为员工训练任务开放。
+
+### 3.6 “练”的业务价值
+
+- 新员工：先练标准接待、报修受理和基础安全规范，降低首次上岗的不确定性；
+- 一线员工：把投诉、协同和复杂沟通放进可重复练习的场景，减少只听课不会用；
+- 主管：从“凭感觉带人”转为有训练记录、有问题证据、有再练安排的带教；
+- 运营：发现哪些 SOP 被频繁问、哪些话术容易触发风险，再反向优化场景和制度说明。
+
+### 3.7 “练”的明确边界
+
+- 不以 AI 评分直接决定员工人事结果；
+- 不以种子数据、测试账号或截图替代真实试点证据；
+- 当前不将视频情境训练、服务录像回放、方言正式验收包装为已完成能力；
+- 当前不因每发现一个需求就另起“第 N 期”，五岗位、三级成长已是阶段一固定范围。
+
+---
+
+## 4. “银城大喇叭”：公司消息的正式入口
+
+### 4.1 产品定位
+
+银城大喇叭是员工端的**公司公共信息频道**。它承载正式、需要统一口径的公司信息，避免重要内容分散在微信群或聊天记录中而无法回看、无法确认是否阅读。
+
+适合发布的内容包括：
+
+- 公司通知、制度更新、服务标准；
+- 重要培训、活动和专项工作提醒；
+- 面向全员的安全、品质、运营要求；
+- 需要员工查看原文并进一步理解的规则说明。
+
+员工通过首页右上角的喇叭入口进入，不新增第五个底部 Tab。
+
+### 4.2 当前基础版（M0）功能
+
+| 角色 | 已具备能力 | 使用方式 |
+|---|---|---|
+| 员工 | 未读红点 | 首页喇叭提示有新的公司消息 |
+| 员工 | 消息列表与详情 | 查看当前租户已发布的全员公开消息 |
+| 员工 | 已读记录 | 打开详情后写入幂等的已读记录，支持审计 |
+| 员工 | 围绕消息追问 | 从详情进入“问”，不需要复制粘贴原文 |
+| 内容运营人员 | 发布消息 | 在管理端“内容运营 → 银城大喇叭”填写标题和正文并发布 |
+| 内容运营人员 | 撤回消息 | 误发或失效时填写撤回原因，保留发布与撤回审计 |
+
+当前 M0 的消息是**面向当前租户全员公开发布的文本消息**。发布后员工可见；撤回后员工不能继续查看，但管理端保留可追溯的发布和撤回记录。
+
+### 4.3 员工如何使用
+
+1. 在首页看到喇叭未读提示后，进入“银城大喇叭”。
+2. 在列表中选择消息，阅读标题、正文和发布时间。
+3. 打开详情后，系统记录本人的已读状态；重复打开不会重复写入多条记录。
+4. 如有疑问，点击“就这条消息问数字师傅”，围绕该消息继续追问。
+
+适合追问的问题包括：
+
+- “这次制度和原来相比改了什么？”
+- “我所在岗位应该重点注意哪几项？”
+- “通知里提到的 SOP 在哪里可以查看？”
+- “遇到业主质疑时，推荐怎样解释？”
+
+消息追问只绑定消息 ID，由服务端重新校验消息状态、当前租户和员工身份。消息已撤回、跨租户或员工不再在职时，不能继续以该消息作为上下文追问。
+
+### 4.4 管理端如何发布和撤回
+
+1. 进入管理端 **内容运营 → 银城大喇叭**。
+2. 新建消息，填写标题和正文。
+3. 确认向当前租户全员公开发布。
+4. 发布后在消息管理列表中查看状态和审计信息。
+5. 如内容误发或失效，填写原因后撤回。
+
+消息以首次发布的内容快照为准。当前不支持直接编辑已发布消息；需要停止展示时，应撤回并保留原因，避免历史口径被无痕改写。
+
+### 4.5 消息追问与“问”模块的关系
+
+大喇叭负责“**告诉员工是什么**”，问负责“**帮助员工理解为什么和怎么做**”。
+
+系统可以解释通知、制度、SOP 和建议动作，但必须遵守以下边界：
+
+- 可以说“这项制度通常要求先完成哪些步骤”；
+- 可以基于授权资料说明“与你的岗位相关的注意点”；
+- 不可以在没有真实任务数据时说“主管已经给你派了任务”；
+- 不可以把通用建议伪装成当前员工的真实待办、工单或审批结果。
+
+如果员工问“我现在要做什么”，系统只能根据服务端已授权的真实任务数据回答“有任务”“当前没有查到待办”或“无权确认”，不能由大模型自行生成任务结论。
+
+### 4.6 当前不属于 M0 的能力
+
+以下能力可作为后续增强，但不能在当前产品介绍中表述为已正式验收：
+
+- 按项目、岗位、成长层级定向发布；
+- “与我有关”自动筛选和优先级排序；
+- 必读、未读催办和强制阅读闭环；
+- 图片、文件、制度附件下发；
+- AI 摘要、版本修订、补发和重推；
+- 企业微信、短信、电话等外部强触达；
+- 高管直通、匿名建议、审批、工单派发等独立业务流程。
+
+---
+
+## 5. 两个模块的联动场景
+
+### 场景一：制度更新后的理解与训练
+
+1. 公司通过大喇叭发布《投诉处理时效更新》；
+2. 员工阅读后追问新旧要求、适用范围和推荐话术；
+3. 主管发现该制度需要强化后，人工指派“投诉升级处理”专项训练；
+4. 员工在“练”中完成模拟对话和训练总结；
+5. 主管复盘并安排再练，运营根据高频问题完善制度说明或训练场景。
+
+> 当前边界：一条通知不会自动创建训练任务、工作任务或成果记录；是否安排训练仍由主管或运营人员按真实业务流程决定。
+
+### 场景二：高风险服务规范强化
+
+1. 大喇叭发布安全或收费相关服务提醒；
+2. 员工先阅读原文并追问红线与 SOP；
+3. 运营人员将高风险训练场景完成双人审核后开放；
+4. 员工练习沟通和处置，主管重点复盘是否触碰红线。
+
+### 场景三：从员工问题反哺内容
+
+1. 员工持续围绕某条制度提出相似问题；
+2. 运营人员识别出原通知解释不足或现有训练场景缺失；
+3. 更新 SOP 说明、补充场景并经过审核；
+4. 后续员工在大喇叭、问和练中获得更一致的口径。
+
+这是一条人工运营闭环，不应由系统在无审核的情况下自动改写通知、SOP 或训练内容。
+
+## 6. 对外介绍时建议统一使用的表述
+
+| 主题 | 推荐表述 |
+|---|---|
+| 练 | “面向住宅物业五岗位的 AI 场景化陪练，帮助员工把 SOP 和服务规范练成可执行动作。” |
+| 主管带教 | “主管可基于训练证据复盘、点评和安排再练，不以 AI 自动决定人事结果。” |
+| 银城大喇叭 | “公司面向当前租户全员的正式消息频道，支持发布、阅读、撤回和围绕消息追问。” |
+| 问 | “员工可基于通知原文、制度和授权知识持续追问，答案不越权、不虚构真实待办。” |
+| 当前进度 | “基础闭环已具备；完整内容审核、真实试点和后续定向/必读能力按独立验收口径推进。” |
+
+## 7. 依据与关联文档
+
+- [AI陪练完整交付计划（固定范围版）](AI陪练完整交付计划-20260724.md)
+- [银城大喇叭与问模块纠偏增量方案](银城大喇叭与问模块纠偏增量方案-20260722.md)
+- [API 对接与接口边界](API_INTEGRATION.md)
+- [BRD 实现与发布审计](BRD_IMPLEMENTATION_AUDIT.md)
+- [员工端 APP 分阶段实施总纲](银城员工端APP分阶段实施总纲.md)

docs/银城帮道产品功能优先级与实施计划-20260721.md

@@ -2,7 +2,7 @@
 
 > 版本：v1.3
 > 日期：2026-07-23
-> 状态：2026-07-21 的多项目、确认式采集和今日工作成果，以及 R0 的历史日期选择、未来日期拒绝和主管手机号授权均已部署；R2 的大喇叭最小闭环和消息追问已于 2026-07-23 随全量迁移发布，完成本地测试、构建和远端服务、产物、后端模块及 `57/57` schema 核验。
+> 状态：2026-07-21 的多项目、确认式采集和今日工作成果，以及 R0 的历史日期选择、未来日期拒绝和主管手机号授权均已部署；R2 的大喇叭最小闭环和消息追问已于 2026-07-23 随全量迁移发布。其 `57/57` 为首轮历史核验；2026-07-24 当前完整包已再次通过远端服务、产物、后端模块及 `62/62` schema 核验。
 > 需求输入：微信临时文件《银城帮道 介绍(1).html》、2026-07-19/20 客户沟通、当前 BRD/TechSpec 与线上事实
 > 适用范围：员工端、主管端、管理端及后续外部业务接口
 
@@ -190,6 +190,6 @@
 后续每个 Agent 开始开发前先阅读本计划，再按对应专项文档实施：
 
 - 工作助手与日报：[工作助手与今日工作成果迭代计划](工作助手与今日工作成果迭代计划-20260721.md)
-- AI 陪练：[AI 陪练二期开发推进计划](AI陪练二期开发推进计划.md)
+- AI 陪练：[AI陪练完整交付计划](AI陪练完整交付计划-20260724.md)（旧二期计划仅作历史追溯）
 - 总阶段边界：[银城员工端 APP 分阶段实施总纲](银城员工端APP分阶段实施总纲.md)
 - 工程契约：[物业 AI 人力资源系统开发规格 TechSpec](物业AI人力资源系统开发规格TechSpec.md)