docs(orders): документация перестроена вокруг текущей модели

- Зачем:
  - описание вело нового читателя через историю исправления вместо действующего
    контракта слоёв.
- Что:
  - прямо описаны версия заказа, границы пакетного приёма и расчёт окна DDS.
  - ответственность ODS, DDS и конвейера разделена без ссылок на прежние
    ошибки как на основной довод.
  - исторический вывод исследования помечен до устаревшего абзаца, а ссылки
    ведут к отдельным решениям и контрактам.
- Проверка:
  - make lint.
  - make config-test.
This commit is contained in:
ddadmin committed 2026-08-26 18:47:22 +03:00
1 parent a82c75705d
commit a9cead2974
6 files changed
+68 -74

No files matched your search

+8 -8
View File
@@ -65,15 +65,15 @@ ODS: это единственный устойчивый ключ сущнос
одинаковы у всех строк дня и отвечают на вопрос «каким запуском и когда
собран этот день».
Ярлыки ODS — `snapshot_date`, `_load_id` приёма, `_load_ts` прибытия — в
модель не переезжают. Лгать они перестали: колонкой версии в ODS стала дата
слепка, и у выжившей строки она равна последнему слепку, в котором заказ был
([ADR 0014](../../adr/0014-order-version-snapshot-date.md)). Довод стал проще:
читателя у этих колонок здесь нет — модель отвечает на вопрос «что сейчас
известно о заказе», а не «когда его показывал источник». Отсюда правило слоя:
Ярлыки ODS (`snapshot_date`, `_load_id` приёма, `_load_ts` прибытия) в модель
не переезжают. Они описывают наблюдение и доставку строки в ODS. Модель DDS
хранит текущее деловое состояние заказа. В ODS `snapshot_date` задаёт версию и
называет последний слепок, в котором источник показал заказ
([ADR 0014](../../adr/0014-order-version-snapshot-date.md)). Дату
наблюдения и координаты доставки читатель спрашивает у ODS по
`order_id`. Правило слоя:
**служебные колонки — координаты собственной загрузки слоя; чужие координаты
спрашиваются у их слоя по ключу сущности**. Этим закрыто наследство #85:
читатель у чужих ярлыков выше ODS не нашёлся и при названных читателях модели.
спрашиваются у их слоя по ключу сущности**.
Происшествие качества данных расследуется цепочкой, где каждый шаг
спрашивает свой слой на его языке: по `_load_id` строки DDS видно, какой