zkxw/docs/superpowers/plans/2026-07-14-oa-approval-checklist.md

OA 审批（钉钉）开发清单

跟踪文件：本清单 · 详细步骤见 2026-07-14-oa-approval-dingtalk.md
设计：docs/superpowers/specs/2026-07-14-oa-approval-dingtalk-design.md
分支：feat/oa-approval-dingtalk
更新：2026-07-14（主链路已通：加签 / 附件控件 / E2E 清单已补；本地需跑 SQL 与手工验收）

图例：[x] 已完成 · [ ] 未开始 ·[~] 进行中

---

Phase A — 数据与解析

• A0 FormCreate 依赖安装 + Spike 页（/#/system/workflow/oa-form-designer-spike）
• A1 supervisor_user_id / leader_user_id（SQL 片段 + 模型 + 用户/部门前后端）
• A2 oa_* 表 DDL（docs/sql/patch_2026-07-14_oa_approval.sql）+ SQLAlchemy 模型
• A3 工作流角色 CRUD API + 预置 GM / CHAIRMAN（ensure）
• A4 审批人解析器 oa_assignee + 单元测试（含主管回退）

Phase B — 应用定义与发布

• B5 分组 / 应用 / 草稿版本 API
• B6 发布校验 oa_publish + publish 接口

Phase C — 运行时引擎

• C7 公式与数据联动 oa_formula + 测试
• C8 引擎发起 / 推进 / 审批任务 API + 测试（含加签 add-sign）

Phase D — 前端壳与配置台

• D9 路由/菜单/API 模块 + 工作流角色页 + 应用列表页
• D10 四步设计器壳 + 基础设置 + 高级设置（表单/流程步进占位，见 E11/E12）

Phase E — 设计器

• E11 表单设计器（FormCreate + 附件控件 oaAttachment + 发布控件字典校验）
• E12 竖向流程树设计器（五种选人 + 或签/会签）

Phase F — 办理中心与收尾

• F13 发起 / 待办 / 已办 / 我发起 / 抄送 / 详情（动态表单 + 时间轴 + 加签）
• F14 旧工作流侧栏隐藏 + E2E 验收清单（2026-07-14-oa-approval-e2e-checklist.md）；手工验收待你勾选

运维提醒

• 本地/测试库已执行 docs/sql/patch_2026-07-14_oa_approval.sql
• 后端重启后用户「直属主管」、部门「负责人 userId」可用

前端界面对照（产品 12 屏）

屏	对应任务	状态
审批管理	D9	[x]
工作流角色	A3 + D9	[x]
基础设置	D10	[x]
表单设计	E11	[x]
流程设计	E12	[x]
高级设置	D10	[x]
发起审批	F13	[x]
待处理	F13	[x]
已处理	F13	[x]
我发起的	F13	[x]
抄送我的	F13	[x]
审批详情	F13	[x]