🎯 archetype-api-microservices

• 🎯 archetype-api-microservices
• 🧩 Descripción general
• 🔖 Características
  • 📋 Requisitos
• 🪛 Crear un proyecto
  • 📀 Instalación
  • 💻 Construir en Terminal bash
  • 🖥️ Construir en Terminal cmd
  • 🧮 Estructura del proyecto
  • 🔧 Tecnologías Usadas
  • ⚙️ Configuración rápida
  • 🧰 Integración de dependencias
  • 📦 Ejemplo de código
• 🧪 Uso
• 👨🏻‍💻 Contribuciones
• 📞 Contacto

🧩 Descripción general

Este arquetipo proporciona una estructura básica para iniciar proyectos en Java utilizando el framework Spring. Está diseñado para facilitar el desarrollo rápido y eficiente de aplicaciones rest.

🔖 Características

📋 Requisitos

Asegúrate de tener instalado:

• Java OpenJDK 21
• Maven 3.6 o superior
• Git

Herramienta	Version	Recurso
Java OpenJDK	21	resources
Maven	3.6.2	resources
Git	latest	win, mac, linux

🪛 Crear un proyecto

📀 Instalación

Clonar el Proyecto

Para clonar este proyecto, utiliza el siguiente comando:

git clone https://github.com/dbacilio88/archetype-api-microservices.git

cd archetype-api-microservices

mvn clean install

💻 Construir en Terminal bash

mvn archetype:generate \
-DarchetypeGroupId=com.bacsystem \
-DarchetypeArtifactId=archetype-api-microservices \
-DarchetypeVersion=1.1.0 \
-DgroupId=com.example \
-DartifactId=archetype-example \
-Dversion=1.0.0 \
-Dversion=1.0.0 \
-DpackageName=microservice \
-Dpackage=com.example \
-DinteractiveMode=false

🖥️ Construir en Terminal cmd

mvn archetype:generate ^
-DarchetypeGroupId=com.bacsystem ^
-DarchetypeArtifactId=archetype-api-microservices ^
-DarchetypeVersion=1.1.0 ^
-DgroupId=com.example ^
-DartifactId=archetype-example ^
-Dversion=1.0.0 ^
-DpackageName=microservice ^
-Dpackage=com.example ^
-DinteractiveMode=false

🧮 Estructura del proyecto

Disk:
├───deploy
├───docs
│   └───collections
├───gradle
│   └───wrapper
└───src
    ├───main
    │   ├───java
    │   │   └───com
    │   │       └───example
    │   │           └───microservice
    │   │               └───application
    │   │                   ├───components
    │   │                   │   ├───configuration
    │   │                   │   ├───enums
    │   │                   │   ├───exceptions
    │   │                   │   │   └───handler
    │   │                   │   ├───interfaces
    │   │                   │   ├───mappers
    │   │                   │   └───utils
    │   │                   ├───controllers
    │   │                   │   ├───contracts
    │   │                   │   └───implementations
    │   │                   ├───dtos
    │   │                   ├───repositories
    │   │                   │   └───entities
    │   │                   └───services
    │   │                       ├───contracts
    │   │                       └───implementations
    │   └───resources
    └───test
        ├───java
        │   └───com
        │       └───example
        └───resources

🔧 Tecnologías Usadas

java	Spring Boot	Gradle	Maven	Branch
openJDK-21	3.*	gradle-8.5	3.6 o superior	console

⚙️ Configuración rápida

Incluye configuraciones predeterminadas para Spring Boot.

🧰 Integración de dependencias

Configuración básica de Maven o Gradle para gestionar dependencias.

📦 Ejemplo de código

Incluye ejemplos de controladores, servicios y repositorios.

Ojo: Leer deploy.md del proyecto generado

🧪 Uso

Puedes agregar tus propios controladores, servicios y repositorios en las carpetas correspondientes. Modifica application.properties o application.yml para configurar tu aplicación según sea necesario.

Nota: ejecutar el componente o aplicación en perfil dev

👨🏻‍💻 Contribuciones

¿Cómo puedes ayudar?

¡Las contribuciones son bienvenidas! Si deseas contribuir a este arquetipo, por favor abre un issue o envía un pull request.

1. Prueba el arquetipo y compárteme tus impresiones.
2. Contribuye con código, ideas o mejoras.
3. Comparte este mensaje con tus colegas y en tus redes sociales.

Tu apoyo puede hacer una gran diferencia y juntos podemos construir algo increíble. 🚀 ¡Espero contar contigo!

📞 Contacto

Para más información, puedes contactar a dbacilio88