docs: согласованы руководства загрузок и учебный маршрут

Руководства STG/ODS/DDS/DM сверены с действующими SQL и DAG,
ожидания учебных заглушек связаны с ТЗ. Самопроверка заданий
отделена от проверок разработки и исторических планов.

Для dim_routes закреплено обновление описательных полей только
у открытых версий. SQL, DAG, DDL и настройки стенда не менялись.

Проверки: make lint; make test (4 passed, 14 skipped); карта;
292 локальные ссылки; маршрут чтения и карта в Chromium.
Живой ETL не запускался.

docs/design/naming_conventions.md

@@ -6,25 +6,24 @@
 
 ## Зачем этот документ
 
-Чтобы имена полей не «плыли» между слоями, DAG и SQL-скриптами:
-- студенты видят один и тот же словарь во всех задачах;
-- новые реализации (ODS/DDS/DM) не расходятся с тем, как уже учили на `dwh-modeling`;
-- ревью становится проще: сразу видно, где отклонение от стандарта.
+Этот справочник задает имена служебных полей. Состав колонок конкретной
+таблицы проверяйте по ее DDL, а требования к учебной загрузке - по
+[ТЗ](../assignment/analyst_spec.md).
 
 ## 1. Базовые правила
 
 - Имена колонок: `snake_case`, на английском.
 - Бизнес-ключи источника не переименовываем без необходимости (`book_ref`, `ticket_no`, `route_no`).
 - Булевы поля начинаются с `is_` (`is_outbound`, `is_boarded`).
-- Денежные/количественные поля называем явно (`total_amount`, `segment_amount`, `range_km`).
+- Денежные и количественные поля называем по смыслу (`total_amount`, `amount`, `range_km`).
 
 ## 2. Каноничные служебные поля
 
 | Поле | Тип (рекомендация) | Смысл | Где применять |
 |---|---|---|---|
-| `_load_id` | `TEXT NOT NULL` | Идентификатор загрузки/батча | STG/ODS (новые объекты), при необходимости DDS |
-| `_load_ts` | `TIMESTAMP NOT NULL` | Когда запись попала в слой | STG/ODS (новые объекты) |
-| `event_ts` | `TIMESTAMP` | Когда событие произошло в источнике (effective time) | ODS/DDS при событийной природе данных |
+| `_load_id` | `TEXT NOT NULL` | Идентификатор запуска или исходного STG-батча; зависит от слоя | STG, ODS, DDS и DM, кроме календаря |
+| `_load_ts` | `TIMESTAMP NOT NULL` | Метка загрузки; в транзакционных ODS сохраняется время STG | STG, ODS, DDS и DM, кроме календаря |
+| `event_ts` | `TIMESTAMP` | Опорное время источника или получения снимка | Все таблицы STG и транзакционные ODS |
 | `created_at` | `TIMESTAMP NOT NULL` | Когда строка создана в таблице слоя | DDS/DM, где есть lifecycle строки |
 | `updated_at` | `TIMESTAMP NOT NULL` | Когда строка обновлена в таблице слоя | DDS/DM, где есть UPDATE |
 | `valid_from` | `DATE NOT NULL` (базовый трек) | Начало действия версии SCD2 | DDS SCD2 |
@@ -35,26 +34,42 @@
 
 - Бизнес-ключ измерения: суффикс `_bk` (`customer_bk`, `airport_bk`).
 - Суррогатный ключ измерения: суффикс `_sk` (`customer_sk`, `airport_sk`).
+- В существующих таблицах есть бизнес-ключи без `_bk`: `passenger_id`
+  у пассажиров, `fare_conditions` у тарифов, `date_actual` у календаря.
+  Используйте имена из DDL и ТЗ; переименовывать их в задании не нужно.
 
 ## 4. Правило времени (важно для обучения)
 
-- `event_ts` (effective time) и `_load_ts` (load time) — разные сущности, не смешиваем.
-- Если `event_ts` отсутствует в источнике, используем `_load_ts` как fallback и явно документируем это в SQL/доке.
-- Для snapshot-справочников (airports, airplanes, routes, seats) в STG нет бизнес-события с точным временем: `event_ts` заполняется через `now()` при загрузке. Это намеренно и задокументировано в каждом load-скрипте.
+- В STG `event_ts` задает опору инкремента: `book_date` у бронирований,
+  билетов, сегментов и посадочных талонов; `scheduled_departure` у рейсов.
+  Например, у талона это дата бронирования, а не `boarding_time`.
+- У снимков `airports`, `airplanes`, `routes`, `seats` в STG
+  `event_ts = now()`: точного времени изменения записи в источнике здесь нет.
+- `_load_ts` относится к загрузке. Какой именно слой ее поставил, указано ниже.
+  Правила отбора строк описаны в руководствах [STG](../bookings_to_gp_stage.md)
+  и [ODS](../bookings_to_gp_ods.md).
 
 ## 5. Применение по слоям
 
 ### STG
 
-- Используем канон `_load_id`, `_load_ts`, `event_ts` для всех таблиц.
+- Все таблицы содержат `_load_id = run_id` запуска STG, `_load_ts = now()`
+  и `event_ts` по правилам выше.
 
 ### ODS
 
-- Используем канон `_load_id`, `_load_ts`, `event_ts`.
-- Базовый эталон ODS в этом стенде: SCD Type 1 (current state + UPSERT).
+- Снимки `airports`, `airplanes`, `routes`, `seats`: `_load_id` выбранного
+  STG-батча, `_load_ts = now()`, без `event_ts`. Загрузка заменяет снимок целиком.
+- Транзакционные таблицы: `_load_id`, `_load_ts` и `event_ts` переносятся из STG.
+  Сохраненная `_load_ts` служит границей инкремента для `UPDATE + INSERT`.
 
-### DDS
+### DDS и DM
 
+- `_load_id` измененной или вставленной строки относится к текущему запуску
+  своего слоя, `_load_ts` фиксирует время записи.
+- Календарь статический: у `dim_calendar` нет меток загрузки.
+- `created_at` и `updated_at` используем там, где они предусмотрены DDL.
+  Например, у факта и полностью пересчитываемой `route_performance` их нет.
 - Для SCD2 используем:
   - `valid_from`, `valid_to`, `hashdiff`, `created_at`, `updated_at`.
 - Интервалы считаем как `[valid_from, valid_to)`, current-версия: `valid_to IS NULL`.