wangsli/hyb-oa
1
0
派生 0
代码 工单 合并请求 工作流 8 软件包 项目 发布 百科 活动

REQAUD 收口需求完成度复核与考勤边界校正

浏览代码
这个提交包含在：
wangsli
2026-05-17 13:42:12 +08:00
父节点 22a2bcd205
当前提交 d50b7db143
共修改 9 个文件，包含 70 行新增和 12 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
docs/trialrun/人工试运行报告.md
+3
查看文件
@@ -33,6 +33,7 @@ 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`，后续需另建合同决定隐藏、关闭或保留备用。
## 关键证据索引
@@ -73,6 +74,7 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
| ACCOUNTING-HANDOFF-V1 | 已收口：月度代账交接 SOP 固化；OA 侧 AP/报销/票据/付款批次/回单附件/审计资料清单可用，公网导出和回单下载状态核对 200；银行流水和回单原件由出纳线下导出给代账 | `issues/2026-05-17_11-40-48-accounting-handoff-v1.csv`、`docs/管理员手册.md` |
| 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` |
## 当前门禁
@@ -103,6 +105,7 @@ 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`。 |
## R7EP / OPS8 / QAF8 / UX8 / P2T 预检推进
docs/员工快速上手.md
+2 -2
查看文件
@@ -37,7 +37,7 @@
## 6. 审批、请假和报销
- 公司正式审批都在海音达工作台内完成，不在企业微信审批里处理。
- 请假、补卡、外出、加班、报销、采购、差旅等申请都按 OA 页面提交。
- 当前已上线的请假、报销、采购等申请按 OA 页面提交；补卡、外出、加班等考勤修正流程待公司另行通知上线前，按管理员通知的临时口径处理。
- 批准后的请假会自动反映到团队状态。
- 报销状态仍可在系统内查看，不需要额外问行政。
- 发票/OCR 正式入口保持 PDF-only；图片发票不作为当前正式 OCR 能力，图片只按普通附件处理。
@@ -58,7 +58,7 @@
## 9. 从企业微信进入
- 如果公司启用了企业微信工作台入口，优先从企业微信打开海音达工作台。
- 企业微信只是入口、免登和提醒，真正填写、审批和修改仍在海音达工作台页面内完成。
- 企业微信打卡仍按公司要求使用；请假、补卡、外出、加班等修正申请在 OA 内提交。
- 企业微信打卡仍按公司要求使用；当前请假在 OA 内提交和审批，补卡、外出、加班等修正流程待公司另行通知上线前，按管理员通知的临时口径处理。
- 如果企业微信免登失败，直接回到账号密码登录即可。
- 如果你第一次从企业微信进入但看到“尚未绑定”，请不要反复重试，先用账号密码登录，再到 `个人设置 -> 企业微信绑定` 完成绑定。
- 如果看到“登录已失效 / 已超时”，重新从企业微信工作台进入即可。
docs/文档事实源状态矩阵.md
+4 -3
查看文件
@@ -54,6 +54,7 @@
| `ACCOUNTING-HANDOFF-V1` | `issues/2026-05-17_11-40-48-accounting-handoff-v1.csv` | `EVIDENCE` | 月度代账交接 SOP 已收口；OA 侧导出和回单附件清单可用，银行流水和回单原件由出纳从银行侧导出，不导入 OA |
| `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 同步需后续合同 |
旧 Issue CSV 保留为历史审计证据：不删除、不批量回写、不移动到 `docs/archive/` 或其他归档目录。新连续合同如替代旧合同，只在新合同 `Notes` 或文档索引中说明 supersedes。
@@ -61,8 +62,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` | `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` | `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` | `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 | 判断文档权威性 |
| `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 后按页面分层和样板选型 |
@@ -167,4 +168,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 首周运营保障均已完成，当前 P0/P1 阻断为 0；P2D 已完成决策分流，P2-ORG 只读巡检已完成且无需写修复合同；当前公网 `payment_batch_v1=force_on`，`erp_sync=force_off`，正式支付接口、ERP、图片 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`。
docs/文档索引.md
+3 -1
查看文件
@@ -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。
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 自动化、公网视觉矩阵和 `ME6-3` 代表性企业微信真机门禁已完成。
@@ -48,6 +48,7 @@ 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`。
## 当前活跃治理流
@@ -82,6 +83,7 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
| `ACCOUNTING-HANDOFF-V1` | `issues/2026-05-17_11-40-48-accounting-handoff-v1.csv` | 已收口：月度代账交接 SOP 固化 | OA 侧 AP/报销/票据/付款批次/回单附件/审计资料清单，银行侧流水和回单原件由出纳线下导出，代账人工核对 | 不开发银行流水导入、不开发一键 zip 包、不保存真实银行资料到仓库 |
| `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` 处理建议 | 不改业务代码、不部署、不切换公网开关；后续考勤同步或修正审批必须另建合同 |
旧 Issue CSV 不删除、不批量回写、不移动到归档目录。若新治理流替代旧合同，只在新 CSV 的 `Notes` 或本索引说明 supersedes，旧文件保留历史审计语义。
docs/海音达OA-MVP需求规格说明书.md
+16
查看文件
@@ -229,6 +229,22 @@ OA 是公司唯一正式审批中心。以下审批必须在 OA 内提交、审
- 已批准请假能影响团队状态或日历展示。
- 文档和界面不引导员工去企业微信原生审批提交请假或补卡。
### 7.4 当前完成度校正
REQAUD 复核后，本章当前完成度按以下口径读取：
| 项目 | 当前状态 | 说明 |
| --- | --- | --- |
| 请假申请、审批、撤回、编辑和移动查看 | `DONE` | 已有 `leave_requests`、统一审批、PC/移动页面和回归证据。 |
| 请假影响团队状态/日历 | `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 自建上下班打卡、月度统计和管理员补卡；但当前产品口径要求企微承担打卡原始采集与风控底座，后续需单独决定隐藏、关闭或保留为备用。 |
---
## 8. 采购、费用、合同与项目资料
docs/管理员手册.md
+8 -6
查看文件
@@ -259,8 +259,10 @@ ORDER BY e.employee_no;
- 员工每天可在 `Portal` 或 `团队` 页更新状态：在岗 / 居家 / 外出 / 出差。
- 已批准请假会自动覆盖当天状态为 `请假`。
- 企业微信打卡只作为原始采集工具；定位、人脸、Wi-Fi 和排班规则不在 OA 内重造。
- OA 后续同步企业微信打卡数据后，应结合 OA 请假、补卡、外出、加班审批形成正式考勤口径。
- 请假、补卡、外出、加班等审批仍在 OA 内完成，不使用企业微信原生审批。
- 当前 OA 已完成请假审批和团队状态解释；员工补卡、外出、加班的独立审批闭环尚未上线。
- 历史 `attendance_v1` 是 OA 极简打卡和管理员补卡能力，不等同于企业微信打卡风控；是否关闭、隐藏或保留备用需另建决策合同。
- OA 后续如同步企业微信打卡数据，应结合 OA 请假和后续补卡/外出/加班审批形成正式考勤口径。
- 请假等已上线审批仍在 OA 内完成，不使用企业微信原生审批；未上线的考勤修正流程按公司临时管理口径处理。
## 6. 周报与待办
- 周报固定三段：本周完成 / 当前阻塞 / 下周计划。
@@ -289,7 +291,7 @@ ORDER BY e.employee_no;
1. 先完成账号、角色、部门、企业微信自建应用入口和账号密码回退路径。
2. 再启用 `OA 统一审批中心 + 报销/发票/OCR/附件`，跑通提交、审批、退回、查重、付款和导出闭环。
3. 同步启用付款批次、AP 台账和银行回单附件，付款动作仍由出纳在 OA 外通过银行渠道完成。
4. 同步启用 `请假/补卡/外出/加班`，明确企业微信打卡只是原始采集，正式考勤解释回到 OA 审批结果。
4. 同步启用已完成的 `请假` 审批和团队状态；补卡、外出、加班审批暂不作为已上线能力，企业微信打卡仍作为原始采集和风控底座。
5. 在 P0 稳定后开放 P1：`采购/费用审批`、`合同/附件归档`、`项目轻管理`。
6. 最后按真实需要评估周报、团队状态、公告、人员生命周期、资产、预算、ERP、AI 和完整差旅。
@@ -297,14 +299,14 @@ ORDER BY e.employee_no;
- 全员都能账号密码登录；已绑定员工能从企业微信 `海音达工作台` 进入移动工作台。
- 至少 1 笔报销完成：上传发票或附件 -> OCR/查重 -> 提交 -> OA 审批 -> 财务复核/付款标记 -> 导出。
- 至少 1 个付款批次完成：出纳创建 -> 管理员复核 -> 出纳上传银行回单 -> 执行 OA 已付款标记 -> AP 台账和审计可查。
- 至少 1 条请假或补卡完成：员工提交 -> OA 审批 -> 团队状态或考勤解释口径不破坏。
- 至少 1 条请假完成：员工提交 -> OA 审批 -> 团队状态或考勤解释口径不破坏。补卡、外出、加班审批需待后续合同上线后再纳入验收。
- 至少 1 个审批待办从企业微信提醒 deeplink 回到 OA 页面处理。
- P1 试点时，至少 1 条采购/费用申请、1 条合同台账、1 个项目关联事项可创建、审批或归档。
- 正式使用前至少完成一次备份可用性核对；真实恢复演练必须另建批准合同，并记录恢复后的 `/ready` 结果。
- 普通员工主导航不出现预算、AP、ERP、AI、完整差旅等当前首批不开放的备用模块。
## 11. 4 周观测操作法
1. 每周一进入 `Portal` 和 `审批待办` 查看近 7 天登录覆盖率、审批积压、报销/OCR 异常、请假/补卡审批和企业微信入口错误。
1. 每周一进入 `Portal` 和 `审批待办` 查看近 7 天登录覆盖率、审批积压、报销/OCR 异常、请假审批和企业微信入口错误；补卡、外出、加班先按临时管理口径记录真实频次。
2. 每周五记录本周结论、关键阻塞、是否需要调整审批规则、报销规则、企业微信入口或导航。
3. 若某周出现员工未登录、报销长期停留、发票重复处理不清、审批积压或企业微信绑定异常，优先修正规则和入口，不额外维护表格作为正式记录。
4. 连续 4 周都达到预期后，再扩大到 P1 采购/费用、合同归档和项目轻管理试点。
@@ -313,7 +315,7 @@ ORDER BY e.employee_no;
- 企业微信定位为 `入口 + 免登 + 通知 + 打卡原始采集`，不承载公司正式审批流。
- 公司只维护一个企业微信自建应用，建议命名为 `海音达工作台`。
- 默认工作台入口在企业微信手机端落到 `/mobile`；桌面浏览器和账号密码登录仍进入 `/portal`。员工真正操作仍在 `hyb-oa` 内完成。
- 所有报销、采购、费用、合同、请假、补卡、外出、加班、出差审批都在 OA 内提交和审批；企业微信消息只负责提醒并 deeplink 回 OA。
- 已上线的报销、采购、费用、合同和请假审批都在 OA 内提交和审批；补卡、外出、加班、出差等未上线流程待后续合同完成后再纳入 OA 正式审批。企业微信消息只负责提醒并 deeplink 回 OA。
- 企微免登建议先完成账号绑定，再逐步在试点部门开启；任何时候都保留账号密码回退。
- 若 OA 部署到公网，生产建议同时满足：`HTTPS`、`COOKIE_SECURE=true`、登录失败锁定、限流、审计开启。
docs/需求-企业微信基础设施规约.md
+9
查看文件
@@ -156,6 +156,15 @@ deeplink 必须校验目标地址白名单，避免跳转到非 OA 域名或未
- 后续同步后，OA 应把企业微信打卡原始记录与 OA 请假、补卡、外出、加班审批结果合并，形成正式考勤口径。
- 企业微信打卡异常不直接等于最终考勤异常；最终解释必须结合 OA 审批记录。
REQAUD 复核后，企业微信打卡边界进一步固定为：
| 项目 | 状态 | 当前口径 |
| --- | --- | --- |
| 企业微信打卡运营使用 | `DONE` | 员工继续按公司要求使用企业微信打卡，定位、人脸、Wi-Fi、设备和防作弊由企业微信侧承担。 |
| OA 同步企业微信打卡 API | `NOT_STARTED` | 当前没有企业微信打卡原始记录同步、补偿重试或隐私脱敏存储实现。 |
| OA 历史 `attendance_v1` 极简打卡 | `NEEDS_DECISION` | 该模块是 OA 自建打卡，不具备企微定位/人脸/Wi-Fi/设备风控能力；后续需单独决定是否关闭、隐藏或保留为备用。 |
| 正式考勤解释 | `PARTIAL` | 请假解释已可用；补卡、外出、加班的员工侧审批闭环尚未完成。 |
---
## 8. 验收场景
docs/需求-请假考勤修正规约.md
+15
查看文件
@@ -36,6 +36,21 @@
- 首批不做复杂假期余额、调休余额、薪资计算、排班引擎和法定节假日自动规则。
- 不把企业微信打卡异常直接作为 OA 最终考勤结论。
### 1.4 当前实现状态
REQAUD 复核后，当前运行时完成度如下：
| 能力 | 状态 | 当前口径 |
| --- | --- | --- |
| 请假申请、审批、撤回、编辑、移动查看 | `DONE` | 已接入统一审批中心和 PC/移动页面。 |
| 请假对团队状态/日历的影响 | `DONE` | 已批准请假可作为团队状态和日历依据。 |
| 企业微信打卡作为原始采集 | `DONE` | 由企业微信侧承载定位、人脸、Wi-Fi、设备和防作弊能力；OA 不重造。 |
| 企业微信打卡 API 同步 | `NOT_STARTED` | OA 尚未同步企微打卡原始记录。 |
| 员工补卡申请审批 | `NOT_STARTED` | 当前只有历史 `attendance_v1` 管理员补卡，不能替代员工补卡申请审批。 |
| 外出申请审批 | `PARTIAL` | 团队状态可手工标记外出，但无员工外出审批对象和流程。 |
| 加班申请审批 | `NOT_STARTED` | 尚无独立加班申请、审批和补偿口径记录。 |
| 历史 OA 极简打卡 `attendance_v1` | `NEEDS_DECISION` | 已有 OA 自建打卡和月度统计，但与当前“企微打卡做原始采集”的产品口径不同，后续需决定关闭、隐藏或保留为备用。 |
---
## 2. 角色与权限