Framework para desarrollar servicios backend en Java 25 y Spring Boot 4.1. Proporciona contratos de dominio, integración con tecnologías, configuración de infraestructura, generación de proyectos y controles de calidad para aplicaciones financieras.
| Proyecto | Contenido | Documentación |
|---|---|---|
| axiz-framework | SDK Java, puertos, adaptadores, persistencia, starters, estructuras, generador y reglas de arquitectura | Capas y dependencias, referencia de capacidades |
| axiz-tools | CLI axiz, Initializr y recetas OpenRewrite |
CLI, Initializr, recetas |
| axiz-demo | Nueve servicios que muestran un flujo de pagos con las capacidades del framework | Servicios y ejecución local, contratos |
| axiz-docs | Guías de uso, referencia de módulos y sitio MkDocs para GitHub Pages | Inicio, primer servicio |
| .github | Workflows de build, deploy y publicación, acciones reutilizables y configuración GitOps | Pipelines, destinos GitOps |
Los componentes comparten repositorio. Framework, herramientas, documentación y workflows se versionan de forma independiente. El procedimiento de publicación está en RELEASING.md.
| Capa | Responsabilidad |
|---|---|
| Platform | Parents Maven, BOM, versiones, esquema SQL y configuración del build |
| Core | Tipos, puertos y algoritmos independientes de Spring y clientes tecnológicos |
| Adapters | Implementaciones de puertos con Redis, Kafka, AWS y bases de datos |
| Kits | APIs de persistencia JDBC, JPA, R2DBC y DynamoDB |
| Spring | Autoconfiguración, propiedades tipadas, ciclo de vida e integración servlet/reactiva |
| Structures | Organización layered, hexagonal, EDA, BFF y batch |
| Extensions | Extensiones estructurales como CQRS |
| Codegen | Motor compartido, catálogos y plantillas de generación |
| Quality | Reglas ArchUnit, pruebas de contratos y estándares de código |
En un servicio hexagonal, el dominio usa Java y los contratos de Axiz; los detalles de Spring, HTTP, mensajería y persistencia permanecen en los adaptadores y en la composición de la aplicación. Las capacidades incluyen dinero y redondeo explícito, seguridad, secretos, auditoría de negocio, observabilidad, HTTP/SOAP, eventos, outbox/inbox, idempotencia, locks, secuencias, almacenamiento, notificaciones y sagas.
- JDK 25 y los wrappers Maven incluidos en cada proyecto.
- Docker activo para dependencias locales y pruebas de integración.
- Python 3 y Node, en las versiones y locks indicados por los workflows, para documentación y CI.
- GraalVM 25 cuando se construyan ejecutables nativos.
Los comandos siguientes funcionan en Linux y Fedora WSL. Las dependencias Maven se obtienen
del repositorio configurado en settings.xml; las credenciales se suministran desde el entorno
o el gestor de secretos.
Ejecutar desde la raíz del repositorio:
(cd axiz-framework && ./mvnw --bootstrap clean install -Pquality -Daxiz.it.requireDocker=true)
(cd axiz-tools && ./mvnw clean verify -Pquality)
(cd axiz-demo && ./mvnw clean verify -Pquality)El bootstrap instala los BOM y parents antes de resolver el reactor. Herramientas y demo consumen el framework instalado o los artefactos publicados en Maven. Cada README de proyecto detalla los perfiles de calidad, integración y compilación nativa.
Con la CLI instalada, consultar el catálogo y generar desde un contrato OpenAPI:
axiz catalog archetypes
axiz new payment-orders --archetype business --structure hexagonal \
--persistence aurora --openapi payments.yaml -c outbox
cd payment-orders
axiz doctor
./mvnw verifyaxiz new -i permite seleccionar los parámetros interactivamente. axiz add incorpora
capacidades y axiz generate crea componentes dentro de un proyecto. CLI e Initializr usan
el mismo motor y validan las combinaciones del catálogo. Consultar la
guía de creación y el
catálogo completo.
La demo incluye PostgreSQL, Valkey, Kafka, LocalStack, Keycloak, WireMock y observabilidad mediante Docker Compose, además de ejemplos para kind. Usa datos ficticios y configuración local; los entornos desplegados obtienen secretos desde su proveedor configurado.
Build y deploy son procesos independientes. Build produce artefactos, SBOM, manifiestos y firmas; deploy verifica y promueve esos mismos bytes por hash, sin recompilar. La documentación de CI/CD describe parámetros, identidades y credenciales.