# konnokai/discord-stream-notify-bot architecture

> Architecture diagram of the GitHub repository konnokai/discord-stream-notify-bot, 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/konnokai/discord-stream-notify-bot
- Repository: https://github.com/konnokai/discord-stream-notify-bot

## Overview

##### Project Type and Purpose
This is a Discord bot application designed to notify users about streaming activities from various platforms (YouTube, Twitch, Twitter Spaces, TwitCasting). It's a complex integration system that monitors multiple streaming platforms and notifies Discord users.

##### Main Components

A. Core Components:
- Discord Bot Interface (Command & Interaction Handlers)
- Database System (Multiple DbContexts)
- Redis Cache Server
- Authentication System

B. Platform Integration Services:
- YouTube Integration
- Twitch Integration
- Twitter Spaces Integration
- TwitCasting Integration

C. External Dependencies:
- Redis Server
- OAuth Services (Discord & Google)
- External APIs (YouTube, Twitch, Twitter, TwitCasting)
- Uptime Kuma Monitoring

**┌─ External Services Layer ─────────────────────┐**
- YouTube API │ Twitch API │ Twitter │ TwitCasting│
- ┘
- ↕ (API Calls)
**┌─ Service Layer ────────────────────────────────┐**
- SharedServices                                 │
- YoutubeStreamService                        │
- TwitchService                               │
- TwitterSpacesService                        │
- TwitCastingService                          │
- ┘
- ↕ (Internal Communication)
**┌─ Core Bot Layer ─────────────────────────────┐**
- Command Handler │ Interaction Handler         │
- ┘
- ↕ (Data Access)
**┌─ Data Layer ───────────────────────────────────┐**
- Database Contexts │ Redis Cache │ Token Storage │
- ┘

##### Key Relationships to Highlight
- Command flow from Discord to the bot's handlers
- Data flow between services and external APIs
- Cache interaction patterns
- Database access patterns
- Authentication flows

##### Implementation Details

- Separation between command/interaction handling
- Multiple database contexts for different types of content
- Redis caching layer for performance
- External service integration points
- Authentication and token management

##### Additional Notes

- Relationship between the bot and the required [Youtube Stream Record] external service
- OAuth flow for YouTube membership verification
- Monitoring connection to Uptime Kuma
- WebHook notification system for Discord channels

Remember to maintain a balance between showing the complexity of the system while keeping it readable and understandable. Use clear labels and group related components together.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph External["External Services Layer"]
        DiscordAPI["Discord API"]:::external
        YoutubeAPI["YouTube API"]:::external
        TwitchAPI["Twitch API"]:::external
        TwitterAPI["Twitter API"]:::external
        TwitcastAPI["TwitCasting API"]:::external
        OAuthServices["OAuth Services"]:::external
    end

    subgraph Integration["API Integration Layer"]
        DiscordWebhook["Discord Webhook Client"]:::integration
        click DiscordWebhook "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/HttpClients/DiscordWebhookClient.cs"
        TwitcastClient["Twitcasting Client"]:::integration
        click TwitcastClient "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/HttpClients/TwitCasting/TwitcastingClient.cs"
        TwitterClient["Twitter Client"]:::integration
        click TwitterClient "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/HttpClients/Twitter/TwitterClient.cs"
        
        subgraph StreamServices["Stream Services"]
            YTService["YouTube Stream Service"]:::service
            click YTService "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/SharedService/Youtube/YoutubeStreamService.cs"
            TwitchService["Twitch Service"]:::service
            click TwitchService "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/SharedService/Twitch/TwitchService.cs"
            TwitterService["Twitter Spaces Service"]:::service
            click TwitterService "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/SharedService/Twitter/TwitterSpacesService.cs"
            TwitcastService["TwitCasting Service"]:::service
            click TwitcastService "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/SharedService/TwitCasting/TwitCastingService.cs"
        end
    end

    subgraph Core["Core Application Layer"]
        BotCore["Core Bot Service"]:::core
        click BotCore "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/Program.cs"
        
        subgraph Handlers["Command & Interaction Handlers"]
            CmdHandler["Command Handler"]:::handler
            click CmdHandler "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/Command/CommandHandler.cs"
            IntHandler["Interaction Handler"]:::handler
            click IntHandler "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/Command/InteractionHandler.cs"
        end

        subgraph Features["Feature Modules"]
            AdminCmd["Admin Commands"]:::feature
            click AdminCmd "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/Command/Admin/Administration.cs"
            HelpSystem["Help System"]:::feature
            click HelpSystem "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/Command/Help/Help.cs"
            MemberVerify["Member Verification"]:::feature
            click MemberVerify "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/SharedService/YoutubeMember/YoutubeMemberService.cs"
            StreamNotify["Stream Notifications"]:::feature
            click StreamNotify "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/SharedService/Youtube/ReminderAction.cs"
        end

        subgraph Security["Security Components"]
            TokenCrypto["Token Crypto"]:::security
            click TokenCrypto "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/Auth/TokenCrypto.cs"
            TokenMgr["Token Manager"]:::security
            click TokenMgr "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/Auth/TokenManager.cs"
        end

        Monitoring["Uptime Monitoring"]:::monitoring
        click Monitoring "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/UptimeKumaClient.cs"
    end

    subgraph Storage["Data Storage Layer"]
        Redis["Redis Cache"]:::cache
        click Redis "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/RedisConnection.cs"
        
        subgraph DB["Database Contexts"]
            MainDB["Main Database"]:::database
            click MainDB "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/DataBase/MainDbContext.cs"
            HoloDB["Holo Video DB"]:::database
            click HoloDB "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/DataBase/HoloVideoContext.cs"
            NijiDB["Nijisanji Video DB"]:::database
            click NijiDB "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/DataBase/NijisanjiVideoContext.cs"
            TwitchDB["Twitch Stream DB"]:::database
            click TwitchDB "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/DataBase/TwitchStreamContext.cs"
            TwitcastDB["Twitcasting Stream DB"]:::database
            click TwitcastDB "https://github.com/konnokai/Discord-Stream-Notify-Bot/blob/master/Discord Stream Notify Bot/DataBase/TwitcastingStreamContext.cs"
        end
    end

    %% Connections
    External --> Integration
    Integration --> Core
    Core --> Storage
    
    %% Specific Connections
    BotCore --> Handlers
    BotCore --> Features
    StreamServices --> StreamNotify
    Security --> BotCore

    %% Styles
    classDef external fill:#90EE90
    classDef integration fill:#ADD8E6
    classDef service fill:#87CEEB
    classDef core fill:#4169E1
    classDef handler fill:#FFA500
    classDef feature fill:#DDA0DD
    classDef security fill:#FF6B6B
    classDef monitoring fill:#98FB98
    classDef cache fill:#FFD700
    classDef database fill:#F0E68C
```
