Vorschläge (Suggestions)

Das Suggestions-Modul bietet ein System zum Einreichen von Vorschlägen durch die Community, mit Abstimmung (👍/👎), Approve/Reject-Buttons und optionalen Diskussionsthreads.

Modul aktivieren

1. Dashboard → Ihr Server → Toggle Suggestions
2. Klicken Sie auf Edit und konfigurieren Sie den Vorschlagskanal
3. Speichern Sie die Änderungen

Konfiguration

Option	Typ	Standard	Beschreibung
channel_id	string	—	Kanal, in den Vorschläge gesendet werden (erforderlich)
color_pending	hex	#3B82F6	Embed-Farbe eines ausstehenden Vorschlags
color_approved	hex	#22C55E	Farbe nach Genehmigung
color_rejected	hex	#EF4444	Farbe nach Ablehnung
create_thread	boolean	false	Diskussionsthread unter dem Vorschlag erstellen
anonymous	boolean	false	Autor des Vorschlags verbergen
manage_permission	string	"moderation_roles"	Wer approve/reject ausführen kann
manage_roles	Liste	[]	Verwaltungsrollen (wenn permission = "custom")
counter	number	0	Automatischer Vorschlagszähler

Dashboard — Konfiguration

Das Bearbeitungspanel enthält:

• Channel — Dropdown mit Textkanälen
• Colors — drei Color Picker (pending, approved, rejected)
• Create Thread — Checkbox
• Anonymous — Checkbox
• Manage Permission — Radio: "Moderation Roles" / "Custom Roles"
• Custom Roles — Multi-Select (sichtbar wenn "Custom" ausgewählt)

Befehle

/suggest

Reicht einen neuen Vorschlag ein.

Parameter	Erforderlich	Beschreibung
content	✅	Vorschlagsinhalt (max 2000 Zeichen)

Ablauf:

1. Bot inkrementiert den Vorschlagszähler
2. Erstellt ein Embed mit Titel "Suggestion #X", Inhalt und Status "⏳ Pending"
3. Sendet das Embed an den konfigurierten Kanal mit Approve/Reject-Buttons
4. Fügt die Reaktionen 👍 und 👎 zur Abstimmung hinzu
5. Erstellt optional einen Diskussionsthread
6. Sendet eine ephemerale Bestätigung an den Autor
7. Protokolliert die Erstellung

Approve / Reject

Berechtigte Benutzer (siehe manage_permission) können klicken:

• Approve ✅ — ändert die Farbe auf Grün, Status auf "Approved by [Name]"
• Reject ❌ — ändert die Farbe auf Rot, Status auf "Rejected by [Name]"

Nach Genehmigung/Ablehnung:

• Buttons werden aus der Nachricht entfernt
• Thread (falls vorhanden) wird archiviert und gesperrt
• Moderator erhält ephemerale Bestätigung
• Aktion wird protokolliert

Abstimmung

Die Reaktionen 👍 und 👎 dienen zur Meinungserhebung in der Community. Der Bot fügt sie automatisch hinzu, aber ihre Zählung ist nativ über Discord sichtbar — der Bot greift nicht in den Zähler ein.

Anonymer Modus

Wenn anonymous = true:

• Das Embed zeigt den Autor als "Anonymous" an
• In den Logs ist der Autor weiterhin sichtbar (für Rechenschaftspflicht)

Überwachte Ereignisse

Ereignis	Aktion
on_interaction	Verarbeitung von Approve/Reject-Button-Klicks

Persistent Views

Die Approve/Reject-Buttons verwenden custom_id (keinen Callback) — sie funktionieren auch nach einem Bot-Neustart.

Protokollierung

Aktionen werden durch Logs unter der Kategorie suggestions protokolliert:

• 💡 Suggestion Created — mit Nummer, Autor und Inhalt (auf 200 Zeichen gekürzt)
• ✅ Suggestion Approved — mit Nummer und Moderator
• ❌ Suggestion Rejected — mit Nummer und Moderator

Tipps

Best Practices

• Erstellen Sie einen dedizierten Kanal #suggestions mit eingeschränkten Schreibrechten (nur Bot)
• Aktivieren Sie create_thread, damit Diskussionen den Hauptkanal nicht überfüllen
• Setzen Sie manage_permission auf "moderation_roles", damit Moderatoren genehmigen/ablehnen können
• Der anonyme Modus fördert ehrliches Feedback, erschwert aber die Moderation

warnung

Der Vorschlagskanal muss konfiguriert sein — ohne ihn gibt der Befehl /suggest einen Fehler zurück. Das Dashboard lässt auch keine Konfiguration ohne ausgewählten Kanal speichern.