工作流操作手册

💡 第一次用？ 文档里会频繁出现「或签 / 会签 / 依次审批」「审批节点 / 抄送节点」「转办 / 委托」等名词。如果不确定它们是什么意思，先读《名词术语表》，每个概念都有大白话解释 + 场景举例 + 对比表格。

一、功能导航

登录系统后，在左侧菜单进入「工作流」模块，包含以下菜单：

菜单	作用	主要使用者
流程定义	设计、发布、管理审批流程	流程管理员
表单模板	保存可复用的表单，供流程引用	流程管理员
发起申请	选择流程，填写表单提交	所有用户
我发起的	查看自己提交的申请及进度	所有用户
待办	处理需要我审批 / 抄送确认的事项（支持批量通过）	审批人
已办	查看我已处理过的事项	审批人
抄送我的	查看抄送知会我的事项	所有用户
审批记录	查看某条申请的完整审批轨迹	所有用户
数据面板	待办 / 效率等统计视图	管理人员

---

二、流程管理员：设计一条流程

1. 新建流程

1. 进入「流程定义」→ 点击「新增」。
2. 填写基本信息：
   • 流程名称、流程编码（可一键生成）、分类、图标等。
3. 进入设计器，开始绘制流程。
4. （新手推荐）选个示例模板起步：新增时可直接选用内置模板，自动搭好骨架（节点名 + 结构），审批人留空待你补全：
   • 通用审批：发起 → 直属主管审批 → 结束
   • 请假审批：直属主管 → 部门经理 → 人事抄送
   • 金额条件分支：直属主管 → 金额≥1万走「总经理审批 / 财务抄送」分支
   • 并行会签：多部门并行审批、汇合后结束
   • 加签演示：主管审批后由主管加签总监
   • 模板对两种设计器模式（见下）都适用。

2. 绘制流程（图形化设计器）

流程定义提供两种设计器，效果等价、可互相切换（保存的数据结构完全一致）：

• LogicFlow（自由画布）：拖节点、拉连线、菱形网关、dagre 自动布局，接近"画流程图"，适合熟悉流程图画法的人。
• Simple（简单式 / antflow 卡片流）：纵向从上到下叠卡片的"审批链"形态，节点下方点「+」即可插入节点、自动连线，无需画连线；属性在右侧抽屉面板配置；自带撤销/重做、缩放、「N 个节点待完善」完整性提示。适合新手快速配审批链，也最受业务人员欢迎。 下面的节点说明两种模式通用；连线在 Simple 模式下自动生成。

• 从左侧节点面板拖拽节点到画布（LogicFlow）；或点节点下方「+」插入节点（Simple）：
  • 开始：流程起点（每个流程一个）。
  • 审批：需要某人 / 某角色审批的节点。
  • 抄送：知会相关人，不阻塞流转。
  • 条件：根据表单数据自动选择下一步走向（菱形网关）。
  • 并行分叉 / 汇聚：多分支同时审批，全部完成再继续。
  • 结束：流程终点。
• 鼠标悬停节点 → 拖出连线到下一节点，建立流转关系（LogicFlow）；Simple 模式自动连线。
• 顶部工具栏可自动布局、放大 / 缩小、下载流程图 PNG（LogicFlow）；Simple 模式提供撤销 / 重做 / 缩放 / 完整性徽标。

3. 配置节点属性

点击节点，右侧弹出属性面板：

• 审批人：
  • 指定用户（直接选人）
  • 指定角色（选角色，该角色成员均可审批）
  • 指定部门
  • 表单字段（从申请人填写的表单中某个"人员"字段动态取审批人）
  • 部门负责人 / 发起人主管（系统自动找人，找不到时自动跳过）
• 多人审批方式（一个节点配多人时）：
  • 或签：任一审批人通过即通过。
  • 会签：需全部审批人通过。
  • 依次审批（顺序会签）：按审批人顺序逐个审批，前一人审完才轮到下一位；全部通过才推进，任一驳回则整节点驳回。
