OA 审批系统 · 用户手册 #
适用版本:SmartChart OA 模块 文档更新:2026-04-26
一、系统简介 #
OA 审批系统是一套轻量级流程审批工具,主要用于:
- 员工发起各类审批(请假、报销、采购等)
- 按预设流程自动流转给相关审批人
- 审批人在线处理(通过、拒绝、转办等)
- 管理后台配置流程和组织架构
系统支持多租户,不同租户(公司/部门)数据完全隔离。
二、页面入口 #
| 页面 | 入口地址 | 适用角色 |
|---|---|---|
| OA 工作台 | /oa/ |
全体员工 |
| 流程设计器 | /oa/designer/ |
系统管理员 |
| 组织架构管理 | /oa/org/ |
系统管理员 |
三、普通员工操作指南 #
3.1 发起审批 #
- 进入 OA 工作台 → 点击顶部「发起申请」按钮
- 在流程列表中选择需要使用的审批流程(如"请假申请"、“费用报销"等)
- 填写表单内容(不同流程有不同的表单字段,如请假天数、事由、金额等)
- 如流程设计支持自选审批人,在表单中选择审批人
- 点击「提交」按钮
提交后,系统会自动将流程推送至审批人。
3.2 审批处理(待我审批) #
- 进入 OA 工作台 → 「待我审批」页面
- 点击任一任务,查看详情(申请内容、流程历史、当前节点等)
- 选择操作:
- ✅ 通过:同意申请,继续流转
- ❌ 拒绝:驳回申请,流程结束
- 🔄 转办:转给其他人处理
- ↩️ 退回:退回给发起人或前任审批人
- ➕ 加签:临时增加其他审批人参与会签
- 如需填写审批意见,可在操作时一并填写
3.3 撤回申请 #
如果审批尚未开始处理,可在「我的申请」页面找到对应申请,点击「撤回」。
3.4 查看历史记录 #
- 「我的申请」:查看自己发起过的所有申请记录
- 「已我审批」:查看自己已处理过的审批记录
- 支持按流程类型、状态、时间范围筛选
四、系统管理员操作指南 #
4.1 流程设计器 #
流程设计器用于配置审批流程的流转规则。
4.1.1 页面布局 #
┌─────────────────────────────────────────────────────────┐
│ 工具栏: [新建] [保存] [发布] [发布新版本] [导出] [导入] │
├──────────────┬──────────────────────────────────────────┤
│ 节点组件 │ 画布 │
│ ───────── │ │
│ ▶ 开始 │ [拖拽节点到画布,用箭头连接形成流程] │
│ ▶ 审批节点 │ │
│ ▶ 会签节点 │ │
│ ▶ 或签节点 │ │
│ ▶ 条件分支 │ │
│ ▶ 并行分支 │ │
│ ▶ 通知节点 │ │
│ ▶ 延时节点 │ │
│ ▶ 智能体节点│ │
│ ▶ 结束 │ │
│ │ │
│ ───────── │ │
│ 流程信息 │ │
│ 名称: xxx │ │
│ UUID: xxx │ │
│ [复制UUID] │ │
└──────────────┴──────────────────────────────────────────┘
4.1.2 设计流程步骤 #
第一步:新建流程
- 点击「新建」按钮
- 输入流程名称和描述
- 开始拖拽节点
第二步:配置开始节点
- 拖拽「开始」节点到画布
- 双击打开配置面板
- 在「表单设计」中添加需要收集的字段(如请假天数、事由、金额等)
- 支持字段类型:文本、多行文本、数字、日期、单选、复选、下拉、人员选择、部门选择、金额等
第三步:添加审批节点
- 拖拽「审批节点」(单人)或「会签节点」(多人)到画布
- 双击配置审批人来源:
- 指定人员:固定选择某人为审批人
- 发起人自选:发起人在提交时自己选择
- 表单字段:从发起人填写的表单中读取(如"部门负责人"字段)
- 设置办理期限(可选)
- 会签节点可设置"多人时全部通过才通过”,或签节点设置"任意一人通过即通过"
第四步:配置条件分支(如需)
- 拖拽「条件分支」节点
- 双击配置路由条件,使用变量语法:
v.xxx— 变量值v.xxx.yyy— 对象属性v.xxx[0]— 数组第一个元素
- 例:
v.amount > 10000表示金额超过1万的走此分支
第五步:保存并发布
- 点击「保存」——保存草稿
- 点击「发布」——正式发布,流程可供使用
💡 提示:发布后如需修改,只能发布新版本,旧版本流程实例不受影响。
4.1.3 节点类型说明 #
| 节点类型 | 用途说明 |
|---|---|
| 开始 | 流程入口,定义发起时需要填写的表单 |
| 审批节点 | 单人审批,指定一个人处理 |
| 会签节点 | 多人依次审批,全部通过才算通过 |
| 或签节点 | 多人审批,任意一人通过即通过 |
| 条件分支 | 根据条件表达式,自动选择下一个节点 |
| 并行分支 | 多条分支同时执行,最后合并 |
| 通知节点 | 向指定人员发送站内消息 |
| 延时节点 | 流程在此节点暂停等待指定时间后再继续 |
| 脚本节点 | 执行一段 Python 代码(用于数据处理) |
| 智能体节点 | 调用 SmartChart 智能体处理复杂逻辑 |
| 数据写入节点 | 将表单数据写入指定数据表 |
| 子流程节点 | 触发另一个审批流程(子流程) |
| 变量节点 | 在流程中设置/修改变量值 |
| 事件节点 | 触发外部系统事件 |
| 结束 | 流程正常结束节点 |
4.1.4 复制流程 UUID #
在左侧面板的「流程信息」区域直接显示该流程的 UUID,点击复制图标即可复制。
UUID 用途:如果需要通过接口(API)发起此流程,需要传入该 UUID。
4.2 组织架构管理 #
入口:OA 工作台 → 右上角「组织管理」(或直接访问 /oa/org/)
4.2.1 租户管理 #
租户是系统中的最高层级隔离单位(如不同子公司、不同部门使用不同租户)。
租户管理仅系统超级管理员可操作,普通管理员无法访问。
4.2.2 角色与权限 #
系统内置 3 个角色,每个角色对应不同权限码:
| 角色 | 权限 | 说明 |
|---|---|---|
| 组织管理员 | org_manage |
管理组织架构(部门、岗位、员工) |
| 员工管理员 | employee_manage |
增删改查员工信息 |
| 任务管理员 | task_manage |
处理审批任务 |
权限码与流程的"启动权限"对应——在设计流程时,可指定只有特定角色的人才能发起该流程。
4.2.3 部门管理 #
- 添加、编辑、删除部门
- 设置上级部门(形成树形结构)
- 部门树形展示,支持按名称搜索
4.2.4 岗位管理 #
- 添加、编辑、删除岗位
- 岗位可设置对应的角色权限
4.2.5 员工管理 #
- 添加、编辑、删除员工账号
- 设置员工所属部门、岗位、直接上级
- 设置员工的兼任部门(一个员工可同时属于多个部门)
- 设置员工角色(决定可访问哪些功能)
员工状态分为在职(ACTIVE)和非在职,离职员工登录后无法使用系统。
五、常见问题 #
Q:发起审批时找不到对应流程? A:请联系系统管理员,确认该流程已发布且您有启动权限(角色匹配)。
Q:审批人被指定了,但看不到待办任务? A:请检查是否登录了正确的租户,或刷新页面重新加载。
Q:可以修改正在运行中的流程吗? A:不可以。流程实例一旦启动,流程定义不可修改。如需变更,需终止旧实例后用新流程重新发起。
Q:员工离职后,其发起的申请怎么处理? A:已发起的申请流程不受影响,正常流转。离职员工账号会被标记为非在职,无法登录。
Q:如何通过接口(API)发起流程?
A:请使用 POST /oa/instance/start/ 接口,请求体格式详见第六章。API 调用方需要持有有效用户身份(cookie 中的 session 或 token)。
六、附录:常用术语 #
| 术语 | 解释 |
|---|---|
| 流程定义(FlowInfo) | 流程的模板/配置,决定流程如何流转 |
| 流程实例(FlowInstance) | 某次具体的申请,从发起开始到结束 |
| 流程任务(FlowTask) | 流程中每个节点的待办事项 |
| 租户(Tenant) | 数据隔离单位,对应一个公司或部门 |
| 变量(Variable) | 流程中的动态数据,可用于条件判断 |
| 会签 | 多个人都要审批,全部通过才算通过 |
| 或签 | 多个人中任意一人审批通过即可 |
| 转办 | 将任务转给其他人处理 |
| 退回 | 将流程退回到之前某个节点重新处理 |
如有更多问题,请联系系统管理员。