Skip to content

Reference & Data Model

Issue (issue)

An issue is a ticket with title, Markdown description, state, priority, due date, assignment and optional delegation to an agent.

The issue records a concern and carries it through triage, processing and review to completion. It can stand alone, belong to a project or be part of a parent issue. (Data type: work data, transactional data)

Workmanagement › Allgemein › Issues (Work management › General › Issues; all) and Workmanagement › Inbox › Meine Issues (My issues; assigned to me) as a list or board, groupable by state, assignment, project, department, priority or label. Project › „Tickets“ shows the issues of a project. Create via „Neues Issue“ (dialog with title, description, project, priority, assignment, labels, due date, files). The detail page (/issues/[id]) contains title, description, sub-issues, files, „Kommentare“ (Comments), „Aktivität“ (Activity), subscribers and, on the right, the „Properties“. See Guides › Issues, Guides › Issue to done.

Field Technical Type Required Meaning Notes
Issue label (title) title Text yes Short label Required in the dialog; search field; „Umbenennen“ in the context menu
Description description Text no Detailed description Markdown editor
Status state Selection yes State in the processing workflow Default „Entwurf“; see States
Priority priority Selection yes „Keine Priorität“ (0), „Niedrig“ (1), „Mittel“ (2), „Hoch“ (3), „Dringend“ (4) (none, low, medium, high, urgent) Default 0; icon with bars, „Dringend“ orange
Due date due_date Date no Deadline Displayed as „Morgen fällig“ / „Überfällig“
Assignment (assignee) assignee_id Reference (user) no Person working on it Agents locked in the selection; „Keine Zuweisung“
Delegate delegate_id Reference (user) no Polaris or active agent that takes over the issue only Polaris and active agents selectable; opens „Agent-Protokoll“
Project project_id Reference (project) no Project reference changeable in the detail; „Kein Projekt“
Department osp_employee_unit_id Reference (department) no Organizational assignment only set when created from a department group; visible as the „Abteilung“ grouping and filter, not editable in the detail
Parent issue (sub-issue of) parent_issue_id Reference (issue) no Parent issue Detail page shows „Sub-Issues“ with progress (share of „Erledigt“)
Labels n:m issue_label Reference no Keywords see below
Subscribers n:m app_user Reference no Following users see below

Not in the interface (only in the filter bar or not at all): type (always custom), estimation_of_complexity („Komplexität“), cycle („Zyklus“), started_at, completed_at, canceled_at, auto_closed_at. The timestamps are not set on state changes. „Erstellungsdatum“ and „Letztes Update“ in the table are standard fields.

Related to Kind Required On archive On delete
Parent issue (issue) belongs to no kept kept (sub-issues remain with a dangling reference)
Project (project) belongs to no kept reference cleared
Department (osp_employment_unit) belongs to no kept reference cleared
User (app_user, assignment) belongs to no kept reference cleared
User (app_user, delegate) belongs to no kept reference cleared
Label (issue_label) n:m via issue_label_map no kept deleting the label removes the mapping
Subscriber (app_user) n:m via issue_subscriber no kept deleting the user removes the mapping
Comment (issue_comment) has many – kept kept
┌──────────────────────────────────────────────────┐
│ Entwurf ──▶ ToDo ──▶ In Bearbeitung ──▶ in Prüfung ──▶ Erledigt │
│ (backlog) (todo) (inProgress) (inReview) (done) │
└──────────────────────────────────────────────────┘
▲ every state ⇄ every state ▼
Duplikat (duplicate) Fehlgeschlagen (cancelled)
Value Label Meaning
backlog Entwurf Newly created, not yet triaged (default)
todo ToDo Triaged, waiting for processing
in_progress In Bearbeitung Being worked on (yellow)
in_review in Prüfung Finished, being reviewed (green)
done Erledigt Completed; counts in the progress of the parent issue
duplicate Duplikat Recorded elsewhere
cancelled Fehlgeschlagen Not implemented

Transitions are free: selection in the „Status“ field, context menu or dragging on the board between state columns. No transition is locked, no state sets timestamps. Set only by the user (a delegated agent can also change fields via its tools).

  • „Duplizieren“ in the context menu creates a new issue with the same values („Neues Issue-Duplikat“); a duplicated sub-issue stays under the same parent issue.
  • Delete from the context menu. Comments and sub-issues technically remain.
  • Issues created from within a group take over the group value (project, department, assignment, label).
  • Every change appears under „Aktivität“ (change history, including „Delegiert“).

A label has „Bezeichnung“ (title, required) and „Farbe“ (color, required) and applies organization-wide. Assignment via „Label hinzufügen“ in the detail, in the create dialog or context menu; grouping and filter „Labels“. Deleting a label (confirmation prompt „Label … wirklich löschen?“) removes all mappings; the issue remains.

Subscribers are users who follow the issue without working on it. Selection via „Abonnenten hinzufügen“; the system account, Polaris and deactivated users are hidden, agents are not selectable (an agent already entered stays visible so it can be removed). The mapping disappears with the user.

Open issues, issues „in Prüfung“, unassigned issues, „Erledigt (7 T)“ in the work management overview; „Tickets“ (total / closed / share) in the project scoreboard; progress of a parent issue = share of completed sub-issues. See Work management, Structure & counts.

Issue comment · Task · Agent · Guides › Delegate