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

docs/trialrun/人工试运行报告.md

@@ -33,7 +33,8 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
 - 2026-05-17 ACCOUNTING-HANDOFF-V1 已固化月度代账交接 SOP：OA 侧导出 AP 台账、报销、票据中心、付款批次/回单附件清单和审计日志；银行流水和银行回单原件由 `wangzhiling` 从银行渠道导出，交给代账人工核对。公网只读/导出核对显示付款批次清单、回单附件列表/下载、AP 导出、报销导出、票据导出和审计日志导出均返回 200；不开发银行流水导入或一键 zip 包。
 - 2026-05-17 SYSTEM-COMPLETE-GATE 已完成系统开发完成门禁：公网 `/ready`、public bundle、live smoke `3 passed`、PDF live OCR `1 passed`，只读 flag 核验显示 `payment_batch_v1=force_on`、`erp_sync=force_off`；公网移动/企业微信 UA 矩阵 `14 passed`；结论 `GO_TO_USE`。当前首批正式能力为员工报销、PDF OCR、审批、请假、采购、通知、移动/企业微信入口、财务台账、付款批次、银行回单附件和代账交接。
 - 2026-05-17 LAUNCH-OPS-V1 已固定首周正式使用运营口径：`wangshunli` 为上线拍板、管理员复核和回滚决策人，`wangzhiling` 为出纳/付款执行和代账资料准备人；首周问题登记、每日巡检、暂停条件、代账交接节奏和 UX8/可选功能冻结口径已回写现有手册。后续新增功能只按真实反馈和业务频次另建 Issue CSV。
-- 2026-05-17 REQ-COMPLETE-AUDIT 已完成需求完成度复核和考勤边界校正：首批正式能力保持 `GO_TO_USE` 结论不变；企业微信打卡作为原始采集和风控底座，OA 不重造定位、人脸、Wi-Fi、排班、设备和防作弊。当前请假为 `DONE`；企业微信打卡 API 同步、员工补卡审批和加班审批为 `NOT_STARTED`；外出申请审批为 `PARTIAL`；历史 OA 极简打卡 `attendance_v1` 为 `NEEDS_DECISION`，后续需另建合同决定隐藏、关闭或保留备用。
+- 2026-05-17 REQ-COMPLETE-AUDIT 已完成需求完成度复核和考勤边界校正：首批正式能力保持 `GO_TO_USE` 结论不变；企业微信打卡作为原始采集和风控底座，OA 不重造定位、人脸、Wi-Fi、排班、设备和防作弊。
+- 2026-05-17 ATTV1 已进入考勤统一入口实现：历史 OA 自建打卡 `attendance_v1` 关闭；OA 新增企微打卡摘要同步、补卡/外出/加班修正审批和月度考勤解释；所有审批继续统一在 OA，企业微信只负责打卡原始采集和风控。企微 live 同步依赖 `WECOM_CHECKIN_SECRET` 和企微打卡 API 权限，缺配置时记 `SKIP`。
 
 ## 关键证据索引
 
@@ -75,6 +76,7 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
 | SYSTEM-COMPLETE-GATE | 已收口：系统开发完成门禁通过，结论 `GO_TO_USE`；live smoke 3 passed、PDF live OCR 1 passed、public bundle findings=0、pending OCR 非阻断 SKIP、正式 flag 状态正确、公网移动/企微矩阵 14 passed | `issues/2026-05-17_12-55-49-system-complete-gate.csv`、`artifacts/qa-flow/live-smoke-readiness-20260517-125805/summary.json` |
 | LAUNCH-OPS-V1 | 已收口：首周运营保障口径固定；支持人、问题登记、每日巡检、暂停条件、代账交接节奏和可选功能冻结口径已回写手册 | `issues/2026-05-17_12-55-50-launch-ops-v1.csv`、`docs/管理员手册.md`、`docs/员工快速上手.md`、`docs/试运行与自动化验证手册.md` |
 | REQ-COMPLETE-AUDIT | 已收口：需求完成度复核和考勤边界校正完成；企微打卡与 OA 考勤解释边界已纠偏，补卡/外出/加班缺口已分级 | `issues/2026-05-17_13-32-26-requirements-completion-audit.csv`、`docs/海音达OA-MVP需求规格说明书.md`、`docs/需求-请假考勤修正规约.md`、`docs/需求-企业微信基础设施规约.md` |
+| ATTV1 | 执行中：考勤统一入口与企微打卡同步 V1；关闭 OA 自建打卡，新增企微打卡摘要同步、OA 补卡/外出/加班审批和月度解释 | `issues/2026-05-17_14-59-28-attendance-unified-wecom-sync-v1.csv`、`docs/需求-请假考勤修正规约.md`、`docs/需求-企业微信基础设施规约.md` |
 
 ## 当前门禁
 
