# Путеводитель по стенду

Путеводитель объясняет, как данные поступают в хранилище, обрабатываются
и попадают в отчеты. В главах есть короткие примеры, которые можно выполнить
на запущенном стенде перед переходом к учебным заданиям.

## Порядок чтения

Сначала запустите стенд по [инструкции](../../README.md#быстрый-старт).
Затем читайте главы по порядку и выполняйте примеры из них.
Незнакомые термины можно найти в
[словаре понятий](../../CONTEXT.md), а подробности устройства —
в [технических справочниках](../architecture/). К ним достаточно обращаться
по мере необходимости. После путеводителя переходите к
[учебным заданиям](../labs/README.md).

## Карта хранилища

[Интерактивная карта](architecture-map.html) показывает путь данных через слои.
Gitea показывает HTML как текст. Откройте файл из своей копии репозитория
или скачайте его кнопкой «Raw» и откройте в браузере.
Сверяйтесь с картой при чтении главы «Хранилище и его слои».

## Содержание

### [Хранилище и его слои](storage-layers.md)

Как меняются данные при переходе из Kafka в слои STG, ODS, DDS и DM.
В конце главы вы посмотрите события, сессии и выручку с помощью SQL.

### [Генерация и обработка данных в Airflow](airflow-dags.md)

Какие даги создают новые данные, а какие обрабатывают их в хранилище.
Вы сравните содержимое витрин до и после обработки нового дня.

### [Мониторинг в Grafana](monitoring.md)

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

### [Отчеты в Superset](superset.md)

Как Superset строит графики по витринам. Вы сравните числа на готовом графике
с результатом SQL и узнаете, какие отчеты сохраняются при перезапуске стенда.

### [Генератор: откуда берутся данные](generator.md)

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