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