# iscoutb/as-movies architecture

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

- Interactive diagram: https://gitdiagram.com/iscoutb/as-movies
- Repository: https://github.com/iscoutb/as-movies

## Overview

##### Project Type and Purpose
- This is a cross-platform Flutter application (“movies”) whose primary purpose is to let users browse movie data from an external REST API (TMDB).
- It targets mobile (Android, iOS), desktop (Windows, Linux, macOS), and web.

##### High-Level Directory Analysis
- Top-level directories platform-specific: `android/`, `ios/`, `web/`, `linux/`, `macos/`, `windows/`. These each host the platform embedding code and Flutter engine integration.
- Shared app code lives in `lib/`:
- `main.dart` – application entrypoint.
- `routes/app_routes.dart` – navigation definitions.
- `pages/*.dart` – UI screens (Home, Discover, Categories, Search, Profile).
- `models/movie.dart` – domain data model for movie entities.
- `services/tmdb_service.dart` – HTTP client to TMDB API.
- `login.dart`, `registro.dart` – authentication screens (if implemented).

##### README Insights
- Standard Flutter boilerplate with no extra architecture notes.
- We infer a layered architecture: UI layer (pages & routes), Service/Data layer (TMDB client & models), External API, Platform integration.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Platform Embedding & Engine
    subgraph "Platform Embedding & Engine"
        direction TB
        Android["Android"]:::platform
        iOS["iOS"]:::platform
        Linux["Linux"]:::platform
        macOS["macOS"]:::platform
        Windows["Windows"]:::platform
        Web["Web"]:::platform
    end

    FlutterEngine["Flutter Engine & Dart VM"]:::platform
    Android -->|loads| FlutterEngine
    iOS -->|loads| FlutterEngine
    Linux -->|loads| FlutterEngine
    macOS -->|loads| FlutterEngine
    Windows -->|loads| FlutterEngine
    Web -->|loads| FlutterEngine

    main["main.dart"]:::platform
    FlutterEngine -->|invokes| main

    %% Shared Dart Code
    subgraph "Shared Dart Code"
        direction TB

        %% Presentation Layer
        subgraph "Presentation (UI)" 
            direction TB
            AppRoutes["AppRoutes\n(lib/routes/app_routes.dart)"]:::ui
            HomePage["HomePage\n(lib/pages/home_page.dart)"]:::ui
            DiscoverPage["DiscoverPage\n(lib/pages/discover_page.dart)"]:::ui
            CategoriesPage["CategoriesPage\n(lib/pages/categories_page.dart)"]:::ui
            SearchPage["SearchPage\n(lib/pages/search_page.dart)"]:::ui
            ProfilePage["ProfilePage\n(lib/pages/profile_page.dart)"]:::ui
            LoginScreen["Login\n(lib/login.dart)"]:::ui
            RegistroScreen["Registro\n(lib/registro.dart)"]:::ui
        end

        %% Service Layer
        subgraph "Service Layer"
            direction TB
            TMDBService["TMDBService\n(lib/services/tmdb_service.dart)"]:::service
        end

        %% Data Layer
        MovieModel["Movie Model\n(lib/models/movie.dart)"]:::data
    end

    %% External API
    TMDBAPI["TMDB REST API"]:::external

    %% Data Flows & Relationships
    main -->|initializes| AppRoutes
    AppRoutes -->|navigates| HomePage
    AppRoutes --> DiscoverPage
    AppRoutes --> CategoriesPage
    AppRoutes --> SearchPage
    AppRoutes --> ProfilePage
    AppRoutes --> LoginScreen
    AppRoutes --> RegistroScreen

    HomePage -->|requests| TMDBService
    DiscoverPage --> TMDBService
    CategoriesPage --> TMDBService
    SearchPage --> TMDBService
    ProfilePage --> TMDBService

    TMDBService -->|HTTPS| TMDBAPI
    TMDBAPI -->|JSON| TMDBService

    TMDBService -->|parses| MovieModel
    MovieModel -->|provides data| HomePage
    MovieModel --> DiscoverPage
    MovieModel --> CategoriesPage
    MovieModel --> SearchPage
    MovieModel --> ProfilePage

    %% Click Events
    click Android "https://github.com/iscoutb/as-movies/tree/main/android/"
    click iOS "https://github.com/iscoutb/as-movies/tree/main/ios/"
    click Linux "https://github.com/iscoutb/as-movies/tree/main/linux/"
    click macOS "https://github.com/iscoutb/as-movies/tree/main/macos/"
    click Windows "https://github.com/iscoutb/as-movies/tree/main/windows/"
    click Web "https://github.com/iscoutb/as-movies/tree/main/web/"
    click main "https://github.com/iscoutb/as-movies/blob/main/lib/main.dart"
    click AppRoutes "https://github.com/iscoutb/as-movies/blob/main/lib/routes/app_routes.dart"
    click HomePage "https://github.com/iscoutb/as-movies/blob/main/lib/pages/home_page.dart"
    click DiscoverPage "https://github.com/iscoutb/as-movies/blob/main/lib/pages/discover_page.dart"
    click CategoriesPage "https://github.com/iscoutb/as-movies/blob/main/lib/pages/categories_page.dart"
    click SearchPage "https://github.com/iscoutb/as-movies/blob/main/lib/pages/search_page.dart"
    click ProfilePage "https://github.com/iscoutb/as-movies/blob/main/lib/pages/profile_page.dart"
    click LoginScreen "https://github.com/iscoutb/as-movies/blob/main/lib/login.dart"
    click RegistroScreen "https://github.com/iscoutb/as-movies/blob/main/lib/registro.dart"
    click TMDBService "https://github.com/iscoutb/as-movies/blob/main/lib/sevices/tmdb_service.dart"
    click MovieModel "https://github.com/iscoutb/as-movies/blob/main/lib/models/movie.dart"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0366D6,color:#0366D6;
    classDef service fill:#E6FFEA,stroke:#22863A,color:#22863A;
    classDef data fill:#FFF5B1,stroke:#D4A72C,color:#735C0F;
    classDef external fill:#FFEFEF,stroke:#D73A49,color:#D73A49;
    classDef platform fill:#F0F0F0,stroke:#6A737D,color:#6A737D;
```
