# ulp-ugd/moviltpi architecture

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

- Interactive diagram: https://gitdiagram.com/ulp-ugd/moviltpi
- Repository: https://github.com/ulp-ugd/moviltpi

## Overview

##### Project Type and Main Purpose
- MovilTPI is a mobile Android application.
- Its main functions include user authentication, creating and viewing posts, commenting, real-time chatting, and managing images.
- The application leverages Parse Server (hosted on Back4App) for backend services such as data storage, user authentication, and push notifications.

##### Main Components
- Frontend – Android App:
- UI Layer: Activities (e.g., MainActivity, HomeActivity, PostActivity), Fragments (e.g., ChatFragment, HomeFragment, PerfilFragment)
- Presentation Layer: ViewModels (e.g., AuthViewModel, ChatViewModel, PostViewModel, RegisterViewModel) that follow an MVVM design pattern.
- Domain/Model Layer: Data models in the "models" package (e.g., Post, User, Comentario, Mensaje)
- Utility and Core Services: Classes in the "core/utils" folder (e.g., ImageUtils, Validaciones, EfectoTransformer) and MyApplication for global configuration (including Parse initialization).

- Backend – External Services:
- Parse Server (Back4App) for:
- Data management (using Parse Database for posts, users, comments, messages).
- Authentication services.
- Real-time data updates and push notifications, with Cloud Code handling before-save events.
- Third-party image libraries (Picasso, Glide) and UI libraries (Material Components, ShapeOfView).

##### Relationships and Interactions
- User Interaction:
- A user starts at the authentication screens (Login/Register) which interface with AuthViewModel and AuthProvider.
- After authentication, navigation occurs to various feature screens where the UI (consisting of Activities and Fragments) communicates with their respective ViewModels.
- Data Flow:
- The application’s ViewModels call Provider classes (like ChatProvider, PostProvider) to interact with the Parse Server.
- Data from the backend is received, parsed into model objects, and used by the ViewModels to update the UI.
- Real-time Chat Integration:
- Chat components use Parse LiveQuery (or fallback polling) to update conversations in real time.
- Cloud Code on Back4App sends push notifications to alert users of new messages.
- Image Handling:
- ImageAdapters along with third-party libraries manage the display and caching of images for posts and profiles.

##### Architectural Patterns and Components
- MVVM Pattern: Separate concerns between the UI (Activities/Fragments), the business logic (ViewModels), and data/model layers.
- Separation of Concerns:
- The “core” package contains base classes, initialization logic (MyApplication), and utility functions.
- The “features” package organizes code by functionality (auth, chat, posts, users) which encapsulates:
- UI code (Activities, Fragments, Layouts)
- ViewModels for business logic
- Providers for handling the connection with Parse backend.
- External Service Integration: Clearly show the connection to Parse Server via network calls and real-time updates (with Cloud Code and push notifications).

