HRWD-0..9 实现人事生命周期企微通讯录同步
这个提交包含在：
+21
-18
@@ -1,11 +1,11 @@
|
||||
# hyb-oa 管理员手册（10 人以下团队版）
|
||||
|
||||
**当前状态（2026-05-17 / SYSTEM-COMPLETE-GATE）**：R7E、PRELAUNCH、CASHIER-VOUCHER-V1、LAUNCH-DEPLOY-FINANCE、FIN-PROD-ENABLE 和 ACCOUNTING-HANDOFF-V1 均已收口；SYSTEM-COMPLETE-GATE 结论为 `GO_TO_USE`。公网 `payment_batch_v1=force_on`，`erp_sync=force_off`。公司当前无 ERP/独立财务系统，财务闭环以 OA 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
|
||||
**当前状态（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 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
|
||||
|
||||
## 1. 适用范围
|
||||
- 适用于 `small_team_internal` 工作区模式。
|
||||
- 适用于单公司、少部门、全员账号密码登录的小团队。
|
||||
- 目标是把内部高频管理动作收口到 `hyb-oa`；企业微信只作为入口、身份、通知和打卡底座。
|
||||
- 目标是把内部高频管理动作收口到 `hyb-oa`；企业微信只作为入口、通讯录账号、身份、通知和打卡底座。
|
||||
|
||||
## 2. 管理员每周固定动作
|
||||
- 周一：查看 `审批待办`、报销/OCR 异常、请假/补卡/外出/加班审批、项目风险和本周关键付款/归档事项。
|
||||
@@ -15,7 +15,7 @@
|
||||
## 3. 首次上线最小配置
|
||||
1. 进入 `工作区设置`，确认产品模式为 `small_team_internal`。
|
||||
2. 首批主路径优先保留：`Portal`、`审批待办`、`报销`、`票据/OCR`、`请假`、`项目`、`采购/费用`、`合同/附件`。
|
||||
3. `团队状态`、`周报`、`待办`、`公告`、`人员`、`资产` 可按真实试运行需要开启；`支付批次` 和 `AP 运营` 已作为财务闭环正式能力面向出纳、财务和管理员开放，普通员工不显示该入口；`预算`、`ERP`、`AI`、完整差旅能力仍作为备用或历史能力。
|
||||
3. `团队状态`、`周报`、`待办`、`公告`、`人员`、`资产` 可按真实试运行需要开启；`支付批次` 和 `AP 运营` 已作为财务闭环正式能力面向出纳、财务和管理员开放，普通员工不显示该入口；`预算`、`AI`、完整差旅能力仍作为备用或历史能力，ERP 不再规划接入。
|
||||
4. 在 `用户管理` 中按推荐预设配置：老板 / 管理员 / 主管 / 员工。
|
||||
- 正式审批组织口径：`majianyong` 配置为员工可见直属主管和 `manager`；`wangshunli` 配置为后台公司负责人 `ceo + admin`，不配置为普通 `manager`。
|
||||
- 普通员工和专用测试员工的直属主管配置为 `majianyong`；`majianyong` 的直属领导配置为 `wangshunli`。
|
||||
@@ -23,12 +23,12 @@
|
||||
- 缺直属主管、主管停用、主管链断裂或审批节点解析到申请人本人时，应先修正组织或审批规则，不要用管理员账号代批。
|
||||
5. 检查功能开关：
|
||||
- 建议开启：`portal_home_v1`、企业微信入口相关开关、报销/OCR、审批待办、请假、项目基础能力和 `payment_batch_v1`。
|
||||
- 按需开启：`announcements_v1`、`presence_board_v1`、`weekly_report_v1`、`employee_lifecycle_v1`、`todo_board_v1`、`global_search_v1`。
|
||||
- 建议保留备用：`cutover_console_v1`、预算、ERP、AI 和完整差旅相关开关。
|
||||
- 按需开启：`announcements_v1`、`presence_board_v1`、`weekly_report_v1`、`employee_lifecycle_v1`、`hr_wecom_directory_sync_v1`、`todo_board_v1`、`global_search_v1`。
|
||||
- 建议保留备用：`cutover_console_v1`、预算、AI 和完整差旅相关开关；`erp_sync` 保持关闭且不再作为后续接入目标。
|
||||
|
||||
### 3.1 ORG8 组织账号与角色边界
|
||||
|
||||
OA 员工账号是权限、审批、业务数据和审计的主事实源；企业微信身份只作为入口、免登和通知辅助。管理员维护组织账号时，先保证员工主数据完整，再配置角色和企业微信绑定。
|
||||
OA 员工账号是权限、审批、业务数据和审计的主事实源；企业微信作为通讯录账号、入口、免登、通知和打卡采集基础设施。管理员维护组织账号时，先保证 OA 员工主数据完整，再配置角色、企业微信通讯录同步和绑定状态。
|
||||
|
||||
最小必填主数据：
|
||||
|
||||
@@ -39,7 +39,7 @@ OA 员工账号是权限、审批、业务数据和审计的主事实源；企
|
||||
| 直属主管 | 请假、报销、采购等默认审批链 | 审批人缺失或错误回退 |
|
||||
| 账号状态 | 登录、入口、通知和禁用拦截 | 离职或停用人员可能继续进入 |
|
||||
| 业务角色 | 审批、财务、HR、系统管理入口 | 权限过大或无法处理待办 |
|
||||
| 企业微信绑定状态 | 手机入口、免登、通知 deeplink | 企业微信入口无法直达或误绑定 |
|
||||
| 企业微信通讯录/绑定状态 | 手机入口、免登、通知 deeplink、打卡采集身份 | 企业微信入口无法直达、误绑定或离职后未禁用 |
|
||||
|
||||
角色边界：
|
||||
|
||||
@@ -57,8 +57,8 @@ OA 员工账号是权限、审批、业务数据和审计的主事实源；企
|
||||
- `admin-only` 账号不得作为报销、请假或采购的业务审批人。
|
||||
- 财务和系统管理员混授属于高风险组合，必须有人工确认、审计记录和可回退路径。
|
||||
- 直属主管、审批人或财务账号停用后，不得继续接收新待办；历史审批记录保留只读。
|
||||
- 新员工账号创建必须同时确认直属主管、初始角色、账号状态和企业微信绑定路径。
|
||||
- 离职或停用账号必须阻断登录、企业微信入口和新业务处理，但不得删除历史单据和审批记录。
|
||||
- 新员工账号创建必须同时确认直属主管、初始角色、账号状态、企业微信通讯录同步状态和绑定路径。
|
||||
- 离职或停用账号必须阻断登录、企业微信入口和新业务处理；离职完成后默认禁用企业微信成员，不删除成员，不删除历史单据和审批记录。
|
||||
|
||||
只读审计口径：
|
||||
|
||||
@@ -236,24 +236,27 @@ ORDER BY e.employee_no;
|
||||
- `payment_batch_v1` 意外关闭，或 `erp_sync`、图片 OCR、真实支付、银行流水导入被误开启。
|
||||
- 同一天出现多个高优先级问题且无法解释清楚。
|
||||
|
||||
首周不主动新增可选功能。UX8 只接真实反馈或自动化确定性失败；移动采购创建、通知扩展、合同/供应商/资产、图片 OCR、ERP、真实支付、银行流水导入、复杂 BPM、审批设计器和重预算都必须另建独立合同。
|
||||
首周不主动新增可选功能。UX8 只接真实反馈或自动化确定性失败；移动采购创建、通知扩展、合同/供应商/资产、图片 OCR、真实支付、银行流水导入、复杂 BPM、审批设计器和重预算都必须另建独立合同；ERP 不再作为后续合同候选。
|
||||
|
||||
## 4. 人员生命周期管理
|
||||
### 4.1 入职
|
||||
1. 在 `人员管理` 创建员工账号。
|
||||
2. 打开员工详情页，补齐部门、职位、直属上级、试用期结束日、工作地点、紧急联系人。
|
||||
3. 发起 `入职`，系统会自动生成 checklist：账号初始化、资产发放、制度确认。
|
||||
4. checklist 全部完成后，员工状态自动从 `onboarding` 进入 `probation`。
|
||||
3. 若已开启 `hr_wecom_directory_sync_v1` 且企业微信通讯录配置完整，创建或发起入职时系统会尝试创建企业微信成员；缺 Secret、缺默认部门或无通讯录权限时记录 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`，OA 入职不回滚。
|
||||
4. 发起 `入职`，系统会自动生成 checklist：账号初始化、资产发放、制度确认。
|
||||
5. checklist 全部完成后，员工状态自动从 `onboarding` 进入 `probation`。
|
||||
6. 人员列表或员工详情中的“企业微信通讯录”状态若为同步失败或配置缺失，管理员可在配置修复后执行“重试同步”。
|
||||
|
||||
### 4.2 转正 / 调岗
|
||||
- `转正`：记录事件并将员工状态改为 `active`。
|
||||
- `调岗`：记录部门、直属上级、职位调整，同时生成调岗交接 checklist。
|
||||
- `调岗`：记录部门、直属上级、职位调整，同时生成调岗交接 checklist；若通讯录同步已开启，会尝试更新企业微信成员资料。
|
||||
- 这两个动作只做管理留痕，不引入复杂审批流。
|
||||
|
||||
### 4.3 离职
|
||||
1. 发起 `离职` 后，系统自动生成离职 checklist：资产归还、权限回收、费用与审批清理、交接说明。
|
||||
2. 若员工仍有名下资产或待处理审批任务，系统不会自动完成离职。
|
||||
3. checklist 完成且阻塞清零后，账号会被停用，主业务入口对该账号不可再用。
|
||||
3. checklist 完成且阻塞清零后，OA 账号会被停用并吊销现有会话，主业务入口对该账号不可再用。
|
||||
4. 离职完成后系统默认尝试禁用企业微信成员，不删除企业微信成员；同步失败时保留记录并允许管理员重试。
|
||||
|
||||
## 5. 团队状态与考勤口径
|
||||
- 员工每天可在 `Portal` 或 `团队` 页更新状态：在岗 / 居家 / 外出 / 出差。
|
||||
@@ -283,7 +286,7 @@ ORDER BY e.employee_no;
|
||||
## 8. 备用模块治理
|
||||
- 采购/费用、合同/附件和项目轻管理属于 P1 轻量能力，可在 P0 审批、报销/OCR、请假和企业微信入口稳定后逐步开放。
|
||||
- 支付批次和 AP 运营已作为正式财务闭环开放给出纳、财务和管理员；普通员工仍不显示财务运营入口。
|
||||
- 预算、ERP、AI、完整差旅、资产深度管理等保留代码和历史数据，但不作为当前 MVP 首批主路径。
|
||||
- 预算、AI、完整差旅、资产深度管理等保留代码和历史数据，但不作为当前 MVP 首批主路径；ERP 保持关闭，不再规划接入。
|
||||
- 若短期完全不用，保持管理员可见即可，不必删除。
|
||||
- 只有出现真实场景时，再恢复到主导航或单独扩展。
|
||||
|
||||
@@ -293,7 +296,7 @@ ORDER BY e.employee_no;
|
||||
3. 同步启用付款批次、AP 台账和银行回单附件，付款动作仍由出纳在 OA 外通过银行渠道完成。
|
||||
4. 同步启用已完成的 `请假`、补卡、外出、加班 OA 审批和月度考勤解释；企业微信打卡仍作为原始采集和风控底座。
|
||||
5. 在 P0 稳定后开放 P1：`采购/费用审批`、`合同/附件归档`、`项目轻管理`。
|
||||
6. 最后按真实需要评估周报、团队状态、公告、人员生命周期、资产、预算、ERP、AI 和完整差旅。
|
||||
6. 最后按真实需要评估周报、团队状态、公告、人员生命周期、资产、预算、AI 和完整差旅；ERP 不进入评估队列。
|
||||
|
||||
## 10. 试点验收口径
|
||||
- 全员都能账号密码登录；已绑定员工能从企业微信 `海音达工作台` 进入移动工作台。
|
||||
@@ -303,7 +306,7 @@ ORDER BY e.employee_no;
|
||||
- 至少 1 个审批待办从企业微信提醒 deeplink 回到 OA 页面处理。
|
||||
- P1 试点时，至少 1 条采购/费用申请、1 条合同台账、1 个项目关联事项可创建、审批或归档。
|
||||
- 正式使用前至少完成一次备份可用性核对；真实恢复演练必须另建批准合同，并记录恢复后的 `/ready` 结果。
|
||||
- 普通员工主导航不出现预算、AP、ERP、AI、完整差旅等当前首批不开放的备用模块。
|
||||
- 普通员工主导航不出现预算、AP、AI、完整差旅等当前首批不开放的备用模块；ERP 入口保持关闭。
|
||||
|
||||
## 11. 4 周观测操作法
|
||||
1. 每周一进入 `Portal`、`审批待办` 和 `考勤` 查看近 7 天登录覆盖率、审批积压、报销/OCR 异常、请假/考勤修正审批和企业微信入口错误；企微打卡同步缺配置时记录为 `SKIP`。
|
||||
@@ -383,7 +386,7 @@ ORDER BY e.employee_no;
|
||||
- `APP_ORIGIN=https://oa.example.com`
|
||||
- `COOKIE_SECURE=true`
|
||||
- `PUBLIC_SECURITY_HARDENING_ENABLED=true`
|
||||
3. 若启用企业微信入口，补齐：`WECOM_*` 与 `WECOM_ALLOWED_RETURN_HOSTS`。
|
||||
3. 若启用企业微信入口，补齐：`WECOM_*` 与 `WECOM_ALLOWED_RETURN_HOSTS`。若启用 OA 驱动企业微信通讯录同步，还需补齐 `WECOM_CONTACT_SYNC_ENABLED=true`、`WECOM_CONTACT_SECRET`、`WECOM_CONTACT_DEFAULT_DEPARTMENT_ID`，并确认该 Secret 具备通讯录写权限。
|
||||
4. 将 `OPENAPI_DOCS_ENABLED` 保持为 `false`，不要在公网生产暴露文档入口。
|
||||
5. 定期检查审计日志中的登录失败、Refresh 来源不匹配与涉密资料查看记录。
|
||||
6. 准备独立 smoke 账号，不使用老板、管理员或真实员工日常账号跑自动化；smoke 账号的角色和直属上级应按正式审批链配置。
|
||||
|
||||
在新工单中引用
屏蔽一个用户