工作流插件文档

更新时间：2026-05-27

本目录只保留当前代码有效的文档。业务流程开发请优先阅读前后端集成指南，并以请假流程 Leave 示例为模板。

文档目录

1. 整体架构与目录 说明工作流插件、业务模块、前端工作流页面之间的职责边界和当前源码路径。

2. 业务流程前后端集成指南 业务流程接入主文档。重点说明业务页面如何发起审批、后端如何包装工作流启动、审批完成后如何回写业务数据。

3. 后端业务模块接入 后端实体、常量、接口、状态字段、回调接口和上线检查清单。

4. 前端业务模块接入workflowForm/*.ts 自动注册、业务页提交审批弹窗、详情组件和 API 适配。

5. 流程设计与节点配置 业务模块流程设计、发布、条件字段、审批节点、节点 HTTP 回调和审批完成回调。

6. 数据表与排查 业务表和工作流表的关系、关键状态枚举、常见问题排查路径。

请假流程参考路径

• 后端服务：Admin.NET/Admin.NET.Application/Service/Workflow/Leave/LeaveService.cs
• 后端 DTO：Admin.NET/Admin.NET.Application/Service/Workflow/Leave/Dto/LeaveDto.cs
• 业务实体：Admin.NET/Admin.NET.Application/Entity/Leave.cs
• 业务模块常量：Admin.NET/Admin.NET.Application/Const/BusinessModuleConst.cs
• 业务页面：Web/src/views/demo/leave/index.vue
• 工作流详情组件：Web/src/views/demo/leave/LeaveDetail.vue
• 前端工作流表单配置：Web/src/views/workFlow/workflowForm/leave.ts
• 工作流提交弹窗：Web/src/views/workFlow/components/BusinessWorkflowStartDialog.vue

维护原则

• 新业务流程照 Leave 示例开发，不再复制旧文档中的 dataApproval 或手写 businessModuleConfig.ts 注册方式。
• 新业务模块只需要在 Web/src/views/workFlow/workflowForm 新增配置文件，workflowForm/index.ts 会自动聚合。
• 后端业务模块必须通过自己的 submit 接口发起流程，不能让前端直接绕过业务状态校验去调用 /api/workflow/startWorkflow。
• 生产环境不要裸露内部回调接口。示例中的 [AllowAnonymous] 只用于演示，实际项目应增加签名、内网网关或服务间鉴权，或实现 IWorkflowCompletedHandler 通过 DI 处理完成回调。