Files
clickstream-ch-kafka-supers…/.scratch/generator-model-time-startup-history/issues/10-dashboard-geo-map-readability.md
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

48 lines
3.3 KiB
Markdown

Status: needs-triage
# Гео-карта на дашборде нечитаема
## Parent
`.scratch/generator-model-time-startup-history/PRD.md` (раздел «Финальная ручная
приёмка»: если панелей не хватает для просмотра — отдельная задача на панель).
## Что нашли
На финальной ручной приёмке (шаг 2 спеки) виджет «🗺️ Geography Map» показывает
что-то, но прочитать нельзя:
- нет всплывающих подсказок (tooltip) — навёл на страну, значения не видно;
- нет легенды и подписи шкалы — непонятно, что кодирует цвет и в каких единицах;
- цветовая шкала неочевидна — подсвечено мало стран, остальное пусто.
Виз отрисовывается, но смысл непрозрачен: нельзя сказать, что именно он показывает.
## Две разные причины (не путать)
1. **Читаемость визуализации (эта задача).** Настройка чарта: включить tooltip,
добавить легенду и подпись метрики/единиц, выбрать понятную цветовую шкалу,
при необходимости — заменить мировую choropleth на более читаемую форму
(например, топ-N стран баром), раз распределение сильно разрежено.
2. **Перекос гео-данных (отдельно, ADR-0006).** Сама гео-фактура берётся из
статического сида (`geo_by_click_id`) с перекошенным распределением стран. Это
«временная опора на сид» до синтеза фактуры — лечится не настройкой чарта, а
генерацией гео. Здесь не решаем, только отмечаем как смежную причину.
## Acceptance criteria
- [ ] У гео-виза есть tooltip со значением по стране.
- [ ] Есть легенда и подпись: какая метрика и в каких единицах кодируется цветом.
- [ ] Цветовая шкала читаема на текущем (разреженном) распределении, либо выбран
более подходящий тип визуализации.
- [ ] Зафиксировано, что перекос распределения стран — это вопрос гео-фактуры
(ADR-0006), а не настройки чарта.
## Notes
- Всплыло на просмотре дашборда на данных генерации (2 суток backfill).
- Смежные документы: `superset/create_dashboard.py` (определение чарта),
`docs/SUPERSET_DASHBOARD.md`.
- Возможно, стоит расширить до общего прохода по читаемости дашборда (легенды и
подсказки у других виджетов), но базово задача — про гео-карту.