Skip to content

Springboot project template administration module with hexagonal architecture

License

Notifications You must be signed in to change notification settings

RuddyQuispe/template-admin-hexagonal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛠️ Template de Administración con Spring Boot 3.5

Java Spring Boot PostgreSQL Build License Swagger

📌 Descripción

Este proyecto es un template de administración que utiliza Spring Boot 3.5, Java 21 y sigue el patrón de Arquitectura Hexagonal. Está diseñado para facilitar el desarrollo de la parte administrativa de un sistema, proporcionando una estructura limpia y modular.


🚀 Tecnologías y Herramientas

  • Java 21
  • Spring Boot 3.5
  • Spring Data JPA / Hibernate
  • MapStruct – para mapeo automático de DTOs
  • PostgreSQL – como base de datos relacional
  • Swagger / OpenAPI – para documentación interactiva de APIs
  • Lombok – para reducir boilerplate
  • Spring Validation – para validaciones de entrada
  • Maven – gestión de dependencias

📁 Estructura del Proyecto

└── src
    └── main
        ├── java
        │   └── edu
        │       └── bo
        │           └── uyunicode
        │               └── template
        │                   └── admin
        │                       ├── application
        │                       │   ├── input
        │                       │   ├── output
        │                       │   └── service
        │                       ├── domain
        │                       │   ├── dto
        │                       │   │   ├── request
        │                       │   │   └── response
        │                       │   ├── entity
        │                       │   ├── exceptions
        │                       │   ├── mappers
        │                       │   └── models
        │                       ├── infrastructure
        │                       │   ├── persistence
        │                       │   │   └── repository
        │                       │   └── rest
        │                       └── utils
        └── resources

🔧 Configuración Inicial

  1. Clonar el repositorio:
    git clone https://github.com/RuddyQuispe/template-admin-hexagonal.git
    cd template-admin-hexagonal

📖 Documentación de la API

Una vez ejecutado, accede a la documentación Swagger en:

http://localhost:8080/swagger-ui/index.html

📖 Documentación de codigo (Javadoc)

   mvn javadoc:jar 

Una vez ejecutado, accede a la documentación en:

   file:///${PROJECT_PATH}/template-administration/target/apidocs/index.html

✅ Estado del Proyecto

  • Estructura base con Arquitectura Hexagonal
  • Integración con PostgreSQL
  • Documentación Swagger activa
  • Mapeos DTO con MapStruct
  • Autenticación y autorización (pendiente)
  • Pruebas unitarias y de integración
  • Dockerización avanzada

About

Springboot project template administration module with hexagonal architecture

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages