📖 Виртуальный гараж износа деталей (Virtual Garage)

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

• Что это такое? Виртуальный гараж решает проблему непредвиденных поломок трансмиссии и ходовой части велосипеда. Велосипедисты часто забывают вовремя менять расходники (цепь, кассету, покрышки, тормозные колодки), что ведет к лавинообразному износу звезд и дорогостоящему ремонту. Гараж отслеживает пробег, качество дорог и погодные условия, заблаговременно предупреждая о необходимости замены.
• Активация: Выдвигается нажатием кнопки 🚲 Garage в правом верхнем углу главного экрана или через боковое меню профиля.
• Физика интерфейса (Basic UI Physics):
  • Зеленые индикаторы (0% - 70%): Компонент в отличном состоянии, обслуживание не требуется.
  • Желтые индикаторы (70% - 90%): Повышенный износ. Время заказать новую деталь на замену.
  • Красные индикаторы (> 90%): Критический износ! Эксплуатация опасна, деталь требует немедленной замены.
  • Drivetrain-Only Filter (Zwift Mode): Тумблер зимнего режима. При его включении покрышки и тормозные колодки визуально затеняются (отключаются от начисления износа).
  • Слайдер Mud & Rain: Интерактивный регулятор загрязненности поездки, меняющий цвет от серого до болотного при перетаскивании вправо.
• 

Подробная инструкция для Арт-директора: Сделать снимок экрана боковой панели Виртуального гаража с открытым списком деталей: цепь изношена на 85% (желтый индикатор), кассета — на 40% (зеленый индикатор), активен тумблер Zwift Mode и слайдер Mud & Rain сдвинут вправо.

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

Сценарий А: Учет жестких погодных условий (Mud Wear Boost)

• Действие пользователя: После поездки по лесной грязи под дождем открыть Гараж, сдвинуть слайдер Mud & Rain в крайнее правое положение (значение 4.0x) и сохранить пробег заезда.
• Реакция системы (Магия): Износ цепи прирастает не на стандартный 0.5% за эту дистанцию, а увеличивается скачком на 2.0%. Индикатор износа цепи окрашивается из зеленого в предупреждающий желтый цвет.
• Физика процесса («Почему»): Износ рассчитывается по формуле Wear = (Distance / ResourceLimit) * WeatherFactor * SurfaceFactor. Слайдер передает в Zustand-хранилище useGarageStore повышающий погодный коэффициент WeatherFactor = 4.0, ускоряющий старение металла во влажной и абразивной среде.
• 

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

Сценарий Б: Зимний домашний режим (Zwift Mode Activation)

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

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

Сценарий В: Замена компонента и сброс ресурса (Component Maintenance Reset)

• Действие пользователя: Купить новую цепь, нажать на иконку круглой стрелки «Сбросить / Заменить» напротив строки Chain в Гараже.
• Реакция системы (Магия): Счетчик износа цепи мгновенно сбрасывается в 0%, полоса окрашивается в сочный зеленый цвет. В базу данных записывается дата обслуживания.
• Физика процесса («Почему»): Запрос PATCH /api/garage/component/:id отправляется на сервер Hono. В базе данных PostgreSQL поле current_wear для данной записи сбрасывается в ноль, а в историю обслуживания maintenance_logs добавляется запись с текущим таймстампом.
• 

Подробная инструкция: Нажатие на кнопку сброса износа цепи, возвращающее индикатор в исходное нулевое зеленое положение.

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

• Деструктивный сценарий: Попытка ввести в текстовые поля веса или пробега некорректные буквы или спецсимволы (например, "abc" или "100,5" с неверным разделителем) в форме добавления велосипеда.
• Реакция UI: Форма, защищенная валидаторами React Hook Form и Zod с методом preprocessNumber, на лету преобразует запятые в точки, отсекает буквы и блокирует отправку, подсвечивая поле ввода оранжевой рамкой.
• Точный текст ошибки (Toast): При успешном создании и добавлении нового велосипеда: "🛡️ Велосипед успешно добавлен в гараж."
• 

Подробная инструкция: Окно добавления велосипеда с заблокированной кнопкой отправки из-за ввода букв в поле пробега.