Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LiuKay/mmall-java
A simple project to learn different architecture (Monolithic on SpringBoot, Microservices on SpringCloud, K8S etc.). 一个简单的学习项目(Mall 商城)， 用来学习单体架构，微服务架构，K8S等
https://github.com/LiuKay/mmall-java
java k8s mmall spring-boot spring-cloud
Last synced: 21 days ago
JSON representation
A simple project to learn different architecture (Monolithic on SpringBoot, Microservices on SpringCloud, K8S etc.). 一个简单的学习项目(Mall 商城)， 用来学习单体架构，微服务架构，K8S等
- Host: GitHub
- URL: https://github.com/LiuKay/mmall-java
- Owner: LiuKay
- License: apache-2.0
- Created: 2018-03-19T00:42:15.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-10-20T06:59:57.000Z (about 2 years ago)
- Last Synced: 2024-11-12T14:02:49.986Z (30 days ago)
- Topics: java, k8s, mmall, spring-boot, spring-cloud
- Language: Java
- Homepage:
- Size: 17.4 MB
- Stars: 68
- Watchers: 2
- Forks: 30
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - LiuKay/mmall-java - A simple project to learn different architecture (Monolithic on SpringBoot, Microservices on SpringCloud, K8S etc.). 一个简单的学习项目(Mall 商城)， 用来学习单体架构，微服务架构，K8S等 (Java)
README
# MMall
[](https://sonarcloud.io/summary/new_code?id=LiuKay_mmall-java)
[](https://sonarcloud.io/summary/new_code?id=LiuKay_mmall-java)
A simple project to learn different architectures.
## What - 这是什么
Mmall 是一个十分简化的商城项目，仅包含了用户、支付、库存管理等能支撑一个购物流程的业务功能，同时也包括了一些非业务功能，
包括登录、身份认证、鉴权等。通过一些简化，从而来更好的学习不同的架构风格是什么样的。从单体服务风格，到微服务架构，再到
云原生，不同的架构为了架构本身的问题而引入了一些新的组件。
> Based on [https://github.com/fenixsoft/monolithic_arch_springboot](https://github.com/fenixsoft/monolithic_arch_springboot) and made some improvements.
>
> 本项目基于周志明老师的[凤凰架构](https://icyfenix.cn/introduction/about-the-fenix-project.html)中的示例项目:[单体架构](https://github.com/fenixsoft/monolithic_arch_springboot). 在此基础上做一些改进和修改。
## Current Version - 当前分支版本:
Microservices SpringCloud - 微服务 SpringCloud 版: [microservices_springcloud]([LiuKay/mmall-java at microservices_springcloud (github.com)](https://github.com/LiuKay/mmall-java/tree/microservices_springcloud))
| service | port | comment |
| ---------------------------- | ---- | -------------------------------------------------------- |
| mmall-domain-security | 8301 | security service, OAuth2, JWT |
| mmall-domain-account | 8401 | account service |
| mmall-domain-warehouse | 8501 | product, stockpile service |
| mmall-domain-payment | 8601 | payment, wallet service |
| mmall-domain-registry | 8761 | services registry center |
| mmall-domain-gateway | 8080 | API Gateway |
| mmall-platform-configuration | 8888 | configurations |
| mmall-lib-infrastructure | NA | infrastructure library, domain, dto, utils, lock service |
| | | |
## Technology - 技术选型
- SpringBoot
- Spring Cache + Redis
- Redisson as distributed lock
- Spring Data JPA
- Spring Security
- Spring Security OAuth 2.3
- Spring Security JWT
- Jackson
- Bean Validation 2.0 (Hibernate Validator 6)
- Netflix Zuul
- Netflix Eureka
- Netflix Feign
- Spring Config
## Get Started
### Local Run - 本地运行
依赖的测试基础设施环境使用 Docker Compose 打包（见 docker-compose.yml），MySQL, Redis 等。
本地演示会将所有service 打包到 Docker 运行，详情见 `docker-compose.dev.yml`
```shell
# 启动 docker 之后可以使用该命令启动演示
./deploy_to_docker.sh
# 或者
./gradlew clean
./gradlew assemble
docker-compose -f ./docker-compose.dev.yml up -d
```
### Debug - 调式模式
调式模式只在 Docker 环境中启动需要的基础设施，如 Redis， MySQL 等，业务服务可以在 IDEA 中分别启动，或使用 Gradle 命令分别启动，按照先启动 registery，configuration 再启动其他。
```shell
# 1.setup infrastructure
docker-compose -f ./docker-compose.debug.yml up -d
# 2.setup services
./gradlew :mmall-platform-registry:bootRun
./gradlew :mmall-platform-configuration:bootRun
./gradlew :mmall-platform-gateway:bootRun
./gradlew :mmall-domain-security:bootRun
./gradlew :mmall-domain-account:bootRun
./gradlew :mmall-domain-payment:bootRun
./gradlew :mmall-domain-warehouse:bootRun
```
进入主页 [http://localhost:8080/](http://localhost:8080/) 默认账号 kaybee, 密码 123456
-----
### Develop Plan - 开发计划
- 单体版本使用 SpringBoot (已完成)，分支： [feature/monolithic_springboot](https://github.com/LiuKay/mmall-java/tree/feature/monolithic_springboot)
- 微服务版本使用 Spring Cloud 体系 （已完成），分支：[feature/microservices_springcloud](https://github.com/LiuKay/mmall-java/tree/feature/microservices_springcloud)
- K8s 版本 （开发中）
## Frontend Project - 前端项目
[https://github.com/LiuKay/mmall-frontend](https://github.com/LiuKay/mmall-frontend)
## Other Versions - 其他版本（分支）
- v1.0
单服务器 + FTP文件服务器,
主要技术：SSM/Guava/Jackson/Joda/注解
- v2.0
Tomcat集群+Nginx负载均衡+Redis分布式,
在V1.0基础上进行迭代重构，主要技术Redis 、Spring Schedule、Tomcat集群、Nginx负载均衡
- v3.0_springboot_Deprecated （已废弃）
重构了登录鉴权的部分