feat: modernize monorepo, vitest test suite, nextjs 15 dashboard rewrite, lavalink v4, and cloud docs

.dockerignore

@@ -11,7 +11,7 @@ docker-compose.yaml
 .git
 .github
 .gitignore
-LICENSE
+LICENSE*
 README.md
 
 # Node Modules and lint settings

.env.example

@@ -1,34 +1,49 @@
 # DB URL
-DATABASE_URL="postgresql://john:doe@localhost:5432/master-bot?schema=public"
+DATABASE_URL="postgresql://postgres:postgres@localhost:5432/master-bot?schema=public"	                                    # Primary PostgreSQL database connection URL
+SHADOW_DB_URL="postgresql://postgres:postgres@localhost:5432/master-bot-shadow?schema=public"	                            # Dedicated shadow database for Prisma migrations
 
 # Bot Token
-DISCORD_TOKEN=""
+DISCORD_TOKEN=""	                                                                                                        # Discord bot token from the Developer Portal
 
-NEXTAUTH_SECRET="somesupersecrettwelvelengthword"
-NEXTAUTH_URL=
-NEXTAUTH_URL_INTERNAL=http://localhost:3000
-NEXT_PUBLIC_INVITE_URL="https://discord.com/api/oauth2/authorize?client_id=yourclientid&permissions=8&scope=bot"
+# NextAuth Configuration
+NEXTAUTH_SECRET="youshallnotpass"	                                                                                        # Random 32+ char secret for signing auth session tokens
+NEXTAUTH_URL=""	                                                                                                            # Canonical public dashboard URL (e.g. https://domain.com)
+NEXTAUTH_URL_INTERNAL="http://localhost:3000"	                                                                            # Internal SSR URL for local dashboard requests
+NEXT_PUBLIC_INVITE_URL="https://discord.com/api/oauth2/authorize?client_id=your_client_id&permissions=8&scope=bot"	        # Public OAuth2 bot invite link
 
 # Next Auth Discord Provider
-DISCORD_CLIENT_ID=""
-DISCORD_CLIENT_SECRET=""
+DISCORD_CLIENT_ID=""	                                                                                                    # Discord application client ID
+DISCORD_CLIENT_SECRET=""	                                                                                                # Discord application client secret
 
 # Lavalink
-LAVA_HOST="0.0.0.0"
-LAVA_PASS="youshallnotpass"
-LAVA_PORT=2333
-LAVA_SECURE=false
+LAVA_HOST="localhost"	                                                                                                    # Lavalink host (default: localhost or 0.0.0.0)
+LAVA_PASS="youshallnotpass"	                                                                                                # Lavalink password (must match application.yml)
+LAVA_PORT=2333	                                                                                                            # Lavalink WebSocket / HTTP port
+LAVA_SECURE=false	                                                                                                        # Enable SSL/WSS encryption (true / false)
+LAVA_EXTERNAL=false	                                                                                                        # Set to true to connect to an external Lavalink instance
+
+# YouTube & Remote Cipher
+YOUTUBE_REFRESH_TOKEN=""	                                                                                                # YouTube OAuth 2.0 refresh token (auto-saved to .youtube-oauth.json)
+YOUTUBE_API_KEY=""	                                                                                                        # Optional YouTube Data API v3 key
+YOUTUBE_CIPHER_URL="https://cipher.kikkia.dev/"	                                                                            # Remote cipher endpoint for YouTube signature deciphering
+YOUTUBE_CIPHER_PASSWORD=""	                                                                                                # Optional password for self-hosted yt-cipher (leave empty for default public endpoint)
 
 # Spotify
-SPOTIFY_CLIENT_ID=""
-SPOTIFY_CLIENT_SECRET=""
+SPOTIFY_CLIENT_ID=""	                                                                                                    # Spotify Developer App Client ID
+SPOTIFY_CLIENT_SECRET=""	                                                                                                # Spotify Developer App Client Secret
 
