用户指南 01 · 快速开始

目标：5 分钟跑起来一个可用的工作流系统（前端 + 后端 + 10 个示例流程）。

1. 环境要求

组件	要求
后端（四选一）	Python 3.10+ / JDK 21+（demo）/ Go 1.21+ / Node 18+
前端	Node 18+
数据库	无（demo 用内存仓储）

2. 方式一：一键体验（推荐）

2.1 启动后端（选择你的语言）

语言	仓库	演示站	快速开始
☕ Java	jeeflow-java	:8080	Java 快速开始
🔷 Go	jeeflow-go	:8081	Go 快速开始
🐍 Python	jeeflow-python	:8100	Python 快速开始
🟢 Node.js	jeeflow-node	:8082	Node 快速开始

安装 / 启动 / 测试 / 生产部署的细节在语言指南分区；本页其余流程对所有语言一致（接口规范相同）。

2.2 启动前端

git clone https://github.com/mldong/jeeflow-ui.git
cd jeeflow-ui
npm install
npx vite
# → http://localhost:5173

打开浏览器访问 http://localhost:5173：

1. 右上角确认后端（默认 🐍 Python :8100，可选 Java/Go/Node，CORS 直连）
2. 流程选择下拉 → 选"简单审批流程" → 点 发起
3. 右上角用户切到 组长 → 我的待办出现"上级审批" → 点 同意
4. 流程完成，实例列表状态变"已完成"，点 详情 → 钉钉设计器展示流程图

3. 方式二：直接调 API

不启动前端，用 curl 走完一个流程：

# 1. 发起（自动完成申请节点）
curl -X POST http://localhost:8100/wf/processDefine/startAndExecute \
  -H "Content-Type: application/json" \
  -d '{"processDefineId":1,"operator":"user1"}'
# → {"code":0,"msg":"成功","data":null}

# 2. 组长查待办
curl -X POST http://localhost:8100/wf/processTask/todoList \
  -H "Content-Type: application/json" -d '{"userId":"leader"}'
# → rows[0].id 即任务ID

# 3. 组长同意
curl -X POST http://localhost:8100/wf/processTask/execute \
  -H "Content-Type: application/json" \
  -d '{"processTaskId":"<taskId>","operator":"leader","submitType":1}'
# → {"code":0,"msg":"成功","data":null}

# 4. 查看实例状态
curl -X POST http://localhost:8100/wf/processInstance/detail \
  -H "Content-Type: application/json" -d '{"id":"<instanceId>"}'

4. 试试驳回闭环（核心流程）

user1 发起 → leader 同意 → manager 点"退回"（submitType=6）
  → 第一个任务节点重新执行并强制指派给发起人 → user1 收到新待办
user1 重新提交（submitType=0）
  → leader 再次收到审批
leader 同意 → 流程完成

与 mldong 框架一致：submitType=2（拒绝）会跳结束（实例→45）；submitType=6（退回发起人）保留实例进行中并给发起人建新待办。全枚举见用户指南 03 §3.3。

这就是 jeeflow 的核心业务闭环：发起 → 审批 → 退回发起人 → 重新提交 → 完成。底层机制见设计原理 06。

5. 10 个示例流程

#	流程	演示点
1	简单审批	基础单级审批
2	多级审批	三级串行（组长→经理→总监）
3	决策表达式	amount 变量路由（>1000 经理 / ≤1000 总监）
4	并行分支合并	fork→join
5	并行会签	3 人并行
6	串行会签	2 人依次
7	按比例会签	4 人并行（阈值完成，#nrOfCompletedInstances 表达式）
8	自定义节点	customClass 处理器
9	含驳回流程	两级审批 + 驳回退回
10	混合模式	fork+join+decision+会签组合

6. 下一步

• 学流程定义怎么写 → 02-流程定义
• 学后端 API → 03-后端接入
• 学写扩展（自定义参与者/决策器/拦截器）→ 04-扩展开发