# leniolabs/ai-data-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/leniolabs/ai-data-dashboard
- Repository: https://github.com/leniolabs/ai-data-dashboard

## Overview

##### Project type and purpose
- This is a full-stack Next.js application (React + TypeScript) that lets end users upload CSV datasets and uses OpenAI’s GPT-3 to generate JSON-driven visualizations (bar, line, pie, treemap, etc.).
- The README confirms it’s a dashboard generator that accepts CSVs, sends them to OpenAI via a prompt template, and then renders charts automatically.

##### File structure
- Top-level “pages” folder: contains Next.js entrypoints (`_app.tsx`, `index.tsx`).
- “components/” subdivided into “layout” (UI widgets, buttons, inputs, panels) and “viz” (chart components).
- “openai/” folder: encapsulates all GPT-3 integration—API wrappers (`completions.ts`, `analyze.ts`), prompt templates, model configs.
- “utils/” holds CSV parsing, formatting, styling helpers.
- “lib/gtag.ts”: Google Analytics.
- Configuration: `next.config.js`, `tsconfig.json`, ESLint and style files under “styles/” and `.vscode`.

##### README for insights
- Architecture isn’t explicitly diagrammed there, but it specifies a client-server flow: user uploads CSV → AI analysis → JSON → charts.
- Dependencies: Next.js, OpenAI API, React, CSS modules.

##### Main components & interactions
a. Frontend / Presentation Layer
- Browser / User
- Next.js React UI: `pages/index.tsx`, components/layout, components/viz
- CSV Uploader (UploadDatasetButton + utils/parseData)
- User controls (filters, settings modal)
b. Backend / Business Logic Layer
- Next.js Serverless API (implied or built into pages—could be an API Route or server‐side function called from getServerSideProps or client fetch)
- openai/index.ts → analyze.ts / completions.ts → uses prompt templates in openai/template.ts
- Model configs: openai/models/*.ts
- Data transformation (utils/models.ts, utils/parseFunc.ts)
c. External Services
- OpenAI GPT-3 API (completions endpoint)
- Google Analytics (lib/gtag.ts)
d. Styling / Static Assets
- CSS Modules (`styles/Components.module.scss`) and `public/`

##### Architectural patterns & design principles
- Layered pattern: Presentation (components) ←→ Business Logic (API wrappers + utils) ←→ External (OpenAI).
- Component-based UI (atomic layout + viz components).
- Single-page interactions powered by serverless functions (no persistent database).
- JSON-first protocol: AI returns chart specifications that drive React viz components.

##### Essential elements
- Clear, consistent labels: “UploadDatasetButton”, “analyze.ts prompt service”, “PieChart”, etc.
- A title at the top: “AI Dashboard Generator – System Architecture”.
- A note or footnote explaining that components under `openai/models` select the GPT-3 variant.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "AI Dashboard Generator – System Architecture"
    end

    subgraph "Frontend Layer"
        Browser["Browser / User"]:::external
        PageApp["pages/_app.tsx"]:::frontend
        PageIndex["pages/index.tsx"]:::frontend
        LayoutDir["components/layout/"]:::frontend
        VizDir["components/viz/"]:::frontend
        Uploader["UploadDatasetButton"]:::frontend
        Settings["SettingsModal"]:::frontend
        Filter["DropdownFilter"]:::frontend
        Charts["Chart Components (Pie, Bar, Line, Treemap)"]:::frontend
    end

    subgraph "API & Business Logic"
        OpenaiIndex["openai/index.ts"]:::server
        AnalyzeSvc["openai/analyze.ts"]:::server
        Completions["openai/completions.ts"]:::server
        Template["openai/template.ts"]:::server
        ModelsCfg["openai/models/"]:::server
    end

    subgraph "External Services"
        OpenAI["OpenAI GPT-3 API"]:::external
        Analytics["Google Analytics (gtag)"]:::external
    end

    subgraph "Utilities & Styling"
        CSVParse["utils/parseData.ts"]:::util
        ParseFunc["utils/parseFunc.ts"]:::util
        ModelsUtil["utils/models.ts"]:::util
        CSSModules["styles/Components.module.scss"]:::util
        GlobalsCSS["styles/globals.css"]:::util
    end

    Browser --> PageIndex
    Browser --> PageApp
    PageApp --> Analytics
    PageIndex --> Uploader
    PageIndex --> Settings
    PageIndex --> Filter
    PageIndex --> Charts
    Uploader --> CSVParse
    CSVParse --> PageIndex
    PageIndex -->|"POST /api/analyze"| OpenaiIndex
    OpenaiIndex --> AnalyzeSvc
    AnalyzeSvc --> Completions
    Completions --> OpenAI
    OpenAI --> Completions
    Completions --> AnalyzeSvc
    AnalyzeSvc --> Template
    AnalyzeSvc --> ModelsCfg
    AnalyzeSvc --> ModelsUtil
    AnalyzeSvc --> ParseFunc
    AnalyzeSvc --> PageIndex
    PageIndex --> Analytics

    click PageIndex "https://github.com/leniolabs/ai-data-dashboard/blob/develop/pages/index.tsx"
    click PageApp "https://github.com/leniolabs/ai-data-dashboard/blob/develop/pages/_app.tsx"
    click LayoutDir "https://github.com/leniolabs/ai-data-dashboard/tree/develop/components/layout/"
    click VizDir "https://github.com/leniolabs/ai-data-dashboard/tree/develop/components/viz/"
    click Uploader "https://github.com/leniolabs/ai-data-dashboard/blob/develop/components/layout/UploadDatasetButton.tsx"
    click CSVParse "https://github.com/leniolabs/ai-data-dashboard/blob/develop/utils/parseData.ts"
    click Settings "https://github.com/leniolabs/ai-data-dashboard/blob/develop/components/layout/SettingsModal.tsx"
    click Filter "https://github.com/leniolabs/ai-data-dashboard/blob/develop/components/viz/DropdownFilter.tsx"
    click OpenaiIndex "https://github.com/leniolabs/ai-data-dashboard/blob/develop/openai/index.ts"
    click AnalyzeSvc "https://github.com/leniolabs/ai-data-dashboard/blob/develop/openai/analyze.ts"
    click Completions "https://github.com/leniolabs/ai-data-dashboard/blob/develop/openai/completions.ts"
    click Template "https://github.com/leniolabs/ai-data-dashboard/blob/develop/openai/template.ts"
    click ModelsCfg "https://github.com/leniolabs/ai-data-dashboard/tree/develop/openai/models/"
    click Analytics "https://github.com/leniolabs/ai-data-dashboard/blob/develop/lib/gtag.ts"
    click ModelsUtil "https://github.com/leniolabs/ai-data-dashboard/blob/develop/utils/models.ts"
    click ParseFunc "https://github.com/leniolabs/ai-data-dashboard/blob/develop/utils/parseFunc.ts"
    click CSSModules "https://github.com/leniolabs/ai-data-dashboard/blob/develop/styles/Components.module.scss"
    click GlobalsCSS "https://github.com/leniolabs/ai-data-dashboard/blob/develop/styles/globals.css"

    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef server fill:#E0F8E0,stroke:#228B22,color:#228B22
    classDef external fill:#FFE0B2,stroke:#FF8C00,color:#FF8C00
    classDef util fill:#F0F0F0,stroke:#888888,color:#555555
```
