# fizzyelt/discord-message-record-bot-effect-ts architecture

> Architecture diagram of the GitHub repository fizzyelt/discord-message-record-bot-effect-ts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fizzyelt/discord-message-record-bot-effect-ts
- Repository: https://github.com/fizzyelt/discord-message-record-bot-effect-ts

## Overview

##### Main Components

A. Core Bot Infrastructure
- Discord.js Client Service
- Event Listeners System
- Command Handler
- Environment Configuration

B. Feature Modules
- Message Recording System
- Channel Management
- Moderation System
- Role Management
- Sticky Messages
- Meme System

C. Data Layer
- Database Service (using Drizzle ORM)
- In-memory Stores

**┌─ External Layer ─────────────────────┐**
- Discord API                          │
- ┬──────────────────┘
- ↓
**┌─ Service Layer ──────────────────────┐**
- ┌─────────────┐  ┌────────────────┐ │
- Discord Client│  │Event Listeners │ │
- ┘  └────────────────┘ │
- ┬──────────────────┘
- ↓
**┌─ Feature Layer ─────────────────────┐**
- ┌─────────┐ ┌────────┐ ┌─────────┐ │
- Messages │ │Commands│ │Guards   │ │
- ┘ └────────┘ └─────────┘ │
- ┬──────────────────┘
- ↓
**┌─ Data Layer ───────────────────────┐**
- ┌─────────┐  ┌──────────────────┐  │
- Database │  │In-memory Stores  │  │
- ┘  └──────────────────┘  │
- ┘

##### Component Details

A. Event Listeners (src/listeners):
- Connections to interaction_create
- message_create/update/delete
- ready events

B. Command System (src/slash_command):
- Main_command
- meme_command
- sticky_command
- clear command

C. Tasks (src/tasks):
- By functionality:
- Channel management
- Member management
- Message handling
- Role management
- Meme handling

D. Services (src/services):
- Relationships between:
- channel_store
- sticky_store
- voting_store
- database
- timeout

##### Important Flows to Highlight

- Message Recording Flow:
- Discord Event → Listener → Message Guard → Database

- Command Processing Flow:
- Interaction → Command Handler → Service → Response

- Moderation Flow:
- Command → Voting Store → Timeout Service → Discord API

##### Implementation Notes

- Version information and date

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Layer
    subgraph External
        DiscordAPI["Discord API"]
    end

    %% Service Layer
    subgraph ServiceLayer["Service Layer"]
        Client["Discord Client"]:::service
        EventSystem["Event Listeners"]:::service
        EnvConfig["Environment Config"]:::service
    end

    %% Feature Layer
    subgraph FeatureLayer["Feature Layer"]
        CommandHandler["Command Handler"]:::feature
        
        subgraph MessageFeatures["Message Features"]
            MessageRecording["Message Recording"]:::feature
            StickyMessages["Sticky Messages"]:::feature
            MemeSystem["Meme System"]:::feature
        end
        
        subgraph ManagementFeatures["Management Features"]
            ChannelMgmt["Channel Management"]:::feature
            RoleMgmt["Role Management"]:::feature
            ModSystem["Moderation System"]:::feature
        end
        
        subgraph Guards["Security Guards"]
            MessageGuard["Message Guard"]:::guard
            InviteLinkGuard["Invite Link Guard"]:::guard
        end
    end

    %% Data Layer
    subgraph DataLayer["Data Layer"]
        DB[(Database)]:::storage
        
        subgraph InMemoryStores["In-Memory Stores"]
            ChannelStore["Channel Store"]:::storage
            VotingStore["Voting Store"]:::storage
            StickyStore["Sticky Store"]:::storage
        end
    end

    %% Relationships
    DiscordAPI <--> Client
    Client --> EventSystem
    EventSystem --> CommandHandler
    EventSystem --> MessageFeatures
    EventSystem --> ManagementFeatures
    MessageFeatures --> Guards
    ManagementFeatures --> Guards
    Guards --> DB
    MessageFeatures --> InMemoryStores
    ManagementFeatures --> InMemoryStores
    CommandHandler --> MessageFeatures
    CommandHandler --> ManagementFeatures
    EnvConfig -.-> ServiceLayer

    %% Styling
    classDef service fill:#90EE90
    classDef feature fill:#FFE4B5
    classDef storage fill:#DDA0DD
    classDef guard fill:#FF6B6B

    %% Click Events
    click Client "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/services/client.ts"
    click EventSystem "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/tree/main/src/listeners/"
    click EnvConfig "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/services/env.ts"
    click CommandHandler "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/tree/main/src/slash_command/"
    click MessageRecording "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/tasks/messages/record_msg.ts"
    click ChannelMgmt "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/tasks/channels/channel.ts"
    click ModSystem "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/tasks/guards/message_guard.ts"
    click RoleMgmt "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/tasks/role/subscribe.ts"
    click StickyMessages "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/tasks/sticky/index.ts"
    click MemeSystem "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/slash_command/meme_command.ts"
    click DB "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/services/database.ts"
    click ChannelStore "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/services/channel_store.ts"
    click VotingStore "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/services/voting_store.ts"
    click StickyStore "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/services/sticky_store.ts"
    click MessageGuard "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/tasks/guards/message_guard.ts"
    click InviteLinkGuard "https://github.com/FizzyElt/discord-message-record-bot-effect-ts/blob/main/src/tasks/guards/invite_link_guard.ts"
```
