# Zuständigkeiten in Forge

> **Zielgruppe & Rolle**
>
> **Rolle**: Projektverantwortliche (Projektrolle Maintainer oder Admin) zum Einrichten, alle Projektmitglieder zum Nutzen | **Voraussetzung**: ein Forge-Projekt; für Reviewer-Vorschläge und CODEOWNERS die GitHub-Anbindung

# Zuständigkeiten in Forge

Eine **Zuständigkeit** beschreibt einen Teil eines Forge-Projekts – etwa „Personal“, „Service Desk“ oder „Alle Fehler“ – und nennt, wer
dafür **hauptverantwortlich** ist und wer **vertritt**. Wofür sie gilt, legen Sie fest über **Pfade** im Repository (wie in einer
CODEOWNERS-Datei von GitHub), über **Vorgangstypen** und über **Labels**. Verantwortlich kann eine Person oder ein **Team** sein.

## Zuständigkeit anlegen

1. Öffnen Sie das Projekt und wählen Sie **Einstellungen › Zuständigkeiten**.
2. Klicken Sie auf **Zuständigkeit anlegen** und vergeben Sie Name und Schlüssel. Der Schlüssel bleibt danach fest; die Zuständigkeit
   erhält automatisch das Label `owner::<Schlüssel>`.
3. Legen Sie fest, wofür sie gilt: **Pfade** (ein Muster je Zeile), **Vorgangstypen** und/oder **Labels**. Es genügt eine der drei Angaben.
4. Wählen Sie die **verantwortliche Person** oder ein **Team** und optional **Vertretungen**. Personen müssen Mitglieder des Projekts
   mit mindestens der Rolle Entwicklung sein. Vertretungen sind immer Personen.

| Muster | Bedeutung |
|---|---|
| `hr/**` | alles unterhalb von `hr` |
| `common/pkg/hrclient/` | das Verzeichnis `common/pkg/hrclient` (ab dem Hauptverzeichnis) und alles darin |
| `logs/` | jedes Verzeichnis namens `logs`, egal wie tief, und alles darin |
| `/docs/` | nur das Verzeichnis `docs` im Hauptverzeichnis |
| `*.go` | jede Go-Datei im ganzen Repository |
| `docs/*` | nur die Dateien direkt in `docs`, nicht in Unterverzeichnissen |

> [!IMPORTANT] Reihenfolge
> Passen mehrere Zuständigkeiten, gilt die **untere** in der Liste – bei Dateien genau wie in CODEOWNERS die letzte passende Zeile.
> Ziehen Sie allgemeine Zuständigkeiten (z. B. `*.go`) nach oben und spezielle nach unten.

Solange eine Person eine Zuständigkeit verantwortet oder vertritt, kann sie nicht aus dem Projekt entfernt oder auf die Rolle Melder
gesetzt werden. Tragen Sie vorher eine andere Person ein.

## Teams

Unter **Einstellungen › Teams** fassen Sie Projektmitglieder (ab der Rolle Entwicklung) zu einem Team zusammen. Die erste Person ist
die **Leitung**. Ist ein Team verantwortlich, gilt seine Leitung als Hauptverantwortliche (bei automatischer Zuweisung) und
**alle Mitglieder** werden als Reviewer vorgeschlagen. Ein Team, das eine Zuständigkeit verantwortet, kann nicht gelöscht werden, und
seine Mitglieder können nicht aus dem Projekt entfernt werden, solange sie im Team sind.

## Verschachteln

Eine Zuständigkeit kann unter einer anderen stehen (bis zu vier Ebenen). Hat sie keine eigene verantwortliche Person oder kein eigenes
Team, übernimmt sie die der übergeordneten Zuständigkeit – samt deren Vertretungen. Eine übergeordnete Zuständigkeit lässt sich erst
löschen, wenn keine untergeordnete mehr darunter steht.

## Vorgängen zuordnen

In der Seitenleiste eines Vorgangs wählen Sie unter **Zuständigkeit** die passende; darunter stehen die Verantwortlichen. Weil sie ein
Label ist (`owner::<Schlüssel>`), können Sie Listen und Ansichten danach filtern und Boards danach gruppieren. Ein Vorgang hat höchstens
eine ausdrückliche Zuständigkeit, und diese hat Vorrang. Ohne sie gilt die Zuständigkeit, deren **Vorgangstyp** oder **Label** auf den
Vorgang passt; bei mehreren gewinnt die weiter unten stehende.

## Automatisch zuweisen

Unter **Projekteinstellungen › Automationen** steht bei den **Fertigen Automationen** die Vorlage **Zuständige automatisch
zuweisen**: Sobald ein Vorgang ein `owner::`-Label trägt – beim Anlegen oder wenn das Label später gesetzt wird –, erhält er die
hauptverantwortliche Person seiner Zuständigkeit (bei einem Team dessen Leitung). Ein anderes Label weist nicht erneut zu; ohne
Zuständigkeit passiert nichts.

Die Automation besteht aus dem Schritt **Zuständige Person hinzufügen** mit dem Wert `ownership_owner` und einem Filter auf das
Label (`any(trigger.data.addedLabels ?? [], hasPrefix(#, 'owner::'))`). Sollen auch Vorgänge zugewiesen werden, deren Zuständigkeit
sich nur aus **Vorgangstyp** oder **Label** ergibt, bauen Sie eine eigene Automation mit dem Ereignis **Element angelegt** und
demselben Schritt – siehe
[Automationen in Entwicklungsprojekten](/knowledge/docs/products/portal/user-docs/automatisierung/automationen-in-entwicklungsprojekten.md).

## CODEOWNERS erzeugen

**Einstellungen › Zuständigkeiten › CODEOWNERS anzeigen** erzeugt die Datei `.github/CODEOWNERS` aus Ihren Zuständigkeiten. Übernehmen Sie
sie in das Repository – GitHub fordert dann bei jedem Pull Request automatisch Reviews der Verantwortlichen an. ConnectCLOUD schreibt die
Datei nicht selbst. Personen ohne mit ConnectCLOUD verknüpftes GitHub-Konto stehen nicht in der Datei; sie werden über der Datei genannt.

> [!NOTE] Nur Pfade landen in CODEOWNERS
> CODEOWNERS kennt ausschließlich Pfadmuster. Zuständigkeiten, die nur über Vorgangstypen oder Labels passen, erscheinen daher nicht in
> der Datei; sie wirken in ConnectCLOUD (Zuordnung, automatische Zuweisung), nicht auf GitHub.

## Reviewer für Pull Requests vorschlagen

Im Bereich **Code** eines Vorgangs zeigt ConnectCLOUD zu jedem offenen Pull Request die **vorgeschlagenen Reviewer**: die
Verantwortlichen der Zuständigkeiten, deren Dateien der Pull Request ändert (bei einem Team alle Mitglieder). Mit **Reviewer anfordern**
fordern Sie die Hauptverantwortlichen an – unter Ihrem eigenen GitHub-Konto. Vertretungen haken Sie bei Bedarf dazu an. Personen ohne
verknüpftes GitHub-Konto oder ohne Zugriff auf das Repository werden angezeigt, aber nicht angefordert; die Autorin oder der Autor
des Pull Requests erscheint nie. Hier zählen nur Pfade: Der Pull Request wird den Zuständigkeiten über seine geänderten Dateien zugeordnet.

## Planungsagent

Der [Planungsagent](/knowledge/docs/base/planungsagent-forge.md) kennt die Zuständigkeit eines Vorgangs, ihre Verantwortlichen und Pfade und kann für Vorgänge
ohne Zuständigkeit ein passendes `owner::`-Label vorschlagen.