• 审批人为空时（兜底）：当所选审批人来源最终解析不到人时，可选择「自动通过（节点自动跳过）」或「指定默认审批人」。
• 超时处理（可选）：为该节点设置「超时时长（小时）」与「超时动作」——超时后系统自动通过 / 驳回 / 转交指定人，无需人工干预。
• 驳回策略（节点被驳回时退回哪里）：
  • 驳回发起人（默认）：整条流程打回给申请人，实例置"驳回"，申请人改完可重新提交（从头重走）。
  • 驳回到上一节点：退回上一个审批节点重新审，流程保持"审批中"，不回申请人（如「主管→经理→总监」中经理驳回，则退回给主管重审，总监待办取消）。
• 并行组：把多个审批节点设为同一组，实现"包容网关"语义（同组同时激活）。画布生成方式：在节点间的连线中点或「+」菜单里选「并行」，即可把该处拆成并行分支入口；再为要并行的若干审批节点设置相同的「并行组」编号，引擎在入口自动分叉、结尾自动汇聚，会等最慢分支完成。

4. 配置条件分支

1. 拖入「条件」节点，从它连出多条线。
2. 点击每条连线，设置条件（基于表单字段与运算符，如 金额 > 5000）。
3. 流程运行时按条件自动走对应分支；都不满足则走默认分支。

5. 设计表单

• 在流程设计的「表单」页，从控件库拖入字段（输入框、多行文本、数字、下拉、单选、日期、图片、文件、人员、部门、明细表等）。
• 每个字段可配置：标题、字段名（自动生成）、是否必填、校验规则（长度 / 正则，手机号 / 邮箱 / 身份证 / 金额等常用预设）、占位提示、默认值等。
• 支持「展示型」控件（说明文字、分割线、分组标题），仅用于排版、不落库。
• 明细表：可插入可增删行的子表（如报销明细），列支持文本 / 数字 / 日期 / 下拉 / 人员，数字列可配底部合计与行内公式。
• 字段联动：按其他字段的值联动显隐（等于 / 不等于 / 为空 / 包含 / 大于 / 小于等运算符）或联动计算（数字字段按公式自动重算）。
• 系统字典绑定：下拉 / 单选 / 多选可直接绑定系统字典作为选项来源，免手工维护。

6. 保存与发布

• 设计完成后点击「保存」。
• 发布：将草稿转为正式版本，员工方可发起。
• 支持多版本：可另存新版本、回滚历史版本、复制为独立流程。
• 版本对比：选择基准版本与对比版本，按节点对齐比较类型 / 审批人 / 会签类型 / 并行组等，标色展示新增 / 移除 / 修改。

---

三、表单模板（可选）

进入「表单模板」→ 设计一套表单并保存，后续新建流程时可直接引用，避免重复搭建。

---

四、普通用户：发起申请

1. 进入「发起申请」。
2. 选择要发起的流程（仅显示已发布的流程）。
3. 填写表单（带 * 为必填），可上传图片 / 附件。
4. 点击「提交」，流程按设计自动流转。
5. 提交后可在「我发起的」查看实时进度（流程图高亮当前节点）。
6. 催办：流程审批中若长时间未处理，可在「我发起的」对该申请发起催办（每 24 小时对同一申请限一次），提醒当前审批人。

---

五、审批人：处理待办

1. 进入「待办」，列表显示需要你处理的事项。
2. 点击某条进入详情：
   • 上方为流程图，高亮当前所处节点。
   • 中部为申请内容（表单填写值）。
   • 下部为审批记录与评论。
3. 操作按钮：
   • 通过：同意，流转到下一节点。
   • 驳回：驳回到发起人，需重新提交。
   • 转办：转交给他人处理（不能转给自己）。
   • 委托：把本节点委托他人代审（任务仍归属你，代审人凭委托代为通过/驳回）。
   • 加签：临时增加审批人，其通过后原审批人再处理。
   • 减签：移除本节点某位加签/会签待审批人（仅节点审批人可操作）。
   • 评论：添加批注，供他人查看。
4. 处理完的事项进入「已办」。
5. 批量审批：在「待办」列表勾选多条可一次性批量通过。

多人审批说明

节点配了多个人时，用「签类型」决定"怎么算通过"。四种签类型的区别（更详细对比见《名词术语表》§二）：

