docs(handbook): четыре главы переписаны живым русским

Зачем: владелец прочел главы и нашел неестественные фразы: дашборды
«спрашивают», даги «двигают ось», заказ «ездит в слепках», Superset —
«витрины глазами», объекты «приезжают из файлов». Читателю такие
образы надо расшифровывать, а урок в них не прячется.

Что: в четырех главах олицетворения заменены прямыми формулировками,
«позиция мира» и «шаговый даг» раскрыты через world_position и имена
дагов, паспорт мира описан по составу и назначению, окно слепка
заказов объяснено словами, режимы генератора и правило импорта
Superset сказаны прямо. Тире и стрелки оставлены: это домашний стиль.

Проверка: проверки тикета #220 на битые ссылки и запретные слова
пусты, строки прозы не длиннее 80 знаков, git diff --check чист.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
ddadminandClaude Fable 5.1 committed 2026-09-03 02:00:37 -04:00
1 parent ac21399fe4
commit 043d1c1382
4 files changed
+110 -93

No files matched your search

+20 -15
View File
@@ -1,7 +1,8 @@
# Немного Superset
Superset — это витрины глазами. Он читает слой DM пользователем `bi`. На
дашборде стенда «Бизнес-сюжеты» три графика:
Superset показывает витрины слоя DM в виде графиков. К ClickHouse он
подключается пользователем `bi`. На дашборде стенда «Бизнес-сюжеты» три
графика:
| График | Витрина |
|---|---|
@@ -11,26 +12,30 @@ Superset — это витрины глазами. Он читает слой DM
## Как витрина становится графиком
Путь состоит из трех объектов: датасет → график → дашборд. Датасет описывает
витрину: он несет русские имена колонок и формат денег. График ссылается на эти
имена и задает способ показа. Дашборд собирает готовые графики на одном экране.
От витрины до экрана три объекта Superset: датасет → график → дашборд. Датасет
описывает витрину: задает русские имена колонок и формат денег. График
ссылается на эти имена и задает способ показа. Дашборд собирает готовые графики
на одном экране.
## Свое и стендовое
## Стендовые объекты и ваши
Стендовые объекты приезжают из файлов при каждом `make up`. Правка такого
датасета, графика или дашборда в интерфейсе живет до следующей инициализации, а
затем молча заменяется версией из репозитория.
Датасеты, графики и дашборд из поставки стенда лежат файлами в репозитории и
заново импортируются при каждом `make up`. Если поправить такой объект в
интерфейсе, правка проживет до следующего `make up`, а потом без предупреждения
заменится версией из файла.
Ваши объекты живут рядом в базе метаданных Superset. Они переживают `make up` и
`make rebuild-storage`. Только `make clean` стирает их вместе с остальным
постоянным состоянием стенда. Поэтому стендовые объекты оставляйте как есть, а
свои отчеты стройте рядом. Устройство импорта описано в [справочнике
Ваши собственные объекты хранятся в той же базе метаданных Superset, но импорт
их не трогает: они переживают и `make up`, и `make rebuild-storage`. Стирает их
только `make clean` вместе с остальным постоянным состоянием стенда. Поэтому
стендовые объекты оставляйте как есть, а свои отчеты стройте рядом. Устройство
импорта описано в [справочнике
Superset](../architecture/superset.md#импорт-при-каждой-инициализации).
## Почему края графиков не совпадают
Правый край выручки всегда на день позади кликстрима. Слепок заказов дня
приезжает со следующим ходом мира. Так устроен источник. Вы уже видели этот
Правый край графика выручки всегда на день позади графиков кликстрима. Слепок
заказов за день приходит только со следующим модельным днем. Так устроен
источник, а не витрина. Вы уже видели этот
сдвиг в [главе об Airflow](airflow-dags.md#посмотрите-сами). Начальное состояние
показано в разделе [«Стартовый мир»](../architecture/world.md#стартовый-мир).