Saltar al contenido
Mis Guidelines
Guías

Guías

18 guías opinadas de arquitectura hexagonal, agrupadas por categoría.

Arquitectura

Arquitectura

Hexagonal Architecture

Arquitectura hexagonal de cero: capas domain/application/infrastructure/bootstrap, outbox y ArchUnit.

Arquitectura

Architecture Document Spec

Spec de 21 secciones para un architecture document board-grade: contexto, riesgos, decisiones y deployment view.

Arquitectura

Architecture Diagrams & Patterns

Índice de diagramas de arquitectura: C4, runtime, ports, command flow y catálogo de patterns.

Arquitectura

LaTeX Architecture Docs

Pipeline LaTeX + Tectonic + Pandoc para producir architecture documents PDF board-grade desde Markdown.

Arquitectura

API Design

Convenciones REST: modelado de recursos, versionado, errores RFC 9457, paginación por cursor, idempotency-key y contract-first con OpenAPI.

Arquitectura

Messaging

Mensajería event-driven: outbox transaccional, envelope EventMessage, dispatch claim-based, consumidores idempotentes y evolución de esquemas.

Arquitectura

API Gateway

API gateway en el edge con KrakenD: validación JWT, claims-to-headers, rate limiting, CORS, propagación W3C Trace Context y mTLS a backends.

DDD

DDD

Domain-Driven Design

Domain-Driven Design en práctica: aggregates, bounded contexts, building blocks y cómo mapean a la capa de dominio hexagonal.

Clean Code

Clean Code

Clean Code

Principios de clean code y SOLID aplicados al backend JVM: funciones cortas, nombres claros, responsabilidades únicas.

Estilos

Estilos

Java Code Style

Convenciones Java 21+: records, sealed classes, pattern matching, @FunctionalInterface y mappers explícitos.

Estilos

Kotlin Code Style

Convenciones Kotlin 2.x: data class, fun interface, extension functions, val por defecto y null-safety.

Framework

Framework

Spring Boot

Spring Boot en hexagonal: bean wiring, profiles, JDBC, Kafka, Redis y Async sin invadir el dominio.

Framework

Eclipse Vert.x

Servicios reactivos con Eclipse Vert.x 4.x: estilo layered N-tier + event-driven, Verticles, EventBus, Future API y testing con vertx-junit5.

Infra

Infra

Gradle Build & Quality

Gradle Kotlin DSL multi-módulo: Spotless, JaCoCo, SonarQube, ArchUnit y enforcement de boundaries hexagonales.

Infra

Liquibase Guidelines

Migraciones Liquibase forward-only: changesets atómicos, rollback strategy y reglas anti-mutación de schema.

Infra

GitHub Actions CI/CD

CI/CD con GitHub Actions: workflows reutilizables (workflow_call), orquestación de pipelines, semver desde commits, security gates y rulesets de protección.

Infra

Git Workflow & Best Practices

Buenas prácticas de Git: conventional commits, branching, pull requests, disciplina de historia y manejo seguro de secretos.

Infra

Security

Baseline de seguridad: STRIDE, AuthN/Z (OAuth2/OIDC/JWT), gestión de secretos, validación, prevención de inyección, criptografía y audit trail.

Infra

Keycloak & Identity

Keycloak como infraestructura: topologías gateway-first vs resource server, mapeo de roles, Current User Port, microservicio de auth y grant flows.

Infra

GitOps + ArgoCD

GitOps con ArgoCD: estado declarativo del clúster, Application/ApplicationSet, sync waves, secrets, promoción de entornos y Argo Rollouts.

Observability

Observability

Observability Guide

Estrategia de observabilidad: métricas Micrometer, tracing OTEL y logging estructurado correlados por traceId.

Testing

Testing

Testing Strategy

Estrategia de testing: JUnit unitarios sin mocks en dominio, Karate para BDD, Testcontainers y ArchUnit por boundaries.

ADR

ADR

Architectural Decision Records

Cuándo y cómo escribir Architectural Decision Records (MADR, Nygard, Y-Statement) y mantenerlos vivos en el repositorio.

Agentes / Workflows

Agentes / Workflows

Claude Code Guide

Guía paso a paso para implementar features hexagonales con Claude Code: domain, puertos, adapters, wiring y tests.

Agentes / Workflows

GSD Workflow Guide

Pipeline GSD para automatizar planning y ejecución de proyectos con Claude: phases, plans, waves y SUMMARY.

Agentes / Workflows

Guidelines Overview

Tabla de contenidos y orden de lectura recomendado para todas las guías de arquitectura hexagonal.

Agentes / Workflows

Resources Structure

Plantillas de archivos de proyecto: README, LICENSE, CONTRIBUTING y la estructura del módulo bootstrap.