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:
1 parent
ac21399fe4
commit
043d1c1382
4 files changed
+110
-93
No files matched your search
+20
-15
@@ -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#стартовый-мир).
|
||||
|
||||
|
||||
Reference in new issue
Block a user