From ab2ad8d471982fc6aa43ad7aeb6d145fcef7c225 Mon Sep 17 00:00:00 2001 From: vladtechno Date: Fri, 25 Sep 2026 21:53:48 +1000 Subject: [PATCH] =?UTF-8?q?feat(nav):=20=D0=BA=D0=BD=D0=BE=D0=BF=D0=BA?= =?UTF-8?q?=D0=B0=20=C2=AB=D0=9D=D0=B0=D0=B7=D0=B0=D0=B4=C2=BB=20=D0=BD?= =?UTF-8?q?=D0=B0=20=D0=BA=D0=B0=D0=B6=D0=B4=D0=BE=D0=BC=20=D1=8D=D0=BA?= =?UTF-8?q?=D1=80=D0=B0=D0=BD=D0=B5=20+=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8?= =?UTF-8?q?=D0=BB=D0=BE=20=D0=B4=D0=BB=D1=8F=20=D0=BD=D0=BE=D0=B2=D1=8B?= =?UTF-8?q?=D1=85=20=D1=80=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=D0=BE=D0=B2=20(?= =?UTF-8?q?=D0=B7=D0=B0=D0=B4=D0=B0=D1=87=D0=B0=206385)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit На айфоне у установленного приложения нет системной «назад», а жест от края после холодного старта или открытия из пуша не делает ничего — водитель застревал в «Уведомлениях», на ожидании Telegram и оплаты, на спиннере штрафа. - Все экраны заводятся в таблице src/routes.tsx с обязательным родителем (null — только у главной и входа); App рисует только из неё. - 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 --- driver-pwa/CLAUDE.md | 48 +++++ driver-pwa/frontend/src/App.back.test.tsx | 189 ++++++++++++++++++ driver-pwa/frontend/src/App.tsx | 95 +++++---- .../frontend/src/components/BackBar.tsx | 43 ++++ .../frontend/src/components/BackButton.tsx | 26 +++ .../src/components/ErrorBoundary.test.tsx | 66 ++++++ .../frontend/src/components/ErrorBoundary.tsx | 54 +++++ .../src/components/ImpersonationBar.tsx | 6 +- driver-pwa/frontend/src/lib/back.test.tsx | 124 ++++++++++++ driver-pwa/frontend/src/lib/back.ts | 89 +++++++++ .../frontend/src/pages/BalancePage.test.tsx | 31 ++- driver-pwa/frontend/src/pages/BalancePage.tsx | 36 +++- driver-pwa/frontend/src/pages/DebugPage.tsx | 8 +- .../frontend/src/pages/DevLoginPage.test.tsx | 19 +- .../frontend/src/pages/DevLoginPage.tsx | 14 +- .../frontend/src/pages/FineDetailPage.tsx | 4 +- .../frontend/src/pages/LoginPage.test.tsx | 27 ++- driver-pwa/frontend/src/pages/LoginPage.tsx | 16 +- driver-pwa/frontend/src/pages/MockPayPage.tsx | 3 +- .../frontend/src/pages/MtsLoginPage.test.tsx | 12 +- .../frontend/src/pages/MtsLoginPage.tsx | 8 +- .../frontend/src/pages/NotificationsPage.tsx | 13 +- .../frontend/src/pages/OnboardingPage.tsx | 6 +- .../frontend/src/pages/PaymentPage.test.tsx | 22 +- driver-pwa/frontend/src/pages/PaymentPage.tsx | 10 +- .../frontend/src/pages/TopupPage.test.tsx | 27 ++- driver-pwa/frontend/src/pages/TopupPage.tsx | 12 +- driver-pwa/frontend/src/routes.test.tsx | 146 ++++++++++++++ driver-pwa/frontend/src/routes.tsx | 75 +++++++ 29 files changed, 1148 insertions(+), 81 deletions(-) create mode 100644 driver-pwa/CLAUDE.md create mode 100644 driver-pwa/frontend/src/App.back.test.tsx create mode 100644 driver-pwa/frontend/src/components/BackBar.tsx create mode 100644 driver-pwa/frontend/src/components/BackButton.tsx create mode 100644 driver-pwa/frontend/src/components/ErrorBoundary.test.tsx create mode 100644 driver-pwa/frontend/src/components/ErrorBoundary.tsx create mode 100644 driver-pwa/frontend/src/lib/back.test.tsx create mode 100644 driver-pwa/frontend/src/lib/back.ts create mode 100644 driver-pwa/frontend/src/routes.test.tsx create mode 100644 driver-pwa/frontend/src/routes.tsx 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