@@ -105,7 +107,8 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
 | ACCOUNTING-HANDOFF-V1 代账交接 | 通过，无需开发一键包 | 现有能力核对：付款批次清单 200，回单附件列表 200，回单下载 200，AP 导出 200，报销导出 200，票据中心导出 200，审计日志导出 200；`docs/管理员手册.md` 已补月度交接 SOP。AP 台账不是银行流水，银行流水和回单原件由出纳从银行侧导出，不导入 OA。 |
 | SYSTEM-COMPLETE-GATE 系统完成门禁 | 通过，结论 `GO_TO_USE` | `check-live-smoke-env --strict` PASS；`run-live-smoke-readiness.sh` PASS，报告 `artifacts/qa-flow/live-smoke-readiness-20260517-125805/`；只读 flag 核验 `payment_batch_v1=force_on`、`erp_sync=force_off`；公网移动/企业微信矩阵 14 passed。 |
 | LAUNCH-OPS-V1 首周运营保障 | 通过，无新增业务功能 | 管理员手册、员工快速上手和试运行手册已更新正式启用口径；首周问题登记、每日巡检、暂停条件、回滚联系人、代账交接节奏和 UX8/冻结项处理方式已固定。 |
-| REQ-COMPLETE-AUDIT 需求完成度复核 | 通过，无运行时变更 | 完成首批能力和考勤边界复核；企业微信打卡为原始采集，OA 不重造打卡风控；请假 `DONE`，员工补卡和加班审批 `NOT_STARTED`，外出申请审批 `PARTIAL`，`attendance_v1` `NEEDS_DECISION`。 |
+| REQ-COMPLETE-AUDIT 需求完成度复核 | 通过，无运行时变更 | 完成首批能力和考勤边界复核；企业微信打卡为原始采集，OA 不重造打卡风控。 |
+| ATTV1 考勤统一入口 | 执行中，待本地全测后部署 | 历史 OA 自建打卡关闭；补卡、外出、加班已进入 OA 统一审批和月度解释；企微 live 同步缺配置时按 `SKIP` 记录。 |
 
 ## R7EP / OPS8 / QAF8 / UX8 / P2T 预检推进
 

docs/员工快速上手.md

@@ -1,12 +1,13 @@
 # hyb-oa 员工快速上手（10 人以下团队版）
 
-**当前状态（2026-05-17 / SYSTEM-COMPLETE-GATE）**：公网正式地址为 `https://oa.hyinda.com`。系统开发完成门禁结论为 `GO_TO_USE`，当前首批正式能力包括报销、PDF 发票 OCR、审批、请假、采购、通知、移动/企业微信入口、财务台账、付款批次、银行回单附件和代账交接。
+**当前状态（2026-05-17 / ATTV1）**：公网正式地址为 `https://oa.hyinda.com`。系统开发完成门禁结论为 `GO_TO_USE`，当前首批正式能力包括报销、PDF 发票 OCR、审批、请假、补卡/外出/加班考勤修正、采购、通知、移动/企业微信入口、财务台账、付款批次、银行回单附件和代账交接。
 
 ## 1. 你每周主要会用到什么
 - `Portal`：看公告、我的待办、我的资产、本周周报入口。
 - `审批`：处理分配给你的报销、请假、采购、差旅等审批。
 - `团队`：更新今天是在岗、居家、外出还是出差。
 - `请假`：提交并查看请假记录。
+- `考勤`：查看企业微信打卡摘要、提交补卡/外出/加班修正并跟踪审批。
 - `报销`：继续提交和跟踪报销。
 - `周报`：每周写一次三段式周报。
 - `待办`：记录和跟进个人事项。
@@ -15,7 +16,7 @@
 ## 2. 第一次登录后建议先做三件事
 1. 检查个人资料是否正确。
 2. 打开 `团队` 更新今天状态。
-3. 打开 `周报` 页面，熟悉本周周报入口。
+3. 打开 `考勤` 页面，确认日常打卡在企业微信，补卡/外出/加班解释在 OA。
 
 ## 3. 今日状态怎么填
 - `在岗`：今天主要在办公室。
@@ -37,7 +38,7 @@
 
 ## 6. 审批、请假和报销
 - 公司正式审批都在海音达工作台内完成，不在企业微信审批里处理。
-- 当前已上线的请假、报销、采购等申请按 OA 页面提交；补卡、外出、加班等考勤修正流程待公司另行通知上线前，按管理员通知的临时口径处理。
+- 当前已上线的请假、报销、采购、补卡、外出、加班等申请按 OA 页面提交；补卡只解释企业微信缺卡，不会写回企业微信。
 - 批准后的请假会自动反映到团队状态。
 - 报销状态仍可在系统内查看，不需要额外问行政。
 - 发票/OCR 正式入口保持 PDF-only；图片发票不作为当前正式 OCR 能力，图片只按普通附件处理。
