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:
1 parent
7d8f4b8998
commit
ab2ad8d471
29 files changed
+1148
-81
No files matched your search
@@ -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`.
|
||||
Reference in new issue
Block a user