docs(aihr): sync organization rollout facts

This commit is contained in:
2026-07-16 14:58:03 +08:00
parent c85a1374f0
commit 6edff99b08
7 changed files with 22 additions and 22 deletions
+2 -2
View File
@@ -77,8 +77,8 @@
- seed service 阶段已完成;后续按 `docs/RUOYI_AI_INCREMENTAL_MIGRATION.md` 分片迁移 `ruoyi-ai` 的知识库、文档解析、RAG、chat 能力。
- 迁移时不要整包搬 `ruoyi-chat`;优先在 `ruoyi-aihr` 内吸收必要表、service、loader 和检索接口,并保留 seed fallback。
- 已落地的演示流不要退回静态壳:AI 面试、三角色对练、案例沉淀已是真模型优先(未配置/失败回退本地兜底),SOP 知识库、移动端三端首页保留 fallback——改造时降级链必须保留。
- 本项目 AI 表前缀用 `aihr_*`:知识库是 `aihr_knowledge_info/attach/fragment`,上传队列是 `aihr_knowledge_upload_item`,导入任务是 `aihr_knowledge_import_task`,模型配置是 `aihr_model_provider/config`,移动端训练记录是 `aihr_practice_session`,候选人补充资料是 `aihr_candidate_material`,组织人员快照是 `aihr_org_snapshot`(本地 reset 有 Demo seed;生产/试点从 `docs/open-org-sync-api-design-v1.md` 对应开放组织系统同步,入口 `POST /api/aihr/org/sync`)。外部快照只有 `position_id` 时,可用 HR 签认的 `AIHR_ORG_POSITION_MAP_JSON` 在同步写入前映射岗位;外部显式岗位优先,层级只允许“一线/主管/项目经理”,必须先 dry-run 核对命中/主管人数,禁止按 ID 猜角色。
- 2026-07-15 生产开放员工快照只返回 `position_id`,未返回岗位名称,开放 API 也没有岗位字典资源;因此生产 2943 名在职人员当前全部落为 `position_name='员工'`、`position_level='一线'`,主管数为 0。补齐开放平台岗位字段/字典或 HR 正式 `position_id` 映射并重新同步前,不得宣称主管身份与项目权限已验收,也不要在代码里猜 `position_id` 的角色含义。
- 本项目 AI 表前缀用 `aihr_*`:知识库是 `aihr_knowledge_info/attach/fragment`,上传队列是 `aihr_knowledge_upload_item`,导入任务是 `aihr_knowledge_import_task`,模型配置是 `aihr_model_provider/config`,移动端训练记录是 `aihr_practice_session`,候选人补充资料是 `aihr_candidate_material`,组织人员快照是 `aihr_org_snapshot`(本地 reset 有 Demo seed;生产/试点从 `docs/open-org-sync-api-design-v1.md` 对应开放组织系统同步,入口 `POST /api/aihr/org/sync`)。人员主键固定优先使用外部资源 `id`,不得让新增 `employee_number` 改写 `ext_party_id`;外部显式岗位优先,非契约数值层级按岗位名称归一为“一线/主管/项目经理”,只有缺岗位字段时才用 HR 签认的 `AIHR_ORG_POSITION_MAP_JSON` 兜底,禁止按 ID 猜角色。
- 生产组织同步必须先 dry-run。若上游手机号为脱敏值,只能在确认稳定 `id` 全量一致后用 `replaceExisting=false` 增量更新,以保留已有手机号;不得用 `allowPartialReplace=true` 强制全量覆盖。2026-07-16 生产为 3417 人、3392 个可映射手机号、在职主管 175、在职项目经理 20,主管身份认证已通过;项目范围正反例和正式短信 OTP 仍须单独验收。
## 业务文档