📖 Изменение формы трека перетаскиванием (Midpoint Drag & Drop)

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

• Что это такое? Функция интерактивного перетаскивания средних точек (rubber-banding) решает проблему жесткости построенного пути. Вместо того чтобы удалять опорные точки и ставить их заново для изменения траектории через красивый парк или сквер, пользователь может потянуть саму линию маршрута в сторону как резиновую ленту.
• Активация: Инструмент активируется автоматически при наведении курсора мыши на любой участок рассчитанной синей линии проложенного маршрута на карте.
• Физика интерфейса (Basic UI Physics):
  • Бирюзовая фантомная точка (Ghost Node): Полупрозрачный круглый маркер, появляющийся точно посередине сегмента под курсором мыши.
  • Тонкие пунктирные направляющие линии: Рисуются в реальном времени от соседних опорных точек до перетаскиваемого курсора во время движения мыши, показывая предварительную форму будущего пути.
  • Постоянный синий маркер с цифрой: Создается в точке отпускания кнопки мыши, заменяя фантомный маркер и фиксируя новую геометрию.
• 

Подробная инструкция для Арт-директора: Сделать снимок экрана карты в момент перетаскивания бирюзовой фантомной точки (ghost node) зажатым курсором мыши в сторону парковой зоны. Вокруг точки должны быть видны тонкие вспомогательные пунктирные линии, соединяющие ее с исходными точками Старта и Финиша.

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

Сценарий А: Перетаскивание на параллельную улицу (Snapping Drag)

• Действие пользователя: Навести мышь на середину прямого шоссе на карте, зажать бирюзовую точку левой кнопкой мыши, перетащить её на параллельную тихую улицу в 200 метрах вбок и отпустить мышь.
• Реакция системы (Магия): Пунктирные линии предпросмотра исчезают. Проложенный путь мгновенно перестраивается, огибая квартал по тихой улице через новую синюю точку. Телеметрия обновляет дистанцию в боковой панели.
• Физика процесса («Почему»): Клиент считывает координаты отпускания мыши dragend, вставляет их в массив waypoints Zustand-хранилища usePlannerStore между стартовой и конечной точками, присваивая промежуточный порядковый индекс, и инициирует recalculate-запрос к API.
• 

Подробная инструкция: Результат успешного перетаскивания точки — маршрут огибает квартал, в центре новой петли горит синий маркер с номером.

Сценарий Б: Удаление перетянутой точки для выпрямления пути (Route Healing)

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

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

Сценарий В: Экстремальное перетаскивание на большие расстояния

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

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

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

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

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