审批流与任务中心

审批流由定义、发布版本、申请、任务和实例组成。修改草稿并发布新版本只影响新申请，已有实例继续使用固定的发布版本。

启用入口

首次安装先执行完整迁移与种子。审批菜单默认禁用，也不会自动向现有角色授予权限；在菜单和角色管理中启用所需入口并授权。

入口	页面路径
流程定义	/workflow/definitions
新建定义	/workflow/definitions/new
任务中心	/workflow/center

设计、发布、发起、处理和运营是不同能力，按角色的实际职责分配。

完成一次审批

1. 创建定义草稿，配置表单、节点和选人方式。
2. 执行校验与预览，确认后发布。
3. 从任务中心选择可发起的流程，填写申请并提交。
4. 办理人在本人待办中打开任务，按页面当前允许的动作处理。
5. 查看实例状态与业务结果。

角色、部门和审批组决定候选范围；实际办理仍会核对当前账号与任务席位。曾经参与过流程，不代表始终保有处理权限。

公告审批

公告需要显式绑定已发布的流程定义和版本，申请页选择当前公告修订。绑定后的约束也作用于 HTTP 与 Agent 直接写入。停用定义或绑定不会自动解除在途实例的约束停用流程定义或解除绑定，不会自动解除在途实例的约束。

通知与后台执行

审批任务执行和通知 Outbox 分别由 WORKFLOW_WORKER_ENABLED、WORKFLOW_OUTBOX_ENABLED 控制。消息已读和“已处理”标记不等于审批决定；消息延迟时仍可在任务中心查看当前任务。

关闭新发起、停用定义、挂起实例、停止 worker 是不同操作。开发环境排查时先确认所用开关与实例状态，再检查后台日志。

业务开发边界

独立应用的自定义流程动作通过 typed 扩展合同接入，可参考回执扩展。不要从应用直接导入核心工作流 service 实现。

命令超时后保留原 request_id 和原参数，通过回执查询或重试确认结果；生成新请求键可能产生新的操作。页面按服务端 allowed_actions 展示动作，不根据历史状态自行恢复按钮。

进一步阅读自定义扩展与接口约定。