# jjsolarte/flutter_clean_architecture architecture

> Architecture diagram of the GitHub repository jjsolarte/flutter_clean_architecture, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jjsolarte/flutter_clean_architecture
- Repository: https://github.com/jjsolarte/flutter_clean_architecture

## Overview

A continuación se detalla un enfoque para crear un diagrama de diseño de sistema/arquitectura que represente de forma precisa y detallada la estructura del proyecto "Flutter Clean Architecture" basado en el árbol de archivos y el README:

##### Identificación del proyecto
- Tipo: Aplicación Flutter basada en **Clean Architecture**.
- Propósito: Servir como una aplicación de prueba y base escalable para proyectos Flutter, con separación de responsabilidades en capas (presentation, domain, data y core).

##### Componentes principales que se deben incluir en el diagrama
a. Capa de Presentación:
- Representa la interfaz de usuario y la lógica de interacción.
- Incluye componentes como:
- Vistas y Pantallas (por ejemplo: home_screen, login_screen, product_screen, user_screen).
- Widgets atómicos y organismos (atoms: app_bar_title_atom, nav_icon_atom; organisms: app_bar_organism, nav_bar_organism).
- Gestión del estado con Provider (login_provider, product_provider, user_provider).
- Ruteo mediante GoRouter (app_router, app_routes).

b. Capa de Dominio:
- Gestiona la lógica de negocio.
- Incluye:
- Repositorios (interfaces para login, productos, usuarios).
- Casos de uso (login_usecase, product_usecase, user_usecase).

c. Capa de Datos:
- Encargada del manejo de datos y de la comunicación con fuentes externas.
- Incluye:
- DataSources para operaciones como login, obtención de productos y usuarios.
- Modelos de datos (product_model, user_model).

d. Capa Core:
- Funciones y utilidades compartidas.
- Incluye:
- Constantes (por ejemplo, end_points).
- Extensiones (string_extensions u otras mejoras generales).

e. Plataforma y Configuración:
- Particiones de Android e iOS para la integración nativa.
- La carpeta web también indica soporte multiplataforma.
- Archivos de configuración y scripts de build, como pubspec.yaml, archivos de configuración de iOS/Android.

##### Relaciones e interacciones entre componentes
- La capa de Presentación interactúa directamente con la capa de Dominio, invocando casos de uso a través de los Providers.
- Los casos de uso (Dominio) se comunican con los Repositorios, que definen los contratos.
- Los Repositorios son implementados en la capa de Datos, donde se encuentran los DataSources y Modelos.
- La capa Core actúa como soporte y se comparte entre las demás capas (por ejemplo, extensions y constantes).
- Los archivos de configuración y las carpetas de plataforma (Android, iOS y web) son responsables de la integración nativa y del empaquetado en las plataformas correspondientes.

##### Patrones de diseño y principios
- Clean Architecture: Separación clara en capas (presentation, domain, data, core) para promover la mantenibilidad y escalabilidad.
- Diseño Atómico: En la capa de presentación para organizar/interface.
- Inyección de dependencias y gestión del estado utilizando Provider.
- Declarativo y estructurado en la navegación a través de GoRouter.

##### Tecnologías y Frameworks Importantes
- Flutter y Dart.
- GoRouter para el ruteo.
- Provider para la gestión de estado.

##### Guía para adaptar el diagrama al proyecto
- Dibuja cada capa (Presentation, Domain, Data, Core) como secciones diferenciadas en el diagrama.
- Incluye la plataforma multiplataforma (Android, iOS, Web) como componentes externos o "shells" que integran la aplicación Flutter.
- Resalta cómo la capa de Presentación interactúa con la Dominio mediante Providers, y cómo esta última se conecta con la Capa de Datos.
- Enfatiza el uso de patrones como Clean Architecture y Diseño Atómico para clarificar la separación de responsabilidades.

##### Elementos que deben incluirse en el diagrama
- Etiquetas claras para cada componente (p.ej., “Login Provider”, “Product UseCase”, “User DataSource”, etc.).
- Flechas direccionales mostrando el flujo de datos:
- Desde la UI (screens/widgets) hacia Providers.
- De los Providers hacia los casos de uso.
- De los casos de uso a los repositorios.
- De los repositorios hacia los data sources y viceversa.
- Utiliza códigos de colores o diferentes formas para distinguir entre:
- Lógica de dominio,
- Interacción con la fuente de datos,
- Componentes comunes/core.
- Incluir notas sobre las herramientas utilizadas (GoRouter, Provider) y cómo se integran en la arquitectura.
- Representar el vínculo o la interacción hacia la parte nativa (Android, iOS) y la configuración en archivos como pubspec.yaml.

