README_zh_Hans.md · 智锋科技/GreaterWMS_2

# 聚商汇WMS--开源仓库管理系统

---

## 项目介绍：

完全开源仓储管理软件，遵循Apache License 2.0协议，前后端分离，且完全开源，API使用restful协议，方便二次开发，前端代码使用quasar进行构建，后端使用Python Django3.1，利用API，可以支持多仓，波次发货，合并拣货，Milk-Run等业务模型。

- 软件著作权编号：2018SR517685
- GitHub地址：[GitHub](https://github.com/Singosgu/GreaterWMS)
- Gitee地址：[Gitee](https://gitee.com/Singosgu/GreaterWMS)
- 视频教程：[B站](https://space.bilibili.com/407321291/channel/detail?cid=152043)(所有的教程都会更新在这里)
- Demo地址：[DEMO](https://www.56yhz.com/)(注册会获得初始化Demo数据)
- 微信：![img_1.png](Wechat.png)
- 邮箱：mail@56yhz.com
- CIMO-ADMIN(vue-quasar-manage): [GitHub](https://github.com/972784674t/vue-quasar-manage) | [Gitee](https://gitee.com/incimo/vue-quasar-manage)

---

## 项目初衷：

我在供应链行业工作了15年，发现在我们这个专业的领域，没有一款高自由度、高自定义化的软件，来深度支持我们企业的业务。大多数软件都是闭源的，而且很难去做二次开发，即使开发，周期也是非常长，开发失败的案例也是比比皆是。由于企业选择了一款软件后，其二次开发也会被开发公司绑定，至于二次开发费用，只能说呵呵。所以，我设计了这个聚商汇WMS，为的是做到一款高自由度，高自定义开发的仓库管理软件，来深度支持企业的业务。

- 愿景：如果你从事着非IT行业的工作，而你又热爱你的行业，那就用科技去改变他。

---

## 生命周期

- V 1.0.0 -- 2019年7月 ~ 2020年12月（由于1.0.0版本的二次开发设计较为复杂，故2.0重新编写）
- V 2.0.0 -- 2020年12月 ~ 2021年3月（重新编写业务逻辑，原生自带API开发文档，加入实时通信，方便企业用户互相沟通）
- V 2.1.0 -- 2021年3月 ~ 2021年6月（加入了客户与企业之间的实时互动，增进企业与客户之间的业务联系，实现VMI）
- V 2.2.0 -- 2020年6月 ~ 2021年9月（加入了供应商与企业之间的实时互动，增进企业与供应商之间的业务联系，实现Milk-Run和看板拉动）
- V 2.3.0 -- 2021年9月 ~ 2021年12月（库存管理雏形，初步加入神经网络，深度学习库存变化）
- V 3.0.0 -- 2021年12月 ~ 2022年3月（完全植入神经网络，让上下游企业可以以最低的成本运营整体的业务）
- V 3.1.0 -- 2022年3月 ~ 2022年6月（区域仓库业务布局，通过深度学习，实现多仓运营，成本最低化）

---

## 开发环境：

- Python 版本为 V 3.8.0 +

- Django 版本为 V 3.1.0 +(该版本Django才原生支持异步实时通信)

- Django-rest-framework 版本为 V 3.12.2 + (更高版本的Django-rest-Framework对Django3的兼容比较好)

- Django-silk 版本为 V 4.1.0 (如果是部署上线，请关闭silk，silk仅为调试API接口速度用，有可能会泄露用户信息)

- Quasar 版本为 V1.7.2 + (可以查看Quasar官网，来编辑GreaterWMS前端代码：[Quasar官网](http://www.quasarchs.com/))

- Vue 版本为 V 2.6.0 +（尽量不要使用Vue3，因为开发环境没有使用Vue3，不知道会出现什么问题）
- API，遵循 RESTful 架构

---

## 构建命令：

- 下载代码：

~~~shell
git clone https://github.com/Singosgu/GreaterWMS.git
~~~

- 安装Python库：

~~~python
pip install -r requirements.txt
~~~

注意：`安装需要Twisted库，这个库有时候会安装不上，需要下载下来本地安装`

- 下载地址：[TWISTED](https://www.lfd.uci.edu/~gohlke/pythonlibs/#twisted)

~~~python
pip install Twisted{你下载下来的版本名称}
~~~

注意：`本地安装需要注意路径`

- 初始化数据库：

~~~python
python manage.py makemigrations
~~~

- 迁移数据库：

~~~python
python manage.py migrate
~~~

创建数据库，Django默认使用sqlite3作为数据库，如果需要mysql数据库，请在greaterwms/settings.py里面配置DATABASE

### 开发服务器运行：

- 开发运行：

~~~python
daphne -p 8008 greaterwms.asgi:application
~~~

### 生产服务器运行：

- supervisor守护进程：

~~~shell
pip install supervisor
~~~

使用supervisor来守护Django进程，再使用Nginx做反向代理，至于superevisor的教程有很多，这里不做讲解

- Nginx支持：

推荐使用Nginx进行部署，部署的时候需要指定WebSocket链接，如果不指定，实时通信功能将报错

另需要修改从2.0.19版本以后，优化了请求地址修改方式，直接修改templates/dist/spa/statics/baseurl.js，中的baseurl和wsurl，就可以成功更改前端请求地址，不再需要做下面的quasar build打包工作。

如果需要修改前端内容，则还需要修改templates/public/statics/baseurl.js中的baseurl和wsurl，然后重新使用quasar build进行打包里的ws_url

~~~shell
## 示例更改前
const baseurl = 'http://127.0.0.1:8008/'
const wsurl = 'ws://127.0.0.1:8008/'

## 示例更改后
const baseurl = 'https://你的域名/'
const wsurl = 'wss://你的域名/websocket/'
~~~

如果服务器启用了SSL，请使用https和wss，如果没有启用SSL，则使用http和ws

修改后需要重新build前端代码

---

## 开发扩展：

因为使用的前后端分离的设计，所以可以通过API，开发更多的软件应用

### 物流智能AGV

- AGV的项目也已经开源，由于场地受限，仅实现智能发货，定点回库，使用的循迹感应器，超声波避障感应器，红外避障感应器，所有的指令通过网络传输，AGV绑定MAC地址和IP地址，保证了安全性，前提是，你需要有一个树莓派。

### 进销存

- 可以直接当一个进销存系统使用，简化仓库库位设置等操作即可。

### APP和小程序

- Quasar原生可以直接打包成IOS APP和Android APP
- 小程序的开发可以通过API开做二次开发，但小程序不支持put请求，所以需要自己再写一个请求接口。

- API的组合可以达到100万种，这样我们可以根据查询请求，来获得实时报表和数据监控

### 供应链管理系统

- 产品的数量，创建时间，最后使用时间是各方面统计的，所以可以方便采购计划和调拨计划进行库存的分析
- V 2.3.0及其以后的版本，将自带深度学习分析，所以可以直接使用分析结果作为供应链管理系统工具使用

### 多仓管理

- OPENID为用户的数据唯一标识，数据组统一标识为APPID，所以很方便可以实现多仓管理

### 波次拣货，发货

- 可以设置固定时间向服务器发出请求，从而达到波次拣货的功能

- 也可以直接使用任务工作，通过API查询分析结果来实现，推荐使用[APScheduler](https://pypi.org/project/APScheduler/)

~~~python
  pip install apscheduler
  ~~~

### Milk-Run

- V 2.2.0及其以上版本，将原生支持此功能
- 如果现在就需要这个业务，可以根据API调用库存消耗，来实现此功能

### VMI

- V 2.1.0及其以上版本，将原生支持此功能
- 如果现在就需要这个业务，可以根据API调用库存消耗，来实现此功能

### 拣货路线优化

- 现在的拣货路线是按照库位排序
- V 2.3.0以后版本将原生支持此功能
- 如果现在需要这个业务，可以根据每天的拣货明细，调用API来实现此功能

---

## 开发指南：

### baseurl

- 是发起请求的基本网址，如果是本地调试，则默认为http://127.0.0.1:8008/ ，如果部署在服务器，则需要将其改为你的网站访问url

- 修改方式为，修改axios_request.js，注意`websocket的修改之前已经提到了`

### Django-silk

- django-silk为开发时的调试工具，可以统计每个接口的响应速度，如果需要部署到生产环境，请删除Django-silk相关配置，因为会有泄露用户信息的风险，或者直接修改Django-silk库，让用户只能看到自己的请求数据

### 数据库存储

- 数据库设计时考虑到数据迁移等问题，所以只有users里面的user_id和Django自带的user_id做了外键，其余所有字段全部没有使用外键，方便数据备份和数据库迁移
- 数据库是4段式设计
  1. 验证数据用户归属
  2. 验证数据安全性
  3. 验证数据是否可以存入数据库
  4. 存入数据库，并返回Response

### 关于数据传输

- 需要在所有的请求头headers里面加入token值，这个值就是用户的数据唯一标识OPENID
- 所有的数据传输需要设定content-type为application/json

### OPENID

- OPENID是注册用户数据的唯一标识，当管理员直接注册时，会有developer=1这个管理员标识。
- 你可以根据developer标识来做自定义二次开发

### APPID

- APPID是用户数据组唯一标识
- 如果需要多公司运营，或者多仓运营，可以通过APPID做统一链接，来实现多公司，多仓操作

### 用户权限

- 未对用户权限做过多限制，请根据自身的业务需要，做二次开发限制

---

## 业务流程：

### 管理员

- 点击注册，可以注册成为管理员账号，从而实现初始化程序设置
- 注册后会得到2个ID和1个开发者标识，OPENID是用户数据组唯一标识，通过OPENID绑定此OPENID下所有的数据，APPID是用户组数据唯一标识，通过APPID来实现多公司，多仓库功能，Developer标识是个布尔值，True代表这是个管理员账号
- 用户登入分2种：
  1. 使用OPENID和员工名称直接登入
  2. 管理员使用账号和密码登入
- 登入后前端会存储登入信息
- 可以通过查看我的OPENID来查看用户数据组的OPENID
- 如果需要多公司，多仓库操作，注意需要更改OPENID
- 更多管理员权限，请自行开发

### 员工管理
- 注册管理员后，新建一个员工
- 员工有2个字段，Staff_name（用于员工登入），Staff_type（员工类型来控制员工的权限）
- 系统没有对员工权限做任何限制，如果需要员工权限，请根据企业业务模型，自行修改Templates
- 点击Edit，可以修改员工信息
- 点击Delete，可以删除员工信息，系统后台会将Is_delete调成True
- 点击Contact：
  1. 可以直接和员工实时聊天，但是不可以和自己聊天
  2. 可以新建一个备忘录员工，这样做其实是当成备忘录使用
  3. 在个人中心，可以查看最近的联系人
  4. Message标识会提醒你现在有多少未读消息

### 司机管理
- 司机管理只会在发货流程中用到
- 你需要知道货物是哪个司机提货取走的

### 仓库设置
- Warehouse
  1. 仓库的创建只可以创建一个仓库，现在可以创建多个，但是只有第一个会起作用
  2. 如果需要多仓处理，可以通过APPID进行二次开发，也可以直接重新创建一个管理员账号
  3. 仓库的城市一定要填写，这是用来计算运费的
- Bin_Property
  1. 库位属性决定了仓库中货物属于什么属性的货物
  2. 4种属性：破损（Damage)，锁定（Holding），质检（Inspection），正常（Normal）
  3. Beta版中，属性可以修改和删除，正式版将无法删除和修改
  4. 所有的发货，都只会匹配Normal库位的货物
  5. 收货上架和移库，都会根据库位属性，直接修改库存数量，仓库的库存数量不会出现负数
- Bin_Size
  1. 库位的尺寸是帮助操作人员查看货物是否可以放入库位
  2. 现行的版本没有对上架和移库尺寸做检查，将来会加入自动检查
- Bin_Set
  1. 库位设置是必须的，通常库位设置是横纵横纵，比如A010101，即A横01纵01横01纵
  2. 库位的设置需要设置库位属性和尺寸，属性很重要，他决定了此库位的货物是否为正常货物

### 基础设置
- Company
  1. 公司基本信息的创建只可以创建一个公司，现在可以创建多个，但是只有第一个会起作用
  2. 如果需要多公司处理，可以通过APPID进行二次开发，也可以直接重新创建一个管理员账号
  3. 公司的城市一定要填写，这是用来显示在收发货单上的
- Supplier
  1. 供应商的基础信息
  2. 供应商的城市一定要填写，这是用来显示在收货单上的，并且也是要自动计算运费的
- Customer
  1. 客户的基础信息
  2. 客户的城市一定要填写，这是用来显示在发货单上的，并且也是要自动计算运费的

### 商品管理
- Unit
  1. 商品的单位，系统会初始化创建一些，但可以自己添加和修改
- Class
  1. 商品的类型，可以自己添加和修改
- Color
  1. 商品的颜色，系统会初始化创建一些，但可以自己添加和修改
- Brand
  1. 商品的品牌，可以自己添加和修改
- Shape
  1. 商品的形状，系统会初始化创建一些，但可以自己添加和修改
- Specs
  1. 商品的规格，可以自己添加和修改
- Origin
  1. 商品的产地，可以自己添加和修改
- Goods List
  1. 商品的列表

### 固定资产
- Capital
  1. 固定资产创建，没有做过多拓展，只是记录使用
  2. 可以统计托盘账目等

### 库存管理
- Stock List
  1. 在库的货物总的库存数据量
  2. Onhand_stock现有的库存数量
  3. Can Order，可以用于下单发货的库存数量，因为有些货物已经被下了订单，虽然有现有库存，但是不可以再被订货
  4. Ordered Stock，已经被下单的货物数量
  5. ASN Stock，已经下了到货通知书，但还没有确认到货通知书的货物数量
  6. DN Stock，已被下单，但是还没有确认订单数量
  7. Pre Load，预计到货货物数量
  8. Pre Sort，已经到货，卸货完成，等待分拣的货物数量
  9. Sorted Stock，货物分拣完成，等待上架的货物数量
  10. Pick Stock，发货单生成了拣货单，等待拣货的货物数量
  11. Picked Stock，已经拣货完成，等待和司机交接的货物数量
  12. Back Order Stock，欠货订单数量
- Bin Stock
  1. Total Stock，这个库位该产品的所有库存数量
  2. Pick Stock，这个库位需要拣货的数量
  3. Picked Stock，这个库位拣货完成的数量
  4. Move To Bin， 移库，移库后，会根据库位属性，直接更新库存数量，如果库位全部移空，则该库位会更新为空库位
- Empty Bin
  1. 空库位明细
- Occupied Bin
  1. 非空库位明细

### 收货管理
- ASN到货通知书状态
  1. ASN Status = 1, ASN到货通知书创建完成，状态1是唯一可以删除和修改ASN信息的状态，他会显示在Pre Delivery中，即有了到货通知书，但是还没有到货，点击Confirm Delivery，即确认货物已经到达，ASN Status更新到2，此时已经无法再修改ASN信息
  2. ASN Status = 2, 拓展开发为司机到货排队，如果我们有很多司机到货，这可以做成一个排队系统，同时也可以让采购和销售看到到货信息，减少不必要的邮件和电话沟通，点击Finish Loading，即确认货物已经卸货完成，ASN Status更新到3,货物信息会出现在Sorting，此时的ASN状态表示，货物已卸到仓库，等待分拣
  3. ASN Status = 3, 货物分拣是必须的一个流程，没有货物分拣，货物是无法上架的，上架的原则就是货物整理好，摆放到相对应的库位上，点击Confirm Sorted，ASN Status更新到4，即确认分拣完成，等待上架
  4. 此时移动Sorted页面，会出现需要上架的货物明细，点击Move To Bin，上架完成，当然，系统会根据上架后的库位属性，自动更新商品库存数量信息
### 发货管理
- DN发货单状态
  1. DN Status = 1, DN发货单创建完成，此时订单还是可以修改状态，且系统中的库存数量不会发生任何改变，点击Confirm Order，DN Status更新到2，即订单已经被确认，且无法更改，同时系统中的货物库存数量会自动更新，比如Can Order数量和Ordered数量
  2. DN Status = 2, 这是订单被确认等待生成拣货单的过程，你可以点击单条订单Order Release来生成一个订单的拣货单，你也可以点击Release All Order，来将所有订单生成拣货单，如果是所有订单Release，那么会根据时间的先后进行库存匹配，库存不足时，会生成Back Order，即欠货订单，在这个过程中，DN单号是会发生改变的，如一家客户的多张订单，会被统一到一张订单中进行拣货，如客户订单无法满足，会将未满足部分生成欠货订单，欠货订单如果仍未得到匹配库存满足，将不再生成新的订单，DN Status会更新到3，即等待拣货的过程，已确认的订单和欠货订单都时Status为2的状态
  3. DN Status = 3, 直接拣货，此功能会出现在Beta5更新
  4. DN Status = 4, 发货交接，此功能会出现在Beta6更新
  5. DN Status = 5, 客户签收，此功能会出现在Beta7更新
  6. DN Status = 6, 对账结束，订单关闭，此功能会出现在Beta7更新
### 退货管理
- RO退货订单
  此功能将会出现在正式版中
### 运费管理
- Transportation Fee
  API已经完成，前端暂未更新入口，如果想要使用，可以直接调用Payment下的Transportation Fee API进行使用，运费自动计算模块已经做进收发货流程中

### 界面截图

智锋科技/GreaterWMS_2

About

Releases

Contributors

Activities