📖 Построение маршрута по точкам (Route Building)

🧠 1. Анатомия инструмента и Логика движка (Tool Anatomy & Engine Logic)

• Что это такое? Построение маршрута по точкам — это ключевая функция BikeTrack V2, позволяющая велосипедисту быстро планировать поездки по дорогам и грунтовым тропам без необходимости ручной отрисовки каждого метра пути. Инструмент решает проблему прокладки оптимальной траектории с учетом дорожного покрытия и набора высоты.
• Активация: Инструмент активируется по умолчанию при открытии приложения. Также пользователь может переключать профили маршрутизации в левом верхнем углу интерфейса через выпадающее меню (Road / Gravel / MTB) или переключать режим Manual (Ручной режим) для построения прямых линий вне дорог.
• Физика интерфейса (Basic UI Physics):
  • Зеленый маркер с надписью "Start": Точка отправления маршрута (индекс 0).
  • Красный маркер с надписью "Finish": Конечная точка маршрута (последний индекс).
  • Синие круглые маркеры с номерами: Промежуточные опорные точки маршрута, определяющие его форму.
  • Сплошная темно-синяя линия: Текущий рассчитанный и подтвержденный маршрут, который "притягивается" к реальным дорогам.
  • Сетка километража (Черные точки с цифрами 1 km, 2 km...): Шкала расстояния вдоль линии.
• 

Подробная инструкция для Арт-директора: Сделать скриншот карты с активным проложенным маршрутом, содержащим зеленый маркер Start, красный маркер Finish и синюю линию пути.

🎬 2. Матрица сценариев (Все комбинации взаимодействия)

Сценарий А: Стандартная прокладка с притяжением к дорогам (Snapping Mode)

• Действие пользователя: Кликнуть левой кнопкой мыши в точке старта, затем кликнуть на перекрестке в паре километров дальше, и наконец кликнуть в конечной точке. Профиль маршрутизации установлен на Road.
• Реакция системы (Магия): На карте мгновенно появляются маркеры Start, промежуточный маркер и Finish, соединенные плавной синей линией, проложенной строго по асфальтированным дорогам. Боковая панель расширяется, показывая суммарную дистанцию, график высот и раскладку покрытия.
• Физика процесса («Почему»): Клиент отправляет координаты точек на Hono API (POST /api/routing/calculate), который обращается к движку BRouter. BRouter находит кратчайший путь по дорожной графовой сетке для выбранного профиля и возвращает GeoJSON LineString.
• 

Подробная инструкция: Сделать снимок экрана с проложенным асфальтовым маршрутом и открытой боковой панелью с графиком высот.

Сценарий Б: Внедорожное планирование (MTB Profile)

• Действие пользователя: Переключить профиль на MTB и кликнуть в лесной зоне.
• Реакция системы (Магия): Синяя линия маршрута перестраивается, сходя с асфальтированного шоссе и направляясь по лесным тропинкам и грунтовым дорогам, даже если этот путь длиннее. График покрытия в боковой панели показывает увеличение доли gravel и unpaved.
• Физика процесса («Почему»): BRouter использует другие весовые коэффициенты ребер графа, где вес лесных и грунтовых дорог существенно ниже, чем у скоростных асфальтированных трасс.
• 

Подробная инструкция: Зафиксировать экран с построенным MTB-маршрутом в лесу и детальным графиком высот под картой.

Сценарий В: Ручной режим прокладки (Manual Off-Grid)

• Действие пользователя: Включить тумблер Manual Mode на боковой панели и кликнуть по карте в глухой лесной зоне, где нет дорог.
• Реакция системы (Магия): Линия прокладывается строго по прямой (азимуту) от предыдущей точки до нового клика, полностью игнорируя дорожную сеть.
• Физика процесса («Почему»): Приложение отключает отправку запросов к BRouter для этого сегмента, соединяя координаты напрямую в памяти Zustand-хранилища usePlannerStore.
• 

Подробная инструкция: Снять карту в режиме Manual Mode с прямыми линиями маршрута, проходящими через ненанесенные на карту зоны.

🚨 3. Защита от дурака и Крайние случаи (QA Guide)

• Деструктивный сценарий: Попытка поставить опорную точку на остров посреди океана или в зону глубокого бездорожья без включенного ручного режима при активном профиле Road.
• Реакция UI: Система временно блокирует построение сложного пути, переключает проблемный сегмент в режим прямой линии (азимута) и выводит предупреждающее сообщение в интерфейсе.
• Точный текст ошибки (Toast): "🛡️ Маршрутизатор не смог найти дорогу для выбранного профиля. Сегмент построен по прямой линии."
• 

Подробная инструкция: Показать всплывающее диалоговое окно или тост с предупреждением об ошибке авто-маршрутизации при клике в воду.