# resocoder/flutter-tdd-clean-architecture-course architecture

> Architecture diagram of the GitHub repository resocoder/flutter-tdd-clean-architecture-course, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/resocoder/flutter-tdd-clean-architecture-course
- Repository: https://github.com/resocoder/flutter-tdd-clean-architecture-course

## Overview

##### Project type and purpose
- This is a cross-platform mobile application built with Flutter, following Uncle Bob’s Clean Architecture and Test-Driven Development (TDD) principles.
- The app’s feature is “Number Trivia”: fetch concrete or random trivia about numbers from a remote API, cache it locally, and display it in the UI.

##### File structure
- Top-level folders:
- android/ios: platform-specific project files & native integration (Gradle, Xcode).
- lib/: main Dart code, organized by layers.
- test/: unit and widget tests, mirroring lib/ structure.
- Clean Architecture layers under lib/:
- core/: reusable utilities (error handling, network info, input conversion, base UseCase).
- features/number_trivia/: feature module, subdivided into:
– data/: concrete implementation of data retrieval – remote and local data sources, DTO models, repository impl.
– domain/: business rules – Entities, Repositories (abstract), UseCases.
– presentation/: UI layer – BLoC, events, states, pages, widgets.
- injection_container.dart: dependency injection (GetIt) setup.
- main.dart: entry point, initializes DI and runs the Flutter app.
- Configuration files:
- pubspec.yaml: dependencies (http, shared_preferences, get_it, flutter_bloc…).

##### README for additional insights
- README title: “TDD Clean Architecture for Flutter” with link to an architecture proposal image.
- Suggests a four-layered architecture: Presentation → Domain → Data → External.

– Labels: “Presentation Layer”, “Domain Layer”, “Data Layer”, “External”.
– Components: NumberTriviaPage, NumberTriviaBloc, UseCases, Repository Interface, Repository Impl, RemoteDataSource, LocalDataSource, Models, Entities.
- Business logic (green)
- Data sources (orange)
- External (gray)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        PT1["NumberTriviaPage"]:::frontend
        PT2["NumberTriviaBloc"]:::frontend
        PT3["NumberTriviaEvent"]:::frontend
        PT4["NumberTriviaState"]:::frontend
        subgraph "Widgets"
            W1["LoadingWidget"]:::frontend
            W2["MessageDisplay"]:::frontend
            W3["TriviaControls"]:::frontend
            W4["TriviaDisplay"]:::frontend
        end
    end

    %% Domain Layer
    subgraph "Domain Layer"
        D1["GetConcreteNumberTrivia"]:::business
        D2["GetRandomNumberTrivia"]:::business
        D3["NumberTrivia"]:::business
        D4["NumberTriviaRepository"]:::business
        D5["UseCase Base"]:::core
    end

    %% Data Layer
    subgraph "Data Layer"
        R1["NumberTriviaRepositoryImpl"]:::data
        R2["NumberTriviaModel"]:::data
        DS1["RemoteDataSource"]:::data
        DS2["LocalDataSource"]:::data
    end

    %% Core & Utilities
    subgraph "Core & Utilities"
        C1["InputConverter"]:::core
        C2["NetworkInfo"]:::core
        C3["Exceptions"]:::core
        C4["Failures"]:::core
    end

    %% Dependency Injection
    subgraph "Dependency Injection"
        DI["injection_container"]:::core
    end

    %% External
    subgraph "External"
        E1["HTTP Client"]:::external
        E2["SharedPreferences"]:::external
        E3["Device Network"]:::external
        E4["Android/iOS Runtime"]:::external
    end

    %% Relationships
    PT1 -->|dispatches events| PT2
    PT2 -->|uses| D1
    PT2 -->|uses| D2
    D1 -->|extends| D5
    D2 -->|extends| D5
    D1 -->|calls repository| D4
    D2 -->|calls repository| D4
    D4 -->|implemented by| R1
    R1 -->|maps to model| R2
    R1 -->|fetches online| DS1
    R1 -->|fetches offline| DS2
    R1 -->|checks network| C2
    DS1 -->|http GET| E1
    DS2 -->|cache read/write| E2
    C2 -->|checks| E3
    DS1 -->|throws| C3
    DS2 -->|throws| C3
    C3 -->|converts to failure| C4
    C4 -->|propagates| PT2

    %% Dependency Injection Wiring
    DI --> PT2
    DI --> D1
    DI --> D2
    DI --> R1
    DI --> DS1
    DI --> DS2
    DI --> C1
    DI --> C2

    %% Click Events
    click PT1 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/presentation/pages/number_trivia_page.dart"
    click PT2 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/presentation/bloc/number_trivia_bloc.dart"
    click PT3 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/presentation/bloc/number_trivia_event.dart"
    click PT4 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/presentation/bloc/number_trivia_state.dart"
    click W1 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/presentation/widgets/loading_widget.dart"
    click W2 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/presentation/widgets/message_display.dart"
    click W3 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/presentation/widgets/trivia_controls.dart"
    click W4 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/presentation/widgets/trivia_display.dart"
    click D3 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/domain/entities/number_trivia.dart"
    click D4 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/domain/repositories/number_trivia_repository.dart"
    click D1 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/domain/usecases/get_concrete_number_trivia.dart"
    click D2 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/domain/usecases/get_random_number_trivia.dart"
    click D5 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/core/usecases/usecase.dart"
    click R1 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/data/repositories/number_trivia_repository_impl.dart"
    click R2 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/data/models/number_trivia_model.dart"
    click DS1 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/data/datasources/number_trivia_remote_data_source.dart"
    click DS2 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/features/number_trivia/data/datasources/number_trivia_local_data_source.dart"
    click C1 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/core/util/input_converter.dart"
    click C2 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/core/network/network_info.dart"
    click C3 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/core/error/exceptions.dart"
    click C4 "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/core/error/failures.dart"
    click DI "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/injection_container.dart"
    click MAIN "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/main.dart"

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#0366D6,color:#0366D6
    classDef business fill:#E6F4EA,stroke:#1F8F2F,color:#1F8F2F
    classDef data fill:#FFEAD0,stroke:#D9822B,color:#D9822B
    classDef core fill:#F0F0F0,stroke:#888888,color:#555555
    classDef external fill:#E8E8E8,stroke:#666666,color:#333333

    click MAIN "https://github.com/resocoder/flutter-tdd-clean-architecture-course/blob/master/lib/main.dart"
```
