feat(nav): кнопка «Назад» на каждом экране + правило для новых разделов (задача 6385)

На айфоне у установленного приложения нет системной «назад», а жест от края
после холодного старта или открытия из пуша не делает ничего — водитель
застревал в «Уведомлениях», на ожидании Telegram и оплаты, на спиннере штрафа.

- Все экраны заводятся в таблице src/routes.tsx с обязательным родителем
  (null — только у главной и входа); App рисует <Route> только из неё.
- BackBar над маршрутами показывает «Назад» (44 px) в любом состоянии экрана.
  Логика в lib/back.ts: есть история этого запуска (history.state.idx > 0) —
  шаг назад, нет — на родителя с replace.
- Тест-сторож обходит таблицу с зависшей сетью и требует «Назад» на каждом
  экране с родителем; список «корневых» экранов закреплён.
- После входа/оплаты/выхода переходы с replace — «Назад» не возвращает на
  отработанную форму; экраны входа уводят вошедшего на главную.
- Фильтр выписки (?kind=, период) и вход по коду (?by=code) — в адресе:
  «Назад» из штрафа возвращает к списку штрафов.
- ErrorBoundary вместо белого экрана при падении.
- driver-pwa/CLAUDE.md — правило и чек-лист нового раздела.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
tremble7681andClaude Opus 5.5 committed 2026-09-25 21:53:48 +10:00
1 parent 7d8f4b8998
commit ab2ad8d471
29 files changed
+1148 -81

No files matched your search

+48
View File
@@ -0,0 +1,48 @@
# Премиум Водитель — 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`
`<Route>` руками не писать, вложенных `<Routes>` в страницах не заводить.
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` — сторож: все экраны при вечно висящей сети, родитель
существует и не сам экран, ни одного `<Route>` мимо таблицы.
**Команды** (из `frontend/`): `npm test`, `npx tsc -b`, `npm run build`.