HCLT 同步企微通讯录验证口径

docs/海音达OA-MVP需求规格说明书.md

@@ -91,7 +91,7 @@ P2T 只做排序和边界确认，不进入当前实现。候选项按 R7 真实
 
 | 优先级 | 候选 | 当前边界 |
 | --- | --- | --- |
-| P2-1 | 人事生命周期与账号主数据治理 | 优先覆盖入职、转正、调岗、离职、直属主管缺失、主管/审批人停用、admin-only 误用、财务/管理员角色混淆、OA 账号和企业微信通讯录/绑定闭环；不使用企业微信原生审批 |
+| P2-1 | 人事生命周期与账号主数据治理 | 已覆盖入职、转正、调岗、离职、OA 账号和企业微信通讯录/绑定闭环；HCLT 已验证公网企微通讯录 create/update/disable 真实写入；不使用企业微信原生审批 |
 | P2-2 | 审批与通知扩展 | 转审扩展到请假/采购/差旅拆 `W2F`；邮件通道和三渠道完整验收另决策；不引入复杂 BPM |
 | P2-3 | OCR 与票据增强 | 当前试运行继续 PDF-only；图片 OCR、批量样票和异步体验需另补样票、隐私处理和 provider 回归 |
 | P2-4 | 费用/预算/项目轻量增强 | 可评估费用提示和项目关联增强；预算重型控制和正式成本核算继续冻结，ERP 不再作为后续接入项 |
@@ -120,7 +120,7 @@ ERP 已从“冻结待办”调整为“未来不接入 OA”。其他冻结项
 | --- | --- | --- | --- | --- |
 | P0 | 统一审批中心 | 所有正式审批在 OA 内处理 | PC 审批待办、移动审批 | 能提交、审批、驳回、退回、转审、留痕 |
 | P0 | 企业微信基础设施 | 手机入口、免登、通知、打卡原始采集 | 企业微信自建应用 `海音达工作台` | 手机进入 `/mobile`，通知 deeplink 回 OA |
-| P0 | 人事生命周期 | 入职、转正、调岗、离职、OA 账号、权限和企业微信通讯录状态闭环 | 人员管理、员工档案 | OA 为员工主事实源，企微通讯录同步成功或可解释 SKIP/失败可重试 |
+| P0 | 人事生命周期 | 入职、转正、调岗、离职、OA 账号、权限和企业微信通讯录状态闭环 | 人员管理、员工档案 | OA 为员工主事实源；HCLT 已验证公网企微通讯录真实写入，其他环境缺配置时同步可解释 SKIP/失败并可重试 |
 | P0 | 报销/发票/OCR | 员工自助报销，财务可查重和导出 | 报销、移动报销、票据中心 | 上传、OCR、查重、绑定、审批、付款闭环 |
 | P0 | 请假与考勤修正审批 | 请假、补卡、外出、加班等修正都在 OA 内审批 | 请假、移动审批、团队状态 | 审批后团队状态和考勤口径不破坏 |
 | P1 | 采购/费用审批 | 小团队采购和费用事项留痕 | 采购、审批待办 | 申请、附件、审批、状态更新可用 |

docs/管理员手册.md

@@ -1,6 +1,6 @@
 # hyb-oa 管理员手册（10 人以下团队版）
 
-**当前状态（2026-05-17 / HRWD）**：R7E、PRELAUNCH、CASHIER-VOUCHER-V1、LAUNCH-DEPLOY-FINANCE、FIN-PROD-ENABLE、ACCOUNTING-HANDOFF-V1、ATTV1 和 HR-WECOM-DIRECTORY-V1 均已收口；SYSTEM-COMPLETE-GATE 结论为 `GO_TO_USE`。公网 `payment_batch_v1=force_on`，`erp_sync=force_off`。公司当前无 ERP/独立财务系统，且 ERP 未来不接入 OA；财务闭环以 OA 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
+**当前状态（2026-05-17 / HCLT）**：R7E、PRELAUNCH、CASHIER-VOUCHER-V1、LAUNCH-DEPLOY-FINANCE、FIN-PROD-ENABLE、ACCOUNTING-HANDOFF-V1、ATTV1、HR-WECOM-DIRECTORY-V1 和 HRWD-CONTACT-LIVE-TEST 均已收口；SYSTEM-COMPLETE-GATE 结论为 `GO_TO_USE`。公网 `payment_batch_v1=force_on`，`erp_sync=force_off`。企业微信通讯录同步已完成公网 create/update/disable 真实写入验证。公司当前无 ERP/独立财务系统，且 ERP 未来不接入 OA；财务闭环以 OA 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
 
 ## 1. 适用范围
 - 适用于 `small_team_internal` 工作区模式。
