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)
Wo in der App
Abschnitt betitelt „Wo in der App“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.
Beziehungen
Abschnitt betitelt „Beziehungen“| 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 |
Zustände
Abschnitt betitelt „Zustände“ ┌──────────────────────────────────────────────────┐ │ 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).
Regeln & Automatik
Abschnitt betitelt „Regeln & Automatik“- „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“).
Labels (issue_label, issue_label_map)
Abschnitt betitelt „Labels (issue_label, issue_label_map)“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 (issue_subscriber)
Abschnitt betitelt „Abonnenten (issue_subscriber)“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.
Kennzahlen
Abschnitt betitelt „Kennzahlen“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.