Spring Boot Multi-tenant Microservice Archetype

Que genera este arquetipo

Este arquetipo de Maven genera un microservicio Spring Boot listo para produccion con soporte multi-tenant integrado. El servicio generado incluye:

  • Arquitectura Hexagonal con separacion clara entre dominio, puertos y adaptadores.

  • Modelo de dominio basado en Domain-Driven Design.

  • Aislamiento de datos por tenant a nivel de esquema de base de datos.

  • Publicacion y consumo de eventos de dominio con garantias de entrega.

  • API REST documentada con OpenAPI.

  • Seguridad pre-autenticada para operar detras de un API Gateway.

  • Testing BDD en dos capas: unitario e integracion end-to-end.

Cuando usar este arquetipo

Usa este arquetipo cuando…​ Considera otra opcion si…​

Tu servicio necesita aislar datos por tenant.

Tu servicio opera en un unico tenant — usa el arquetipo single-tenant.

Necesitas comunicacion asincrona entre servicios con garantias de entrega.

Tu dominio es simple y no requiere eventos distribuidos.

Quieres arquitectura hexagonal y DDD desde el inicio.

Prefieres un monolito modular — evalua el arquetipo modular-monolith.

Secciones

  • Primeros Pasos — como instanciar el arquetipo y ejecutar el servicio localmente.

  • Arquitectura — capas hexagonales, convenciones de nombres y reglas de dependencia.