GreaterWMS--开源仓库管理系统
Win10无环境安装镜像：https://www.56yhz.com/zh-hans/plugins/4/
项目介绍：
完全开源仓储管理软件，遵循Apache License 2.0协议，前后端分离，且完全开源，API使用restful协议，方便二次开发，前端代码使用quasar进行构建，后端使用Python Django3.1，利用API，可以支持多仓，波次发货，合并拣货，Milk-Run等业务模型。
项目初衷：
我在供应链行业工作了15年，发现在我们这个专业的领域，没有一款高自由度、高自定义化的软件，来深度支持我们企业的业务。大多数软件都是闭源的，而且很难去做二次开发，即使开发，周期也是非常长，开发失败的案例也是比比皆是。由于企业选择了一款软件后，其二次开发也会被开发公司绑定，至于二次开发费用，只能说呵呵。所以，我设计了这个聚商汇WMS，为的是做到一款高自由度，高自定义开发的仓库管理软件，来深度支持企业的业务。
- 愿景：如果你从事着非IT行业的工作，而你又热爱你的行业，那就用科技去改变他。
开发环境：
-
Python 版本为 V 3.9.5 +
-
Django 版本为 V 3.1.12 +(该版本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
pip install -r requirements.txt
注意：安装需要Twisted库，这个库有时候会安装不上，需要下载下来本地安装
pip install Twisted{你下载下来的版本名称}
注意：本地安装需要注意路径
python manage.py makemigrations
创建数据库，Django默认使用sqlite3作为数据库，如果需要mysql数据库，请在greaterwms/settings.py里面配置DATABASE
开发服务器运行：
daphne -p 8008 greaterwms.asgi:application
生产服务器运行：
使用supervisor来守护Django进程，再使用Nginx做反向代理，至于superevisor的教程有很多，这里不做讲解
推荐使用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
## 示例更改前
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前端代码
开发指南：
baseurl
Django-silk
- django-silk为开发时的调试工具，可以统计每个接口的响应速度，如果需要部署到生产环境，请删除Django-silk相关配置，因为会有泄露用户信息的风险，或者直接修改Django-silk库，让用户只能看到自己的请求数据
数据库存储
- 数据库设计时考虑到数据迁移等问题，所以只有users里面的user_id和Django自带的user_id做了外键，其余所有字段全部没有使用外键，方便数据备份和数据库迁移
- 数据库是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种：
- 使用OPENID和员工名称直接登入
- 管理员使用账号和密码登入
- 登入后前端会存储登入信息
- 可以通过查看我的OPENID来查看用户数据组的OPENID
- 如果需要多公司，多仓库操作，注意需要更改OPENID
- 更多管理员权限，请自行开发
员工管理
- 注册管理员后，新建一个员工
- 员工有2个字段，Staff_name（用于员工登入），Staff_type（员工类型来控制员工的权限）
- 系统没有对员工权限做任何限制，如果需要员工权限，请根据企业业务模型，自行修改Templates
- 点击Edit，可以修改员工信息
- 点击Delete，可以删除员工信息，系统后台会将Is_delete调成True
- 点击Contact：
- 可以直接和员工实时聊天，但是不可以和自己聊天
- 可以新建一个备忘录员工，这样做其实是当成备忘录使用
- 在个人中心，可以查看最近的联系人
- Message标识会提醒你现在有多少未读消息
司机管理
- 司机管理只会在发货流程中用到
- 你需要知道货物是哪个司机提货取走的
仓库设置
- Warehouse
- 仓库的创建只可以创建一个仓库，现在可以创建多个，但是只有第一个会起作用
- 如果需要多仓处理，可以通过APPID进行二次开发，也可以直接重新创建一个管理员账号
- 仓库的城市一定要填写，这是用来计算运费的
- Bin_Property
- 库位属性决定了仓库中货物属于什么属性的货物
- 4种属性：破损（Damage)，锁定（Holding），质检（Inspection），正常（Normal）
- Beta版中，属性可以修改和删除，正式版将无法删除和修改
- 所有的发货，都只会匹配Normal库位的货物
- 收货上架和移库，都会根据库位属性，直接修改库存数量，仓库的库存数量不会出现负数
- Bin_Size
- 库位的尺寸是帮助操作人员查看货物是否可以放入库位
- 现行的版本没有对上架和移库尺寸做检查，将来会加入自动检查
- Bin_Set
- 库位设置是必须的，通常库位设置是横纵横纵，比如A010101，即A横01纵01横01纵
- 库位的设置需要设置库位属性和尺寸，属性很重要，他决定了此库位的货物是否为正常货物
基础设置
- Company
- 公司基本信息的创建只可以创建一个公司，现在可以创建多个，但是只有第一个会起作用
- 如果需要多公司处理，可以通过APPID进行二次开发，也可以直接重新创建一个管理员账号
- 公司的城市一定要填写，这是用来显示在收发货单上的
- Supplier
- 供应商的基础信息
- 供应商的城市一定要填写，这是用来显示在收货单上的，并且也是要自动计算运费的
- Customer
- 客户的基础信息
- 客户的城市一定要填写，这是用来显示在发货单上的，并且也是要自动计算运费的
商品管理
- Unit
- 商品的单位，系统会初始化创建一些，但可以自己添加和修改
- Class
- 商品的类型，可以自己添加和修改
- Color
- 商品的颜色，系统会初始化创建一些，但可以自己添加和修改
- Brand
- 商品的品牌，可以自己添加和修改
- Shape
- 商品的形状，系统会初始化创建一些，但可以自己添加和修改
- Specs
- 商品的规格，可以自己添加和修改
- Origin
- 商品的产地，可以自己添加和修改
- Goods List
- 商品的列表
固定资产
- Capital
- 固定资产创建，没有做过多拓展，只是记录使用
- 可以统计托盘账目等
库存管理
- Stock List
- 在库的货物总的库存数据量
- Onhand_stock现有的库存数量
- Can Order，可以用于下单发货的库存数量，因为有些货物已经被下了订单，虽然有现有库存，但是不可以再被订货
- Ordered Stock，已经被下单的货物数量
- ASN Stock，已经下了到货通知书，但还没有确认到货通知书的货物数量
- DN Stock，已被下单，但是还没有确认订单数量
- Pre Load，预计到货货物数量
- Pre Sort，已经到货，卸货完成，等待分拣的货物数量
- Sorted Stock，货物分拣完成，等待上架的货物数量
- Pick Stock，发货单生成了拣货单，等待拣货的货物数量
- Picked Stock，已经拣货完成，等待和司机交接的货物数量
- Back Order Stock，欠货订单数量
- Bin Stock
- Total Stock，这个库位该产品的所有库存数量
- Pick Stock，这个库位需要拣货的数量
- Picked Stock，这个库位拣货完成的数量
- Move To Bin， 移库，移库后，会根据库位属性，直接更新库存数量，如果库位全部移空，则该库位会更新为空库位
- Empty Bin
- 空库位明细
- Occupied Bin
- 非空库位明细
收货管理
- ASN到货通知书状态
- ASN Status = 1, ASN到货通知书创建完成，状态1是唯一可以删除和修改ASN信息的状态，他会显示在Pre Delivery中，即有了到货通知书，但是还没有到货，点击Confirm Delivery，即确认货物已经到达，ASN Status更新到2，此时已经无法再修改ASN信息
- ASN Status = 2, 拓展开发为司机到货排队，如果我们有很多司机到货，这可以做成一个排队系统，同时也可以让采购和销售看到到货信息，减少不必要的邮件和电话沟通，点击Finish Loading，即确认货物已经卸货完成，ASN Status更新到3,货物信息会出现在Sorting，此时的ASN状态表示，货物已卸到仓库，等待分拣
- ASN Status = 3, 货物分拣是必须的一个流程，没有货物分拣，货物是无法上架的，上架的原则就是货物整理好，摆放到相对应的库位上，点击Confirm Sorted，ASN Status更新到4，即确认分拣完成，等待上架
- 此时移动Sorted页面，会出现需要上架的货物明细，点击Move To Bin，上架完成，当然，系统会根据上架后的库位属性，自动更新商品库存数量信息
发货管理
- DN发货单状态
- DN Status = 1, DN发货单创建完成，此时订单还是可以修改状态，且系统中的库存数量不会发生任何改变，点击Confirm Order，DN Status更新到2，即订单已经被确认，且无法更改，同时系统中的货物库存数量会自动更新，比如Can Order数量和Ordered数量
- DN Status = 2, 这是订单被确认等待生成拣货单的过程，你可以点击单条订单Order Release来生成一个订单的拣货单，你也可以点击Release All Order，来将所有订单生成拣货单，如果是所有订单Release，那么会根据时间的先后进行库存匹配，库存不足时，会生成Back Order，即欠货订单，在这个过程中，DN单号是会发生改变的，如一家客户的多张订单，会被统一到一张订单中进行拣货，如客户订单无法满足，会将未满足部分生成欠货订单，欠货订单如果仍未得到匹配库存满足，将不再生成新的订单，DN Status会更新到3，即等待拣货的过程，已确认的订单和欠货订单都时Status为2的状态
- DN Status = 3, 直接拣货，此功能会出现在Beta5更新
- DN Status = 4, 发货交接，此功能会出现在Beta6更新
- DN Status = 5, 客户签收，此功能会出现在Beta7更新
- DN Status = 6, 对账结束，订单关闭，此功能会出现在Beta7更新
退货管理
运费管理
- Transportation Fee
API已经完成，前端暂未更新入口，如果想要使用，可以直接调用Payment下的Transportation Fee API进行使用，运费自动计算模块已经做进收发货流程中
界面截图
