Files
mechanic-pwa/driver-pwa/CLAUDE.md
T
tremble7681andClaude Opus 5.5 ab2ad8d471 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>
2026-09-25 21:53:48 +10:00

49 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Премиум Водитель — 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`.