# dvadell/nya architecture

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

- Interactive diagram: https://gitdiagram.com/dvadell/nya
- Repository: https://github.com/dvadell/nya

## Overview

##### Main Components Structure

a) Client-Side Application (Frontend)
- Core Components Layer
- MainPage
- GatosNavBar
- GatosSideBar
- Card/CardList System
- Feature Modules Layer
- SubeGato (Cat Upload)
- MyCats
- Ver (View)
- Settings
- Integration Layer
- Mapa
- GatoMarker
- MarkerList
- Shared Components Layer
- Alerts
- Credits
- CardSlider

b) State Management
- Actions (from actions.js)
- Reducers (from reducers.js)

c) Progressive Web App Features
- A "PWA Layer" showing:
- Service Worker (from service-worker-policy.js)
- Workbox Configuration
- Cache Storage

##### Data Flow and Interactions
- User interaction flows
- State updates through Redux
- Service worker cache interactions
- Image compression pipeline (via compressImg.js)

##### Cross-Cutting Concerns
- Internationalization (shown by *.translations.js files)
- Error Handling (withError.js)
- Loading States (withLoading.js)

**🔷 React Component**
**🔶 Redux Store**
**⭐ PWA Feature**
**🔄 Data Flow**
**📱 Mobile-specific Feature**
**🌐 Internationalization**

##### The localization system

- Component relationships
- Data flow patterns
- Progressive enhancement features
- Cross-cutting concerns

This will give other developers a clear understanding of how the application works while maintaining the right level of abstraction for a principal software engineer to understand the system's architecture.

Remember to include a note about testing coverage, as evidenced by the numerous *.test.js files and __snapshots__ directories throughout the project.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "React Frontend"
        subgraph "Core Components"
            MainPage["Main Page"]:::react
            GatosNavBar["Navigation Bar"]:::react
            GatosSideBar["Side Bar"]:::react
            CardSystem["Card System"]:::react
        end

        subgraph "Feature Modules"
            SubeGato["Cat Upload"]:::react
            MyCats["My Cats"]:::react
            Ver["View"]:::react
            Settings["Settings"]:::react
        end

        subgraph "Map Integration"
            Mapa["Map Component"]:::react
            GatoMarker["Cat Marker"]:::react
            MarkerList["Marker List"]:::react
        end

        subgraph "Shared Components"
            Alerts["Alerts"]:::react
            Credits["Credits"]:::react
            CardSlider["Card Slider"]:::react
        end
    end

    subgraph "State Management"
        ReduxStore["Redux Store"]:::redux
        Actions["Actions"]:::redux
        Reducers["Reducers"]:::redux
    end

    subgraph "PWA Features"
        ServiceWorker["Service Worker"]:::pwa
        WorkboxConfig["Workbox Config"]:::pwa
        CacheStorage["Cache Storage"]:::pwa
    end

    subgraph "Cross-Cutting Concerns"
        ErrorHandling["Error Handling"]:::cross
        LoadingStates["Loading States"]:::cross
        I18n["Internationalization"]:::cross
        ImageCompression["Image Compression"]:::cross
    end

    MainPage --> CardSystem
    MainPage --> GatosNavBar
    MainPage --> GatosSideBar
    MainPage --> Mapa
    
    Actions --> ReduxStore
    ReduxStore --> Reducers
    Reducers --> ReduxStore

    ServiceWorker --> CacheStorage
    WorkboxConfig --> ServiceWorker

    %% Component interactions
    CardSystem --> Alerts
    SubeGato --> ImageCompression
    Mapa --> MarkerList
    MarkerList --> GatoMarker

    %% Cross-cutting concerns connections
    ErrorHandling -.-> MainPage
    LoadingStates -.-> MainPage
    I18n -.-> MainPage
    
    %% Click events for component mapping
    click MainPage "https://github.com/dvadell/nya/blob/master/src/components/MainPage.js"
    click GatosNavBar "https://github.com/dvadell/nya/blob/master/src/components/GatosNavBar/GatosNavBar.js"
    click GatosSideBar "https://github.com/dvadell/nya/blob/master/src/GatosSideBar.js"
    click CardSystem "https://github.com/dvadell/nya/blob/master/src/Card.js"
    click SubeGato "https://github.com/dvadell/nya/blob/master/src/components/SubeGato/SubeGato.js"
    click MyCats "https://github.com/dvadell/nya/blob/master/src/components/MyCats/MyCats.js"
    click Ver "https://github.com/dvadell/nya/blob/master/src/components/Ver/Ver.js"
    click Settings "https://github.com/dvadell/nya/blob/master/src/components/Settings/Settings.js"
    click Mapa "https://github.com/dvadell/nya/blob/master/src/components/Mapa.js"
    click GatoMarker "https://github.com/dvadell/nya/blob/master/src/components/GatoMarker.js"
    click MarkerList "https://github.com/dvadell/nya/blob/master/src/components/MarkerList.js"
    click Alerts "https://github.com/dvadell/nya/blob/master/src/components/Alerts/Alerts.js"
    click Credits "https://github.com/dvadell/nya/blob/master/src/components/Credits/Credits.js"
    click CardSlider "https://github.com/dvadell/nya/blob/master/src/components/CardSlider.js"
    click Actions "https://github.com/dvadell/nya/blob/master/src/actions.js"
    click Reducers "https://github.com/dvadell/nya/blob/master/src/reducers.js"
    click ServiceWorker "https://github.com/dvadell/nya/blob/master/src/service-worker-policy.js"
    click WorkboxConfig "https://github.com/dvadell/nya/blob/master/workbox-config.js"
    click ErrorHandling "https://github.com/dvadell/nya/blob/master/src/components/withError.js"
    click LoadingStates "https://github.com/dvadell/nya/blob/master/src/components/withLoading.js"
    click I18n "https://github.com/dvadell/nya/blob/master/src/lib/Localized.js"
    click ImageCompression "https://github.com/dvadell/nya/blob/master/src/lib/compressImg.js"

    classDef react fill:#61DAFB,stroke:#61DAFB,color:#000000
    classDef redux fill:#764ABC,stroke:#764ABC,color:#FFFFFF
    classDef pwa fill:#FF9800,stroke:#FF9800,color:#000000
    classDef cross fill:#E91E63,stroke:#E91E63,color:#FFFFFF

    %% Legend
    subgraph Legend
        React["🔷 React Component"]:::react
        Redux["🔶 Redux Store"]:::redux
        PWA["⭐ PWA Feature"]:::pwa
        Cross["🌐 Cross-Cutting"]:::cross
    end
```
