mall - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #golang #android #machine-learning #deep-learning #nodejs #macos #windows #awesome #kubernetes #mcp #open-source

mall

(★ 84,558)

mall 프로젝트는 Spring Boot와 MyBatis를 기반으로 구현되고 Docker 컨테이너화 배포를 채택한 프론트엔드 쇼핑몰 시스템과 백엔드 관리 시스템을 포함하는 이커머스 시스템입니다. 프론트엔드 쇼핑몰 시스템은 메인 페이지 포털, 상품 추천, 상품 검색, 상품 진열, 장바구니, 주문 프로세스, 회원 센터, 고객 서비스, 도움말 센터 등의 모듈을 포함합니다. 백엔드 관리 시스템은 상품 관리, 주문 관리, 회원 관리, 프로모션 관리, 운영 관리, 콘텐츠 관리, 통계 보고서, 재무 관리, 권한 관리, 설정 등의 모듈을 포함합니다.

mall 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# mall

<p>
  <a href="#公众号"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%85%AC%E4%BC%97%E5%8F%B7-macrozheng-blue.svg" alt="公众号"></a>
  <a href="#公众号"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E4%BA%A4%E6%B5%81-%E5%BE%AE%E4%BF%A1%E7%BE%A4-2BA245.svg" alt="交流"></a>
  <a href="https://github.com/macrozheng/mall-learning"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%AD%A6%E4%B9%A0%E6%95%99%E7%A8%8B-mall--learning-green.svg" alt="学习教程"></a>
  <a href="https://github.com/macrozheng/mall-swarm"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/Cloud%E7%89%88%E6%9C%AC-mall--swarm-brightgreen.svg" alt="SpringCloud版本"></a>
  <a href="https://github.com/macrozheng/mall-admin-web"><img src="https://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%90%8E%E5%8F%B0%E7%AE%A1%E7%90%86%E7%B3%BB%E7%BB%9F-mall--admin--web-green.svg" alt="后台管理系统"></a>
  <a href="https://github.com/macrozheng/mall-app-web"><img src="https://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%89%8D%E5%8F%B0%E5%95%86%E5%9F%8E%E9%A1%B9%E7%9B%AE-mall--app--web-green.svg" alt="前台商城项目"></a>
  <a href="https://gitee.com/macrozheng/mall"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E7%A0%81%E4%BA%91-%E9%A1%B9%E7%9B%AE%E5%9C%B0%E5%9D%80-orange.svg" alt="码云"></a>
</p>

## 참고 팁

