fix(aihr): separate onboarding and candidate review states

docs/API_INTEGRATION.md

@@ -13,7 +13,7 @@
 | 对练语音 | `POST /api/ai/asr`（multipart 字段 `file`，≤5MB）、`POST /api/ai/tts`（JSON `{text≤300字, voice}`，成功返回 `ossId`，客户端播放地址为受控的内联 `data:audio/*`，不返回原始 OSS URL）、`GET /api/aihr/mobile/oss/{ossId}` | 走 OpenAI-compatible audio 接口（如硅基流动 SenseVoice/CosyVoice2）；模型管理需启用 `category=asr/tts` 配置；移动端优先用浏览器录音，`getUserMedia/MediaRecorder` 不可用或麦克风权限失败时，用 `audio/*` file input 选择/录制音频后继续调同一 ASR 接口；ASR/TTS 未配置或失败返回 fail，前端降级文本；训练/每日题录音只通过 `audioOssId` 走受保护下载，历史客户端传入的 HTTP `audioUrl` 不再回显；TTS 成功音频仍写入 `sys_oss` 留痕，同时用内联 data URL 保持旧客户端可播放；音频下载按员工本人或主管项目范围授权，系统管理端保持后台访问 |
 | 案例沉淀 `/knowledge/cases` | `GET /api/knowledge/case/capabilities`、`POST /api/knowledge/case/upload`、`/organize`、`/curate`、`GET /records`、`GET /records/{caseId}`、`POST /records/{caseId}/review`、`GET /records/{caseId}/media` | `/capabilities` 返回服务端判定的案例提交/查看能力，移动端不再向普通员工展示无权提交的素材表单；`/upload` 改为 multipart 真实语音上传并走 ASR，服务端只接受 MP3/WAV/M4A/WebM/OGG/AAC/FLAC，成功后原始音频写入 `sys_oss`，案例记录只保存 `mediaOssId` 供受保护媒体接口读取，不向客户端回传原始 `mediaUrl`；`/organize` 用真实转写调 chat 模型整理案例，未配置模型时按真实 transcript 本地结构化，并从背景外的真实摘要项提取学习点；APP 用户的项目范围从 `aihr_org_snapshot` 登录身份解析，上传、整理、入库、列表和详情均按项目范围校验，未完成正式组织映射时安全拒绝，不接受前端伪造项目范围；员工列表/详情只返回 `已入库` 案例，管理端系统用户保留全局运营视图；移动端和管理端案例详情通过受保护媒体接口回放原始音频，主管/项目负责人可提交脱敏点评；预渲染视频样片仍待正式媒体资产接入 |
 | 案例媒体安全 | `GET /api/knowledge/case/records/{caseId}/media` | 案例详情只返回 `mediaOssId`，不返回原始 `sys_oss.url`；媒体下载会重复执行登录、后台角色或 APP 项目范围校验，再由服务端流式读取 OSS。管理端与 `mobile-uni` 通过鉴权 blob/temp 文件播放，关闭详情页时释放本地对象 URL |
