🏗️ Architecture

System Architecture

┌─────────────────────────────────────────────────────────┐
│                    FiveM Client                         │
│  ┌──────────────────────────────────────────────────┐  │
│  │         React UI (NUI)                           │  │
│  │  - ChatContainer                                  │  │
│  │  - MessageList                                    │  │
│  │  - ChatInput                                      │  │
│  │  - AdminEditor                                    │  │
│  └──────────────────────────────────────────────────┘  │
│                    ↕ NUI Callbacks                      │
│  ┌──────────────────────────────────────────────────┐  │
│  │         Client Lua (main.lua)                    │  │
│  │  - Message handling                              │  │
│  │  - Command registration                           │  │
│  │  - Cooldown tracking                             │  │
│  └──────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────┘
                         ↕ Network Events
┌─────────────────────────────────────────────────────────┐
│                  FiveM Server                            │
│  ┌──────────────────────────────────────────────────┐  │
│  │         Server Lua (main.lua)                    │  │
│  │  - Message broadcasting                          │  │
│  │  - Proximity calculations                        │  │
│  │  - Permission checking                           │  │
│  │  - Discord API integration                       │  │
│  └──────────────────────────────────────────────────┘  │
│                    ↕ File I/O                           │
│  ┌──────────────────────────────────────────────────┐  │
│  │    Config Manager (config-manager.lua)           │  │
│  │  - JSON loading/saving                           │  │
│  │  - Hot-reload support                            │  │
│  │  - Validation                                    │  │
│  └──────────────────────────────────────────────────┘  │
│                    ↕ HTTP Requests                      │
│  ┌──────────────────────────────────────────────────┐  │
│  │         Discord API                              │  │
│  │  - Role fetching                                 │  │
│  │  - Avatar URLs                                   │  │
│  │  - Member data                                   │  │
│  └──────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────┘