• 或签：任一审批人通过后即通过。例如节点审批人是「张总, 王总, 李总」或签 —— 张总先点通过，流程立刻继续，王总/李总的待办自动消失。
• 会签：需所有审批人都通过。例如「法务, 财务」两会签 —— 法务通过后流程不前进，继续等财务；两人都过才进入下一关；任一人驳回则整节点打回发起人。
• 依次审批：按设置顺序逐个审批，前一人审完自动轮到下一位，直至末位；任一驳回则整节点驳回。与"会签"不同，会签是大家同时收到待办，依次审批是强迫按顺序、前面不审后面看不到。
• 比例会签：多人同时激活，达到节点设定比例（如 60%）的审批人通过即推进，不要求全员一致；需配合 PassRatio（通过比例 0~1）使用。适合委员会 / 多人表决"过半即生效"场景。
• 同一节点其他待办会自动跳过，避免重复处理。

四种签类型一眼对比：

签类型	通过条件	待办是否同时出现	一人驳回
或签	任一通过	是	整节点驳回
会签	全部通过	是	整节点驳回
依次审批	全部通过（按序）	否（排队）	整节点驳回
比例会签	通过人数 ≥ 设定比例（如 60%）	是	不影响"达比例即过"判定

---

六、抄送与记录

• 抄送我的：被设为抄送人的事项汇总于此，仅供查看、不阻塞流程。
• 审批记录：任意申请可查看完整流转轨迹（谁在何时通过 / 驳回 / 转办 / 评论）。

---

七、数据面板

进入「数据面板」查看：

• 待办 / 已办 / 我发起 / 抄送 数量概览。
• 平均审批时长、各节点耗时分布、完成率趋势（口径为"我作为申请人"的实例）。

---

八、常见问题

Q：提交后流程没动 / 卡住了？ A：通常是某个审批节点解析不到审批人。若配置了"部门负责人 / 发起人主管"但系统中未配置对应人员，该节点会自动跳过；若使用"指定用户 / 角色"请确保已正确选人且角色下有人。

Q：驳回后怎么继续？ A：被驳回的申请回到「我发起的」，状态为"已驳回"，可修改后重新提交，回到首节点重新审批。

Q：能下载流程图吗？ A：可以。在流程设计器顶部工具栏点击「下载流程图 PNG」。

Q：条件分支怎么设？ A：拖入"条件"节点，从它连出多条线，在每条连线上设置基于表单字段的条件即可。

Q：节点超时了会怎样？ A：若该节点配置了"超时处理"，到时间后系统按设定自动通过 / 驳回 / 转交指定人，并写入审批记录，无需手动处理。未配置则一直等待人工审批。

Q：我临时没法审批，能找人代审吗？ A：可以。在待办详情点「委托」选代审人，任务仍归属你，代审人代为处理后记录会注明"（代 X 审批）"。若想让他人以后改由对方直接负责，可用「转办」。

Q：加签的人不合适，能去掉吗？ A：可以。在待办详情点「减签」移除该加签 / 会签待审批人（仅节点审批人可操作）。

Q：流程改过好几版，怎么看改了什么？ A：在「流程定义」的版本历史里选两个版本做「版本对比」，会标色展示节点的新增 / 移除 / 修改。

---

九、AI 智能能力

