¿Qué es la arquitectura limpia? ¿Cómo se estructura y cómo funciona?

Question

IT Interview Practice · Accepted Answer

## ¿Qué es la arquitectura limpia?

**La arquitectura limpia** organiza el software alrededor del comportamiento de negocio y lo separa de las interfaces de usuario, las bases de datos y los frameworks. Su objetivo es reducir el efecto de los cambios tecnológicos sobre las reglas importantes de la aplicación.

Por ejemplo, «un pedido entregado no puede cancelarse» es una regla de negocio. Sigue siendo la misma tanto si el cliente utiliza un sitio web como una aplicación móvil, e independientemente de la tecnología de almacenamiento.

## Partes principales

La arquitectura limpia suele representarse mediante círculos organizados de dentro hacia fuera:

- **Entidades:** Contienen los datos y las reglas fundamentales del negocio, como un pedido y sus condiciones de cancelación.
- **Casos de uso:** Coordinan una operación concreta de la aplicación, como recuperar un pedido, solicitar su cancelación y guardar el resultado.
- **Adaptadores de interfaz:** Convierten los datos entre la lógica de negocio y los sistemas externos. Un controlador convierte una solicitud HTTP en datos de entrada para la operación de cancelación; un adaptador de almacenamiento transforma los datos del pedido en consultas a la base de datos.
- **Frameworks y herramientas:** Tecnologías situadas en el borde exterior, como el framework web o el sistema de base de datos.

**La regla esencial es que el código interior no debe depender del código exterior.** Un caso de uso puede trabajar con una interfaz de almacenamiento de pedidos definida en la parte de negocio; un adaptador externo implementa esa interfaz utilizando una tecnología concreta.

## Ejemplo: cancelar un pedido

Cuando un cliente solicita una cancelación, el controlador llama al caso de uso de cancelación. El caso de uso recupera el pedido a través de una interfaz de acceso a datos y después pide al objeto del pedido que compruebe si se permite la cancelación.

Si el pedido no se ha entregado y cumple las condiciones, su estado cambia a cancelado. El caso de uso solicita que se guarde el cambio, el adaptador de base de datos realiza la escritura y el controlador devuelve el resultado al cliente.

Durante la ejecución, la lógica de negocio puede seguir llamando a un adaptador a través de una interfaz conectada durante el inicio. La regla de que las dependencias apuntan hacia dentro se refiere a las relaciones entre componentes del código; no significa que los datos o las llamadas solo puedan circular en una dirección.

## Ventajas

- **Pruebas más sencillas de las reglas:** Las cancelaciones permitidas y rechazadas pueden probarse con datos en memoria, sin iniciar un servidor web ni una base de datos.
- **Un lugar claro para el comportamiento de negocio:** Las reglas no están dispersas entre controladores y consultas, lo que facilita su lectura y modificación coherente.
- **Menor impacto de los cambios tecnológicos:** Sustituir una biblioteca de almacenamiento o un gestor de solicitudes afecta principalmente a los componentes externos si los contratos de negocio permanecen iguales.

## Limitaciones

- **Más componentes:** Escribir y mantener interfaces, casos de uso y código de conversión de datos requiere tiempo.
- **Los límites necesitan disciplina:** Si un caso de uso utiliza directamente tipos específicos de un framework o de una biblioteca de base de datos, la lógica de negocio vuelve a depender de la tecnología externa.

## ¿Cuándo conviene utilizarla?

La arquitectura limpia resulta útil para sistemas con un comportamiento de negocio complejo, una larga vida de desarrollo y necesidades frecuentes de pruebas. Para una aplicación pequeña que solo lee y escribe unas pocas tablas, una estructura más sencilla puede ser más fácil de utilizar. No es necesario crear todos los círculos o carpetas, salvo que ayuden a separar responsabilidades reales.

¿Qué es la arquitectura limpia?

Partes principales

Ejemplo: cancelar un pedido

Ventajas

Limitaciones

¿Cuándo conviene utilizarla?

Preguntas relacionadas