🏗️ 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
- Introducción y modelo mental
Clean Architecture aplicada al frontend y enfoque feature-driven. - Infrastructure layer
Integración con APIs, DTOs, transforms, interfaces y services. - Domain layer
Modelos y reglas de negocio puras. - Application layer
Orquestación de flujos con queries, mutations y use-cases. - UI layer
Pages, widgets y componentes enfocados en experiencia de usuario. - Imports y boundaries
Reglas de imports, uso desharedy 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.