# mall

**Repository Path**: oldxuedu/mall

## Basic Information

- **Project Name**: mall
- **Description**: mall微服务商城，可本地部署，可k8s部署
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-11-28
- **Last Updated**: 2024-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mall-电商微服务

## 项目介绍

本项目从‘mall-swarm’项目改造而来; `mall-swarm`是一套微服务商城系统，采用了 Spring Cloud 2021 & Alibaba、Spring Boot 2.7、Oauth2、MyBatis、Elasticsearch、Docker、Kubernetes等核心技术，同时提供了基于Vue的管理后台方便快速搭建系统。`mall-swarm`在电商业务的基础集成了注册中心、配置中心、监控中心、网关等系统功能。

## 系统架构图

![系统架构图](http://img.macrozheng.com/mall/project/mall_micro_service_arch.jpg)

## 组织结构

``` lua
项目目录结构：
mall
├── mall-auth -- 基于Spring Security Oauth2的统一的认证中心            【8401】
├── mall-gateway -- 基于Spring Cloud Gateway的微服务API网关服务        【8201】
├── mall-admin -- 后台管理系统服务                                    【8202】
├── mall-search -- 基于Elasticsearch的商品搜索系统服务                【8081】
├── mall-portal -- 移动端商城系统服务                                【8085】
├── mall-monitor -- 基于Spring Boot Admin的微服务监控中心	           【8101】
├── mall-demo -- 微服务远程调用测试服务
├── mall-common -- 工具类及通用代码模块
├── mall-mbg -- MyBatisGenerator生成的数据库操作代码模块
└── config -- 配置
    └── mall.sql -- SQL文件
    └── nacos_config_local_2023.zip		-- 本地搭建使用的配置
    └── nacos_config_k8s_2023.zip		-- k8s环境搭建使用的配置
```

## 技术选型

### 后端技术

| 技术                   | 说明                | 官网                                             |
| ---------------------- | ------------------- | ------------------------------------------------ |
| Spring Cloud           | 微服务框架          | https://spring.io/projects/spring-cloud          |
| Spring Cloud Alibaba   | 微服务框架          | https://github.com/alibaba/spring-cloud-alibaba  |
| Spring Boot            | 容器+MVC框架        | https://spring.io/projects/spring-boot           |
| Spring Security Oauth2 | 认证和授权框架      | https://spring.io/projects/spring-security-oauth |
| MyBatis                | ORM框架             | http://www.mybatis.org/mybatis-3/zh/index.html   |
| MyBatisGenerator       | 数据层代码生成      | http://www.mybatis.org/generator/index.html      |
| PageHelper             | MyBatis物理分页插件 | http://git.oschina.net/free/Mybatis_PageHelper   |
| Knife4j                | 文档生产工具        | https://github.com/xiaoymin/swagger-bootstrap-ui |
| Elasticsearch          | 搜索引擎            | https://github.com/elastic/elasticsearch         |
| RabbitMq               | 消息队列            | https://www.rabbitmq.com/                        |
| Redis                  | 分布式缓存          | https://redis.io/                                |
| MongoDb                | NoSql数据库         | https://www.mongodb.com/                         |
| Docker                 | 应用容器引擎        | https://www.docker.com/                          |
| Druid                  | 数据库连接池        | https://github.com/alibaba/druid                 |
| OSS                    | 对象存储            | https://github.com/aliyun/aliyun-oss-java-sdk    |
| MinIO                  | 对象存储            | https://github.com/minio/minio                   |
| JWT                    | JWT登录支持         | https://github.com/jwtk/jjwt                     |
| Lombok                 | 简化对象封装工具    | https://github.com/rzwitserloot/lombok           |
| Seata                  | 全局事务管理框架    | https://github.com/seata/seata                   |
| Kubernetes             | 应用容器管理平台    | https://kubernetes.io/                           |

### 前端技术

| 技术       | 说明                  | 官网                           |
| ---------- | --------------------- | ------------------------------ |
| Vue        | 前端框架              | https://vuejs.org/             |
| Vue-router | 路由框架              | https://router.vuejs.org/      |
| Vuex       | 全局状态管理框架      | https://vuex.vuejs.org/        |
| Element    | 前端UI框架            | https://element.eleme.io/      |
| Axios      | 前端HTTP框架          | https://github.com/axios/axios |
| v-charts   | 基于Echarts的图表框架 | https://v-charts.js.org/       |


## 环境搭建

### 开发环境

| 工具          | 版本号     | 下载                                                         |
| ------------- | ---------- | ------------------------------------------------------------ |
| JDK           | 1.8        | https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html |
| Mysql         | 5.7 OR 8.0 | https://www.mysql.com/                                       |
| Redis         | 6.0 OR 7.0 | https://redis.io/download                                    |
| Elasticsearch | 7.17.7     | https://www.elastic.co/cn/downloads/elasticsearch            |
| Kibana        | 7.17.7     | https://www.elastic.co/cn/downloads/kibana                   |
| Logstash      | 7.17.7     | https://www.elastic.co/cn/downloads/logstash                 |
| MongoDb       | 5.0        | https://www.mongodb.com/download-center                      |
| RabbitMq      | 3.12       | http://www.rabbitmq.com/download.html                        |
| nginx         | 1.24       | http://nginx.org/en/download.html                            |



[Apache License 2.0](https://github.com/macrozheng/mall-swarm/blob/master/LICENSE)

Copyright (c) 2018-2022 macrozheng