На айфоне у установленного приложения нет системной «назад», а жест от края после холодного старта или открытия из пуша не делает ничего — водитель застревал в «Уведомлениях», на ожидании 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>
3.9 KiB
3.9 KiB
Премиум Водитель — 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.
Новый раздел — чек-лист.
- Добавить строку в
ROUTES(src/routes.tsx) сparent. ВApp.tsx<Route>руками не писать, вложенных<Routes>в страницах не заводить. - Свою «Назад» не рисовать: её ставит
BackBarнад маршрутами. navigate()после мутаций — сreplace. Кнопка «уйти с экрана» внутри страницы —useRouteBack(), адрес родителя в странице не повторять.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.