Files
clickstream-data-platform/docs/handbook
ddadmin 3fa669a920 docs(handbook): добавлено описание соединений на карте
- Зачем:
  - читатель карты видит ключи переноса данных, не переходя к карточкам узлов.
- Что:
  - для 17 стрелок добавлено поле «Как соединяет», сверенное с SQL.
  - раздел выведен в карточке стрелки и пересобрана карта.
- Проверка:
  - uv run docs/handbook/architecture-map/render.py --check.
  - make lint.
  - make typecheck && make test в generator/.
2026-09-03 04:34:25 -04:00
..

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

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

Как читать

Тропа такая: словарь понятий → главы путеводителя → справочники docs/architecture/ → уроки.

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

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

Интерактивная карта показывает путь данных через слои. Gitea показывает HTML как текст. Откройте файл из своей копии репозитория или скачайте его кнопкой «Raw» и откройте в браузере. Держите карту рядом с главой «Хранилище и его слои».

Главы

Хранилище и его слои

От события в Kafka до витрины: глава разбирает путь через STG, ODS, DDS и DM и показывает, за что отвечает каждый слой.

Потоки Airflow и даги модельного времени

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

Мониторинг: куда смотреть

Свежесть и поток данных, брак и отставание собраны на дашборде «Данные». Глава научит находить нужную панель и разбирать ее показания.

Немного Superset

Глава покажет, как витрина становится графиком и где проходит граница между своими объектами и теми, которые поднимает стенд.

Генератор: откуда берутся данные

Здесь генератор — источник данных, а не предмет изучения. Глава в общих чертах объяснит, откуда берутся события и заказы и в каком виде их получает хранилище.