- Зачем:
- первая глава путеводителя: без нее читатель попадает из 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>
3.1 KiB
Путеводитель по стенду
Если вы впервые видите стенд, начните отсюда. Путеводитель подскажет, на что смотреть и в каком порядке, а за подробностями отправит в справочники. Так вы разберетесь в устройстве, прежде чем браться за уроки.
Как читать
Тропа такая: словарь понятий → главы путеводителя →
справочники docs/architecture/ →
уроки.
Словарь не надо читать подряд. Возвращайтесь к нему за незнакомым словом. Первая статья объясняет хранилище. Следом идет несколько статей об устройстве генератора; они понадобятся нескоро.
Главы
Хранилище и его слои
От события в Kafka до витрины: глава разбирает путь через STG, ODS, DDS и DM и показывает, за что отвечает каждый слой.
Потоки Airflow и даги модельного времени
Шаговый даг играет модельный день, а дневной конвейер раскладывает данные по слоям. Глава поможет увидеть их связь и роль каждого дага. Пока главы нет, смотрите справочник конвейера и справочник мира и дагов времени.
Мониторинг: куда смотреть
Свежесть и поток данных, брак и отставание собраны на дашборде «Данные». Глава научит находить нужную панель и разбирать ее показания. Пока главы нет, смотрите устройство мониторинга.
Немного Superset
Глава покажет, как витрина становится графиком и где проходит граница между своими объектами и теми, которые поднимает стенд. Пока главы нет, смотрите справочник Superset.
Генератор: откуда берутся данные
Здесь генератор — источник данных, а не предмет изучения. Глава в общих
чертах объяснит, откуда берутся события и заказы и в каком виде их получает
хранилище. Пока главы нет, смотрите generator/ и
описание события кликстрима.