- Зачем:
- после 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>
48 lines
3.3 KiB
Markdown
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`.
|
|
- Возможно, стоит расширить до общего прохода по читаемости дашборда (легенды и
|
|
подсказки у других виджетов), но базово задача — про гео-карту.
|