Ticket Patch

{
  "type": "record",
  "name": "TicketPatch",
  "namespace": "com.nexoware.connect.events",
  "doc": "Vertragsentwurf: typisierte Teilaenderung fuer Ticket. Nur ChangedFields werden angewandt; null leert nur nullable State-Einheiten. Listen und Unterobjekte sind atomare Ersetzungen mit vollstaendigem Inhalt. Fachliche Freigabe und Regeln gekoppelter Werte sind offen; siehe docs/contracts/ticket.md.",
  "fields": [
    {
      "name": "EventId",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Beim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch."
    },
    {
      "name": "TicketUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Stabile, global eindeutige Identitaet des Tickets (Matching-Schluessel; zugleich Message-Key)."
    },
    {
      "name": "Mode",
      "type": {
        "type": "enum",
        "name": "PatchMode",
        "doc": "CHANGE: lokal autorisierte Aenderung, LWW je Einheit nach Kafka-Reihenfolge. INITIAL_LOAD: Erstbefuellung beim Anschluss eines Produkts - setzt eine Einheit nur, wenn sie noch nie geschrieben wurde; ueberschreibt nie einen vorhandenen oder ausdruecklich geleerten Wert. Bewusst ohne Enum-Default: ein unbekannter kuenftiger Modus darf nicht still als CHANGE gelesen werden.",
        "symbols": [
          "CHANGE",
          "INITIAL_LOAD"
        ]
      }
    },
    {
      "name": "ChangedFields",
      "type": {
        "type": "array",
        "items": "string"
      },
      "doc": "Explizite Maske der geaenderten Top-Level-Einheiten; keine Wildcards, Identitaets- oder Auditfelder. Listen und Records werden als Ganzes ersetzt."
    },
    {
      "name": "Data",
      "type": {
        "type": "record",
        "name": "TicketPatchData",
        "doc": "Werte der maskierten Einheiten. null ausserhalb der Maske wird ignoriert; innerhalb der Maske entscheidet die Nullability im State.",
        "fields": [
          {
            "name": "TicketNumber",
            "type": [
              "null",
              "int"
            ],
            "doc": "Fachliche Ticket-Nummer (Business-Key; Nummerngruppe Helpdesk, quellseitig non-null). Nur bei Anlage; fixedAfterCreate.",
            "default": null
          },
          {
            "name": "AccountUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "doc": "Pflicht-Referenz auf den Kunden-Account des Tickets (Quelle KundeI3D, non-null) ueber dessen UUID. Kann der Producer sie nicht aufloesen, scheitert die Avro-Projektion laut (Failed-Outbox-Zeile) statt still null zu senden.",
            "default": null
          },
          {
            "name": "ContactPersonUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "doc": "Referenz auf den Ansprechpartner ueber dessen UUID (bereits akzeptierter Uebergangsfall fuer Personenbezug). Die Quelle referenziert den LEGACY-Kontakt (AnsprechpartnerI3D -> Personen); der Producer loest ihn ueber die Migrations-Rueckreferenz der neuen Kontaktstruktur auf (AccountAddressContacts.OldReferenceI3D + OldReferenceKind = 0). Null ohne Ansprechpartner oder bei Aufloesungsluecke (Kontakt noch nicht migriert).",
            "default": null,
            "references": "ContactPerson"
          },
          {
            "name": "ParentTicketUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "doc": "Referenz auf das uebergeordnete Ticket (Quelle ParentHelpdeskI3D, gleiche Tabelle) ueber dessen UUID; DB nullable. Consumer: Defer-and-Retry, wenn der Parent noch nicht angekommen ist.",
            "default": null,
            "references": "Ticket"
          },
          {
            "name": "StateName",
            "type": [
              "null",
              "string"
            ],
            "doc": "Ticket-Status als Wert-Kopie (hlpdsk_status.Name; installationsspezifischer Katalog ohne eigenes Topic). LWW-Statusfeld des Lebenszyklus; null, solange das Ticket im Freigabe-Workflow noch keinen Status traegt.",
            "default": null
          },
          {
            "name": "PriorityName",
            "type": [
              "null",
              "string"
            ],
            "doc": "Prioritaet als Wert-Kopie (Katalog-Name); DB nullable.",
            "default": null
          },
          {
            "name": "TypeName",
            "type": [
              "null",
              "string"
            ],
            "doc": "Ticket-Typ als Wert-Kopie (Katalog-Name); DB nullable.",
            "default": null
          },
          {
            "name": "ShortDescription",
            "type": [
              "null",
              "string"
            ],
            "doc": "Kurzbeschreibung / Betreff (Quelle Beschreibung); DB nullable.",
            "default": null
          },
          {
            "name": "Description",
            "type": [
              "null",
              "string"
            ],
            "doc": "Problembeschreibung (Quelle Problem, Langtext); DB nullable. Die interne Notiz (InternalNote) und die Dokumentation sind bewusst NICHT Teil des Vertrags.",
            "default": null
          },
          {
            "name": "SerialNumber",
            "type": [
              "null",
              "string"
            ],
            "doc": "Seriennummer des betroffenen Geraets als Wert-Kopie (Quelle SerienNr); DB nullable.",
            "default": null
          },
          {
            "name": "ProjectNumber",
            "type": [
              "null",
              "string"
            ],
            "doc": "Projektnummer (Verknuepfung zur CRM-Projektwelt als fachlicher Schluessel); DB nullable.",
            "default": null
          },
          {
            "name": "IsInternalOnly",
            "type": [
              "null",
              "boolean"
            ],
            "doc": "true = Ticket ist nur intern sichtbar (Quelle IsOnlyInternalVisible, non-null) - Konsumenten duerfen es nicht kundenseitig anzeigen.",
            "default": null
          },
          {
            "name": "IsTicketRefused",
            "type": [
              "null",
              "boolean"
            ],
            "doc": "Freigabe-Status des Kundenportal-Workflows (Quelle IsTicketRefused): true = abgelehnt, false = freigegeben, null = kein Freigabe-Workflow.",
            "default": null
          },
          {
            "name": "DueDate",
            "type": [
              "null",
              {
                "type": "long",
                "logicalType": "timestamp-millis"
              }
            ],
            "doc": "Faelligkeitsdatum (Quelle FaelligAm); DB nullable.",
            "default": null
          },
          {
            "name": "ClosedAt",
            "type": [
              "null",
              {
                "type": "long",
                "logicalType": "timestamp-millis"
              }
            ],
            "doc": "Abschluss-Zeitpunkt (Quelle AbgeschlossenAm); null = offen. Zusammen mit StateName das LWW-Lebenszyklus-Signal - Tickets werden geschlossen, nie geloescht (kein Tombstone).",
            "default": null
          },
          {
            "name": "CreatedAt",
            "type": [
              "null",
              {
                "type": "long",
                "logicalType": "timestamp-millis"
              }
            ],
            "doc": "Anlagezeitpunkt des Tickets als UTC-Instant (Quelle ErfasstAm, vom Save immer gesetzt; Host-lokale Zeit, beim Publish nach UTC konvertiert). Nur bei Anlage; fixedAfterCreate.",
            "default": null
          }
        ]
      }
    },
    {
      "name": "ChangedByUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "UUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt (z. B. Portal-Login oder Wartungs-Massenabschluss).",
      "default": null,
      "references": "Employee"
    },
    {
      "name": "ChangedAt",
      "type": {
        "type": "long",
        "logicalType": "timestamp-millis"
      },
      "doc": "Zeitpunkt der Aenderung als UTC-Instant."
    }
  ],
  "aggregate": "Ticket",
  "label": "Ticket",
  "topic": "ticket.patch",
  "key": "TicketUuid",
  "cleanupPolicy": "delete",
  "retentionMs": 2592000000,
  "partitions": 1,
  "writers": [
    "centron",
    "nexoware-erp"
  ],
  "requiredOnCreate": [
    "TicketNumber",
    "AccountUuid",
    "IsInternalOnly",
    "CreatedAt"
  ],
  "fixedAfterCreate": [
    "TicketNumber",
    "CreatedAt"
  ]
}