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

3.9 KiB
Raw Blame History

Премиум Водитель — 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.