##### Elements
- Labels: Clearly label sections such as “Authentication”, “Posts”, “Chat”, “User Profiles”, “Image Management” and “External Parse Server”.
- Distinguishing Components:

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Entry Point
    U("User"):::external

    %% Android App Subsystem
    subgraph "Android App"
      
      %% UI Layer: Activities & Fragments
      subgraph "UI Layer (Activities & Fragments)"
        MA("MainActivity"):::ui
        HA("HomeActivity"):::ui
        PA("PostActivity"):::ui
        RA("RegisterActivity"):::ui
        CF("ChatFragment"):::ui
        HF("HomeFragment"):::ui
        PF("PerfilFragment"):::ui
      end

      %% Presentation Layer: ViewModels
      subgraph "Presentation Layer (ViewModels)"
        AV("AuthViewModel"):::viewModel
        MV("MainViewModel"):::viewModel
        RV("RegisterViewModel"):::viewModel
        CV("ChatViewModel"):::viewModel
        PV("PostViewModel"):::viewModel
        PDV("PostDetailViewModel"):::viewModel
      end

      %% Domain/Model Layer
      subgraph "Domain/Model Layer (Models)"
        PostM("Post"):::model
        ComM("Comentario"):::model
        MenM("Mensaje"):::model
        UserM("User"):::model
      end

      %% Utility and Core Services
      subgraph "Utility & Core Services"
        App("MyApplication"):::utility
        IU("ImageUtils"):::utility
        ET("EfectoTransformer"):::utility
        Val("Validaciones"):::utility
        IA("ImageAdapter"):::utility
        ISA("ImageSliderAdapter"):::utility
      end

      %% Data Providers
      subgraph "Data Providers"
        AP("AuthProvider"):::provider
        CP("ChatProvider"):::provider
        PP("PostProvider"):::provider
      end

    end

    %% External Services
    subgraph "External Services"
      PS("Parse Server"):::external
      TPL("Third-Party Libraries\n(Picasso, Glide, Material Components)"):::external
    end

    %% Relationships
    U -->|"uses"| MA
    U -->|"uses"| HA
    U -->|"uses"| PA
    U -->|"uses"| RA
    U -->|"interacts"| CF
    U -->|"interacts"| HF
    U -->|"interacts"| PF

    %% UI Layer to Presentation Layer (mapping by feature)
    MA -->|"triggers"| AV
    HA -->|"triggers"| MV
    RA -->|"triggers"| RV
    CF -->|"triggers"| CV
    HF -->|"triggers"| PV
    PA -->|"triggers"| PDV

    %% Presentation Layer calls Data Providers
    AV -->|"calls"| AP
    CV -->|"calls"| CP
    PV -->|"calls"| PP

    %% Providers interact with External Parse Server
    AP -->|"syncs with"| PS
    CP -->|"syncs with"| PS
    PP -->|"syncs with"| PS

    %% External Push Notifications back to UI (real-time updates)
    PS -->|"push_notif"| CF

    %% Core Initialization & Utilities support
    App ---|"init Parse"| PS
    IU --- TPL
    IA --- TPL
    ISA --- TPL

    %% Domain Models support ViewModels (data binding)
    AV --- PostM
    PV --- PostM
    CV --- MenM

    %% Styles
    classDef ui fill:#cce5ff,stroke:#004085,stroke-width:2px;
    classDef viewModel fill:#d4edda,stroke:#155724,stroke-width:2px;
    classDef model fill:#fff3cd,stroke:#856404,stroke-width:2px;
    classDef utility fill:#d1ecf1,stroke:#0c5460,stroke-width:2px;
    classDef provider fill:#f8d7da,stroke:#721c24,stroke-width:2px;
    classDef external fill:#ffefc1,stroke:#b8860b,stroke-width:2px;

    %% Click Events for UI Layer - Activities & Fragments
    click MA "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/auth/MainActivity.java"
    click HA "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/posts/HomeActivity.java"
    click PA "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/posts/PostActivity.java"
    click RA "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/auth/RegisterActivity.java"
    click CF "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/chat/ChatFragment.java"
    click HF "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/posts/HomeFragment.java"
    click PF "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/users/PerfilFragment.java"

    %% Click Events for Presentation Layer - ViewModels
    click AV "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/auth/AuthViewModel.java"
    click MV "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/auth/MainViewModel.java"
    click RV "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/auth/RegisterViewModel.java"
    click CV "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/chat/ChatViewModel.java"
    click PV "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/posts/PostViewModel.java"
    click PDV "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/posts/PostDetailViewModel.java"

    %% Click Events for Domain/Model Layer - Models
    click PostM "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/core/models/Post.java"
    click ComM "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/core/models/Comentario.java"
    click MenM "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/core/models/Mensaje.java"
    click UserM "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/core/models/User.java"

    %% Click Events for Utility & Core Services
    click App "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/core/MyApplication.java"
    click IU "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/core/utils/ImageUtils.java"
    click ET "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/core/utils/EfectoTransformer.java"
    click Val "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/core/utils/Validaciones.java"
    click IA "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/core/utils/ImageAdapter.java"
    click ISA "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/core/utils/ImageSliderAdapter.java"

    %% Click Events for Data Providers
    click AP "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/auth/AuthProvider.java"
    click CP "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/chat/ChatProvider.java"
    click PP "https://github.com/ulp-ugd/moviltpi/blob/main/app/src/main/java/com/example/moviltpi/features/posts/PostProvider.java"
```
