Zum Inhalt springen

Referenz & Datenmodell

Issue (issue)

Ein Issue ist ein Ticket mit Titel, Markdown-Beschreibung, Zustand, Priorität, Fälligkeit, Zuweisung und optionaler Delegation an einen Agenten.

Das Issue hält ein Anliegen fest und führt es durch Triage, Bearbeitung und Prüfung bis zum Abschluss. Es kann allein stehen, zu einem Projekt gehören oder Teil eines übergeordneten Issues sein. (Datenart: Arbeitsdaten, Bewegungsdaten)

Workmanagement › Allgemein › Issues (alle) und Workmanagement › Inbox › Meine Issues (mir zugewiesen) als Liste oder Board, gruppierbar nach Zustand, Zuweisung, Projekt, Abteilung, Priorität oder Label. Projekt › „Tickets“ zeigt die Issues eines Projekts. Anlegen über „Neues Issue“ (Dialog mit Titel, Beschreibung, Projekt, Priorität, Zuweisung, Labels, Fälligkeitsdatum, Dateien). Die Detailseite (/issues/[id]) enthält Titel, Beschreibung, Sub-Issues, Dateien, „Kommentare“, „Aktivität“, Abonnenten und rechts die „Properties“. Siehe Guides › Issues, Guides › Issue bis erledigt.

Feld Technisch Typ Pflicht Bedeutung Besonderheit
Issue-Bezeichnung (Titel) title Text ja Kurzbezeichnung Pflicht im Dialog; Suchfeld; „Umbenennen“ im Kontextmenü
Beschreibung description Text nein Ausführliche Beschreibung Markdown-Editor
Status state Auswahl ja Zustand im Bearbeitungsablauf Vorgabe „Entwurf“; siehe Zustände
Priorität priority Auswahl ja „Keine Priorität“ (0), „Niedrig“ (1), „Mittel“ (2), „Hoch“ (3), „Dringend“ (4) Vorgabe 0; Symbol mit Balken, „Dringend“ orange
Fälligkeitsdatum due_date Datum nein Termin Anzeige „Morgen fällig“ / „Überfällig“
Zuweisung (Zugewiesener) assignee_id Verweis (Benutzer) nein Bearbeitende Person Agenten in der Auswahl gesperrt; „Keine Zuweisung“
Delegieren delegate_id Verweis (Benutzer) nein Polaris oder aktiver Agent, der das Issue übernimmt nur Polaris und aktive Agenten wählbar; öffnet „Agent-Protokoll“
Projekt project_id Verweis (Projekt) nein Projektbezug im Detail wechselbar; „Kein Projekt“
Abteilung osp_employee_unit_id Verweis (Abteilung) nein Organisatorische Zuordnung nur beim Anlegen aus einer Abteilungsgruppe gesetzt; als Gruppierung „Abteilung“ und Filter sichtbar, im Detail nicht bearbeitbar
Übergeordnetes Issue (Sub-Issue von) parent_issue_id Verweis (Issue) nein Eltern-Issue Detailseite zeigt „Sub-Issues“ mit Fortschritt (Anteil „Erledigt“)
Labels n:m issue_label Verweis nein Schlagworte siehe unten
Abonnenten n:m app_user Verweis nein Verfolgende Benutzer siehe unten

Nicht in der Oberfläche (nur Filterleiste oder gar nicht): type (immer custom), estimation_of_complexity („Komplexität“), cycle („Zyklus“), started_at, completed_at, canceled_at, auto_closed_at. Die Zeitstempel werden bei Zustandswechseln nicht gesetzt. „Erstellungsdatum“ und „Letztes Update“ in der Tabelle sind Standardfelder.

Zu Art Pflicht Beim Archivieren Beim Löschen
Übergeordnetes Issue (issue) gehört zu nein bleibt bleibt (Sub-Issues bleiben mit hängendem Verweis)
Projekt (project) gehört zu nein bleibt Verweis lösen
Abteilung (osp_employment_unit) gehört zu nein bleibt Verweis lösen
Benutzer (app_user, Zuweisung) gehört zu nein bleibt Verweis lösen
Benutzer (app_user, Delegieren) gehört zu nein bleibt Verweis lösen
Label (issue_label) n:m über issue_label_map nein bleibt Label löschen entfernt die Zuordnung
Abonnent (app_user) n:m über issue_subscriber nein bleibt Benutzer löschen entfernt die Zuordnung
Kommentar (issue_comment) hat viele – bleibt bleibt
┌──────────────────────────────────────────────────┐
│ Entwurf ──▶ ToDo ──▶ In Bearbeitung ──▶ in Prüfung ──▶ Erledigt │
│ (backlog) (todo) (inProgress) (inReview) (done) │
└──────────────────────────────────────────────────┘
▲ jeder Zustand ⇄ jeder Zustand ▼
Duplikat (duplicate) Fehlgeschlagen (cancelled)
Wert Label Bedeutung
backlog Entwurf Neu angelegt, noch nicht eingeordnet (Vorgabe)
todo ToDo Eingeordnet, wartet auf Bearbeitung
in_progress In Bearbeitung Wird bearbeitet (gelb)
in_review in Prüfung Fertig, wird geprüft (grün)
done Erledigt Abgeschlossen; zählt im Fortschritt des Eltern-Issues
duplicate Duplikat Anderswo erfasst
cancelled Fehlgeschlagen Nicht umgesetzt

Übergänge sind frei: Auswahl im Feld „Status“, Kontextmenü oder Ziehen auf dem Board zwischen Zustandsspalten. Kein Übergang ist gesperrt, kein Zustand setzt Zeitstempel. Setzt nur der Benutzer (auch ein delegierter Agent kann Felder über seine Werkzeuge ändern).

  • „Duplizieren“ im Kontextmenü legt ein neues Issue mit denselben Werten an („Neues Issue-Duplikat“); ein dupliziertes Sub-Issue bleibt unter demselben Eltern-Issue.
  • Löschen aus dem Kontextmenü. Kommentare und Sub-Issues bleiben technisch bestehen.
  • Aus einer Gruppe heraus angelegte Issues übernehmen den Gruppenwert (Projekt, Abteilung, Zuweisung, Label).
  • Jede Änderung erscheint unter „Aktivität“ (Änderungsverlauf, auch „Delegiert“).

Ein Label hat „Bezeichnung“ (title, Pflicht) und „Farbe“ (color, Pflicht) und gilt organisationsweit. Zuordnung über „Label hinzufügen“ im Detail, im Anlege-Dialog oder Kontextmenü; Gruppierung und Filter „Labels“. Löschen eines Labels (Sicherheitsabfrage „Label … wirklich löschen?“) entfernt alle Zuordnungen; das Issue bleibt.

Abonnenten sind Benutzer, die das Issue verfolgen, ohne es zu bearbeiten. Auswahl über „Abonnenten hinzufügen“; Systemkonto, Polaris und deaktivierte Benutzer sind ausgeblendet, Agenten nicht wählbar (ein bereits eingetragener Agent bleibt sichtbar, damit er austragbar ist). Zuordnung verschwindet mit dem Benutzer.

Offene Issues, Issues „in Prüfung“, Issues ohne Zuweisung, „Erledigt (7 T)“ in der Workmanagement-Übersicht; „Tickets“ (gesamt / geschlossen / Anteil) im Projekt-Scoreboard; Fortschritt eines Eltern-Issues = Anteil erledigter Sub-Issues. Siehe Workmanagement, Struktur & Zählwerte.

Issue-Kommentar · Aufgabe · Agent · Guides › Delegieren