Organisation und Teams

Die Organisation ist der zentrale Arbeitsbereich in Almirant. Alle Projekte, Mitglieder, Integrationen und Konfigurationen gehören zu einer Organisation. Innerhalb der Organisation kannst du Teams verwalten, um die Arbeit detaillierter zu organisieren.

Was ist eine Organisation?

Eine Organisation in Almirant repräsentiert dein Unternehmen, Team oder deine Arbeitsgruppe. Sie ist der übergeordnete Container für:

• Projekte -- Alle erstellten Projekte gehören zu einer Organisation.
• Mitglieder -- Personen, die Zugriff auf die Organisation und ihre Projekte haben.
• Integrationen -- Verbindungen zu externen Diensten (GitHub, Vercel, Telegram).
• KI-Anbieter -- Die Konfiguration von Anbietern und Kontingenten für künstliche Intelligenz.
• API-Schlüssel -- Zugriffstoken für externe Integrationen und MCP.

Die Organisation konfigurieren

So greifst du auf die Konfiguration deiner Organisation zu:

1. Klicke im Seitenmenü auf den Namen deiner Organisation.
2. Wähle Einstellungen oder greife direkt über Einstellungen zu.

Organisationsdaten

Feld	Beschreibung	Erforderlich
Name	Name der Organisation, der auf der gesamten Plattform angezeigt wird	Ja
Logo	Repräsentatives Bild der Organisation	Nein
Slug	Eindeutige Kennung in der URL der Organisation	Ja

So aktualisierst du die Daten:

1. Gehe zu Einstellungen > Allgemein.
2. Ändere die gewünschten Felder.
3. Speichere die Änderungen.

Mitgliederverwaltung

Mitglieder sind Personen, die Zugriff auf die Organisation haben und an ihren Projekten arbeiten können.

Mitglieder einladen

1. Gehe zu Einstellungen > Mitglieder.
2. Klicke auf Mitglied einladen.
3. Gib die E-Mail-Adresse des neuen Mitglieds ein.
4. Wähle die Rolle aus, die das Mitglied in der Organisation haben wird.
5. Sende die Einladung.

Das Mitglied erhält eine E-Mail mit einem Link, um der Organisation beizutreten. Wenn es bereits ein Konto bei Almirant hat, wird es direkt hinzugefügt. Andernfalls muss es zuerst ein Konto erstellen.

Mitgliederrollen

Almirant definiert Rollen, um den Zugriff jedes Mitglieds zu steuern:

Rolle	Berechtigungen
Inhaber	Vollständige Kontrolle über die Organisation. Kann Mitglieder, Konfiguration, Abrechnung verwalten und die Organisation löschen
Administrator	Kann Mitglieder, Projekte, Integrationen und Konfiguration verwalten. Kann die Organisation nicht löschen
Mitglied	Kann an zugewiesenen Projekten arbeiten, Work Items erstellen und bearbeiten sowie KI-Planung und Agenten verwenden

Prinzip der geringsten Berechtigung

Weise die restriktivste Rolle zu, die es jedem Mitglied ermöglicht, seine Arbeit zu erledigen. Reserviere die Rolle Inhaber für 1-2 Personen und Administrator für Teamleitungen.

Aktive Mitglieder anzeigen

Die Mitgliederliste zeigt:

• Name und E-Mail-Adresse jedes Mitglieds.
• Zugewiesene Rolle.
• Beitrittsdatum.
• Einladungsstatus (ausstehend, angenommen).

Die Rolle eines Mitglieds ändern

1. Gehe zu Einstellungen > Mitglieder.
2. Suche das Mitglied in der Liste.
3. Klicke auf die Rollenauswahl.
4. Wähle die neue Rolle.
5. Bestätige die Änderung.

Ein Mitglied entfernen

1. Gehe zu Einstellungen > Mitglieder.
2. Suche das Mitglied in der Liste.
3. Klicke auf Entfernen oder das Löschsymbol.
4. Bestätige das Entfernen.

Warnung

Das Entfernen eines Mitglieds widerruft seinen Zugriff sofort. Dem Mitglied zugewiesene Work Items behalten die historische Zuweisung bei, das Mitglied erhält jedoch keine Benachrichtigungen mehr. Weise aktive Work Items neu zu, bevor du das Mitglied entfernst.

Teams

Teams ermöglichen es dir, Mitglieder innerhalb einer Organisation zu gruppieren, um die Arbeitszuweisung und Kommunikation zu erleichtern.

Ein Team erstellen

1. Gehe zu Einstellungen > Teams.
2. Klicke auf Team erstellen.
3. Lege einen Namen für das Team fest (zum Beispiel: "Frontend", "Backend", "QA").
4. Füge dem Team Mitglieder hinzu, indem du sie aus der Mitgliederliste der Organisation auswählst.
5. Speichere das Team.

Verwendung von Teams

Teams sind nützlich für:

• Schnelle Zuweisung -- Work Items einem gesamten Team statt einzelnen Mitgliedern zuweisen.
• Filterung -- Das Board nach Team filtern, um nur die Aufgaben einer bestimmten Gruppe anzuzeigen.
• Transparenz -- Schnell verstehen, wer zu welchem Funktionsbereich gehört.

Projekte zwischen Organisationen übertragen

Wenn du Zugriff auf mehrere Organisationen hast, kannst du Projekte von einer Organisation in eine andere übertragen. Weitere Details findest du im Abschnitt zur Projektübertragung.

Für Entwickler

MCP-Tools

Die folgenden Tools sind über MCP zur Verwaltung von Mitgliedern verfügbar:

Tool	Beschreibung	Hauptparameter
list_members	Listet die Mitglieder der Organisation auf	organizationId

Beispiel: Mitglieder auflisten

Tool: list_members
Parametros:
  organizationId: "uuid-de-la-organizacion"

Gibt die Liste der Mitglieder mit Name, E-Mail-Adresse, Rolle und Status zurück.

Anwendungsrouten

Route	Beschreibung
/settings	Allgemeine Konfiguration der Organisation
/settings/members	Mitgliederverwaltung
/settings/teams	Teamverwaltung