WFOC 重构企微优先与OA接管需求口径
这个提交包含在：
+35
-24
@@ -5,7 +5,7 @@
|
||||
**状态**：模块级开发规约
|
||||
**上级事实源**：[海音达OA-MVP需求规格说明书](./海音达OA-MVP需求规格说明书.md)
|
||||
|
||||
本规约细化 `hyb-oa` 统一审批中心的产品边界、角色权限、状态模型、异常规则、留痕要求和验收场景。后续审批相关开发必须先从本规约拆分 Issue CSV，再进入技术方案和代码实现。
|
||||
本规约细化 `hyb-oa` 审批中心和企业微信原生审批镜像的产品边界、角色权限、状态模型、异常规则、留痕要求和验收场景。WFOC 起，审批按主办方分层：报销、财务、采购、合同和项目类审批继续由 OA 主办；HR/考勤/行政审批优先由企业微信主办，OA 同步完整镜像并保留人工接管和恢复回写能力。后续审批相关开发必须先从本规约拆分 Issue CSV，再进入技术方案和代码实现。
|
||||
|
||||
---
|
||||
|
||||
@@ -13,31 +13,41 @@
|
||||
|
||||
### 1.1 目标
|
||||
|
||||
- `hyb-oa` 是公司唯一业务主系统和唯一正式审批中心。
|
||||
- 所有正式审批在 OA 内提交、审批、留痕、归档。
|
||||
- PC、移动端和企业微信入口看到的是同一批审批任务和同一套审批记录。
|
||||
- 企业微信只做入口、身份、通知和 deeplink；审批动作必须回到 OA 页面完成。
|
||||
- R5 已在公网验证企业微信工作台入口、免登录、个人应用消息通知和移动审批回流；R6 之后继续沿用“OA 内审批、企业微信提醒回流”的正式口径。
|
||||
- `hyb-oa` 是财务审批、报销、采购、合同、项目和审计镜像中心。
|
||||
- HR/考勤/行政审批优先复用企业微信原生审批；OA 同步审批单、审批历史、附件、状态回调和审计镜像。
|
||||
- PC、移动端和企业微信入口应能区分 OA 主办审批、企微主办审批镜像和 OA 应急接管单据。
|
||||
- 企业微信消息继续作为 OA 主办审批的提醒和 deeplink；企微主办审批在企业微信内完成，OA 负责镜像和恢复对账。
|
||||
- 企微不可用时，管理员可人工开启 `oa_hr_emergency_mode_v1`，临时由 OA 接管 HR/考勤应急审批；企微恢复后通过 `wecom_recovery_writeback_v1` 回写和对账。
|
||||
|
||||
### 1.2 适用对象
|
||||
|
||||
首批及后续默认纳入 OA 审批中心的正式审批包括：
|
||||
首批及后续默认纳入 OA 主办审批中心的正式审批包括：
|
||||
|
||||
- 报销审批。
|
||||
- 请假、补卡、外出、加班、出差等考勤相关审批。
|
||||
- 采购审批。
|
||||
- 费用审批。
|
||||
- 合同审批、合同变更审批和合同归档相关审批。
|
||||
- 资产领用、归还、调拨、盘点中需要正式留痕的动作。
|
||||
- 后续新增业务审批，除非另有明确产品决策，否则默认接入统一审批中心。
|
||||
- 后续新增财务、采购、合同、项目和高风险业务审批，除非另有明确产品决策，否则默认接入 OA 主办审批中心。
|
||||
|
||||
企业微信主办审批第一批包括：
|
||||
|
||||
- 请假。
|
||||
- 补卡。
|
||||
- 外出。
|
||||
- 加班。
|
||||
- 与上述事项关联的假期余额和考勤解释。
|
||||
|
||||
OA 中既有请假、补卡、外出、加班能力转为历史只读、镜像展示和应急接管能力；正常情况下不再作为员工日常提交入口。
|
||||
|
||||
### 1.3 暂不做范围
|
||||
|
||||
- 不使用企业微信原生审批作为公司正式审批流。
|
||||
- 不接入飞书登录、飞书审批、飞书通知或飞书项目管理。
|
||||
- 首批不做复杂 BPM 设计器、自由拖拽流程、并行会签、条件分支可视化建模。
|
||||
- 首批不做跨公司多租户审批市场化配置。
|
||||
- 首批不做审批动作离线处理；移动端必须在线提交动作。
|
||||
- 不把企业微信 HR/考勤审批结果直接用于报销付款、财务复核或 AP 台账；财务动作必须在 OA 内完成。
|
||||
- 不让 AI 直接改正式审批模板；`wecom_ruleops_v1` 只能先草拟和 dry-run，人工确认后才允许写入企微。
|
||||
|
||||
---
|
||||
|
||||
@@ -48,9 +58,9 @@
|
||||
| 申请人 | 普通员工、主管、财务、HR | 创建草稿、提交、查看自己的单据、撤回允许撤回的单据、按退回意见修改后重提 | 只能编辑草稿、已退回、已驳回且规则允许重提的本人单据；当前不允许审批自己的待办；未来如需自审例外，必须另拆规则并强审计 |
|
||||
| 审批人 | 主管、项目负责人、老板、被转审人 | 查看分配给自己的待办，通过、驳回、退回、转审、查看审批历史 | 只能处理当前分配给自己的任务；不能越权处理他人待办 |
|
||||
| 财务 | 财务人员、财务主管 | 处理报销复核、付款标记、财务导出、重复发票例外审批中与财务相关的动作 | 不默认拥有系统管理权限；财务例外动作必须留痕 |
|
||||
| HR/行政 | HR、行政负责人 | 处理请假、补卡、外出、加班等行政审批或复核；维护基础人员与组织配置 | 不能绕过审批流直接改业务结果，必要修正必须审计 |
|
||||
| HR/行政 | HR、行政负责人 | 在企业微信处理请假、补卡、外出、加班等行政审批；在 OA 查看镜像、处理应急接管和恢复对账 | 不能绕过审批流直接改业务结果，必要修正必须审计 |
|
||||
| 老板/总经理 | 公司负责人 | 处理大额、高风险或最终节点审批，查看公司级待办和摘要 | 操作仍需写入审批历史和审计日志 |
|
||||
| 系统管理员 | 运维或后台系统负责人 | 配置角色、权限、企业微信入口、通知、基础字典和功能开关 | `admin` 只代表系统管理权限，不自动获得业务单据审批权；直接数据修复必须另有运维流程和审计 |
|
||||
| 系统管理员 | 运维或后台系统负责人 | 配置角色、权限、企业微信入口、通知、基础字典、功能开关、应急模式和 RuleOps | `admin` 只代表系统管理权限，不自动获得业务单据审批权；应急模式、回写和规则写入必须有审计 |
|
||||
|
||||
权限判定以服务端为准，前端按钮显隐只是体验优化，不作为授权依据。
|
||||
|
||||
@@ -104,7 +114,7 @@
|
||||
| PC 审批待办 | `/workflow/tasks` | 审批人集中处理待办、已办、抄送或历史任务 | 应在 PC 主导航清晰可达 |
|
||||
| 移动审批 | `/mobile/approvals` | 手机端处理待办和查看审批历史 | 应适配企业微信 WebView 和普通手机浏览器 |
|
||||
| 业务详情页 | 报销、请假、采购、合同等详情页 | 从具体单据查看审批流和执行动作 | 状态、当前节点、历史记录必须与待办一致 |
|
||||
| 企业微信消息 | deeplink 到 OA 页面 | 只做提醒和跳转 | 不在企业微信原生审批里完成正式审批 |
|
||||
| 企业微信消息 | deeplink 到 OA 页面或企微原生审批 | OA 主办审批回 OA，HR/考勤企微主办审批在企业微信处理 | 必须区分主办方，不把企微 HR 审批当作财务审批 |
|
||||
| Portal 待办摘要 | `/portal` 或首页卡片 | 提醒当前待处理数量 | 点击后进入 `/workflow/tasks` 或对应详情页 |
|
||||
|
||||
### 3.2 任务列表要求
|
||||
@@ -149,11 +159,10 @@
|
||||
| 采购 | `<=1000` 元 | 直属主管 | 视费用类型抽查 | 老板/总经理 | 审批完成前允许撤回 | 允许转给项目负责人或上级 |
|
||||
| 采购 | `1000-5000` 元 | 直属主管 -> 老板/总经理 | 视付款方式财务复核 | 老板/总经理 | 老板审批前允许撤回 | 允许转审但不得绕过老板节点 |
|
||||
| 采购 | `>5000` 元 | 直属主管 -> 老板/总经理 | 财务复核，建议关联合同或附件 | 老板/总经理 | 老板审批前允许撤回 | 允许转审但必须保留原因 |
|
||||
| 请假 | `<=1` 天 | 直属主管 | 无 | HR/行政 | 开始时间前允许撤回 | 允许转给上级或 HR/行政 |
|
||||
| 请假 | `>1` 天 | 直属主管 | HR/行政复核 | 老板/总经理 | HR 复核前允许撤回 | 允许转给上级或 HR/行政 |
|
||||
| 补卡 | 所有 | 直属主管 | HR/行政复核 | HR/行政 | 审批完成前允许撤回 | 允许转给 HR/行政 |
|
||||
| 外出 | 所有 | 直属主管 | HR/行政按需复核 | HR/行政 | 审批完成前允许撤回 | 允许转给上级或 HR/行政 |
|
||||
| 加班 | 所有 | 直属主管 | HR/行政复核 | HR/行政 | 审批完成前允许撤回 | 允许转给上级或 HR/行政 |
|
||||
| 请假 | 由企微模板配置 | 企业微信原生审批 | 按企微模板和公司制度 | OA 应急时按管理员临时规则 | 按企微能力或 OA 应急规则 | 企微正常时在企微处理，OA 只同步镜像 |
|
||||
| 补卡 | 由企微模板配置 | 企业微信原生审批 | 按企微模板和公司制度 | OA 应急时按管理员临时规则 | 按企微能力或 OA 应急规则 | 企微正常时在企微处理，OA 只同步镜像 |
|
||||
| 外出 | 由企微模板配置 | 企业微信原生审批 | 按企微模板和公司制度 | OA 应急时按管理员临时规则 | 按企微能力或 OA 应急规则 | 企微正常时在企微处理，OA 只同步镜像 |
|
||||
| 加班 | 由企微模板配置 | 企业微信原生审批 | 按企微模板和公司制度 | OA 应急时按管理员临时规则 | 按企微能力或 OA 应急规则 | 企微正常时在企微处理，OA 只同步镜像 |
|
||||
| 合同 | 所有 | 负责人主管 -> 老板/总经理 | 财务按金额或付款条款复核 | 老板/总经理 | 老板审批前允许撤回 | 允许转审但不得绕过老板节点 |
|
||||
|
||||
规则匹配优先级为：业务类型 -> 金额或天数阈值 -> 项目/部门特殊规则 -> 默认规则。若找不到审批人、缺直属主管、主管链断裂、审批人停用或节点解析为申请人本人，提交必须阻断并提示管理员修正组织或审批规则，不得生成半截流程。
|
||||
@@ -249,7 +258,7 @@ WF8 阶段只做轻量转审扩展，不进入复杂 BPM、审批设计器、并
|
||||
|
||||
- 首批覆盖报销、请假、采购三类已接入统一审批中心的待办。
|
||||
- 合同、差旅、资产等后续业务沿用同一原则，但必须另走对应连续 Issue 验收。
|
||||
- 企业微信只做通知和 deeplink 回 OA，不在企业微信原生审批中完成转审。
|
||||
- OA 主办审批通过企业微信通知和 deeplink 回 OA；HR/考勤企微主办审批允许在企业微信原生审批中完成转审或流转，OA 同步最终详情。
|
||||
|
||||
发起人规则：
|
||||
|
||||
@@ -340,7 +349,7 @@ WF8-3、WF8-4、WF8-5 实现前必须基于本设计给技术方案；实现后
|
||||
- 企业微信消息只发送脱敏提醒：标题、业务编号、状态、处理入口。
|
||||
- 企业微信 deeplink 必须指向 OA 审批页或业务详情页。
|
||||
- 用户点击消息后，在 OA 内查看详情并执行审批动作。
|
||||
- 企业微信原生审批不参与正式审批流，不生成公司认可的正式审批记录。
|
||||
- 企业微信原生审批参与 HR/考勤/行政审批正式流程，OA 通过 `wecom_native_approval_mirror_v1` 同步为可查询、可导出、可审计的镜像记录。报销、财务、采购、合同和项目类 OA 主办审批仍不得在企业微信原生审批中替代完成。
|
||||
- 若企业微信返回 `invaliduser`、`unlicenseduser`、不可见范围或权限类错误，业务提交和审批动作不应回滚，但通知记录必须可审计、可重试，并提示管理员修正企业微信应用可见范围或账号绑定。
|
||||
- 真机验收以企业微信手机端收到应用消息并可点击回流为准；系统级弹窗是否出现受客户端通知权限影响，不作为 OA 通知链路硬门槛。
|
||||
|
||||
@@ -367,9 +376,11 @@ WF8 当前正式验收通道为站内通知和企业微信个人应用消息。
|
||||
|
||||
| 场景 | 步骤 | 预期结果 |
|
||||
| --- | --- | --- |
|
||||
| 正常审批通过 | 申请人提交报销或请假；审批人在 PC 通过；查看业务详情 | 单据从草稿到审批中再到已通过；历史、当前状态、通知记录一致 |
|
||||
| OA 主办审批通过 | 申请人提交报销、采购或合同事项；审批人在 PC 通过；查看业务详情 | 单据从草稿到审批中再到已通过；历史、当前状态、通知记录一致 |
|
||||
| 移动端审批 | 申请人提交单据；审批人从 `/mobile/approvals` 打开待办并通过 | 移动端可完成审批；PC 待办同步消失或进入已办 |
|
||||
| 企业微信通知回 OA | 待办产生后发送企业微信提醒；审批人点击 deeplink | 打开 OA 对应审批页；不能在企业微信原生审批完成动作 |
|
||||
| 企业微信通知回 OA | OA 主办待办产生后发送企业微信提醒；审批人点击 deeplink | 打开 OA 对应审批页；审批动作在 OA 完成 |
|
||||
| 企微 HR 审批镜像 | 员工在企业微信提交请假、补卡、外出或加班；审批人在企业微信处理 | OA 通过 `wecom_native_approval_mirror_v1` 同步审批详情、历史、附件和状态 |
|
||||
| OA 应急 HR 审批 | 管理员人工开启 `oa_hr_emergency_mode_v1` 后，员工在 OA 提交 HR/考勤应急单 | 单据带 `EMERGENCY` 标记，进入恢复回写队列 |
|
||||
| 企业微信个人应用消息 | 触发待办后向绑定企业微信成员发送个人应用消息 | delivery 为成功且无 `invaliduser`；手机端可收到消息并点击回到 OA 移动审批 |
|
||||
| 驳回重提 | 审批人填写原因驳回；申请人查看原因后复制或重建申请 | 原流程留痕完整；新流程有新的提交记录 |
|
||||
| 退回修改 | 审批人退回；申请人修改后重提 | 保留同一业务单号和退回历史；重新进入审批中 |
|
||||
@@ -394,8 +405,8 @@ WF8 当前正式验收通道为站内通知和企业微信个人应用消息。
|
||||
- A2：通用状态转换与并发保护，覆盖提交、通过、驳回、退回、撤回、转审。
|
||||
- A3：审批权限与当前处理人校验，覆盖越权、自审、停用账号和角色待办。
|
||||
- A4：审批历史、审计日志和通知记录一致性。
|
||||
- A5：企业微信通知 deeplink 回 OA 验证，不新增企业微信原生审批。
|
||||
- A6：报销、请假、采购等业务模块逐个接入统一审批验收。
|
||||
- A5：企业微信通知 deeplink 回 OA 验证，覆盖 OA 主办审批回 OA 和企微主办 HR/考勤审批镜像。
|
||||
- A6：报销、采购、合同等 OA 主办业务逐个接入统一审批验收；请假、补卡、外出、加班按 `wecom_native_approval_mirror_v1` 单独接入镜像。
|
||||
- A7：审批回归脚本与 Playwright PC/移动/企业微信 UA 验证。
|
||||
- A8：审批规则配置矩阵落地，覆盖金额阈值、天数阈值、兜底审批人、转审和撤回。
|
||||
- A9：权限与数据范围矩阵落地，覆盖附件下载、导出、例外处理和系统管理员最小授权。
|
||||
|
||||
在新工单中引用
屏蔽一个用户