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

Зачем: после главы о хранилище путеводитель обещал еще четыре главы, а
вместо них стояли заглушки «Пока главы нет…». Без них читатель не видит,
кто двигает мир и раскладывает данные по слоям, куда смотреть в 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>
This commit is contained in:
ddadminandClaude Fable 5.1 committed 2026-09-02 17:14:43 -04:00
1 parent b15d5253ee
commit ac21399fe4
6 files changed
+306 -16

No files matched your search

+10 -15
View File
@@ -11,8 +11,8 @@
[уроки](../labs/README.md).
Словарь не надо читать подряд. Возвращайтесь к нему за незнакомым словом.
Первая статья объясняет хранилище. Следом идет несколько статей об устройстве
генератора; они понадобятся нескоро.
Первая статья словаря объясняет хранилище. Следом идет несколько статей об
устройстве генератора; они понадобятся нескоро.
## Главы
@@ -21,28 +21,23 @@
От события в Kafka до витрины: глава разбирает путь через STG, ODS, DDS и DM
и показывает, за что отвечает каждый слой.
### Потоки Airflow и даги модельного времени
### [Потоки Airflow и даги модельного времени](airflow-dags.md)
Шаговый даг играет модельный день, а дневной конвейер раскладывает данные по
слоям. Глава поможет увидеть их связь и роль каждого дага. Пока главы нет,
смотрите [справочник конвейера](../architecture/etl.md) и [справочник мира и
дагов времени](../architecture/world.md).
слоям. Глава поможет увидеть их связь и роль каждого дага.
### Мониторинг: куда смотреть
### [Мониторинг: куда смотреть](monitoring.md)
Свежесть и поток данных, брак и отставание собраны на дашборде «Данные».
Глава научит находить нужную панель и разбирать ее показания. Пока главы
нет, смотрите [устройство мониторинга](../architecture/monitoring/README.md).
Глава научит находить нужную панель и разбирать ее показания.
### Немного Superset
### [Немного Superset](superset.md)
Глава покажет, как витрина становится графиком и где проходит граница между
своими объектами и теми, которые поднимает стенд. Пока главы нет, смотрите
[справочник Superset](../architecture/superset.md).
своими объектами и теми, которые поднимает стенд.
### Генератор: откуда берутся данные
### [Генератор: откуда берутся данные](generator.md)
Здесь генератор — источник данных, а не предмет изучения. Глава в общих
чертах объяснит, откуда берутся события и заказы и в каком виде их получает
хранилище. Пока главы нет, смотрите [`generator/`](../../generator/) и
[описание события кликстрима](../formats/clickstream-event.md).
хранилище.