Ticket Schema

The ticket title

Detailed ticket description

Rich text HTML version of the ticket description

Best-effort AI summary of the imported ticket content (external-master mirrors, e.g. TANSS — their description holds the raw source mail). Written only by the worker (queue-ai-summary), null when AI is disabled for the tenant. Distinct from dispatch.aiSummary, which is an internal metadata field of the auto-dispatch pipeline and is not rendered.

Set by the worker whenever an AI summary was attempted — even when the LLM returned nothing (AI off, content too short). Prevents the lazy on-open trigger from re-enqueuing the same ticket on every load.

Current ticket status

Ticket priority level

Associated party UUID

Specific site/address of the associated party

Associated contact person UUID

Assigned user UUID

Human dispatcher responsible for this ticket (ADR 0260): the person who manually created/dispatched it or confirmed/overrode the AI dispatch. Null for pure AI auto-dispatch (no human dispatcher). Server-managed — drives the per-dispatcher Rückfragen-KPI (Dispo-Zielvereinbarung).

Associated org unit UUID

Current ownership tier: CUSTOMER (customer IT) or MSP. null/absent means MSP (legacy).

When the ticket was last handed to CUSTOMER (SLA pause start). Server-managed.

Accumulated milliseconds the SLA clock was paused while the ticket sat at CUSTOMER. Server-managed.

Assignee parked while the ticket sits at CUSTOMER; restored on hand-back. Server-managed.

Associated contract UUID

Associated project UUID

Linked sales_order UUID (the order this ticket originated from)

ID of the orderItem inside the linked sales_order (matches salesOrder.orderItems[].id)

Origin of the linked sales-order item — internal or weclapp

Due date in ISO format

Resolution date in ISO format

Closure date in ISO format

Timestamp of the last status change (denormalized for time limit queries)

Timestamp of the last reopen event (system or manual). Cleared on next non-reopen status change.

User UUID of the actor who reopened the ticket, or one of the sentinel strings "system:auto_close_undo", "system:inbound_mail_ai", "system:inbound_mail_closed" for system-triggered reopens.

Why the ticket was reopened — drives UI banners and audit.

The status the ticket was in immediately before being reopened.

Einstufung des Klassifikators, die zur Wiedereröffnung geführt hat.

Konfidenz (0…1) der Einstufung zum Zeitpunkt der Wiedereröffnung.

Woraus sich die Wiedereröffnung ergab: Schwellwert erreicht ("threshold"), Tenant-Fallback bei Unsicherheit ("fallback") oder von einem Menschen bestätigt ("confirmed").

User-UUID der Person, die die unsichere KI-Einstufung bestätigt hat (nur bei aiReopenBasis "confirmed").

Zustand der manuellen Bestätigung einer unsicheren KI-Einstufung.

Ticket tags

ADR 0146 — explicit permission to invoice time bookings for this ticket while it is still open (e.g. customer ghosted). When `allowedWhileOpen` is true the billing-guard treats the ticket as billable. The reason is internal and propagates into the Leistungsnachweis snapshot, not onto the customer invoice.

ADR 0274 — mark this ticket for STANDALONE billing: its billable time is carved out of the customer collective Leistungsnachweis (and, if the ticket belongs to a project, out of the project LN too) and billed on its own via POST /tickets/:id/generate-performance-record. `enabledBy`/`enabledAt` and the `performanceRecord*`/`invoicedAt` back-references are set server-side only. Set via PUT /tickets/:id/standalone-billing (permission `ticket_billing_override`).

Ticket difficulty (0–100). Feeds the XP award formula on close. Defaults to 50 at award time if null.

Structured skill requirements for dispatch matching

Automatically detected language of the ticket content (ISO 639-1, via fastText lid.176)

Detection confidence (0..1). Used with LANGUAGE_DETECTION_CONFIDENCE_THRESHOLD

Timestamp of the last language detection run

Set when this ticket was converted to another entity (opportunity/complaint). The ticket is kept — not deleted — so linked records (time records, tasks, callbacks) stay reachable and billable. Written only by the conversion routes.

Set when this ticket was created by converting another entity (opportunity/complaint). Written only by the conversion routes.

Reference to a contract position this ticket relates to

Contact person name (used when contactPartyId is not available)

Channel through which the ticket was reported

Ticket type — references the `key` of a ticket_type entity (e.g. INCIDENT, REPAIR). Configurable per tenant; no longer a fixed enum.

External ticket reference ID

