REFERENCE / DATA CONTRACT
Live-state contract
Не универсальная отраслeвая schema, а редакционная карточка инвариантов: какие поля помогают объяснить версию live-состояния, источник и свежесть.
ENTITYlive_statestatus: conceptual
event_idstring
Устойчивый предметный идентификатор события в canonical model.
versionmonotonic / comparable
Позволяет клиенту и downstream отличить новое состояние от старого.
source_event_timetimestamp
Когда факт произошёл или был датирован источником.
ingest_timetimestamp
Когда платформа приняла конкретную версию.
correctionflag/type
Явно сообщает, что версия исправляет или удаляет ранее опубликованный факт.
provenancesource + mapping
Сохраняет происхождение после нормализации и слияния провайдеров.
- старшая версия не должна заменяться младшей без явного rollback semantics;
- correction проходит тем же lineage, что и исходное событие;
- freshness считается по предметному timestamp, а не только по времени HTTP-ответа;
- source/provenance сохраняются после canonical mapping;
- replay не создаёт вторую логическую сущность там, где ожидается та же event/version lineage.