docs(handbook): четыре главы путеводителя — Airflow, мониторинг, Superset, генератор #221

2026-09-03T00:14:48+03:00

ddmitry commented

2026-09-03 00:14:48 +03:00

Closes #220

Четыре главы путеводителя docs/handbook/: потоки Airflow, мониторинг, Superset, генератор. Форма — как у главы о хранилище; сквозная линия трех глав — ход мира на день D везет слепок заказов дня D−1, поэтому выручка всегда на день позади кликстрима. README путеводителя ведет заголовками в главы, заглушки убраны; «Куда дальше» главы о хранилище ведет прямо в главу об Airflow.

Проверка: три SELECT из глав прогнаны на живом стенде от analyst; скрипт проверки ссылок и запретных слов из тикета пуст. Постановка отревьюена Opus (18 находок внесены). Проза — Sol, саморевью 4/4, два слепых ревью Opus (факты; проза через ai-text-lint и оптику литературного русского): 25 находок внесены, 1 отклонена с доводом, хвосты перепроверок закрыты финальным проходом. Глава об Airflow — 113 строк при лимите 110: три строки добавил перенос до 80 знаков, содержание не росло.

🤖 Generated with Claude Code

Closes #220 Четыре главы путеводителя `docs/handbook/`: потоки Airflow, мониторинг, Superset, генератор. Форма — как у главы о хранилище; сквозная линия трех глав — ход мира на день D везет слепок заказов дня D−1, поэтому выручка всегда на день позади кликстрима. README путеводителя ведет заголовками в главы, заглушки убраны; «Куда дальше» главы о хранилище ведет прямо в главу об Airflow. Проверка: три SELECT из глав прогнаны на живом стенде от `analyst`; скрипт проверки ссылок и запретных слов из тикета пуст. Постановка отревьюена Opus (18 находок внесены). Проза — Sol, саморевью 4/4, два слепых ревью Opus (факты; проза через ai-text-lint и оптику литературного русского): 25 находок внесены, 1 отклонена с доводом, хвосты перепроверок закрыты финальным проходом. Глава об Airflow — 113 строк при лимите 110: три строки добавил перенос до 80 знаков, содержание не росло. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

ddmitry added 1 commit 2026-09-03 00:14:50 +03:00

docs(handbook): написаны четыре главы путеводителя ac21399fe4

Зачем: после главы о хранилище путеводитель обещал еще четыре главы, а
вместо них стояли заглушки «Пока главы нет…». Без них читатель не видит,
кто двигает мир и раскладывает данные по слоям, куда смотреть в Grafana,
как витрина становится графиком и откуда берутся данные.

Что: docs/handbook/airflow-dags.md, monitoring.md, superset.md,
generator.md — по скелетам тикета #220, форма — как у главы о хранилище.
Сквозная линия трех глав: ход мира на день D везет слепок заказов дня D−1,
поэтому выручка всегда на день позади кликстрима. README путеводителя
ведет заголовками в файлы глав, заглушки убраны; «Куда дальше» главы о
хранилище ведет прямо в главу об Airflow.

Проверка: три SELECT из глав прогнаны на живом стенде от analyst — трафик
получил сыгранный день, выручка только предыдущий, счетчики первых восьми
дней совпали с паспортом мира. Скрипт проверки ссылок и запретных слов из
тикета пуст. Постановка отревьюена Opus (18 находок внесены); главы прошли
саморевью Sol и два слепых ревью Opus — факты и проза (ai-text-lint плюс
оптика литературного русского): 25 находок внесены, 1 отклонена.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

ddmitry referenced this pull request

2026-09-03 00:14:51 +03:00

Главы путеводителя: потоки Airflow, мониторинг, Superset, генератор #220

ddmitry referenced this pull request

2026-09-03 00:14:53 +03:00

Реализация учебной программы: документация стенда и ТЗ лаб #206

ddmitry added 1 commit 2026-09-03 09:00:43 +03:00

docs(handbook): четыре главы переписаны живым русским 043d1c1382

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

Что: в четырех главах олицетворения заменены прямыми формулировками,
«позиция мира» и «шаговый даг» раскрыты через world_position и имена
дагов, паспорт мира описан по составу и назначению, окно слепка
заказов объяснено словами, режимы генератора и правило импорта
Superset сказаны прямо. Тире и стрелки оставлены: это домашний стиль.

Проверка: проверки тикета #220 на битые ссылки и запретные слова
пусты, строки прозы не длиннее 80 знаков, git diff --check чист.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

ddmitry merged commit 4995628f2a into main

2026-09-03 09:03:55 +03:00

ddmitry deleted branch 220-handbook-chapters

2026-09-03 09:03:56 +03:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: ddmitry/clickstream-data-platform#221