Estimated work time in minutes

Timestamp of the first agent response (drives time_to_first_response targets, ADR 0117a)

Timestamp at which the latest inbound customer email was acknowledged as "handled, no reply needed". Clears the awaiting-reply badge when >= the last inbound email time; a newer inbound email re-arms the badge.

User who acknowledged the latest inbound customer email (see inboundReplyAckedAt).

Denormalized active service targets (ADR 0117a)

If set, this ticket was merged into the referenced ticket

Ticket number of the ticket this was merged into (denormalized for display)

Linked risk IDs

Budget control: billing type, caps, consumed time, and lock state

Auto-dispatch metadata set by the AI dispatch pipeline

Herkunftsmarker (EMAIL, M365_OUTLOOK, TANSS, …). Zwei Bedeutungen, die zusammenfallen: WOHER der Datensatz kam und — falls der Wert einem `externalMaster`-Provider entspricht — WER ihn führt. Ein Ticket mit `source: "TANSS"` ist ein read-only Spiegel (ADR 0377): Bearbeitungsversuche scheitern mit 423, gepflegt wird es ausschließlich vom Sync. Der Guard wirkt PRO DOKUMENT — in Codemeta angelegte Tickets tragen kein `source` und bleiben uneingeschränkt bearbeitbar, obwohl sie in derselben Collection liegen. Die Sperre lässt sich pro Ticket aufheben, ohne die Herkunft zu verfälschen: `externalOwnership: "LOCAL"` (ADR 0432) übernimmt den Vorgang nach Codemeta — `source` bleibt dann als Herkunftsangabe stehen, führt aber nicht mehr. Vorher wurde das Feld bereits ad hoc geschrieben (EMAIL/M365_OUTLOOK), war aber nie deklariert — bei `additionalProperties: false` konnte es über validierte Pfade nicht gesetzt werden.

Übernahme eines Fremdsystem-Spiegels in die lokale Verantwortung (ADR 0432). `"LOCAL"` hebt die read-only-Sperre aus ADR 0377 auf: das Ticket bleibt formal ein TANSS-Ticket (`source`/`sourceRef` bleiben erhalten, der Deeplink funktioniert weiter), wird aber ab jetzt in Codemeta zu Ende bearbeitet und vom TANSS-Sync nicht mehr angefasst. In TANSS trägt der Vorgang dann den Tag "CodemetaOS". Fehlt das Feld (Altbestand), gilt der Datensatz weiter als Spiegel — kein Backfill nötig. Nur über POST /tickets/:id/takeover setzbar (in `protectedFields`), niemals per generischem PATCH.

Zeitpunkt der Übernahme (ADR 0432).

Interne User-Id, die die Übernahme ausgelöst hat (ADR 0432).

Name des Tags, der bei der Übernahme im Fremdsystem gesetzt wurde (ADR 0432). Belegt, dass die Gegenseite markiert ist — die Übernahme wird nur bei Erfolg vollzogen. `null` BEI GESETZTEM `externalOwnership: "LOCAL"` ist die eine dokumentierte Ausnahme (ADR 0457): der Vorgang existierte im Fremdsystem nicht mehr, konnte deshalb nicht markiert werden, und die Übernahme wurde nach ausdrücklicher Bestätigung trotzdem vollzogen. Bei fehlendem `externalOwnership` heißt `null` schlicht „nie übernommen".

Direktverweis auf den Datensatz in der Oberfläche des führenden Fremdsystems (ADR 0362/0377). Wird beim Spiegeln einmal mitgeschrieben, weil der Host nur in `integration_configs` steht — Daten, die die Ticketseite nicht lädt und ein Techniker nicht zwingend lesen darf. Fehlt das Feld (ältere Spiegel), zeigt die Oberfläche schlicht keinen Link — kein Backfill nötig.

Reference to the source system this entity was imported from

Customer satisfaction rating for this ticket, populated from survey responses

Whether this ticket is appropriate for an intern/junior to work on (auto-set when difficulty < 30; manual override possible)

Parent major incident this ticket is grouped under

Ticket is snoozed until this timestamp; hidden from active queues

User who snoozed the ticket

When the ticket was snoozed

Reason provided when snoozing

Top-N task_template IDs suggested by the dispatcher (ADR 0138 Hook A). Server-managed via /suggest-templates endpoint.

task_template IDs that have been applied to this ticket (used by skill-aware dispatch in Hook B).

When the template suggestion pipeline last ran for this ticket.