Tavora

Leitfaden

Mitglieder

Öffne das Profil eines Mitglieds und du hast alles: Stammdaten, Aktivität, interne Staff-Notizen, Sanktionen mit automatischer DM, Tags, Gruppenverwaltung. Rollenhierarchie überall durchgesetzt, Audit für jede Aktion.

1Mitgliederliste

Aus dem Hauptmenü der Community → Mitglieder siehst du die paginierte Liste aller Mitglieder mit Rollen-Badges, Rollenfilter, Tag-Filter und Fuzzy-Suche nach @username, Name oder ID.

Auswahl und schnelle Aktionen

Tippe auf die Nummer eines Mitglieds, um es in die Auswahl zu setzen (das Kästchen wird ✅). Oben erscheint der Button 📋 Anzeigen (N):

  • 1 Mitglied ausgewählt → öffnet sein vollständiges Profil.
  • 2 oder mehr ausgewählt → öffnet die Bulk-Ansicht: eine Bestätigung und die Aktion (Notiz, Sanktion, Anerkennung, Tag, Gruppen-Einladung, Rauswurf, Ban) wird auf alle gleichzeitig angewendet.

Bulk-Aktionen funktionieren auf Dutzenden oder Hunderten Mitgliedern gleichzeitig, mit automatischem Throttling für die Telegram-Rate-Limits. Keine Bot-Hänger, keine halbfertigen Operationen.

Mitgliederliste mit Auswahl, Anzeigen-(N)-Button, Rollen-+Tag-Filter und Suche
Mitgliederliste mit Auswahl, Anzeigen-(N)-Button, Rollen-+Tag-Filter und Suche

2Mitglieder-Profil

Wenn du ein einzelnes Mitglied ausgewählt hast und auf Anzeigen tippst, öffnet sich sein Profil-Hub: vollständige Identität, Beitrittsdatum, Gruppen der Community, Zähler für Anträge/Stimmen/Aufgaben. Von dort erreichst du 5 Unterseiten:

  • 📝 Interne Notizen — Staff-Memos mit Anhängen (Fotos, Videos, Dokumente). Vom Autor editierbar, nach Hierarchie löschbar, wichtigste Notiz oben anheften. Filter "Nur meine".
  • 🏷 Tags — farbige Labels (7 Farben + keine) mit optionalem Emoji (auch Premium). Bis zu 20 Tags pro Community, jedem zuweisbar.
  • 📜 Aktivität — Zeitleiste alles, was das Mitglied gemacht hat: erstellte Anträge, Stimmen, zugewiesene Aufgaben, Rollenwechsel. Filter nach Datum (24h / 7T / 30T / benutzerdef.) und Typ.
  • ⚠️ Sanktionen — siehe unten, eigene Sektion.
  • 📦 Gruppenverwaltung — siehe nächste Sektion.

Zwei direkte Aktionsbuttons im Profil: Rolle ändern (ändert die Rolle des Mitglieds) und Aus der Organisation bannen (endgültiger Ausschluss mit optionalem Grund und DM ans Mitglied). Zwei Varianten: nur aus der Organisation (bleibt in den verbundenen Telegram-Gruppen), oder aus der Organisation + Gruppen (auch aus den Chats geworfen).

Profil-Hub eines Mitglieds mit Zählern, Unterseiten und direkten Aktionen
Profil-Hub eines Mitglieds mit Zählern, Unterseiten und direkten Aktionen

3Gruppenverwaltung

Vom Profil → Gruppen verwalten öffnest du das vereinheitlichte Panel mit allen Gruppen der Community in zwei Sektionen:

  • Mitglied in N GruppenRauswerfen-Button für jede
  • Nicht Mitglied in M Gruppen — Mehrfachauswahl mit Checkboxen; Tipp auf Einladungen senden (N) erstellt einmalige Einladungslinks und schickt sie dem Mitglied per DM

Rauswurf: was technisch passiert

Tavora nutzt Soft-Kick: Ban + sofortiges Entbannen. Der Nutzer verliert Zugang zur Gruppe, kann aber mit einer neuen Einladung zurückkehren. Keine permanente Sperrliste der Telegram-User-ID.

Telegram-Fehler werden automatisch behandelt: Bot ohne Berechtigungen in der Gruppe, Target ist Admin/Owner (Telegram erlaubt das Rauswerfen von Admins nicht), Bot aus der Gruppe entfernt, Telegram-Rate-Limit, abgelaufene file_id. Spezifischer Toast für jeden Fall, keine Crashes, keine halbfertigen Operationen.

