📖 Панель быстрого доступа (Тулбар HUD)

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

• Что это такое? Плавающая панель быстрого доступа (Route HUD) консолидирует основные действия планировщика BikeTrack: поиск, undo/redo, реверс, Out & Back, Round Trip, сохранение, импорт, экспорт и очистку текущего маршрута.
• Активация: Панель постоянно отображается в левом верхнем углу карты. Глобальный слушатель клавиатуры keydown активирует функции по системным сочетаниям (горячим клавишам).
• Физика интерфейса (Basic UI Physics):
  • opacity-50 (Полупрозрачность): Кнопка временно отключена (например, Undo, когда на карте нет точек, или Save для пустого трека).
  • Активная подсветка (Catppuccin Lavender background): Показывает выбранное действие или активное состояние маршрута.
  • Плавающий тултип (Tooltip): Черный полупрозрачный блок, всплывающий при наведении курсора, показывающий название инструмента и его горячую клавишу (например, Reverse (R)).
• 

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

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

Сценарий А: Разворот направления маршрута (Reverse Route)

• Действие пользователя: Нарисовать маршрут от Дома до Озера, затем нажать кнопку 🔄 Reverse на панели или нажать клавишу R на клавиатуре.
• Реакция системы (Магия): Маркеры Start и Finish мгновенно меняются местами на карте. Стрелки направления движения на синей линии разворачиваются в противоположную сторону. График высот внизу зеркально отражается по горизонтали.
• Физика процесса («Почему»): Метод reverseWaypoints в Zustand-хранилище usePlannerStore переворачивает массив waypoints задом наперед (waypoints.reverse()) и повторно запрашивает маршрутизацию с новыми параметрами, меняя направление движения.
• 

Подробная инструкция: Зеркально развернутый график высот после клика на кнопку Reverse.

Сценарий Б: Создание пути туда-обратно (Out & Back)

• Действие пользователя: Нарисовать путь длиной 10 км, нажать кнопку Out & Back (Туда-обратно) или нажать клавишу O на клавиатуре.
• Реакция системы (Магия): Длина маршрута в панели телеметрии мгновенно удваивается до 20 km. Точка финиша на карте возвращается в точку старта. График высот показывает сначала подъем, а затем симметричный спуск.
• Физика процесса («Почему»): Алгоритм берет существующий массив промежуточных точек, копирует его, переворачивает копию и пришивает ее в хвост исходного массива, автоматически замыкая путь обратно.
• 

Подробная инструкция: Замкнутый маршрут туда-обратно с точкой финиша, наложенной на точку старта.

Сценарий В: Автоматическое масштабирование (Fit Viewport)

• Действие пользователя: Проложить длинный маршрут на 100 км, вручную сильно приблизить карту на какой-то перекресток, потеряв из виду старт и финиш, затем нажать кнопку ⛶ Fit на панели или нажать клавишу F.
• Реакция системы (Магия): Карта плавно отдалится и центрируется таким образом, чтобы весь 100-километровый маршрут целиком идеально уместился на экране.
• Физика процесса («Почему»): Клиент вычисляет географические границы (Bounding Box) массива координат LineString и вызывает метод map.fitBounds(bounds, { padding: 50 }) библиотеки MapLibre GL.
• 

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

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

• Деструктивный сценарий: Случайный клик по reset/clear во время построения маршрута.
• Реакция UI: Действие должно быть очевидным и обратимым через историю, если состояние уже попало в undo stack.
• Точный текст ошибки (Toast): При развороте трека выводится тост: "Направление маршрута успешно изменено."