# mpadillae/misw4203-202415-vinilos architecture

> Architecture diagram of the GitHub repository mpadillae/misw4203-202415-vinilos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mpadillae/misw4203-202415-vinilos
- Repository: https://github.com/mpadillae/misw4203-202415-vinilos

## Overview

##### Main Components

a. Client Layer (UI):
- Activities and Fragments (from ui/albums, ui/artists, ui/collectors)
- Adapters (for RecyclerViews)
- XML Layouts

b. Presentation Layer:
- AlbumListViewModel
- ArtistListViewModel
- CollectorListViewModel

c. Domain Layer:
- AlbumRepository
- BandRepository
- CollectorRepository
- MusicianRepository

d. Data Layer:
- Create two parallel containers:
1. "Network Services" containing:
- RetrofitApiClient
- Various service interfaces (AlbumService, BandService, etc.)
2. "Models" containing:
- Data classes (Album, Band, Collector, etc.)

##### Component Relationships

- UI Layer → ViewModel Layer (user actions)
- ViewModel Layer → Repository Layer (data requests)
- Repository Layer → Network Services (API calls)
- Network Services ↔ External API
- Models should be shown as being used across all layers

##### Technical Stack Indicators

Technology labels:
- Kotlin
- Retrofit
- MVVM
- AndroidX
- LiveData
- Glide
- Material Design

**[UI Layer (Activities/Fragments/XML)]**
- ↓
**[ViewModels (MVVM Pattern)]**
- ↓
**[Repositories]**
- ↓
**[Network Services] ←→ [Data Models]**
- ↓
**[External API]**

##### Where shared utilities and constants are used across the application.

This will provide a comprehensive view of the Vinilos application's architecture while maintaining clarity about how different components interact with each other.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and classes
    classDef ui fill:#e6f3ff,stroke:#4a90e2
    classDef viewmodel fill:#e6ffe6,stroke:#2ecc71
    classDef repository fill:#fff5e6,stroke:#f1c40f
    classDef network fill:#ffe6e6,stroke:#e74c3c
    classDef model fill:#f5e6ff,stroke:#9b59b6
    classDef config fill:#e6e6e6,stroke:#95a5a6

    %% Legend
    subgraph Legend
        UI[UI Components]:::ui
        VM[ViewModels]:::viewmodel
        REPO[Repositories]:::repository
        NET[Network Services]:::network
        MOD[Models]:::model
        CONF[Configuration]:::config
    end

    %% UI Layer
    subgraph UILayer[UI Layer]
        Activities["Activities & Fragments"]:::ui
        click Activities "https://github.com/mpadillae/MISW4203-202415-Vinilos/tree/main/app/src/main/java/com/mfpe/vinilos/ui"
        Layouts["XML Layouts"]:::ui
        click Layouts "https://github.com/mpadillae/MISW4203-202415-Vinilos/tree/main/app/src/main/res/layout"
        
        subgraph Adapters
            AlbumAdapter["Album Adapter"]:::ui
            click AlbumAdapter "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/adapters/AlbumAdapter.kt"
            BandAdapter["Band Adapter"]:::ui
            click BandAdapter "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/adapters/BandAdapter.kt"
            CollectorAdapter["Collector Adapter"]:::ui
            click CollectorAdapter "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/adapters/CollectorAdapter.kt"
            MusicianAdapter["Musician Adapter"]:::ui
            click MusicianAdapter "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/adapters/MusicianAdapter.kt"
        end
    end

    %% ViewModel Layer
    subgraph ViewModelLayer[ViewModel Layer]
        AlbumVM["Album List ViewModel"]:::viewmodel
        click AlbumVM "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/viewmodel/AlbumListViewModel.kt"
        ArtistVM["Artist List ViewModel"]:::viewmodel
        click ArtistVM "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/viewmodel/ArtistListViewModel.kt"
        CollectorVM["Collector List ViewModel"]:::viewmodel
        click CollectorVM "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/viewmodel/CollectorListViewModel.kt"
    end

    %% Repository Layer
    subgraph RepositoryLayer[Repository Layer]
        AlbumRepo["Album Repository"]:::repository
        click AlbumRepo "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/repository/AlbumRepository.kt"
        BandRepo["Band Repository"]:::repository
        click BandRepo "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/repository/BandRepository.kt"
        CollectorRepo["Collector Repository"]:::repository
        click CollectorRepo "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/repository/CollectorRepository.kt"
        MusicianRepo["Musician Repository"]:::repository
        click MusicianRepo "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/repository/MusicianRepository.kt"
    end

    %% Data Layer
    subgraph DataLayer[Data Layer]
        subgraph NetworkServices[Network Services]
            RetrofitClient["Retrofit API Client"]:::network
            click RetrofitClient "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/network/RetrofitApiClient.kt"
            AlbumService["Album Service"]:::network
            click AlbumService "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/network/AlbumService.kt"
            BandService["Band Service"]:::network
            click BandService "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/network/BandService.kt"
            CollectorService["Collector Service"]:::network
            click CollectorService "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/network/CollectorService.kt"
            MusicianService["Musician Service"]:::network
            click MusicianService "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/network/MusicianService.kt"
        end

        subgraph Models[Data Models]
            Album["Album Model"]:::model
            click Album "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/model/Album.kt"
            Band["Band Model"]:::model
            click Band "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/model/Band.kt"
            Collector["Collector Model"]:::model
            click Collector "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/model/Collector.kt"
            Musician["Musician Model"]:::model
            click Musician "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/java/com/mfpe/vinilos/data/model/Musician.kt"
        end
    end

    %% Configuration
    subgraph Config[Configuration]
        AndroidManifest["AndroidManifest.xml"]:::config
        click AndroidManifest "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/AndroidManifest.xml"
        Navigation["Navigation Graph"]:::config
        click Navigation "https://github.com/mpadillae/MISW4203-202415-Vinilos/blob/main/app/src/main/res/navigation/mobile_navigation.xml"
    end

    %% Relationships
    Activities --> AlbumAdapter & BandAdapter & CollectorAdapter & MusicianAdapter
    Activities --> AlbumVM & ArtistVM & CollectorVM
    AlbumVM --> AlbumRepo
    ArtistVM --> BandRepo & MusicianRepo
    CollectorVM --> CollectorRepo
    AlbumRepo & BandRepo & CollectorRepo & MusicianRepo --> RetrofitClient
    RetrofitClient --> AlbumService & BandService & CollectorService & MusicianService
    AlbumService & BandService & CollectorService & MusicianService --> ExternalAPI[("External API")]:::network
```
