Dashboard-Anleitung

1. Rollen und Zugriffsrechte

Die Rollen-IDs sind fest mit den Dashboard-Bereichen verknüpft. Die Rollen müssen auf eurem Discord-Server existieren und den Mitgliedern zugewiesen sein. Bereichsrollen erlauben die Verwaltung ihres jeweiligen Bereichs, ohne allgemeine Adminrechte zu vergeben.

Rollen in Discord einrichten

1. In Discord unter Benutzereinstellungen → Erweitert den Entwicklermodus einschalten.
2. Unter Servereinstellungen → Rollen die benötigten Rollen erstellen oder vorhandene Rollen verwenden.
3. Mit Rechtsklick auf eine Rolle Rollen-ID kopieren und kontrollieren, dass sie mit der oben angegebenen ID übereinstimmt.
4. Die Default-Rolle allen normalen Mitgliedern geben; sie erlaubt persönliche Aufstellungsantworten sowie Ideen und Clips. Bereichsrollen gezielt an die Personen vergeben, die den jeweiligen Bereich verwalten sollen. Die Admin-Rolle nur an vertrauenswürdige Administratoren vergeben.
5. Der Gang-System-Bot muss auf dem Discord-Server sein. Er gleicht Mitglieder- und Rollenänderungen automatisch ab; das Dashboard aktualisiert die Freigaben regelmäßig.

Wenn eine Rolle trotz richtiger ID noch nicht greift, im Dashboard-Bot den Guild-Sync abwarten oder mit einer Person mit Adminrechten einmal den Discord-Mitglieder-Sync starten.

2. Anmeldung und eigenes Profil

1. https://leebots.xyz öffnen und Mit Discord anmelden auswählen.
2. Beim ersten Öffnen des Guild-Dashboards die Telefonnummer eintragen. Das Formular muss einmal vollständig gespeichert werden, bevor der Workspace geöffnet wird.
3. Die Steam-ID64 kann dabei optional ergänzt oder später im Profil geändert werden. Das erwartete Format ist eine 17-stellige SteamID64, zum Beispiel 76561198000000000.
4. Über Profilwerte als Discord-Rollen anzeigen wird ausdrücklich entschieden, ob Telefon und Steam-ID in Discord-Rollennamen stehen dürfen.

Der graue Telefonnummer-Platzhalter (6) 723-7569 ist nur ein Formatbeispiel und keine vorgegebene Nummer. Die eigene Nummer wird pro Discord-Server im persönlichen Profil gespeichert. Das Profil lässt sich über den Benutzerbereich oben rechts oder die Schaltfläche Mein Profil bearbeiten in der Übersicht jederzeit selbst ändern.

Profilrollen und Synchronisierung

Mit aktivierter Rollendarstellung erstellt der Bot am unteren Ende der Discord-Rollenliste einen Trenner ──────── MITGLIEDERPROFILE ────────. Für das Mitglied folgen eine Rolle TELEFON · [Nummer] · [Discord-ID] und – falls eine Steam-ID eingetragen wurde – eine Rolle STEAM · [Steam-ID] · [Discord-ID]. Beide werden dem richtigen Discord-Mitglied zugewiesen. Profiländerungen benennen diese Rollen neu; beim Abwählen der Freigabe werden die persönlichen Rollen entfernt.

Nach dem Speichern zeigt das Profil den Status des Discord-Rollensyncs. „Synchronisierung läuft“ bedeutet, dass der Bot den Auftrag verarbeitet. Bei einem Fehler müssen Bot-Berechtigungen und Rollen-Hierarchie geprüft werden.

3. Die persönliche Übersicht

• Mein Mitgliedsstatus: zeigt ausschließlich die eigenen offenen Wochenabgaben und aktiven Sanktionen. Bereits gezahlte Teilbeträge und der verbleibende Betrag werden getrennt angezeigt. Ausgeschlossene Mitglieder erscheinen nicht in der Abgabenwarnung.
• Persönliche Aufgaben: zeigt Aufgaben, die dem eigenen Discord-Konto oder einer eigenen Rolle zugewiesen wurden.
• Musik-Icon rechts: klappt die Guild-Musik, Playlist-Steuerung und den Spotify-Player seitlich auf.
• Online-Icon rechts: klappt die synchronisierte Online-Mitgliederliste seitlich auf. Über „Alle Mitglieder anzeigen“ geht es – falls freigeschaltet – in den Mitgliederbereich.
• Roter Hinweis oben: kündigt die nächste Aufstellung gut sichtbar an. Der größere Aufstellungsbanner unten in der Übersicht führt ebenfalls zum Aufstellungsbereich, sofern die Rolle diesen Bereich freischaltet.

