Files
clickstream-data-platform/docs/labs/superset-dashboard.md
T
ddadmin 830efa7ef4 docs(labs): ТЗ ступени 2 «Свой график в Superset» и порядок программы
- Зачем:
  - программа лаб принята спекой, но индекс docs/labs/ показывал только
    пять витрин и дашборд; ступень 2 не имела ТЗ (#226).
- Что:
  - новое ТЗ docs/labs/superset-chart.md: один столбиковый график доли
    отказов по устройствам поверх dm.session_overview_v, метрика в датасете.
  - docs/labs/README.md: семь ступеней основной программы и пять разделов
    факультативов; правила пяти витрин помечены как правила ступени 1.
  - шапка docs/labs/superset-dashboard.md: факультатив раздела «Superset и BI».
- Проверка:
  - grep 'ё' и 'менти' по трем файлам молчат; скрипт ссылок из тикета
    печатает пусто; git diff --check чистый.

Closes #226
2026-09-03 17:12:37 -04:00

5.8 KiB

Свой дашборд в Superset

Чему учит: довести свои витрины до потребителя — завести в Superset датасеты поверх публичных представлений, подобрать графики под вопросы и собрать из них один связный экран.

Это факультатив раздела «Superset и BI». Его можно пройти после ступени 2, когда готовы витрины ступени 1.

Роль дашборда

Собери обзор трафика и поведения посетителей. Он должен отвечать на три вопроса: что происходило в магазине, какие страницы, устройства и рекламные каналы дали результат, были ли ошибки приема данных.

Стендовый дашборд «Бизнес-сюжеты» собран из готовых витрин. Свой дашборд собери из пяти витрин, которые ты построил в заданиях. Копировать раскладку стендового дашборда не нужно: выбери форму, в которой ответы читаются без пояснений рядом с экраном.

Свои объекты — отдельно

Не добавляй графики в стендовый дашборд и не правь его датасеты. При инициализации Superset импорт с --overwrite заменит ручные правки стендовых объектов файлами из репозитория. make up свой дашборд не стирает; срок жизни таких объектов описан в доке Superset, «Импорт при каждой инициализации».

Заведи отдельные датасеты и графики, собери из них свой дашборд. Назови его, например, «Мои витрины DM». Это то же правило, по которому DDL домашек лежит в sql/ddl/70-labs.sql: стендовые объекты уже есть, свои создаешь ты.

Датасеты

Заведи в подключении ClickHouse пять физических датасетов схемы dm:

  • events_enriched_v;
  • top_pages_daily_v;
  • session_overview_v;
  • dq_errors_daily_v;
  • utm_effectiveness_v.

Состав дашборда

Каждая из пяти витрин должна появиться хотя бы в одном графике. Точный тип графика выбери сам. На дашборде покажи следующее:

Витрина Что показать
events_enriched_v число событий по часу и типу события
top_pages_daily_v страницы с просмотрами, посетителями и добавлениями в корзину
session_overview_v сравнение устройств по визитам, отказам и визитам с покупкой
dq_errors_daily_v число ошибок по дню загрузки, источнику и классу
utm_effectiveness_v трафик, покупки и заявленную выручку по рекламным каналам

Для долей используй слагаемые из витрин. Например, доля отказов считается как сумма bounce_sessions, деленная на сумму sessions. Среднее по готовым долям для такого графика не подходит — урок задания 3 остается в силе.

Названия графиков, осей и показателей должны объяснять экран без чтения SQL.

Как проверить себя

Эта лаба проверяется глазами. У расположения панелей и понятных подписей нет счетного инварианта, поэтому задачи для нее в homework_check нет.

Открой список дашбордов и проверь:

  • «Бизнес-сюжеты» остался отдельным стендовым дашбордом;
  • твой дашборд открывается без ошибок и содержит график от каждого из пяти датасетов;
  • подписи, единицы измерения и легенды читаются без обращения к SQL;
  • прямой трафик не исчез из графика UTM, а заявленная выручка не выдана за серверную;
  • пустой график ошибок нормален, если в таблицах брака сейчас нет строк.

Последний проход сделай как читатель: найди на экране самый заметный канал, страницу и устройство, затем проверь, понятно ли из подписей, что именно сравнивается. Если ответ приходится угадывать, поправь график или его название.

Приемка

  • пять датасетов читают публичные представления витрин заданий 1–5;
  • создан отдельный дашборд, стендовые объекты не изменены;
  • каждая витрина представлена хотя бы одним графиком;
  • дашборд проверен глазами по разделу выше.