wiki/tasks/enduro-trails/BRD_SATELLITE_MODE.md

BRD: Режим спутниковой карты (Схема / Спутник)

Переключатель между векторной картой и спутниковым видом (как в Google Maps / Яндекс.Картах)

Статус: Analysis (ожидает работы Analyst)
Приоритет: Medium
Фаза: 5.5 (после terrain)
Инициатор: Слава
Дата создания: 2026-05-31

---

Контекст

Сейчас Enduro Trails использует полностью векторную карту на базе MapLibre GL JS с кастомными стилями:

• style.json (светлая тема)
• style-dark.json (тёмная тема)

Рельеф (terrain) реализован в фазе 5.4: гипсометрия + hillshade (SRTM 30м).

Пользователь хочет иметь возможность переключаться между схемой и спутником, как на популярных картах. Это особенно полезно для:

• Визуальной оценки рельефа и ландшафта перед поездкой
• Понимания, как выглядит местность «вживую»
• Планирования маршрутов в сложных районах

---

Цель

Реализовать переключатель режимов отображения карты:

• Схема — текущая векторная карта (с дорогами, POI, terrain)
• Спутник — растровый спутниковый слой (с возможностью гибридного отображения)

---

Требования (MVP)

1. Переключатель режимов в UI (toolbar, рядом с кнопкой 🏔️ рельефа)
2. Сохранение выбора пользователя в localStorage
3. Корректная работа переключения вместе с terrain (гипосометрия + hillshade)
4. Производительность: тайлы должны загружаться быстро, без деградации UX
5. Поддержка мобильных устройств

---

Исследовательские вопросы (для Analyst)

Analyst должен провести исследование и дать рекомендации по следующим направлениям:

1. Источники спутниковых тайлов

Источник	Покрытие РФ	Качество	Лицензия/Стоимость	Примечание
ESRI World Imagery	Хорошее	Хорошее	Free (attribution)	Самый популярный вариант для MapLibre
Яндекс.Спутник	Отличное (РФ)	Отличное	?	Нужно проверить API/тайлы
Maxar / DigitalGlobe	Отличное	Высокое	Платно	Дорого для open-source проекта
Sentinel Hub	Среднее	Среднее	Free tier	Низкое разрешение (~10м)
Mapbox Satellite	Хорошее	Хорошее	Платно	Требует Mapbox токен

Вопросы для Analyst:

• Какой источник оптимален для ЦФО + Чувашия по соотношению качество/скорость/стоимость?
• Есть ли ограничения на использование ESRI World Imagery в коммерческих/открытых проектах?
• Можно ли использовать Яндекс.Спутник без токена (как тайлы)?

2. Архитектура реализации

Вариант A: Отдельный satellite style

• Полностью новый style-satellite.json
• Плюсы: чистый контроль над слоями
• Минусы: дублирование стилей, сложнее поддерживать terrain

Вариант B: Raster overlay поверх текущего стиля

• Добавление raster source + layer в текущий стиль
• Плюсы: минимальные изменения, terrain работает «из коробки»
• Минусы: z-order слоёв нужно контролировать

Вариант C: Hybrid (спутник + дороги/подписи)

• Спутник как base layer
• Векторные дороги/подписи поверх с полупрозрачностью
• Плюсы: лучший UX (понимаешь и рельеф, и дороги)
• Минусы: сложнее в разработке, нужно два набора стилей

Вопросы для Analyst:

• Какой вариант рекомендуешь и почему?
• Какой подход лучше с точки зрения поддержки terrain (F-29)?

3. UX и поведение

• Какой формат переключателя использовать (сегмент, иконка, выпадающий список)?
• Нужно ли показывать подписи (населённые пункты, реки) в спутниковом режиме?
• Как переключение должно влиять на terrain (автоматически выключать/оставлять)?
• Нужна ли отдельная тёмная версия спутника (ночь)?
• Какой дефолтный режим при первом открытии карты?

4. Производительность и кэширование

• Тайлы спутника кэшировать на клиенте (browser cache) или через nginx?
• Есть ли лимиты на запросы у выбранного источника?
• Какое разрешение тайлов использовать (256 vs 512 px)?

5. Открытые вопросы для согласования со Славой

Analyst должен явно выделить вопросы, которые требуют решения от владельца продукта:

1. Чистый спутник или гибрид?
   Хочешь видеть просто снимки из космоса, или чтобы дороги и подписи тоже отображались поверх?

2. Приоритет качества vs скорости
   Готов ли жертвовать скоростью загрузки ради более детальных снимков (или наоборот)?

3. Интеграция с terrain
   При включении спутника terrain должен автоматически выключаться, или оставаться (и тогда гипсометрия будет «накладываться» на спутник)?

4. Яндекс или ESRI?
   Есть ли сильное предпочтение по источнику (российский vs международный)?

5. Тёмный режим для спутника
   Нужна ли «ночная» версия спутника, или достаточно текущей?

---

Результат работы Analyst'а

1. BRD_SATELLITE_MODE.md (обновлённый, с заполненными разделами)
2. Рекомендация по источнику + архитектуре (с обоснованием)
3. Список открытых вопросов с предлагаемыми вариантами ответов
4. (Опционально) Ссылки на примеры реализации в других проектах

---

Следующие шаги (после анализа)

1. Согласование BRD со Славой
2. Создание DEV_TASK (Architect + Developer)
3. Реализация переключателя и интеграция с terrain
4. Тестирование (в т.ч. на мобильных устройствах)
5. Деплой

---

Примечания

• Спутниковый режим не отменяет текущую векторную карту — это дополнительная опция.
• Кнопка 🏔️ (рельеф) должна продолжать работать в обоих режимах.
• При переключении на спутник маршруты и POI должны оставаться видимыми (или с возможностью скрыть).