-| SOP知识库 `/knowledge/sop` | `POST /api/knowledge/search`、`POST /api/knowledge/answer-feedback`、`GET /api/knowledge/position-sop`、`POST /api/knowledge/doc/upload` | 已接入 MySQL Fulltext + Qdrant 混合召回、岗位学习适配摘要、OSS-first 文档上传、txt/md/PDF/Word/Excel/PPT 解析和 embedding 写入，失败回退 seed；搜索返回 `reviewId` 与 `promptVersion`，员工反馈回传并保存该评审批次，SOP 人工评审记录同时保留答案生成提示词版本，管理端可继续复核；`position-sop` 目前只返回一期生活顾问学习导航，不代表正式上岗资格 |
+| SOP知识库 `/knowledge/sop` | `POST /api/knowledge/search`、`POST /api/knowledge/answer-feedback`、`GET /api/knowledge/position-sop`、`GET /api/aihr/mobile/onboard/tasks`、`GET /api/aihr/mobile/qualification`、`POST /api/knowledge/doc/upload` | 已接入 MySQL Fulltext + Qdrant 混合召回、岗位学习适配摘要、OSS-first 文档上传、txt/md/PDF/Word/Excel/PPT 解析和 embedding 写入，失败回退 seed；搜索返回 `reviewId` 与 `promptVersion`，员工反馈回传并保存该评审批次，SOP 人工评审记录同时保留答案生成提示词版本，管理端可继续复核；员工学习页只读读取当前 APP 身份对应的正式岗前/入职任务与资格证据，无正式数据时明确返回空任务和 `NOT_CONFIGURED`，不以 AI 分数代替上岗资格；`position-sop` 仍保留一期生活顾问学习导航语义 |
 | 资料处理 `/knowledge/processing` | `GET /api/knowledge/processing/overview`、`POST /api/knowledge/doc/upload-async`、`GET /api/knowledge/doc/upload-items`、`POST /api/knowledge/doc/upload-items/{id}/retry`、`POST /api/knowledge/doc/import-local-task`、`GET /api/knowledge/doc/import-tasks`、`POST /api/knowledge/doc/import-tasks/{id}/cancel` | 已接入解析任务状态聚合；**批量上传走异步队列**：接口只暂存+入队即秒回，后台 worker（并发 2）逐条解析/归类/向量化；ZIP 在 worker 内安全解压后把支持的子文件继续入同一批次队列，页面按批次轮询进度、失败可单文件重试；服务端目录导入、进度轮询和任务取消保留，失败回退 seed |
 | 组织人员同步 | `POST /api/aihr/org/sync` | 从开放组织同步系统的 `/api/open/v1/sync/snapshot` 拉取 `company/department/employee` 快照，分页参数使用 `limit`；员工手机号只落 `person_phone` 用于移动端身份映射，不在组织列表响应暴露；岗位识别 `position/job_title/post/job_name/role/title` 等字段。`dryRun` 必须显式传入 `true`（预检）或 `false`（写入），省略或传 `null` 直接拒绝，避免空请求意外写库；默认 `replaceExisting=true`，写入前必须先用 `{"dryRun":true}`；dry-run 不访问本地快照表、不执行 DDL/写库，返回 `phoneLinked/maskedPhone/suspectText/warnings` 且 `syncedCount=0`。非 dry-run 覆盖写入遇到员工被跳过、手机号不完整、脱敏手机号或疑似乱码时默认拒绝，只有确认 dry-run 结果后显式传 `allowPartialReplace=true` 才允许覆盖；重复 `ext_party_id` 始终拒绝写入，因为数据库唯一键会折叠重复身份；`replaceExisting=false` 不触发不完整快照覆盖闸门，但仍拒绝重复身份。2026-07-10 源接口实测 3474 人仅 1 个可用手机号、3473 个脱敏手机号、8 条疑似乱码，因此未执行覆盖同步，正式试点需上游先开放至少 20 名试点人员手机号 |
 | 移动端手机号登录 | `GET /resource/sms/code`、`POST /auth/mobile/sms-login` | 已复用 sms4j 阿里云配置 `config1` 和 RuoYi `sms` 授权策略；短信发送成功后才写 Redis 验证码；手机号不存在时自动注册 `app_user`；`aihr.sms.dev-fixed-code` 非空时不真发短信、验证码固定（dev 默认 `123456`，prod profile 代码级强制失效） |

docs/BRD_IMPLEMENTATION_AUDIT.md

@@ -1,5 +1,9 @@
 # BRD 功能审查与未完成项记录
 
+- 2026-07-15 BRD 4.1 候选人进度状态修正：候选人进度页此前用最近一份补充资料的审核状态作为“面试人工复核”状态，可能在面试已复核但资料未提交时误显示“人工复核中”；现改为面试状态读取 `InterviewRecord.reviewStatus`，并将补充资料审核单独展示为未提交/待审核/已通过/已驳回。仅修正移动端展示与类型契约，不改 API、数据库或审核结论；`mobile-uni` 类型检查、单元测试 `56/56` 和 H5 构建通过。
+
+- 2026-07-15 BRD 4.2/P1 正式任务与资格只读桥接：复核确认 `aihr_onboard_task`、`aihr_qualification_gate` 已有结构但员工端没有读取入口；现新增登录 APP 用户范围内的 `GET /api/aihr/mobile/onboard/tasks` 与 `GET /api/aihr/mobile/qualification`，通过组织快照把手机号解析到正式 `ext_party_id`，不接受前端身份参数。`mobile-uni` 学习页新增正式岗前/入职任务和资格状态展示；空表明确显示“未配置”，不生成任务、不把 AI 训练分数当资格结论。该批次未写入生产数据，正式任务/资格规则仍需 HR 与组织系统提供。
+
 - 2026-07-15 发布预检重建复核：按当前 `HEAD=14adc3e6` 重新构建管理端生产包、`mobile-uni` H5 和 `ruoyi-admin.jar` 均成功，产物新鲜度检查通过；`RELEASE_VERIFY_REMOTE_MATCH=true ./scripts/release-preflight.sh` 随后仅因两份用户未提交的 Figma 文档阻断，尚未进入线上资源/后端 hash 对比。本轮未同步静态资源、迁移生产数据库、重启后端或写入生产业务数据；待 Figma 提交边界和正式发布窗口确认后再继续。
 
 - 2026-07-15 BRD 4.5/P1 成长规则与权限续审：成长激励页继续明确“证据包待人工复核”和“学分规则待 HR 配置、当前不生效”，当前没有 `cert_rule`/`incentive_rule` 正式规则契约，不新增空壳配置 CRUD；候选人资料、组织同步、训练音频和 SOP 管理写入口均已复核为登录或 HR/管理员角色保护。AIHR 测试 `138/138`、`mobile-uni` 单测 `56/56`、类型检查、管理端构建和成长页 lint 均通过。线上根站、H5、租户接口和员工首页 API 只读返回 `200`，服务为 `active`，但线上仍加载旧 H5 资源 `index-CDn6TrX8.js`，本轮未发布、未迁移生产数据库或写入业务数据；下一步仍需 HR 规则/组织同步数据与正式发布窗口。
