# zero-one-wms

**Repository Path**: hxsaas/zero-one-wms

## Basic Information

- **Project Name**: zero-one-wms
- **Description**: zero-one-wms旨在帮助您满足未来的供应链需求，将库存管理和履行服务与现代采购方法相匹配，并提供对整个库存的实时可见性。只要有互联网，用户就可以通过智能手机和浏览器实时了解库存。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: v1.0.0
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# `zero-one-wms`

`WMS`概念定义参考：

- https://en.wikipedia.org/wiki/Warehouse_management_system
- https://baike.baidu.com/item/%E4%BB%93%E5%BA%93%E7%AE%A1%E7%90%86/9163356

## 项目简介

仓储管理系统（`WMS`）是一种软件解决方案，它提供对企业整个库存的可见性，可管理从配送中心到商店货架的整个供应链履行运营。通过协调和优化资源使用与物料流动，助力企业充分利用劳动力、空间以及所投资的设备。旨在满足整个全球供应链的需求，包括分销、制造、资产密集型和服务业务。

在当今动态、全渠道的履行经济中，网购消费者希望随时随地都能进行购买、订单履行和退货。这要求企业使用适当的仓库管理软件来提高履行能力，快速响应客户需求。

`zero-one-wms`旨在帮助您满足未来的供应链需求，将库存管理和履行服务与现代采购方法相匹配，并提供对整个库存的实时可见性。只要有互联网，用户就可以通过智能手机和浏览器实时了解库存。

## 系统架构图

项目主体骨架基于`Spring Cloud Alibaba`生态体系，使用`MySQL`进行数据持久化管理，采用`Vue3`生态体系与`Element Puls` `UI`框架完成前端制作，同时项目提供`C++`微服务开发解决方案与集成。

![architecture](./documents/00、preview-pic/architecture.jpg)

## 目录结构说明
> `zero-one-wms`  
>
> > `.gitignore` -- 忽略配置
> >
> > `README.md` -- 自述文件
> >
> > `documents` -- 环境搭建、编码规范、项目需求等等文档资源
> >
> > `wms-cpp` -- `C++`项目主体
> >
> > `wms-front` -- 前端项目主体
> >
> > `wms-java` -- `Java`项目主体

## 软件架构
### `Java`后端核心技术栈

版本匹配参考：

https://github.com/alibaba/spring-cloud-alibaba/wiki/%E7%89%88%E6%9C%AC%E8%AF%B4%E6%98%8E

|技术|说明|版本|备注|
|----|----|----|----|
|`Spring`|容器|5.2.15|https://spring.io/|
|`Spring Web MVC`|`MVC`框架|5.2.15|https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html|
|`Beanvalidation`|实体属性校验|2.0.2|https://beanvalidation.org/2.0-jsr380/<br>https://www.baeldung.com/spring-boot-bean-validation|
|`MyBatis`|`ORM`框架|3.5.7|http://www.mybatis.org/mybatis-3/zh/index.html|
|`MyBatis Plus`|`MyBatis`的增强工具|3.4.3.4|https://baomidou.com/|
|`MyBatis Plus Generator`|代码生成器|3.5.1|https://github.com/baomidou/generator|
|`Druid`|数据库连接池|1.2.8|https://github.com/alibaba/druid|
|`Lombok`|实体类增加工具|1.18.20|https://github.com/rzwitserloot/lombok|
|`Hutool`|Java工具类库|5.7.16|https://hutool.cn/docs/#/|
|`Knife4j`|接口描述语言| 3.0.3 |https://gitee.com/xiaoym/knife4j|
|`Nimbus JOSE JWT`|`JSON Web Token`| 8.21  |https://bitbucket.org/connect2id/nimbus-jose-jwt/wiki/Home|
|`Jedis`|`Redis Java`客户端| 3.7.0         |https://github.com/redis/jedis|
|`Spring Boot`|Spring快速集成脚手架| 2.3.12 |https://spring.io/projects/spring-boot|
|`Spring Cloud`|微服务框架| `Hoxton.SR12` |https://spring.io/projects/spring-cloud|
|`Spring Cloud Alibaba`|微服务框架| 2.2.7 |https://github.com/alibaba/spring-cloud-alibaba/wiki|
|`Spring Cloud Security`|认证和授权框架| 2.2.5 |https://spring.io/projects/spring-cloud-security|
|`Sentinel`|分布式系统的流量防卫兵| 1.8.1 |https://sentinelguard.io/zh-cn/|
|`Seata`|分布式事务解决方案| 1.3.0 |https://seata.io/zh-cn/|

### `Java`后端扩展技术栈
|技术|说明|版本|备注|
|----|----|----|----|
|`easyexcel`|Excel报表|3.0.5| https://github.com/alibaba/easyexcel |
|`RocketMQ`|事件驱动中间件|4.6.1|https://github.com/alibaba/spring-cloud-alibaba/wiki/RocketMQ|
| `Spring WebSocket` | 及时通讯服务 | 5.2.15 | https://www.baeldung.com/websockets-spring |
| `FastDFS` | `dfs`客户端 | 1.29 | https://bluemiaomiao.github.io/fastdfs-spring-boot-starter/ |


### 前端技术栈

