feat(aihr): finalize practice growth and access boundaries

2026-07-25 00:42:19 +08:00
parent a90f40e4d8
commit c9d2012ec1
87 changed files with 6804 additions and 2538 deletions
@@ -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)。