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

New Issue

2026-09-13T20:32:37+03:00

ddmitry commented

2026-09-13 20:32:37 +03:00

Режим выполнения

Редактуру выполняет Codex самостоятельно, без субагентов. Рекомендуемый reasoning effort: medium. Словарь рекомендуется выполнить первым: его определения станут опорой для остальных материалов.

Чему учит

Читать пример построения витрины или сессий и понимать, какую строку он получает, какие дни обрабатывает и как публикует результат.

Работа

За один проход согласовать справочники и комментарии к примерам SQL, которые менти читает на ступенях 1–4. Здесь общий контекст: таблицы и представления, распределение данных, сборка сессий, временные таблицы и замена дневных разделов.

Основные файлы:

docs/architecture/dm.md: действующие модели витрин, ритм пересборки, раздел о самопроверке.
docs/architecture/dds/session.md: действующая модель, сборка и сверка с эталоном.
docs/architecture/etl.md: устройство конвейера, способы запуска, объем прогона, готовность источника и повторное выполнение.
docs/architecture/storage.md: только разделы «Имена объектов» и «Раскладка по шардам».
Комментарии в sql/dm/revenue_daily_{scope,rebuild,replace}.sql и sql/dds/session_{scope,rebuild,replace}.sql; пояснения в dags/dds_transform.py и dags/dm_transform.py, если без них объяснение расходится со справочником.

Заменять метафоры вроде «шов ему не нужен» и «чекан визита» объяснением конкретного действия. Оставить детали сопровождения и историю отклоненных решений за пределами прохода.

Критерии приемки

Понятно, чему соответствует строка каждой разбираемой модели и зачем выбранная форма хранения нужна задаче.
По справочнику и SQL можно проследить выбор дней, сборку результата и публикацию раздела; объяснения не противоречат друг другу.
Сохранены правила границ сессий, порядка событий, идентификатора сессии и выбора дней для пересчета.
Повторный запуск и готовность источников объяснены без обещаний, которых код не дает.
Исполняемый код и SQL не изменены; новых готовых решений лабораторных и обходов самостоятельной работы не добавлено.

Сначала прочитать

CONTEXT.md, docs/labs/README.md, задания ступеней 1–4, docs/handbook/storage-layers.md, docs/handbook/airflow-dags.md, затем перечисленные исходники.

Проверка

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

Общие границы

Это продолжение редактуры материалов для начинающего инженера данных. Образцы языка — корневой README, главы docs/handbook/ и задания docs/labs/. Писать простым русским языком; термины объяснять при первом употреблении. Не упрощать технический смысл и не подменять объяснение образными оборотами.

Уже вычитанные лабораторные, handbook и карту не переписывать. Исторические спеки, ADR и внутренние инструкции не входят в задачу. Перед приемкой сделать проход на сокращение: убрать повторы и пояснения, которые не помогают пройти учебную программу. Имена объектов, технические условия и полезные примеры сохранить.

## Режим выполнения Редактуру выполняет Codex самостоятельно, без субагентов. Рекомендуемый reasoning effort: `medium`. Словарь рекомендуется выполнить первым: его определения станут опорой для остальных материалов. ## Чему учит Читать пример построения витрины или сессий и понимать, какую строку он получает, какие дни обрабатывает и как публикует результат. ## Работа За один проход согласовать справочники и комментарии к примерам SQL, которые менти читает на ступенях 1–4. Здесь общий контекст: таблицы и представления, распределение данных, сборка сессий, временные таблицы и замена дневных разделов. Основные файлы: - `docs/architecture/dm.md`: действующие модели витрин, ритм пересборки, раздел о самопроверке. - `docs/architecture/dds/session.md`: действующая модель, сборка и сверка с эталоном. - `docs/architecture/etl.md`: устройство конвейера, способы запуска, объем прогона, готовность источника и повторное выполнение. - `docs/architecture/storage.md`: только разделы «Имена объектов» и «Раскладка по шардам». - Комментарии в `sql/dm/revenue_daily_{scope,rebuild,replace}.sql` и `sql/dds/session_{scope,rebuild,replace}.sql`; пояснения в `dags/dds_transform.py` и `dags/dm_transform.py`, если без них объяснение расходится со справочником. Заменять метафоры вроде «шов ему не нужен» и «чекан визита» объяснением конкретного действия. Оставить детали сопровождения и историю отклоненных решений за пределами прохода. ## Критерии приемки - [x] Понятно, чему соответствует строка каждой разбираемой модели и зачем выбранная форма хранения нужна задаче. - [x] По справочнику и SQL можно проследить выбор дней, сборку результата и публикацию раздела; объяснения не противоречат друг другу. - [x] Сохранены правила границ сессий, порядка событий, идентификатора сессии и выбора дней для пересчета. - [x] Повторный запуск и готовность источников объяснены без обещаний, которых код не дает. - [x] Исполняемый код и SQL не изменены; новых готовых решений лабораторных и обходов самостоятельной работы не добавлено. ## Сначала прочитать `CONTEXT.md`, `docs/labs/README.md`, задания ступеней 1–4, `docs/handbook/storage-layers.md`, `docs/handbook/airflow-dags.md`, затем перечисленные исходники. ## Проверка `git diff --check`; проверить Markdown-ссылки. Сравнить SQL до и после без комментариев. Если менялись Python-комментарии или строки документации, выполнить корневой `make lint` и проверить, что логика не изменилась. Запуск пересборки данных не требуется. ## Общие границы Это продолжение редактуры материалов для начинающего инженера данных. Образцы языка — корневой README, главы `docs/handbook/` и задания `docs/labs/`. Писать простым русским языком; термины объяснять при первом употреблении. Не упрощать технический смысл и не подменять объяснение образными оборотами. Уже вычитанные лабораторные, handbook и карту не переписывать. Исторические спеки, ADR и внутренние инструкции не входят в задачу. Перед приемкой сделать проход на сокращение: убрать повторы и пояснения, которые не помогают пройти учебную программу. Имена объектов, технические условия и полезные примеры сохранить.

ddmitry added the ready-for-agent label 2026-09-13 20:32:37 +03:00

ddmitry self-assigned this 2026-09-13 21:22:44 +03:00

ddmitry referenced this issue from a commit

2026-09-13 21:33:55 +03:00

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

ddmitry referenced a pull request that will close this issue

2026-09-13 21:34:06 +03:00

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

ddmitry referenced this issue from a commit

2026-09-13 22:16:42 +03:00

docs(warehouse): объяснены расчет строк и замена дневных разделов

ddmitry closed this issue