Skip to content

Latest commit

 

History

History
124 lines (82 loc) · 5 KB

README.md

File metadata and controls

124 lines (82 loc) · 5 KB
Raw

MMall

Quality Gate Status Maintainability Rating

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

home

Develop Plan - 开发计划

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

    重构了登录鉴权的部分