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.
Purpose
Section titled “Purpose”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)
Where in the app
Section titled “Where in the app”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.
Fields
Section titled “Fields”| 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.
Relations
Section titled “Relations”| 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 |
States
Section titled “States” ┌──────────────────────────────────────────────────┐ │ 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).
Rules & automation
Section titled “Rules & automation”- „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“).
Labels (issue_label, issue_label_map)
Section titled “Labels (issue_label, issue_label_map)”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 (issue_subscriber)
Section titled “Subscribers (issue_subscriber)”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.