Verträge / ContractKindPatch
Vertragsart Patch
ContractKindPatch · com.nexoware.connect.events
- Aggregat
- ContractKind · State ContractKindState
- Topic
- contractkind.patch je Mandant mit Präfix, z. B.
<mandant>.contractkind.patch - Key
- ContractKindUuid
- Nachrichtenart
- Patch — ausdrückliche Teiländerungen, zusammengeführt vom Zusammenführungsdienst
- Schreiber
- c-entron Webservice (centron) , NEXOWARE.ERP (nexoware-erp)
- Retention
- 30 Tage
- Fassung
- Version 1 (neueste)
- Schema-ID
- 46
Vertragsentwurf: typisierte Teilaenderung fuer Vertragsart. Nur ChangedFields werden angewandt; null leert nur nullable State-Einheiten. Listen und Unterobjekte sind atomare Ersetzungen mit vollstaendigem Inhalt. Fachliche Freigabe und Regeln gekoppelter Werte sind offen; siehe docs/contracts/contractkind.md.
Fassungen
Felder
-
EventId ↗ extern: EventId uuidBeim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch.
-
ContractKindUuid Key uuidStabile, global eindeutige Identitaet der Vertragsart (Matching-Schluessel; zugleich Message-Key).
-
Mode enum(CHANGE|INITIAL_LOAD)
-
ChangedFields Liste string[]Explizite Maske der geaenderten Top-Level-Einheiten; keine Wildcards, Identitaets- oder Auditfelder. Listen und Records werden als Ganzes ersetzt.
-
Data ContractKindPatchData
4 Felder von
ContractKindPatchData-
Name optional stringDefault:
nullBezeichnung der Vertragsart (Quelle Bezeichnung); DB nullable. -
ShortSign optional stringDefault:
nullKurzzeichen der Vertragsart; DB nullable. -
Description optional stringDefault:
nullBeschreibung der Vertragsart (Quelle Beschreibung); DB nullable. -
State optional intDefault:
nullLWW-Statusfeld (Quelle Status: 1 = aktiv, sonst deaktiviert/geloescht - die Quelle filtert aktiv per Status == 1). Deaktivierung reist als Voll-Snapshot, kein Tombstone; DB nullable.
-
-
Default:
nullUUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt. -
ChangedAt timestampZeitpunkt der Aenderung als UTC-Instant.
Referenziert von
Rohfassung
Schema dieser Fassung (Avro)
{
"type": "record",
"name": "ContractKindPatch",
"namespace": "com.nexoware.connect.events",
"doc": "Vertragsentwurf: typisierte Teilaenderung fuer Vertragsart. Nur ChangedFields werden angewandt; null leert nur nullable State-Einheiten. Listen und Unterobjekte sind atomare Ersetzungen mit vollstaendigem Inhalt. Fachliche Freigabe und Regeln gekoppelter Werte sind offen; siehe docs/contracts/contractkind.md.",
"fields": [
{
"name": "EventId",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Beim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch."
},
{
"name": "ContractKindUuid",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Stabile, global eindeutige Identitaet der Vertragsart (Matching-Schluessel; zugleich Message-Key)."
},
{
"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": "Explizite Maske der geaenderten Top-Level-Einheiten; keine Wildcards, Identitaets- oder Auditfelder. Listen und Records werden als Ganzes ersetzt."
},
{
"name": "Data",
"type": {
"type": "record",
"name": "ContractKindPatchData",
"doc": "Werte der maskierten Einheiten. null ausserhalb der Maske wird ignoriert; innerhalb der Maske entscheidet die Nullability im State.",
"fields": [
{
"name": "Name",
"type": [
"null",
"string"
],
"doc": "Bezeichnung der Vertragsart (Quelle Bezeichnung); DB nullable.",
"default": null
},
{
"name": "ShortSign",
"type": [
"null",
"string"
],
"doc": "Kurzzeichen der Vertragsart; DB nullable.",
"default": null
},
{
"name": "Description",
"type": [
"null",
"string"
],
"doc": "Beschreibung der Vertragsart (Quelle Beschreibung); DB nullable.",
"default": null
},
{
"name": "State",
"type": [
"null",
"int"
],
"doc": "LWW-Statusfeld (Quelle Status: 1 = aktiv, sonst deaktiviert/geloescht - die Quelle filtert aktiv per Status == 1). Deaktivierung reist als Voll-Snapshot, kein Tombstone; DB nullable.",
"default": null
}
]
}
},
{
"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": "ContractKind",
"label": "Vertragsart",
"topic": "contractkind.patch",
"key": "ContractKindUuid",
"cleanupPolicy": "delete",
"retentionMs": 2592000000,
"partitions": 1,
"writers": [
"centron",
"nexoware-erp"
],
"requiredOnCreate": []
}