@@ -58,7 +59,7 @@
 ## 9. 从企业微信进入
 - 如果公司启用了企业微信工作台入口，优先从企业微信打开海音达工作台。
 - 企业微信只是入口、免登和提醒，真正填写、审批和修改仍在海音达工作台页面内完成。
-- 企业微信打卡仍按公司要求使用；当前请假在 OA 内提交和审批，补卡、外出、加班等修正流程待公司另行通知上线前，按管理员通知的临时口径处理。
+- 企业微信打卡仍按公司要求使用；请假、补卡、外出、加班等解释和审批都在 OA 内提交和审批。
 - 如果企业微信免登失败，直接回到账号密码登录即可。
 - 如果你第一次从企业微信进入但看到“尚未绑定”，请不要反复重试，先用账号密码登录，再到 `个人设置 -> 企业微信绑定` 完成绑定。
 - 如果看到“登录已失效 / 已超时”，重新从企业微信工作台进入即可。

docs/文档事实源状态矩阵.md

@@ -55,6 +55,7 @@
 | `SYSTEM-COMPLETE-GATE` | `issues/2026-05-17_12-55-49-system-complete-gate.csv` | `EVIDENCE` | 系统开发完成门禁已收口；公网 readiness、live smoke、PDF live OCR、flag 状态、移动/企微矩阵和事实源核对通过，结论 `GO_TO_USE` |
 | `LAUNCH-OPS-V1` | `issues/2026-05-17_12-55-50-launch-ops-v1.csv` | `EVIDENCE` | 首周正式使用运营保障已收口；支持人、问题登记、每日巡检、暂停条件、回滚联系人、代账交接节奏和冻结项口径已固定 |
 | `REQ-COMPLETE-AUDIT` | `issues/2026-05-17_13-32-26-requirements-completion-audit.csv` | `EVIDENCE` | 需求完成度复核和考勤边界校正已收口；首批能力可交付不变，企业微信打卡作为原始采集和风控底座，OA 不重造定位/人脸/Wi-Fi/排班/防作弊；员工补卡/外出/加班审批和企微打卡 API 同步需后续合同 |
+| `ATTV1` | `issues/2026-05-17_14-59-28-attendance-unified-wecom-sync-v1.csv` | `ACTIVE` | 考勤统一入口与企微打卡同步 V1：关闭历史 OA 自建打卡，新增企微打卡摘要同步、补卡/外出/加班 OA 审批和月度解释；本地全测通过后再部署公网复检 |
 
 旧 Issue CSV 保留为历史审计证据：不删除、不批量回写、不移动到 `docs/archive/` 或其他归档目录。新连续合同如替代旧合同，只在新合同 `Notes` 或文档索引中说明 supersedes。
 
@@ -62,8 +63,8 @@
 
 | Doc_ID | Path | Category | Authority | Status | Owner | Related_Issues | Evidence | Supersedes | Last_Audited | Audit_Method | Risk | Notes |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| `IDX` | `docs/文档索引.md` | 入口索引 | 最高文档入口 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1,REQ-COMPLETE-AUDIT` | `rg` | none | 2026-05-17 | `node scripts/qa/audit-docs.mjs --check-registry` | medium | 判断当前该读什么 |
-| `REG` | `docs/文档事实源状态矩阵.md` | 文档台账 | 文档分类和状态事实源 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1,REQ-COMPLETE-AUDIT` | `audit-docs` | none | 2026-05-17 | `audit-docs --check-registry` | medium | 判断文档权威性 |
+| `IDX` | `docs/文档索引.md` | 入口索引 | 最高文档入口 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1,REQ-COMPLETE-AUDIT,ATTV1` | `rg` | none | 2026-05-17 | `node scripts/qa/audit-docs.mjs --check-registry` | medium | 判断当前该读什么 |
+| `REG` | `docs/文档事实源状态矩阵.md` | 文档台账 | 文档分类和状态事实源 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1,REQ-COMPLETE-AUDIT,ATTV1` | `audit-docs` | none | 2026-05-17 | `audit-docs --check-registry` | medium | 判断文档权威性 |
 | `PRD-MVP` | `docs/海音达OA-MVP需求规格说明书.md` | 需求事实源 | PRD 主事实源 | `CURRENT` | product | `REQ8,P2T,GOV8` | Issue CSV | `docs/requirements-specification.md` | 2026-05-13 | `rg` | high | 定义做什么、不做什么和验收口径 |
 | `PRODUCT-SCOPE` | `docs/产品口径.md` | 需求事实源 | 产品边界事实源 | `CURRENT` | product | `REQ8,P2T` | `rg` | none | 2026-05-13 | `rg` | high | 记录已拍板产品边界 |
 | `DESIGN-UI` | `docs/产品设计规则.md` | 设计事实源 | PC/移动/企业微信设计事实源 | `CURRENT` | design/frontend | `MIA7,MIF7,GOV8,DG8,DG9` | Playwright/视觉审查/DG8/DG9 | none | 2026-05-13 | `rg` | high | 页面改动必须读取；DG8 后飞书为主 UI/布局参考；DG9 后按页面分层和样板选型 |