|技术|说明|版本|备注|
|----|----|----|----|
|`Vue`|前端框架|3|https://v3.vuejs.org/|
|`Vue-Router`|路由框架|`v4.x`| https://next.router.vuejs.org/       |
|`Pinia`|全局状态管理框架|`v2.x`|https://pinia.vuejs.org/|
|`Axios`|HTTP中间件|[v0.27.2](https://github.com/axios/axios/releases/tag/v0.27.2)|https://github.com/axios/axios|
|`Element-Plus`|前端`UI`框架|latest|https://element-plus.org/zh-CN/|
| `Avue` | 基于`ElementUI`二次封装 | `v3.0.4` | https://v3.avuejs.com/ |
| `V-Charts` | 基于`Echarts`的图表框架 | latest | https://v-charts.js.org/ |

### `CPP`技术栈

#### 后端核心技术栈

| 技术              | 说明                         | 版本                                                         | 备注                                                         |
| ----------------- | ---------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| `cinatra`         | `Http`框架                   | [d91b912bb6](https://github.com/qicosmos/cinatra/tree/d91b912bb63193eb2592732445ebf14c96e78180) | https://github.com/qicosmos/cinatra                          |
| `nlohmann/json`   | `json`框架                   | [v3.10.4](https://github.com/nlohmann/json/releases/tag/v3.10.4) | https://github.com/nlohmann/json                             |
| `asio`            | 网络和低级I/O编程的跨平台C库 | 1.20.0                                                       | https://think-async.com/Asio/                                |
| `MySQL Connector` | `MySQL`连接驱动库            | 8.0.27                                                       | https://dev.mysql.com/downloads/connector/cpp/<br>https://dev.mysql.com/doc/connector-cpp/1.1/en/connector-cpp-apps.html |
| `JWT`             | `JSON` Web Token             | [v1.4](https://github.com/arun11299/cpp-jwt/tree/v1.4)       | https://opensourcelibs.com/lib/cpp-jwt                       |
| `OpenSSL`         | 开源安全套接层协议           | `1.1.1L`                                                     | https://www.openssl.org/<br>https://www.xolphin.com/support/OpenSSL/OpenSSL_-_Installation_under_Windows |
| `xlnt`            | excel库                      | 1.5.0                                                        | https://github.com/tfussell/xlnt                             |

#### 测试前端技术栈

| 技术       | 说明       | 版本  | 备注                |
| ---------- | ---------- | ----- | ------------------- |
| `jQuery`   | Ajax框架   | 3.6.0 | https://jquery.com/ |
| `HTML5`    | 文本页面   | 5     |                     |
| `CSS3`     | 页面样式表 | 3     |                     |
| JavaScript | 页面小脚本 | `ES6` |                     |

## 环境搭建

### 开发工具

|工具|说明|版本|备注|
|----|----|----|----|
|`IDEA`|开发`IDE`|2021.3|https://www.jetbrains.com/idea/download|
|`Navicat`|数据库连接工具|latest|https://www.navicat.com.cn/|
|`RDM`|`Redis`可视化管理工具|latest|https://github.com/uglide/RedisDesktopManager<br>https://gitee.com/qishibo/AnotherRedisDesktopManager|
|`PowerDesigner`|数据库设计工具|16.6|http://powerdesigner.de/|
|`Axure`|原型设计工具|9|https://www.axure.com/|
|`MindMaster`|思维导图设计工具|latest|http://www.edrawsoft.cn/mindmaster|
|`Visio`|流程图绘制工具|latest||
|`Apipost`|`API`接口调试工具|latest|https://www.apipost.cn/|
|`Git`|项目版本管控工具|latest|https://git-scm.com/|
|`TAPD`|开发过程管控软件|latest|https://www.tapd.cn/|
|`VS`|C++开发`IDE`|2019|https://docs.microsoft.com/en-us/visualstudio/releases/2019/release-notes|

### 开发环境

|依赖环境|版本|备注|
|----|----|----|
|Windows|10|操作系统|
|`JDK`|1.8.0_191|https://www.injdk.cn/|
|`NodeJS`|14.15.1|https://nodejs.org/zh-cn/|

### 服务器环境

| 依赖环境   | 版本                                                         | 备注                                                |
| ---------- | ------------------------------------------------------------ | --------------------------------------------------- |
| `CentOS`   | 7                                                            | 操作系统（可用`VM`安装`Centos7`）                   |
| `Docker`   | latest                                                       | https://www.docker.com/                             |
| `MySQL`    | 8                                                            | https://www.mysql.com/cn/                           |
| `Redis`    | 6.2.6                                                        | https://redis.io/                                   |
| `Nacos`    | 2.0.3                                                        | https://nacos.io/zh-cn/docs/quick-start-docker.html |
| `Sentinel` | 1.8.1                                                        | https://github.com/alibaba/Sentinel/releases        |
| `Seata`    | 1.3.0                                                        | https://github.com/seata/seata                      |
| `RocketMQ` | 4.6.1                                                        | https://rocketmq.apache.org/                        |
| `Nginx`    | latest                                                       | https://nginx.org/en/                               |
| `FastDFS`  | [V6.07](https://github.com/happyfish100/fastdfs/releases/tag/V6.07) | https://gitee.com/fastdfs100                        |

## 特别鸣谢

`zero-one-wms`的诞生离不开开源软件的支持，感谢以下开源项目及项目维护者：

- spring：https://github.com/spring-projects
- alibaba：https://github.com/alibaba
- mybatis：https://github.com/mybatis/mybatis-3.git
- mp：https://github.com/baomidou
- api：https://gitee.com/xiaoym/knife4j
- `vue`：https://github.com/vuejs
- ui：https://github.com/ElemeFE
- cinatra：https://github.com/qicosmos/cinatra
- 参考项目：https://gitee.com/erzhongxmu/jeewms.git