Mitglieder verwalten

Vollständige Anleitung zum Einladen, Verwalten und Entfernen von Teammitgliedern in CodeCourier-Projekten, einschließlich des Einladungsablaufs und Bulk-Operationen.

6 min Lesezeit

membersinviteteam

Die Seite Mitglieder ist Ihre zentrale Anlaufstelle, um zu verwalten, wer Zugriff auf ein Projekt hat. Von hier aus können Sie neue Teammitglieder einladen, deren Rollen und Status überprüfen, Berechtigungen ändern und bei Bedarf Mitglieder entfernen. Nur Nutzer mit der Rolle Eigentümer oder Admin können die Projektmitgliedschaft verwalten.

Mitgliederliste anzeigen

Navigieren Sie über die Seitenleiste unter der Gruppe Insights zur Seite Mitglieder. Die Seite zeigt eine Tabelle mit allen aktuellen Mitgliedern und ausstehenden Einladungen, sortiert nach Eigentümern zuerst, dann Admins, dann Mitgliedern, wobei ausstehende Einladungen unten gruppiert werden. Für jedes Mitglied zeigt die Tabelle:

Name - Der Anzeigename des Mitglieds mit seinem Avatar. Fahren Sie mit der Maus darüber, um zusätzliche Profildetails zu sehen sowie wer es eingeladen hat.
E-Mail - Die mit dem Konto verknüpfte E-Mail-Adresse
Rolle - Farblich codiertes Badge, das Eigentümer (bernstein), Admin (blau) oder Mitglied (grau) anzeigt
Status - Entweder "Angenommen" (grün) oder "Ausstehend" (orange mit Uhrsymbol)
Beigetreten - Das Datum, an dem das Mitglied dem Projekt beigetreten ist (zeigt "--" für ausstehende Einladungen)
Aktionen - Dropdown-Menü mit Optionen zur Rollenverwaltung und Entfernung (nur Admin/Eigentümer)

Teammitglieder einladen

Einladungsdialog öffnen

Klicken Sie auf die Schaltfläche Mitglied einladen in der Kopfzeile der Seite. Dies öffnet einen Dialog mit Feldern für die E-Mail des Eingeladenen und die Rollenzuweisung.

E-Mail-Adresse eingeben

Geben Sie die E-Mail-Adresse der Person ein, die Sie einladen möchten. Die E-Mail muss zu einem existierenden CodeCourier-Nutzerkonto gehören - das System sucht den Nutzer per E-Mail. Wird kein Konto gefunden, sehen Sie den Fehler "Kein Nutzer mit dieser E-Mail-Adresse gefunden". Die Person muss sich zuerst bei CodeCourier registrieren.

Rolle auswählen

Wählen Sie die Rolle für das neue Mitglied:

Admin - Kann Mitglieder verwalten, Einstellungen konfigurieren und alle Projektoperationen durchführen
Mitglied - Kann alle Projektfunktionen nutzen, aber keine Mitglieder oder kritischen Einstellungen verwalten

Beachten Sie, dass die Rolle Eigentümer bei der Einladung nicht zugewiesen werden kann. Nur der aktuelle Eigentümer kann die Eigentümerschaft über die Rollenverwaltung übertragen.

Einladung senden

Klicken Sie auf Einladung senden, um die Mitgliedschaft zu erstellen. Das System validiert die E-Mail, prüft, ob der Nutzer nicht bereits Mitglied ist, und erstellt einen ausstehenden Mitgliedschafts- Datensatz. Der Eingeladene sieht die Einladung in seinem Dashboard.

Einladungsfehler

Der Einladungsdialog zeigt spezifische Fehlermeldungen für häufige Probleme:

"Kein Nutzer mit dieser E-Mail-Adresse gefunden" - Die E-Mail ist nicht in CodeCourier registriert
"Nutzer ist bereits Mitglied oder hat eine ausstehende Einladung" - Eine Mitgliedschaft existiert bereits

Einladungen annehmen und ablehnen

Wenn Sie zu einem Projekt eingeladen werden, erscheint die Einladung in Ihrem Dashboard. Sie haben zwei Optionen:

Annehmen

Das Annehmen einer Einladung aktualisiert Ihren Mitgliedschaftsstatus von "ausstehend" auf "angenommen" und protokolliert den Zeitstempel der Annahme. Sie erhalten sofort Zugriff auf alle Projektressourcen gemäß Ihrer zugewiesenen Rolle.

Ablehnen