-# Twitch
-TWITCH_CLIENT_ID=""
-TWITCH_CLIENT_SECRET=""
+# Twitch & IGDB
+TWITCH_CLIENT_ID=""	                                                                                                        # Twitch Developer App Client ID (used for Twitch alerts & IGDB search)
+TWITCH_CLIENT_SECRET=""	                                                                                                    # Twitch Developer App Client Secret
 
 # Other APIs
-TENOR_API=""
-NEWS_API=""
-GENIUS_API=""
-RAWG_API=""
+KLIPY_API=""	                                                                                                            # API key for anime reactions and interactive GIFs
+NEWS_API=""	                                                                                                                # NewsAPI key for /world-news global headline searches
+GENIUS_API=""	                                                                                                            # Genius API client token for /lyrics song lyrics lookup
+
+# Feature Flags (Enable or disable specific bot modules dynamically)
+LAVA_ENABLED=true	                                                                                                        # Master toggle for Lavalink audio engine and music commands
+GIFS_ENABLED=true	                                                                                                        # Toggle for animated GIF and reaction commands
+TWITCH_ENABLED=true	                                                                                                        # Toggle for Twitch stream monitoring and notifications
+NEWS_ENABLED=true	                                                                                                        # Toggle for news headline commands
+IGDB_ENABLED=true	                                                                                                        # Toggle for IGDB game database lookups

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,67 @@
+name: Bug Report
+description: Create a report to help us improve Master-Bot
+title: '[Bug]: '
+labels: ['bug']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### Instructions
+        Please provide detailed information to help reproduce and fix the bug.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the Bug
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Use command `/...`
+        2. Pass argument `...`
+        3. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: A clear and concise description of what you expected to happen.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - Windows
+        - Linux (Ubuntu/Debian)
+        - macOS
+        - Docker
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: node-version
+    attributes:
+      label: Node.js Version
+      placeholder: "e.g., v20.11.0"
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context / Logs
+      description: Add any error logs, stack traces, or screenshots here.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/command_issue.yml

@@ -0,0 +1,55 @@
+name: Command Issue
+description: Report a problem with a specific slash command
+title: '[Command]: '
+labels: ['bug']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### Instructions
+        Describe the command that is not working as expected and what should happen instead.
+
+  - type: input
+    id: command
+    attributes:
+      label: Command
+      description: The slash command that has an issue.
+      placeholder: "/play"
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the Issue
+      description: What went wrong?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Run `/...`
+        2. Pass arguments `...`
+        3. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error Output / Logs
+      description: Paste any Discord error message or bot log output.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/dashboard_issue.yml

@@ -0,0 +1,62 @@
+name: Dashboard / Web Issue
+description: Report a problem with the web dashboard, authentication, or API
+title: '[Dashboard]: '
+labels: ['bug']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### Instructions
+        Describe the web dashboard, authentication, or API issue you encountered.
+
+  - type: input
+    id: url
+    attributes:
+      label: Page / Route
+      description: The dashboard page or API route affected.
+      placeholder: "e.g., /dashboard/[server_id]/welcome-message"
+    validations:
+      required: false
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the Issue
+      description: What happened? Include any error messages.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Navigate to ...
+        2. Click ...
+        3. See error
+    validations:
+      required: true
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Authentication / Sign-In
+        - Server Settings
+        - Welcome Message Editor
+        - Ticket Panel
+        - Log Viewer
+        - Commands Panel
+        - Other
+    validations:
+      required: false
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Browser / Server Console
+      description: Paste any console errors or dashboard log output.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,21 @@
+name: Feature Request
+description: Suggest an idea or new feature for Master-Bot
+title: '[Feature]: '
+labels: ['enhancement']
+body:
+  - type: textarea
+    id: feature-description
+    attributes:
+      label: Feature Description
+      description: Explain your suggestion or proposed feature in detail.
+      placeholder: Describe what feature you would like to see and why.
+    validations:
+      required: true
+
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case / Problem Statement
+      description: Is your feature request related to a problem or specific workflow?
+    validations:
+      required: false