Hub-Daten — Entwickler

Warum DTOs?

Der Server bekommt die Daten 1:1 so, wie die Lua-Seite sie aufbereitet. Ein einheitliches Format sorgt dafür, dass Server und Web App dieselbe Struktur erwarten können, unabhängig davon, welche EEP-Daten gerade gemeldet werden.

DTO-Konvention: CeTypes und Listen

Alle Daten werden in eine dreistufige Map-Struktur einsortiert:

ceType : string
  └─ dtoId : string | number
       └─ dto : table

ceType ist die stabile Typkennung des Datenbereichs, z.B. "ce.hub.TrainStatic" oder "ce.hub.Signal".
dtoId ist ein eindeutiger Schlüssel innerhalb des CeTypes, z.B. der Zugname oder die Signal-ID.
dto ist eine flache Tabelle mit serialisierbaren Werten — keine Funktionen, keine gemischten Schlüsseltypen.

Ablauf: Wie kommt ein DTO auf den Bus?

Ein *DataCollector liest den aktuellen Zustand aus EEP oder einer Registry.
Eine *DtoFactory wandelt den Zustand in ein DTO um.
Das DTO wird unter dem richtigen ceType und der richtigen dtoId einsortiert.
Der zugehörige *StatePublisher veröffentlicht Änderungen über DataChangeBus.fire*().

Vollständige DTO-Strukturen

Alle CeTypes und ihre DTO-Felder sind in DTO.md dokumentiert.

Informationen für Anwender: README.md