# vzmdn/pmdm_proyecto_final architecture

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

- Interactive diagram: https://gitdiagram.com/vzmdn/pmdm_proyecto_final
- Repository: https://github.com/vzmdn/pmdm_proyecto_final

## Overview

- Data Layer: This layer implements the repository and handles data from two sources:
- Remote Service: Involves the packages “data/network” – including API interface (PhotoService), models (PhotoResponse), and any network interceptors (RequestTokenInterceptor).
- Local Storage: Involves the packages under “data/local” – such as the PhotosDatabase, DAO (PhotoDao), and entity definitions (PhotoEntity).
- Data Mappers: Tools to convert from network data / database entities to domain models (Mappers.kt).

- Optionally, show error or caching flows by representing fallback logic in case the remote API fails.

##### Important Architectural Patterns and Design Principles
- Layered Architecture / Clean Architecture: Emphasize the separation between presentation (UI), domain (business logic), and data (persistence & network). This separation ensures maintainability and testability.
- Repository Pattern: Indicating that the PhotoRepository interface abstracts data access details, while PhotoRepositoryImpl bridges the domain logic and the data sources.

##### Relevant Technologies and Frameworks
- Gradle: Indicate that the project uses Gradle (managed via build.gradle.kts) for dependency management.
- Kotlin: Since the source files are in Kotlin.
- Android Framework & Lifecycle Components: Implicitly represented via Activities, ViewModels, and resources.
- Room/SQLite (for local persistence): Represented by PhotosDatabase and DAO.
- Retrofit/OkHttp (or similar libraries) for network calls: Implied by the API-related classes and interceptors.

##### Final Assembly
- Minimal yet sufficient detail that shows the critical paths (data retrieval, persistence, business logic, and UI presentation) without overcomplicating the visual.
- Verify that each component mirrors the package structure and purpose discussed in the README (for example, clearly showing that “Esta semana” and “Hoy” screens use the same view/component design).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer – Activities & ViewModels"
        A1["MainActivity"]:::activity
        A2["FullscreenActivity"]:::activity
        A3["TodayActivity"]:::activity
        A4["ThisWeekActivity"]:::activity
        A5["PickDateActivity"]:::activity
        V1["MainViewModel"]:::viewmodel
        V2["TodayViewModel"]:::viewmodel
        V3["ThisWeekViewModel"]:::viewmodel
        V4["PickDateViewModel"]:::viewmodel
    end

    %% Domain Layer
    subgraph "Domain Layer"
        D1["PhotoRepository (Interface)"]:::domain
        D2["Photo (Domain Model)"]:::domain
    end

    %% Data Layer
    subgraph "Data Layer – Remote & Local"
        DImpl["PhotoRepositoryImpl"]:::dataimpl
        Mapper["Mappers"]:::dataimpl
        
        subgraph "Remote Service"
            R1["RequestTokenInterceptor"]:::remote
            R2["PhotoService (API)"]:::remote
            R3["PhotoResponse"]:::remote
        end
        
        subgraph "Local Storage"
            L1["PhotosDatabase"]:::localdb
            L2["PhotoDao"]:::localdb
            L3["PhotoEntity"]:::localdb
        end
    end

    %% UI interactions within UI Layer: Activities call ViewModels
    A1 -->|"triggers"| V1
    A3 -->|"triggers"| V2
    A4 -->|"triggers"| V3
    A5 -->|"triggers"| V4

    %% UI to Domain: ViewModels call Domain Repository Interface
    V1 -->|"calls"| D1
    V2 -->|"calls"| D1
    V3 -->|"calls"| D1
    V4 -->|"calls"| D1

    %% Domain to Data: Repository Interface is implemented by RepositoryImpl
    D1 -->|"impl"| DImpl

    %% Data Layer interactions
    DImpl -->|"remoteCall"| R2
    DImpl -->|"localCall"| L1

    %% Remote Service flow
    R1 -->|"intercepts"| R2
    R2 -->|"returns"| R3
    R3 -->|"maps"| Mapper

    %% Local Storage flow
    L1 -->|"dao"| L2
    L2 -->|"entity"| L3
    L3 -->|"maps"| Mapper

    %% Mapper transforms data to Domain Model
    Mapper -->|"toDomain"| D2

    %% Class definitions for styling
    classDef activity fill:#AED6F1,stroke:#1F618D,stroke-width:2px;
    classDef viewmodel fill:#85C1E9,stroke:#1B4F72,stroke-width:2px;
    classDef domain fill:#A9DFBF,stroke:#196F3D,stroke-width:2px;
    classDef dataimpl fill:#F9E79F,stroke:#B9770E,stroke-width:2px;
    classDef remote fill:#F5B7B1,stroke:#922B21,stroke-width:2px;
    classDef localdb fill:#D7BDE2,stroke:#6C3483,stroke-width:2px;

    %% Click Events for UI Layer
    click A1 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/ui/MainActivity.kt"
    click A2 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/ui/FullscreenActivity.kt"
    click A3 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/ui/TodayActivity.kt"
    click A4 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/ui/ThisWeekActivity.kt"
    click A5 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/ui/PickDateActivity.kt"
    click V1 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/ui/MainViewModel.kt"
    click V2 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/ui/TodayViewModel.kt"
    click V3 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/ui/ThisWeekViewModel.kt"
    click V4 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/ui/PickDateViewModel.kt"

    %% Click Events for Domain Layer
    click D1 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/domain/PhotoRepository.kt"
    click D2 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/domain/model/Photo.kt"

    %% Click Events for Data Layer
    click DImpl "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/data/PhotoRepositoryImpl.kt"
    click Mapper "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/data/Mappers.kt"
    click R1 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/data/network/RequestTokenInterceptor.kt"
    click R2 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/data/network/api/PhotoService.kt"
    click R3 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/data/network/model/PhotoResponse.kt"
    click L1 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/data/local/PhotosDatabase.kt"
    click L2 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/data/local/dao/PhotoDao.kt"
    click L3 "https://github.com/vzmdn/pmdm_proyecto_final/blob/master/app/src/main/java/com/vozmediano/vozmedianonasa/data/local/entities/PhotoEntity.kt"
```