> 1. **프로젝트 빠르게 체험하기**: [온라인 접속 주소](https://www.macrozheng.com/admin/index.html)
> 2. **전체 학습 튜토리얼**: [《mall 학습 튜토리얼》](https://www.macrozheng.com)
> 3. **동영상 튜토리얼**: [《mall 동영상 튜토리얼》](https://www.macrozheng.com/mall/catalog/mall_video.html)
> 4. **마이크로서비스 버전**: Spring Cloud Alibaba 기반 프로젝트: [mall-swarm](https://github.com/macrozheng/mall-swarm)
> 5. **브랜치 설명**: `master` 브랜치는 Spring Boot 3.5 + JDK 17 기반이며, `dev-v2` 브랜치는 Spring Boot 2.7 + JDK 8 기반입니다.

## 서문

`mall` 프로젝트는 현시점의 주류 기술을 사용하여 완전한 이 쇼핑몰 시스템을 구축하는 것을 목표로 합니다.

## 프로젝트 문서

문서 주소: [https://www.macrozheng.com](https://www.macrozheng.com)

## 프로젝트 소개

`mall` 프로젝트는 쇼핑몰 시스템 세트로, 프론트엔드 쇼핑몰 시스템과 백엔드 관리 시스템을 포함하며 SpringBoot + MyBatis를 기반으로 구현되었고 Docker 컨테이너화 배포를 채택했습니다. 프론트엔드 쇼핑몰 시스템은 홈 포털, 상품 추천, 상품 검색, 상품 진열, 장바구니, 주문 프로세스, 회원 센터, 고객 서비스, 도움말 센터 등의 모듈을 포함합니다. 백엔드 관리 시스템은 상품 관리, 주문 관리, 회원 관리, 프로모션 관리, 운영 관리, 콘텐츠 관리, 통계 보고서, 재무 관리, 권한 관리, 설정 등의 모듈을 포함합니다.

### 프로젝트 데모

#### 백엔드 관리 시스템

프론트엔드 프로젝트 `mall-admin-web` 주소: https://github.com/macrozheng/mall-admin-web

프로젝트 데모 주소: [https://www.macrozheng.com/admin/index.html](https://www.macrozheng.com/admin/index.html)

![백엔드 관리 시스템 기능 데모](https://raw.githubusercontent.com/macrozheng/mall/master/document/resource/mall_admin_show.png)

#### 프론트엔드 쇼핑몰 시스템

프론트엔드 프로젝트 `mall-app-web` 주소: https://github.com/macrozheng/mall-app-web

프로젝트 데모 주소 (브라우저를 모바일 모드로 전환하면 더 좋은 효과를 볼 수 있습니다): [https://www.macrozheng.com/app/](https://www.macrozheng.com/app/)

![프론트엔드 쇼핑몰 시스템 기능 데모](https://raw.githubusercontent.com/macrozheng/mall/master/document/resource/re_mall_app_show.jpg)

### 조직 구조

```
mall
├── mall-common -- 유틸리티 클래스 및 공통 코드
├── mall-mbg -- MyBatisGenerator가 생성한 데이터베이스 조작 코드
├── mall-security -- SpringSecurity 캡슐화 공용 모듈
├── mall-admin -- 백엔드 쇼핑몰 관리 시스템 인터페이스
├── mall-search -- Elasticsearch 기반 상품 검색 시스템
├── mall-portal -- 프론트엔드 쇼핑몰 시스템 인터페이스
└── mall-demo -- 프레임워크 구축 시 테스트 코드
```

### 기술 스택

#### 백엔드 기술

| 기술                 | 설명                | 공식 홈페이지                                    |
| -------------------- | ------------------- | ---------------------------------------------- |
| SpringBoot           | Web 애플리케이션 개발 프레임워크      | https://spring.io/projects/spring-boot         |
| SpringSecurity       | 인증 및 인가 프레임워크      | https://spring.io/projects/spring-security     |
| MyBatis              | ORM 프레임워크             | http://www.mybatis.org/mybatis-3/zh/index.html |
| MyBatisGenerator     | 데이터 계층 코드 생성기     | http://www.mybatis.org/generator/index.html    |
| Elasticsearch        | 검색엔진            | https://github.com/elastic/elasticsearch       |
| RabbitMQ             | 메시지 큐            | https://www.rabbitmq.com/                      |
| Redis                | 인메모리 데이터 스토리지         | https://redis.io/                              |
| MongoDB              | NoSQL 데이터베이스         | https://www.mongodb.com                        |
| LogStash             | 로그 수집 도구        | https://github.com/elastic/logstash            |
| Kibana               | 로그 시각화 조회 도구  | https://github.com/elastic/kibana              |
| Nginx                | 정적 리소스 서버      | https://www.nginx.com/                         |
| Docker               | 앱 컨테이너 엔진        | https://www.docker.com                         |
| Jenkins              | 자동화 배포 도구      | https://github.com/jenkinsci/jenkins           |
| 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               | Java 언어 확장 라이브러리      | https://github.com/rzwitserloot/lombok         |
| Hutool               | Java 유틸리티 라이브러리        | https://github.com/looly/hutool                |
| PageHelper           | MyBatis 물리적 페이징 플러그인 | http://git.oschina.net/free/Mybatis_PageHelper |
| SpringDoc            | API 문서 생성 도구      | https://github.com/springdoc/springdoc-openapi |
| Hibernator-Validator | 검증 프레임워크            | http://hibernate.org/validator                 |

#### 프론트엔드 기술

| 기술       | 설명                  | 공식 홈페이지                                   |
| ---------- | --------------------- | -------------------------------------- |
| 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/               |
| Js-cookie  | cookie 관리 도구        | https://github.com/js-cookie/js-cookie |
| nprogress  | 프로그레스 바 컨트롤        | https://github.com/rstacruz/nprogress  |

#### 모바일 기술

| 기술         | 설명             | 공식 홈페이지                                    |
| ------------ | ---------------- | --------------------------------------- |
| Vue          | 코어 프론트엔드 프레임워크     | https://vuejs.org                       |
| Vuex         | 글로벌 상태 관리 프레임워크 | https://vuex.vuejs.org                  |
| uni-app      | 모바일 프론트엔드 프레임워크   | https://uniapp.dcloud.io                |
| mix-mall     | 쇼핑몰 프로젝트 템플릿     | https://ext.dcloud.net.cn/plugin?id=200 |
| luch-request | HTTP 요청 프레임워크     | https://github.com/lei-mu/luch-request  |

#### 아키텍처 다이어그램

##### 시스템 아키텍처 다이어그램

![시스템 아키텍처 다이어그램](https://raw.githubusercontent.com/macrozheng/mall/master/document/resource/re_mall_system_arch.jpg)

##### 비즈니스 아키텍처 다이어그램

![비즈니스 아키텍처 다이어그램](https://raw.githubusercontent.com/macrozheng/mall/master/document/resource/re_mall_business_arch.jpg)

#### 모듈 소개

##### 백엔드 관리 시스템 `mall-admin`

- 상품 관리: [기능 구조도-상품.jpg](document/resource/mind_product.jpg)
- 주문 관리: [기능 구조도-주문.jpg](document/resource/mind_order.jpg)
- 프로모션 관리: [기능 구조도-프로모션.jpg](document/resource/mind_sale.jpg)
- 콘텐츠 관리: [기능 구조도-콘텐츠.jpg](document/resource/mind_content.jpg)
- 회원 관리: [기능 구조도-회원.jpg](document/resource/mind_member.jpg)

##### 프론트엔드 쇼핑몰 시스템 `mall-portal`

[기능 구조도-포털.jpg](document/resource/mind_portal.jpg)

#### 개발 진행 상황

![프로젝트 개발 진행 상황 다이어그램](https://raw.githubusercontent.com/macrozheng/mall/master/document/resource/re_mall_dev_flow.jpg)

## 환경 구축

### 개발 도구

| 도구          | 설명                | 공식 홈페이지                                            |
| ------------- | ------------------- | ----------------------------------------------- |
| IDEA          | 개발 IDE             | https://www.jetbrains.com/idea/download         |
| RedisDesktop  | redis 클라이언트 연결 도구 | https://github.com/qishibo/AnotherRedisDesktopManager  |
| Robomongo     | mongo 클라이언트 연결 도구 | https://robomongo.org/download                  |
| SwitchHosts   | 로컬 host 관리        | https://oldj.github.io/SwitchHosts/             |
| X-shell       | Linux 원격 연결 도구   | http://www.netsarang.com/download/software.html |
| Navicat       | 데이터베이스 연결 도구      | http://www.formysql.com/xiazai.html             |
| PowerDesigner | 데이터베이스 설계 도구      | http://powerdesigner.de/                        |
| Axure         | 프로토타입 디자인 도구        | https://www.axure.com/                          |
| MindMaster    | 마인드맵 디자인 도구    | http://www.edrawsoft.cn/mindmaster              |
| ScreenToGif   | gif 녹화 도구         | https://www.screentogif.com/                    |
| ProcessOn     | 순서도 작성 도구      | https://www.processon.com/                      |
| PicPick       | 이미지 처리 도구        | https://picpick.app/zh/                         |
| Snipaste      | 화면 캡처 도구        | https://www.snipaste.com/                       |
| Postman       | API 인터페이스 디버깅 도구      | https://www.postman.com/                        |
| Typora        | Markdown 편집기      | https://typora.io/                              |

### 개발 환경

| 도구          | 버전 번호 | 다운로드                                                         |
| ------------- | ------ | ------------------------------------------------------------ |
| JDK           | 17     | https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html |
| MySQL         | 5.7    | https://www.mysql.com/                                       |
| Redis         | 7.0    | https://redis.io/download                                    |
| MongoDB       | 5.0    | https://www.mongodb.com/download-center                      |
| RabbitMQ      | 3.10.5 | http://www.rabbitmq.com/download.html                        |
| Nginx         | 1.22   | http://nginx.org/en/download.html                            |
| Elasticsearch | 7.17.3 | https://www.elastic.co/downloads/elasticsearch               |
| Logstash      | 7.17.3 | https://www.elastic.co/cn/downloads/logstash                 |
| Kibana        | 7.17.3 | https://www.elastic.co/cn/downloads/kibana                   |

### 구축 단계

> Windows 환경 배포

- Windows 환경 구축은 다음을 참고하세요: [mall의 Windows 환경 배포](https://www.macrozheng.com/mall/deploy/mall_deploy_windows.html);
- 주의: `mall-admin` 모듈만 실행할 경우, MySQL과 Redis만 설치하면 됩니다;
- `mall-admin-web` 프로젝트를 클론한 후 IDEA로 가져와 컴파일을 완료합니다: [프론트엔드 프로젝트 주소](https://github.com/macrozheng/mall-admin-web);
- `mall-admin-web` 프로젝트의 설치 및 배포는 다음을 참고하세요: [mall 프론트엔드 프로젝트 설치 및 배포](https://www.macrozheng.com/mall/deploy/mall_deploy_web.html).

> Docker 환경 배포

- 가상 머신을 이용한 CentOS 7.6 설치는 다음을 참고하세요: [가상 머신 설치 및 Linux 사용, 이 글로 충분합니다](https://www.macrozheng.com/tool/linux_install.html);
- 본 프로젝트 Docker 이미지 빌드는 다음을 참고하세요: [Maven 플러그인을 사용하여 SpringBoot 애플리케이션의 Docker 이미지 빌드하기](https://www.macrozheng.com/project/maven_docker_fabric8.html);
- 본 프로젝트의 Docker 컨테이너 환경 배포는 다음을 참고하세요: [mall의 Linux 환경 배포 (Docker 컨테이너 기반)](https://www.macrozheng.com/mall/deploy/mall_deploy_docker.html);
- 본 프로젝트의 Docker Compose 사용은 다음을 참고하세요: [mall의 Linux 환경 배포 (Docker Compose 기반)](https://www.macrozheng.com/mall/deploy/mall_deploy_docker_compose.html);
- 본 프로젝트의 Linux 자동화 배포는 다음을 참고하세요: [mall의 Linux 환경 자동화 배포 (Jenkins 기반)](https://www.macrozheng.com/mall/deploy/mall_deploy_jenkins.html);

> 관련 환경 배포

- ELK 로그 수집 시스템 구축은 다음을 참고하세요: [mall 프로젝트 ELK 로그 수집 솔루션](https://www.macrozheng.com/project/mall_kibana_start.html);
- MinIO를 이용한 파일 스토리지는 다음을 참고하세요: [MinIO를 이용한 파일 스토리지 구현](https://www.macrozheng.com/project/minio_console_start.html);
- 읽기/쓰기 분리 솔루션은 다음을 참고하세요: [아직도 코드에서 읽기/쓰기 분리를 하시나요? 이 미들웨어를 시도해 보세요](https://www.macrozheng.com/project/gaea.html);
- Redis 클러스터 솔루션은 다음을 참고하세요: [Docker 환경에서 Redis 클러스터 초고속 구축](https://www.macrozheng.com/blog/redis_cluster.html).

## 공식 계정

위챗(WeChat) 그룹에 참여하여 소통하려면 공식 계정 「**macrozheng**」을 팔로우한 후 「**加群**」(그룹 참여)이라고 메시지를 보내세요.

![공식 계정 이미지](https://raw.githubusercontent.com/macrozheng/mall/master/document/resource/qrcode_for_macrozheng_258.jpg)

## 라이선스

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

Copyright (c) 2018-2026 macrozheng