开源电子作业指导书系统 ESOPS:用 FastAPI、Vue 3 和 MySQL 打通 SOP 管理与工位执行
GitHub 开源地址: github.com/luguoyuanf/…
Gitee 镜像: gitee.com/barping/e-s…
在线体验: esops.cc
使用手册: esops.cc/manual
在制造现场,作业指导书经常以纸张、PDF 或分散的电子文件存在。文件更新后,现场能否及时拿到正确版本?生产任务下发后,员工能否在工位看到对应的作业内容?完成作业后,管理人员能否查到报工记录?
ESOPS 是一个面向生产现场的开源电子作业指导书系统,把产品、SOP、生产订单、排产任务和工位作业连接起来。后台维护作业标准并安排生产,员工通过 Android 或 Web 工位端查看任务、阅读 SOP 并反馈报工。
ESOPS 工作台:集中查看 SOP、产线、终端和排产等信息。
一、从产品到工序,让作业标准有处可管
系统支持维护产品资料和工序,将作业指导内容与产品、工序关联。管理员可以集中组织现场使用的作业资料,减少文件分散保存带来的查找和维护成本。
产品管理:按分类维护产品资料。
二、SOP 编辑、审核与版本管理
工艺人员可以维护工序和作业附件,并提交 SOP 审核。审核通过的内容可以用于后续生产安排;需要调整时,通过版本管理维护变更,让作业标准的更新有迹可循。
SOP 编辑:维护工序与作业附件。界面截图来自项目手册,可能随版本更新。
三、生产订单与排产发布
生产管理人员可以在后台维护生产订单和排产任务,结合产线、工位安排生产。任务发布后,工位端可以获取对应作业内容,让现场员工围绕当前生产任务查看指导。
排产发布:组织生产任务与现场工位。
四、管理车间、产线、工位和终端
现场组织有自己的层级和设备分布。ESOPS 支持维护车间、产线、工位、员工和终端等基础资料,为任务下发和现场执行提供基础。
产线管理:维护现场产线和工位。
终端管理:查看和管理现场终端。
五、工位查看 SOP,作业完成后反馈报工
员工可以在 Android 或 Web 工位端登录,查看当前工位任务和作业指导,并按工序提交报工。管理人员可以在后台查看报工记录和生产进度,让现场反馈回到管理流程中。
Web 工位端:在现场查看任务与作业指导。
报工记录:查询现场反馈的信息。
六、从 SOP 到报工,一条清晰的业务链路
使用时,可以按照以下顺序推进:
- 建立员工、车间、产线、工位和终端等基础资料。
- 建立产品与工序,维护并审核作业指导内容。
- 创建生产订单,配置排产并发布任务。
- 员工在工位终端查看任务和 SOP,完成作业并报工。
- 管理人员在后台查看生产进度和报工记录。
这条链路让后台维护的标准内容与现场执行的生产任务建立联系,也让作业反馈回到后台。
七、技术架构与部署
ESOPS 采用前后端分离和模块化单体架构,公开版本的主要技术组成包括:
- 管理界面:Vue 3、TypeScript。
- 服务端:FastAPI。
- 数据存储:MySQL 5.7、Redis。
- 数据库迁移:Alembic。
- 容器化部署:Docker Compose。
- 工位终端:开源仓库包含 Web 工位端;实体客户端另行提供安装包。
系统提供租户、用户、角色和权限管理能力。业务模块与平台基础能力按模块组织,开发者可以结合实际需求阅读代码、部署和扩展。
首次部署可以从克隆仓库开始:
git clone https://github.com/luguoyuanf/E-SOPS.git
cd E-SOPS
./install.sh
运行前请阅读仓库 README,确认主机、Docker、网络及存储等环境要求。部署脚本会初始化必要的系统数据;配置、升级和备份方法请以仓库当前说明为准。
八、开源范围与项目地址
开源仓库包含管理后台、服务端和 Web 工位端,采用 AGPL-3.0 许可。Android 等实体客户端提供独立安装包,客户端源码不包含在该仓库中;第三方组件和客户端安装包请遵循各自的许可声明。
- GitHub 开源仓库:github.com/luguoyuanf/…
- Gitee 镜像仓库:gitee.com/barping/e-s…
- 官网与在线体验:esops.cc
- 使用手册:esops.cc/manual
如果你正在探索电子作业指导书、生产现场终端或制造数字化应用,欢迎查看项目代码和文档,也欢迎通过 GitHub Issues 交流问题与改进建议。