# kasa-wms

**Repository Path**: hxsaas/kasa-wms

## Basic Information

- **Project Name**: kasa-wms
- **Description**: 仓储物流WMS管理系统，商用多年，功能齐全，运行稳定，C/S + B/S 双架构混合运行，具备代码生成器，使用方便，极大简化普通的crud操作，能快速提高开发效率。

后端：java swing+mina+springboot+hibernate+mybatis-plus+......

前端：java swing+iReport+vue3+uniapp+......
- **Primary Language**: Java
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 28
- **Created**: 2023-04-29
- **Last Updated**: 2023-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 卡萨物流系统

## 版权
### 本系统虽已开源，但本系统属武汉卡萨科技有限公司独立开发，依法独立享有该软件的所有权利，但未经公司授权，不得将之用于盈利的任何用途，仅可用于编程爱好者们的学习，谢谢！

## 介绍
### 本系统支持大多数自有仓库的仓储管理，通过系统打出入库、出库的单据，仓库工作人员通过PDA操作，进行仓库作业，极大提高现场的作业效率，同时支持低温环境下冻品作业，已在零下18度的仓库环境下作业得到实践证明(武汉山绿冷链物流有限公司)

>EDI(电子数据接口)：可通过电子文档导入订单、基础数据、库存初始化等，也可作为线上数据对接的入口
>
>AMS(权限管理系统)：通用权限管理+业务权限管理
>
>OMS(订单管理系统)：入库/出库单管理，提供审核功能，审核通过的订单才能进入WMS系统
>>入库订单<br>
>>出库订单<br>
>>
>WMS(仓储管理系统)：<br>
>>收货
>>>收货单管理<br>
>>>生成统一收货单<br>
>>>打印收货库存码<br>
>>>
>>发货
>>>发货单管理<br>
>>>拣货计算<br>
>>>列印拣货单(选)<br>
>>>生成拣货任务<br>
>>>任务调度<br>
>>>任务调整<br>
>>>发货确立<br>
>>>出货集货储位(选)<br>
>>>出货集货栈板(选)<br>
>>>拣货还原<br>
>>>拣货波次<br>
>>>
>>出货回单
>>>出货回单确认<br>
>>>出货回单查询<br>
>>>
>>返单作业
>>>进货单返单<br>
>>>出货单返单<br>
>>>
>>库内管理
>>>栈板调整<br>
>>>储位调整<br>
>>>商品状态调整<br>
>>>报废<br>
>>>库存调整<br>
>>>特殊调整<br>
>>>商品控制<br>
>>>
>>库内查询/统计
>>>储位库存查询<br>
>>>商品库存查询<br>
>>>储位库存状态<br>
>>>储位库存分组统计<br>
>>>商品库存状态统计<br>
>>>商品进出库统计<br>
>>>货物进出查询<br>
>>>储位进出查询<br>
>>>查询当日异动<br>
>>>入库单明细查询<br>
>>>统一收货单明细查询<br>
>>>出库单明细查询<br>
>>>处理中拣货单明细查询<br>
>>>已出货拣货单明细查询<br>
>>>储位调整明细查询<br>
>>>库存调整明细查询<br>
>>>特殊调整明细查询<br>
>>>强制进货验收查询<br>
>>>商品进货最新制造日期<br>
>>>商品出货最新制造日期<br>
>>>"拣货位剩余库存盘点表<br>
>>>订单->任务明细<br>
>>>拣货任务->出货单->任务明细<br>
>>>
>>日结作业
>>>库存日结<br>
>>>列印日结报表<br>
>>>取消日结<br>
>>>查询日结异动<br>
>>>日结储位库存<br>
>>>日结商品库存<br>
>>>库存日结明细<br>
>>>
>>仓库盘点(正常)
>>>宣告盘点作业<br>
>>>列印盘点表<br>
>>>登录实际盘点值<br>
>>>盘点值更新<br>
>>>列印盘点报告书<br>
>>>取消盘点<br>
>>>
>>TMS(运输管理系统)：客户用的不多，后期就没怎么维护了，功能列表省略
>>>
>>FMS(财务管理系统)：客户用的不多，后期就没怎么维护了，功能列表省略
>>>
>>基础数据(太多，不一一列举，见系统)


