На айфоне у установленного приложения нет системной «назад», а жест от края после холодного старта или открытия из пуша не делает ничего — водитель застревал в «Уведомлениях», на ожидании 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>
49 lines
3.9 KiB
Markdown
49 lines
3.9 KiB
Markdown
# Премиум Водитель — 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`.
|