Teams im Personalbereich

Nutzen Sie diese Seite, wenn Sie Teams als beschreibende Personalstruktur pflegen möchten. Nach dem Lesen wissen Sie, wann Sie Personal > Teams verwenden, wann reports_to maßgeblich bleibt und wie Sie Teams sicher per UI oder über veröffentlichte Ressourcen prüfen.

Staff Teams sind Administrationsdaten. Mitarbeiter arbeiten weiterhin im Profil; Teamleitungen für Arbeitszeit und Urlaub arbeiten über direkte Reports und die Team-Zeiterfassung.

Schnelle Entscheidung

Aufgabe	Richtige Stelle	Warum
Team mit Parent-Team, Beschreibung, Tags und Mitgliedern dokumentieren	`Personal > Teams`	Beschreibt die Personalstruktur ohne Prozesswirkung.
Führungskraft für Arbeitszeit oder Urlaub setzen	Mitarbeiterdatensatz, Tab `Reporting`, Relation `reports_to`	Team-Zeiterfassung und Genehmigungen folgen direkten Reports.
Benutzerrechte vergeben	IAM, Rollen und AccessGroups	Staff-Team-Rollen erzeugen keine Scopes. AccessGroups zeigen die verknüpfte Mandantenrolle in Liste und Auswahl.
Beschäftigungsabteilung pflegen	Beschäftigungsbezug oder HR-Klassifikation	Abteilungen bleiben HR-/Beschäftigungsdaten.
Organisation oder Mandantenstruktur pflegen	Organisations-/Tenant-Struktur	Staff Teams ersetzen keine Organisationseinheiten.
Kostenstelle oder Projekt pflegen	Accounting, Kostenstellen oder Projektstruktur	Staff Teams sind keine Finanzdimension.

Team anlegen

Öffnen Sie Personal > Teams.
Legen Sie ein Team mit Name und optionalem Key an.
Ergänzen Sie bei Bedarf Parent-Team, Beschreibung, Tags, Aktiv-Status, Sortierung und Labels.
Öffnen Sie das Teamdetail.
Prüfen Sie, ob Parent-Team und Aktiv-Status im Detail korrekt erscheinen.

Die Aufgabe ist abgeschlossen, wenn das Team in der Liste erscheint, im Detail geöffnet werden kann und die erwartete Parent-Zuordnung sichtbar ist.

Mitglieder pflegen

Öffnen Sie ein Team.
Wechseln Sie in den Tab Mitglieder.
Fügen Sie eine Mitarbeiterperson hinzu.
Wählen Sie member, lead oder deputy als fachliche Teamrolle.
Pflegen Sie optional Gültigkeit, Primärteam, Sortierung und Notiz.
Speichern Sie den Eintrag und prüfen Sie ihn im Mitglieder-Tab.

Workspace akzeptiert nur Mitarbeiterpersonen. Ein Teammitglied ändert keine Person, kein Benutzerkonto, keine Beschäftigung, keine AccessGroup und keinen Genehmigungsweg.

Regeln und Validierung

Workspace schützt diese fachlichen Regeln:

Parent-Teams dürfen keine Zyklen erzeugen.
Ein Team mit Kind-Teams oder Mitgliedern lässt sich nicht löschen.
Eine Person kann im selben Team nicht doppelt mit überlappender Gültigkeit eingetragen werden.
Eine Person kann nicht in zwei zeitlich überlappenden Teams gleichzeitig als Primärmitglied markiert werden.
effectiveUntil darf nicht vor effectiveFrom liegen.
Fremde Mandanten sind nicht sichtbar und nicht referenzierbar.

Wenn eine Validierung blockiert, korrigieren Sie zuerst Team, Person oder Gültigkeitszeitraum. Legen Sie keine parallele Ersatzstruktur in AccessGroups, Organisationen oder Abteilungen an.

Berechtigungen

Staff Teams nutzen eigene Pflege-Scopes:

Bereich	Scopes
Teams lesen und suchen	`staff_teams:list`, `staff_teams:read`
Teams pflegen	`staff_teams:create`, `staff_teams:update`, `staff_teams:delete`
Mitglieder lesen und suchen	`staff_team_members:list`, `staff_team_members:read`
Mitglieder pflegen	`staff_team_members:create`, `staff_team_members:update`, `staff_team_members:delete`

Der Preset Staff: Team Lead steuert weiterhin Team-Zeiterfassung und Entscheidungen über staff_time_team:*. Er erhält keine Staff-Team-Pflege. Verwenden Sie Staff-Team-Pflege nur für Administratoren oder HR-Rollen, die Personalstrukturen verwalten dürfen.

Grenzen

Staff Teams lösen diese Dinge nicht aus:

keine automatische Team-Zeiterfassung
keine Urlaubs- oder Abwesenheitsgenehmigung
keine IAM-Rollen oder AccessGroup-Mitgliedschaften
keine Änderung von reports_to
keine Beschäftigungs-, Payroll-, Projekt- oder Accounting-Wirkung

Wenn Sie Team-Zeiterfassung oder Urlaub einrichten, folgen Sie Mitarbeiter, Arbeitszeit, Urlaub und Verträge. Die Teamliste kann die Struktur ergänzend dokumentieren, bleibt aber nicht die Quelle für Genehmigungen.

Entwickler und Agenten

Lesen Sie Ressourcen immer discovery-first. Mit nucli prüfen Sie die Top-Level-Ressource so:

bash

nucli --tenant <tenant> resources list
nucli --tenant <tenant> resources meta staff.teams
nucli --tenant <tenant> resources get staff.teams --all --max-pages 5 --summary

Die Resource staff.teams steht nur bereit, wenn die aktuelle Session die passenden Staff-Team-Scopes hat. Teammitglieder sind eine nested Resource unter einem konkreten Team. Prüfen Sie zuerst die Team-Meta und verwenden Sie für Mitglieder nur serververöffentlichte URLs oder explizite API-Aufrufe wie:

bash

nucli --tenant <tenant> api GET /api/v1/staff/teams/<team-id>/members --summary

Agenten dürfen aus einer Teamrolle wie lead oder deputy keine Genehmigungs-, IAM- oder Reporting-Wirkung ableiten. Antworten Sie bei Teamfragen mit dieser Trennung:

Staff Teams dokumentieren Struktur und Mitglieder.
reports_to steuert direkte Führung für Arbeitszeit und Urlaub.
IAM-Rollen und AccessGroups steuern Rechte.
Abteilungen, Organisationen, Kostenstellen und Projekte bleiben eigene Fachstrukturen.