BRD 功能审查与未完成项记录

当前基线：2026-07-18，生产功能包提交 064816a784dad535f2320c4321f73f2e6e364d69。

本文只维护当前结论、证据层级和剩余门槛。逐提交发布流水已从当前真相文档移除，需要追溯时使用 Git 历史；不得再用 2026-07-14/15 的“尚未发布”记录判断现网。

1. 当前结论

客户在 2026-07-17 反馈的主要回退和新增项已经进入当前生产包，包括语音输入与关键内容播报、总结卡图片、全局三级字号、主管学习端、姓名多选与快捷截止日期、每日题轮换和题目反馈、常见难题、开放问题榜与积分、完整岗位考试、全网 AI 独立入口、多租户知识空间管理，以及问师傅短期多轮、追问改写和受控原文件/视频交付。

完成状态必须分层表达：

层级	当前状态	证据与边界
已实现	是	主功能提交 `6bdc86e3`，排序规则兼容修复 `32fa376d`，问师傅短期会话提交 `064816a7`
本地自动化/API 验证	是	功能批次已完成后端、前端、移动端测试与真实本地 API 闭环；具体用例见代码测试和版本功能清单
本地浏览器/视觉验证	是	24 个移动端状态和 3 个管理端页面已操作并逐页截图，无页面级横向溢出、控制台错误或失败请求
已部署	是	管理端、H5、后端和 22 个版本化迁移已发布；线上产物哈希与本地发布产物一致
生产基础验证	是	服务 `active`；根站、H5、租户接口、员工首页 API 正常；目标 schema `35/35`，本次 19 张发布表排序规则 `19/19` 对齐；管理端关键页和移动端“新对话”已浏览器复核
生产完整业务验收	否	未用正式 OTP 重放员工/主管认证写链路，未在真实手机复验麦克风、文件/相册、下载、读屏和设备语音，也未完成严格试点窗口验收

“已部署”不等于“正式试点通过”。当前可以确认生产包和基础运行状态，不能把未执行的正式账号、真机和业务窗口验收写成已完成。

未发布工作区增量（2026-07-20）

工作助手“记一下”统一采集已完成本地编码、数据库迁移、目标测试、390×844 视觉交互和真实 HTTP 召回验证；PRIVATE 仅本人可见，COMPANY 只写 PENDING。该增量尚未提交或部署，不属于上表的生产包；外部线索/工单投递、正式回执、个人文件/网页知识空间仍未实现。

2. 三端输入与 BRD 匹配

角色端	当前能力	BRD 判断
员工端	对练、每日题和问师傅支持文字/语音；问师傅附件支持图片/视频仅用于本次分析；关键题目、回答、点评和总结卡支持播报；案例支持音频上传	阶段一文字/语音主链路已实现并部署；对练的图像/视频情境输入、服务录像回放和方言正式样本仍未达到 BRD 终态
候选人端	面试支持文字、录音转写和选择音频；补充资料支持文档/图片	满足当前面试和资料链路；图片资料不参与面试多模态评分
主管端	文字复盘、回听员工录音、姓名多选派发、考试组卷/发布/成绩、工作台与学员模式切换	当前主管闭环已实现；项目范围和角色正反例仍需正式账号复核

3. 客户反馈处理结果