@@ -143,7 +147,7 @@
 
 | 缺口 | BRD依据 | 当前事实 | 建议实现顺序 |
 |---|---|---|---|
-| 岗位-SOP匹配与上岗资格 gating | 3.1、4.2、TechSpec P1 | 已补 `GET /api/knowledge/position-sop` 和员工学习页状态提示；新增 `position_responsibility`、`sop_applicability`、`onboard_task`、`qualification_gate` 四表结构及版本化迁移，接口在有正式适用范围数据时优先读取岗位/SOP映射，未迁移或无映射时回退生活顾问 seed。当前正式映射、入职任务和资格规则均为空，资格状态仍为 `NOT_CONFIGURED`，不能作为上岗资格判断 | 先由 HR/组织系统提供正式岗位、项目、SOP 适用范围与任务规则，再补任务查询/完成状态和资格判定；资格 gating 必须绑定明确规则、证据来源和权限，不能用空表或 seed 冒充 |
+| 岗位-SOP匹配与上岗资格 gating | 3.1、4.2、TechSpec P1 | 已补 `GET /api/knowledge/position-sop`、员工端 `GET /api/aihr/mobile/onboard/tasks` 与 `GET /api/aihr/mobile/qualification`；四表结构及版本化迁移已在位，任务/资格读取按登录 APP 身份映射正式 `ext_party_id`。当前正式映射、入职任务和资格规则均为空，资格状态仍为 `NOT_CONFIGURED`，不能作为上岗资格判断 | 先由 HR/组织系统提供正式岗位、项目、SOP 适用范围与任务/资格规则；当前只读展示已完成，后续再接 HR 派发、员工完成回写和正式资格证据复核，不能用空表或 seed 冒充 |
 | BRD 全覆盖训练场景 | 3.1、4.3.4 | 仓库已补 `service-promotion-needs`、`daily-service-followup` 两条生活顾问场景及住宅 SOP 迁移，严格门禁也检查两类核心流程；生产当前仍未迁移场景/Rubric 表和补充内容，且两类成功条件、价格/取消规则、回访口径仍需内容负责人确认 | 先在发布窗口执行场景、Rubric、SOP 迁移，再由内容负责人确认正式成功条件、合规边界和 SOP 版本；不把仓库 seed 或本地样本直接算作正式验收素材 |
 | 认证等级与激励规则可配置 | 4.5、10.2-A、TechSpec M6 | 成长激励页已有初/中/高级证据包和学分口径展示，但规则仍是前端硬编码；原“排行榜”开关无实际业务作用，已移除并明确标记只读；尚无 `cert_rule`/`incentive_rule` 的持久化、版本、角色权限和生效记录 | 先由 HR 确认学分来源、分值、防刷和初/中/高级条件，再设计规则表与管理员 CRUD；在规则契约明确前，不把静态展示称为可配置 |
 | 智能错题本 | 3.1、4.4、TechSpec P1 | 已补员工本人错题本和主管 `/api/aihr/mobile/practice/team` 内的 `mistakes` 聚合：按当前项目权限统计场景、归因、次数、影响人数、平均分和最近发生时间；员工端可跳转待训练 retry assignment，retry 已完成时改为显示“已完成”，不再重复引导进入已完成任务；不新增独立错题事实表 | 继续用正式组织快照和试点窗口验证主管只看到本项目数据；后续可在真实错题量上来后补趋势/导出，不把本地演示样本当正式指标 |
@@ -199,7 +203,7 @@
 
 1. 先完成正式组织快照 dry-run 与项目范围核对；不修改正式数据，不用手机号猜角色。
 2. 在本地/测试环境实现“错题本只读聚合”，复用现有训练记录和 retry assignment，补 API、员工入口和主管查看边界。
-3. 已补岗位学习适配摘要、正式岗位/SOP 映射读取和空表回退；下一步接正式映射数据，再实现 `onboard_task` 培训任务状态；资格 gating 放在有真实资格规则后接入，避免先做一个无法运营的开关。
+3. 已补岗位学习适配摘要、正式岗位/SOP 映射读取、正式任务/资格只读展示和空表回退；下一步接正式映射数据，再实现 HR 派发、员工完成回写和有证据的资格 gating，避免先做一个无法运营的开关。
 4. 在业务提供一期视频样片及字段口径后，继续扩案例详情数据契约；当前原始音频回放已完成，但不替代视频、学习点和主管点评。
 5. 用正式试点窗口跑 BRD L1/M5，而不是继续增加视觉页面。