ddadminandClaude Fable 5.1
ac21399fe4
Зачем: после главы о хранилище путеводитель обещал еще четыре главы, а вместо них стояли заглушки «Пока главы нет…». Без них читатель не видит, кто двигает мир и раскладывает данные по слоям, куда смотреть в 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>
58 lines
3.4 KiB
Markdown
58 lines
3.4 KiB
Markdown
# Немного 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).
|