{loc.pathname}

; +} + +function app() { + return render( + + + + в раздел} /> + глубже} /> + } /> + + + ); +} + +const idx = () => (window.history.state as { idx?: number } | null)?.idx; + +describe("canGoBackInApp", () => { + it("смотрит на счётчик записей BrowserRouter, а не на длину истории", () => { + window.history.replaceState(null, "", "/"); + expect(canGoBackInApp()).toBe(false); + window.history.replaceState({ idx: 0 }, "", "/"); + expect(canGoBackInApp()).toBe(false); + window.history.replaceState({ idx: 2 }, "", "/"); + expect(canGoBackInApp()).toBe(true); + }); +}); + +describe("кнопка «Назад»", () => { + beforeEach(() => window.history.replaceState(null, "", "/")); + + it("есть история в приложении — ровно один шаг назад", async () => { + app(); + await userEvent.click(screen.getByRole("link", { name: "в раздел" })); + await userEvent.click(screen.getByRole("link", { name: "глубже" })); + expect(idx()).toBe(2); + const len = window.history.length; + + await userEvent.click(screen.getByRole("button", { name: "Назад" })); + // popstate в jsdom асинхронный — ждём. + await waitFor(() => expect(screen.getByTestId("where").textContent).toBe("/a")); + expect(window.location.pathname).toBe("/a"); + expect(idx()).toBe(1); + expect(window.history.length).toBe(len); + }); + + it("холодный старт (пуш, ссылка) — на родителя заменой, история не растёт", async () => { + window.history.replaceState(null, "", "/a/b"); + app(); + expect(idx()).toBe(0); + const len = window.history.length; + + await userEvent.click(screen.getByRole("button", { name: "Назад" })); + expect(screen.getByTestId("where").textContent).toBe("/"); + expect(window.location.pathname).toBe("/"); + expect(idx()).toBe(0); + expect(window.history.length).toBe(len); + }); + + it("режим parent — на родителя даже при истории позади", async () => { + render( + + + + в раздел} /> + } /> + родитель

} /> +
+
+ ); + 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 && ( )} 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() { + {/* Не «Назад»: так называется кнопка над экраном, и уводит она с + экрана совсем. Эта — только к вводу логина и пароля. */} ) : ( @@ -124,7 +132,7 @@ export function DevLoginPage() { - + )} 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() {

Штраф не найден

Возможно, он больше не числится за вами.

- +
); } return (
- - {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() { )} - + {/* Предложение установки — только на выборе способа входа: это первый экран, который видит человек, открывший приложение впервые. На экранах ввода номера и кода оно отвлекало бы от дела. */} 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() {

Учебная оплата недоступна

Этот экран работает только при просмотре сотрудником.

- +
); } return (
-

Учебная оплата

Банка в этом платеже нет: ни списания, ни чека, ни проводки. Выберите, что 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() {

Такое бывает, когда оператор не может доставить подтверждение.

- )} -
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 )} -
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 = ( +
); } @@ -88,7 +92,7 @@ export function PaymentPage() {

Платёж возвращён

Деньги вернулись на счёт, с которого платили. Баланс пересчитаем.

- +
); } @@ -102,7 +106,7 @@ export function PaymentPage() {

Не удаётся проверить оплату

Похоже, пропала связь. Если вы уже оплатили, деньги дойдут.

- +
); } 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 ; + } + 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 (
- - {/* Категорию выбирают в шторке на главном экране. Пришли оттуда — показываем выбранное строкой, а не рядом чипов: второй выбор того же самого сбивает с толку. Чипы остаются для входа сюда напрямую (кнопка «Пополнить» без 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; +}