@@ -242,7 +242,7 @@ ORDER BY e.employee_no;
 ### 4.1 入职
 1. 在 `人员管理` 创建员工账号。
 2. 打开员工详情页，补齐部门、职位、直属上级、试用期结束日、工作地点、紧急联系人。
-3. 若已开启 `hr_wecom_directory_sync_v1` 且企业微信通讯录配置完整，创建或发起入职时系统会尝试创建企业微信成员；缺 Secret、缺默认部门或无通讯录权限时记录 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`，OA 入职不回滚。
+3. 若已开启 `hr_wecom_directory_sync_v1` 且企业微信通讯录配置完整，创建或发起入职时系统会尝试创建企业微信成员；HCLT 已验证公网真实写入闭环，缺 Secret、缺默认部门或无通讯录权限时记录 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`，OA 入职不回滚。
 4. 发起 `入职`，系统会自动生成 checklist：账号初始化、资产发放、制度确认。
 5. checklist 全部完成后，员工状态自动从 `onboarding` 进入 `probation`。
 6. 人员列表或员工详情中的“企业微信通讯录”状态若为同步失败或配置缺失，管理员可在配置修复后执行“重试同步”。

docs/需求-企业微信基础设施规约.md

@@ -142,6 +142,7 @@ deeplink 必须校验目标地址白名单，避免跳转到非 OA 域名或未
 ## 6. 通讯录身份边界
 
 - HRWD 起，OA 驱动企业微信通讯录成员创建、更新和禁用；OA 员工表仍是权限、审批、业务数据和审计的主事实源。
+- HCLT 已完成公网真实写入验证：测试员工 `HRWDTEST-20260517214548` 已完成企业微信通讯录 create/update/disable，三次同步均为 `wecom_contact_synced` 且 `errcode=0`。
 - 新员工在 OA 创建账号和入职记录后，可在 `hr_wecom_directory_sync_v1` 开启且配置完整时同步创建企业微信成员，并写入 `wecom_identity_bindings.external_user_id`。
 - OA 调岗、部门、职位、手机号、邮箱变化后，可触发企业微信成员更新；历史审批和历史业务单据不因调岗被改写。
 - 离职完成后默认禁用企业微信成员，不删除成员；绑定关系和历史业务记录保留审计。
@@ -154,7 +155,7 @@ deeplink 必须校验目标地址白名单，避免跳转到非 OA 域名或未
 | 项目 | 状态 | 当前口径 |
 | --- | --- | --- |
 | OA 员工生命周期 | `DONE` | 支持入职、转正、调岗、离职 checklist、账号禁用、会话失效和审计。 |
-| OA 驱动企微通讯录创建/更新/禁用 | `DONE_WITH_EXTERNAL_SKIP` | 代码、同步记录、员工管理状态和重试入口已部署；公网端点检查在缺配置时返回 `SKIP wecom_contact_sync_disabled`，真实写入取决于通讯录 Secret、默认部门和企业微信通讯录 API 权限。 |
+| OA 驱动企微通讯录创建/更新/禁用 | `DONE_LIVE_VERIFIED` | 代码、同步记录、员工管理状态和重试入口已部署；HCLT 公网真实写入闭环通过，`HRWDTEST-20260517214548` create/update/disable 均返回 `errcode=0`。其他环境缺 Secret、默认部门或通讯录 API 权限时仍按 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG` 或失败可重试处理。 |
 | 企业微信原生审批 | `FROZEN` | 不作为正式审批流，入离职、请假、补卡、外出、加班审批均在 OA 内留痕。 |
 
 ---