WHMS 实现企微HR主数据镜像同步

docs/产品口径.md

@@ -20,7 +20,7 @@
 - 企业微信打卡用于原始采集，保留其定位、人脸、Wi-Fi、规则与设备能力。
 - OA 后续同步企业微信打卡规则、排班、记录、日报、月报和 HR/考勤审批镜像，形成正式考勤口径。
 - 请假、补卡、外出、加班等考勤修正正常在企业微信完成；OA 只在应急模式下接管，并在企微恢复后 dry-run 和自动回写。
-- 后续实现必须另建 `wecom_hr_master_sync_v1`、`wecom_attendance_approval_mirror_v1`（承接旧口径 `wecom_native_approval_mirror_v1`）、`oa_hr_emergency_mode_v1`、`wecom_recovery_writeback_v1` 或 `wecom_ruleops_v1` 合同。
+- `wecom_hr_master_sync_v1` 已本地实现但尚未部署公网；后续考勤/审批镜像、应急接管、恢复回写或 RuleOps 仍必须另建 `wecom_attendance_approval_mirror_v1`（承接旧口径 `wecom_native_approval_mirror_v1`）、`oa_hr_emergency_mode_v1`、`wecom_recovery_writeback_v1` 或 `wecom_ruleops_v1` 合同。
 
 ### P0-3 按域镜像定义
 - 企微主办域镜像到 OA：通讯录/人事助手、打卡、请假、补卡、外出、加班、假期余额和 HR/考勤规则。
@@ -50,7 +50,15 @@
 - WCPC 只做企业微信后台配置收口和只读 POC 复跑，不改业务代码、不部署、不持久写服务器 `.env`。
 - 已按用户要求自动查找并使用既有在职低风险测试号 `SMOKE002/测试员工` 复跑；报告和文档只记录脱敏企业微信 userid 前缀 `oa_smoke***`，不得使用已离职/禁用的 `HRWDTEST-20260517214548` 作为主测试号。
 - 复跑报告为远端 `/tmp/wecom-capability-poc-wcpc-smoke002/summary.json`，结论 `GO_TO_HR_MASTER_SYNC`，`nextStageAllowed=true`，`blockingCapabilities=[]`。
-- 当前允许下一步规划 `wecom_hr_master_sync_v1`；审批模板 ID、审批单号 `sp_no`、真实回调配置和 HR 写接口仍需后续独立合同处理，不得直接跳到考勤/审批镜像、OA 应急接管、恢复回写或 RuleOps。
+- WCPC 已由 WHMS 承接；审批模板 ID、审批单号 `sp_no`、真实回调配置和 HR 写接口仍需后续独立合同处理，不得直接跳到考勤/审批镜像、OA 应急接管、恢复回写或 RuleOps。
+
+### P0-8 WHMS 企微 HR 主数据镜像口径
+- WHMS 已本地实现 `wecom_hr_master_sync_v1`，默认 `force_off`，尚未部署公网，未执行生产真实员工批量 apply。
+- 企微/人事助手作为 HR 主数据源；OA 同步员工档案、部门、主管、职位、手机号、邮箱、默认角色、企业微信绑定和审计。
+- dry-run 只生成差异和同步记录，不写员工主数据；apply 需要管理员确认，生产真实员工批量 apply 需单独批准。
+- 缺姓名、手机号、邮箱或部门时记录 `missing_required_field` 并跳过，不生成占位数据；企微不在职状态记录 `needs_offboarding_confirmation`，不自动禁用 OA 账号。
+- 已有 OA 员工只更新安全主数据字段，不覆盖银行账户、身份证、工资、合同附件或历史审批。
+- WHMS 不代表考勤/审批镜像、审批回调、OA 应急接管、恢复回写或 RuleOps 已完成；下一阶段仍需另建 `wecom_attendance_approval_mirror_v1`。
 
 ---