Files
clickstream-data-platform/docs/handbook/README.md
T
ddadminandClaude Fable 5 46e82b5240 docs(handbook): написана глава «Хранилище и его слои»
- Зачем:
  - первая глава путеводителя: без нее читатель попадает из README сразу
    в справочники, минуя объяснение пути данных (тикет #218, карта #206).
- Что:
  - добавлена docs/handbook/storage-layers.md: путь STG → ODS → DDS → DM,
    правило чтения через _v, зона dic, таблица ключей соединения слоев
    и два SELECT для самостоятельной пробы.
  - в docs/handbook/README.md раздел «Будущие главы» стал «Главы»,
    аннотация первой главы ведет в ее файл.
- Проверка:
  - обе команды из раздела «Проверка» тикета #218 дают пустой вывод;
    оба SELECT прогнаны на живом стенде от пользователя analyst.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-02 16:15:16 -04:00

49 lines
3.1 KiB
Markdown

# Путеводитель по стенду
Если вы впервые видите стенд, начните отсюда. Путеводитель подскажет, на что
смотреть и в каком порядке, а за подробностями отправит в справочники. Так вы
разберетесь в устройстве, прежде чем браться за уроки.
## Как читать
Тропа такая: [словарь понятий](../../CONTEXT.md) → главы путеводителя →
[справочники `docs/architecture/`](../architecture/) →
[уроки](../labs/README.md).
Словарь не надо читать подряд. Возвращайтесь к нему за незнакомым словом.
Первая статья объясняет хранилище. Следом идет несколько статей об устройстве
генератора; они понадобятся нескоро.
## Главы
### [Хранилище и его слои](storage-layers.md)
От события в Kafka до витрины: глава разбирает путь через STG, ODS, DDS и DM
и показывает, за что отвечает каждый слой.
### Потоки Airflow и даги модельного времени
Шаговый даг играет модельный день, а дневной конвейер раскладывает данные по
слоям. Глава поможет увидеть их связь и роль каждого дага. Пока главы нет,
смотрите [справочник конвейера](../architecture/etl.md) и [справочник мира и
дагов времени](../architecture/world.md).
### Мониторинг: куда смотреть
Свежесть и поток данных, брак и отставание собраны на дашборде «Данные».
Глава научит находить нужную панель и разбирать ее показания. Пока главы
нет, смотрите [устройство мониторинга](../architecture/monitoring/README.md).
### Немного Superset
Глава покажет, как витрина становится графиком и где проходит граница между
своими объектами и теми, которые поднимает стенд. Пока главы нет, смотрите
[справочник Superset](../architecture/superset.md).
### Генератор: откуда берутся данные
Здесь генератор — источник данных, а не предмет изучения. Глава в общих
чертах объяснит, откуда берутся события и заказы и в каком виде их получает
хранилище. Пока главы нет, смотрите [`generator/`](../../generator/) и
[описание события кликстрима](../formats/clickstream-event.md).