Für Multi-Gruppen-Rauswürfe führt der Bot die Operationen im Hintergrund mit Throttling aus (~0,5s zwischen Gruppen), um die Telegram-Limits zu respektieren. Du erhältst sofortiges Feedback und der Effekt verbreitet sich graduell — der Bot blockiert für niemanden.

Gruppen-verwalten-Panel mit Mitglied/Nicht-Mitglied-Sektionen und Einladen/Rauswerfen-Aktionen
Gruppen-verwalten-Panel mit Mitglied/Nicht-Mitglied-Sektionen und Einladen/Rauswerfen-Aktionen

4Sanktionen und Auto-Ban

Vom Profil → Sanktionen öffnest du die Sanktionsliste des Mitglieds (aktiv + archiviert). Hier erstellst du eine neue Sanktion mit Begründung (max. 1000 Zeichen, Formatierung und Premium-Emoji unterstützt).

Beim Speichern schickt der Bot eine DM ans Mitglied mit der vollständigen Begründung. Falls es den Bot blockiert hat oder nie /start gemacht hat, bekommst du einen Info-Toast: die Sanktion wird trotzdem gespeichert.

Auto-Ban-Schwelle

Aus den Community-Einstellungen kann der Founder eine Auto-Ban-Schwelle konfigurieren: bei N aktiven Sanktionen wird das Mitglied automatisch gebannt. Schnellwerte (2, 3, 5, 10) oder benutzerdefiniert. Jederzeit deaktivierbar.

Hierarchisches Löschen: der Founder kann jede Sanktion löschen, ein Admin die eigenen und die des Staffs darunter, Staff nur die eigenen. Gelöschte Sanktionen bleiben im Soft-Delete (wiederherstellbar) und werden im Audit-Log festgehalten.

Das Mitglied sieht seine eigenen aktiven Sanktionen über die Community-Home → Mein ProfilMeine Sanktionen. Es sieht nur Begründung, Autor und Datum — keine internen Staff-Notizen.

Sanktionsliste eines Mitglieds mit automatischer DM an den Empfänger
Sanktionsliste eines Mitglieds mit automatischer DM an den Empfänger

5Anerkennungen

Anerkennungen sind das Gegenstück zu Sanktionen: eine Art, demjenigen öffentlich Anerkennung zu zollen, der sich für die Organisation einsetzt.

So schreibst du eine

Aus dem Profil → 🌟 Anerkennungen öffnest du den Prompt und sendest eine Nachricht mit dem Text der Anerkennung. Fett, kursiv und Premium-Emoji werden unterstützt.

Was beim Mitglied passiert

Der Bot schickt dem Mitglied eine private Direktnachricht mit Titel, Text und Organisationsname, plus einen Button In meinem Profil ansehen, um die Liste der erhaltenen Anerkennungen zu öffnen. Die Anerkennung bleibt im Profil des Mitglieds sichtbar für jeden, der es öffnet.

Anerkennung im Profil des Mitglieds mit formatiertem Titel und Text
Anerkennung im Profil des Mitglieds mit formatiertem Titel und Text

6Akte löschen

Akte löschen löscht in einem Zug alle Notizen, Sanktionen, Tags, ausstehenden Einladungen und Anerkennungen des Mitglieds. Nützlich, wenn jemand bei null beginnt.

Nur Founder und Admin. Auch ein Staff-Mitglied mit Verwaltungsrechten kann diesen Button nicht nutzen — er ist Systemrollen vorbehalten.

Was NICHT gelöscht wird

  • 📜 Aktivitätsprotokoll — die Löschaktion selbst wird protokolliert, mit der Anzahl aller gelöschten Einträge.
  • 🚪 Beitritts-/Austrittsverlauf — Beitritts-, Austritts- und Bannereignisse der Organisation bleiben erhalten.
  • 👤 Identität des Mitglieds — die Person bleibt mit ihrer Rolle in der Organisation. Nur die «Disziplinarakte» wird geleert.

Vor der Anwendung siehst du eine Vorschau mit Zählern: «werden gelöscht: 12 Notizen, 3 Sanktionen, 5 Tags, 2 Einladungen». Erst nach ausdrücklicher Bestätigung läuft die Aktion.

7Organisations-Statistiken

Aus dem Management-Menü📊 Statistiken öffnest du das aggregierte Panel der Organisation. Ein Blick auf den allgemeinen Gesundheitszustand. Nur für Founder und Admin sichtbar.

