Arquitectura limpia · Mapas mentales
Arquitectura limpia. Un mapa mental editable con ramas de colores, ideas secundarias y conexiones. Las líneas curvas muestran relaciones; las flechas aparecen cuando importa la dirección.
La arquitectura limpia organiza el código en capas concéntricas (entidades, casos de uso, adaptadores de interfaz, frameworks) bajo una sola regla: las dependencias apuntan siempre hacia dentro, así que el núcleo nunca depende de una herramienta.
Arquitectura limpia · Mapas mentales
El lienzo interactivo de MindMap de esta explicación: cada carril, cada fila y cada flecha de arriba forma parte de un diagrama real de QueryChart que puedes abrir y editar.
Cómo leer este mapa mental
- Empieza por el tema central y sigue una rama de color para explorar sus ideas.
- Las líneas curvas muestran relaciones; las flechas aparecen cuando importa la dirección.
Business core
Esta rama reúne “The innermost circle: objects and rules that exist no matter how the app is delivered — a customer, an invoice, the rule that an invoice cannot be paid twice.”, “The core never imports a framework”.
Use cases
Esta rama reúne “Use cases orchestrate entities for one application scenario, such as “place an order”. They know about the app but nothing about screens or databases.”, “Because the database and UI are details, replacing them — a migration, a new front-end — leaves the entities and use cases untouched.”.
Adapters
Esta rama reúne “Adapters translate between the use cases and the outside world: an HTTP controller turns a request into a use-case call, a presenter turns results into a screen.”, “Outer layers talk through the adapter, not to the core”.
Frameworks
Esta rama reúne “The outermost ring: the tools. React, PostgreSQL, Express — details that can change without the core knowing or caring.”, “The dependency rule: source code dependencies always cross inward. The core declares what it needs (interfaces) and the outer rings implement them.”.
Conexiones entre ramas
Las dependencias apuntan siempre hacia dentro: esa única regla es lo que la arquitectura es.
El núcleo declara interfaces y los anillos exteriores las implementan: el adaptador es la costura.
Las entidades y los casos de uso son independientes del framework por construcción.
La recompensa es la sustituibilidad: cambiar de interfaz, de base de datos o de framework web sin tocar el núcleo.
La arquitectura limpia va de la dirección de las dependencias, no del número de capas.
Relaciones clave y conclusiones
- Las dependencias apuntan siempre hacia dentro: esa única regla es lo que la arquitectura es.
- El núcleo declara interfaces y los anillos exteriores las implementan: el adaptador es la costura.
- Las entidades y los casos de uso son independientes del framework por construcción.
- La recompensa es la sustituibilidad: cambiar de interfaz, de base de datos o de framework web sin tocar el núcleo.
- La arquitectura limpia va de la dirección de las dependencias, no del número de capas.
Cuándo usar este diagrama
- Enseñar la regla de dependencia a un equipo antes de que estructure un código grande.
- Revisar una arquitectura: un caso de uso que importa una biblioteca de interfaz o de base de datos es una violación de la regla, visible en el lienzo.
- Planificar una reescritura o una migración: el lienzo muestra qué capas tienen que sobrevivir y cuáles se pueden sustituir.
Cómo funciona
Adapta el tema central
Cambia el nombre del tema para adaptarlo a tu proyecto o clase.
Desarrolla las ramas
Edita las ideas y añade ejemplos o notas.
Conecta ideas relacionadas
Dibuja conexiones entre ramas; usa flechas cuando la dirección importe.
Preguntas frecuentes
¿Qué es la arquitectura limpia?
Es un patrón arquitectónico, popularizado por Robert C. Martin, que organiza el código en capas concéntricas: las entidades en el centro, después los casos de uso, después los adaptadores de interfaz y, en el borde, los frameworks y drivers. Su regla rectora es que las dependencias del código fuente apuntan siempre hacia dentro, así que las reglas de negocio del núcleo nunca dependen de los mecanismos de entrega: la interfaz, la base de datos o el framework web.
¿Qué es la regla de dependencia?
La regla de dependencia dice que las dependencias del código fuente tienen que cruzar siempre hacia dentro: una capa exterior puede depender de una capa interior, nunca al revés. En la práctica, las capas interiores declaran interfaces y las exteriores las implementan, así que el código del núcleo no importa nada de las herramientas del borde. El diagrama la dibuja como su propio grupo porque de ella se deriva cualquier otra propiedad de la arquitectura.
¿En qué se diferencia la arquitectura limpia de una arquitectura por capas?
La arquitectura por capas también separa responsabilidades, pero sus dependencias suelen fluir de arriba abajo: la capa de presentación llama a la capa de servicio, que llama a la capa de datos. La arquitectura limpia invierte eso: el núcleo de negocio está en el centro y todo lo demás depende de él, así que la dirección de la dependencia es el rasgo distintivo. La flecha del diagrama hacia el núcleo es esa diferencia hecha visible.
¿Merece la pena la arquitectura limpia en un proyecto pequeño?
No siempre: la ceremonia cuesta más de lo que devuelve cuando las reglas de negocio son triviales o el equipo es de una sola persona. El patrón se gana el sueldo cuando la lógica de negocio es lo bastante compleja como para tener que sobrevivir a las herramientas, o cuando es probable que la interfaz o la base de datos cambien. Las cajas de recompensa del lienzo enuncian el intercambio con honestidad: la seguridad del núcleo se compra con las capas de adaptadores.
Editar este mapa mental en QueryChart
Abre este mapa mental en un lienzo editable. Mueve ideas, añade ramas y dibuja conexiones.