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:
tremble7681andClaude Opus 5.5 committed 2026-09-25 21:53:48 +10:00
1 parent 7d8f4b8998
commit ab2ad8d471
29 files changed
+1148 -81

No files matched your search

+60 -35
View File
@@ -1,22 +1,13 @@
import type { ReactNode } from "react";
import { useEffect } from "react";
import { useEffect, useState } from "react";
import { Navigate, Route, Routes, useLocation, useNavigate } from "react-router-dom";
import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff";
import { setReturnTo } from "@/lib/returnTo";
import { ImpersonationBar } from "@/components/ImpersonationBar";
import { LoginPage } from "@/pages/LoginPage";
import { MtsLoginPage } from "@/pages/MtsLoginPage";
import { TgWaitPage } from "@/pages/TgWaitPage";
import { OnboardingPage } from "@/pages/OnboardingPage";
import { BalancePage } from "@/pages/BalancePage";
import { TopupPage } from "@/pages/TopupPage";
import { PaymentPage } from "@/pages/PaymentPage";
import { DevLoginPage } from "@/pages/DevLoginPage";
import { DebugPage } from "@/pages/DebugPage";
import { MockPayPage } from "@/pages/MockPayPage";
import { FineDetailPage } from "@/pages/FineDetailPage";
import { NotificationsPage } from "@/pages/NotificationsPage";
import { BackBar, BackProvider } from "@/components/BackBar";
import { ErrorBoundary } from "@/components/ErrorBoundary";
import { ROUTES, findRoute, type AppRoute } from "@/routes";
import { markNotificationsRead } from "@/api/driver";
import { syncSubscription } from "@/lib/push";
@@ -39,6 +30,25 @@ function RequireStaff({ children }: { children: ReactNode }) {
return impersonated || staffToken ? <>{children}</> : <Navigate to="/" replace />;
}
/**
* Экраны входа — только тому, кто ещё не вошёл. Вход после ссылки или пуша
* заменяет лишь последнюю запись истории, и экран входа остаётся позади: шаг
* назад (кнопкой или жестом) показал бы вошедшему выбор способа входа — без
* «Назад» и без пути дальше, кроме нового, платного входа. Отсюда — на главную.
*
* Смотрим на вход, с которым ПРИШЛИ на эту запись: токен, появившийся уже здесь,
* значит, что экран сам довёл вход и сейчас уведёт водителя туда, куда тот шёл
* (returnTo). Перебить его уходом на главную — потерять ссылку на оплату.
*/
function GuestOnly({ children }: { children: ReactNode }) {
const signedIn = useAuth((s) => !!s.token);
const { key } = useLocation();
const [arrived, setArrived] = useState({ key, signedIn });
if (arrived.key !== key) setArrived({ key, signedIn });
const wasSignedIn = arrived.key === key ? arrived.signedIn : signedIn;
return wasSignedIn ? <Navigate to="/" replace /> : <>{children}</>;
}
/**
* Нажатие по пушу — единственный честный признак, что уведомление увидели.
* Сам воркер отметить его не может: токен водителя лежит в хранилище страницы,
@@ -83,29 +93,44 @@ function SyncPushSubscription() {
return null;
}
function guarded(r: AppRoute): ReactNode {
if (r.guard === "staff") return <RequireAuth><RequireStaff>{r.element}</RequireStaff></RequireAuth>;
if (r.guard === "auth") return <RequireAuth>{r.element}</RequireAuth>;
if (r.guard === "guest") return <GuestOnly>{r.element}</GuestOnly>;
return r.element;
}
export default function App() {
const loc = useLocation();
// Упавшей главной или экрану входа «Назад» сверху не положен — вместо него
// страховка сама предложит «На главную».
const root = findRoute(loc.pathname)?.route.parent === null;
return (
<div className="mx-auto max-w-md min-h-full px-4 pt-3 pb-8">
{/* Плашка живёт над маршрутами: чей экран открыт, видно на каждом из них,
а не только там, где про неё вспомнили. Сама решает, показываться ли. */}
<ImpersonationBar />
<SyncPushSubscription />
<MarkPushRead />
<Routes>
<Route path="/login" element={<LoginPage />} />
<Route path="/login/mts" element={<MtsLoginPage />} />
<Route path="/dev" element={<DevLoginPage />} />
<Route path="/tg-wait" element={<TgWaitPage />} />
<Route path="/onboarding" element={<OnboardingPage />} />
<Route path="/" element={<RequireAuth><BalancePage /></RequireAuth>} />
<Route path="/topup" element={<RequireAuth><TopupPage /></RequireAuth>} />
<Route path="/pay/:orderId" element={<RequireAuth><PaymentPage /></RequireAuth>} />
<Route path="/mock-pay/:orderId" element={<RequireAuth><MockPayPage /></RequireAuth>} />
<Route path="/fines/:fineId" element={<RequireAuth><FineDetailPage /></RequireAuth>} />
<Route path="/notifications" element={<RequireAuth><NotificationsPage /></RequireAuth>} />
<Route path="/debug" element={<RequireAuth><RequireStaff><DebugPage /></RequireStaff></RequireAuth>} />
<Route path="*" element={<Navigate to="/" replace />} />
</Routes>
</div>
<BackProvider>
{/* Отступ сверху не меньше системной полосы iPhone: если приложение когда-нибудь
начнёт рисовать под ней, «Назад» всё равно останется под пальцем. */}
<div className="mx-auto max-w-md min-h-full px-4 pt-[max(0.75rem,env(safe-area-inset-top))] pb-8">
{/* Плашка живёт над маршрутами: чей экран открыт, видно на каждом из них,
а не только там, где про неё вспомнили. Сама решает, показываться ли. */}
<ImpersonationBar />
{/* «Назад» — тоже над маршрутами и вне страховки от падений: есть на любом
экране кроме главной и входа, в любом его состоянии (см. routes.tsx). */}
<BackBar />
<SyncPushSubscription />
<MarkPushRead />
{/* Ключ — адрес целиком: выбор на экране живёт в строке запроса
(?kind=, ?by=code), и уход с неё — уже другой экран. */}
<ErrorBoundary resetKey={loc.pathname + loc.search} home={root}>
<Routes>
{/* Экраны — только из таблицы ROUTES: по ней же BackBar ищет родителя,
а тест-сторож проверяет «Назад». Сюда <Route> руками не добавлять. */}
{ROUTES.map((r) => (
<Route key={r.path} path={r.path} element={guarded(r)} />
))}
<Route path="*" element={<Navigate to="/" replace />} />
</Routes>
</ErrorBoundary>
</div>
</BackProvider>
);
}