На айфоне у установленного приложения нет системной «назад», а жест от края после холодного старта или открытия из пуша не делает ничего — водитель застревал в «Уведомлениях», на ожидании 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>
76 lines
4.6 KiB
TypeScript
76 lines
4.6 KiB
TypeScript
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;
|
|
}
|