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:
1 parent
7d8f4b8998
commit
ab2ad8d471
29 files changed
+1148
-81
No files matched your search
@@ -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;
|
||||
}
|
||||
Reference in new issue
Block a user