# open-wes

**Repository Path**: pigTear/open-wes

## Basic Information

- **Project Name**: open-wes
- **Description**: Open WES 是一个可定制的开源仓库执行系统，旨在简化仓库操作。它与各种自动化技术无缝集成，提供高效的工作流程管理和任务调度，同时简化用户操作。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://openwes.top
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 4
- **Created**: 2024-12-12
- **Last Updated**: 2025-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, warehouse, execution-system, customization

## README

# 开源仓库执行系统 (Open WES)

[English](README.md) | [中文](#README_CN.md) | [日本語](README_JP.md)

**Open WES** 是一款可定制化的开源仓库执行系统，旨在优化仓储运营流程。该系统能与各类自动化技术无缝集成，提供高效的工作流管理、任务调度和实时数据追踪功能。


## 核心功能

- **任务管理**：高效统筹仓储作业优先级
- **实时监控**：动态追踪库存、设备与工作流状态
- **模块化设计**：轻松对接现有仓储管理系统
- **规则定制**：灵活配置任务分配、分拣路径等策略
- **开放API**：支持RESTful与WebSocket双协议交互
- **智能优化**：基于AI算法实现运营优化、需求预测与自动化决策

## Docker Compose快速部署指南

### 环境准备

请确保已安装以下组件：
1. **Docker**：[安装指南](https://docs.docker.com/get-docker/)
2. **Docker Compose**：[安装指南](https://docs.docker.com/compose/install/)

### 30秒极速启动

执行以下命令即可完成部署：
```bash
git clone https://github.com/jingsewu/open-wes
cd open-wes
HOST_IP=$(hostname -I | awk '{print $1}') docker-compose up -d
```

## 方案对比
| **对比维度**       | **Open-WES**                                                                 | **传统WMS系统**                                                             |
|--------------------|------------------------------------------------------------------------------|---------------------------------------------------------------------------|
| **核心定位**       | 实时协调仓储工作流与自动化设备                                               | 库存追踪与订单管理等宏观管控                                              |
| **自动化集成**     | 原生支持机器人、AGV、物联网等实时系统                                        | 需定制开发中间件对接                                                      |
| **开源协议**       | MIT开源许可，社区驱动开发                                                   | 闭源商业软件，存在授权费用                                                |
| **定制能力**       | 全代码可修改，深度适配业务场景                                               | 依赖供应商配置功能                                                        |
| **成本结构**       | 零授权费用，仅需基础运维成本                                                | 高昂的许可费+年度维护费                                                   |
| **扩展性**         | 模块化架构随业务自动扩展                                                    | 受限于供应商产品路线图                                                    |
| **实时处理**       | 动态优化任务分配（如订单优先级调整）                                        | 基于批处理的延迟响应                                                      |
| **部署方式**       | 支持云原生/混合部署                                                         | 通常为本地化部署                                                          |
| **系统对接**       | 提供现代API（ROS/IoT/微服务）                                               | 传统接口，对接成本高                                                      |
| **用户界面**       | 开发者友好型，支持前端框架定制                                              | 固化UI界面                                                                |
| **技术支持**       | 社区支持+可选商业服务                                                       | 付费技术支持（响应滞后）                                                  |
| **适用场景**       | 高自动化仓储、需要实时调度的电商/3PL                                        | 低自动化水平的传统仓储                                                    |
| **系统透明度**     | 全代码可审计                                                                | 黑箱操作                                                                  |

---

### **核心差异**：
1. **自动化导向**：Open-WES专为机器人、物联网等实时场景设计，传统WMS侧重基础库存管理
2. **成本优势**：开源模式节省90%以上软件授权费用
3. **灵活扩展**：可对接定制化设备（如特种机器人、AI排产系统）
4. **响应机制**：Open-WES实现秒级动态响应，传统系统依赖定时批处理

### **Open-WES适用场景**：
- 需要协调**机器人集群**或**物联网设备**
- 追求**成本控制**与**流程定制**
- 向**工业4.0**智能仓储转型

### **传统WMS适用场景**：
- 需要**开箱即用**的基础仓储功能
- 现有**低自动化**作业环境
- 偏好**供应商托管**服务

详细案例参见[官网演示](https://www.openwes.top/)

### 贡献指南

我们欢迎社区贡献来帮助改进此项目。贡献方式如下：

1.  Fork 项目仓库。
2.  为新功能或问题修复创建分支。
3.  提交代码更改并提交 Commit。
4.  提交 Pull Request，详细说明更改内容及解决的问题。

详细说明请参考 [贡献指南](CONTRIBUTING.md)。

* * *

### 许可协议

本项目基于 [MIT 许可证](LICENSE)。

* * *

### 联系我们

如有任何问题或需要帮助，请通过以下方式联系我们：

*   **GitHub Issues**：提交问题或请求功能。

感谢您使用和贡献 Open WES！

* * * 
### 架构设计

Open WES 的架构采用模块化和可扩展设计，可应对复杂的仓库操作。以下是其组件的高层概览：

**架构图**

![Architecture](server/doc/image/architecture.png)

* * *

### 获取帮助

如遇到问题或有任何疑问，请查看以下资源：

*   **[GitHub Issues](https://github.com/jingsewu/open-wes/issues)**：提交问题或请求新功能。
*   **[文档](https://docs.openwes.top)**：查找详细指南和 API 文档。