docs(labs): ТЗ факультатива «Добавь названия регионов в отчет» #246

New Issue

2026-09-07T23:41:44+03:00

ddmitry commented

2026-09-07 23:41:44 +03:00

Цель

Написать ТЗ факультативной лабы ветки «Тонкий анализ данных» (идея — #143):
читатель собирает свой словарь регионов по образцу каталога и обогащает им
отчет. Результатом лабы становится карта регионов России в Superset на своем
дашборде читателя.

Почему карта здесь, а не на стенде

Грилинг #200 отклонил карту на стендовом дашборде: плагин Country Map
кросс-фильтр не отдает, а ради фильтра по региону пришлось бы заводить регион
во всех витринах стенда. Доводы целиком — в
docs/adr/0018-superset-dashboard-scope.md. Отказ от стендового словаря
регионов записан раньше, резолюцией #132: он повторил бы урок dictGet
каталога вторым разом.

На своем дашборде читателю ничего из этого не мешает: витрина его, справочник
его, кросс-фильтрация не нужна. Карта становится наградой за собранный
справочник — видно, что новое измерение сразу дает новую форму подачи.

Что учесть автору ТЗ

Проверено на живом стенде 7 сентября 2026 года, Superset 6.1:

карта России лежит в поставке Superset, Mapbox и внешние ключи не нужны;
колонка с кодом региона задается полем «ISO 3166-2 Codes», сопоставление идет
по полю ISO в geojson;
в geojson 85 объектов: 83 региона России плюс Севастополь и Крым с
украинскими кодами;
Москва помечена там RU-MOS, а область — RU-MOW, то есть против стандарта.
Это готовый урок задания: ключ карты сверяется глазами, а не переписыванием
из стандарта;
16 городов стенда сворачиваются в 14 регионов, и больше половины сессий
приходится на один — карта честно показывает, что магазин региональный.

Границы

стендовые объекты и дерево infra/superset/import/ не трогать;
витрины стенда не менять: лаба стоит на витринах читателя.

Сначала прочитать

docs/specs/2026-09-01-labs-program.md, ветка «Тонкий анализ данных» — место
лабы в программе;
docs/adr/0018-superset-dashboard-scope.md — почему карты нет на стенде;
docs/labs/optional/superset-dashboard.md — форма факультатива;
docs/adr/0012-dictionary-home.md — где живут словари и как устроен каталог.

## Цель Написать ТЗ факультативной лабы ветки «Тонкий анализ данных» (идея — #143): читатель собирает свой словарь регионов по образцу каталога и обогащает им отчет. Результатом лабы становится карта регионов России в Superset на своем дашборде читателя. ## Почему карта здесь, а не на стенде Грилинг #200 отклонил карту на стендовом дашборде: плагин Country Map кросс-фильтр не отдает, а ради фильтра по региону пришлось бы заводить регион во всех витринах стенда. Доводы целиком — в `docs/adr/0018-superset-dashboard-scope.md`. Отказ от стендового словаря регионов записан раньше, резолюцией #132: он повторил бы урок `dictGet` каталога вторым разом. На своем дашборде читателю ничего из этого не мешает: витрина его, справочник его, кросс-фильтрация не нужна. Карта становится наградой за собранный справочник — видно, что новое измерение сразу дает новую форму подачи. ## Что учесть автору ТЗ Проверено на живом стенде 7 сентября 2026 года, Superset 6.1: - карта России лежит в поставке Superset, Mapbox и внешние ключи не нужны; - колонка с кодом региона задается полем «ISO 3166-2 Codes», сопоставление идет по полю `ISO` в geojson; - в geojson 85 объектов: 83 региона России плюс Севастополь и Крым с украинскими кодами; - Москва помечена там `RU-MOS`, а область — `RU-MOW`, то есть против стандарта. Это готовый урок задания: ключ карты сверяется глазами, а не переписыванием из стандарта; - 16 городов стенда сворачиваются в 14 регионов, и больше половины сессий приходится на один — карта честно показывает, что магазин региональный. ## Границы - стендовые объекты и дерево `infra/superset/import/` не трогать; - витрины стенда не менять: лаба стоит на витринах читателя. ## Сначала прочитать - `docs/specs/2026-09-01-labs-program.md`, ветка «Тонкий анализ данных» — место лабы в программе; - `docs/adr/0018-superset-dashboard-scope.md` — почему карты нет на стенде; - `docs/labs/optional/superset-dashboard.md` — форма факультатива; - `docs/adr/0012-dictionary-home.md` — где живут словари и как устроен каталог.

ddmitry added the needs-triage label 2026-09-07 23:41:44 +03:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: ddmitry/clickstream-data-platform#246