🛍️ Douyin Mall Java Template
A Production-Ready E-commerce Platform

Important

This is a production-ready template project built with Spring Boot and microservice architecture. While it demonstrates industry best practices, please thoroughly review and enhance security measures before deploying to production.

English | 简体中文

🌟 Introduction

A comprehensive Spring Boot-based e-commerce platform template with microservice architecture. This project provides a robust foundation for building scalable online shopping applications, incorporating industry-standard practices and modern technologies.

✨ Key Features

• 🏗️ Microservice Architecture - Built with Spring Cloud Alibaba
• 🔐 Security System - JWT and OAuth2 integration
• 📦 Data Management - JPA and MyBatis support
• 💾 Caching Solution - Redis integration
• 📨 Message Queue - RabbitMQ implementation
• 🔄 Gateway - Spring Cloud Gateway
• ⚙️ Service Discovery - Spring Cloud Eureka
• 🤖 AI Integration - Ready for AI feature development
• ⏰ Task Scheduling - Quartz implementation
• 📧 Email Service - Spring Mail support

🛠️ Tech Stack

Spring Boot

MySQL

Redis

RabbitMQ

Maven

📚 Table of Contents

• Prerequisites
• Project Creation Guide
• Project Structure
• Configuration
• Running the Application
• Common Issues
• Contributing
• License

🔧 Prerequisites

Important

Before you begin, ensure you have the following installed:

• JDK 17 or later
• Maven 3.6+
• MySQL 5.7+
• IntelliJ IDEA (Recommended)
• Git

🚀 Project Creation Guide

Step 1: Project Setup

Create Project Using IntelliJ IDEA

1. Open IntelliJ IDEA
2. Click "New Project"
3. Select "Spring Initializr"
4. Configure project metadata:

   Group: com.douyinmall
   Artifact: douyin-mall-java-template
   Name: douyin-mall-java-template
   Description: Douyin Mall Java Template Project
   Package name: com.douyinmall.mall
   Packaging: Jar
   Java version: 17

Select Dependencies

Core Dependencies

• Spring Web
• Spring Boot DevTools
• Lombok
• Spring Configuration Processor

Data Access

• Spring Data JPA
• MySQL Driver
• Spring Data Redis
• MyBatis Framework

Security

• Spring Security
• OAuth2 Resource Server
• Spring Session

Messaging

• Spring for RabbitMQ

Cloud Dependencies

• Eureka Discovery Client
• Config Client
• Gateway
• Resilience4j

Others

• Spring Boot Actuator
• Validation
• Java Mail Sender
• Quartz Scheduler

Step 2: Configuration

Create application.properties in src/main/resources:

# Application
spring.application.name=douyin-mall
server.port=8080

# Database
spring.datasource.url=jdbc:mysql://localhost:3306/douyin_mall?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# JPA
spring.jpa.database-platform=org.hibernate.dialect.MySQLDialect
spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=update
spring.jpa.open-in-view=false

# Disable Services Initially
spring.autoconfigure.exclude=\
  org.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration,\
  org.springframework.boot.autoconfigure.data.redis.RedisRepositoriesAutoConfiguration,\
  org.springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration

# Eureka Client
eureka.client.enabled=false

Step 3: Database Setup

CREATE DATABASE douyin_mall CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

📂 Project Structure

📦douyin-mall-java-template
 ┣ 📂src
 ┃ ┣ 📂main
 ┃ ┃ ┣ 📂java
 ┃ ┃ ┃ ┗ 📂com
 ┃ ┃ ┃ ┃ ┗ 📂douyinmall
 ┃ ┃ ┃ ┃ ┃ ┗ 📂mall
 ┃ ┃ ┃ ┃ ┃ ┃ ┗ 📜DouyinMallJavaTemplateApplication.java
 ┃ ┃ ┗ 📂resources
 ┃ ┃ ┃ ┣ 📂static
 ┃ ┃ ┃ ┣ 📂templates
 ┃ ┃ ┃ ┗ 📜application.properties
 ┃ ┗ 📂test
 ┃ ┃ ┗ 📂java
 ┃ ┃ ┃ ┗ 📂com
 ┃ ┃ ┃ ┃ ┗ 📂douyinmall
 ┃ ┃ ┃ ┃ ┃ ┗ 📂mall
 ┃ ┃ ┃ ┃ ┃ ┃ ┗ 📜DouyinMallJavaTemplateApplicationTests.java
 ┣ 📂target
 ┃ ┣ 📂classes
 ┃ ┃ ┣ 📂com
 ┃ ┃ ┃ ┗ 📂douyinmall
 ┃ ┃ ┃ ┃ ┗ 📂mall
 ┃ ┃ ┃ ┃ ┃ ┗ 📜DouyinMallJavaTemplateApplication.class
 ┃ ┃ ┗ 📜application.properties
 ┃ ┣ 📂generated-sources
 ┃ ┃ ┗ 📂annotations
 ┃ ┣ 📂generated-test-sources
 ┃ ┃ ┗ 📂test-annotations
 ┃ ┗ 📂test-classes
 ┃ ┃ ┗ 📂com
 ┃ ┃ ┃ ┗ 📂douyinmall
 ┃ ┃ ┃ ┃ ┗ 📂mall
 ┃ ┃ ┃ ┃ ┃ ┗ 📜DouyinMallJavaTemplateApplicationTests.class
 ┣ 📜.gitattributes
 ┣ 📜.gitignore
 ┣ 📜CODE_OF_CONDUCT.md
 ┣ 📜HELP.md
 ┣ 📜LICENSE
 ┣ 📜mvnw
 ┣ 📜mvnw.cmd
 ┣ 📜pom.xml
 ┗ 📜README.md

🚀 Running the Application

Using Maven

# Build the project
mvn clean package

# Run the application
java -jar target/douyin-mall-java-template-0.0.1-SNAPSHOT.jar

Using IDE

Run the main class DouyinMallApplication.java directly in your IDE.

❗ Common Issues

JDK Version Mismatch

Tip

If you encounter JDK version issues:

• Verify JDK 17 installation
• Check project structure settings
• Confirm Maven compiler settings

Database Connection

Note

Common database connection issues:

• MySQL service status
• Database credentials
• Database existence
• Port availability

Port Conflicts

If port 8080 is occupied, modify server.port in application.properties.

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the Apache-2.0 License - see the LICENSE.md file for details.

🙋‍♀ Author

Chan Meng

• LinkedIn: chanmeng666
• GitHub: ChanMeng666

---

Made with ❤️ for Java developers
⭐ Star us on GitHub | 📖 Read our Docs | 🐛 Report Issues