ATTV1 实现考勤统一入口与企微同步

docs/管理员手册.md

@@ -259,10 +259,10 @@ ORDER BY e.employee_no;
 - 员工每天可在 `Portal` 或 `团队` 页更新状态：在岗 / 居家 / 外出 / 出差。
 - 已批准请假会自动覆盖当天状态为 `请假`。
 - 企业微信打卡只作为原始采集工具；定位、人脸、Wi-Fi 和排班规则不在 OA 内重造。
-- 当前 OA 已完成请假审批和团队状态解释；员工补卡、外出、加班的独立审批闭环尚未上线。
-- 历史 `attendance_v1` 是 OA 极简打卡和管理员补卡能力，不等同于企业微信打卡风控；是否关闭、隐藏或保留备用需另建决策合同。
-- OA 后续如同步企业微信打卡数据，应结合 OA 请假和后续补卡/外出/加班审批形成正式考勤口径。
-- 请假等已上线审批仍在 OA 内完成，不使用企业微信原生审批；未上线的考勤修正流程按公司临时管理口径处理。
+- 当前 OA 已完成请假审批、补卡/外出/加班修正审批和月度考勤解释。
+- 历史 `attendance_v1` 是 OA 极简打卡和管理员补卡能力，不等同于企业微信打卡风控；该入口已关闭，旧写接口返回可解释 409，历史表保留。
+- OA 同步企业微信打卡摘要后，应结合 OA 请假、补卡、外出、加班审批形成正式考勤口径；缺企微打卡 Secret 或 API 权限时，同步批次按 `SKIP` 记录。
+- 请假和考勤修正审批均在 OA 内完成，不使用企业微信原生审批，也不向企业微信写回补卡或加班结果。
 
 ## 6. 周报与待办
 - 周报固定三段：本周完成 / 当前阻塞 / 下周计划。
@@ -291,7 +291,7 @@ ORDER BY e.employee_no;
 1. 先完成账号、角色、部门、企业微信自建应用入口和账号密码回退路径。
 2. 再启用 `OA 统一审批中心 + 报销/发票/OCR/附件`，跑通提交、审批、退回、查重、付款和导出闭环。
 3. 同步启用付款批次、AP 台账和银行回单附件，付款动作仍由出纳在 OA 外通过银行渠道完成。
-4. 同步启用已完成的 `请假` 审批和团队状态；补卡、外出、加班审批暂不作为已上线能力，企业微信打卡仍作为原始采集和风控底座。
+4. 同步启用已完成的 `请假`、补卡、外出、加班 OA 审批和月度考勤解释；企业微信打卡仍作为原始采集和风控底座。
 5. 在 P0 稳定后开放 P1：`采购/费用审批`、`合同/附件归档`、`项目轻管理`。
 6. 最后按真实需要评估周报、团队状态、公告、人员生命周期、资产、预算、ERP、AI 和完整差旅。
 
@@ -299,14 +299,14 @@ ORDER BY e.employee_no;
 - 全员都能账号密码登录；已绑定员工能从企业微信 `海音达工作台` 进入移动工作台。
 - 至少 1 笔报销完成：上传发票或附件 -> OCR/查重 -> 提交 -> OA 审批 -> 财务复核/付款标记 -> 导出。
 - 至少 1 个付款批次完成：出纳创建 -> 管理员复核 -> 出纳上传银行回单 -> 执行 OA 已付款标记 -> AP 台账和审计可查。
-- 至少 1 条请假完成：员工提交 -> OA 审批 -> 团队状态或考勤解释口径不破坏。补卡、外出、加班审批需待后续合同上线后再纳入验收。
+- 至少 1 条请假和 1 条考勤修正完成：员工提交 -> OA 审批 -> 月度考勤解释可查；日常打卡仍在企业微信。
 - 至少 1 个审批待办从企业微信提醒 deeplink 回到 OA 页面处理。
 - P1 试点时，至少 1 条采购/费用申请、1 条合同台账、1 个项目关联事项可创建、审批或归档。
 - 正式使用前至少完成一次备份可用性核对；真实恢复演练必须另建批准合同，并记录恢复后的 `/ready` 结果。
 - 普通员工主导航不出现预算、AP、ERP、AI、完整差旅等当前首批不开放的备用模块。
 
 ## 11. 4 周观测操作法
-1. 每周一进入 `Portal` 和 `审批待办` 查看近 7 天登录覆盖率、审批积压、报销/OCR 异常、请假审批和企业微信入口错误；补卡、外出、加班先按临时管理口径记录真实频次。
+1. 每周一进入 `Portal`、`审批待办` 和 `考勤` 查看近 7 天登录覆盖率、审批积压、报销/OCR 异常、请假/考勤修正审批和企业微信入口错误；企微打卡同步缺配置时记录为 `SKIP`。
 2. 每周五记录本周结论、关键阻塞、是否需要调整审批规则、报销规则、企业微信入口或导航。
 3. 若某周出现员工未登录、报销长期停留、发票重复处理不清、审批积压或企业微信绑定异常，优先修正规则和入口，不额外维护表格作为正式记录。
 4. 连续 4 周都达到预期后，再扩大到 P1 采购/费用、合同归档和项目轻管理试点。
@@ -315,7 +315,7 @@ ORDER BY e.employee_no;
 - 企业微信定位为 `入口 + 免登 + 通知 + 打卡原始采集`，不承载公司正式审批流。
 - 公司只维护一个企业微信自建应用，建议命名为 `海音达工作台`。
 - 默认工作台入口在企业微信手机端落到 `/mobile`；桌面浏览器和账号密码登录仍进入 `/portal`。员工真正操作仍在 `hyb-oa` 内完成。
-- 已上线的报销、采购、费用、合同和请假审批都在 OA 内提交和审批；补卡、外出、加班、出差等未上线流程待后续合同完成后再纳入 OA 正式审批。企业微信消息只负责提醒并 deeplink 回 OA。
+- 已上线的报销、采购、费用、合同、请假、补卡、外出和加班审批都在 OA 内提交和审批；出差等未上线流程待后续合同完成后再纳入 OA 正式审批。企业微信消息只负责提醒并 deeplink 回 OA。
 - 企微免登建议先完成账号绑定，再逐步在试点部门开启；任何时候都保留账号密码回退。
 - 若 OA 部署到公网，生产建议同时满足：`HTTPS`、`COOKIE_SECURE=true`、登录失败锁定、限流、审计开启。