9.6 KiB
9.6 KiB
BRD 功能审查与未完成项记录
更新时间：2026-07-14
1. 审查口径
本记录以 物业AI人力资源系统业务需求文档BRD.md 为业务事实源，以 FIGMA_IMPLEMENTATION_MATRIX.md 判断页面与视觉落地，以 API_INTEGRATION.md 和真实接口/浏览器结果判断运行闭环。
Figma 的 [x] 只表示画板对应页面已实现，不代表正式试点数据、组织权限或线上生产验收已经完成。BRD 的“阶段二个人 AI 助理”和三期运营页面不纳入当前一期修复范围。
2. 已确认完成的当前基线
| 领域 | 当前证据 | 结论 |
|---|---|---|
| 员工端今日/练/问/我 | mobile-uni/src/pages/user/*；员工首页、训练前预习、独立练习路由已实现 |
当前本地代码与线上静态包不一致：线上仍引用旧 index-DSualpPE.js，当前构建引用 index-DJfe2tlN.js；线上学习页未包含当前错题原因筛选标记。不能把本地构建视为线上已发布 |
| 主管工作台/复盘/派发 | mobile-uni/src/pages/supervisor/*；线上工作台已完成视觉回归 |
页面主链路已在位；正式主管身份仍依赖组织数据 |
| 候选人面试与 HR 复核 | mobile-uni/src/pages/candidate/*、frontend/src/views/recruit/interview.vue |
工程闭环已在位，需继续保留人工复核证据 |
| SOP/RAG/资料处理 | frontend/src/views/knowledge/*、backend/.../AihrSopSeedService.java |
搜索、引用、反馈、异步处理和评审入口已在位 |
| 对练/每日题/主管带教 | backend/.../AihrPracticeSeedService.java、mobile-uni/src/pages/user/practice |
主闭环已在位；低分再练、错题归因仍需更明确的用户可见闭环 |
| 案例上传/整理/筛选 | backend/.../AihrCaseService.java、mobile-uni/src/pages/user/cases、frontend/src/views/knowledge/cases.vue |
上传与整理已在位，但当前仓库没有可用预渲染视频样片资产，也没有稳定的案例详情/学习点模型；不能用假播放器宣称案例学习闭环完成 |
3. 未完成项与优先级
P0：必须先解决，否则不能称为正式试点完成
| 缺口 | BRD依据 | 当前事实 | 下一步 |
|---|---|---|---|
| 正式主管身份、项目范围和数据权限 | 5.4、L1-B、G3 | 代码已有 aihr_org_snapshot、岗位/项目过滤和主管接口；移动端角色查询失败已改为安全降级员工端，但正式上游快照的手机号关联仍不足，线上视觉测试不能替代真实主管身份验证 |
用正式组织同步 dry-run 先核对项目、岗位、ext_party_id、手机号；只在上游数据合规后执行正式同步 |
| M5 正式试点证据 | L1-B/C/D、G1/G3/G4 | 本地严格门禁和导出能力已存在；本地样本不能代表正式窗口，不能用 seed/烟测数据替代；当前没有正式满意度问卷/评分采集入口，因此无法证明“满意度 ≥4/5” | 固定 1–2 个住宅项目和窗口，按唯一在职身份采集训练、人工校准、SOP 评审、完训率和满意度；先确定问卷量表、采集对象和导出字段 |
| AI 分数与人工复核边界 | 4.1、4.5、G1/G2 | 面试和对练已有人工复核/校准入口；正式试点 CSV 已补明细级 AI 分、人工校准分、校准人、校准时间和最终采用分；正式试点仍需用真实窗口验证人工可否决证据 | 在正式试点报告中抽查校准记录与最终采用值，确认人工分可覆盖 AI 建议且不直接挂钩绩效/晋升 |
| 线上 H5 静态包未同步当前代码 | 3.1、4.4、L1-B | 2026-07-14 对线上 https://peilian.njzhmj.top/h5/ 做资源核对：生产 HTML 最后修改时间为 2026-07-13 19:09，仍引用 index-DSualpPE.js；当前 mobile-uni 构建引用 index-DJfe2tlN.js，学习页本地 chunk 包含错题原因筛选而线上 chunk 不包含 |
先按发布脚本做远端备份和静态资源同步，再重新 curl HTML、逐项核对资源哈希和关键页面；未经发布动作和线上回归，不宣称已发布 |
P1：一期 BRD 功能仍未形成完整业务闭环
| 缺口 | BRD依据 | 当前事实 | 建议实现顺序 |
|---|---|---|---|
| 岗位-SOP匹配与上岗资格 gating | 3.1、4.2、TechSpec P1 | 已补 GET /api/knowledge/position-sop 和员工学习页状态提示：一期只确认生活顾问内置学习导航；尚无 sop_applicability、onboard_task、qualification_gate 正式数据闭环，不能作为上岗资格判断 |
先接正式岗位/项目与 SOP 适用范围数据，再补培训任务状态；资格 gating 必须由 HR 明确规则和证据来源后实现 |
| 认证等级与激励规则可配置 | 4.5、10.2-A、TechSpec M6 | 成长激励页已有初/中/高级证据包和学分口径展示，但规则仍是前端硬编码；原“排行榜”开关无实际业务作用，已移除并明确标记只读；尚无 cert_rule/incentive_rule 的持久化、版本、角色权限和生效记录 |
先由 HR 确认学分来源、分值、防刷和初/中/高级条件，再设计规则表与管理员 CRUD；在规则契约明确前，不把静态展示称为可配置 |
| 智能错题本 | 3.1、4.4、TechSpec P1 | 已补 /api/aihr/mobile/practice/mistakes 和员工“学”页错题本：按本人聚合低分/红线回合，展示原因、分数、再练状态，支持按现有归因筛选，并可跳已有 retry assignment；尚未做独立错题表和主管侧聚合 |
后续复用现有 session/assignment/annotation 补复盘详情关联和主管侧聚合，不新增独立错题事实表 |
| 案例学习/视频详情 | 3.1、4.6、矩阵第35行 | AihrCaseService 当前用内存 CaseState + aihr_case_record 保存转写/摘要，没有稳定 media URL、学习点、主管点评和案例详情 API；仓库也没有可用于一期验收的预渲染样片资产 |
先由业务提供样片或正式媒体 URL，并确定案例详情、学习点、主管点评字段，再扩持久化契约和权限；没有真实媒体 URL 时不造播放按钮 |
| 案例库质量与数量 | L1-B、4.6/4.7 | 上传/整理/筛选路径已有；“至少20条脱敏案例”和每周每项目一条需要正式数据证明，当前也没有可用于一期样片验收的真实视频资产 | 先按项目窗口采集并脱敏检查，再补案例统计/学习详情导出；不使用空壳视频或演示 seed 冒充 |
| RAG 可用率与知识治理 | 4.7、L1-C、G3 | 搜索、引用、反馈、知识缺口和人工评审入口已有；住宅核心流程覆盖率与可用率仍需正式评审数据。员工反馈目前按规范化问题+fragmentId去重，没有保存同一次搜索的 reviewId/答案版本，尚不足以做严格的答案版本追溯 |
先由业务确定问答评审与员工反馈的关联契约，再补评审批次/答案版本字段；在此之前按现有 query、fragment、source 口径统计，不宣称完成逐问答追溯 |
| 方言语音与多模态训练验收 | 4.3.2、4.3.3、L1-C | ASR/TTS、音频 OSS 留痕和文本降级链路已有；但当前没有四川话/粤语等方言供应商配置、样本集和准确率/响应时延证据，也没有把图像/视频训练输入纳入一期验收口径 | 先确定一期方言厂商和可接受指标，用真实短音频做至少一条方言路径回归；图像/视频输入另按场景与合规边界评审，不用通用文本链路冒充完成 |
P2/P3：明确暂缓，不应混入当前修复
- 个人 AI 助理、个人资料库、网页抓取、引用问答、PPT 生成：BRD 4.8，阶段二。
- 开放问题榜、积分/排行榜/荣誉墙、完整七维偏好、独立 AI 教练编排：阶段二/三或后续运营范围。
- 师徒关系、拜师池、认证和带徒福利：业务已取消，继续保持不实现。
4. 首批执行顺序
- 先完成正式组织快照 dry-run 与项目范围核对；不修改正式数据，不用手机号猜角色。
- 在本地/测试环境实现“错题本只读聚合”，复用现有训练记录和 retry assignment，补 API、员工入口和主管查看边界。
- 已先补岗位学习适配摘要，但它只负责把一期生活顾问导航状态说清楚；下一步接正式岗位/项目/SOP 适用范围，再实现培训任务状态；资格 gating 放在有真实资格规则后接入，避免先做一个无法运营的开关。
- 单独设计案例详情数据契约，确定媒体来源、样片、学习点和主管点评后再开发详情页。
- 用正式试点窗口跑 BRD L1/M5，而不是继续增加视觉页面。
5. 每批完成定义
- 有明确 BRD 条款、代码路径和数据证据。
- 读写权限按员工本人、主管项目范围、HR/运营角色区分。
- 真实接口或浏览器验证通过；不能验证的外部数据依赖必须标明。
- 不用 seed、烟测样本或固定演示账号冒充正式试点达标。
- 发布前同步矩阵、API 文档、验收脚本和本记录。
6. 本轮线上核对记录（2026-07-14）
- 线上入口
https://peilian.njzhmj.top/h5/返回HTTP 200；生产 HTML 的Last-Modified为2026-07-13 19:09。 - 线上 HTML 引用
index-DSualpPE.js；当前分支mobile-uni构建引用index-DJfe2tlN.js。两者 CSS 引用一致，但 JS 资源内容和动态 chunk 集合不一致。 - 使用本地数据库已有手机号和 dev 固定验证码登录线上 H5，岗位确认、员工首页和
/pages/user/practice/index均可打开；这证明线上登录/基础路由可用，不证明线上包已追平当前代码。 - 线上学习页 chunk 未包含当前代码已有的错题原因筛选标记；本轮未执行远端覆盖发布，待发布后重新做 HTML、资源哈希和浏览器回归。