Die 5 Bereiche des Panels

  • 👥 Membership — Gesamtmitglieder, Aufschlüsselung nach Rolle, Beitritte/Austritte/Banns der letzten 30 Tage.
  • ⚡ Engagement — wie viele unterschiedliche Personen in den letzten 7 und 30 Tagen etwas getan haben.
  • 🏆 Top-Beitragende — wer die meisten Anträge erstellt, die meisten Stimmen abgegeben, die meisten Aufgaben abgeschlossen hat in den letzten 30 Tagen.
  • ⚠️ Moderation — Gesamt-/aktive/archivierte Sanktionen, manuelle und durch Schwelle ausgelöste Auto-Banns.
  • 📈 Beteiligung — Prozentsatz angenommener Anträge und abgeschlossener Aufgaben.
Statistik-Panel der Organisation mit Membership, Engagement, Top-Beitragenden, Moderation, Beteiligung
Statistik-Panel der Organisation mit Membership, Engagement, Top-Beitragenden, Moderation, Beteiligung

8Beitritts-/Austrittsverlauf

Aus der Mitgliederliste📋 Beitritts-/Austrittsverlauf öffnest du das vollständige Tagebuch der Beitritte, Austritte und Banns (manuell, automatisch und legacy), die seit Bestehen der Organisation aufgetreten sind. Eine eigenständige chronologische Sicht, getrennt vom Protokoll der einzelnen Mitgliederakte.

Filter

  • Ereignistyp: Alle, 🟢 Beitritte, 🚪 Austritte, 👢 Rausgeworfen, 🚫 Gebannt, ⚙️ Auto-Bann.
  • Zeitraum: immer, 24 Stunden, 7 Tage, 30 Tage, oder benutzerdefinierter Bereich (in deiner Zeitzone interpretiert).

Was du zu jedem Ereignis siehst

  • Datum und Uhrzeit.
  • Beteiligtes Mitglied, mit Direktlink zu seinem Telegram-Profil.
  • Wer die Aktion ausgeführt hat („System" bei Auto-Banns und spontanen Beitritten).
  • Optionaler Grund.
  • Bann-Geltungsbereich (nur Organisation, oder Organisation + Gruppen).

9Mitglieder hinzufügen

Zwei Wege, neue Leute in die Organisation aufzunehmen.

  • Einladungslink — aus dem Hauptmenü → Einladen. Du teilst ihn wo du willst: wer ihn öffnet, tritt bei (oder landet in der Genehmigungs-Warteschlange, falls aktiv).
  • Befehl /add @user1 @user2 — aus einer verbundenen Gruppe (mit dem Bot als Admin): fügt der Organisation sofort die Mitglieder hinzu, die bereits in dieser Gruppe sind — auch mehrere auf einmal.

Einladungen per Link landen im Panel «Ausstehende Einladungen» des Mitgliederprofils: werden sie nicht innerhalb von 24 Stunden genutzt, wird der Link automatisch widerrufen. Der Befehl /add dagegen fügt sofort hinzu und erzeugt keine ausstehende Einladung.

Um bereits eingeschriebene Mitglieder zu bestimmten Telegram-Gruppen hinzuzufügen, siehe den Abschnitt Gruppenverwaltung: aus der Mitgliederliste kannst du N Personen auswählen, die Gruppen wählen, und der Bot sendet jeder einzeln die Einladungslinks privat.
Zwei Wege, Mitglieder in die Organisation aufzunehmen: Einladungslink und /add @username
Zwei Wege, Mitglieder in die Organisation aufzunehmen: Einladungslink und /add @username

10Beitrittsanfragen

Wenn die manuelle Genehmigung aktiv ist (Community-Einstellungen), kommen neue Nutzer mit dem Einladungslink nicht direkt rein, sondern landen in einer Schlange. Aus Verwaltung → Anfragen:

  • Annehmen einzelne Anfragen oder Ablehnen
  • Alle annehmen — ein einziger Button, um die Schlange auf einmal zu leeren

Auf dem Verwaltung-Button der Community-Home erscheint ein 📬N grünes Badge bei offenen Anfragen, und 🎟N bei nicht genutzten Gruppeneinladungen. Push-Erinnerungen alle 2 Stunden, falls die Schlange voll bleibt — in den Einstellungen stummschaltbar.

Offene Beitrittsanfragen mit Annehmen/Ablehnen-Aktionen
Offene Beitrittsanfragen mit Annehmen/Ablehnen-Aktionen

11Eigentum übertragen

Um die Community an ein anderes Mitglied zu übergeben: Verwaltung → Einstellungen → Eigentum übertragen. Gib die numerische ID des Empfängers ein (er kann sie über den Befehl /myid erhalten).

Der Empfänger muss die Übertragung im Bot annehmen, bevor das Eigentum wechselt. Du bleibst Founder, bis er annimmt. Lehnt er ab, läuft die Anfrage nach einigen Tagen ab.