ddmitry/clickstream-ch-kafka-superset-demo

Files

T

ddadminandClaude Opus 4.8 d7f02fd700 docs(generator): зафиксировано независимое ревью и задачи на потом

- Зачем:
  - после coordinator-loop нужно независимое ревью результатов модельного
    времени и стартовой истории; пропущенный внешний review gate после задачи 5
    закрыт другой родословной.
- Что:
  - добавлен verification-handoff: что проверено независимо, дефект стыка
    (issue 09) и открытые пробелы (×K, crash recovery, коридоры мат-спеки,
    воспроизводимость, review gate задачи 3).
  - заведены issues 08 (портативный артефакт + runbook + идеи интерфейса),
    09 (баг браузерной фактуры на стыке), 10 (читаемость гео-карты).
  - в docs/course/PRD.md §7 — открытый вопрос «генератор как скрытая
    инфраструктура vs отдельный урок».
- Проверка:
  - git show --stat HEAD
  - чтение .scratch/handoffs/2026-06-14-generator-model-time-verification-review.md

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-14 23:03:08 +03:00

3.3 KiB

Raw Blame History

Status: needs-triage

Гео-карта на дашборде нечитаема

Parent

.scratch/generator-model-time-startup-history/PRD.md (раздел «Финальная ручная приёмка»: если панелей не хватает для просмотра — отдельная задача на панель).

Что нашли

На финальной ручной приёмке (шаг 2 спеки) виджет «🗺️ Geography Map» показывает что-то, но прочитать нельзя:

нет всплывающих подсказок (tooltip) — навёл на страну, значения не видно;
нет легенды и подписи шкалы — непонятно, что кодирует цвет и в каких единицах;
цветовая шкала неочевидна — подсвечено мало стран, остальное пусто.

Виз отрисовывается, но смысл непрозрачен: нельзя сказать, что именно он показывает.

Две разные причины (не путать)

Читаемость визуализации (эта задача). Настройка чарта: включить tooltip, добавить легенду и подпись метрики/единиц, выбрать понятную цветовую шкалу, при необходимости — заменить мировую choropleth на более читаемую форму (например, топ-N стран баром), раз распределение сильно разрежено.
Перекос гео-данных (отдельно, ADR-0006). Сама гео-фактура берётся из статического сида (geo_by_click_id) с перекошенным распределением стран. Это «временная опора на сид» до синтеза фактуры — лечится не настройкой чарта, а генерацией гео. Здесь не решаем, только отмечаем как смежную причину.

Acceptance criteria

У гео-виза есть tooltip со значением по стране.
Есть легенда и подпись: какая метрика и в каких единицах кодируется цветом.
Цветовая шкала читаема на текущем (разреженном) распределении, либо выбран более подходящий тип визуализации.
Зафиксировано, что перекос распределения стран — это вопрос гео-фактуры (ADR-0006), а не настройки чарта.

Notes

Всплыло на просмотре дашборда на данных генерации (2 суток backfill).
Смежные документы: superset/create_dashboard.py (определение чарта), docs/SUPERSET_DASHBOARD.md.
Возможно, стоит расширить до общего прохода по читаемости дашборда (легенды и подсказки у других виджетов), но базово задача — про гео-карту.

3.3 KiB Raw Blame History