GUIDE Projektmanagement

Letztes Update: 04. Februar 2026

Überblick

Dieses Dokument beschreibt HisQu-spezifische Git-Themen (u.a. Projektboard-Workflow im Projects-Tab der HisQu-Organisation). Es ist bewusst getrennt vom allgemeinen Git-Guide.

Der Guide behandelt folgende Themen:

1. Zweck des HisQu Projektboards
2. Das Projektboard nutzen
3. Labels im HisQu Projekt
4. Size im HisQu-Projekt
5. Filtern & Suchen im Projektboard

---

1. Zweck des HisQu Projektboards

Das zentrale HisQu Projektboard (im Projects-Tab der HisQu-Organisation) dient dazu:

• Einen Gesamtüberblick über alle relevanten Issues aus verschiedenen Repositories zu bieten.
• Den Fortschritt von Aufgaben transparent zu machen (Status-Tracking).
• Issues nach Priorität, Zuständigkeit (Assignee) und Teilprojekt/Partner zu ordnen.
• Die Planung mittels Kanban-Boards und Timeline zu unterstützen.

---

2. Das Projektboard nutzen

2.1 Hauptansichten

Das Board hat mehrere Ansichten (Tabs), die wichtigsten für uns sind typischerweise:

1. Kanban/Board-Ansicht ("HisQu Aufgaben" o.ä.):

   • Spalten nach Status: Zeigt Issues gruppiert nach ihrem Bearbeitungsstatus: Todo (Zu erledigen), In Progress (In Arbeit), Erwartet Review (Fertig, wartet auf Prüfung), Done (Abgeschlossen).
   • Verschieben: Ziehe Issues per Drag & Drop in die nächste Spalte, um ihren Status zu aktualisieren.
   • Infos auf Karten: Zeigt Titel, Assignee, Labels, ggf. Aufwand ("Size") direkt an.

2. Tabellenansicht:

   • Überblick: Listet Issues zeilenweise mit konfigurierbaren Spalten (Feldern) auf. Gut für Sortierung und Massenbearbeitung.
   • Bearbeiten: Viele Felder (Status, Assignee, Labels) können direkt in der Tabelle geändert werden.

3. Timeline-Ansicht:

   • Planung: Visualisiert Issues auf einer Zeitachse. Nützlich, wenn Issues Start- und Enddaten haben (diese müssen als Felder im Projekt konfiguriert und an Issues gepflegt werden, aktuell weniger relevant für uns).

2.2 Issues verwalten

• Zum Projekt hinzufügen:
  • Direkt im Board über "Add item".
  • Aus einem Repository heraus über die Issue-Seitenleiste > "Projects".
  • Automatisch (falls Workflows dafür eingerichtet sind).
• Status pflegen: Halte das "Status"-Feld immer aktuell (entsprechend der Kanban-Spalte).
• Zuweisen: Weise Issues einem Assignee zu.
• Labels verwenden: Nutze Labels zur Kategorisierung (siehe nächster Abschnitt).

---

3. Labels im HisQu Projekt

Labels dienen der thematischen Einordnung und sind entscheidend für das Filtern im Projektboard und in den Repositories.

3.1 Projektspezifische Labels (Partner/Teilprojekt)

• DHI Rom: Für alle Issues, an denen das DHI Rom beteiligt ist, die mehr als ein Teammitglied betreffen, aber nur einen Assignee haben.
• FactGrid: Für alle Issues, an denen FactGrid beteiligt ist, die mehr als ein Teammitglied betreffen, aber nur einen Assignee haben.
• FSU: Für alle Issues, an denen die FSU beteiligt ist, die mehr als ein Teammitglied betreffen, aber nur einen Assignee haben.
• Germania Sacra: Für alle Issues, an denen die Germania Sacra beteiligt ist, die mehr als ein Teammitglied betreffen, aber nur einen Assignee haben.

3.2 Status / Workflow Labels

• Wird nicht behoben: Tickets, die nicht umgesetzt werden.
• Zurückgestellt: Tickets, deren Bearbeitung später erfolgt.
• Duplikat: Issue oder Pull Request existiert bereits.

3.3 Kollaborations-Labels

• Diskussion: Ungeklärte Fragen zum Vorgehen; benötigt Input.
• Dokumentation: Betrifft Verbesserungen oder Erstellung von Dokumentation.

(Labels wie Bug oder Feature können zusätzlich verwendet werden, um die Art des Issues zu kennzeichnen, falls im Template definiert)

---

4. Size im HisQu-Projekt

Die Einordnung der Size eines Issues dient der Bestimmung des zeitlichen Umfangs einer Aufgabe und unterstützt die Zuweisung im Team. In der Timeline sollte pro Woche nicht mehr Aufwand geplant werden als die verfügbare Wochenarbeitszeit.

• XS: Für alle Issues mit einer Dauer < 1 Stunde: Sehr kleine Aufgaben, oft nur ein paar Minuten: z. B. Schreibfehler korrigieren, eine Variable umbenennen, README anpassen.

• S: Für alle Issues mit einer Dauer 1–4 Stunden: Kleine, klar umrissene Tasks: z. B. eine Funktion ergänzen, kleine Tests schreiben, einen Bug fixen.

• M: Für alle Issues mit einer Dauer 4–8 Stunden (≈ 1 Arbeitstag): Mittlere Aufgaben, die man an einem Tag erledigen kann: z. B. eine Komponente bauen, ein Datenmodell erweitern.

• L: Für alle Issues mit einer Dauer 2–4 Arbeitstage: Größere Tasks, die mehrere Teilaspekte haben, eventuell Aufteilung sinnvoll: z. B. neue Feature-Implementierung, Refactoring größerer Module.

• XL: Für alle Issues mit einer Dauer > 1 Woche / mehrere Arbeitstage: Sehr große Aufgaben, die bitte immer in Teil-Issues oder Unteraufgaben zerlegt werden sollten: z. B. Systemarchitektur ändern, große Migrationen.

---

5. Filtern & Suchen im Projektboard

Nutze die Filterleiste oben im Projektboard (Filter by keyword or field), um gezielt Informationen zu finden:

• Nach Person filtern: Gib @me ein (deine Issues) oder @<username> (Issues einer anderen Person).
• Nach Label filtern: Gib label:"DHI Rom" ein (Anführungszeichen bei Leerzeichen nötig) oder label:FSU. Mehrere Labels: label:FSU,Dokumentation.
• Nach Status filtern: Gib status:"In Progress" ein oder wähle es aus dem Dropdown.
• Nach Text filtern: Gib Suchbegriffe ein (durchsucht Titel/Body).
• Nach Repository filtern: Gib repo:HisQu/repository-name ein.
• Kombinieren: Verknüpfe mehrere Filter (z.B. status:"In Progress" label:FSU assignee:@me).

Gespeicherte Ansichten: Häufig genutzte Filterkombinationen können als eigene Ansicht (neuer Tab im Projekt) gespeichert werden.