反馈主题	当前实现	生产验证边界
不同角色/岗位内容	员工、候选人、主管独立入口；岗位来自组织系统，主管可切换学员模式但不改变组织身份	生产包已部署；全岗位内容矩阵和正式权限正反例仍需业务数据
字号适老化	标准/大字/超大字全局持久化，同一页面结构响应式增高	本地多视口视觉通过；真实手机触控、键盘和读屏未验收
问师傅语音与播报	录音、选择音频、ASR、TTS/设备语音降级恢复；答案、总结卡、每日题、点评等关键内容可播报	生产包已部署；生产 CosyVoice2 已按老师傅/业主/面试官区分音色，业主情绪语气与语速已在生产 H5 验证；真实手机权限、弱网、方言和正式 ASR 仍未验收
问师傅连续对话与资料	认证用户短期会话保留 30 分钟/最近 6 轮，追问改写并路由 `QA/FILE/VIDEO/DATA_TOOL`；原文件/视频只从当前命中且实时授权的附件交付，无资源不造假链接	生产包、schema、哈希和匿名“新对话”页面已验证；正式 OTP 认证态三轮与真机下载未在生产重放
图片/视频与总结卡图片	问师傅附件仅用于本次现场分析；总结卡可下载 PNG	生产包已部署；iOS/Android H5 下载和相册/文件权限未复验
录音归属、提交无反馈、筛选错位	账号/页面代次隔离、旧请求回写保护、明确加载/失败状态和窄屏布局已修	本地双账号/交互测试通过；生产认证态未重放
每日题变化与题目反馈	五岗位题库按日期、岗位和员工身份轮换；每日题/专项支持有用/无用反馈	生产 schema 和包已部署；正式题库内容审核与业务样本待补
常见难题与一键派专项	管理端按岗位、时间、次数、人数、均分排序并可生成专项	生产页面已打开复核；正式团队样本待补
指派姓名、多选、快捷日期	项目内在职人员姓名选择，最多 100 人，四档快捷日期，幂等批量提交和逐人结果	本地真实 API 已验证；生产大团队、时区边界和权限正反例待补
开放问题榜与奖励	提问、回答、审核、最佳答案、积分规则和积分/学习学分双账户已实现；重复选优不重复发奖	生产页面/schema 已验证；正式运营规则和认证写链路待验收；不是现金、不可提现
岗位入职考试	主管选择岗位/项目/员工、组卷、发布、截止日期和成绩；员工答题、播报、提交、逐题结果；提交幂等	本地发布与 100 分提交/重放通过；生产正式账号未重放
问 AI（全网）	与企业问师傅分入口、接口、来源和提示；只允许已测试启用的公网 HTTPS 提供方	管理页已生产打开；未配置正式提供方密钥时明确不可用，不生成假答案
多租户知识空间	空间、授权、调用应用、统一问答、审计、限流和受控数据工具已实现	生产页面/schema 已验证；银城/美途正式空间、授权矩阵、令牌和内容迁移仍需业务确认后执行

4. 当前剩余硬门槛

P0：生产认证与正式试点

选定 1–2 个真实项目、正式员工名单和起止日期，固定试点窗口。
用正式短信 OTP 完成员工、主管、候选人和后台角色正反例；不得用开发固定验证码替代生产安全验收。
在真实手机复验录音/选音频、TTS/设备语音、图片/视频附件、总结卡下载、三级字号、键盘和读屏。
以同一窗口收集训练、人工校准、SOP 评审、满意度和案例样本，再运行 AIHR_PILOT_STRICT=true ./scripts/demo-check.sh。

P1：业务配置与终态能力

由业务确认五岗位正式场景、题库、SOP、资格规则及当前禁用高风险内容；seed 不能代替内容验收。
完成项目权限正例/反例、岗位内容映射和大团队批量派发验收。
继续用真实手机复验正式 ASR、麦克风权限、弱网、方言与全网 AI 提供方；密钥只从安全环境注入。
BRD 终态仍缺员工对练图像/视频情境、服务录像回放、四川话/粤语真实样本和响应时延证据。
多租户知识平台完成正式租户 ID、空间、授权、外部应用、内容迁移和标准题签字后，才可称业务上线。

5. 2026-07-18 生产发布证据

分支：codex/multi-tenant-knowledge-platform，已推送到 origin。
当前生产功能包：064816a784dad535f2320c4321f73f2e6e364d69；前序主功能提交：6bdc86e3。
当前发布备份：/opt/wygj/backups/ask-memory-20260718-2130（数据库、JAR、H5 及 SHA-256）；前序备份仍保留在 /opt/wygj/backups/release-20260718005151。
生产地址：https://peilian.njzhmj.top/、https://peilian.njzhmj.top/h5/。
数据库：22 个版本化迁移已应用；目标 schema 35/35；19 张发布表与知识主表租户字段排序规则 19/19 对齐，会话表两个业务索引均存在。
浏览器：管理端首页、常见难题、问题榜运营、知识空间、全网 AI 配置和 390×844 移动端 H5 已查看；当前发布又实际点击了“新对话”，最终页面无控制台/请求错误。
发布中发现知识空间页因历史库排序规则混用报错，已通过 aihr_20260718_release_collation_compat_mysql8.sql 根因修复并重新验证；禁止用 SQL 临时转换掩盖同类 schema 漂移。

6. 当前事实源

工程、运行和发布规则：README.md、AGENTS.md。
客户反馈与版本连续性：员工端版本功能对比与功能对齐清单-20260717.md。
Figma 视觉与实现状态：FIGMA需求覆盖与版本偏差审计-20260717.md、FIGMA_IMPLEMENTATION_MATRIX.md。
API 契约：API_INTEGRATION.md。
生产迁移与回滚：BRD_PRODUCTION_MIGRATION_RUNBOOK.md。
正式试点门禁：DEMO_ACCEPTANCE.md。

任何新结论仍要分别记录“已实现、本地验证、视觉验证、已部署、生产验证、正式业务验收”，不得合并成一个笼统的“完成”。

9.7 KiB Raw Blame History