docs(handbook): написаны четыре главы путеводителя
Зачем: после главы о хранилище путеводитель обещал еще четыре главы, а вместо них стояли заглушки «Пока главы нет…». Без них читатель не видит, кто двигает мир и раскладывает данные по слоям, куда смотреть в Grafana, как витрина становится графиком и откуда берутся данные. Что: docs/handbook/airflow-dags.md, monitoring.md, superset.md, generator.md — по скелетам тикета #220, форма — как у главы о хранилище. Сквозная линия трех глав: ход мира на день D везет слепок заказов дня D−1, поэтому выручка всегда на день позади кликстрима. README путеводителя ведет заголовками в файлы глав, заглушки убраны; «Куда дальше» главы о хранилище ведет прямо в главу об Airflow. Проверка: три SELECT из глав прогнаны на живом стенде от analyst — трафик получил сыгранный день, выручка только предыдущий, счетчики первых восьми дней совпали с паспортом мира. Скрипт проверки ссылок и запретных слов из тикета пуст. Постановка отревьюена Opus (18 находок внесены); главы прошли саморевью Sol и два слепых ревью Opus — факты и проза (ai-text-lint плюс оптика литературного русского): 25 находок внесены, 1 отклонена. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
1 parent
b15d5253ee
commit
ac21399fe4
6 files changed
+306
-16
No files matched your search
@@ -0,0 +1,57 @@
|
||||
# Немного Superset
|
||||
|
||||
Superset — это витрины глазами. Он читает слой DM пользователем `bi`. На
|
||||
дашборде стенда «Бизнес-сюжеты» три графика:
|
||||
|
||||
| График | Витрина |
|
||||
|---|---|
|
||||
| «Выручка по дням и категориям» | `dm.revenue_daily_v` |
|
||||
| «Сверка purchase и заказов» | `dm.purchase_vs_orders_v` |
|
||||
| «Посетители и известные пользователи» | `dm.daily_traffic_v` |
|
||||
|
||||
## Как витрина становится графиком
|
||||
|
||||
Путь состоит из трех объектов: датасет → график → дашборд. Датасет описывает
|
||||
витрину: он несет русские имена колонок и формат денег. График ссылается на эти
|
||||
имена и задает способ показа. Дашборд собирает готовые графики на одном экране.
|
||||
|
||||
## Свое и стендовое
|
||||
|
||||
Стендовые объекты приезжают из файлов при каждом `make up`. Правка такого
|
||||
датасета, графика или дашборда в интерфейсе живет до следующей инициализации, а
|
||||
затем молча заменяется версией из репозитория.
|
||||
|
||||
Ваши объекты живут рядом в базе метаданных Superset. Они переживают `make up` и
|
||||
`make rebuild-storage`. Только `make clean` стирает их вместе с остальным
|
||||
постоянным состоянием стенда. Поэтому стендовые объекты оставляйте как есть, а
|
||||
свои отчеты стройте рядом. Устройство импорта описано в [справочнике
|
||||
Superset](../architecture/superset.md#импорт-при-каждой-инициализации).
|
||||
|
||||
## Почему края графиков не совпадают
|
||||
|
||||
Правый край выручки всегда на день позади кликстрима. Слепок заказов дня
|
||||
приезжает со следующим ходом мира. Так устроен источник. Вы уже видели этот
|
||||
сдвиг в [главе об Airflow](airflow-dags.md#посмотрите-сами). Начальное состояние
|
||||
показано в разделе [«Стартовый мир»](../architecture/world.md#стартовый-мир).
|
||||
|
||||
## Посмотрите сами
|
||||
|
||||
Откройте Superset по адресу из раздела [«Адреса и
|
||||
пароли»](../../README.md#адреса-и-пароли) и выберите дашборд «Бизнес-сюжеты».
|
||||
Затем откройте SQL Lab и выполните запрос:
|
||||
|
||||
```sql
|
||||
SELECT report_date, visitors, known_users
|
||||
FROM dm.daily_traffic_v
|
||||
ORDER BY report_date DESC
|
||||
LIMIT 7;
|
||||
```
|
||||
|
||||
Как построить свой отчет, рассказывают [учебные задания](../labs/README.md).
|
||||
|
||||
## Куда дальше
|
||||
|
||||
Устройство BI-зоны описано в [справочнике
|
||||
Superset](../architecture/superset.md), а состав витрин — в [справочнике
|
||||
DM](../architecture/dm.md). Следующая глава — [«Генератор: откуда берутся
|
||||
данные»](generator.md).
|
||||
Reference in new issue
Block a user