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

+75
View File
@@ -0,0 +1,75 @@
import type { ReactNode } from "react";
import { matchRoutes, type Params } from "react-router-dom";
import type { BackMode } from "@/lib/back";
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";
/** Что известно при выборе родителя: параметры пути, строка запроса, вход. */
export interface ParentCtx {
params: Params;
search: URLSearchParams;
/** Есть токен водителя — свой вход или просмотр сотрудником. */
signedIn: boolean;
}
/** Куда ведёт «Назад», когда в истории этого запуска позади ничего нет.
* null — только у главной и у экранов входа: там кнопки «Назад» нет. */
export type Parent = string | ((ctx: ParentCtx) => string) | null;
export interface AppRoute {
path: string;
element: ReactNode;
/** Обязателен: экран без родителя не соберётся. См. CLAUDE.md приложения. */
parent: Parent;
/** "auth" — только вошедшему водителю, "staff" — ещё и только сотруднику,
* "guest" — экран входа: вошедшего уводит на главную (см. GuestOnly в App). */
guard?: "auth" | "staff" | "guest";
/** По умолчанию «Назад» идёт шагом по истории — см. BackMode. */
back?: BackMode;
}
/**
* Все экраны приложения — единственный источник и для <Routes> в App, и для
* кнопки «Назад» (BackBar), и для теста-сторожа, который проверяет её на каждом.
*/
export const ROUTES: AppRoute[] = [
{ path: "/", element: <BalancePage />, guard: "auth", parent: null },
{ path: "/login", element: <LoginPage />, guard: "guest", parent: null },
{ path: "/login/mts", element: <MtsLoginPage />, guard: "guest", parent: "/login" },
{ path: "/tg-wait", element: <TgWaitPage />, guard: "guest", parent: "/login" },
{ path: "/onboarding", element: <OnboardingPage />, guard: "guest", parent: "/login" },
// Сотрудник, уже вошедший водителем, попадает сюда долгим тапом с главной —
// туда и возвращаем; без входа возвращаться некуда, кроме экрана входа.
{ path: "/dev", element: <DevLoginPage />, parent: ({ signedIn }) => (signedIn ? "/" : "/login") },
{ path: "/notifications", element: <NotificationsPage />, guard: "auth", parent: "/" },
{ path: "/topup", element: <TopupPage />, guard: "auth", parent: "/" },
{ path: "/pay/:orderId", element: <PaymentPage />, guard: "auth", parent: "/" },
{ path: "/mock-pay/:orderId", element: <MockPayPage />, guard: "auth", parent: "/" },
// Карточку открывают из списка штрафов — к нему и возвращаем, даже если её
// открыли пушем «Новый штраф» с холодного старта.
{ path: "/fines/:fineId", element: <FineDetailPage />, guard: "auth", parent: "/?kind=fines" },
{ path: "/debug", element: <DebugPage />, guard: "staff", parent: "/" },
];
/** Маршрут из таблицы, под который попадает адрес, — с параметрами пути. */
export function findRoute(pathname: string): { route: AppRoute; params: Params } | null {
// Тем же ранжированием, что у <Routes> (статичный сегмент сильнее параметра),
// а не первым совпадением по порядку таблицы: иначе «Назад» взял бы родителя
// не того экрана, что нарисован.
const hit = matchRoutes(ROUTES, pathname)?.[0];
return hit ? { route: hit.route, params: hit.params } : null;
}
export function resolveParent(parent: Exclude<Parent, null>, ctx: ParentCtx): string {
return typeof parent === "function" ? parent(ctx) : parent;
}