流程配置与使用手册

流程与版本

一个可配置的审批流程。编辑时改的是「草稿」，发布后生成一个不可变的「版本」；已发起的流程实例始终绑定其发起时的版本，后续改动不影响进行中的流程。

流程图、节点与连线

流程的结构。节点表示一个步骤（开始 / 审批 / 子流程 / 结束），连线表示流转方向。

发起者范围与处理人

某个节点允许办理的人员集合。开始节点的发起者范围决定谁可发起；审批节点的处理人决定该步由谁办理。

表单字段

发起流程时需要填写的数据项，支持文本、数字、日期、单选、多选等多种类型。

流程实例、任务与流转记录

流程实例是流程的一次发起；任务是派给某位处理人的待办；流转记录是流程实例上发生的每一步（发起、通过、回退、转交、进入子流程、并行汇合取消等）的时间线。

1. 1

   新建流程

   进入「流程管理」，新建流程并填写名称、描述。新流程处于「草稿」状态。

2. 2

   绘制流程图

   在画布上从左侧拖入「审批节点」或「子流程节点」，用连线把「开始 → 各审批 → 结束」串起来。双击子流程节点可进入其内部继续编排。

3. 3

   设置处理人

   点选开始 / 审批节点，配置发起者范围或处理人。开始节点的发起者范围即可发起此流程的人；审批节点的处理人即该步的办理人。

4. 4

   配置表单字段

   在「表单字段」页添加发起时需填写的字段，设置类型、标题、是否必填、选项与取值范围，并可拖拽排序。

5. 5

   校验并发布

   点击发布，系统会校验流程图合法性（见第九节）。校验通过后生成新版本，流程即可被发起。

6. 6

   发起与办理

   在「我的流程」选择已发布流程并填写表单发起流程；办理人在「处理看板」通过 / 回退 / 转交任务，直到流程结束。 列表中的时限展示、逾期筛选等运行期能力见第十节与第十二节。

处理人来源

审批节点的处理人支持三种来源，在节点的「设置处理人」中选择：

按组织与标签圈定范围

发布时冻结「选了谁」，运行时按最新的组织成员与成员标签解析生效人员——发布后调整成员标签或组织成员会影响运行中的流程。发布校验会拦下没有生效处理人的节点（包括只选了标签但没有成员持有）。

审批策略与办理动作

任意节点可在「设置抄送人」中配置抄送：流程走到相应时机时，被抄送人会收到消息通知，但不产生待办、无需办理。留空表示不抄送。

子流程图内部的开始 / 结束节点不可配抄送；对子流程整体的抄送请配在父流程的子流程节点上。

在开始或审批节点上开启「并行」，办理通过时可一次选择多个下一节点，流程就此「分叉」成多条同时进行的支线；这些支线最终汇聚到同一个「汇合节点」后再继续。

连线可以设置「条件」。发起或办理通过、选择下一节点时，只有满足条件的连线指向的节点才会出现在候选里，从而按表单内容或发起人身份自动分流。不设条件的连线始终可走。

条件引用的字段必须存在且条件形式与字段类型匹配，发布校验会检查；若某次流转所有连出连线的条件都不满足，办理时会提示「无符合条件的下一节点」，请检查各分支条件的覆盖是否完整。

字段均可设为「必填」并拖拽排序；必填项在填写页以红色 * 标记，数字 / 手机号 / 身份证等会显示填写提示。单选 / 多选 / 数字字段还可用于连线的条件分支。

回传字段

发布前系统会校验整张流程图（含子流程），不满足以下规则会阻止发布并给出提示：

• 有且仅有一个开始节点，且至少有一个结束节点。
• 每个审批 / 子流程节点都至少有一条连入的线和一条连出的线。
• 所有节点都从开始节点可达，且都能到达某个结束节点。
• 流程图不能形成循环回路。
• 每个审批 / 子流程节点都必须设置处理人。
• 开启并行的节点必须至少有两条连出的线；其分支必须在结束前汇合到同一节点；同一个汇合节点不能被多个分叉共用。
• 汇合节点的「通过分支数」必须在 1 到其连入条数之间。
• 连线条件引用的表单字段必须存在，且条件形式与字段类型匹配。

