docs(ods): описана семантика snapshot_date после схлопывания версий

- Зачем:
  - проверка #137 показала: у заказа, не менявшегося несколько дней, версию
    выбирает только updated_at, и какая из одинаковых строк переживёт
    схлопывание — не обещано; snapshot_date выжившей строки означал не то,
    что обещала документация (у 86 заказов стартового мира выжил серединный
    день наблюдения).
- Что:
  - в docs/architecture/orders/ingestion.md записано: snapshot_date, _load_id
    и _load_ts выжившей строки — координаты одного из наблюдений версии, не
    обязательно последнего; допущение «уточнение поднимает updated_at»
    названо допущением с границей применимости.
  - та же оговорка — в комментарии DDL ods.order_rep.
- Проверка:
  - замеры на живом стенде: во всех 3034 парах строк с равным updated_at
    деловые поля совпали побайтово; монотонность updated_at по слепкам —
    без нарушений; ods.order_v сошёлся с эталоном argMax из сырья построчно.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
ddadminandClaude Opus 5 committed 2026-08-22 04:28:51 -04:00
1 parent 8c76a7a0d8
commit 94a1ffeee2
2 files changed
+23 -1

No files matched your search

+19
View File
@@ -106,6 +106,25 @@ JSON-объектом с точным набором ключей: `order_id`, `
- `_load_id` — какой запуск Airflow принял строку;
- `_load_ts` — когда строка приехала в хранилище.
У выжившей после схлопывания строки три последние координаты означают меньше,
чем кажется. Версию выбирает только `updated_at`; заказ, не менявшийся
несколько дней, приезжает в нескольких слепках одинаковыми деловыми полями, и
какая из этих строк переживёт схлопывание — не обещано. Поэтому её
`snapshot_date` — *один из* дней, когда источник показывал эту версию, не
обязательно последний; то же с `_load_id` и `_load_ts`. Замер 22 августа
2026 года (#137): у 86 заказов стартового мира выжил даже не крайний день, а
серединный. Вопрос «когда заказ наблюдался в последний раз» задаётся сырью STG,
пока его не съел срок жизни, — а не одной строке ODS.
Вся схема версий стоит на одном свойстве источника: уточнение заказа поднимает
`updated_at`. Наш генератор моделирует источник с триггерной меткой и это
свойство гарантирует; замеры 22 августа 2026 года его подтвердили — во всех
парах строк с равным `updated_at` деловые поля совпали побайтово, а по слепкам
метка не убывала ни разу. Это допущение, а не закон природы: источник, умеющий
уточнить строку тихо — правка мимо приложения, миграция, ручной `UPDATE`, —
эту схему ломает, и тогда версии по метке времени уже не хватает, нужна сверка
самих полей (в терминах dbt snapshots — стратегия `check` вместо `timestamp`).
Обычное чтение `_dist` показывает физически сохранившиеся версии и нужно для
диагностики. Их число зависит от фоновых слияний: ODS не служит архивом истории.
`ods.order_v` сохраняет те же источник-ориентированные поля без обогащения