fix(superset): заменена нечитаемая гео-карта

- Зачем:
  - гео-блок дашборда должен показывать понятную метрику, единицы и сравнение стран.
- Что:
  - legacy world_map заменён на столбцы Top Countries by Events с tooltip и легендой.
  - синхронизирован экспорт дашборда и добавлены контрактные тесты.
  - обновлены документы и урок Superset по новому гео-блоку.
- Проверка:
  - uv run --with pytest pytest tests/test_superset_dashboard_config.py.
  - uv run python -m py_compile superset/create_dashboard.py tests/test_superset_dashboard_config.py.
  - jq empty superset/dashboards/ecommerce_analytics.zip.json.
This commit is contained in:
2026-07-04 22:05:56 +03:00
parent 0f435d70fd
commit 0c80e2438e
5 changed files with 389 additions and 78 deletions
+12 -1
View File
@@ -67,7 +67,18 @@ KPI разложены в одну строку по 12-колоночной с
- **📱 Traffic by Device** — pie chart распределения по устройствам
#### География
- **🌍 Geography Map** — world map с распределением по странам
- **🌍 Top Countries by Events** — top-15 стран по количеству событий
(`COUNT(*)`, единицы — события, штуки). Столбцы заменили legacy world map:
на текущем разреженном распределении так видны страна, значение, порядок и
tooltip. Перекос стран приходит из гео-фактуры статического сида
`geo_by_click_id`; своя генерация гео описана как отдельный будущий шаг в
ADR-0006 и не лечится настройкой чарта.
> **Что проверили по Superset.** Через MCP Context7 проверили `/apache/superset`:
> legacy world map описан как отдельный legacy-плагин, а ECharts bar chart имеет
> штатные параметры `show_legend`, `rich_tooltip`, подписи осей и формат чисел.
> Поэтому для разреженной географии выбран top-N bar chart
> (`viz_type: echarts_timeseries_bar`), а не донастройка `world_map`.
#### Маркетинг
- **🔗 UTM Effectiveness Table** — таблица эффективности UTM-меток
+1 -1
View File
@@ -119,7 +119,7 @@ http://localhost:8088/superset/dashboard/ecommerce-analytics/
- KPI сверху: `Total Events`, `Unique Users`, `Avg Events/Visit`,
`Conversion to /confirmation`;
- динамика: `Events over Time`, `Traffic by Device`;
- география: `Geography Map`;
- география: `Top Countries by Events`;
- маркетинг: `UTM Effectiveness Table`, `Page Funnel`;
- прохождение строк по слоям: `Rows by Layer (event)`.