🤖 Discord Bot

Modul-Planung: Was bleibt, was ändert sich, was kommt neu. V3 Chaos → V4 Clean Architecture.

🔴 Was in V3 schief lief

10 konkrete Probleme die wir in V4 lösen

Chaotisches Admin Panel

19 Discord-Tabellen, 7 ORPC Router, Seiten ohne klare Struktur. Man findet nichts. Commands, Levels, Giveaways, Polls — alles auf eigenen Seiten ohne Zusammenhang.

Redis Pub/Sub ohne Garantie

Commands gehen verloren wenn der Bot offline ist. Kein Retry, kein Acknowledgment. Fire-and-forget = Data Loss.

3 verschiedene Log-Tabellen

DiscordLog, DiscordActionLog, AuditLog — niemand weiß welche man checken soll. Duplikate überall.

Kein Real-Time im Panel

Bot sendet Nachricht → Panel zeigt es erst nach Reload. Kein WebSocket, kein SSE. Sync nur manuell.

Settings als Key-Value Store

DiscordBotSetting ist ein Anti-Pattern. Keine Typsicherheit, kein Schema, kein Default-Handling.

Keine Rate Limiting

Discord API Calls ohne Throttling. Bot kann gebannt werden wenn zu viele Requests kommen.

Sync-Logik überall verstreut

roleSync, memberSync, channelSync — 3 separate Services mit duplizierten Patterns. Fehleranfällig.

Keine Tests

0 Tests für den gesamten Discord Bot. Jede Änderung = manuelles Testen.

🟢 V4 Architektur

Clean, typed, testbar

BullMQ statt Pub/Sub

Zuverlässige Job Queue mit Retry, Acknowledgment, Dead Letter Queue. Commands gehen nie verloren.

1 Log-System

Ein einheitliches activityLog mit Type-Enum. Alles an einem Ort, filterbar, durchsuchbar.

WebSocket Real-Time

Bot Events → Redis → WS Events Service → Panel. Live-Updates für Member Joins, Messages, Voice.

Typed Settings als JSON Column

Ein discordGuild Table mit typed JSON settings Column. Arktype validiert, Defaults eingebaut.

Communication Flow

Admin Panel
ORPC Call
→
Media API
Validates + Persists
→
BullMQ
Reliable Queue
→
Discord Bot
Executes + ACK
→
Redis Pub/Sub
Event Broadcast
→
WS Events
Push to Panel
📦 Features

Priorisiert: Must Have → Should Have → Could Have

🔗 Guild Management

  • Guild Registration + Settings
  • Role Sync + Permission Mapping
  • Member Sync + Linking zu App Users
  • Channel Sync
Must Have

⚡ Custom Commands

  • Slash Commands CRUD
  • Response Builder (Text + Embed)
  • Permission Checks
  • Cooldowns
  • Usage Statistics
Must Have

📊 Level System

  • XP pro Nachricht (configurable)
  • Level-Up Rewards (Rollen)
  • Leaderboard
  • XP Multiplier pro Channel/Rolle
  • Anti-Spam Cooldown
Must Have

🎁 Giveaways

  • Erstellen + Verwalten
  • Requirements (Level, Rolle, etc)
  • Auto-Draw bei Ablauf
  • Reroll Funktion
Should Have

📋 Polls

  • Multi-Option Voting
  • Anonym / Offen
  • Auto-Close bei Ablauf
  • Live Ergebnisse
Should Have

🏷 Reaction Roles

  • Emoji → Rolle Mapping
  • Toggle / Add / Remove Modi
  • Multi-Message Support
Should Have

📅 Scheduled Messages

  • Cron-basiert
  • Embed Templates
  • Timezone Support
  • Test-Senden
Should Have

📝 Activity Logging

  • Message Tracking (Create/Edit/Delete)
  • Voice Session Tracking
  • Member Join/Leave Log
  • Moderation Log
Must Have

🛡 Auto-Moderation

  • Banned Words Filter
  • Link Filter
  • Spam Detection
  • Configurable Actions (Warn/Mute/Kick/Ban)
Could Have
🖥 Admin Panel — Mockup

So sollte die Discord-Verwaltung aussehen. Klare Gruppen, alles erreichbar.

codenull.de/admin/discord
Discord
📊 Dashboard
⚙️ Settings
Community
👥 Members
🏷 Roles
📊 Levels
🏷 Reaction Roles
Engagement
⚡ Commands
🎁 Giveaways
📋 Polls
📅 Scheduled
Monitoring
📝 Activity Log
🛡 Moderation

Discord Dashboard

Überblick über den Server und Bot-Status

1,247
Members
89
Online
342
Messages Today
12
Voice Active

Custom Commands

