📖 Навигация вне дорожной сетки и азимут (Direct Mode)

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

• Что это такое? Навигация вне дорожной сетки (Direct/Manual Mode) решает проблему жесткости автоматических навигаторов. Когда велосипедист сталкивается с неоцифрованными лесополосами, бродами, паромными переправами или дикими полями, автопрокладка не может проложить путь и ведет в объезд. Этот инструмент позволяет прочертить прямую линию («по азимуту») через сложный участок, а затем продолжить автопрокладку по дорогам.
• Активация: Выбирается через выпадающий список профилей в левом верхнем углу (профиль Direct / иконка прямой стрелки) или включается тумблером Manual Mode (Ручной режим) на боковой панели планировщика.
• Физика интерфейса (Basic UI Physics):
  • Прямой сегмент маршрута: В отличие от извилистых дорожных линий, рисуется на карте как абсолютно прямая сплошная синяя линия между двумя опорными точками.
  • Оранжевый баннер-предупреждение: Появляется вверху карты при автоматическом переключении проблемных сегментов в режим Direct.
• 

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

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

Сценарий А: Гибридный маршрут (Road ➔ Direct ➔ Gravel)

• Действие пользователя: Построить 5 км по шоссе в профиле Road, затем переключить профиль на Direct, поставить точку на другом берегу реки у парома, переключить профиль на Gravel и поставить точку в лесу.
• Реакция системы (Магия): Первые 5 км проложены точно по извилистому асфальту. Через реку идет абсолютно прямая синяя линия. Лесной участок строится по грунтовым тропинкам. Все три куска объединены в один бесшовный маршрут.
• Физика процесса («Почему»): Состояние waypoints хранит признак профиля индивидуально для каждого интервала между точками. При рендеринге клиент отправляет на сервер запросы только для автодорожных интервалов, а прямые соединяет в памяти без внешних вызовов.
• 

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

Сценарий Б: Вычисление высот на прямых отрезках

• Действие пользователя: Прочертить прямую линию длиной 2 км в режиме Direct через глубокий овраг.
• Реакция системы (Магия): В боковой панели отображается честный график высот этого оврага (спуск, дно, крутой подъем), а набор высоты добавляется в суммарный счетчик поездки.
• Физика процесса («Почему»): Клиент разбивает прямую линию на мелкие шаги (дискретизация) и запрашивает значения высот из базы SRTM/DEM для каждой промежуточной координаты, формируя точный рельефный профиль даже при отсутствии дорог.
• 

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

Сценарий В: Автоматическое восстановление сети (Auto-Healing Snap)

• Действие пользователя: После рисования участка по азимуту переключиться обратно в режим Gravel и кликнуть на дорогу.
• Реакция системы (Магия): Линия от новой точки мгновенно притягивается к дорожной сети.
• Физика процесса («Почему»): Система сбрасывает флаг ручного режима для нового сегмента и возобновляет стандартные API-запросы маршрутизации от последней Direct-координаты.
• 

Подробная инструкция: Маршрут возобновляет автоматическое прилипание к тропинкам после окончания Direct-сегмента.

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

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

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