NEXOWARE ConnectSchema-Explorer · Kafka-Backbone

Verträge / AddressState

Adresse State

AddressState · com.nexoware.connect.events

Aggregat
Address · Patch AddressPatch
Topic
address.state je Mandant mit Präfix, z. B. <mandant>.address.state
Key
AddressUuid
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
55

Kanonischer Vertrag, Version 1: der vollstaendige zusammengefuehrte Zustand einer Adresse (Kind des Account-Aggregats: Zuordnung zu einem Geschaeftspartner samt postalischem Inhalt in einer Zeile). Einziger Writer ist der Zusammenfuehrungsdienst (ADR-0023 Punkt 2 und 4); die Produkte schreiben Patches auf address.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 1:1 aus dem Bestandsvertrag AddressChanged (archiviert), ergaenzt um Revision und LastEventId. Fachliche Anforderungen: docs/contracts/address.md.

Fassungen

Felder

Referenziert von

Kein Vertrag verweist auf diesen.

Rohfassung

Schema dieser Fassung (Avro) 
{
  "type": "record",
  "name": "AddressState",
  "namespace": "com.nexoware.connect.events",
  "doc": "Kanonischer Vertrag, Version 1: der vollstaendige zusammengefuehrte Zustand einer Adresse (Kind des Account-Aggregats: Zuordnung zu einem Geschaeftspartner samt postalischem Inhalt in einer Zeile). Einziger Writer ist der Zusammenfuehrungsdienst (ADR-0023 Punkt 2 und 4); die Produkte schreiben Patches auf address.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 1:1 aus dem Bestandsvertrag AddressChanged (archiviert), ergaenzt um Revision und LastEventId. Fachliche Anforderungen: docs/contracts/address.md.",
  "fields": [
    {
      "name": "AddressUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Stabile, global eindeutige Identitaet der Adresse; zugleich Message-Key auf State und Patch. In c-entron identifiziert sie Zuordnung und Inhalt zugleich; Nexoware.ERP fuehrt dafuer zwei IDs (docs/contracts/address.md, OFFEN-1)."
    },
    {
      "name": "AccountUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Parent-Referenz: UUID des Eltern-Geschaeftspartners (AccountState). Pflicht bei Anlage und danach unveraenderlich - ein Patch verschiebt keine Adresse zu einem anderen Partner."
    },
    {
      "name": "AddressKind",
      "type": "int",
      "doc": "Adressrolle als Zahl, wie c-entron sie fuehrt (kein Enum im Produkt; belegt: 1 = Rechnungs-/Lieferadresse und Vorgabe bei Anlage, 4 = Lieferantenadresse). Pflicht bei Anlage - kein Default, damit 0 keine Rolle vortaeuscht. Die Abbildung auf die Rollen von Nexoware.ERP ist offen (docs/contracts/address.md, OFFEN-2)."
    },
    {
      "name": "Street",
      "type": [
        "null",
        "string"
      ],
      "doc": "Strasse samt Hausnummer als ein Freitext; ein getrenntes Hausnummernfeld kennt der Vertrag nicht.",
      "default": null
    },
    {
      "name": "Zip",
      "type": [
        "null",
        "string"
      ],
      "default": null
    },
    {
      "name": "City",
      "type": [
        "null",
        "string"
      ],
      "default": null
    },
    {
      "name": "PostOfficeBox",
      "type": [
        "null",
        "string"
      ],
      "default": null
    },
    {
      "name": "Department",
      "type": [
        "null",
        "string"
      ],
      "doc": "Adresszusatz (Abteilung) als Freitext.",
      "default": null
    },
    {
      "name": "CountryUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Referenz auf das Land (CountryState) ueber dessen UUID; quellseitig nullable.",
      "default": null
    },
    {
      "name": "BookKeepingNumber",
      "type": [
        "null",
        "int"
      ],
      "doc": "Buchhaltungsnummer der Adresse; quellseitig int?.",
      "default": null
    },
    {
      "name": "IsActive",
      "type": "boolean",
      "doc": "Pflicht bei Anlage - kein Default, damit false keine Vollstaendigkeit vortaeuscht."
    },
    {
      "name": "IsDefault",
      "type": "boolean",
      "doc": "Standardadresse ihres Geschaeftspartners. Pflicht bei Anlage, aus demselben Grund wie IsActive. Feld-LWW stellt nicht sicher, dass hoechstens eine Adresse je Partner Default ist (docs/contracts/address.md)."
    },
    {
      "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": "Address",
  "label": "Adresse",
  "topic": "address.state",
  "key": "AddressUuid",
  "cleanupPolicy": "compact",
  "partitions": 1,
  "writers": [
    "merge"
  ],
  "readers": [
    "centron",
    "nexoware-erp"
  ]
}