Зачем: README служил складом для двух зон без своих справочников — «службы и доступ» и «мир и его пульт». Раскладка принята резолюцией #211: README остается лицом, устройство живет в docs/architecture/. Что: новые docs/architecture/stand.md («Стенд: службы, доступ, настройка», доводы — ADR 0001 и 0007) и docs/architecture/world.md («Мир и его пульт», доводы — ADR 0009 и 0013). Доводы смоука и описания целей make слиты в testing.md без повторов: фраза о check_containers_survived и абзац про config-test умерли как дубли. На месте каждого переехавшего раздела README — абзац со ссылкой, адреса и пароли интерфейсов остались. Путеводитель и README генератора ссылаются на world.md вместо якорей README. Переехавший текст не правился, только относительные ссылки. Проверка: скрипт ссылок из тикета — пустой вывод; make config-test — ЗЕЛЁНО; подиффовая сверка переехавших диапазонов с README@2588515 — без расхождений (слепое ревью); в новой прозе нет «ё». Closes #212 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014QBCtU38qSHg5DvgtnKXcW
50 lines
3.1 KiB
Markdown
50 lines
3.1 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).
|