工作流内置 AI 助手，覆盖设计 → 审批 → 治理全流程。能力来自后端 WfAiService（WfAiController，路由 workflow/ai/*），需服务端配置 AiOptions（见下「配置」）。 所有 AI 调用的提示词（prompts）由后端目录统一管理，可在 appsettings.json 的 AiOptions.PromptDir 指定（留空取程序基目录 Prompts/ 子目录）。当前包含：approval-suggest.md（审批建议）、risk-check.md（风险检查）、flow-generate.md（流程生成）等。

1. 自然语言生成流程（设计助手）

• 入口：流程设计器顶部「AI 生成」按钮 → 弹出对话框（AiGenerateDialog.vue）。
• 怎么用：用一句话描述业务，例如「员工请假 3 天以内直属主管审批，超过 3 天加部门经理审批，最后人事备案」。AI 会返回：
  • 一个完整的流程定义草稿（含节点、连线、审批人来源、签类型、条件分支等）；
  • 还自动推断所需表单字段（请假类型 / 天数 / 事由等），并给出「采纳表单」选项。
• 采纳：勾选「采纳流程定义」→ 直接覆盖进当前设计器（Simple / LogicFlow 皆可）；勾选「采纳表单」→ 同时把推断字段合并进表单定义。采纳后建议用设计器再审视一遍审批人是否准确。
• 模型温度 = 0.2（低随机，保证结构稳定）。

提示：AI 生成的流程是"起点"不是"终点"。它擅长搭骨架，但审批人来源（尤其指定用户/角色）务必人工核对后再发布。

2. 审批智能建议（审批助手）

• 入口：待办详情页的「AI 建议」按钮（调用 workflow/ai/approval-suggest）。
• 输入：当前节点名 + 申请人填写的表单内容 + 流转路径；可选附上一句"批示语"。
• 输出：AI 生成的审批参考意见（通过/驳回的措辞建议），审批人可一键采纳到审批意见框，再自行点「通过/驳回」。
• 适用：大段表单（如报销明细）快速抓住重点，辅助决策，最终仍由人拍板。

3. 审批摘要（记录助手）

• 每次审批动作（通过/驳回/转办…）时，引擎在流转事务后台自动生成 AI 摘要（temperature 0.3），把「动作 + 节点 + 意见 + 表单」压缩成一句话，落库在一条 Action=0（系统生成）的 WfFlowRecord 上（AiSummary 字段），与人工审批记录并列展示，便于在「审批记录」里快速回看上下文。该能力无独立前端按钮，摘要随审批动作自动生成。
• 查看 / 重生成：实例详情页「AI 摘要」卡片展示整条实例的连贯摘要（按时间拼接各节点摘要）。若不满意，可点「重新生成摘要」调用 workflow/ai/instance-summary/{instanceId}?regenerate=true，以完整全量记录重新汇总（忽略已有的局部摘要），一次性产出整条审批链路总结。

4. 流程体检（治理助手）

• 入口：流程定义详情的「AI 体检」（workflow/ai/flow-analyze）。
• 输出：对当前流程做合规性/合理性体检，常见检查点如：
  • 是否缺少结束节点、是否有孤立节点；
  • 条件分支是否覆盖默认分支（避免死路）；
  • 审批人来源是否为空 / 是否会解析不到人；
  • 并行汇聚是否配对。
• 体检结果会列出问题点，帮助在发布前消灭"发布后才发现跑不通"的坑。

5. 自然语言填单（发起助手）

• 入口：发起申请页的「AI 帮我填」（workflow/ai/match-fill）。
• 怎么用：把业务诉求（如"我要请 3 天病假，因为感冒"）贴进去，AI 自动抽取字段并回填到对应表单控件（请假类型=病假、天数=3…），用户确认即可提交，省去逐项手填。

6. AI 风险检查（审批卫士）

• 入口：待办详情页的「AI 风险检查」按钮（workflow/ai/risk-check/{taskId}）。
• 作用：基于当前节点 + 表单内容 + 流转路径，AI 研判本次审批是否存在风险点（如金额与历史偏差、字段缺失、越权、合规冲突等），给出风险等级 + 风险说明 + 处置建议，辅助审批人谨慎拍板。结果仅在审批端展示，不影响流程流转。
• 提示词由 ZR.Admin.WebApi/Prompts/risk-check.md 统一管理（与 approval-suggest.md 分离，便于分别调优）。

7. 智能建议重生成

• 审批建议（approval-suggest）与实例摘要均支持「重新生成」：workflow/ai/approval-suggest/{taskId}?regenerate=true 与 workflow/ai/instance-summary/{instanceId}?regenerate=true。重生成会忽略之前缓存的建议/局部摘要，用更完整的上下文重新调用模型，适合首次结果不理想时二次生成。

AI 各能力的入口、接口、提示词与配置详见《AI 工作流专栏》。

配置（管理员）

在 ZR.Admin.WebApi/appsettings.json 的 AiOptions：

"AiOptions": {
  "Enable": true,            // false 则前端隐藏所有 AI 入口
  "Endpoint": "https://...", // 大模型推理端点
  "ApiKey": "xxx",           // 服务商密钥（生产建议用环境变量覆盖，勿明文提交）
  "Model": "gpt-4o-mini",   // 模型名
  "PromptDir": "",           // AI 提示词目录；留空取程序基目录 Prompts/
  "Providers": [ ... ]       // 多供应商兜底配置
}

• Enable=false 时，前端 AI 按钮自动隐藏，不影响任何现有流程功能。
• 密钥建议通过环境变量 / UserSecrets 注入，不要明文提交到仓库。

---

更多技术细节与能力规划，见《功能清单与演进路线》《工作流引擎设计文档》。