# ynesterenk/airrun-migration-finance-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/ynesterenk/airrun-migration-finance-dashboard
- Repository: https://github.com/ynesterenk/airrun-migration-finance-dashboard

## Overview

##### Project type and purpose
- This is a front-end, single‐page React/TypeScript application built with Vite that implements a dynamic “dashboard plugin system.”
- Its purpose is to load and render a series of self-contained widget components (plugins) at runtime, based on an active-plugins configuration.

##### File structure
- Top level
- public/: static assets (index.html, manifest.json, robots.txt, tailwind.css)
- src/: application source
- ├─ components/: shared UI pieces (cards, inputs, tabs)
- ├─ config/pluginRegistry.ts: registry mapping plugin IDs to React components
- ├─ services/pluginService.ts: runtime service deciding which plugins are active
- ├─ plugins/: one folder per widget plugin, each containing
│       – Main component (e.g. IntradayChart.tsx)
│       – data.ts for mock or fetch logic
│       – index.ts to export the component
- ├─ App.tsx: orchestrates loading & rendering of active plugins
- ├─ index.tsx, CSS, tests, utility libs, Tailwind config
- Build/config files: package.json, vite.config.mts, tsconfig.json, tailwind.config.js

##### README for additional insights
- Explains the plugin-component structure, the registry that “knows” about all plugins, and the service that simulates fetching which plugins are active.
- Emphasizes that adding or removing plugins requires no code changes in App.tsx—only registry & service updates.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Static Assets & Build
    subgraph "Static Assets & Build"
        direction TB
        HTML["index.html"]:::build
        VITE["vite.config.mts"]:::build
        PKG["package.json"]:::build
        TAILW_CFG["tailwind.config.js"]:::build
    end

    %% Core App Layer
    subgraph "Core App Layer"
        direction TB
        INDEX["src/index.tsx"]:::core
        APP["src/App.tsx"]:::core
        APP_CSS["src/App.css"]:::core
        SERVICE["src/services/pluginService.ts"]:::core
        REGISTRY["src/config/pluginRegistry.ts"]:::core
        TAILW_IN["src/tailwind.css"]:::core
    end

    %% Shared UI Components
    subgraph "Shared UI Components"
        direction TB
        CARD["src/components/ui/card.tsx"]:::shared
        INPUT["src/components/ui/input.tsx"]:::shared
        TABS["src/components/ui/tabs.tsx"]:::shared
    end

    %% Utility Libraries
    UTIL["src/lib/utils.ts"]:::shared

    %% Plugin Modules
    subgraph "Plugin Modules"
        direction TB
        subgraph "CrossAssetMonitor"
            direction TB
            CAM_COMP["CrossAssetMonitor.tsx"]:::plugin
            CAM_DATA["data.ts"]:::plugin
            CAM_IDX["index.ts"]:::plugin
        end
        subgraph "CurrencyExchangeRate"
            direction TB
            CER_COMP["CurrencyExchangeRate.tsx"]:::plugin
            CER_DATA["data.ts"]:::plugin
            CER_IDX["index.ts"]:::plugin
        end
        subgraph "HistoricalChart"
            direction TB
            HC_COMP["HistoricalChart.tsx"]:::plugin
            HC_DATA["data.ts"]:::plugin
            HC_IDX["index.ts"]:::plugin
        end
        subgraph "IntradayChart"
            direction TB
            IC_COMP["IntradayChart.tsx"]:::plugin
            IC_DATA["data.ts"]:::plugin
            IC_IDX["index.ts"]:::plugin
        end
        subgraph "NewsFeed"
            direction TB
            NF_COMP["NewsFeed.tsx"]:::plugin
            NF_DATA["data.ts"]:::plugin
            NF_IDX["index.ts"]:::plugin
        end
    end

    %% External Services
    API["External API Endpoints"]:::external

    %% Testing & Config
    subgraph "Testing & Config"
        direction TB
        TEST_APP["src/App.test.tsx"]:::shared
        SETUP["src/setupTests.tsx"]:::shared
        TS_CFG["tsconfig.json"]:::build
    end

    %% Flow
    HTML -->|"serves"| INDEX
    INDEX -->|"renders"| APP
    APP -->|"calls getActivePlugins"| SERVICE
    SERVICE -->|"simulates API call"| API
    APP -->|"queries"| REGISTRY
    REGISTRY -->|"maps IDs to"| CAM_IDX
    REGISTRY --> CER_IDX
    REGISTRY --> HC_IDX
    REGISTRY --> IC_IDX
    REGISTRY --> NF_IDX
    APP -->|"renders UI"| CARD
    APP --> INPUT
    APP --> TABS
    CARD --> UTIL
    INPUT --> UTIL
    TABS --> UTIL
    CAM_COMP --> CAM_DATA
    CAM_DATA --> API
    CER_COMP --> CER_DATA
    CER_DATA --> API
    HC_COMP --> HC_DATA
    HC_DATA --> API
    IC_COMP --> IC_DATA
    IC_DATA --> API
    NF_COMP --> NF_DATA
    NF_DATA --> API

    %% Click events
    click HTML "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/index.html"
    click VITE "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/vite.config.mts"
    click INDEX "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/index.tsx"
    click APP "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/App.tsx"
    click APP_CSS "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/App.css"
    click SERVICE "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/services/pluginService.ts"
    click REGISTRY "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/config/pluginRegistry.ts"
    click CARD "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/components/ui/card.tsx"
    click INPUT "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/components/ui/input.tsx"
    click TABS "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/components/ui/tabs.tsx"
    click UTIL "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/lib/utils.ts"
    click CAM_COMP "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/CrossAssetMonitor/CrossAssetMonitor.tsx"
    click CAM_DATA "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/CrossAssetMonitor/data.ts"
    click CAM_IDX "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/CrossAssetMonitor/index.ts"
    click CER_COMP "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/CurrencyExchangeRate/CurrencyExchangeRate.tsx"
    click CER_DATA "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/CurrencyExchangeRate/data.ts"
    click CER_IDX "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/CurrencyExchangeRate/index.ts"
    click HC_COMP "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/HistoricalChart/HistoricalChart.tsx"
    click HC_DATA "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/HistoricalChart/data.ts"
    click HC_IDX "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/HistoricalChart/index.ts"
    click IC_COMP "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/IntradayChart/IntradayChart.tsx"
    click IC_DATA "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/IntradayChart/data.ts"
    click IC_IDX "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/IntradayChart/index.ts"
    click NF_COMP "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/NewsFeed/NewsFeed.tsx"
    click NF_DATA "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/NewsFeed/data.ts"
    click NF_IDX "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/plugins/NewsFeed/index.ts"
    click TAILW_CFG "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/tailwind.config.js"
    click TAILW_IN "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/tailwind.css"
    click PKG "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/package.json"
    click TS_CFG "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/tsconfig.json"
    click TEST_APP "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/App.test.tsx"
    click SETUP "https://github.com/ynesterenk/airrun-migration-finance-dashboard/blob/main/src/setupTests.tsx"

    %% Styles
    classDef core fill:#E0F2FF,stroke:#0366d6,stroke-width:2px
    classDef plugin fill:#E6FFEA,stroke:#28a745,stroke-width:2px
    classDef shared fill:#F5F5F5,stroke:#6c757d,stroke-width:2px
    classDef build fill:#FFF4E5,stroke:#db9c00,stroke-width:2px
    classDef external fill:#F0F4C3,stroke:#a67c00,stroke-width:2px,stroke-dasharray: 5 5
```