@@ -168,4 +169,4 @@
 
 - `ME6-3` 代表性企业微信真机门禁已关闭。
 - MIF7-1..7 与 MIF7T 已完成本地整改、公网部署、公网匿名复检和带凭据 live smoke/OCR 复检。
-- R7E 真实扩大试运行阶段验收、P2 排序、R7E 收口、QAOPS8 上线硬化阶段收口、QAOPS9 上线硬化连续合同、PRELAUNCH 正式启用前公网预回归、CASHIER-VOUCHER-V1 财务闭环与银行回单附件、LAUNCH-DEPLOY-FINANCE 部署复检、FIN-PROD-ENABLE 正式常开、ACCOUNTING-HANDOFF-V1 代账交接 SOP、SYSTEM-COMPLETE-GATE 系统完成门禁、LAUNCH-OPS-V1 首周运营保障和 REQ-COMPLETE-AUDIT 需求完成度复核均已完成，当前 P0/P1 阻断为 0；P2D 已完成决策分流，P2-ORG 只读巡检已完成且无需写修复合同；当前公网 `payment_batch_v1=force_on`，`erp_sync=force_off`，正式支付接口、ERP、图片 OCR 和银行流水导入继续冻结。考勤侧当前只确认请假闭环 `DONE` 和企业微信打卡运营使用 `DONE`；企业微信打卡 API 同步、员工补卡审批和加班审批为 `NOT_STARTED`，外出申请审批为 `PARTIAL`，历史 OA 极简打卡 `attendance_v1` 为 `NEEDS_DECISION`。
+- R7E 真实扩大试运行阶段验收、P2 排序、R7E 收口、QAOPS8 上线硬化阶段收口、QAOPS9 上线硬化连续合同、PRELAUNCH 正式启用前公网预回归、CASHIER-VOUCHER-V1 财务闭环与银行回单附件、LAUNCH-DEPLOY-FINANCE 部署复检、FIN-PROD-ENABLE 正式常开、ACCOUNTING-HANDOFF-V1 代账交接 SOP、SYSTEM-COMPLETE-GATE 系统完成门禁、LAUNCH-OPS-V1 首周运营保障和 REQ-COMPLETE-AUDIT 需求完成度复核均已完成，当前 P0/P1 阻断为 0；P2D 已完成决策分流，P2-ORG 只读巡检已完成且无需写修复合同；当前公网 `payment_batch_v1=force_on`，`erp_sync=force_off`，正式支付接口、ERP、图片 OCR 和银行流水导入继续冻结。ATTV1 进入执行：历史 OA 自建打卡 `attendance_v1` 关闭，OA 补卡/外出/加班审批和月度考勤解释已纳入统一考勤主线；企微打卡 live 同步能力依赖 `WECOM_CHECKIN_SECRET` 和企微 API 权限，缺配置时记录 `SKIP`。

docs/文档索引.md

@@ -20,7 +20,7 @@
 
 ## 最近事实源链
 
-R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> MIF7/MIF7T(公网部署与带凭据公网复检已收口) -> DG8 -> DG9 -> R7E -> FBA -> QAOPS9/P2D -> P2-ORG -> P2-FIN-DECISION -> P2-FIN-V1 -> P2-OCR-SAMPLE -> P2Q -> P2AUTO -> P2AF -> P2-FIN-LIVE-DECISION -> P2-FIN-LIVE -> PRELAUNCH -> CASHIER-VOUCHER-V1 -> LAUNCH-DEPLOY-FINANCE -> FIN-PROD-ENABLE -> ACCOUNTING-HANDOFF-V1 -> SYSTEM-COMPLETE-GATE -> LAUNCH-OPS-V1 -> REQ-COMPLETE-AUDIT。
+R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> MIF7/MIF7T(公网部署与带凭据公网复检已收口) -> DG8 -> DG9 -> R7E -> FBA -> QAOPS9/P2D -> P2-ORG -> P2-FIN-DECISION -> P2-FIN-V1 -> P2-OCR-SAMPLE -> P2Q -> P2AUTO -> P2AF -> P2-FIN-LIVE-DECISION -> P2-FIN-LIVE -> PRELAUNCH -> CASHIER-VOUCHER-V1 -> LAUNCH-DEPLOY-FINANCE -> FIN-PROD-ENABLE -> ACCOUNTING-HANDOFF-V1 -> SYSTEM-COMPLETE-GATE -> LAUNCH-OPS-V1 -> REQ-COMPLETE-AUDIT -> ATTV1。
 
 - R6、PC6、PA6、FL6、AP6、RI6、LP6 已完成并部署。
 - ME6 自动化、公网视觉矩阵和 `ME6-3` 代表性企业微信真机门禁已完成。
