63 lines
6.2 KiB
Markdown
63 lines
6.2 KiB
Markdown
# BRD 功能审查与未完成项记录
|
|
|
|
更新时间：2026-07-14
|
|
|
|
## 1. 审查口径
|
|
|
|
本记录以 [物业AI人力资源系统业务需求文档BRD.md](物业AI人力资源系统业务需求文档BRD.md) 为业务事实源，以 [FIGMA_IMPLEMENTATION_MATRIX.md](FIGMA_IMPLEMENTATION_MATRIX.md) 判断页面与视觉落地，以 [API_INTEGRATION.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 | 已补 `GET /api/knowledge/position-sop` 和员工学习页状态提示：一期只确认生活顾问内置学习导航；尚无 `sop_applicability`、`onboard_task`、`qualification_gate` 正式数据闭环，不能作为上岗资格判断 | 先接正式岗位/项目与 SOP 适用范围数据，再补培训任务状态；资格 gating 必须由 HR 明确规则和证据来源后实现 |
|
|
| 智能错题本 | 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. 首批执行顺序
|
|
|
|
1. 先完成正式组织快照 dry-run 与项目范围核对；不修改正式数据，不用手机号猜角色。
|
|
2. 在本地/测试环境实现“错题本只读聚合”，复用现有训练记录和 retry assignment，补 API、员工入口和主管查看边界。
|
|
3. 已先补岗位学习适配摘要，但它只负责把一期生活顾问导航状态说清楚；下一步接正式岗位/项目/SOP 适用范围，再实现培训任务状态；资格 gating 放在有真实资格规则后接入，避免先做一个无法运营的开关。
|
|
4. 单独设计案例详情数据契约，确定媒体来源、样片、学习点和主管点评后再开发详情页。
|
|
5. 用正式试点窗口跑 BRD L1/M5，而不是继续增加视觉页面。
|
|
|
|
## 5. 每批完成定义
|
|
|
|
- 有明确 BRD 条款、代码路径和数据证据。
|
|
- 读写权限按员工本人、主管项目范围、HR/运营角色区分。
|
|
- 真实接口或浏览器验证通过；不能验证的外部数据依赖必须标明。
|
|
- 不用 seed、烟测样本或固定演示账号冒充正式试点达标。
|
|
- 发布前同步矩阵、API 文档、验收脚本和本记录。
|