# Премиум Водитель — PWA водителя (app.pptaxi.ru) Фронт: `frontend/` (React + Vite + react-router 6, BrowserRouter). Как поднять и проверить — `frontend/README.md`. ## Кнопка «Назад» на каждом экране **Зачем.** У установленного PWA на iPhone нет системной кнопки «назад», жест от края ненадёжен, а после холодного старта (иконка, пуш, ссылка) истории нет вовсе. Водитель застревал, например, в «Уведомлениях» (задача 6385). Android-«назад» должен вести туда же, куда кнопка в интерфейсе. **Правило.** - Любой экран, кроме главной (`/`) и входа (`/login`), показывает «Назад» слева сверху во всех состояниях: загрузка, ошибка, пусто, не найдено, итог. - Поведение одно (`src/lib/back.ts`): есть история этого запуска (`history.state.idx > 0`) — `navigate(-1)`, нет — родитель с `replace`. Голый `navigate(-1)` и `navigate(родитель)` без `replace` запрещены. - Родитель экрана — поле `parent` в таблице `src/routes.tsx` (обязательное; `null` только у `/` и `/login`; можно функцией от параметров/входа). - После действия, которое «съедает» форму или запись (создали платёж, выбрали исход, вошли, вышли), уходим с `{ replace: true }`. Экраны входа — `guard: "guest"`: вошедшего уводят на главную, и шаг назад после входа по ссылке не попадает на отработавший вход. - Режим, заменяющий экран целиком, где это дёшево, получает свой адрес (push) и перенацеливает верхнюю «Назад» через `useBackOverride`; второй кнопки не рисует. Свой `BackButton` — только на экране без родителя (вход по коду, `?by=code`). - Выбор на экране (фильтр, период) держим в адресе, меняем с `replace`. **Новый раздел — чек-лист.** 1. Добавить строку в `ROUTES` (`src/routes.tsx`) с `parent`. В `App.tsx` `` руками не писать, вложенных `` в страницах не заводить. 2. Свою «Назад» не рисовать: её ставит `BackBar` над маршрутами. 3. `navigate()` после мутаций — с `replace`. Кнопка «уйти с экрана» внутри страницы — `useRouteBack()`, адрес родителя в странице не повторять. 4. `npm test` — сторож `src/routes.test.tsx` обязан пройти. **Где что.** - `src/lib/back.ts` — `canGoBackInApp()`, `useBack(parent, { mode })`, `useRouteBack()`, `useBackOverride({ to, mode })`. - `src/components/BackBar.tsx` — `BackProvider` (родитель по таблице) и `BackBar`. - `src/components/BackButton.tsx` — сама кнопка (ChevronLeft + «Назад», 44 px). - `src/components/ErrorBoundary.tsx` — вместо белого экрана «Перезагрузить», на главной и входе ещё «На главную». - `src/routes.test.tsx` — сторож: все экраны при вечно висящей сети, родитель существует и не сам экран, ни одного `` мимо таблицы. **Команды** (из `frontend/`): `npm test`, `npx tsc -b`, `npm run build`.