Home DE

PDC Redbot Webapp — Wiki

🌐 English · Deutsch

Ein modernes, modulares und sicheres Web-Dashboard (Frontend + BFF) für den PDC Red-DiscordBot. Es ist das Gegenstück zum Companion-Cog pdc_webdashboard und kommuniziert mit dem Bot über ein token-gesichertes JSON-RPC-Gateway.

Stack: SvelteKit · TypeScript · TailwindCSS · adapter-node · Chart.js Auth: Discord OAuth2 (serverseitig / BFF) · signierte Cookie-Sessions Sprachen: Deutsch & Englisch (vollständig übersetzte UI, Umschalter oben rechts)

---

Schnellstart

git clone https://github.com/pd-codes/PDC_Redbot_Webapp.git
cd PDC_Redbot_Webapp
cp .env.example .env      # Werte eintragen
npm install
npm run dev               # http://localhost:5173

Schritt für Schritt: Erste Schritte → Konfiguration.

---

Benutzer-Dokumentation

Seite	Inhalt
Erste Schritte	Clone, .env, Discord-OAuth2-App, Gateway-Token, erster Login
Konfiguration	Jede .env-Variable und ihre Bedeutung
Authentifizierung	OAuth2-Flow, Sessions, Berechtigungsstufen, Sicherheitsmodell
Web-UI	Rundgang durch alle Seiten des Dashboards
Feature-Katalog	/features-Modul-Raster + Schritt-für-Schritt-Einrichtungs-Assistent
Embed-Builder	/embeds visueller Builder, Live-Vorschau, Entwürfe, JSON-Import/-Export
Öffentliche Seiten	/public/<guildId> — Server-Schaufenster ohne Login
Cog-Verwaltung	Laden/Entladen/Neu laden, Downloader, Slash, globale Panels
Statistiken	Die Analyse-Seite /stats (benötigt pdc_webdashboard_stats)
Custom Pages	Markdown-Seiten, öffentlich/privat
Deployment	systemd, Docker, nginx-Reverse-Proxy, Stolpersteine
Self-Update	Web-App per Panel aus GitHub aktualisieren

Entwickler-Dokumentation

Seite	Inhalt
Architektur	Stack, BFF-Muster, RPC-Gateway, Request-Ablauf
Cog-Integration	Wie ein Cog Widgets, Panels und Listen bereitstellt
API & Gateway	JSON-RPC-Methoden, Auth, Berechtigungsstufen

---

Wie alles zusammenspielt

Browser ──(OAuth2-Login)──▶ SvelteKit-BFF ──(JSON-RPC + Token)──▶ pdc_webdashboard-Cog ──▶ Red-DiscordBot
                                  │                                       │
                             Session-Cookie                       pdc_webdashboard_stats, deine Cogs …

Der Browser spricht nie direkt mit dem Bot — alle Secrets liegen serverseitig im BFF, und das Gateway akzeptiert nur localhost + Token. Siehe Authentifizierung.

---

Links

• WebApp-Repo: https://github.com/pd-codes/PDC_Redbot_Webapp
• Cogs-Repo: https://github.com/pd-codes/PDC_Redbot_Cogs
• Red-DiscordBot: https://github.com/Cog-Creators/Red-DiscordBot