CommandResponseCooldownUsesStatus
/shopEmbed: Shop Link5s1,892Active
/rankLevel + XP Embed10s4,231Active
/clipLast Clip Link30s567Active
/donateDonation Page5s234Disabled
🗄 Datenmodell — V3 → V4

Von 19 Tabellen auf 10. Weniger Chaos, bessere Relationen.

V3 (19 Tabellen)V4 (10 Tabellen)Änderung
DiscordBotSetting (key-value)→ discordGuild.settings (typed JSON)Eliminiert
DiscordLog + DiscordActionLog→ activityLog (unified)Zusammengeführt
DiscordMemberdiscordMember (+ linkedUserId)Behalten
DiscordRole + DiscordMemberRolediscordRole + discordMemberRoleBehalten
DiscordCommand + DiscordCommandStats→ discordCommand (stats eingebaut)Zusammengeführt
DiscordUserLevel + DiscordLevelSettingsdiscordUserLevel + discordGuild.levelSettingsSettings → Guild
DiscordGiveawaydiscordGiveawayBehalten
DiscordPolldiscordPollBehalten
DiscordReactionRolediscordReactionRoleBehalten
DiscordScheduledMessage + DiscordEmbedTemplate→ discordScheduledMessage (templates inline)Zusammengeführt
DiscordMessagediscordMessageBehalten
DiscordVoiceSessiondiscordVoiceSessionBehalten
DiscordVote—Entfernt (Polls reichen)
DiscordRolePermissionMapping→ discordGuild.rolePermissions (JSON)Vereinfacht
📋 Schema Preview (Drizzle)
// ─── Core ──────────────────────────────────────── discordGuild id text PK // Discord Guild ID name text icon text? settings jsonb // { features, logChannels, blacklistChannels, levelSettings, ... } rolePermissions jsonb // { discordRoleId: ["ADMIN", "SHOP_MANAGE", ...] } botJoinedAt timestamp updatedAt timestamp discordMember id text PK guildId text FK → discordGuild userId text // Discord User ID linkedUserId text? FK → user // Better-Auth User (nullable) username text nickname text? avatar text? joinedAt timestamp status enum // ACTIVE, LEFT, BANNED, KICKED messageCount integer // denormalized counter voiceMinutes integer // denormalized counter discordRole id text PK // Discord Role ID guildId text FK → discordGuild name text color integer position integer permissions text // Discord permission bitfield // ─── Features ──────────────────────────────────── discordCommand id text PK guildId text FK → discordGuild name text description text response jsonb // { type: "text"|"embed", content, embed } permissions text[] cooldown integer // seconds isEnabled boolean usageCount integer // stats built-in (was separate table) lastUsedAt timestamp? discordUserLevel id text PK guildId text FK → discordGuild userId text xp integer level integer messages integer lastMessageAt timestamp discordGiveaway // same as v3, cleaned up discordPoll // same as v3, cleaned up discordReactionRole // same as v3 discordScheduledMessage // merged with EmbedTemplate // ─── Tracking ──────────────────────────────────── discordMessage // message create/edit/delete tracking discordVoiceSession // voice join/leave/mute tracking
✅ Entscheidungen

Geklärt am 2026-03-18

1. Single-Guild

Kein Multi-Server Support. Ein Discord Server = eine Codenull Instanz. Vereinfacht Datenmodell erheblich — guildId wird trotzdem gespeichert (für Future-Proofing), aber kein Multi-Tenant Logic nötig.

2. Discord Member = Codenull User

Jeder Discord Member wird automatisch als Codenull User angelegt. Discord OAuth ist primäre Auth. Kein separater Registration-Flow. discordMember.linkedUserId wird beim Join automatisch gesetzt.

3. Visueller Embed Builder

WYSIWYG Editor im Admin Panel zum Bauen von Discord Embeds. Live-Preview neben dem Editor. Farbe, Felder, Footer, Thumbnail, Image — alles per Drag'n'Drop. Templates speicherbar.

4. Kein Custom AutoMod

Discord's eingebaute AutoMod Features reichen aus. Wir bauen KEINE eigene Spam-Detection, Link-Filter oder Banned-Words. Spart erheblich Entwicklungszeit.

5. Alle Messages loggen

Vollständiges Message Tracking — Create, Edit, Delete. Keine Privacy-Einschränkungen. Retention Policy kann später ergänzt werden wenn nötig.

6. Feste + Custom Commands

Eingebaute Commands: /rank, /shop, /clip, /donate, /leaderboard. Diese sind nicht löschbar aber konfigurierbar (Response, Cooldown, Permissions). Plus unbegrenzt Custom Commands.

Codenull Platform · Discord Bot Module Planning · 2026-03-18