Verträge / BranchState
Filiale State
BranchState · com.nexoware.connect.events
- Aggregat
- Branch · Patch BranchPatch
- Topic
- branch.state je Mandant mit Präfix, z. B.
<mandant>.branch.state - Key
- BranchUuid
- 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
- 59
Vertragsentwurf: vollstaendiger veroeffentlichter Zustand fuer Filiale. Feldumfang aus dem archivierten BranchChanged; kein fachlicher Vergleich beider Produkte. Einziger State-Writer ist merge; Produkte veroeffentlichen typisierte Patches. Grenzen, Migration und offene Fachregeln: docs/contracts/branch.md.
Fassungen
Felder
-
BranchUuid Key uuidStabile, global eindeutige Identitaet der Filiale (Matching-Schluessel; zugleich Message-Key).
-
BranchId optional stringDefault:
nullFilial-Kennung (Quelle FilialID) als fachliches Attribut; Uebergangs-Matching-Fallback, sofern befuellt (DB nullable, ADR-0006). -
Name optional stringDefault:
nullFilialname (Quelle FilialName); DB nullable. -
State intLWW-Statusfeld (Quelle FilialStatus: 1 = aktiv, sonst deaktiviert - die Quelle filtert aktiv per Status == 1, BranchRepository.GetBranchesForSelection). Deaktivierung reist als Voll-Snapshot, kein Tombstone.
-
IsDefault intStandard-Filiale-Kennzeichen (Quelle IsDefault, 0/1 als int wie in der Quelle).
-
MandatorName optional stringDefault:
nullMandanten-Zugehoerigkeit als Fachfeld: Name des Mandanten (Quelle MandantI3D -> Mandant.Mandant, vom Producer denormalisiert aufgeloest). Der Mandant hat keine Uuid und kein eigenes Topic (Urteil 'spaeter', Zuschnitt 11); null, wenn nicht aufloesbar. -
Default:
nullReferenz auf das der Filiale zugeordnete Kundenkonto (Quelle KundenI3D) ueber dessen UUID; null, wenn nicht verknuepft (<= 0) oder nicht aufloesbar. -
Street optional stringDefault:
nullStrasse (Quelle Strasse); DB nullable. -
ZipCode optional stringDefault:
nullPostleitzahl (Quelle Postleitzahl); DB nullable. -
City optional stringDefault:
nullStadt (Quelle Stadt); DB nullable. -
Default:
nullReferenz auf das Land-Stammdatum ueber dessen UUID (vormals LandI3D); quellseitig nullable. -
PhoneNumber optional stringDefault:
nullTelefonnummer der Filiale (Quelle TelefonNummer); DB nullable. -
FaxNumber optional stringDefault:
nullFaxnummer der Filiale (Quelle FaxNummer); DB nullable. -
Email optional stringDefault:
nullE-Mail-Adresse der Filiale (Quelle EMail) - Firmen-Kontaktdatum, kein Personendatum; DB nullable. -
Url optional stringDefault:
nullWeb-Adresse der Filiale (Quelle WWW); DB nullable. -
Comment optional stringDefault:
nullKommentar/Notiz zur Filiale (Quelle Kommentar); DB nullable. -
BookKeepingNumber optional stringDefault:
nullBuchhaltungsnummer der Filiale (Quelle Buchhaltungsnummer) - Buchungskreis-/FiBu-Kontext (Anhang C FiBu-Paket); DB nullable. -
Revision longAnzahl der zustandsaendernden Patches seit Anlage; vom Zusammenfuehrungsdienst gesetzt.
-
LastEventId ↗ extern: LastEventId uuidEventId des zuletzt angewandten Patches; vom Zusammenfuehrungsdienst gesetzt.
-
Default:
nullUUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt. -
ChangedAt timestampZeitpunkt der Aenderung als UTC-Instant.
Referenziert von
Kein Vertrag verweist auf diesen.
Rohfassung
Schema dieser Fassung (Avro)
{
"type": "record",
"name": "BranchState",
"namespace": "com.nexoware.connect.events",
"doc": "Vertragsentwurf: vollstaendiger veroeffentlichter Zustand fuer Filiale. Feldumfang aus dem archivierten BranchChanged; kein fachlicher Vergleich beider Produkte. Einziger State-Writer ist merge; Produkte veroeffentlichen typisierte Patches. Grenzen, Migration und offene Fachregeln: docs/contracts/branch.md.",
"fields": [
{
"name": "BranchUuid",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Stabile, global eindeutige Identitaet der Filiale (Matching-Schluessel; zugleich Message-Key)."
},
{
"name": "BranchId",
"type": [
"null",
"string"
],
"doc": "Filial-Kennung (Quelle FilialID) als fachliches Attribut; Uebergangs-Matching-Fallback, sofern befuellt (DB nullable, ADR-0006).",
"default": null
},
{
"name": "Name",
"type": [
"null",
"string"
],
"doc": "Filialname (Quelle FilialName); DB nullable.",
"default": null
},
{
"name": "State",
"type": "int",
"doc": "LWW-Statusfeld (Quelle FilialStatus: 1 = aktiv, sonst deaktiviert - die Quelle filtert aktiv per Status == 1, BranchRepository.GetBranchesForSelection). Deaktivierung reist als Voll-Snapshot, kein Tombstone."
},
{
"name": "IsDefault",
"type": "int",
"doc": "Standard-Filiale-Kennzeichen (Quelle IsDefault, 0/1 als int wie in der Quelle)."
},
{
"name": "MandatorName",
"type": [
"null",
"string"
],
"doc": "Mandanten-Zugehoerigkeit als Fachfeld: Name des Mandanten (Quelle MandantI3D -> Mandant.Mandant, vom Producer denormalisiert aufgeloest). Der Mandant hat keine Uuid und kein eigenes Topic (Urteil 'spaeter', Zuschnitt 11); null, wenn nicht aufloesbar.",
"default": null
},
{
"name": "AccountUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf das der Filiale zugeordnete Kundenkonto (Quelle KundenI3D) ueber dessen UUID; null, wenn nicht verknuepft (<= 0) oder nicht aufloesbar.",
"default": null
},
{
"name": "Street",
"type": [
"null",
"string"
],
"doc": "Strasse (Quelle Strasse); DB nullable.",
"default": null
},
{
"name": "ZipCode",
"type": [
"null",
"string"
],
"doc": "Postleitzahl (Quelle Postleitzahl); DB nullable.",
"default": null
},
{
"name": "City",
"type": [
"null",
"string"
],
"doc": "Stadt (Quelle Stadt); DB nullable.",
"default": null
},
{
"name": "CountryUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf das Land-Stammdatum ueber dessen UUID (vormals LandI3D); quellseitig nullable.",
"default": null
},
{
"name": "PhoneNumber",
"type": [
"null",
"string"
],
"doc": "Telefonnummer der Filiale (Quelle TelefonNummer); DB nullable.",
"default": null
},
{
"name": "FaxNumber",
"type": [
"null",
"string"
],
"doc": "Faxnummer der Filiale (Quelle FaxNummer); DB nullable.",
"default": null
},
{
"name": "Email",
"type": [
"null",
"string"
],
"doc": "E-Mail-Adresse der Filiale (Quelle EMail) - Firmen-Kontaktdatum, kein Personendatum; DB nullable.",
"default": null
},
{
"name": "Url",
"type": [
"null",
"string"
],
"doc": "Web-Adresse der Filiale (Quelle WWW); DB nullable.",
"default": null
},
{
"name": "Comment",
"type": [
"null",
"string"
],
"doc": "Kommentar/Notiz zur Filiale (Quelle Kommentar); DB nullable.",
"default": null
},
{
"name": "BookKeepingNumber",
"type": [
"null",
"string"
],
"doc": "Buchhaltungsnummer der Filiale (Quelle Buchhaltungsnummer) - Buchungskreis-/FiBu-Kontext (Anhang C FiBu-Paket); DB nullable.",
"default": null
},
{
"name": "Revision",
"type": "long",
"doc": "Anzahl der zustandsaendernden Patches seit Anlage; vom Zusammenfuehrungsdienst gesetzt."
},
{
"name": "LastEventId",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "EventId des zuletzt angewandten Patches; vom Zusammenfuehrungsdienst gesetzt."
},
{
"name": "ChangedByUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "UUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt.",
"default": null,
"references": "Employee"
},
{
"name": "ChangedAt",
"type": {
"type": "long",
"logicalType": "timestamp-millis"
},
"doc": "Zeitpunkt der Aenderung als UTC-Instant."
}
],
"aggregate": "Branch",
"label": "Filiale",
"topic": "branch.state",
"key": "BranchUuid",
"cleanupPolicy": "compact",
"partitions": 1,
"writers": [
"merge"
],
"readers": [
"centron",
"nexoware-erp"
]
}