@@ -48,7 +48,8 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
 - ACCOUNTING-HANDOFF-V1 是月度代账交接 SOP 合同：公司无 ERP/独立财务系统，OA 侧交接资料固定为 AP 台账、报销导出、票据中心导出、付款批次/回单附件清单和审计日志；银行侧流水和回单原件由出纳从银行渠道导出交给代账人工核对，不导入 OA，不开发一键 zip 包。
 - SYSTEM-COMPLETE-GATE 是系统开发完成收口合同：公网 readiness、live smoke、PDF live OCR、正式 flag 状态、FINPROD/ACCTH 证据、移动/企业微信矩阵和文档事实源均通过；结论 `GO_TO_USE`，系统按首批正式能力可交付使用。
 - LAUNCH-OPS-V1 是正式使用首周运营保障合同：固定 `wangshunli` 为上线拍板、管理员复核和回滚决策人，`wangzhiling` 为出纳/付款执行和代账资料准备人；首周问题登记、每日巡检、暂停条件、代账交接节奏和可选功能冻结口径已回写现有手册。
-- REQ-COMPLETE-AUDIT 是系统完成门禁后的需求完成度复核合同：确认首批正式能力仍为报销、PDF OCR、审批、请假、采购、通知、移动/企业微信入口、财务台账、付款批次、银行回单附件和代账交接；考勤边界纠偏为“企业微信打卡做原始采集和风控，OA 不重造定位/人脸/Wi-Fi/排班/防作弊”。请假为 `DONE`，员工补卡申请为 `NOT_STARTED`，外出申请为 `PARTIAL`，加班申请为 `NOT_STARTED`，历史 OA 极简打卡 `attendance_v1` 为 `NEEDS_DECISION`。
+- REQ-COMPLETE-AUDIT 是系统完成门禁后的需求完成度复核合同：确认首批正式能力仍为报销、PDF OCR、审批、请假、采购、通知、移动/企业微信入口、财务台账、付款批次、银行回单附件和代账交接；考勤边界纠偏为“企业微信打卡做原始采集和风控，OA 不重造定位/人脸/Wi-Fi/排班/防作弊”。
+- ATTV1 是 REQ-COMPLETE-AUDIT 后的考勤统一入口实现合同：关闭历史 OA 自建打卡 `attendance_v1`；新增 `attendance_unified_v1`、企微打卡摘要同步批次、补卡/外出/加班 OA 审批和月度考勤解释；企微 live 同步缺 Secret 或 API 权限时记 `SKIP`，不使用企微原生审批，不保存完整位置、人脸、设备明文或原始 payload。
 
 ## 当前活跃治理流
 
@@ -84,6 +85,7 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
 | `SYSTEM-COMPLETE-GATE` | `issues/2026-05-17_12-55-49-system-complete-gate.csv` | 已收口：系统开发完成门禁通过，结论 `GO_TO_USE` | 公网 `/ready`、public bundle、live smoke、PDF live OCR、正式 flag 状态、FINPROD/ACCTH 证据、移动/企微矩阵和文档事实源 | 不新增业务功能、不部署、不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水 |
 | `LAUNCH-OPS-V1` | `issues/2026-05-17_12-55-50-launch-ops-v1.csv` | 已收口：首周运营保障口径固定 | 首周支持人、问题登记、每日巡检、暂停条件、回滚联系人、代账月度交接节奏、UX8 真实反馈池和冻结项 | 不做真实恢复演练、不重置数据库、不主动开发可选功能 |
 | `REQ-COMPLETE-AUDIT` | `issues/2026-05-17_13-32-26-requirements-completion-audit.csv` | 已收口：需求完成度复核和考勤边界校正完成 | 首批能力完成度、企微打卡边界、请假/补卡/外出/加班缺口、`attendance_v1` 处理建议 | 不改业务代码、不部署、不切换公网开关；后续考勤同步或修正审批必须另建合同 |
