Зачем: после главы о хранилище путеводитель обещал еще четыре главы, а вместо них стояли заглушки «Пока главы нет…». Без них читатель не видит, кто двигает мир и раскладывает данные по слоям, куда смотреть в 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>
44 lines
2.6 KiB
Markdown
44 lines
2.6 KiB
Markdown
# Путеводитель по стенду
|
|
|
|
Если вы впервые видите стенд, начните отсюда. Путеводитель подскажет, на что
|
|
смотреть и в каком порядке, а за подробностями отправит в справочники. Так вы
|
|
разберетесь в устройстве, прежде чем браться за уроки.
|
|
|
|
## Как читать
|
|
|
|
Тропа такая: [словарь понятий](../../CONTEXT.md) → главы путеводителя →
|
|
[справочники `docs/architecture/`](../architecture/) →
|
|
[уроки](../labs/README.md).
|
|
|
|
Словарь не надо читать подряд. Возвращайтесь к нему за незнакомым словом.
|
|
Первая статья словаря объясняет хранилище. Следом идет несколько статей об
|
|
устройстве генератора; они понадобятся нескоро.
|
|
|
|
## Главы
|
|
|
|
### [Хранилище и его слои](storage-layers.md)
|
|
|
|
От события в Kafka до витрины: глава разбирает путь через STG, ODS, DDS и DM
|
|
и показывает, за что отвечает каждый слой.
|
|
|
|
### [Потоки Airflow и даги модельного времени](airflow-dags.md)
|
|
|
|
Шаговый даг играет модельный день, а дневной конвейер раскладывает данные по
|
|
слоям. Глава поможет увидеть их связь и роль каждого дага.
|
|
|
|
### [Мониторинг: куда смотреть](monitoring.md)
|
|
|
|
Свежесть и поток данных, брак и отставание собраны на дашборде «Данные».
|
|
Глава научит находить нужную панель и разбирать ее показания.
|
|
|
|
### [Немного Superset](superset.md)
|
|
|
|
Глава покажет, как витрина становится графиком и где проходит граница между
|
|
своими объектами и теми, которые поднимает стенд.
|
|
|
|
### [Генератор: откуда берутся данные](generator.md)
|
|
|
|
Здесь генератор — источник данных, а не предмет изучения. Глава в общих
|
|
чертах объяснит, откуда берутся события и заказы и в каком виде их получает
|
|
хранилище.
|