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

WF8 明确审批通知与邮件通道边界

浏览代码
这个提交包含在：
wangsli
2026-05-13 18:38:19 +08:00
父节点 9a834df2c1
当前提交 874cd9db4d
共修改 2 个文件，包含 19 行新增和 2 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
docs/需求-统一审批中心规约.md
+17
查看文件
@@ -285,6 +285,23 @@ REQ8 当前状态：跨业务转审仍是产品目标，但当前 R7 不以扩
- 若企业微信返回 `invaliduser`、`unlicenseduser`、不可见范围或权限类错误，业务提交和审批动作不应回滚，但通知记录必须可审计、可重试，并提示管理员修正企业微信应用可见范围或账号绑定。 - 若企业微信返回 `invaliduser`、`unlicenseduser`、不可见范围或权限类错误，业务提交和审批动作不应回滚，但通知记录必须可审计、可重试，并提示管理员修正企业微信应用可见范围或账号绑定。
- 真机验收以企业微信手机端收到应用消息并可点击回流为准；系统级弹窗是否出现受客户端通知权限影响，不作为 OA 通知链路硬门槛。 - 真机验收以企业微信手机端收到应用消息并可点击回流为准；系统级弹窗是否出现受客户端通知权限影响，不作为 OA 通知链路硬门槛。
### 9.1 WF8 邮件通道决策
WF8 当前正式验收通道为站内通知和企业微信个人应用消息。邮件通道先记录为冻结项，不作为当前 WF8 硬门禁；三渠道验收在本阶段按“两渠道验收 + 邮件冻结说明”处理。
冻结原因：
- 当前 R7E 真实试运行尚未完成，邮件是否必要应由真实使用反馈决定。
- 未确认正式 SMTP 配置、发件域、收件人范围、退信处理和敏感信息脱敏策略前，不应把邮件纳入发布可测结论。
- 审批邮件容易被转发或进入个人邮箱，消息内容必须比企业微信更严格脱敏。
后续解锁条件：
- 用户确认邮件是审批通知正式通道，而不是临时辅助提醒。
- 技术方案写清 SMTP provider、密钥存放、退信处理、失败重试、速率限制和回滚路径。
- 邮件内容只包含脱敏标题、业务编号、状态和 OA deeplink，不包含完整发票、附件、合同正文、报价、银行卡、身份证或 token。
- `Test_Method` 同时覆盖站内、企业微信和邮件；缺 SMTP 或样例收件人时必须标 `SKIP`，不得写成 `PASS`。
--- ---
## 10. 验收场景 ## 10. 验收场景
issues/2026-05-13_18-23-52-wf8-approval-notification.csv
+2 -2
查看文件
@@ -1,12 +1,12 @@
ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes
WF8-0,WF8 连续合同建档,"建立审批与通知增强连续型合同，把转审、通知、催办、邮件通道决策、三渠道验收和审批历史一致性放入同一 CSV。","1) 本 CSV 校验通过；2) 文档索引和状态矩阵指向本合同；3) 不进入复杂 BPM 或审批设计器；4) 不改业务代码；5) 执行前确认 ORG8 角色边界。","流程级验证：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-13_18-23-52-wf8-approval-notification.csv；rg -n 'WF8|审批|通知' docs/文档索引.md docs/文档事实源状态矩阵.md issues/README.md。",python3|rg|manual,DONE,DONE,DONE,issues/2026-05-13_18-23-52-wf8-approval-notification.csv|docs/文档索引.md|docs/文档事实源状态矩阵.md|issues/README.md,[],CSV validator 和索引 rg 均通过；本次仅合同建档和入口登记，未改业务代码，执行前仍需 ORG8 角色边界和方案批准。 WF8-0,WF8 连续合同建档,"建立审批与通知增强连续型合同，把转审、通知、催办、邮件通道决策、三渠道验收和审批历史一致性放入同一 CSV。","1) 本 CSV 校验通过；2) 文档索引和状态矩阵指向本合同；3) 不进入复杂 BPM 或审批设计器；4) 不改业务代码；5) 执行前确认 ORG8 角色边界。","流程级验证：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-13_18-23-52-wf8-approval-notification.csv；rg -n 'WF8|审批|通知' docs/文档索引.md docs/文档事实源状态矩阵.md issues/README.md。",python3|rg|manual,DONE,DONE,DONE,issues/2026-05-13_18-23-52-wf8-approval-notification.csv|docs/文档索引.md|docs/文档事实源状态矩阵.md|issues/README.md,[],CSV validator 和索引 rg 均通过；本次仅合同建档和入口登记，未改业务代码，执行前仍需 ORG8 角色边界和方案批准。
WF8-1,审批通知需求规约更新,"复核统一审批中心规约，把转审、通知失败、催办、deeplink 和邮件通道决策写清楚或确认已覆盖。","1) 审批和通知边界清楚；2) 不引入复杂 BPM；3) 企业微信审批动作回 OA；4) 邮件是否验收有决策。","流程级验证：rg -n '转审|通知|催办|邮件|deeplink|复杂 BPM|审批设计器' docs/需求-统一审批中心规约.md docs/需求-企业微信基础设施规约.md。",rg|manual,TODO,TODO,TODO,docs/需求-统一审批中心规约.md|docs/需求-企业微信基础设施规约.md,"[""WF8-0""]",先事实源对齐再实现。 WF8-1,审批通知需求规约更新,"复核统一审批中心规约，把转审、通知失败、催办、deeplink 和邮件通道决策写清楚或确认已覆盖。","1) 审批和通知边界清楚；2) 不引入复杂 BPM；3) 企业微信审批动作回 OA；4) 邮件是否验收有决策。","流程级验证：rg -n '转审|通知|催办|邮件|deeplink|复杂 BPM|审批设计器' docs/需求-统一审批中心规约.md docs/需求-企业微信基础设施规约.md。",rg|manual,DONE,DONE,DONE,docs/需求-统一审批中心规约.md|docs/需求-企业微信基础设施规约.md,"[""WF8-0""]",统一审批中心规约已覆盖转审、通知失败、催办、deeplink、复杂 BPM 和审批设计器冻结；已补 WF8 邮件通道决策；未改 workflow 代码。
WF8-2,转审扩展设计,"设计请假、采购和报销的转审扩展规则，明确权限、状态、历史和通知影响。","1) 转审发起人和接收人规则清楚；2) 原审批人和新审批人历史可追溯；3) 不造成重复审批；4) 回滚路径明确。","流程级验证：人工审查状态流；rg -n '转审|delegat|reassign|审批历史|workflow' docs/需求-统一审批中心规约.md server/src。",rg|manual,TODO,TODO,TODO,docs/需求-统一审批中心规约.md|server/src,"[""WF8-1""]",涉及 workflow 状态机必须 reviewer。 WF8-2,转审扩展设计,"设计请假、采购和报销的转审扩展规则，明确权限、状态、历史和通知影响。","1) 转审发起人和接收人规则清楚；2) 原审批人和新审批人历史可追溯；3) 不造成重复审批；4) 回滚路径明确。","流程级验证：人工审查状态流；rg -n '转审|delegat|reassign|审批历史|workflow' docs/需求-统一审批中心规约.md server/src。",rg|manual,TODO,TODO,TODO,docs/需求-统一审批中心规约.md|server/src,"[""WF8-1""]",涉及 workflow 状态机必须 reviewer。
WF8-3,请假转审,"实现或补强请假审批转审，保证请假流程和团队状态一致。","1) 请假待办可合法转审；2) 被转审人可审批；3) 历史记录完整；4) 团队状态不被错误更新。","流程级验证：员工提交请假 -> 审批人转审 -> 新审批人通过或驳回 -> 检查请假状态和审批历史。",node|bash|manual,TODO,TODO,TODO,server/src|client/src|server/scripts,"[""WF8-2""]",不扩展考勤 API。 WF8-3,请假转审,"实现或补强请假审批转审，保证请假流程和团队状态一致。","1) 请假待办可合法转审；2) 被转审人可审批；3) 历史记录完整；4) 团队状态不被错误更新。","流程级验证：员工提交请假 -> 审批人转审 -> 新审批人通过或驳回 -> 检查请假状态和审批历史。",node|bash|manual,TODO,TODO,TODO,server/src|client/src|server/scripts,"[""WF8-2""]",不扩展考勤 API。
WF8-4,采购转审,"实现或补强采购审批转审，保证采购状态、附件和审批历史一致。","1) 采购待办可合法转审；2) 附件和状态不丢失；3) 重复转审有防护；4) 历史可追溯。","流程级验证：员工提交采购 -> 审批人转审 -> 新审批人处理 -> 检查采购状态和历史。",node|bash|manual,TODO,TODO,TODO,server/src|client/src|server/scripts,"[""WF8-2""]",不引入复杂预算和供应商准入。 WF8-4,采购转审,"实现或补强采购审批转审，保证采购状态、附件和审批历史一致。","1) 采购待办可合法转审；2) 附件和状态不丢失；3) 重复转审有防护；4) 历史可追溯。","流程级验证：员工提交采购 -> 审批人转审 -> 新审批人处理 -> 检查采购状态和历史。",node|bash|manual,TODO,TODO,TODO,server/src|client/src|server/scripts,"[""WF8-2""]",不引入复杂预算和供应商准入。
WF8-5,报销转审复核,"复核既有报销转审能力，补齐权限、历史或通知缺口。","1) 报销转审符合权限；2) 发票和附件不受影响；3) 财务状态不被非法改变；4) 通知到正确处理人。","流程级验证：员工提交报销 -> 审批人转审 -> 新审批人审批 -> 财务查看台账 -> 检查历史和通知。",node|bash|manual,TODO,TODO,TODO,server/src|client/src|server/scripts,"[""WF8-2""]",不得改变付款状态机。 WF8-5,报销转审复核,"复核既有报销转审能力，补齐权限、历史或通知缺口。","1) 报销转审符合权限；2) 发票和附件不受影响；3) 财务状态不被非法改变；4) 通知到正确处理人。","流程级验证：员工提交报销 -> 审批人转审 -> 新审批人审批 -> 财务查看台账 -> 检查历史和通知。",node|bash|manual,TODO,TODO,TODO,server/src|client/src|server/scripts,"[""WF8-2""]",不得改变付款状态机。
WF8-6,通知失败可追溯,"补强企业微信、站内和可选邮件通知失败的追踪口径。","1) 发送失败有摘要和错误类型；2) 不打印 token 或手机号；3) 业务流程不因非关键通知失败误完成；4) 可人工排障。","流程级验证：模拟通知失败 -> 检查通知记录或日志摘要 -> 确认业务状态和错误提示可解释。",node|manual,TODO,TODO,TODO,server/src|scripts/qa|docs/试运行与自动化验证手册.md,"[""WF8-1""]",遵守只读审计和敏感字段脱敏。 WF8-6,通知失败可追溯,"补强企业微信、站内和可选邮件通知失败的追踪口径。","1) 发送失败有摘要和错误类型；2) 不打印 token 或手机号；3) 业务流程不因非关键通知失败误完成；4) 可人工排障。","流程级验证：模拟通知失败 -> 检查通知记录或日志摘要 -> 确认业务状态和错误提示可解释。",node|manual,TODO,TODO,TODO,server/src|scripts/qa|docs/试运行与自动化验证手册.md,"[""WF8-1""]",遵守只读审计和敏感字段脱敏。
WF8-7,邮件通道决策记录,"决定邮件通道是否进入当前验收，若不进入则冻结并说明替代通知通道。","1) 邮件是否验收有明确结论；2) 不影响企业微信和站内通知验收；3) 冻结原因可追溯；4) 后续解锁条件清楚。","流程级验证：人工核对需求规约和 Issue Notes 中邮件通道决策。",manual,TODO,TODO,TODO,docs/需求-统一审批中心规约.md|issues/2026-05-13_18-23-52-wf8-approval-notification.csv,"[""WF8-1""]",默认不因邮件通道阻塞企业微信个人应用消息验收。 WF8-7,邮件通道决策记录,"决定邮件通道是否进入当前验收，若不进入则冻结并说明替代通知通道。","1) 邮件是否验收有明确结论；2) 不影响企业微信和站内通知验收；3) 冻结原因可追溯；4) 后续解锁条件清楚。","流程级验证：人工核对需求规约和 Issue Notes 中邮件通道决策。",manual,DONE,DONE,DONE,docs/需求-统一审批中心规约.md|issues/2026-05-13_18-23-52-wf8-approval-notification.csv,"[""WF8-1""]",邮件通道当前冻结，不作为 WF8 硬门禁；站内通知和企业微信个人应用消息继续验收；解锁条件已写入规约和本 Notes。
WF8-8,三渠道通知验收设计,"设计站内、企业微信个人应用消息和邮件或冻结替代通道的三渠道验收口径。","1) 三渠道或二渠道加冻结说明清楚；2) deeplink 回 OA；3) 缺配置时 SKIP 不等于 PASS；4) 真机和公网边界明确。","流程级验证：人工审查通知矩阵；必要时执行 live readiness 和企业微信真机验证。",manual|bash|playwright,TODO,TODO,TODO,docs/试运行与自动化验证手册.md|docs/需求-企业微信基础设施规约.md,"[""WF8-6"",""WF8-7""]","三渠道中的邮件可被决策冻结，但必须说明。" WF8-8,三渠道通知验收设计,"设计站内、企业微信个人应用消息和邮件或冻结替代通道的三渠道验收口径。","1) 三渠道或二渠道加冻结说明清楚；2) deeplink 回 OA；3) 缺配置时 SKIP 不等于 PASS；4) 真机和公网边界明确。","流程级验证：人工审查通知矩阵；必要时执行 live readiness 和企业微信真机验证。",manual|bash|playwright,TODO,TODO,TODO,docs/试运行与自动化验证手册.md|docs/需求-企业微信基础设施规约.md,"[""WF8-6"",""WF8-7""]","三渠道中的邮件可被决策冻结，但必须说明。"
WF8-9,催办和超时提醒回归,"回归既有催办和超时提醒，避免转审或通知增强引入倒退。","1) 催办不改变审批状态；2) 超时提醒不重复刷屏；3) 通知对象正确；4) 历史记录可追溯。","流程级验证：创建待审批任务 -> 触发催办或超时提醒 -> 检查通知和 workflow history。",node|bash|manual,TODO,TODO,TODO,server/src|server/scripts|docs/需求-统一审批中心规约.md,"[""WF8-6""]",AP6 后提醒能力是当前事实。 WF8-9,催办和超时提醒回归,"回归既有催办和超时提醒，避免转审或通知增强引入倒退。","1) 催办不改变审批状态；2) 超时提醒不重复刷屏；3) 通知对象正确；4) 历史记录可追溯。","流程级验证：创建待审批任务 -> 触发催办或超时提醒 -> 检查通知和 workflow history。",node|bash|manual,TODO,TODO,TODO,server/src|server/scripts|docs/需求-统一审批中心规约.md,"[""WF8-6""]",AP6 后提醒能力是当前事实。
WF8-10,审批历史一致性,"确保转审、催办、通过、驳回和通知事件在审批历史中一致展示。","1) 历史顺序清楚；2) 操作人和目标人可解释；3) 不泄露敏感字段；4) PC 和移动展示一致。","流程级验证：提交审批 -> 转审 -> 催办 -> 审批处理 -> PC 和移动查看历史。",playwright|node|manual,TODO,TODO,TODO,server/src|client/src,"[""WF8-3"",""WF8-4"",""WF8-5"",""WF8-9""]",涉及前端需补 typecheck/build。 WF8-10,审批历史一致性,"确保转审、催办、通过、驳回和通知事件在审批历史中一致展示。","1) 历史顺序清楚；2) 操作人和目标人可解释；3) 不泄露敏感字段；4) PC 和移动展示一致。","流程级验证：提交审批 -> 转审 -> 催办 -> 审批处理 -> PC 和移动查看历史。",playwright|node|manual,TODO,TODO,TODO,server/src|client/src,"[""WF8-3"",""WF8-4"",""WF8-5"",""WF8-9""]",涉及前端需补 typecheck/build。
1 ID Title Description Acceptance Test_Method Tools Dev_Status Review1_Status Regression_Status Files Dependencies Notes
2 WF8-0 WF8 连续合同建档 建立审批与通知增强连续型合同，把转审、通知、催办、邮件通道决策、三渠道验收和审批历史一致性放入同一 CSV。 1) 本 CSV 校验通过；2) 文档索引和状态矩阵指向本合同；3) 不进入复杂 BPM 或审批设计器；4) 不改业务代码；5) 执行前确认 ORG8 角色边界。 流程级验证：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-13_18-23-52-wf8-approval-notification.csv；rg -n 'WF8|审批|通知' docs/文档索引.md docs/文档事实源状态矩阵.md issues/README.md。 python3|rg|manual DONE DONE DONE issues/2026-05-13_18-23-52-wf8-approval-notification.csv|docs/文档索引.md|docs/文档事实源状态矩阵.md|issues/README.md [] CSV validator 和索引 rg 均通过；本次仅合同建档和入口登记，未改业务代码，执行前仍需 ORG8 角色边界和方案批准。
3 WF8-1 审批通知需求规约更新 复核统一审批中心规约，把转审、通知失败、催办、deeplink 和邮件通道决策写清楚或确认已覆盖。 1) 审批和通知边界清楚；2) 不引入复杂 BPM；3) 企业微信审批动作回 OA；4) 邮件是否验收有决策。 流程级验证：rg -n '转审|通知|催办|邮件|deeplink|复杂 BPM|审批设计器' docs/需求-统一审批中心规约.md docs/需求-企业微信基础设施规约.md。 rg|manual TODO DONE TODO DONE TODO DONE docs/需求-统一审批中心规约.md|docs/需求-企业微信基础设施规约.md ["WF8-0"] 先事实源对齐再实现。 统一审批中心规约已覆盖转审、通知失败、催办、deeplink、复杂 BPM 和审批设计器冻结；已补 WF8 邮件通道决策；未改 workflow 代码。
4 WF8-2 转审扩展设计 设计请假、采购和报销的转审扩展规则，明确权限、状态、历史和通知影响。 1) 转审发起人和接收人规则清楚；2) 原审批人和新审批人历史可追溯；3) 不造成重复审批；4) 回滚路径明确。 流程级验证：人工审查状态流；rg -n '转审|delegat|reassign|审批历史|workflow' docs/需求-统一审批中心规约.md server/src。 rg|manual TODO TODO TODO docs/需求-统一审批中心规约.md|server/src ["WF8-1"] 涉及 workflow 状态机必须 reviewer。
5 WF8-3 请假转审 实现或补强请假审批转审，保证请假流程和团队状态一致。 1) 请假待办可合法转审；2) 被转审人可审批；3) 历史记录完整；4) 团队状态不被错误更新。 流程级验证：员工提交请假 -> 审批人转审 -> 新审批人通过或驳回 -> 检查请假状态和审批历史。 node|bash|manual TODO TODO TODO server/src|client/src|server/scripts ["WF8-2"] 不扩展考勤 API。
6 WF8-4 采购转审 实现或补强采购审批转审，保证采购状态、附件和审批历史一致。 1) 采购待办可合法转审；2) 附件和状态不丢失；3) 重复转审有防护；4) 历史可追溯。 流程级验证：员工提交采购 -> 审批人转审 -> 新审批人处理 -> 检查采购状态和历史。 node|bash|manual TODO TODO TODO server/src|client/src|server/scripts ["WF8-2"] 不引入复杂预算和供应商准入。
7 WF8-5 报销转审复核 复核既有报销转审能力，补齐权限、历史或通知缺口。 1) 报销转审符合权限；2) 发票和附件不受影响；3) 财务状态不被非法改变；4) 通知到正确处理人。 流程级验证：员工提交报销 -> 审批人转审 -> 新审批人审批 -> 财务查看台账 -> 检查历史和通知。 node|bash|manual TODO TODO TODO server/src|client/src|server/scripts ["WF8-2"] 不得改变付款状态机。
8 WF8-6 通知失败可追溯 补强企业微信、站内和可选邮件通知失败的追踪口径。 1) 发送失败有摘要和错误类型；2) 不打印 token 或手机号；3) 业务流程不因非关键通知失败误完成；4) 可人工排障。 流程级验证：模拟通知失败 -> 检查通知记录或日志摘要 -> 确认业务状态和错误提示可解释。 node|manual TODO TODO TODO server/src|scripts/qa|docs/试运行与自动化验证手册.md ["WF8-1"] 遵守只读审计和敏感字段脱敏。
9 WF8-7 邮件通道决策记录 决定邮件通道是否进入当前验收，若不进入则冻结并说明替代通知通道。 1) 邮件是否验收有明确结论；2) 不影响企业微信和站内通知验收；3) 冻结原因可追溯；4) 后续解锁条件清楚。 流程级验证：人工核对需求规约和 Issue Notes 中邮件通道决策。 manual TODO DONE TODO DONE TODO DONE docs/需求-统一审批中心规约.md|issues/2026-05-13_18-23-52-wf8-approval-notification.csv ["WF8-1"] 默认不因邮件通道阻塞企业微信个人应用消息验收。 邮件通道当前冻结，不作为 WF8 硬门禁；站内通知和企业微信个人应用消息继续验收；解锁条件已写入规约和本 Notes。
10 WF8-8 三渠道通知验收设计 设计站内、企业微信个人应用消息和邮件或冻结替代通道的三渠道验收口径。 1) 三渠道或二渠道加冻结说明清楚；2) deeplink 回 OA；3) 缺配置时 SKIP 不等于 PASS；4) 真机和公网边界明确。 流程级验证：人工审查通知矩阵；必要时执行 live readiness 和企业微信真机验证。 manual|bash|playwright TODO TODO TODO docs/试运行与自动化验证手册.md|docs/需求-企业微信基础设施规约.md ["WF8-6","WF8-7"] 三渠道中的邮件可被决策冻结，但必须说明。
11 WF8-9 催办和超时提醒回归 回归既有催办和超时提醒，避免转审或通知增强引入倒退。 1) 催办不改变审批状态；2) 超时提醒不重复刷屏；3) 通知对象正确；4) 历史记录可追溯。 流程级验证：创建待审批任务 -> 触发催办或超时提醒 -> 检查通知和 workflow history。 node|bash|manual TODO TODO TODO server/src|server/scripts|docs/需求-统一审批中心规约.md ["WF8-6"] AP6 后提醒能力是当前事实。
12 WF8-10 审批历史一致性 确保转审、催办、通过、驳回和通知事件在审批历史中一致展示。 1) 历史顺序清楚；2) 操作人和目标人可解释；3) 不泄露敏感字段；4) PC 和移动展示一致。 流程级验证：提交审批 -> 转审 -> 催办 -> 审批处理 -> PC 和移动查看历史。 playwright|node|manual TODO TODO TODO server/src|client/src ["WF8-3","WF8-4","WF8-5","WF8-9"] 涉及前端需补 typecheck/build。