docs(warehouse): упрощены объяснения витрин, сессий и пересчета #253

Merged
ddmitry merged 2 commits from issue-249-warehouse-docs into main 2026-09-13 22:22:42 +03:00
Owner

Справочники и SQL-примеры ступеней 1–4 объясняют, какую строку получает модель, как выбираются дни и как результат записывается в таблицы. Расчет сначала заполняет промежуточную таблицу, пока читатели видят прежние данные. Затем ее готовые дневные разделы заменяют разделы основной таблицы.

Уточнены ограничения: поиск пропущенных дней не обнаруживает потерю части строк; замена атомарна на отдельном шарде; выбор страниц и UTM при равном времени не учитывает event_id.

Изменены четыре справочника, комментарии шести SQL-файлов и пояснения в dds_transform и dm_transform. Исполняемый код, лабораторные, handbook, исторические разделы и состояние стенда сохранены. Выполнены вычитка понятности и проход на сокращение.

Проверено: make lint; git diff --check; локальные Markdown-ссылки и якоря; совпадение SQL без комментариев и AST обоих дагов без строк документации с исходной основной веткой. Пересборка данных не требовалась.

Closes #249

Задача: #249

Справочники и SQL-примеры ступеней 1–4 объясняют, какую строку получает модель, как выбираются дни и как результат записывается в таблицы. Расчет сначала заполняет промежуточную таблицу, пока читатели видят прежние данные. Затем ее готовые дневные разделы заменяют разделы основной таблицы. Уточнены ограничения: поиск пропущенных дней не обнаруживает потерю части строк; замена атомарна на отдельном шарде; выбор страниц и UTM при равном времени не учитывает event_id. Изменены четыре справочника, комментарии шести SQL-файлов и пояснения в dds_transform и dm_transform. Исполняемый код, лабораторные, handbook, исторические разделы и состояние стенда сохранены. Выполнены вычитка понятности и проход на сокращение. Проверено: make lint; git diff --check; локальные Markdown-ссылки и якоря; совпадение SQL без комментариев и AST обоих дагов без строк документации с исходной основной веткой. Пересборка данных не требовалась. Closes #249 Задача: https://git.dementev.space/ddmitry/clickstream-data-platform/issues/249
ddmitry added 1 commit 2026-09-13 21:34:07 +03:00
Зачем: читателю ступеней 1–4 нужно проследить выбор дней, расчет строки
и публикацию результата без расшифровки метафор.

Что: согласованы справочники DM, сессий, ETL и два раздела хранилища
с комментариями шести SQL-примеров. Уточнены ограничения повторного
запуска и выбора атрибутов при равном времени событий.

Проверка: make lint, git diff --check, локальные Markdown-ссылки и якоря.
SQL без комментариев совпадает; AST Python без строк документации совпадает.
Исторические разделы и материалы вне границ задачи сохранены.

Refs: #249
ddmitry added 1 commit 2026-09-13 22:16:42 +03:00
Зачем: выражения «собираются в донор» и «публикуются дни» требовали
знать устройство конвейера до чтения объяснения.

Что: описаны назначение промежуточных таблиц и последовательность
расчета, записи и замены разделов. Перечитаны остальные объяснения:
выбор дней, разворачивание позиций заказа, проверка сессий и повтор запуска.

Проверка: make lint, git diff --check, локальные ссылки и якоря.
SQL без комментариев и AST обоих дагов без строк документации не изменились.

Refs: #249
ddmitry merged commit 83434102d5 into main 2026-09-13 22:22:42 +03:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ddmitry/clickstream-data-platform#253