发布成功后会生成一个新的不可变版本，进行中的旧流程实例不受影响。

在流程编辑器中为开始节点或审批节点开启逾期时间后，发起人或办理人在推进流程时可设置截止时间。系统取节点级时限与流程总时限中较早的一个作为实际生效截止时间。

任务临近截止或已经来不及时，办理人可以在待办中申请延时，审批通过后新的截止时间生效，而不必让流程直接逾期。前提：在流程编辑器中为开始节点（流程时限）或审批节点（节点时限）开启「申请延时」。

流程发布后，用户与管理员可在不同页面查看发起记录、筛选并打开详情。

列表筛选

表头支持以下筛选（可组合）：

• 发起人：按姓名模糊搜索。
• 发起时间：起止日期范围。
• 当前节点：按节点或「已结束 / 待重新发起」筛选。
• 流程状态：进行中 / 已回退 / 已完成；另可单独勾选已逾期。
• 表单字段：文本模糊、选项多选、日期范围；数字字段支持排序。

「已逾期」筛选含义

「已逾期」可与流程状态组合：例如「进行中 + 已逾期」仅显示当前仍逾期的流程。仅勾选「已回退 + 已逾期」通常无结果，因已回退不参与逾期判定。

任务派达、抄送、延时审批等时刻，系统会向相关人发送通知；点击通知可直达对应任务或流程详情。

微信推送在管理端「微信配置」按空间独立设置，并要求系统对外地址可被微信侧访问；未配置微信或成员未绑定时仅发站内通知。

管理员可以把常用数据导出为表格文件。导出在后台异步生成，不阻塞页面操作，生成后到「导出记录」下载。

空间是数据隔离边界。每个空间拥有独立的用户、组织、流程、接口授权（API 凭证）与微信配置，彼此不可见。

登录与选空间

同一手机号可在多个空间注册（各空间密码可不同）。登录时系统用密码匹配：

• 无匹配 → 提示手机号或密码错误。
• 唯一匹配 → 自动进入该空间。
• 多个匹配 → 进入「选择登录空间」页，点选空间名称后完成登录。

空间管理

空间管理员在「空间管理」页可：

• 查看各空间名称、成员数；新增 / 编辑 / 删除空间（默认空间不可删；非空空间不可删）。
• 左侧选择空间，右侧按角色分组浏览成员，支持按姓名或手机号搜索。
• 对任意成员「登录为 TA」，以该用户视角操作（跨空间）。

微信配置、接口授权均在各自空间内独立维护；对外 API 凭证创建时绑定所在空间，集成方只能访问该空间数据。

管理员可在「用户管理」与「组织管理」侧栏点击「批量导入」，上传 CSV 或 Excel 文件批量创建成员或组织。导入在后台异步执行，进度与历史显示在弹窗内。

成员导入

表头须与模板完全一致：

组织导入

表头须与模板完全一致：

行可乱序提交，系统按依赖关系排序创建；若父组织引用形成环，整批拒绝。

通用规则

• 支持 .csv、.xlsx、.xls，单文件不超过 5MB。
• 全量校验：任一行的错误会导致整批不创建。
• 每用户最多 2 个进行中的导入任务；弹窗内可下载模板、查看历史记录并删除已完成记录。
• 进行中的任务每 3 秒自动刷新状态；完成后列表 / 组织树自动刷新。

面向管理员与集成方：流程发生关键事件时，系统向配置的外部地址发送 POST 请求。入口在流程编辑页的「Webhook」页签；一个流程可配置多个 Webhook，配置对该流程全部版本的流程实例生效。

请求体字段结构与验签代码示例见项目 README「流程级 Webhook」章节。

面向外部系统的 REST 集成接口，用于管理组织与用户、按指定流程发起与查询流程记录。 认证方式为请求头 Authorization: Bearer <JWT>，由集成方使用 app_secret 本地签发。 管理员在 接口授权 页创建 App 并配置模块权限。每个 App 绑定创建时所在空间，仅能访问该空间内的数据。