6.0 KiB
6.0 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/*；员工首页、训练前预习、独立练习路由已发布 |
当前代码和线上包一致，后续只做回归 |
| 主管工作台/复盘/派发 | 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/烟测数据替代 | 固定 1–2 个住宅项目和窗口，按唯一在职身份采集训练、人工校准、SOP 评审、完训率和满意度 |
| AI 分数与人工复核边界 | 4.1、4.5、G1/G2 | 面试和对练已有人工复核/校准入口；仍需在正式试点报告中保留“AI 建议、人工可否决”的证据 | 导出中保留 AI 分、人工分、复核人、复核时间和最终采用值 |
P1：一期 BRD 功能仍未形成完整业务闭环
| 缺口 | BRD依据 | 当前事实 | 建议实现顺序 |
|---|---|---|---|
| 岗位-SOP匹配与上岗资格 gating | 3.1、4.2、TechSpec P1 | 当前有岗位选择、SOP 搜索和训练任务，但未发现稳定的 onboard_task / qualification_gate 业务表与页面闭环 |
先建岗位适用 SOP 只读结果，再补培训任务状态，最后补“未通过不得标记上岗”的资格规则 |
| 智能错题本 | 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 时不造播放按钮 |
| 案例库质量与数量 | L1-B、4.6/4.7 | 上传/整理/筛选路径已有；“至少20条脱敏案例”和每周每项目一条需要正式数据证明 | 增加案例统计/脱敏检查导出，按项目窗口采集，不用演示 seed 冒充 |
| RAG 可用率与知识治理 | 4.7、L1-C、G3 | 搜索、引用、反馈、知识缺口和人工评审入口已有；住宅核心流程覆盖率与可用率仍需正式评审数据 | 按住宅核心流程建立评审批次，保留命中片段、评审人、状态、版本和来源 |
P2/P3：明确暂缓，不应混入当前修复
- 个人 AI 助理、个人资料库、网页抓取、引用问答、PPT 生成：BRD 4.8，阶段二。
- 开放问题榜、积分/排行榜/荣誉墙、完整七维偏好、独立 AI 教练编排：阶段二/三或后续运营范围。
- 师徒关系、拜师池、认证和带徒福利：业务已取消，继续保持不实现。
4. 首批执行顺序
- 先完成正式组织快照 dry-run 与项目范围核对；不修改正式数据，不用手机号猜角色。
- 在本地/测试环境实现“错题本只读聚合”，复用现有训练记录和 retry assignment，补 API、员工入口和主管查看边界。
- 再实现岗位-SOP匹配与培训任务状态；资格 gating 放在有真实资格规则后接入，避免先做一个无法运营的开关。
- 单独设计案例详情数据契约，确定媒体来源、样片、学习点和主管点评后再开发详情页。
- 用正式试点窗口跑 BRD L1/M5，而不是继续增加视觉页面。
5. 每批完成定义
- 有明确 BRD 条款、代码路径和数据证据。
- 读写权限按员工本人、主管项目范围、HR/运营角色区分。
- 真实接口或浏览器验证通过；不能验证的外部数据依赖必须标明。
- 不用 seed、烟测样本或固定演示账号冒充正式试点达标。
- 发布前同步矩阵、API 文档、验收脚本和本记录。