31 Star 145 Fork 53

GreaterWMS / GreaterWMS

Create your Gitee Account
Explore and code with more than 6 million developers,Free private repositories !:)
Sign up
Clone or download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README.md

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


项目介绍:

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

  • 软件著作权编号:2018SR517685

  • GitHub地址:GitHub

  • Demo地址:DEMO(注册会获得初始化Demo数据)

  • 技术交流QQ群:463562933


项目初衷:

我在供应链行业工作了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官网)

  • Vue 版本为 V 2.6.0 +(尽量不要使用Vue3,因为开发环境没有使用Vue3,不知道会出现什么问题)

  • API,遵循 RESTful 架构


构建命令:

  • 下载代码:
git clone https://github.com/Singosgu/GreaterWMS.git
  • 安装Python库:
pip install -r requirements.txt

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

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

注意:本地安装需要注意路径

  • 初始化数据库:
python manage.py makemigrations
  • 迁移数据库:
python manage.py migrate

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

开发服务器运行:

  • 开发运行:
daphne -p 8008 greaterwms.asgi:application

生产服务器运行:

  • supervisor守护进程:
pip install supervisor

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

  • Nginx支持:

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

另需要修改axios_request.js里的ws_url

## 示例更改前
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

    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进行使用,运费自动计算模块已经做进收发货流程中

Comments ( 8 )

Sign in for post a comment

About

开源仓储管理系统,该仓库管理系统遵循Apache License 2.0协议,前后端分离,api使用restful协议,方便二次开发,前端代码使用quasar进行构建,利用API,可以支持多仓,波次发货,合并拣货,Milk-Run等业务模型 spread retract
Python and 3 more languages
Apache-2.0
Cancel

Releases (2)

All

Gitee Metrics

Contributors

All

Activities

load more
can not load any more
Python
1
https://gitee.com/Singosgu/GreaterWMS.git
git@gitee.com:Singosgu/GreaterWMS.git
Singosgu
GreaterWMS
GreaterWMS
master

Search