LiuKay / mmall-java

A simple project to learn different architecture (Monolithic on SpringBoot, Microservices on SpringCloud, K8S etc.). 一个简单的学习项目(Mall 商城)， 用来学习单体架构，微服务架构，K8S等

MMall

A simple project to learn different architectures.

What - 这是什么

Mmall 是一个十分简化的商城项目，仅包含了用户、支付、库存管理等能支撑一个购物流程的业务功能，同时也包括了一些非业务功能， 包括登录、身份认证、鉴权等。通过一些简化，从而来更好的学习不同的架构风格是什么样的。从单体服务风格，到微服务架构，再到 云原生，不同的架构为了架构本身的问题而引入了一些新的组件。

Based on https://github.com/fenixsoft/monolithic_arch_springboot and made some improvements.

本项目基于周志明老师的凤凰架构中的示例项目:单体架构. 在此基础上做一些改进和修改。

Current Version - 当前分支版本:

Microservices SpringCloud - 微服务 SpringCloud 版: [microservices_springcloud](LiuKay/mmall-java at microservices_springcloud (github.com))

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

# 启动 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 再启动其他。

# 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/ 默认账号 kaybee, 密码 123456

---

Develop Plan - 开发计划

• 单体版本使用 SpringBoot (已完成)，分支： feature/monolithic_springboot
• 微服务版本使用 Spring Cloud 体系 （已完成），分支：feature/microservices_springcloud
• K8s 版本 （开发中）

Frontend Project - 前端项目

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 （已废弃）

  重构了登录鉴权的部分