Ansprechpartner Patch

{
  "type": "record",
  "name": "ContactPersonPatch",
  "namespace": "com.nexoware.connect.events",
  "doc": "Kanonischer Vertrag, Version 1: Teilaenderung eines Ansprechpartners (ADR-0023 Punkt 3). Alle Patches eines Kontakts laufen ueber dieses eine Topic mit Key = ContactUuid; der Zusammenfuehrungsdienst wendet sie in Kafka-Reihenfolge an und veroeffentlicht den State auf contactperson.state. Semantik: Pfad nicht in ChangedFields -> unveraendert (Wert in Data wird ignoriert); Pfad in ChangedFields mit Wert -> setzen; mit null -> leeren, sofern die Einheit im State nullable ist. Die Maske ist Pflicht, ohne Wildcard. Die Anlage eines Kontakts braucht AccountAddressUuid, IsActive und IsDefault (requiredOnCreate); AccountAddressUuid setzt nur der anlegende Patch (fixedAfterCreate). Ein ungueltiger Patch wird als Ganzes abgelehnt. Fachliche Anforderungen: docs/contracts/contactperson.md.",
  "fields": [
    {
      "name": "EventId",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Beim ersten Enqueue in die Outbox erzeugt, bei jeder Wiederholung identisch. Grundlage der fachlichen Deduplizierung."
    },
    {
      "name": "ContactUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Objektidentitaet; muss dem Message-Key entsprechen."
    },
    {
      "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": "Feldmaske: Pfade der geaenderten Einheiten, z. B. Email1, Phone3. Jeder Pfad nennt genau eine Einheit des State."
    },
    {
      "name": "Data",
      "type": {
        "type": "record",
        "name": "ContactPersonPatchData",
        "doc": "Typisierte Werte. Alle Felder optional, damit ein Producer ausserhalb der Maske nichts erfinden muss; ob null erlaubt ist, entscheidet der State-Vertrag.",
        "fields": [
          {
            "name": "AccountAddressUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "doc": "Nur bei Anlage; danach lehnt der Dienst einen CHANGE mit diesem Pfad ab (FIXED_AFTER_CREATE).",
            "default": null,
            "references": "Address"
          },
          {
            "name": "Firstname",
            "type": [
              "null",
              "string"
            ],
            "default": null
          },
          {
            "name": "Lastname",
            "type": [
              "null",
              "string"
            ],
            "default": null
          },
          {
            "name": "Job",
            "type": [
              "null",
              "string"
            ],
            "default": null
          },
          {
            "name": "DepartmentText",
            "type": [
              "null",
              "string"
            ],
            "default": null
          },
          {
            "name": "Email1",
            "type": [
              "null",
              "string"
            ],
            "default": null
          },
          {
            "name": "Email2",
            "type": [
              "null",
              "string"
            ],
            "default": null
          },
          {
            "name": "Phone1",
            "type": [
              "null",
              "string"
            ],
            "default": null
          },
          {
            "name": "Phone3",
            "type": [
              "null",
              "string"
            ],
            "default": null
          },
          {
            "name": "Fax1",
            "type": [
              "null",
              "string"
            ],
            "default": null
          },
          {
            "name": "IsActive",
            "type": [
              "null",
              "boolean"
            ],
            "default": null
          },
          {
            "name": "IsDefault",
            "type": [
              "null",
              "boolean"
            ],
            "default": null
          },
          {
            "name": "SalutationUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "default": null
          }
        ]
      }
    },
    {
      "name": "ChangedByUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "UUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt. Audit.",
      "default": null
    },
    {
      "name": "ChangedAt",
      "type": {
        "type": "long",
        "logicalType": "timestamp-millis"
      },
      "doc": "Zeitpunkt der Aenderung als UTC-Instant. Audit, kein Konfliktentscheider - es entscheidet die Kafka-Reihenfolge."
    }
  ],
  "aggregate": "ContactPerson",
  "label": "Ansprechpartner",
  "topic": "contactperson.patch",
  "key": "ContactUuid",
  "cleanupPolicy": "delete",
  "retentionMs": 2592000000,
  "partitions": 1,
  "writers": [
    "centron",
    "nexoware-erp"
  ],
  "requiredOnCreate": [
    "AccountAddressUuid",
    "IsActive",
    "IsDefault"
  ],
  "fixedAfterCreate": [
    "AccountAddressUuid"
  ]
}