+| `ATTV1` | `issues/2026-05-17_14-59-28-attendance-unified-wecom-sync-v1.csv` | 执行中：考勤统一入口与企微打卡同步 V1 | 关闭历史 OA 自建打卡；新增企微打卡摘要同步、补卡/外出/加班 OA 修正审批、月度解释页和移动入口 | 不用企业微信原生审批；不重造定位/人脸/Wi-Fi/设备风控；不保存完整位置、原始 payload 或人脸信息 |
 
 旧 Issue CSV 不删除、不批量回写、不移动到归档目录。若新治理流替代旧合同，只在新 CSV 的 `Notes` 或本索引说明 supersedes，旧文件保留历史审计语义。
 

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

@@ -231,7 +231,7 @@ OA 是公司唯一正式审批中心。以下审批必须在 OA 内提交、审
 
 ### 7.4 当前完成度校正
 
-REQAUD 复核后，本章当前完成度按以下口径读取：
+REQAUD 复核后，ATTV1 已按“企业微信打卡、OA 审批解释”口径进入实现，本章当前完成度按以下口径读取：
 
 | 项目 | 当前状态 | 说明 |
 | --- | --- | --- |
@@ -239,11 +239,11 @@ REQAUD 复核后，本章当前完成度按以下口径读取：
 | 请假影响团队状态/日历 | `DONE` | 已批准请假可进入团队状态和日历展示。 |
 | 企业微信入口、免登/绑定、通知 deeplink 回 OA | `DONE` | 企业微信只作为入口、身份和提醒，审批动作仍回 OA。 |
 | 企业微信打卡运营使用 | `DONE` | 员工继续按公司要求在企业微信打卡；这是企业微信侧能力，不代表 OA 已同步打卡 API。 |
-| 企业微信打卡 API 同步到 OA | `NOT_STARTED` | 当前没有同步企业微信打卡原始记录的运行时能力。 |
-| 员工补卡申请审批 | `NOT_STARTED` | 当前只有历史 `attendance_v1` 管理员补卡，不等同于员工提交补卡申请并走 OA 审批。 |
-| 外出申请审批 | `PARTIAL` | 团队状态支持手工记录外出，但没有独立外出申请审批闭环。 |
-| 加班申请审批 | `NOT_STARTED` | 当前没有独立加班申请、审批和补偿口径记录闭环。 |
-| 历史 OA 极简打卡 `attendance_v1` | `NEEDS_DECISION` | 已有 OA 自建上下班打卡、月度统计和管理员补卡；但当前产品口径要求企微承担打卡原始采集与风控底座，后续需单独决定隐藏、关闭或保留为备用。 |
+| 企业微信打卡 API 同步到 OA | `PARTIAL` | 已新增 `attendance_unified_v1` 同步批次和打卡摘要表；有企微打卡 Secret/API 权限时可同步，缺配置时按 `SKIP` 记录，不伪造通过。 |
+| 员工补卡申请审批 | `DONE` | 已新增 OA 考勤修正申请，补卡只解释企微缺卡，不向企业微信写回。 |
+| 外出申请审批 | `DONE` | 已新增外出修正申请和 OA 审批，用于月度考勤解释；不重造企微定位风控。 |
+| 加班申请审批 | `DONE` | 已新增加班修正申请和 OA 审批，记录加班事实和补偿口径。 |
+| 历史 OA 极简打卡 `attendance_v1` | `FROZEN_CLOSED` | OA 自建上下班打卡、管理员补卡和自建月度统计已从正式入口关闭；旧 API 保留但返回 409，历史表不删除。 |
 
 ---
 
@@ -306,8 +306,8 @@ REQAUD 复核后，本章当前完成度按以下口径读取：
 
 ### 9.4 打卡原始采集
 
-- 企业微信打卡数据可作为后续同步来源。
-- 首批不新增企业微信打卡 API 同步实现。
+- 企业微信打卡数据是 OA 同步的原始来源。
+- `attendance_unified_v1` 只同步打卡摘要、批次、脱敏错误码和 raw hash，不保存完整位置、人脸、设备明文或原始 payload。
 - 正式考勤统计必须结合 OA 的请假、补卡、外出、加班审批结果。
 
 ---
@@ -403,8 +403,8 @@ REQAUD 复核后，本章当前完成度按以下口径读取：
 
 后续事项必须另立 Issue CSV，不直接进入当前 MVP：
 