Esta estructura de diagrama mostrará de forma clara y detallada cómo se interconectan las diferentes partes de la aplicación, permitiendo a cualquier ingeniero principal entender la separación de responsabilidades, el flujo de trabajo y las dependencias tecnológicas en el proyecto. Recuerda favorecer la claridad y el detalle, pero sin sobrecargar el diagrama: lo esencial es capturar la relación entre los componentes críticos y cómo interactúan entre sí en el marco de Clean Architecture.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        subgraph "Screens"
            HomeScreen["Home Screen"]:::presentation
            LoginScreen["Login Screen"]:::presentation
            ProductScreen["Product Screen"]:::presentation
            UserScreen["User Screen"]:::presentation
        end
        subgraph "Atoms"
            AppBarTitleAtom["App Bar Title Atom"]:::presentation
            NavIconAtom["Nav Icon Atom"]:::presentation
        end
        subgraph "Organisms"
            AppBarOrganism["App Bar Organism"]:::presentation
            NavBarOrganism["Nav Bar Organism"]:::presentation
        end
        subgraph "Providers"
            LoginProvider["Login Provider"]:::presentation
            ProductProvider["Product Provider"]:::presentation
            UserProvider["User Provider"]:::presentation
        end
        subgraph "Routing"
            AppRouter["App Router"]:::presentation
            AppRoutes["App Routes"]:::presentation
        end
    end

    %% Domain Layer
    subgraph "Domain Layer"
        subgraph "Repositories"
            LoginRepository["Login Repository Interface"]:::domain
            ProductRepository["Product Repository Interface"]:::domain
            UserRepository["User Repository Interface"]:::domain
        end
        subgraph "UseCases"
            LoginUseCase["Login UseCase"]:::domain
            ProductUseCase["Product UseCase"]:::domain
            UserUseCase["User UseCase"]:::domain
        end
    end

    %% Data Layer
    subgraph "Data Layer"
        subgraph "DataSources"
            LoginDataSource["Login DataSource"]:::data
            ProductDataSource["Product DataSource"]:::data
            UserDataSource["User DataSource"]:::data
            HomeProvider["Home Provider"]:::data
        end
        subgraph "Models"
            ProductModel["Product Model"]:::data
            UserModel["User Model"]:::data
        end
    end

    %% Core Layer
    subgraph "Core Layer"
        EndPoints["End Points"]:::core
        StringExtensions["String Extensions"]:::core
    end

    %% Platform & Configuration
    subgraph "Platform & Configuration"
        Pubspec["pubspec.yaml"]:::platform
        Android["Android"]:::platform
        iOS["iOS"]:::platform
        Web["Web"]:::platform
    end

    %% Relationships

    %% Screens to Providers
    LoginScreen -->|"triggers"| LoginProvider
    ProductScreen -->|"triggers"| ProductProvider
    UserScreen -->|"triggers"| UserProvider
    HomeScreen -->|"triggers"| HomeProvider

    %% Providers to Domain UseCases
    LoginProvider -->|"calls"| LoginUseCase
    ProductProvider -->|"calls"| ProductUseCase
    UserProvider -->|"calls"| UserUseCase

    %% Domain UseCases to Repositories
    LoginUseCase -->|"uses"| LoginRepository
    ProductUseCase -->|"uses"| ProductRepository
    UserUseCase -->|"uses"| UserRepository

    %% Repositories to DataSources
    LoginRepository -->|"implements"| LoginDataSource
    ProductRepository -->|"implements"| ProductDataSource
    UserRepository -->|"implements"| UserDataSource

    %% Routing connections
    AppRouter -->|"configures"| AppRoutes

    %% Core support
    LoginUseCase -->|"utilizes"| StringExtensions
    ProductUseCase -->|"utilizes"| StringExtensions
    UserUseCase -->|"utilizes"| StringExtensions
    LoginDataSource -->|"uses"| EndPoints
    ProductDataSource -->|"uses"| EndPoints
    UserDataSource -->|"uses"| EndPoints

    %% Platform & Configuration integration
    Pubspec -->|"configures"| HomeScreen
    Android -->|"integrates"| HomeScreen
    iOS -->|"integrates"| HomeScreen
    Web -->|"integrates"| HomeScreen

    %% Styles
    classDef presentation fill:#add8e6,stroke:#000,stroke-width:2px;
    classDef domain fill:#90ee90,stroke:#000,stroke-width:2px;
    classDef data fill:#fffacd,stroke:#000,stroke-width:2px;
    classDef core fill:#d3d3d3,stroke:#000,stroke-width:2px;
    classDef platform fill:#f08080,stroke:#000,stroke-width:2px;

    %% Click Events
    click HomeScreen "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/feature/home/home_screen.dart"
    click LoginScreen "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/feature/login/login_screen.dart"
    click ProductScreen "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/feature/product/product_screen.dart"
    click UserScreen "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/feature/users/user_screen.dart"
    click AppBarTitleAtom "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/atoms/app_bar_title_atom.dart"
    click NavIconAtom "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/atoms/nav_icon_atom.dart"
    click AppBarOrganism "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/organism/app_bar_organism.dart"
    click NavBarOrganism "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/organism/nav_bar_organism.dart"
    click LoginProvider "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/providers/login_provider.dart"
    click ProductProvider "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/providers/product_provider.dart"
    click UserProvider "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/presentation/providers/user_provider.dart"
    click AppRouter "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/core/router/app_router.dart"
    click AppRoutes "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/core/router/app_routes.dart"
    click LoginRepository "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/domain/repositories/login_repository.dart"
    click ProductRepository "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/domain/repositories/product_repository.dart"
    click UserRepository "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/domain/repositories/user_repository.dart"
    click LoginUseCase "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/domain/use_case/login_usecase.dart"
    click ProductUseCase "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/domain/use_case/product_usecase.dart"
    click UserUseCase "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/domain/use_case/user_usecase.dart"
    click LoginDataSource "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/data/data_source/login_datasource.dart"
    click ProductDataSource "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/data/data_source/product_datasource.dart"
    click UserDataSource "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/data/data_source/user_datasource.dart"
    click HomeProvider "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/data/data_source/home_provider.dart"
    click ProductModel "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/data/models/product_model.dart"
    click UserModel "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/data/models/user_model.dart"
    click EndPoints "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/core/constants/end_points.dart"
    click StringExtensions "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/lib/core/utils/extensions/string_extensions.dart"
    click Pubspec "https://github.com/jjsolarte/flutter_clean_architecture/blob/main/pubspec.yaml"
    click Android "https://github.com/jjsolarte/flutter_clean_architecture/tree/main/android/"
    click iOS "https://github.com/jjsolarte/flutter_clean_architecture/tree/main/ios/"
    click Web "https://github.com/jjsolarte/flutter_clean_architecture/tree/main/web/"
```
