# yueee69/rebuild_discord_bot architecture

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

- Interactive diagram: https://gitdiagram.com/yueee69/rebuild_discord_bot
- Repository: https://github.com/yueee69/rebuild_discord_bot

## Overview

##### Project type and purpose
- This is a Python-based Discord bot, refactored into an OOP architecture. It listens to Discord events, processes commands and interactions, manages data in JSON, and offers subsystems such as Lottery, Profile Management, Ranks, AI chat, and auto-features (e.g. auto-buy, auto-sign-in).

##### File structure
- Top-level entry: main.py.
- “events/discord_listener.py” hooks into Discord Gateway events.
- “commands/” implements slash-commands; each command has a view (views/) and a callback (callbacks/).
- “features/” holds background services (auto_lottery, auto_sign_in, auto_buy).
- “Lottery/” and “profile_management/” each encapsulate a driver subsystem using Strategy/Factory patterns:
- Lottery uses gacha_resource, tools, and main_driver.
- Profile_management has its own drivers, events, feature modules, and a main_driver.
- “models/” maps each JSON file to a manager class.
- “ranks/” is another subsystem using an abstract base and concrete rank implementations.
- “Json/” directory is the flat JSON file datastore.
- “Ai/” interfaces with ChatGPT.
- “utils/” contains common helpers (discord_model, time, validation).

##### README for insights
- Emphasizes refactoring to OOP, modularity, and maintainability.
- Lists core directories and design patterns: abstraction in ranks, strategy & factory in Lottery and profile_management.

##### Elements
- Core components in another

##### Detailed capture of essential elements
- Models as a layer between business logic and JSON files.
- Utilities as thin helpers attached to any component needing them.

## Diagram (Mermaid)

```mermaid
flowchart TB
    DG["Discord Gateway"]:::external
    OA["OpenAI API"]:::external

    subgraph "Bot Core"
        EL["Event Listener"]:::core
        CD["Command Dispatcher"]:::core
        VC["View Constructors"]:::core
        CB["Callback Handlers"]:::core
    end

    subgraph "Lottery Subsystem"
        LGRes["gacha_resource"]:::subsystem
        LGTools["gacha_tools"]:::subsystem
        LD["lottery_driver"]:::subsystem
        LMD["main_driver"]:::subsystem
        LV["view_constructor"]:::subsystem
    end

    subgraph "Profile Management Subsystem"
        PMMD["main_driver"]:::subsystem
        PMDrv["drivers"]:::subsystem
        PMCE["card_events"]:::subsystem
        PMVC["view_constructor"]:::subsystem
        PMPerm["DiscordPermissionsTool"]:::subsystem
    end

    subgraph "Ranks Subsystem"
        RB["base"]:::subsystem
        RA["air"]:::subsystem
        RC["coin"]:::subsystem
        RMD["main_driver"]:::subsystem
    end

    subgraph "Auto-Features"
        AF_alm["auto_lottery_feature"]:::subsystem
        AF_asin["auto_sign_in_feature"]:::subsystem
        AF_abuy["auto_buy_feature"]:::subsystem
        AF_f["feature"]:::subsystem
    end

    AC["AI Chat Module"]:::subsystem

    subgraph "Data Layer"
        MM["Model Managers"]:::data
        JD["JSON Datastore"]:::data
    end

    UT["Utilities"]:::util

    DG --> EL --> CD
    CD --> VC
    CD --> CB

    CD --> LMD
    CD --> PMMD
    CD --> RMD
    CD --> AF_alm
    CD --> AC

    LMD --> MM
    PMMD --> MM
    RMD --> MM
    AF_alm --> MM

    MM --> JD
    AC --> OA

    UT -.-> EL
    UT -.-> CD
    UT -.-> LMD
    UT -.-> PMMD
    UT -.-> RMD
    UT -.-> AF_alm
    UT -.-> AC

    click EL "https://github.com/yueee69/rebuild_discord_bot/blob/main/events/discord_listener.py"
    click CD "https://github.com/yueee69/rebuild_discord_bot/blob/main/commands/base_command.py"
    click CB "https://github.com/yueee69/rebuild_discord_bot/tree/main/callbacks/"
    click VC "https://github.com/yueee69/rebuild_discord_bot/tree/main/views/"
    click LGRes "https://github.com/yueee69/rebuild_discord_bot/blob/main/Lottery/gacha_resource.py"
    click LGTools "https://github.com/yueee69/rebuild_discord_bot/blob/main/Lottery/gacha_tools.py"
    click LD "https://github.com/yueee69/rebuild_discord_bot/blob/main/Lottery/lottery_driver.py"
    click LMD "https://github.com/yueee69/rebuild_discord_bot/blob/main/Lottery/main_driver.py"
    click LV "https://github.com/yueee69/rebuild_discord_bot/blob/main/Lottery/view_constructor.py"
    click PMMD "https://github.com/yueee69/rebuild_discord_bot/blob/main/profile_management/main_driver.py"
    click PMDrv "https://github.com/yueee69/rebuild_discord_bot/tree/main/profile_management/drivers/"
    click PMCE "https://github.com/yueee69/rebuild_discord_bot/tree/main/profile_management/card_events/"
    click PMVC "https://github.com/yueee69/rebuild_discord_bot/blob/main/profile_management/view_constructor.py"
    click PMPerm "https://github.com/yueee69/rebuild_discord_bot/tree/main/profile_management/DiscordPermissionsTool/"
    click RB "https://github.com/yueee69/rebuild_discord_bot/blob/main/ranks/base.py"
    click RA "https://github.com/yueee69/rebuild_discord_bot/blob/main/ranks/air.py"
    click RC "https://github.com/yueee69/rebuild_discord_bot/blob/main/ranks/coin.py"
    click RMD "https://github.com/yueee69/rebuild_discord_bot/blob/main/ranks/main_driver.py"
    click AF_alm "https://github.com/yueee69/rebuild_discord_bot/blob/main/features/auto_lottery_feature.py"
    click AF_asin "https://github.com/yueee69/rebuild_discord_bot/blob/main/features/auto_sign_in_feature.py"
    click AF_abuy "https://github.com/yueee69/rebuild_discord_bot/blob/main/features/auto_buy_feature.py"
    click AF_f "https://github.com/yueee69/rebuild_discord_bot/blob/main/features/feature.py"
    click AC "https://github.com/yueee69/rebuild_discord_bot/blob/main/Ai/chatgpt.py"
    click MM "https://github.com/yueee69/rebuild_discord_bot/tree/main/models/"
    click UT "https://github.com/yueee69/rebuild_discord_bot/tree/main/utils/"

    classDef external fill:#BBDEFB,stroke:#000;
    classDef core fill:#C8E6C9,stroke:#000;
    classDef subsystem fill:#FFE0B2,stroke:#000;
    classDef data fill:#D7CCC8,stroke:#000;
    classDef util fill:#E1BEE7,stroke:#000;
```