## 软件历史
本套系统可以说是一个大杂烩，从2006年孕育，到2007年有客户上线正式运营，到目前已有将近20来个年头。
  本系统服务的客户有：
  1. 武汉宝沃勤物流有限公司(最初客户，现改为卓尔宝沃勤)
  2. 九裕物流-金六福酒业集团下属的物流企业：长沙仓(家电配送)、南昌仓(红牛集团饮品配送，有在线数据对接，通过红牛sop系统推送订单数据，仓库处理完后，返结果给红牛sop系统)
  3. 武汉山绿冷链物流有限公司-武汉市供销社直属企业：主配送百胜餐饮的华中地区，有在线数据对接，通过百胜系统推送订单数据，仓库处理完后，返结果给百胜系统，另还管理其它货主的物品。
  4. 其它小客户就不一一说明了
  
  由于系统陆陆续续开发了很多年，经历过多次版本迭代升级，因此避免不了架构有一定混乱及代码风格差异大，但至少在目前所用的客户中，稳定性和效率性还是不错的。
  
  从最开始的C/S架构，转到现在的C/S+B/S混合运行，是因为物流公司随着业务的增长，需要和货主公司进行在线数据对接，大多采用的是http协议，故后来加上springboot版本，所以原主要的仓储业务逻辑使用hibernate持久层，在线数据对接使用mybatis作为持久层
  
  前端最初只有java swing版本，随着web的流行，先加了react版本的客户端，前后端分离，后来改成vue2版本，进而改成目前的vue3版本，ui框架使用element-plus。
  
  因swing版本的客户端存在，客户觉得也挺好用，就不太愿意再花钱买web版，故web版本的客户端一直没上心开发，所以功能不完整，我估计以后也不会再投入精力开发web版本，有兴趣的朋友可自己试试！
  
  虽然系统老旧，但也不停尝试使用新技术，相信也有一定值得学习的地方，比如：
  1. 权限管理，大多通用的权限管理只能做到对角色分配功能权限，然后把用户添加到这个角色中，而本系统不仅支持这种赋权模式外，还另外允许给用户单独赋予某个功能的权限
  2. 普通crud操作，支持代码和配置文件生成，而且对常用功能做了深度封装的组件，大大提高普通数据的开发效率


## 软件架构
### B/S + C/S 混合架构，也可单独C/S简单部署
* 后端采用java swing+mina+springboot+hibernate+mybatis-plus+...... 
* 前端采用java swing+iReport+vue3(Element plus)+uniapp+......


## 演示图

<table width="100%">
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/swing_login.jpg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/swing_cdg_list.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/swing_cdg_verify.jpg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/swing_cdg_detail.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/swing_jhd_tyshd.jpg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/swing_jhd_tyshd2.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/swing_chd_build.jpg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/swing_chd_jhjs.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/web_login.jpg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/web_sz_login.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/web_cgd_list.jpg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/web_cgd_verify.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/web_cgd_add.jpg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/web_async.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/web_jhd_ys.jpg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/web_jhd_ys2.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/web_jhd_ys3.jpg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/web_sz_login.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/pda.jpeg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/pad_login.jpeg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/pda_home.jpeg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/pda_settings.jpeg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/pda_in.jpeg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/pad_out.jpeg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/pda_tysh_list.jpeg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/pda_tysh_main.jpeg"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/pda_tysh_detail.jpeg"/></td>
        <td><img src="https://gitee.com/gzhou/kasa-wms/raw/master/assets/pad_kngl.jpeg"/></td>
    </tr>
</table>

## 目录介绍
>assets: README需要用到的图片，非项目文件，略过

>kasa_runtime：C/S架构的运行环境

>>client：客户端运行环境

>>server：服务端运行环境

>kasa_workspace：源代码工作空间目录

>>client_storage：swing客户端源码

>>server_storage：swing服务端源码(可不用界面console运行)，是kasa_webserver_springboot编译时必须用到的依赖项目

>>kasa_webserver_springboot：springboot版后台源码，主要做在线数据对接功能，必须依赖server_storage的代码

>>kasa-vue-element-plus：vue3(element-plus)web版前端源码

>pda：PDA安装程序-不提供源码

>sql：建库、建表脚本及演示数据脚本

>tools：内部开发工具

>>license：后台服务license生成工具及密码生成工具

>>schemas：建表工具，能生成开发用的代码及脚本


## 使用说明

正在编写开发指南，请等待......   2023-3-22 by gzhou

开发环境的搭建有一定要求，如想先学习，请加入下方QQ群和作者沟通，谢谢！


## 交流群

<p>QQ技术交流群(610332850):<a target="_blank" href="https://qm.qq.com/cgi-bin/qm/qr?k=2SrSGGOIOyZk0DviluFGQ4MlO5ORBqYt&jump_from=webapi&authKey=vqJHYmDyiGT24T/5vZLoaY5wBw/e9QeV+DADnCMXcPfQg/t6sRuJCdlMy2DVVwyB"><img border="0" src="//pub.idqqimg.com/wpa/images/group.png" alt="卡萨物流系统交流群" title="卡萨物流系统交流群"></a>