# 基于Gin+Vue的信息管理系统

**Repository Path**: wdczrs/wms

## Basic Information

- **Project Name**: 基于Gin+Vue的信息管理系统
- **Description**: 基于Gin+Vue的仓储信息管理系统
- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://gitee.com/Cauchy_AQ/wms/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-02-14
- **Last Updated**: 2025-02-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于 Gin + Vue 的信息管理系统

## 前言
`wms` 项目是我的本科毕业设计，虽有不完善之处，但足以应对毕设答辩。

## 项目介绍

> 该项目基于权限管理系统开发，实现一个后台仓库管理系统。
> 
> 前端使用 Vue3 框架，采用 Vite 工具构建，大部分编码使用 TypeScript 语言。后端使用 Gin 框架，数据库 Mysql + Redis，底层基于 Kafka 消息队列搭建好了消费实时数据的框架，大文本的检索采用 elasticsearch。
>
> 主要功能包括：菜单管理、角色管理、用户管理、仓库管理、商品管理、库区管理、入库管理、库存查询、出库管理、客户管理、操作日志等。

权限管理系统（rbac）

- 代码地址：[参考 rbac 分支](https://gitee.com/Cauchy_AQ/rbac/tree/rbac/)

- 博客地址：[权限管理系统](https://blog.csdn.net/qq_52678569/article/details/136128274?spm=1001.2014.3001.5501)

仓库管理系统（wms）
- 前端源码：[传送门](https://gitee.com/Cauchy_AQ/wms/tree/master/frontend)
- 后端源码：[传送门](https://gitee.com/Cauchy_AQ/wms/tree/master/backend)

项目前端及后端详细的介绍参考对应目录下的 `README.md` 文件。


## 项目演示

### 后台管理系统

项目演示地址：[www.cauchy.site](www.cauchy.site)

- 商品管理界面展示：

![goods](frontend/public/goods.png)

- 入库管理界面展示：

![instocks](frontend/public/instocks.png)

- 日志查询界面展示：

![logs](frontend/public/logs.png)

## 项目架构

### 系统架构

![wms系统架构图](frontend/public/wms项目系统架构图.png)


## 组织结构
> wms \
> |—— /backend  -- 后端项目文件夹 \
> |—— /frontend  -- 前端项目文件夹 \
> |—— docker-compose.yml  -- docker 服务编排




## 技术选型

### 后端技术

| 技术          | 说明                  | 官网                                                                                     |
| ------------- | --------------------- | ---------------------------------------------------------------------------------------- |
| Gin           | HTTP Web 框架         | [https://github.com/gin-gonic/gin](https://github.com/gin-gonic/gin)                     |
| Mysql         | sql数据库             | [https://www.mysql.com](https://www.mysql.com)                                           |
| Redis         | 内存数据库存储        | [https://redis.io](https://redis.io)                                                     |
| Gorm          | ORM 框架              | [https://gorm.io](https://gorm.io)                                                       |
| Kafka         | 消息队列              | [https://github.com/segmentio/kafka-go](https://github.com/segmentio/kafka-go)           |
| Kafka-UI      | 消息队列可视化工具    | [https://github.com/provectus/kafka-ui](https://github.com/provectus/kafka-ui)           |
| Snoyflake     | 雪花算法生成分布式 ID | [https://github.com/sony/sonyflake](https://github.com/sony/sonyflake)                   |
| Elasticsearch | 搜索引擎              | [https://github.com/elastic/elasticsearch](https://github.com/elastic/elasticsearch)     |
| Kibana        | 日志可视化查看工具    | [https://github.com/elastic/kibana](https://github.com/elastic/kibana)                   |
| Nginx         | 静态资源服务器        | [https://www.nginx.com](https://www.nginx.com)                                           |
| Docker        | 应用容器引擎          | [https://www.docker.com](https://www.docker.com)                                         |
| JWT           | JWT 身份验证          | [https://github.com/dgrijalva/jwt-go](https://github.com/dgrijalva/jwt-go)               |
| Swagger       | API文档生成工具       | [https://github.com/swaggo/gin-swagger](https://github.com/swaggo/gin-swagger)           |
| Validator     | 验证框架              | [https://github.com/go-playground/validator](https://github.com/go-playground/validator) |


### 前端技术

| 技术         | 说明           | 官网                                                             |
| ------------ | -------------- | ---------------------------------------------------------------- |
| Vue          | 前端框架       | [https://vuejs.org](https://vuejs.org)                           |
| Vue-router   | 路由框架       | [https://v3.router.vuejs.org](https://v3.router.vuejs.org)       |
| Pinia        | 状态管理框架   | [https://github.com/vuejs/pinia](https://github.com/vuejs/pinia) |
| Axios        | 前端 HTTP 框架 | [https://github.com/axios/axios](https://github.com/axios/axios) |
| Element Plus | 前端 UI 框架   | [https://element-plus.org](https://element-plus.org)             |


## 环境搭建

### 开发环境

| 工具          | 版本号 | 下载                                                                                                                            |
| ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------- |
| Golang        | 1.22.0 | [https://golang.google.cn](https://golang.google.cn)                                                                            |
| Mysql         | 5.7    | [	https://www.mysql.com](	https://www.mysql.com)                                                                                |
| Redis         | 7.0    | [https://redis.io/download](https://redis.io/download)                                                                          |
| Nginx         | 1.25   | [https://nginx.org/en/download.html](https://nginx.org/en/download.html)                                                        |
| Kafka         | 7.3.2  | https://kafka.apache.org/downloads ，镜像地址：[hub.docker.com/r/confluentinc/cp-kafka](hub.docker.com/r/confluentinc/cp-kafka) |
| Elasticsearch | 8.12.2 | [https://www.elastic.co/cn/downloads/elasticsearch](https://www.elastic.co/cn/downloads/elasticsearch)                          |




### 搭建步骤

> Docker Compose 环境部署

- Ubuntu 22.04 版本
- Docker 26.0.0 版本

服务器部署：

- 前端源码（`/frontend`）修改 `vite.config.ts`、`.env.development`、`nginx.conf` 三个文件中的 IP 地址（`127.0.0.1`）为实际服务器地址

- `docker-compose.yml` 中两处 `${DOCKER_HOST_IP:-127.0.0.1}` 修改为实际服务器地址

- 服务器放行端口：8080、2181、9092、29092、5601、9200

- 执行下述指令，一键部署 `wms` 项目
```
docker compose up --build -d
```


## 联系作者

vx联系，可直接私信交流，尽力为您解答

![微信二维码](frontend/public/vx.png)