NEXOWARE ConnectSchema-Explorer · Kafka-Backbone

Verträge / ContactPersonState

Ansprechpartner State

ContactPersonState · com.nexoware.connect.events

Aggregat
ContactPerson · Patch ContactPersonPatch
Topic
contactperson.state je Mandant mit Präfix, z. B. <mandant>.contactperson.state
Key
ContactUuid
Nachrichtenart
State — der aktuelle Zustand, ein Writer
Schreiber
Zusammenführungsdienst (merge)
Leser
c-entron Webservice (centron) , NEXOWARE.ERP (nexoware-erp)
Fassung
Version 1 (neueste)
Schema-ID
80

Kanonischer Vertrag, Version 1: der vollstaendige zusammengefuehrte Zustand eines Ansprechpartners (Kind des Account-Aggregats, unterhalb einer Adresse). Einziger Writer ist der Zusammenfuehrungsdienst (ADR-0023 Punkt 2 und 4); die Produkte schreiben Patches auf contactperson.patch und lesen diesen State mit isolation.level=read_committed. Identitaet und alle Referenzen ausschliesslich ueber UUID; quell-lokale IDs sind nicht Teil des Vertrags. Feldumfang aus dem Bestandsvertrag ContactPersonChanged (archiviert), ergaenzt um Revision und LastEventId. Fachliche Anforderungen: docs/contracts/contactperson.md.

Fassungen

Felder

Referenziert von

Kein Vertrag verweist auf diesen.

Rohfassung

Schema dieser Fassung (Avro) 
{
  "type": "record",
  "name": "ContactPersonState",
  "namespace": "com.nexoware.connect.events",
  "doc": "Kanonischer Vertrag, Version 1: der vollstaendige zusammengefuehrte Zustand eines Ansprechpartners (Kind des Account-Aggregats, unterhalb einer Adresse). Einziger Writer ist der Zusammenfuehrungsdienst (ADR-0023 Punkt 2 und 4); die Produkte schreiben Patches auf contactperson.patch und lesen diesen State mit isolation.level=read_committed. Identitaet und alle Referenzen ausschliesslich ueber UUID; quell-lokale IDs sind nicht Teil des Vertrags. Feldumfang aus dem Bestandsvertrag ContactPersonChanged (archiviert), ergaenzt um Revision und LastEventId. Fachliche Anforderungen: docs/contracts/contactperson.md.",
  "fields": [
    {
      "name": "ContactUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Stabile, global eindeutige Identitaet des Ansprechpartners; zugleich Message-Key auf State und Patch."
    },
    {
      "name": "AccountAddressUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Parent-Referenz: UUID der Eltern-Adresse (AddressState, Key AddressUuid). Pflicht bei Anlage und danach unveraenderlich - ein Patch verschiebt keinen Kontakt an eine andere Adresse; c-entron legt bei einem Umzug einen neuen Kontakt an.",
      "references": "Address"
    },
    {
      "name": "Firstname",
      "type": [
        "null",
        "string"
      ],
      "default": null
    },
    {
      "name": "Lastname",
      "type": [
        "null",
        "string"
      ],
      "default": null
    },
    {
      "name": "Job",
      "type": [
        "null",
        "string"
      ],
      "doc": "Funktion im Unternehmen.",
      "default": null
    },
    {
      "name": "DepartmentText",
      "type": [
        "null",
        "string"
      ],
      "doc": "Abteilung als Freitext.",
      "default": null
    },
    {
      "name": "Email1",
      "type": [
        "null",
        "string"
      ],
      "default": null
    },
    {
      "name": "Email2",
      "type": [
        "null",
        "string"
      ],
      "default": null
    },
    {
      "name": "Phone1",
      "type": [
        "null",
        "string"
      ],
      "doc": "Geschaeftliche Rufnummer.",
      "default": null
    },
    {
      "name": "Phone3",
      "type": [
        "null",
        "string"
      ],
      "doc": "Mobilnummer.",
      "default": null
    },
    {
      "name": "Fax1",
      "type": [
        "null",
        "string"
      ],
      "default": null
    },
    {
      "name": "IsActive",
      "type": "boolean",
      "doc": "Pflicht bei Anlage - kein Default, damit false keine Vollstaendigkeit vortaeuscht."
    },
    {
      "name": "IsDefault",
      "type": "boolean",
      "doc": "Standard-Ansprechpartner seiner Adresse. Pflicht bei Anlage, aus demselben Grund wie IsActive. Feld-LWW stellt nicht sicher, dass hoechstens ein Kontakt je Adresse Default ist (docs/contracts/contactperson.md)."
    },
    {
      "name": "SalutationUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Referenz auf das Anrede-Stammdatum ueber dessen UUID; quellseitig nullable.",
      "default": null
    },
    {
      "name": "Revision",
      "type": "long",
      "doc": "Anzahl der zustandsaendernden Patches seit Erstanlage. Streng monoton je Objekt - Consumer ueberspringen Revisionen <= der zuletzt uebernommenen."
    },
    {
      "name": "LastEventId",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "EventId des zuletzt angewandten Patches (Diagnose)."
    },
    {
      "name": "ChangedByUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "UUID des aendernden Mitarbeiters (Employee) aus dem zuletzt angewandten Patch; null, wenn unbekannt.",
      "default": null
    },
    {
      "name": "ChangedAt",
      "type": {
        "type": "long",
        "logicalType": "timestamp-millis"
      },
      "doc": "Audit aus dem zuletzt angewandten Patch als UTC-Instant - kein Konfliktentscheider, es entscheidet die Kafka-Reihenfolge der Patches."
    }
  ],
  "aggregate": "ContactPerson",
  "label": "Ansprechpartner",
  "topic": "contactperson.state",
  "key": "ContactUuid",
  "cleanupPolicy": "compact",
  "partitions": 1,
  "writers": [
    "merge"
  ],
  "readers": [
    "centron",
    "nexoware-erp"
  ]
}