Files
clickstream-data-platform/docs/handbook
ddadminandClaude Fable 5.1 7108cd4af3 docs(readme): корневой README пересобран по четырем блокам
Зачем: README был складом сведений, осевших там, где писались. По
раскладке резолюции #211 он становится лицом репозитория: промо-блок,
«куда я попал», типовые действия, ссылки. Слово «менти» уходит из README
и путеводителя, хвосты #212 и #214 закрываются.

Что: промо-цитата со ссылкой на план обучения и ментора; шапка с
нейтральной адресацией и одной фразой о составе и пути данных; «Быстрый
старт» сжат до двух команд по решению владельца — проверки остаются
роботам, в README одна ссылка на карту проверок; разделы «Адреса и
пароли», «Сдвинуть мир вперед», «Вернуть мир к началу», «Выключить или
сбросить целиком», «Подключиться из DBeaver»; «Документация» называет все
семь справочников вложенным списком. Умерли «Статус», «Что здесь будет»,
«Чем отличается от предшественника» и три заголовка-якоря. В world.md
снята устаревшая фраза о «даге этапа 5», stand.md и ADR 0007 ведут на
новый раздел «Адреса и пароли», в путеводителе снято слово «менти».

Проверка: скрипт ссылок пуст, grep «менти» по README и путеводителю пуст,
make config-test зеленый. Саморевью Sol 1/1; слепое ревью Opus — 0
блокеров, 2 minor, 3 nit, все закрыты; вычитка прозы ai-text-lint и
оптикой литературного русского — 15 находок, 9 внесены, 6 отклонены как
слова владельца и термины.

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

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

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

Как читать

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

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

Будущие главы

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

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

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

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

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

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

Немного Superset

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

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

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