diff --git a/driver-pwa/CLAUDE.md b/driver-pwa/CLAUDE.md
new file mode 100644
index 0000000..d8c95b9
--- /dev/null
+++ b/driver-pwa/CLAUDE.md
@@ -0,0 +1,48 @@
+# Премиум Водитель — 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`.
+
+**Новый раздел — чек-лист.**
+1. Добавить строку в `ROUTES` (`src/routes.tsx`) с `parent`. В `App.tsx`
+ `` руками не писать, вложенных `` в страницах не заводить.
+2. Свою «Назад» не рисовать: её ставит `BackBar` над маршрутами.
+3. `navigate()` после мутаций — с `replace`. Кнопка «уйти с экрана» внутри
+ страницы — `useRouteBack()`, адрес родителя в странице не повторять.
+4. `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` — сторож: все экраны при вечно висящей сети, родитель
+ существует и не сам экран, ни одного `` мимо таблицы.
+
+**Команды** (из `frontend/`): `npm test`, `npx tsc -b`, `npm run build`.
diff --git a/driver-pwa/frontend/src/App.back.test.tsx b/driver-pwa/frontend/src/App.back.test.tsx
new file mode 100644
index 0000000..b29385f
--- /dev/null
+++ b/driver-pwa/frontend/src/App.back.test.tsx
@@ -0,0 +1,189 @@
+import { describe, it, expect, vi, beforeEach, beforeAll, afterAll } from "vitest";
+import { render, screen, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { BrowserRouter, MemoryRouter, useLocation } from "react-router-dom";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { useEffect, type ReactNode } from "react";
+
+vi.mock("@/api/driver", () => ({
+ getNotifications: vi.fn(async () => ({
+ items: [
+ { id: 5, kind: "fine", title: "Новый штраф", body: "Постановление от 13.08.2026.",
+ url: "/fines/12", created_at: "2026-08-18T10:15:00+10:00", read_at: null },
+ ],
+ unread: 1,
+ })),
+ markNotificationsRead: vi.fn(async () => ({ marked: 1 })),
+ getBalance: vi.fn(async () => ({
+ accounts: [
+ { bucket: "Долг аренда", balance: -3050, payable: true },
+ { bucket: "Долг по штрафам", balance: -618.75, payable: true },
+ ],
+ total: -3668.75, synced_at: null, pending_topup: 0,
+ })),
+ getStatement: vi.fn(async () => ({ items: [], from: "2026-08-11", to: "2026-08-18", kind: "all" })),
+ getFines: vi.fn(async () => ({
+ items: [{
+ id: 12, number: "18810525260813035846", date: "2026-08-13",
+ article: "12.09.2 - Превышение скорости", address: "", car_number: "А947УТ125",
+ amount: 618.75, settled: "owed" as const, cancelled: false, has_photo: false,
+ }],
+ open_count: 1, debt: -618.75,
+ })),
+ getFine: vi.fn(async () => ({
+ id: 12, number: "18810525260813035846", date: "2026-08-13",
+ article: "12.09.2 - Превышение скорости", address: "", car_number: "А947УТ125",
+ amount: 618.75, settled: "owed" as const, cancelled: false, has_photo: false,
+ photos: [], document: null, post_date: null, camera: null,
+ speed: null, speed_limit: null, speed_excess: null,
+ })),
+ // Экран входа: МТС ID и Telegram выключены — остаётся вход по коду.
+ mtsStatus: vi.fn(async () => ({ enabled: false })),
+ tgSession: vi.fn(async () => ({ pair_session: "S", poll_secret: "P", confirm_code: "1", deep_link: null })),
+ authRequest: vi.fn(async () => ({ status: "code_sent", channel: "tg" })),
+ authVerify: vi.fn(async () => ({ token: "t", driver_id: 42 })),
+ apiErrorText: vi.fn(async (_e: unknown, fallback: string) => fallback),
+ retryAfterSeconds: vi.fn(() => null),
+}));
+
+import App from "@/App";
+import * as driver from "@/api/driver";
+import { useAuth } from "@/store/auth";
+
+// Штраф от 13.08 должен попадать в «последние 7 дней» — морозим только Date.
+beforeAll(() => {
+ vi.useFakeTimers({ toFake: ["Date"] });
+ vi.setSystemTime(new Date("2026-08-18T12:00:00Z"));
+});
+afterAll(() => vi.useRealTimers());
+
+const withQuery = (children: ReactNode) => (
+
+ {children}
+
+);
+
+const idx = () => (window.history.state as { idx?: number } | null)?.idx;
+
+describe("выход с экранов назад (задача 6385)", () => {
+ beforeEach(() => {
+ window.history.replaceState(null, "", "/");
+ useAuth.getState().setSession("t", 42);
+ vi.clearAllMocks();
+ });
+
+ it("лента, открытая пушем с холодного старта: «Назад» ведёт на главную", async () => {
+ // Так это и выглядело на iPhone: пуш открыл /notifications?n=5, истории
+ // позади нет, системной кнопки нет — выйти было нечем.
+ render(withQuery(
+
+ ));
+ expect(await screen.findByText("Новый штраф")).toBeInTheDocument();
+ expect(driver.markNotificationsRead).toHaveBeenCalledWith([5], "push");
+
+ await userEvent.click(screen.getByRole("button", { name: "Назад" }));
+ expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
+ expect(screen.queryByRole("heading", { name: "Уведомления" })).not.toBeInTheDocument();
+ });
+
+ it("главная → колокольчик → лента → «Назад» возвращает шагом по истории", async () => {
+ render(withQuery());
+ await userEvent.click(await screen.findByRole("button", { name: "Уведомления" }));
+ expect(await screen.findByRole("heading", { name: "Уведомления" })).toBeInTheDocument();
+ expect(idx()).toBe(1);
+ const len = window.history.length;
+
+ await userEvent.click(screen.getByRole("button", { name: "Назад" }));
+ await waitFor(() => expect(window.location.pathname).toBe("/"));
+ // Вернулись назад, а не положили главную новой записью поверх ленты.
+ expect(idx()).toBe(0);
+ expect(window.history.length).toBe(len);
+ expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
+ });
+
+ it("из карточки штрафа «Назад» возвращает к списку штрафов", async () => {
+ render(withQuery());
+ await userEvent.click(await screen.findByRole("button", { name: /Долг по штрафам/ }));
+ await waitFor(() => expect(window.location.search).toBe("?kind=fines"));
+ // Фильтр — не шаг истории: сменили заменой.
+ expect(idx()).toBe(0);
+
+ await userEvent.click(await screen.findByRole("button", { name: /Превышение скорости/ }));
+ expect(await screen.findByText("Начислено вам")).toBeInTheDocument();
+
+ await userEvent.click(screen.getByRole("button", { name: "Назад" }));
+ await waitFor(() => expect(window.location.pathname + window.location.search).toBe("/?kind=fines"));
+ expect(await screen.findByRole("button", { name: /Превышение скорости/ })).toBeInTheDocument();
+ });
+
+ it("вход сотрудника с холодного старта: «Я водитель» ведёт туда же, куда «Назад»", async () => {
+ // Водитель вошёл, а /dev открыт заново (перезагрузка, ссылка): родитель по
+ // таблице — главная. Раньше кнопка на странице знала только /login.
+ const seen: string[] = [];
+ function Seen() {
+ const { pathname } = useLocation();
+ useEffect(() => { seen.push(pathname); }, [pathname]);
+ return null;
+ }
+ render(withQuery());
+ await userEvent.click(screen.getByRole("button", { name: "Я водитель" }));
+ expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
+ expect(seen).toEqual(["/dev", "/"]);
+ });
+
+ it("карточка штрафа с холодного старта: «Назад» — в список штрафов", async () => {
+ render(withQuery());
+ expect(await screen.findByText("Начислено вам")).toBeInTheDocument();
+ await userEvent.click(screen.getByRole("button", { name: "Назад" }));
+ expect(await screen.findByRole("button", { name: /Превышение скорости/ })).toBeInTheDocument();
+ expect(driver.getFines).toHaveBeenCalled();
+ });
+});
+
+describe("после входа «Назад» не возвращает к экрану входа", () => {
+ beforeEach(() => {
+ useAuth.getState().clear();
+ sessionStorage.clear();
+ vi.clearAllMocks();
+ });
+
+ async function loginByCode() {
+ await userEvent.click(await screen.findByRole("button", { name: "Войти по коду" }));
+ await userEvent.type(screen.getByLabelText("Номер телефона"), "9143054400");
+ await userEvent.click(screen.getByRole("button", { name: "Получить код" }));
+ await userEvent.type(await screen.findByPlaceholderText("Код из сообщения"), "1234");
+ await userEvent.click(screen.getByRole("button", { name: "Войти" }));
+ }
+
+ it("открыл экран, не войдя (пуш, ссылка на оплату): вошёл — «Назад» на главную", async () => {
+ // Охрана заменяет адрес экраном входа (запись 0), вход по коду кладёт свою
+ // запись (1), а успешный вход заменяет лишь её. Позади остаётся отработавший
+ // экран входа — шаг назад на него раньше показывал вошедшему выбор способа
+ // входа без «Назад» и без пути дальше.
+ window.history.replaceState(null, "", "/notifications");
+ render(withQuery());
+ await loginByCode();
+ expect(await screen.findByRole("heading", { name: "Уведомления" })).toBeInTheDocument();
+ expect(idx()).toBe(1);
+
+ await userEvent.click(screen.getByRole("button", { name: "Назад" }));
+ await waitFor(() => expect(idx()).toBe(0));
+ await waitFor(() => expect(window.location.pathname).toBe("/"));
+ expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
+ expect(screen.queryByText("Вход в приложение")).not.toBeInTheDocument();
+ });
+
+ it("вход по коду: системный «назад» с главной не открывает выбор способа входа", async () => {
+ window.history.replaceState(null, "", "/login");
+ render(withQuery());
+ await loginByCode();
+ expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
+ expect(idx()).toBe(1);
+
+ window.history.back();
+ await waitFor(() => expect(idx()).toBe(0));
+ await waitFor(() => expect(window.location.pathname).toBe("/"));
+ expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
+ expect(screen.queryByText("Вход в приложение")).not.toBeInTheDocument();
+ });
+});
diff --git a/driver-pwa/frontend/src/App.tsx b/driver-pwa/frontend/src/App.tsx
index 378ce14..f370119 100644
--- a/driver-pwa/frontend/src/App.tsx
+++ b/driver-pwa/frontend/src/App.tsx
@@ -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}> : ;
}
+/**
+ * Экраны входа — только тому, кто ещё не вошёл. Вход после ссылки или пуша
+ * заменяет лишь последнюю запись истории, и экран входа остаётся позади: шаг
+ * назад (кнопкой или жестом) показал бы вошедшему выбор способа входа — без
+ * «Назад» и без пути дальше, кроме нового, платного входа. Отсюда — на главную.
+ *
+ * Смотрим на вход, с которым ПРИШЛИ на эту запись: токен, появившийся уже здесь,
+ * значит, что экран сам довёл вход и сейчас уведёт водителя туда, куда тот шёл
+ * (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 ? : <>{children}>;
+}
+
/**
* Нажатие по пушу — единственный честный признак, что уведомление увидели.
* Сам воркер отметить его не может: токен водителя лежит в хранилище страницы,
@@ -83,29 +93,44 @@ function SyncPushSubscription() {
return null;
}
+function guarded(r: AppRoute): ReactNode {
+ if (r.guard === "staff") return {r.element};
+ if (r.guard === "auth") return {r.element};
+ if (r.guard === "guest") return {r.element};
+ return r.element;
+}
+
export default function App() {
+ const loc = useLocation();
+ // Упавшей главной или экрану входа «Назад» сверху не положен — вместо него
+ // страховка сама предложит «На главную».
+ const root = findRoute(loc.pathname)?.route.parent === null;
return (
-
- {/* Плашка живёт над маршрутами: чей экран открыт, видно на каждом из них,
- а не только там, где про неё вспомнили. Сама решает, показываться ли. */}
-
-
-
-
- } />
- } />
- } />
- } />
- } />
- } />
- } />
- } />
- } />
- } />
- } />
- } />
- } />
-
-
+
+ {/* Отступ сверху не меньше системной полосы iPhone: если приложение когда-нибудь
+ начнёт рисовать под ней, «Назад» всё равно останется под пальцем. */}
+
+ {/* Плашка живёт над маршрутами: чей экран открыт, видно на каждом из них,
+ а не только там, где про неё вспомнили. Сама решает, показываться ли. */}
+
+ {/* «Назад» — тоже над маршрутами и вне страховки от падений: есть на любом
+ экране кроме главной и входа, в любом его состоянии (см. routes.tsx). */}
+
+
+
+ {/* Ключ — адрес целиком: выбор на экране живёт в строке запроса
+ (?kind=, ?by=code), и уход с неё — уже другой экран. */}
+
+
+ {/* Экраны — только из таблицы ROUTES: по ней же BackBar ищет родителя,
+ а тест-сторож проверяет «Назад». Сюда руками не добавлять. */}
+ {ROUTES.map((r) => (
+
+ ))}
+ } />
+
+
+
+
);
}
diff --git a/driver-pwa/frontend/src/components/BackBar.tsx b/driver-pwa/frontend/src/components/BackBar.tsx
new file mode 100644
index 0000000..778555c
--- /dev/null
+++ b/driver-pwa/frontend/src/components/BackBar.tsx
@@ -0,0 +1,43 @@
+import { useContext, useState, type ReactNode } from "react";
+import { useLocation } from "react-router-dom";
+import { findRoute, resolveParent } from "@/routes";
+import { BackContext, type BackTarget } from "@/lib/back";
+import { useAuth } from "@/store/auth";
+import { BackButton } from "@/components/BackButton";
+
+/**
+ * Родитель текущего экрана — один раз по таблице маршрутов, для всех: кнопки
+ * над экраном (BackBar) и выходов внутри страниц (useRouteBack). Здесь же живёт
+ * цель, которую страница может задать сама (useBackOverride).
+ */
+export function BackProvider({ children }: { children: ReactNode }) {
+ const loc = useLocation();
+ const signedIn = useAuth((s) => !!s.token);
+ const [override, setOverride] = useState(null);
+ const hit = findRoute(loc.pathname);
+ const parent =
+ hit && hit.route.parent !== null
+ ? {
+ to: resolveParent(hit.route.parent, {
+ params: hit.params,
+ search: new URLSearchParams(loc.search),
+ signedIn,
+ }),
+ mode: hit.route.back,
+ }
+ : null;
+ return {children};
+}
+
+/**
+ * Строка «Назад» над экраном. Стоит в App над маршрутами, а не в страницах:
+ * так она есть в любом состоянии экрана — загрузка, ошибка, пустота, редирект
+ * охраны, — и новый раздел получает её сам, стоит завести его в таблице
+ * маршрутов с родителем. У главной и входа родителя нет — строки тоже.
+ */
+export function BackBar() {
+ const { parent, override } = useContext(BackContext);
+ if (!parent) return null;
+ const target = override ?? parent;
+ return ;
+}
diff --git a/driver-pwa/frontend/src/components/BackButton.tsx b/driver-pwa/frontend/src/components/BackButton.tsx
new file mode 100644
index 0000000..4e636ee
--- /dev/null
+++ b/driver-pwa/frontend/src/components/BackButton.tsx
@@ -0,0 +1,26 @@
+import { ChevronLeft } from "lucide-react";
+import { useBack, type BackMode } from "@/lib/back";
+
+/**
+ * Кнопка «Назад» — одна на всё приложение, всегда в левом верхнем углу.
+ *
+ * Обычно её ставит BackBar по таблице маршрутов; сама страница рисует её только
+ * для своего режима, у которого есть адрес, а родителя в таблице нет (вход по
+ * коду). Высота 44 px — палец попадает с первого раза, подпись словом, а не
+ * одной стрелкой: так её находят и те, кто не привык к значкам.
+ */
+export function BackButton({ to, mode }: { to: string; mode?: BackMode }) {
+ const back = useBack(to, { mode });
+ return (
+
+
+
+ );
+}
diff --git a/driver-pwa/frontend/src/components/ErrorBoundary.test.tsx b/driver-pwa/frontend/src/components/ErrorBoundary.test.tsx
new file mode 100644
index 0000000..3d50922
--- /dev/null
+++ b/driver-pwa/frontend/src/components/ErrorBoundary.test.tsx
@@ -0,0 +1,66 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { cleanup, render, screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { MemoryRouter } from "react-router-dom";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+
+// Карточка штрафа, падающая при отрисовке, — как упал бы любой экран на
+// неожиданных данных.
+vi.mock("@/pages/FineDetailPage", () => ({
+ FineDetailPage: () => {
+ throw new Error("сломалось");
+ },
+}));
+// Экран входа тоже падает — у него, в отличие от карточки, «Назад» сверху нет.
+vi.mock("@/pages/LoginPage", () => ({
+ LoginPage: () => {
+ throw new Error("сломалось");
+ },
+}));
+
+import App from "@/App";
+import { useAuth } from "@/store/auth";
+
+const renderAt = (url: string) =>
+ render(
+
+
+
+ );
+
+describe("экран упал при отрисовке", () => {
+ beforeEach(() => {
+ vi.stubGlobal("fetch", vi.fn(() => new Promise(() => {})));
+ // React громко пишет пойманную ошибку в консоль — в тесте это шум.
+ vi.spyOn(console, "error").mockImplementation(() => undefined);
+ window.history.replaceState(null, "", "/");
+ useAuth.getState().setSession("t", 42);
+ });
+ afterEach(() => {
+ cleanup();
+ vi.unstubAllGlobals();
+ vi.restoreAllMocks();
+ useAuth.getState().clear();
+ });
+
+ it("вместо белого экрана — «Перезагрузить» и «Назад», и уйти можно", async () => {
+ renderAt("/fines/1");
+ expect(screen.getByRole("button", { name: "Перезагрузить" })).toBeInTheDocument();
+ // Выход с экрана — «Назад» сверху; вторая кнопка ухода тут лишняя.
+ expect(screen.queryByRole("button", { name: "На главную" })).not.toBeInTheDocument();
+
+ await userEvent.click(screen.getByRole("button", { name: "Назад" }));
+ // Ушли с упавшего экрана — обёртка сбрасывается и рисует главную.
+ expect(screen.queryByRole("button", { name: "Перезагрузить" })).not.toBeInTheDocument();
+ expect(screen.getByRole("button", { name: /^Пополнить$/ })).toBeInTheDocument();
+ });
+
+ it("упал экран без «Назад» — есть «На главную», а не только перезагрузка", () => {
+ // Перезагрузка вернула бы тот же адрес (?by=code) — и то же падение.
+ useAuth.getState().clear();
+ renderAt("/login?by=code");
+ expect(screen.getByRole("button", { name: "Перезагрузить" })).toBeInTheDocument();
+ expect(screen.getByRole("button", { name: "На главную" })).toBeInTheDocument();
+ expect(screen.queryByRole("button", { name: "Назад" })).not.toBeInTheDocument();
+ });
+});
diff --git a/driver-pwa/frontend/src/components/ErrorBoundary.tsx b/driver-pwa/frontend/src/components/ErrorBoundary.tsx
new file mode 100644
index 0000000..16fc920
--- /dev/null
+++ b/driver-pwa/frontend/src/components/ErrorBoundary.tsx
@@ -0,0 +1,54 @@
+import { Component, type ErrorInfo, type ReactNode } from "react";
+import { RotateCw } from "lucide-react";
+
+/**
+ * Страховка от белого экрана: упавший при отрисовке экран раньше оставлял
+ * пустоту без единой кнопки. Теперь вместо него — «Перезагрузить», а «Назад»
+ * остаётся сверху: BackBar стоит вне этой обёртки.
+ *
+ * `resetKey` — адрес экрана: ушли с упавшего экрана — пробуем рисовать снова.
+ * `home` — у экрана нет «Назад» (главная, вход): выход — «На главную» начисто.
+ * Перезагрузка вернула бы тот же адрес с тем же выбором (?kind=, ?by=code), а
+ * с ним и то же падение.
+ */
+export class ErrorBoundary extends Component<
+ { resetKey: string; home: boolean; children: ReactNode },
+ { failed: boolean }
+> {
+ state = { failed: false };
+
+ static getDerivedStateFromError() {
+ return { failed: true };
+ }
+
+ componentDidCatch(error: Error, info: ErrorInfo) {
+ console.error(error, info.componentStack);
+ }
+
+ componentDidUpdate(prev: { resetKey: string }) {
+ if (this.state.failed && prev.resetKey !== this.props.resetKey) this.setState({ failed: false });
+ }
+
+ render() {
+ if (!this.state.failed) return this.props.children;
+ return (
+
+
Экран не открылся
+
Перезагрузите приложение — обычно этого достаточно.
+
+ {this.props.home && (
+ // Полная загрузка с чистого адреса: сбрасывает и строку запроса, и
+ // всё, что приложение успело держать в памяти.
+
+ )}
+
+ );
+ }
+}
diff --git a/driver-pwa/frontend/src/components/ImpersonationBar.tsx b/driver-pwa/frontend/src/components/ImpersonationBar.tsx
index e44c0ef..4b46f34 100644
--- a/driver-pwa/frontend/src/components/ImpersonationBar.tsx
+++ b/driver-pwa/frontend/src/components/ImpersonationBar.tsx
@@ -1,5 +1,6 @@
import { useLocation, useNavigate } from "react-router-dom";
import { Eye } from "lucide-react";
+import { useRouteBack } from "@/lib/back";
import { useAuth } from "@/store/auth";
/**
@@ -14,6 +15,9 @@ export function ImpersonationBar() {
const nav = useNavigate();
const loc = useLocation();
const { impersonated, driverName, driverId } = useAuth();
+ // С отладки — туда, откуда на неё пришли (иначе к её родителю в routes.tsx),
+ // а не новой записью главной поверх: системный «назад» вернул бы на отладку.
+ const back = useRouteBack();
if (!impersonated) return null;
const onDebug = loc.pathname === "/debug";
@@ -25,7 +29,7 @@ export function ImpersonationBar() {
diff --git a/driver-pwa/frontend/src/lib/back.test.tsx b/driver-pwa/frontend/src/lib/back.test.tsx
new file mode 100644
index 0000000..5a95966
--- /dev/null
+++ b/driver-pwa/frontend/src/lib/back.test.tsx
@@ -0,0 +1,124 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { render, screen, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { BrowserRouter, Link, MemoryRouter, Route, Routes, useLocation } from "react-router-dom";
+import { BackButton } from "@/components/BackButton";
+import { BackBar, BackProvider } from "@/components/BackBar";
+import { canGoBackInApp, useBackOverride } from "./back";
+
+// Настоящий BrowserRouter поверх истории jsdom: только так виден счётчик idx.
+// Родитель экрана /a/b — главная, а позади в истории — /a: по тому, куда
+// попали, видно, какой из двух путей сработал.
+function Where() {
+ const loc = useLocation();
+ return
} />
+
+
+ );
+ await userEvent.click(screen.getByRole("link", { name: "в раздел" }));
+ const len = window.history.length;
+ await userEvent.click(screen.getByRole("button", { name: "Назад" }));
+ expect(screen.getByText("родитель")).toBeInTheDocument();
+ expect(idx()).toBe(1);
+ expect(window.history.length).toBe(len);
+ });
+});
+
+describe("страница перенацеливает «Назад» над экраном", () => {
+ beforeEach(() => window.history.replaceState(null, "", "/"));
+
+ it("цель страницы важнее родителя из таблицы и уходит вместе со страницей", async () => {
+ // /topup в таблице с родителем «/»; режим внутри страницы ведёт в ленту.
+ function Mode() {
+ useBackOverride({ to: "/notifications" });
+ return
режим
;
+ }
+ render(
+
+
+
+
+ главная} />
+ } />
+ лента} />
+
+
+
+ );
+ // Кнопка по-прежнему одна — страница не рисует вторую.
+ expect(screen.getAllByRole("button", { name: "Назад" })).toHaveLength(1);
+ await userEvent.click(screen.getByRole("button", { name: "Назад" }));
+ expect(screen.getByText("лента")).toBeInTheDocument();
+
+ // Страница ушла — с ней и её цель: у ленты снова родитель из таблицы.
+ await userEvent.click(screen.getByRole("button", { name: "Назад" }));
+ expect(screen.getByText("главная")).toBeInTheDocument();
+ });
+});
diff --git a/driver-pwa/frontend/src/lib/back.ts b/driver-pwa/frontend/src/lib/back.ts
new file mode 100644
index 0000000..c714243
--- /dev/null
+++ b/driver-pwa/frontend/src/lib/back.ts
@@ -0,0 +1,89 @@
+import { createContext, useCallback, useContext, useLayoutEffect } from "react";
+import { useNavigate } from "react-router-dom";
+
+/**
+ * «Назад» внутри приложения — одно правило на все экраны.
+ *
+ * У установленного PWA на iPhone нет системной кнопки «назад», а жест от края
+ * экрана ненадёжен и после холодного старта (открыли с иконки, из пуша, по
+ * ссылке) не делает ничего — истории нет. Водитель застревал на экране без
+ * выхода (задача 6385). Поэтому на каждом экране, кроме главной и входа, есть
+ * своя кнопка, и ведёт она так: есть куда вернуться в этом запуске — шаг назад
+ * по истории, нет — на родительский экран С ЗАМЕНОЙ записи.
+ */
+
+/** Есть ли позади в истории экран ЭТОГО запуска приложения.
+ *
+ * `idx` — собственный счётчик записей BrowserRouter: 0 — первая запись запуска
+ * (холодный старт, открытие из пуша, внешняя ссылка), push его увеличивает,
+ * replace сохраняет. `location.key !== "default"` не годится — после replace
+ * ключ новый, а позади пусто; `history.length` считает и чужие записи до
+ * приложения. MemoryRouter window.history не трогает, поэтому в таких тестах
+ * здесь всегда false — это путь холодного старта. */
+export function canGoBackInApp(): boolean {
+ const idx = (window.history.state as { idx?: unknown } | null)?.idx;
+ return typeof idx === "number" && idx > 0;
+}
+
+/** "history" — шаг назад, если есть куда (по умолчанию); "parent" — всегда на
+ * родителя: для экранов, где запись позади заведомо не та. */
+export type BackMode = "history" | "parent";
+
+/** Обработчик «Назад»; `parent` — куда идти, если позади ничего нет.
+ *
+ * Родителя только заменяем, никогда не пушим: запись поверх истории зацикливает
+ * системный «назад» Android — он возвращал бы на экран, с которого ушли. */
+export function useBack(parent: string, opts?: { mode?: BackMode }): () => void {
+ const nav = useNavigate();
+ const mode = opts?.mode ?? "history";
+ return useCallback(() => {
+ if (mode === "history" && canGoBackInApp()) nav(-1);
+ else nav(parent, { replace: true });
+ }, [nav, parent, mode]);
+}
+
+/** Куда ведёт «Назад» и каким способом. */
+export interface BackTarget {
+ to: string;
+ mode?: BackMode;
+}
+
+interface BackState {
+ /** Родитель текущего экрана из таблицы маршрутов; null — главная и вход. */
+ parent: BackTarget | null;
+ /** Цель, которую задала сама страница (useBackOverride), — важнее родителя. */
+ override: BackTarget | null;
+ setOverride: (t: BackTarget | null) => void;
+}
+
+/** Кладёт BackProvider в App: он знает таблицу маршрутов, страницы — нет (иначе
+ * таблица, импортирующая страницы, импортировалась бы ими же по кругу). */
+export const BackContext = createContext({
+ parent: null,
+ override: null,
+ setOverride: () => undefined,
+});
+
+/** Уйти с экрана к родителю из таблицы — для кнопок внутри страницы вроде
+ * «Другой способ входа»: свой адрес родителя страница не повторяет, иначе он
+ * разъезжается с кнопкой «Назад» над экраном. Вне App (тесты страниц) — на главную. */
+export function useRouteBack(): () => void {
+ const { parent } = useContext(BackContext);
+ return useBack(parent?.to ?? "/", { mode: parent?.mode });
+}
+
+/** Перенацелить кнопку «Назад» над экраном: для режима внутри страницы со своим
+ * адресом или когда родителя знает только она (например, узнав id записи).
+ * Второй кнопки «Назад» страница не рисует. null — цель из таблицы. Действует
+ * только на экранах с родителем: у главной и входа верхней кнопки нет. */
+export function useBackOverride(target: BackTarget | null): void {
+ const { setOverride } = useContext(BackContext);
+ const to = target?.to;
+ const mode = target?.mode;
+ // До отрисовки кадра: иначе мелькнула бы кнопка со старой целью.
+ useLayoutEffect(() => {
+ if (to === undefined) return;
+ setOverride({ to, mode });
+ return () => setOverride(null);
+ }, [setOverride, to, mode]);
+}
diff --git a/driver-pwa/frontend/src/pages/BalancePage.test.tsx b/driver-pwa/frontend/src/pages/BalancePage.test.tsx
index f39b063..c60d4d3 100644
--- a/driver-pwa/frontend/src/pages/BalancePage.test.tsx
+++ b/driver-pwa/frontend/src/pages/BalancePage.test.tsx
@@ -1,7 +1,7 @@
import { describe, it, expect, vi, beforeAll, afterAll } from "vitest";
import { render, screen, within } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
-import { MemoryRouter, Route, Routes } from "react-router-dom";
+import { MemoryRouter, Route, Routes, useLocation } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
// Ответ как у настоящего водителя: статьи 1С, итог отдельным числом.
@@ -52,11 +52,16 @@ import { BalancePage, balancePollMs } from "./BalancePage";
import { markPaymentActivity } from "@/lib/paymentWatch";
import * as driver from "@/api/driver";
-function wrap() {
+function Search() {
+ return
{useLocation().search}
;
+}
+
+function wrap(url = "/") {
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
return render(
-
+
+ } />
экран пополнения} />
@@ -136,6 +141,26 @@ describe("главный экран", () => {
await userEvent.click(await screen.findByRole("button", { name: /Долг по штрафам/ }));
expect(await screen.findByText(/Превышение скорости/)).toBeInTheDocument();
expect(driver.getFines).toHaveBeenCalled();
+ // Фильтр записан в адрес — по нему «Назад» из карточки штрафа вернёт сюда же.
+ expect(screen.getByTestId("search").textContent).toBe("?kind=fines");
+ });
+
+ it("фильтр и период восстанавливаются из адреса", async () => {
+ // Сюда ведёт «Назад» из карточки штрафа (родитель /?kind=fines) — список
+ // штрафов должен встретить водителя сразу, без повторного выбора фильтра.
+ vi.mocked(driver.getStatement).mockClear();
+ wrap("/?kind=fines&from=2026-08-01&to=2026-08-15");
+ expect(await screen.findByText(/Превышение скорости/)).toBeInTheDocument();
+ expect(screen.getByLabelText("Начало периода")).toHaveValue("2026-08-01");
+ expect(screen.getByLabelText("Конец периода")).toHaveValue("2026-08-15");
+ // Проводки при фильтре «Штрафы» не запрашиваются — показаны постановления.
+ expect(driver.getStatement).not.toHaveBeenCalled();
+ });
+
+ it("мусор в адресе не ломает экран — остаются значения по умолчанию", async () => {
+ wrap("/?kind=bogus&from=вчера");
+ expect(await screen.findByText("Аренда автомобиля")).toBeInTheDocument();
+ expect(screen.getByLabelText("Начало периода")).toHaveValue("2026-08-11");
});
it("категории для выбора живут в шторке «Пополнить»", async () => {
diff --git a/driver-pwa/frontend/src/pages/BalancePage.tsx b/driver-pwa/frontend/src/pages/BalancePage.tsx
index 1893cdb..07231c0 100644
--- a/driver-pwa/frontend/src/pages/BalancePage.tsx
+++ b/driver-pwa/frontend/src/pages/BalancePage.tsx
@@ -1,6 +1,6 @@
import { useState } from "react";
import { useQuery } from "@tanstack/react-query";
-import { useNavigate } from "react-router-dom";
+import { useNavigate, useSearchParams } from "react-router-dom";
import { ArrowUp, ChevronRight, LogOut } from "lucide-react";
import { getBalance, type StatementKind } from "@/api/driver";
import { formatMoney, isoDaysAgo, isoToday } from "@/lib/format";
@@ -29,6 +29,10 @@ const MAIN_BUCKETS = ["Долг аренда", "Долг по штрафам"];
export const balancePollMs = (d?: { pending_topup?: number }): number | false =>
(d?.pending_topup ?? 0) > 0 || paymentActivityWithin() ? 4000 : false;
+const KINDS: StatementKind[] = ["all", "charges", "payments", "fines"];
+const isKind = (v: string | null): v is StatementKind => KINDS.includes(v as StatementKind);
+const isIsoDate = (v: string | null): v is string => !!v && /^\d{4}-\d{2}-\d{2}$/.test(v);
+
/**
* Главный экран из двух половин: сверху деньги, снизу — за что они списаны.
*
@@ -45,10 +49,30 @@ export function BalancePage() {
refetchInterval: (q) => balancePollMs(q.state.data),
});
const [sheet, setSheet] = useState(false);
+ // Фильтр выписки живёт в адресе (?kind=&from=&to=), а не в памяти экрана:
+ // вернувшись «Назад» из карточки штрафа, водитель видит тот же список штрафов,
+ // а не «Все операции», и F5 его не сбрасывает. Меняем заменой записи — выбор
+ // фильтра не шаг, по которому надо идти назад.
+ const [params, setParams] = useSearchParams();
+ const rawKind = params.get("kind");
+ const kind: StatementKind = isKind(rawKind) ? rawKind : "all";
// Неделя — тот же период, что у вендора: столько человек помнит свои поездки.
- const [from, setFrom] = useState(isoDaysAgo(7));
- const [to, setTo] = useState(isoToday());
- const [kind, setKind] = useState("all");
+ const rawFrom = params.get("from");
+ const rawTo = params.get("to");
+ const from = isIsoDate(rawFrom) ? rawFrom : isoDaysAgo(7);
+ const to = isIsoDate(rawTo) ? rawTo : isoToday();
+
+ function setFilter(key: "kind" | "from" | "to", value: string) {
+ setParams((prev) => {
+ const next = new URLSearchParams(prev);
+ // Значения по умолчанию в адрес не пишем: «Все операции» и пустая дата —
+ // это просто отсутствие параметра.
+ if (!value || (key === "kind" && value === "all")) next.delete(key);
+ else next.set(key, value);
+ return next;
+ }, { replace: true });
+ }
+ const setKind = (k: StatementKind) => setFilter("kind", k);
const accounts = data?.accounts ?? [];
const total = data?.total ?? accounts.reduce((s, a) => s + a.balance, 0);
@@ -127,14 +151,14 @@ export function BalancePage() {
{/* ── За что списано ─────────────────────────────────────── */}
+ onFrom={(v) => setFilter("from", v)} onTo={(v) => setFilter("to", v)} onKind={setKind} />
{/* Отдельного раздела «Мои пополнения» нет намеренно: пополнения видны в
выписке выше по фильтру, а дублирующий пустой экран сбивал с толку. */}
-
diff --git a/driver-pwa/frontend/src/pages/DebugPage.tsx b/driver-pwa/frontend/src/pages/DebugPage.tsx
index a70d52b..234407d 100644
--- a/driver-pwa/frontend/src/pages/DebugPage.tsx
+++ b/driver-pwa/frontend/src/pages/DebugPage.tsx
@@ -135,9 +135,11 @@ export function DebugPage() {
onClick={() => {
// Свой вход, отложенный на время просмотра, возвращаем на место: иначе
// «посмотреть чужой экран» означало бы заново входить через Telegram.
- if (impersonated && stopImpersonation()) { nav("/"); return; }
+ // Уходим заменой записи: системный «назад» не должен возвращать на
+ // отладку сеанса, который только что закрыли.
+ if (impersonated && stopImpersonation()) { nav("/", { replace: true }); return; }
clear();
- nav(staff.token ? "/dev" : "/login");
+ nav(staff.token ? "/dev" : "/login", { replace: true });
}}
>
{" "}
@@ -145,7 +147,7 @@ export function DebugPage() {
{staff.token && (
{ clear(); staff.clear(); nav("/login"); }}>
+ onClick={() => { clear(); staff.clear(); nav("/login", { replace: true }); }}>
Выйти и из учётки сотрудника
)}
diff --git a/driver-pwa/frontend/src/pages/DevLoginPage.test.tsx b/driver-pwa/frontend/src/pages/DevLoginPage.test.tsx
index b3e9763..48aa079 100644
--- a/driver-pwa/frontend/src/pages/DevLoginPage.test.tsx
+++ b/driver-pwa/frontend/src/pages/DevLoginPage.test.tsx
@@ -1,7 +1,7 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
-import { MemoryRouter } from "react-router-dom";
+import { MemoryRouter, Route, Routes, useNavigationType } from "react-router-dom";
vi.mock("@/api/staff", () => ({
staffLogin: vi.fn(async () => ({ access_token: "staff-tok", requires_2fa: false, partial_token: null })),
@@ -49,6 +49,23 @@ describe("DevLoginPage", () => {
expect(auth.driverName).toBe("Петров Пётр");
});
+ it("выбрал водителя — на главную заменой записи: «назад» не вернёт к выбору", async () => {
+ function Home() {
+ return
главная: {useNavigationType()}
;
+ }
+ useStaff.getState().setStaff("staff-tok", "vlad");
+ render(
+
+
+ } />
+ } />
+
+
+ );
+ await userEvent.click(await screen.findByRole("button", { name: /Петров Пётр/ }));
+ expect(await screen.findByText("главная: REPLACE")).toBeInTheDocument();
+ });
+
it("двухфакторка: пароль сам по себе сеанса не открывает", async () => {
vi.mocked(staffApi.staffLogin).mockResolvedValueOnce({
access_token: null, requires_2fa: true, partial_token: "partial",
diff --git a/driver-pwa/frontend/src/pages/DevLoginPage.tsx b/driver-pwa/frontend/src/pages/DevLoginPage.tsx
index a53076e..992a834 100644
--- a/driver-pwa/frontend/src/pages/DevLoginPage.tsx
+++ b/driver-pwa/frontend/src/pages/DevLoginPage.tsx
@@ -3,6 +3,7 @@ import { useNavigate } from "react-router-dom";
import { toast } from "sonner";
import { apiErrorText } from "@/api/driver";
import { staffLogin, staffLogin2fa } from "@/api/staff";
+import { useRouteBack } from "@/lib/back";
import { useStaff } from "@/store/staff";
import { DriverPicker } from "@/components/DriverPicker";
import { Spinner } from "@/components/Spinner";
@@ -17,6 +18,9 @@ import { Spinner } from "@/components/Spinner";
*/
export function DevLoginPage() {
const nav = useNavigate();
+ // «Я водитель» — туда же, куда «Назад» над экраном: откуда пришли, а с
+ // холодного старта — на главную или ко входу, смотря вошёл ли (routes.tsx).
+ const toDriver = useRouteBack();
const { token: staffToken, username: staffName, setStaff, clear } = useStaff();
const [username, setUsername] = useState("");
const [password, setPassword] = useState("");
@@ -65,7 +69,9 @@ export function DevLoginPage() {
Сотрудник: {staffName}. Приложение откроется от лица выбранного водителя,
деньги в этом режиме не двигаются.
- nav("/")} />
+ {/* Сеанс уже сменился — выбор отработал. Заменой записи: системный
+ «назад» с главной не должен возвращать к выбору водителя. */}
+ nav("/", { replace: true })} />
Выйти из учётки сотрудника
);
@@ -99,8 +105,10 @@ export function DevLoginPage() {
submit2fa()}>
{busy ? : "Подтвердить"}
+ {/* Не «Назад»: так называется кнопка над экраном, и уводит она с
+ экрана совсем. Эта — только к вводу логина и пароля. */}
{ setPartial(null); setCode(""); }}>
- Назад
+ Изменить логин
>
) : (
@@ -124,7 +132,7 @@ export function DevLoginPage() {
{busy ? : "Войти"}
- nav("/login")}>Я водитель
+ Я водитель
>
)}
diff --git a/driver-pwa/frontend/src/pages/FineDetailPage.tsx b/driver-pwa/frontend/src/pages/FineDetailPage.tsx
index 36f26dd..ed48c5f 100644
--- a/driver-pwa/frontend/src/pages/FineDetailPage.tsx
+++ b/driver-pwa/frontend/src/pages/FineDetailPage.tsx
@@ -38,15 +38,13 @@ export function FineDetailPage() {
Штраф не найден
Возможно, он больше не числится за вами.
- nav("/")}>На главную
+ nav("/", { replace: true })}>На главную
);
}
return (
- nav("/")}>‹ Назад
-
{f.photos.length > 0 ? (
{f.photos.map((src, i) => (
diff --git a/driver-pwa/frontend/src/pages/LoginPage.test.tsx b/driver-pwa/frontend/src/pages/LoginPage.test.tsx
index c1dfd68..4b2e4b5 100644
--- a/driver-pwa/frontend/src/pages/LoginPage.test.tsx
+++ b/driver-pwa/frontend/src/pages/LoginPage.test.tsx
@@ -1,7 +1,7 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
-import { MemoryRouter } from "react-router-dom";
+import { MemoryRouter, Route, Routes, useLocation } from "react-router-dom";
vi.mock("@/api/driver", () => ({
authRequest: vi.fn(async () => ({ status: "code_sent", channel: "tg" })),
@@ -30,4 +30,29 @@ describe("LoginPage", () => {
await userEvent.click(screen.getByRole("button", { name: /Войти/i }));
expect(driver.authVerify).toHaveBeenCalledWith("79143054400", "123456");
});
+
+ it("вход по коду — отдельный адрес, и из него есть «Назад» к выбору способа", async () => {
+ // Раньше режим жил в памяти экрана: ни кнопки, ни системного «назад» — с
+ // экрана ввода номера было не вернуться к Telegram.
+ function Where() {
+ const loc = useLocation();
+ return
{loc.pathname + loc.search}
;
+ }
+ render(
+
+
+ } />
+
+ );
+ // На выборе способа «Назад» нет — это экран входа, возвращаться с него некуда.
+ expect(screen.queryByRole("button", { name: "Назад" })).toBeNull();
+
+ await userEvent.click(screen.getByRole("button", { name: /Войти по коду/i }));
+ expect(screen.getByTestId("where").textContent).toBe("/login?by=code");
+ expect(screen.getByLabelText(/Номер телефона/i)).toBeInTheDocument();
+
+ await userEvent.click(screen.getByRole("button", { name: "Назад" }));
+ expect(screen.getByTestId("where").textContent).toBe("/login");
+ expect(screen.getByRole("button", { name: /Войти по коду/i })).toBeInTheDocument();
+ });
});
diff --git a/driver-pwa/frontend/src/pages/LoginPage.tsx b/driver-pwa/frontend/src/pages/LoginPage.tsx
index cadc95a..fe37232 100644
--- a/driver-pwa/frontend/src/pages/LoginPage.tsx
+++ b/driver-pwa/frontend/src/pages/LoginPage.tsx
@@ -1,5 +1,5 @@
import { useEffect, useState } from "react";
-import { useNavigate } from "react-router-dom";
+import { useNavigate, useSearchParams } from "react-router-dom";
import { toast } from "sonner";
import { apiErrorText, authRequest, authVerify, mtsStatus, retryAfterSeconds, tgSession } from "@/api/driver";
import { digitsOnly, formatNational, nationalDigits } from "@/lib/format";
@@ -8,6 +8,7 @@ import { takeReturnTo } from "@/lib/returnTo";
import { useAuth } from "@/store/auth";
import { Spinner } from "@/components/Spinner";
import { InstallHint } from "@/components/InstallHint";
+import { BackButton } from "@/components/BackButton";
// Кулдаун повторной отправки кода — синхронно с бэкендом (60с). Точное значение
// приходит в Retry-After на 429; это дефолт после успешной отправки.
@@ -27,7 +28,11 @@ export function LoginPage() {
const [step, setStep] = useState<"phone" | "code">("phone");
const [channel, setChannel] = useState("");
const [busy, setBusy] = useState(false);
- const [mode, setMode] = useState<"choose" | "code">("choose");
+ // Вход по коду — отдельный шаг со своим адресом (/login?by=code), а не флаг в
+ // памяти: тогда и «Назад» в интерфейсе, и системный «назад» Android одинаково
+ // возвращают к выбору способа входа. Раньше выхода из этого режима не было.
+ const [params, setParams] = useSearchParams();
+ const mode: "choose" | "code" = params.get("by") === "code" ? "code" : "choose";
// Секунды до разрешённой повторной отправки кода (0 — можно отправлять).
const [cooldown, setCooldown] = useState(0);
// Prefetched pairing session so the «Войти через Telegram» control is a real
@@ -114,8 +119,9 @@ export function LoginPage() {
}
return (
-
-
Премиум Водитель
+
+ {mode === "code" && }
+
Премиум Водитель
Вход в приложение
{mode === "choose" ? (
@@ -168,7 +174,7 @@ export function LoginPage() {
)}
- setMode("code")}>Войти по коду
+ setParams({ by: "code" })}>Войти по коду
{/* Предложение установки — только на выборе способа входа: это первый
экран, который видит человек, открывший приложение впервые. На
экранах ввода номера и кода оно отвлекало бы от дела. */}
diff --git a/driver-pwa/frontend/src/pages/MockPayPage.tsx b/driver-pwa/frontend/src/pages/MockPayPage.tsx
index 69d254c..e397cb3 100644
--- a/driver-pwa/frontend/src/pages/MockPayPage.tsx
+++ b/driver-pwa/frontend/src/pages/MockPayPage.tsx
@@ -42,14 +42,13 @@ export function MockPayPage() {
Учебная оплата недоступна
Этот экран работает только при просмотре сотрудником.
- nav("/")}>На главную
+ nav("/", { replace: true })}>На главную
);
}
return (
- nav(-1)}>‹ Назад
Учебная оплата
Банка в этом платеже нет: ни списания, ни чека, ни проводки. Выберите, что
diff --git a/driver-pwa/frontend/src/pages/MtsLoginPage.test.tsx b/driver-pwa/frontend/src/pages/MtsLoginPage.test.tsx
index 409c58d..aa47252 100644
--- a/driver-pwa/frontend/src/pages/MtsLoginPage.test.tsx
+++ b/driver-pwa/frontend/src/pages/MtsLoginPage.test.tsx
@@ -17,6 +17,7 @@ vi.mock("@/api/driver", () => ({
}));
import { MtsLoginPage } from "./MtsLoginPage";
+import { BackProvider } from "@/components/BackBar";
import * as driver from "@/api/driver";
import { useAuth } from "@/store/auth";
@@ -24,8 +25,13 @@ const started = {
session: "S", poll_secret: "P", status: "pending", expires_in: 140, hhe_uri: null,
};
+// Как в App: родителя экрана «Другой способ входа» берёт из таблицы маршрутов.
function wrap() {
- return render();
+ return render(
+
+
+
+ );
}
async function enterPhone(user: ReturnType) {
@@ -90,7 +96,9 @@ describe("MtsLoginPage", () => {
expect(await screen.findByText(/Вход отклонён на телефоне/i)).toBeInTheDocument();
await user.click(screen.getByRole("button", { name: /Войти через Telegram/i }));
- expect(nav).toHaveBeenCalledWith("/login");
+ // К выбору способа (родитель /login/mts в routes.tsx) — заменой записи, а не
+ // новой поверх (здесь истории нет: MemoryRouter, как холодный старт).
+ expect(nav).toHaveBeenCalledWith("/login", { replace: true });
expect(useAuth.getState().token).toBeFalsy();
});
diff --git a/driver-pwa/frontend/src/pages/MtsLoginPage.tsx b/driver-pwa/frontend/src/pages/MtsLoginPage.tsx
index ebb5027..b6f88ba 100644
--- a/driver-pwa/frontend/src/pages/MtsLoginPage.tsx
+++ b/driver-pwa/frontend/src/pages/MtsLoginPage.tsx
@@ -3,6 +3,7 @@ import { useNavigate } from "react-router-dom";
import { toast } from "sonner";
import { apiErrorText, mtsCode, mtsPoll, mtsStart } from "@/api/driver";
import { digitsOnly, formatNational, nationalDigits } from "@/lib/format";
+import { useRouteBack } from "@/lib/back";
import { takeReturnTo } from "@/lib/returnTo";
import { useAuth } from "@/store/auth";
import { Spinner } from "@/components/Spinner";
@@ -35,6 +36,9 @@ const GIVE_UP_MS = 180_000;
export function MtsLoginPage() {
const nav = useNavigate();
+ // К выбору способа входа (родитель в routes.tsx) — шагом назад, а не новой
+ // записью поверх истории: иначе системный «назад» Android возвращал бы сюда.
+ const toLogin = useRouteBack();
const setSession = useAuth((s) => s.setSession);
const [phone, setPhone] = useState("");
const [code, setCode] = useState("");
@@ -137,7 +141,7 @@ export function MtsLoginPage() {
Такое бывает, когда оператор не может доставить подтверждение.
- nav("/login")}>
+
Войти через Telegram
setFailure(null)}>
@@ -200,7 +204,7 @@ export function MtsLoginPage() {
Изменить номер
)}
- nav("/login")}>
+
Другой способ входа
diff --git a/driver-pwa/frontend/src/pages/NotificationsPage.tsx b/driver-pwa/frontend/src/pages/NotificationsPage.tsx
index 9b80561..5eed284 100644
--- a/driver-pwa/frontend/src/pages/NotificationsPage.tsx
+++ b/driver-pwa/frontend/src/pages/NotificationsPage.tsx
@@ -3,7 +3,7 @@ import { useNavigate } from "react-router-dom";
import { Bell } from "lucide-react";
import { getNotifications, markNotificationsRead, type DriverNotification } from "@/api/driver";
-import { AppHeader } from "@/components/AppHeader";
+import { useBack } from "@/lib/back";
import { Spinner } from "@/components/Spinner";
import { OperationIcon } from "@/components/operationIcon";
@@ -28,6 +28,10 @@ const ICON_BY_KIND: Record = {
*/
export function NotificationsPage() {
const nav = useNavigate();
+ // Уведомление о платеже ведёт на главную — а главная и есть экран, с которого
+ // сюда пришли. Туда шагом назад, а не новой записью поверх: иначе системный
+ // «назад» Android возвращал бы в ленту.
+ const back = useBack("/");
const [items, setItems] = useState(null);
const [error, setError] = useState(null);
@@ -45,9 +49,10 @@ export function NotificationsPage() {
};
}, []);
+ // Шапки с названием приложения здесь нет: сверху «Назад» (BackBar в App), под
+ // ним заголовок экрана — двух строк «откуда» и «где я» достаточно.
return (
-
-
+
Уведомления
{error &&
{error}
}
@@ -65,7 +70,7 @@ export function NotificationsPage() {
key={n.id}
type="button"
className="flex gap-3 items-start text-left bg-surface border border-line rounded-xl p-3"
- onClick={() => n.url && nav(n.url)}
+ onClick={() => n.url && (n.url === "/" ? back() : nav(n.url))}
>
diff --git a/driver-pwa/frontend/src/pages/OnboardingPage.tsx b/driver-pwa/frontend/src/pages/OnboardingPage.tsx
index 215f6a3..36a0b49 100644
--- a/driver-pwa/frontend/src/pages/OnboardingPage.tsx
+++ b/driver-pwa/frontend/src/pages/OnboardingPage.tsx
@@ -1,8 +1,12 @@
import { useNavigate } from "react-router-dom";
+import { useRouteBack } from "@/lib/back";
import { loadPairing } from "@/lib/pairing";
export function OnboardingPage() {
const nav = useNavigate();
+ // Ко входу (родитель в routes.tsx) — шагом назад, а не новой записью поверх
+ // истории (см. lib/back).
+ const back = useRouteBack();
const raw = sessionStorage.getItem("pp-onboarding");
const data = raw ? (JSON.parse(raw) as { tg?: string; max?: string; phone: string }) : null;
const pairing = loadPairing();
@@ -40,7 +44,7 @@ export function OnboardingPage() {
Подключить MAX
)}
- nav("/login")}>
+
Назад ко входу
diff --git a/driver-pwa/frontend/src/pages/PaymentPage.test.tsx b/driver-pwa/frontend/src/pages/PaymentPage.test.tsx
index 1490e6e..331cd2b 100644
--- a/driver-pwa/frontend/src/pages/PaymentPage.test.tsx
+++ b/driver-pwa/frontend/src/pages/PaymentPage.test.tsx
@@ -1,7 +1,8 @@
import { describe, it, expect, vi } from "vitest";
import { render, screen, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
-import { MemoryRouter, Routes, Route } from "react-router-dom";
+import { MemoryRouter, Routes, Route, useNavigationType } from "react-router-dom";
const states = ["FORM", "PAID"];
vi.mock("@/api/driver", () => ({
@@ -26,4 +27,23 @@ describe("PaymentPage", () => {
expect(screen.getByRole("link", { name: /Оплатить/i })).toHaveAttribute("href", "https://qr.nspk.ru/x");
await waitFor(() => expect(screen.getByText(/Оплачено/i)).toBeInTheDocument(), { timeout: 3000 });
});
+
+ it("с итога на главную — заменой записи, а не поверх «Оплачено»", async () => {
+ // Иначе системный «назад» с главной возвращал бы на отработавший итог.
+ function Home() {
+ return
главная: {useNavigationType()}
;
+ }
+ render(
+
+
+
+ } />
+ } />
+
+
+
+ );
+ await userEvent.click(await screen.findByRole("button", { name: "На главную" }, { timeout: 3000 }));
+ expect(await screen.findByText("главная: REPLACE")).toBeInTheDocument();
+ });
});
diff --git a/driver-pwa/frontend/src/pages/PaymentPage.tsx b/driver-pwa/frontend/src/pages/PaymentPage.tsx
index a6607bd..3256242 100644
--- a/driver-pwa/frontend/src/pages/PaymentPage.tsx
+++ b/driver-pwa/frontend/src/pages/PaymentPage.tsx
@@ -40,6 +40,10 @@ export function PaymentPage() {
}
}, [paid, qc]);
+ // С итога оплаты на главную — заменой записи: системный «назад» с главной не
+ // должен возвращать на отработавший экран «Оплачено».
+ const home = () => nav("/", { replace: true });
+
const retry = (
nav("/topup", { state: { bucket: st.bucket }, replace: true })}>
Пополнить ещё раз
@@ -54,7 +58,7 @@ export function PaymentPage() {
);
}
@@ -88,7 +92,7 @@ export function PaymentPage() {
Платёж возвращён
Деньги вернулись на счёт, с которого платили. Баланс пересчитаем.
- nav("/")}>На главную
+ На главную
);
}
@@ -102,7 +106,7 @@ export function PaymentPage() {
Не удаётся проверить оплату
Похоже, пропала связь. Если вы уже оплатили, деньги дойдут.
refetch()}>Проверить ещё раз
- nav("/")}>На главную
+ На главную
);
}
diff --git a/driver-pwa/frontend/src/pages/TopupPage.test.tsx b/driver-pwa/frontend/src/pages/TopupPage.test.tsx
index 464b284..74a9e92 100644
--- a/driver-pwa/frontend/src/pages/TopupPage.test.tsx
+++ b/driver-pwa/frontend/src/pages/TopupPage.test.tsx
@@ -1,7 +1,7 @@
import { describe, it, expect, vi } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
-import { MemoryRouter } from "react-router-dom";
+import { MemoryRouter, Route, Routes, useNavigate } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
vi.mock("@/api/driver", () => ({
@@ -60,6 +60,31 @@ describe("TopupPage", () => {
await userEvent.click(screen.getByRole("button", { name: /Оплатить/i }));
expect(driver.topup).toHaveBeenCalledWith("Долг по штрафам", 500, "qr", false);
});
+
+ it("платёж создан — «Назад» с оплаты не возвращает к набору суммы", async () => {
+ // Экран оплаты подменяет клавиатуру в истории: шаг назад с него ведёт туда,
+ // откуда пришли пополнять, а не к уже отработавшей форме.
+ function StepBack() {
+ const nav = useNavigate();
+ return nav(-1)}>шаг назад;
+ }
+ const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
+ render(
+
+
+
+ главная} />
+ } />
+ } />
+
+
+
+ );
+ for (const k of ["5", "0", "0"]) await userEvent.click(screen.getByRole("button", { name: k }));
+ await userEvent.click(screen.getByRole("button", { name: /Оплатить/i }));
+ await userEvent.click(await screen.findByRole("button", { name: "шаг назад" }));
+ expect(await screen.findByText("главная")).toBeInTheDocument();
+ });
});
describe("боевая оплата под просмотром", () => {
diff --git a/driver-pwa/frontend/src/pages/TopupPage.tsx b/driver-pwa/frontend/src/pages/TopupPage.tsx
index 556da30..fb819c5 100644
--- a/driver-pwa/frontend/src/pages/TopupPage.tsx
+++ b/driver-pwa/frontend/src/pages/TopupPage.tsx
@@ -44,16 +44,22 @@ export function TopupPage() {
setBusy(true);
try {
const r = await topup(bucket, base, method as "qr" | "card", livePay);
+ // Платёж уже создан — клавиатура суммы своё отработала. Уходим с неё
+ // заменой записи: «Назад» с оплаты ведёт на экран, откуда пришли
+ // пополнять, а не к повторному набору той же суммы.
// Учебный платёж (сотрудник смотрит от чужого лица): банка нет, платить
// негде — сразу на экран выбора исхода, дальше всё как у водителя.
if (r.mock) {
- nav(`/mock-pay/${r.order_id}`, { state: { total: r.total, bucket, base, method } });
+ nav(`/mock-pay/${r.order_id}`, { replace: true, state: { total: r.total, bucket, base, method } });
return;
}
// Отметка ДО ухода на оплату: вернись водитель на баланс жестом «назад»
// раньше вебхука банка, экран обязан опрашивать себя и подхватить платёж.
markPaymentActivity();
- nav(`/pay/${r.order_id}`, { state: { payUrl: r.pay_url, total: r.total, bucket, base, method } });
+ nav(`/pay/${r.order_id}`, {
+ replace: true,
+ state: { payUrl: r.pay_url, total: r.total, bucket, base, method },
+ });
} catch (err: unknown) {
// Текст с сервера, а не глухое «не удалось»: минимум СБП, потолок суммы и
// неизвестная категория объясняются словами, иначе экран молча не реагирует.
@@ -65,8 +71,6 @@ export function TopupPage() {
return (
- nav(-1)}>‹ Назад
-
{/* Категорию выбирают в шторке на главном экране. Пришли оттуда — показываем
выбранное строкой, а не рядом чипов: второй выбор того же самого сбивает
с толку. Чипы остаются для входа сюда напрямую (кнопка «Пополнить» без
diff --git a/driver-pwa/frontend/src/routes.test.tsx b/driver-pwa/frontend/src/routes.test.tsx
new file mode 100644
index 0000000..2a32566
--- /dev/null
+++ b/driver-pwa/frontend/src/routes.test.tsx
@@ -0,0 +1,146 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { cleanup, render, screen } from "@testing-library/react";
+import { MemoryRouter, useLocation } from "react-router-dom";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import App from "@/App";
+import appSource from "@/App.tsx?raw";
+import { ROUTES, findRoute, resolveParent } from "@/routes";
+import { clearPairing, savePairing } from "@/lib/pairing";
+import { useAuth } from "@/store/auth";
+import { useStaff } from "@/store/staff";
+
+/**
+ * Сторож правила «Назад на каждом экране» (задача 6385, см. CLAUDE.md).
+ *
+ * Ходит по ТОЙ ЖЕ таблице, из которой App рисует маршруты: новый экран попадает
+ * под проверку сам. Сеть при этом висит вечно — экраны застревают в загрузке, а
+ * именно в таких состояниях кнопку раньше и теряли (голый спиннер карточки
+ * штрафа, пустой онбординг).
+ */
+
+/** Единственные экраны без «Назад»: главная и вход. Новый экран сюда не
+ * добавляют — ему заводят родителя в routes.tsx. */
+const ROOTS = ["/", "/login"];
+
+/** Адрес-образец: параметры пути заменяем единицей (/fines/:fineId → /fines/1). */
+const sample = (path: string) => path.replace(/:[^/]+/g, "1");
+
+/** Исходники приложения, кроме тестов и App: там быть не должно. */
+const sources = import.meta.glob(["./**/*.tsx", "!./**/*.test.tsx", "!./App.tsx"], {
+ query: "?raw",
+ import: "default",
+ eager: true,
+});
+
+/** Комментарии упоминают словами — проверяем только код. */
+function stripComments(src: string): string {
+ return src.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
+}
+
+function Where() {
+ return
{useLocation().pathname}
;
+}
+
+function renderAt(url: string) {
+ const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
+ return render(
+
+
+
+
+
+
+ );
+}
+
+describe("«Назад» на каждом экране", () => {
+ beforeEach(() => {
+ // Любой запрос (ky ходит через глобальный fetch) не отвечает никогда.
+ vi.stubGlobal("fetch", vi.fn(() => new Promise(() => {})));
+ window.history.replaceState(null, "", "/");
+ // Пускаем всюду: водитель под просмотром сотрудника проходит и RequireAuth,
+ // и RequireStaff, и учебную оплату; сессия Telegram держит экран ожидания.
+ useAuth.getState().setSession("t", 42, { impersonated: true, driverName: "Проверка" });
+ useStaff.getState().setStaff("s", "staff");
+ savePairing({ pair_session: "S", poll_secret: "P", confirm_code: "1234", deep_link: null });
+ });
+ afterEach(() => {
+ // Сначала размонтировать: иначе сброс входа ниже гонит смонтированный экран
+ // на /login мимо act().
+ cleanup();
+ vi.unstubAllGlobals();
+ useAuth.getState().clear();
+ useStaff.getState().clear();
+ clearPairing();
+ });
+
+ it.each(ROUTES.map((r) => [r.path, r] as const))("%s", (_path, r) => {
+ // Экраны входа пускают только того, кто ещё не вошёл.
+ if (r.guard === "guest") useAuth.getState().clear();
+ const url = sample(r.path);
+ renderAt(url);
+ // Проверяем сам экран, а не тот, куда увела охрана маршрута.
+ expect(screen.getByTestId("where").textContent).toBe(url);
+ const back = screen.queryAllByRole("button", { name: "Назад" });
+ // Ровно одна: две кнопки с одним именем и разным поведением путают.
+ expect(back).toHaveLength(r.parent === null ? 0 : 1);
+ });
+
+ it.each(ROUTES.filter((r) => r.guard === "guest").map((r) => r.path))(
+ "вошедшего %s уводит на главную",
+ (path) => {
+ // Так «Назад» после входа по ссылке не возвращает к отработавшему входу.
+ renderAt(path);
+ expect(screen.getByTestId("where").textContent).toBe("/");
+ }
+ );
+
+ it("родителя нет только у главной и входа", () => {
+ const roots = ROUTES.filter((r) => r.parent === null).map((r) => r.path);
+ expect(roots.sort()).toEqual([...ROOTS].sort());
+ });
+
+ it("адрес находит свой же экран, а родитель — другой существующий", () => {
+ for (const r of ROUTES) {
+ const hit = findRoute(sample(r.path));
+ // BackBar должен взять тот же экран, что нарисовал .
+ expect(hit?.route, r.path).toBe(r);
+ if (r.parent === null) continue;
+ for (const signedIn of [true, false]) {
+ const to = resolveParent(r.parent, { params: hit!.params, search: new URLSearchParams(), signedIn });
+ const target = findRoute(to.split("?")[0]);
+ // Опечатка в родителе или родитель-сам-себе: с холодного старта «Назад»
+ // заменил бы экран им же — кнопка есть, а уйти нельзя.
+ expect(target, `${r.path} → ${to}`).not.toBeNull();
+ expect(target!.route, `${r.path} → ${to}`).not.toBe(r);
+ }
+ }
+ });
+
+ it("родитель может зависеть от входа: вход сотрудника ведёт туда, откуда пришли", () => {
+ const hit = findRoute("/dev");
+ expect(hit).not.toBeNull();
+ const ctx = { params: hit!.params, search: new URLSearchParams() };
+ // Уже вошёл водителем (долгий тап с главной) — на главную; нет — ко входу.
+ expect(resolveParent(hit!.route.parent!, { ...ctx, signedIn: true })).toBe("/");
+ expect(resolveParent(hit!.route.parent!, { ...ctx, signedIn: false })).toBe("/login");
+ });
+
+ it("App рисует экраны только из таблицы маршрутов", () => {
+ // , вписанный в App мимо таблицы, остался бы без «Назад» и без
+ // проверки выше. Разрешены только ROUTES.map и перехват неизвестных адресов.
+ const code = stripComments(appSource);
+ expect(code.match(/ в страницах и компонентах нет", () => {
+ // Экран, заведённый внутри страницы, тоже прошёл бы мимо таблицы.
+ const nested = Object.entries(sources)
+ .filter(([, src]) => //]/.test(stripComments(src)))
+ .map(([file]) => file);
+ expect(Object.keys(sources).length).toBeGreaterThan(10);
+ expect(nested).toEqual([]);
+ });
+});
diff --git a/driver-pwa/frontend/src/routes.tsx b/driver-pwa/frontend/src/routes.tsx
new file mode 100644
index 0000000..5db4ac9
--- /dev/null
+++ b/driver-pwa/frontend/src/routes.tsx
@@ -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;
+}
+
+/**
+ * Все экраны приложения — единственный источник и для в App, и для
+ * кнопки «Назад» (BackBar), и для теста-сторожа, который проверяет её на каждом.
+ */
+export const ROUTES: AppRoute[] = [
+ { path: "/", element: , guard: "auth", parent: null },
+ { path: "/login", element: , guard: "guest", parent: null },
+ { path: "/login/mts", element: , guard: "guest", parent: "/login" },
+ { path: "/tg-wait", element: , guard: "guest", parent: "/login" },
+ { path: "/onboarding", element: , guard: "guest", parent: "/login" },
+ // Сотрудник, уже вошедший водителем, попадает сюда долгим тапом с главной —
+ // туда и возвращаем; без входа возвращаться некуда, кроме экрана входа.
+ { path: "/dev", element: , parent: ({ signedIn }) => (signedIn ? "/" : "/login") },
+ { path: "/notifications", element: , guard: "auth", parent: "/" },
+ { path: "/topup", element: , guard: "auth", parent: "/" },
+ { path: "/pay/:orderId", element: , guard: "auth", parent: "/" },
+ { path: "/mock-pay/:orderId", element: , guard: "auth", parent: "/" },
+ // Карточку открывают из списка штрафов — к нему и возвращаем, даже если её
+ // открыли пушем «Новый штраф» с холодного старта.
+ { path: "/fines/:fineId", element: , guard: "auth", parent: "/?kind=fines" },
+ { path: "/debug", element: , guard: "staff", parent: "/" },
+];
+
+/** Маршрут из таблицы, под который попадает адрес, — с параметрами пути. */
+export function findRoute(pathname: string): { route: AppRoute; params: Params } | null {
+ // Тем же ранжированием, что у (статичный сегмент сильнее параметра),
+ // а не первым совпадением по порядку таблицы: иначе «Назад» взял бы родителя
+ // не того экрана, что нарисован.
+ const hit = matchRoutes(ROUTES, pathname)?.[0];
+ return hit ? { route: hit.route, params: hit.params } : null;
+}
+
+export function resolveParent(parent: Exclude, ctx: ParentCtx): string {
+ return typeof parent === "function" ? parent(ctx) : parent;
+}