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>
This commit is contained in:
+47
@@ -0,0 +1,47 @@
|
||||
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`.
|
||||
- Возможно, стоит расширить до общего прохода по читаемости дашборда (легенды и
|
||||
подсказки у других виджетов), но базово задача — про гео-карту.
|
||||
Reference in New Issue
Block a user