Saltar al contenido principal

🏗️ Arquitectura

La arquitectura del proyecto define cómo estructuramos el código, cómo se relacionan las capas y cómo evitamos el acoplamiento innecesario entre funcionalidades.

Adoptamos un enfoque basado en Clean Architecture y organización feature-driven, donde cada funcionalidad es una unidad vertical independiente y las dependencias siguen reglas claras y predecibles.

El objetivo es construir un sistema:

  • Escalable
  • Mantenible
  • Testeable
  • Fácil de refactorizar

Esta sección describe el modelo que guía todas las decisiones estructurales del frontend.

📚 Índice

  1. Introducción y modelo mental
    Clean Architecture aplicada al frontend y enfoque feature-driven.
  2. Infrastructure layer
    Integración con APIs, DTOs, transforms, interfaces y services.
  3. Domain layer
    Modelos y reglas de negocio puras.
  4. Application layer
    Orquestación de flujos con queries, mutations y use-cases.
  5. UI layer
    Pages, widgets y componentes enfocados en experiencia de usuario.
  6. Imports y boundaries
    Reglas de imports, uso de shared y límites entre módulos.

🧭 Reglas generales

  • Cada capa tiene responsabilidades claras.
  • Cuando respetamos esos límites, el código se vuelve más testeable, predecible y simple de evolucionar.