Die persönlichen Hinweise werden laufend mit den Dashboard-Daten aktualisiert. Rollenänderungen aus Discord werden vom Bot übernommen und anschließend im Dashboard nachgezogen.

4. Was die Rolleninhaber bearbeiten dürfen

Jede Bereichsrolle kann die Inhalte und Einstellungen ihres eigenen Bereichs verwalten, erhält aber keine Rechte für andere Bereiche oder die globalen Dashboard-Einstellungen. Nur die Admin-Rolle beziehungsweise Discord-Serverrechte „Server verwalten“/„Administrator“ erlauben eine globale Verwaltung. Persönliche Telefonnummer und Steam-ID kann jedes Mitglied ausschließlich im eigenen Profil ändern.

Die Member-Default-Rolle darf Aufstellungen ansehen und die eigene Antwort auf „Zusagen“ oder „Abmelden“ setzen. Außerdem können Mitglieder damit Ideen und Clips einreichen und abstimmen; sie können keine fremden Einträge verwalten oder löschen.

5. Fehlerbehebung

• Ein Bereich fehlt: prüfen, ob die passende Rolle dem richtigen Discord-Konto zugewiesen wurde; danach einige Sekunden warten. Die Rolle muss die exakte angegebene ID haben.
• Bereich ist sichtbar, aber nicht bearbeitbar: das ist für Bereichsrollen beabsichtigt. Für Verwaltungszugriff die Admin-Rolle vergeben.
• Profilrolle bleibt auf „Synchronisierung läuft“ oder schlägt fehl: Bot-Container und Discord-Berechtigung Rollen verwalten prüfen. Die höchste Bot-Rolle muss oberhalb der vom Bot erstellten Profilrollen stehen. Der Discord-Server darf sein Rollenlimit nicht erreicht haben.
• Telefonnummer wird nicht angenommen: nur Zahlen sowie +, Klammern, Leerzeichen, Punkt und Bindestrich verwenden; die Nummer muss mindestens sieben Zeichen enthalten.
• Steam-ID wird nicht angenommen: eine SteamID64 mit 17 Ziffern verwenden, die mit 7656119 beginnt.

Auf dem Server können die beiden betroffenen Dienste geprüft werden:

docker compose ps

docker compose logs --tail=100 app bot

Nach einem Update des Dashboards werden Web-App und Discord-Bot gemeinsam neu gebaut:

docker compose up -d --build app bot

Die Datenbank-Erweiterungen werden beim Start der Web-App automatisch über das vorhandene Schema eingespielt.

6. Discord-Mitglieder-Anleitung konfigurieren und posten

1. Im Dashboard den Bereich Einstellungen → Mitglieder-Anleitung öffnen. Dort den Zielkanal, Titel, Einleitung, Themenblöcke und Ping-Rollen festlegen.
2. Für das große Embed-Bild eine HTTPS-Bild-URL eintragen oder PNG, JPG, WEBP beziehungsweise ein animiertes GIF hochladen. Discord bindet es direkt in das Embed ein; die Vorschau im Dashboard zeigt den vorgesehenen Kartenaufbau.
3. Speichern übernimmt den Entwurf. Speichern & posten veröffentlicht die gespeicherte Fassung im ausgewählten Kanal.
4. Alternativ kann /dashboard-anleitung die gespeicherte Fassung erneut im konfigurierten Kanal posten. Ausführen darf den Command nur die Rolle 1556010467166654506.

Die ausgewählten Rollen werden in Discord oberhalb des Embeds erwähnt. Discord löst Rollen-Pings nicht aus, wenn sie nur im Embed-Text stehen. Die Ping-Rollen und die Zielgruppe sollten deshalb vor dem Posten geprüft werden.