Spring Boot Web Community Template 🚀

Elige tu idioma | Choose your language:

• Español
• English

---

Español

Índice

1. Descripción General
2. Características Principales
3. Tecnologías y Dependencias
4. Instalación y Puesta en Marcha
5. Arquitectura del proyecto
6. Licencia

Descripción General 🌟

Una plantilla completa de Spring Boot que implementa patrones de arquitectura modernos y mejores prácticas. Esta plantilla proporciona una base sólida para construir microservicios escalables y mantenibles.

¿Quieres más funcionalidades y soporte adicional?

Accede a la versión completa de la plantilla con características adicionales y soporte exclusivo para entornos de producción a través de la versión comercial.

Características Principales 🔑

• Arquitectura Hexagonal
• Containerización con Docker Compose
• Pruebas unitarias
• PostgresSQL con Soporte Vector

Tecnologías & Dependencias 🛠️

• Java 21
• Spring Boot 3.4.4
• Spring Data JPA
• PostgreSQL
• Docker & Docker Compose
• JUnit 5
• Lombock
• MapStruct
• DevTools

Instalación & Puesta en Marcha 🚀

1. Clona el repositorio:

   git clone https://github.com/David-DAM/spring-boot-web-template-community.git
   cd spring-boot-web-template-community
   

2. Configura las variables de entorno si es necesario.
3. Instala las dependencias

   mvn clean install
   

4. Inicia los servicios:

   docker-compose up -d
   

5. Ejecuta la aplicación:

   ./mvnw spring-boot:run
   

Arquitectura del proyecto

Este proyecto utiliza el patrón Mediator para una separación clara de responsabilidades y facilitar la extensibilidad.

Cada operación se representa por una combinación de:

Request → Objeto que representa la entrada del usuario.

Handler → Lógica de negocio que procesa el Request.

Response → Resultado devuelto por el handler.

Este patrón se implementa gracias a una capa personalizada que enruta cada request a su handler correspondiente.

Esto permite tener controladores extremadamente delgados y lógica desacoplada.

Licencia

Versión gratuita

Esta plantilla cuenta con la licencia MIT License.

Puede usarla, modificarla y distribuirla libremente para proyectos personales, educativos o no comerciales.

Versión comercial

Para uso comercial, consulte el Acuerdo de licencia comercial.

La versión comercial incluye funciones y soporte adicionales. Debe adquirir la licencia comercial para usar esta plantilla en entornos de producción o con fines comerciales.

---

English

Index

1. Overview
2. Key Features
3. Technologies & Dependencies
4. Setup & Installation
5. Project Architecture
6. License

Overview 🌟

A comprehensive Spring Boot template implementing modern architecture patterns and best practices. This template provides a solid foundation for building scalable and maintainable microservices.

Want more features and additional support?

Access the full version of the template with additional features and exclusive support for production environments through the commercial version.

Key Features 🔑

• Hexagonal Architecture
• Containerization with Docker Compose
• PostgresSQL with Vector Support

Technologies & Dependencies 🛠️

• Java 21
• Spring Boot 3.4.4
• Spring Data JPA
• PostgresSQL
• Docker & Docker Compose
• JUnit 5
• Lombock
• MapStruct
• DevTools

Setup & Installation 🚀

1. Clone the repository:

   git clone https://github.com/David-DAM/spring-boot-web-template-community.git
   cd spring-boot-web-template-community
   

2. Set up environment variables if needed.
3. Install dependencies

   mvn clean install
   

4. Start the services:

   docker-compose up -d
   

5. Run the application:

   mvn spring-boot:run
   

Project Architecture

This project uses the Mediator pattern for a clear separation of responsibilities and easy extensibility.

Each operation is represented by a combination of:

Request → Object representing user input.

Handler → Business logic that processes the Request.

Response → Result returned by the handler.

This pattern is implemented through a custom layer that routes each request to its corresponding handler.

This allows for extremely lean controllers and decoupled logic.

License

Free Version

This template is licensed under the MIT License.

You can freely use, modify, and distribute this template for personal, educational, or non-commercial projects.

Commercial Version

For commercial use, please refer to the Commercial License Agreement.

The commercial version includes additional features and support. You must purchase the commercial license to use this template in production environments or for commercial purposes.