NEXOWARE ConnectSchema-Explorer · Kafka-Backbone

Verträge / CountryState

Land State

CountryState · com.nexoware.connect.events

Aggregat
Country · Patch CountryPatch
Topic
country.state je Mandant mit Präfix, z. B. <mandant>.country.state
Key
CountryUuid
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
38

Kanonischer Vertrag, Version 1: der vollstaendige zusammengefuehrte Zustand eines Landes (Stammdatum, auf das Adressen und Beleg-Empfaenger ueber CountryUuid zeigen). Die Waehrung reist als Werte am Land, wie dieses Land sie fuehrt - kein Waehrungs-Stammdatum (docs/contracts/country.md, OFFEN-2). Einziger Writer ist der Zusammenfuehrungsdienst (ADR-0023 Punkt 2 und 4); die Produkte schreiben Patches auf country.patch und lesen diesen State mit isolation.level=read_committed. Identitaet ausschliesslich ueber UUID; quell-lokale IDs sind nicht Teil des Vertrags. Feldumfang 1:1 aus dem Bestandsvertrag CountryChanged (archiviert), ergaenzt um Revision und LastEventId. Fachliche Anforderungen: docs/contracts/country.md.

Fassungen

Felder

Referenziert von

Kein Vertrag verweist auf diesen.

Rohfassung

Schema dieser Fassung (Avro) 
{
  "type": "record",
  "name": "CountryState",
  "namespace": "com.nexoware.connect.events",
  "doc": "Kanonischer Vertrag, Version 1: der vollstaendige zusammengefuehrte Zustand eines Landes (Stammdatum, auf das Adressen und Beleg-Empfaenger ueber CountryUuid zeigen). Die Waehrung reist als Werte am Land, wie dieses Land sie fuehrt - kein Waehrungs-Stammdatum (docs/contracts/country.md, OFFEN-2). Einziger Writer ist der Zusammenfuehrungsdienst (ADR-0023 Punkt 2 und 4); die Produkte schreiben Patches auf country.patch und lesen diesen State mit isolation.level=read_committed. Identitaet ausschliesslich ueber UUID; quell-lokale IDs sind nicht Teil des Vertrags. Feldumfang 1:1 aus dem Bestandsvertrag CountryChanged (archiviert), ergaenzt um Revision und LastEventId. Fachliche Anforderungen: docs/contracts/country.md.",
  "fields": [
    {
      "name": "CountryUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Stabile, global eindeutige Identitaet des Landes; zugleich Message-Key auf State und Patch."
    },
    {
      "name": "Name",
      "type": [
        "null",
        "string"
      ],
      "doc": "Name des Landes. Nexoware.ERP fuehrt ihn als Pflicht (docs/contracts/country.md, OFFEN-3).",
      "default": null
    },
    {
      "name": "CountryCode",
      "type": [
        "null",
        "string"
      ],
      "doc": "ISO-Laendercode (z. B. DE) als fachliches Attribut; quellseitig nullable. Matching-Fallback fuer Laender, die beide Produkte vor dem Anschluss schon fuehren (docs/contracts/country.md, OFFEN-1).",
      "default": null
    },
    {
      "name": "CurrencyISO",
      "type": [
        "null",
        "string"
      ],
      "doc": "ISO-Code der Waehrung, die dieses Land fuehrt (z. B. EUR).",
      "default": null
    },
    {
      "name": "CurrencyName",
      "type": [
        "null",
        "string"
      ],
      "doc": "Name der Waehrung, wie dieses Land sie fuehrt (z. B. \"Euro\"). Ein Wert am Land, kein Waehrungs-Stammdatum: zwei Laender mit derselben CurrencyISO koennen verschiedene Namen tragen.",
      "default": null
    },
    {
      "name": "CurrencySymbol",
      "type": [
        "null",
        "string"
      ],
      "doc": "Waehrungszeichen, wie dieses Land es fuehrt (z. B. \"€\"). Wie CurrencyName ein Wert am Land.",
      "default": null
    },
    {
      "name": "DialingCode",
      "type": [
        "null",
        "string"
      ],
      "doc": "Telefon-Landesvorwahl als Text.",
      "default": null
    },
    {
      "name": "State",
      "type": "int",
      "doc": "Status als Zahl, wie c-entron ihn fuehrt (kein Enum im Produkt; belegt: 1 = aktiv). Pflicht bei Anlage - kein Default, damit 0 keinen Status vortaeuscht. Die Abbildung auf IsActive in Nexoware.ERP ist offen (docs/contracts/country.md, OFFEN-4)."
    },
    {
      "name": "IsEuMember",
      "type": [
        "null",
        "boolean"
      ],
      "doc": "Ob das Land EU-Mitglied ist (steuerlich relevant, z. B. innergemeinschaftliche Lieferung). Null heisst unbekannt, nicht false.",
      "default": null
    },
    {
      "name": "CountryCodeISONumeric",
      "type": [
        "null",
        "string"
      ],
      "doc": "Numerischer ISO-3166-1-Code, dreistellig mit fuehrenden Nullen als Text (z. B. \"276\", \"040\"); null, wenn nicht gepflegt.",
      "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": "Country",
  "label": "Land",
  "topic": "country.state",
  "key": "CountryUuid",
  "cleanupPolicy": "compact",
  "partitions": 1,
  "writers": [
    "merge"
  ],
  "readers": [
    "centron",
    "nexoware-erp"
  ]
}