Das Ablehnen einer Einladung löscht den Mitgliedschaftsdatensatz endgültig. Der Projekt-Admin kann Sie bei Bedarf später erneut einladen. Das Ablehnen erzeugt keine Benachrichtigung für das Projekt- Team.

Sie können alle Ihre ausstehenden Einladungen über alle Projekte hinweg mit der AbfragelistPendingInvitations einsehen, die angereicherte Einladungsdetails zurückgibt, einschließlich des Projektnamens und des Namens der Person, die Sie eingeladen hat.

Bestehende Mitglieder verwalten

Rollen ändern

Nur Projekt-Eigentümer können Mitgliederrollen ändern. Wählen Sie im Aktionsmenü des Mitglieds Rolle ändern und wählen Sie die neue Rolle. Rollenänderungen werden sofort wirksam und in Echtzeit über alle verbundenen Clients hinweg übernommen.

Sicherheitsmaßnahmen bei Rollenänderungen:

Ein Eigentümer kann sich nicht selbst degradieren, wenn er der einzige Eigentümer ist. Zuerst muss ein weiterer Eigentümer zugewiesen werden.
Admins können sich nicht selbst zum Eigentümer befördern - nur bestehende Eigentümer können dies tun.
Rollenänderungen erfordern keine erneute Authentifizierung; die neuen Berechtigungen gelten sofort.

Mitglieder entfernen

Eigentümer und Admins können Mitglieder aus dem Projekt entfernen. Klicken Sie auf das Aktionsmenü des Mitglieds und wählen Sie Mitglied entfernen. Vor der Ausführung der Entfernung erscheint ein Bestätigungsdialog.

Sicherheitsmaßnahmen bei Entfernungen:

Der letzte verbleibende Eigentümer kann nicht entfernt werden. Übertragen Sie zuerst die Eigentümerschaft.
Nicht-Eigentümer können keine Eigentümer entfernen - nur andere Eigentümer können dies.
Das Entfernen eines Mitglieds löscht dessen Mitgliedschaftsdatensatz endgültig und reduziert den Mitgliederzähler des Projekts.

Ausstehende Einladungen abbrechen

Wurde eine Einladung versehentlich gesendet, können Eigentümer und Admins sie abbrechen, bevor der Eingeladene sie annimmt. Wählen Sie Einladung abbrechen aus dem Aktionsmenü des ausstehenden Mitglieds. Dies löscht den ausstehenden Mitgliedschaftsdatensatz endgültig.

Bulk-Operationen

Die Mitgliedertabelle unterstützt die Mehrfachauswahl über Checkboxen. Wählen Sie mehrere Mitglieder aus und nutzen Sie die Bulk-Aktionsleiste, um sie alle gleichzeitig zu entfernen. Die Bulk-Entfernung verarbeitet sowohl aktive Mitglieder als auch ausstehende Einladungen - bei ausstehenden Mitgliedern wird die Einladung abgebrochen, bei aktiven Mitgliedern wird deren Mitgliedschaft entfernt.

Unwiderrufliche Aktionen

Die Entfernung von Mitgliedern und das Abbrechen von Einladungen sind permanente Operationen. Es gibt kein Rückgängig oder Papierkorb-System für Mitgliedschaften. Der entfernte Nutzer müsste erneut eingeladen werden, um wieder Zugriff zu erhalten.

Kontextmenü-Unterstützung

Zusätzlich zum Dropdown-Aktionsmenü unterstützt die Mitgliedertabelle Kontextmenüs per Rechtsklick auf jede Zeile. Ein Rechtsklick auf ein Mitglied zeigt dieselben Optionen wie das Dropdown: Profil anzeigen, Rolle ändern und Mitglied entfernen (oder Einladung abbrechen für ausstehende Mitglieder). Dies bietet einen schnelleren Workflow für Power-User, die große Teams verwalten.

Programmatische Mitgliederverwaltung

Alle Operationen zur Mitgliederverwaltung sind über Convex-Mutationen verfügbar:

member-management.ts

import { api } from "@/convex/_generated/api";
import { useMutation, useQuery } from "convex/react";

// List all members
const members = useQuery(api.projectMembers.listByProject, { projectId });

// Invite by email
const addMember = useMutation(api.projectMembers.addMemberByEmail);
await addMember({ projectId, email: "user@example.com", role: "member" });

// Accept invitation
const accept = useMutation(api.projectMembers.acceptInvitation);
await accept({ projectId });

// Change role (owner only)
const updateRole = useMutation(api.projectMembers.updateRole);
await updateRole({ projectId, userId, role: "admin" });

// Remove member
const remove = useMutation(api.projectMembers.removeMember);
await remove({ projectId, userId });