# errornointernet/doge-utilities architecture

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

- Interactive diagram: https://gitdiagram.com/errornointernet/doge-utilities
- Repository: https://github.com/errornointernet/doge-utilities

## Overview

##### Main Components

- core.py (main bot logic)
- functions.py (utility functions)
- language.py (internationalization)
- variables.py (configuration)
- converter.py (data conversion utilities)

- Discord API
- Top.gg API
- OpenWeatherMap API
- Redis Database

c. Web Interface (Right Side):
- Web Server (server.py)
- Static Content
- Dashboard (web_dashboard.html)
- Command List (commands.html)
- Other Static Pages

##### Component Relationships

- Bot Core ↔ Discord API (WebSocket and REST)
- Bot Core ↔ Redis Database (data persistence)
- Bot Core ↔ OpenWeatherMap API (weather data)
- Bot Core ↔ Top.gg API (bot statistics)
- Web Server ↔ Static Content
- Web Server ↔ Discord OAuth2
- Web Server ↔ Redis Database

##### Environment Configuration

A configuration section showing:
- Environment Variables
- API Keys
- Authentication Tokens

## Diagram (Mermaid)

```mermaid
graph TB
    %% External Services
    subgraph ExternalServices
        direction TB
        Discord[Discord API]:::external
        TopGG[Top.gg API]:::external
        Weather[OpenWeatherMap API]:::external
        Redis[(Redis Database)]:::database
    end

    %% Core Bot Components
    subgraph BotCore
        direction TB
        Main["Main Entry Point"]:::core
        Core["Core Bot Logic"]:::core
        Functions["Utility Functions"]:::core
        Lang["Internationalization"]:::core
        Vars["Configuration"]:::core
        Conv["Data Converter"]:::core
    end

    %% Web Interface
    subgraph WebInterface
        direction TB
        Server["Web Server"]:::web
        subgraph StaticContent
            direction TB
            Dashboard["Dashboard"]:::static
            Commands["Command List"]:::static
            Other["Other Static Pages"]:::static
            Nav["Navigation"]:::static
        end
    end

    %% Environment Configuration
    subgraph Config
        direction TB
        EnvVars["Environment Variables"]:::config
        APIKeys["API Keys"]:::config
        AuthTokens["Authentication Tokens"]:::config
    end

    %% Connections
    Core <--> Discord
    Core <--> Redis
    Core <--> Weather
    Core <--> TopGG
    Server <--> Redis
    Server <--> Discord
    Server --> StaticContent
    Config --> Core
    Config --> Server
    Main --> Core
    Core --> Functions
    Core --> Lang
    Core --> Vars
    Core --> Conv

    %% Click Events
    click Core "https://github.com/ErrorNoInternet/Doge-Utilities/blob/main/core.py"
    click Functions "https://github.com/ErrorNoInternet/Doge-Utilities/blob/main/functions.py"
    click Lang "https://github.com/ErrorNoInternet/Doge-Utilities/blob/main/language.py"
    click Vars "https://github.com/ErrorNoInternet/Doge-Utilities/blob/main/variables.py"
    click Conv "https://github.com/ErrorNoInternet/Doge-Utilities/blob/main/converter.py"
    click Server "https://github.com/ErrorNoInternet/Doge-Utilities/blob/main/server.py"
    click Dashboard "https://github.com/ErrorNoInternet/Doge-Utilities/blob/main/static/web_dashboard.html"
    click Commands "https://github.com/ErrorNoInternet/Doge-Utilities/blob/main/static/commands.html"
    click Other "https://github.com/ErrorNoInternet/Doge-Utilities/tree/main/static"
    click Nav "https://github.com/ErrorNoInternet/Doge-Utilities/blob/main/static/side_bar.html"
    click Main "https://github.com/ErrorNoInternet/Doge-Utilities/blob/main/main.py"

    %% Styles
    classDef core fill:#2b5797,color:#fff
    classDef external fill:#00a300,color:#fff
    classDef web fill:#ff8c00,color:#fff
    classDef static fill:#666,color:#fff
    classDef database fill:#8000ff,color:#fff
    classDef config fill:#ff0097,color:#fff

    %% Legend
    subgraph Legend
        L1[Core Components]:::core
        L2[External Services]:::external
        L3[Web Components]:::web
        L4[Static Content]:::static
        L5[(Database)]:::database
        L6[Configuration]:::config
    end
```