-- 企业微信打卡 API 同步和考勤汇总报表。
-- 补卡、外出、加班的完整移动端体验强化。
+- 企业微信打卡 live 同步配置和权限稳定化。
+- 补卡、外出、加班的真实使用反馈体验优化。
 - 合同台账、合同编号、合同审批和离线档案号的细化。
 - 预算控制、支付批次、AP 运营和 ERP 出站凭证增强。
 - 项目轻管理与周报、待办、费用、采购、差旅的进一步联动。

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`、登录失败锁定、限流、审计开启。
 

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

@@ -23,7 +23,7 @@
 
 - 不使用企业微信原生审批作为公司正式审批流。
 - 不把企业微信聊天、文件或审批记录作为财务附件主库、业务单据主库或正式审计事实源。
-- 首批不新增企业微信打卡 API 同步实现。
+- OA 不重造企业微信打卡采集和风控；ATTV1 起只同步企微打卡摘要并做 OA 考勤解释。
 - 首批不在 OA 内重造企业微信打卡的定位、人脸识别、Wi-Fi、排班、设备和防作弊规则。
 - 不接入飞书、钉钉或其他办公平台作为首批入口。
 
@@ -152,18 +152,18 @@ deeplink 必须校验目标地址白名单，避免跳转到非 OA 域名或未
 
 - 企业微信打卡用于原始采集，保留其定位、人脸识别、Wi-Fi、排班和设备能力。
 - OA 首批不重造打卡定位、人脸识别、Wi-Fi、排班、设备绑定、防作弊和异常判断引擎。
-- 首批不新增企业微信打卡 API 同步实现，只固定后续集成边界。
-- 后续同步后，OA 应把企业微信打卡原始记录与 OA 请假、补卡、外出、加班审批结果合并，形成正式考勤口径。
+- ATTV1 新增企微打卡摘要同步、同步批次和 raw hash 留痕；缺 Secret 或 API 权限时同步批次记录 `SKIP`。
+- OA 把企业微信打卡摘要与 OA 请假、补卡、外出、加班审批结果合并，形成正式考勤解释。
 - 企业微信打卡异常不直接等于最终考勤异常；最终解释必须结合 OA 审批记录。
 
-REQAUD 复核后，企业微信打卡边界进一步固定为：
+REQAUD 复核后，ATTV1 已完成统一入口实现，企业微信打卡边界进一步固定为：
 
 | 项目 | 状态 | 当前口径 |
 | --- | --- | --- |
 | 企业微信打卡运营使用 | `DONE` | 员工继续按公司要求使用企业微信打卡，定位、人脸、Wi-Fi、设备和防作弊由企业微信侧承担。 |
-| OA 同步企业微信打卡 API | `NOT_STARTED` | 当前没有企业微信打卡原始记录同步、补偿重试或隐私脱敏存储实现。 |
-| OA 历史 `attendance_v1` 极简打卡 | `NEEDS_DECISION` | 该模块是 OA 自建打卡，不具备企微定位/人脸/Wi-Fi/设备风控能力；后续需单独决定是否关闭、隐藏或保留为备用。 |
-| 正式考勤解释 | `PARTIAL` | 请假解释已可用；补卡、外出、加班的员工侧审批闭环尚未完成。 |
+| OA 同步企业微信打卡 API | `PARTIAL` | 同步表、批次、摘要和脱敏错误码已实现；公网真实同步取决于 `WECOM_CHECKIN_SECRET` 和企微打卡 API 权限。 |
+| OA 历史 `attendance_v1` 极简打卡 | `FROZEN_CLOSED` | 该模块已从正式入口关闭；旧表保留，旧写接口返回 409，不作为企微打卡能力。 |
+| 正式考勤解释 | `DONE` | OA 已支持请假、补卡、外出、加班审批和月度解释；不向企业微信原生审批或补卡接口写回。 |
 
 ---
 
@@ -191,7 +191,7 @@ REQAUD 复核后，企业微信打卡边界进一步固定为：
 - A5：企业微信通知 provider 和失败重试，不阻断主业务。
 - A6：deeplink 白名单和移动目标页回跳。
 - A7：通讯录辅助字段和后续同步边界。
-- A8：企业微信打卡原始采集同步 backlog，不进入首批实现。
+- A8：企业微信打卡 live 同步配置和权限稳定化，缺配置时继续按 `SKIP` 记录。
 - A9：企业微信真机 smoke 清单，覆盖工作台入口、绑定、通知和回跳。
 
 涉及真实企业微信凭据、回调域名、可信域名、生产配置或真机验证的 Issue，必须在技术方案中写明配置项、回滚路径和无法自动化时的人工验收步骤。

docs/需求-请假考勤修正规约.md

@@ -18,7 +18,7 @@
 - 员工能在 OA PC 或移动端提交请假、补卡、外出、加班申请。
 - 主管、HR/管理员在 OA 内审批并留痕。
 - 已通过的考勤修正影响团队状态、日历展示和后续正式考勤口径。
-- 企业微信打卡原始记录后续可同步到 OA，但必须结合 OA 审批结果解释。
+- 企业微信打卡原始记录由 OA 按摘要同步，必须结合 OA 审批结果解释。
 
 ### 1.2 适用对象
 
@@ -32,24 +32,24 @@
 
 - 不使用企业微信原生审批处理请假、补卡、外出、加班。
 - 首批不重造企业微信打卡的定位、人脸识别、Wi-Fi、排班和防作弊规则。
-- 首批不新增企业微信打卡 API 同步实现。
+- 不在 OA 内重造企业微信打卡采集和风控；OA 只同步摘要并做审批解释。
 - 首批不做复杂假期余额、调休余额、薪资计算、排班引擎和法定节假日自动规则。
 - 不把企业微信打卡异常直接作为 OA 最终考勤结论。
 
 ### 1.4 当前实现状态
 
-REQAUD 复核后，当前运行时完成度如下：
+REQAUD 复核后，ATTV1 已完成统一入口实现，当前运行时完成度如下：
 
 | 能力 | 状态 | 当前口径 |
 | --- | --- | --- |
 | 请假申请、审批、撤回、编辑、移动查看 | `DONE` | 已接入统一审批中心和 PC/移动页面。 |
 | 请假对团队状态/日历的影响 | `DONE` | 已批准请假可作为团队状态和日历依据。 |
 | 企业微信打卡作为原始采集 | `DONE` | 由企业微信侧承载定位、人脸、Wi-Fi、设备和防作弊能力；OA 不重造。 |
-| 企业微信打卡 API 同步 | `NOT_STARTED` | OA 尚未同步企微打卡原始记录。 |
-| 员工补卡申请审批 | `NOT_STARTED` | 当前只有历史 `attendance_v1` 管理员补卡，不能替代员工补卡申请审批。 |
-| 外出申请审批 | `PARTIAL` | 团队状态可手工标记外出，但无员工外出审批对象和流程。 |
-| 加班申请审批 | `NOT_STARTED` | 尚无独立加班申请、审批和补偿口径记录。 |
-| 历史 OA 极简打卡 `attendance_v1` | `NEEDS_DECISION` | 已有 OA 自建打卡和月度统计，但与当前“企微打卡做原始采集”的产品口径不同，后续需决定关闭、隐藏或保留为备用。 |
+| 企业微信打卡 API 同步 | `PARTIAL` | 已新增同步批次和企微打卡摘要表；有 `WECOM_CHECKIN_SECRET` 和企微权限时同步，缺配置时记录 `SKIP`。 |
+| 员工补卡申请审批 | `DONE` | 员工可在 OA 提交补卡修正，进入统一审批；通过后用于月度考勤解释，不写回企业微信。 |
+| 外出申请审批 | `DONE` | 员工可在 OA 提交外出修正，记录地点摘要和事由，审批后用于月度解释。 |
+| 加班申请审批 | `DONE` | 员工可在 OA 提交加班修正，记录时间、原因和补偿口径，审批后用于月度解释。 |
+| 历史 OA 极简打卡 `attendance_v1` | `FROZEN_CLOSED` | 自建上下班打卡、管理员补卡和自建月度统计已关闭正式入口；旧表保留，旧写接口返回可解释 409。 |
 
 ---
 
@@ -211,14 +211,11 @@ REQAUD 复核后，当前运行时完成度如下：
 
 ## 10. 后续开发拆分建议
 
-- A1：请假/补卡/外出/加班申请对象和字段收口。
-- A2：请假、补卡、外出、加班接入统一审批中心。
-- A3：审批规则配置，覆盖请假天数、补卡、外出、加班和兜底审批人。
-- A4：团队状态和日历生效逻辑，覆盖成功、失败重试和权限展示。
-- A5：考勤口径解释，预留企业微信打卡原始记录同步后的合并逻辑。
-- A6：企业微信通知 deeplink 回 OA，覆盖申请详情和审批待办。
-- A7：移动端提交与审批体验，覆盖普通手机和企业微信 WebView。
-- A8：请假考勤主链路回归脚本和人工验收数据集。
-- A9：出差完整流程后续专项，不进入本轮首批。
+- 已完成：补卡/外出/加班申请对象、统一审批接入、月度考勤解释页、移动入口和企业微信 deeplink 回 OA。
+- 后续 A1：企微打卡 live 同步配置稳定化，覆盖 Secret/API 权限、短窗口同步、错误码和脱敏证据。
+- 后续 A2：团队状态和日历生效逻辑增强，按真实使用反馈决定是否把外出/加班进一步展示到团队状态或日历。
+- 后续 A3：移动端提交与审批体验优化，覆盖普通手机和企业微信 WebView 的真实反馈。
+- 后续 A4：请假考勤主链路回归脚本和人工验收数据集。
+- 后续 A5：出差完整流程专项，不进入当前正式首批能力。
 
 涉及审批状态、团队状态、生效记录或后续打卡同步的 Issue，必须写明失败重试、回滚策略和人工修正路径。