feat(nav): кнопка «Назад» на каждом экране + правило для новых разделов (задача 6385)

На айфоне у установленного приложения нет системной «назад», а жест от края
после холодного старта или открытия из пуша не делает ничего — водитель
застревал в «Уведомлениях», на ожидании Telegram и оплаты, на спиннере штрафа.

- Все экраны заводятся в таблице src/routes.tsx с обязательным родителем
  (null — только у главной и входа); App рисует <Route> только из неё.
- BackBar над маршрутами показывает «Назад» (44 px) в любом состоянии экрана.
  Логика в lib/back.ts: есть история этого запуска (history.state.idx > 0) —
  шаг назад, нет — на родителя с replace.
- Тест-сторож обходит таблицу с зависшей сетью и требует «Назад» на каждом
  экране с родителем; список «корневых» экранов закреплён.
- После входа/оплаты/выхода переходы с replace — «Назад» не возвращает на
  отработанную форму; экраны входа уводят вошедшего на главную.
- Фильтр выписки (?kind=, период) и вход по коду (?by=code) — в адресе:
  «Назад» из штрафа возвращает к списку штрафов.
- ErrorBoundary вместо белого экрана при падении.
- driver-pwa/CLAUDE.md — правило и чек-лист нового раздела.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
tremble7681andClaude Opus 5.5 committed 2026-09-25 21:53:48 +10:00
1 parent 7d8f4b8998
commit ab2ad8d471
29 files changed
+1139 -72

No files matched your search

+48
View File
@@ -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`
`<Route>` руками не писать, вложенных `<Routes>` в страницах не заводить.
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` — сторож: все экраны при вечно висящей сети, родитель
существует и не сам экран, ни одного `<Route>` мимо таблицы.
**Команды** (из `frontend/`): `npm test`, `npx tsc -b`, `npm run build`.
+189
View File
@@ -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) => (
<QueryClientProvider client={new QueryClient({ defaultOptions: { queries: { retry: false } } })}>
{children}
</QueryClientProvider>
);
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(
<MemoryRouter initialEntries={["/notifications?n=5"]}><App /></MemoryRouter>
));
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(<BrowserRouter><App /></BrowserRouter>));
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(<BrowserRouter><App /></BrowserRouter>));
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(<MemoryRouter initialEntries={["/dev"]}><Seen /><App /></MemoryRouter>));
await userEvent.click(screen.getByRole("button", { name: "Я водитель" }));
expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
expect(seen).toEqual(["/dev", "/"]);
});
it("карточка штрафа с холодного старта: «Назад» — в список штрафов", async () => {
render(withQuery(<MemoryRouter initialEntries={["/fines/12"]}><App /></MemoryRouter>));
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(<BrowserRouter><App /></BrowserRouter>));
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(<BrowserRouter><App /></BrowserRouter>));
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();
});
});
+51 -26
View File
@@ -1,22 +1,13 @@
import type { ReactNode } from "react"; 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 { Navigate, Route, Routes, useLocation, useNavigate } from "react-router-dom";
import { useAuth } from "@/store/auth"; import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff"; import { useStaff } from "@/store/staff";
import { setReturnTo } from "@/lib/returnTo"; import { setReturnTo } from "@/lib/returnTo";
import { ImpersonationBar } from "@/components/ImpersonationBar"; import { ImpersonationBar } from "@/components/ImpersonationBar";
import { LoginPage } from "@/pages/LoginPage"; import { BackBar, BackProvider } from "@/components/BackBar";
import { MtsLoginPage } from "@/pages/MtsLoginPage"; import { ErrorBoundary } from "@/components/ErrorBoundary";
import { TgWaitPage } from "@/pages/TgWaitPage"; import { ROUTES, findRoute, type AppRoute } from "@/routes";
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 { markNotificationsRead } from "@/api/driver"; import { markNotificationsRead } from "@/api/driver";
import { syncSubscription } from "@/lib/push"; import { syncSubscription } from "@/lib/push";
@@ -39,6 +30,25 @@ function RequireStaff({ children }: { children: ReactNode }) {
return impersonated || staffToken ? <>{children}</> : <Navigate to="/" replace />; return impersonated || staffToken ? <>{children}</> : <Navigate to="/" replace />;
} }
/**
* Экраны входа — только тому, кто ещё не вошёл. Вход после ссылки или пуша
* заменяет лишь последнюю запись истории, и экран входа остаётся позади: шаг
* назад (кнопкой или жестом) показал бы вошедшему выбор способа входа — без
* «Назад» и без пути дальше, кроме нового, платного входа. Отсюда — на главную.
*
* Смотрим на вход, с которым ПРИШЛИ на эту запись: токен, появившийся уже здесь,
* значит, что экран сам довёл вход и сейчас уведёт водителя туда, куда тот шёл
* (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 ? <Navigate to="/" replace /> : <>{children}</>;
}
/** /**
* Нажатие по пушу — единственный честный признак, что уведомление увидели. * Нажатие по пушу — единственный честный признак, что уведомление увидели.
* Сам воркер отметить его не может: токен водителя лежит в хранилище страницы, * Сам воркер отметить его не может: токен водителя лежит в хранилище страницы,
@@ -83,29 +93,44 @@ function SyncPushSubscription() {
return null; return null;
} }
function guarded(r: AppRoute): ReactNode {
if (r.guard === "staff") return <RequireAuth><RequireStaff>{r.element}</RequireStaff></RequireAuth>;
if (r.guard === "auth") return <RequireAuth>{r.element}</RequireAuth>;
if (r.guard === "guest") return <GuestOnly>{r.element}</GuestOnly>;
return r.element;
}
export default function App() { export default function App() {
const loc = useLocation();
// Упавшей главной или экрану входа «Назад» сверху не положен — вместо него
// страховка сама предложит «На главную».
const root = findRoute(loc.pathname)?.route.parent === null;
return ( return (
<div className="mx-auto max-w-md min-h-full px-4 pt-3 pb-8"> <BackProvider>
{/* Отступ сверху не меньше системной полосы iPhone: если приложение когда-нибудь
начнёт рисовать под ней, «Назад» всё равно останется под пальцем. */}
<div className="mx-auto max-w-md min-h-full px-4 pt-[max(0.75rem,env(safe-area-inset-top))] pb-8">
{/* Плашка живёт над маршрутами: чей экран открыт, видно на каждом из них, {/* Плашка живёт над маршрутами: чей экран открыт, видно на каждом из них,
а не только там, где про неё вспомнили. Сама решает, показываться ли. */} а не только там, где про неё вспомнили. Сама решает, показываться ли. */}
<ImpersonationBar /> <ImpersonationBar />
{/* «Назад» — тоже над маршрутами и вне страховки от падений: есть на любом
экране кроме главной и входа, в любом его состоянии (см. routes.tsx). */}
<BackBar />
<SyncPushSubscription /> <SyncPushSubscription />
<MarkPushRead /> <MarkPushRead />
{/* Ключ — адрес целиком: выбор на экране живёт в строке запроса
(?kind=, ?by=code), и уход с неё — уже другой экран. */}
<ErrorBoundary resetKey={loc.pathname + loc.search} home={root}>
<Routes> <Routes>
<Route path="/login" element={<LoginPage />} /> {/* Экраны — только из таблицы ROUTES: по ней же BackBar ищет родителя,
<Route path="/login/mts" element={<MtsLoginPage />} /> а тест-сторож проверяет «Назад». Сюда <Route> руками не добавлять. */}
<Route path="/dev" element={<DevLoginPage />} /> {ROUTES.map((r) => (
<Route path="/tg-wait" element={<TgWaitPage />} /> <Route key={r.path} path={r.path} element={guarded(r)} />
<Route path="/onboarding" element={<OnboardingPage />} /> ))}
<Route path="/" element={<RequireAuth><BalancePage /></RequireAuth>} />
<Route path="/topup" element={<RequireAuth><TopupPage /></RequireAuth>} />
<Route path="/pay/:orderId" element={<RequireAuth><PaymentPage /></RequireAuth>} />
<Route path="/mock-pay/:orderId" element={<RequireAuth><MockPayPage /></RequireAuth>} />
<Route path="/fines/:fineId" element={<RequireAuth><FineDetailPage /></RequireAuth>} />
<Route path="/notifications" element={<RequireAuth><NotificationsPage /></RequireAuth>} />
<Route path="/debug" element={<RequireAuth><RequireStaff><DebugPage /></RequireStaff></RequireAuth>} />
<Route path="*" element={<Navigate to="/" replace />} /> <Route path="*" element={<Navigate to="/" replace />} />
</Routes> </Routes>
</ErrorBoundary>
</div> </div>
</BackProvider>
); );
} }
@@ -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<BackTarget | null>(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 <BackContext.Provider value={{ parent, override, setOverride }}>{children}</BackContext.Provider>;
}
/**
* Строка «Назад» над экраном. Стоит в App над маршрутами, а не в страницах:
* так она есть в любом состоянии экрана — загрузка, ошибка, пустота, редирект
* охраны, — и новый раздел получает её сам, стоит завести его в таблице
* маршрутов с родителем. У главной и входа родителя нет — строки тоже.
*/
export function BackBar() {
const { parent, override } = useContext(BackContext);
if (!parent) return null;
const target = override ?? parent;
return <BackButton to={target.to} mode={target.mode} />;
}
@@ -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 (
<div className="mb-1">
<button
type="button"
onClick={back}
className="-ml-2 inline-flex items-center gap-0.5 h-11 min-w-11 pl-1 pr-3 text-sm font-semibold text-ink-soft active:text-ink"
>
<ChevronLeft size={22} aria-hidden="true" />
Назад
</button>
</div>
);
}
@@ -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(
<QueryClientProvider client={new QueryClient({ defaultOptions: { queries: { retry: false } } })}>
<MemoryRouter initialEntries={[url]}><App /></MemoryRouter>
</QueryClientProvider>
);
describe("экран упал при отрисовке", () => {
beforeEach(() => {
vi.stubGlobal("fetch", vi.fn(() => new Promise<Response>(() => {})));
// 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();
});
});
@@ -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 (
<div className="pt-16 text-center">
<p className="text-sm font-semibold mb-1">Экран не открылся</p>
<p className="text-muted text-xs mb-6">Перезагрузите приложение — обычно этого достаточно.</p>
<button
className="btn-primary flex items-center justify-center gap-2"
onClick={() => window.location.reload()}
>
<RotateCw size={16} aria-hidden="true" /> Перезагрузить
</button>
{this.props.home && (
// Полная загрузка с чистого адреса: сбрасывает и строку запроса, и
// всё, что приложение успело держать в памяти.
<button className="btn-ghost mt-3" onClick={() => window.location.replace("/")}>
На главную
</button>
)}
</div>
);
}
}
@@ -1,5 +1,6 @@
import { useLocation, useNavigate } from "react-router-dom"; import { useLocation, useNavigate } from "react-router-dom";
import { Eye } from "lucide-react"; import { Eye } from "lucide-react";
import { useRouteBack } from "@/lib/back";
import { useAuth } from "@/store/auth"; import { useAuth } from "@/store/auth";
/** /**
@@ -14,6 +15,9 @@ export function ImpersonationBar() {
const nav = useNavigate(); const nav = useNavigate();
const loc = useLocation(); const loc = useLocation();
const { impersonated, driverName, driverId } = useAuth(); const { impersonated, driverName, driverId } = useAuth();
// С отладки — туда, откуда на неё пришли (иначе к её родителю в routes.tsx),
// а не новой записью главной поверх: системный «назад» вернул бы на отладку.
const back = useRouteBack();
if (!impersonated) return null; if (!impersonated) return null;
const onDebug = loc.pathname === "/debug"; const onDebug = loc.pathname === "/debug";
@@ -25,7 +29,7 @@ export function ImpersonationBar() {
</span> </span>
<button <button
className="ml-auto shrink-0 underline underline-offset-2" className="ml-auto shrink-0 underline underline-offset-2"
onClick={() => nav(onDebug ? "/" : "/debug")} onClick={() => (onDebug ? back() : nav("/debug"))}
> >
{onDebug ? "к приложению" : "отладка"} {onDebug ? "к приложению" : "отладка"}
</button> </button>
+124
View File
@@ -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 <p data-testid="where">{loc.pathname}</p>;
}
function app() {
return render(
<BrowserRouter>
<Where />
<Routes>
<Route path="/" element={<Link to="/a">в раздел</Link>} />
<Route path="/a" element={<Link to="/a/b">глубже</Link>} />
<Route path="/a/b" element={<BackButton to="/" />} />
</Routes>
</BrowserRouter>
);
}
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(
<BrowserRouter>
<Where />
<Routes>
<Route path="/" element={<Link to="/a">в раздел</Link>} />
<Route path="/a" element={<BackButton to="/b" mode="parent" />} />
<Route path="/b" element={<p>родитель</p>} />
</Routes>
</BrowserRouter>
);
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 <p>режим</p>;
}
render(
<MemoryRouter initialEntries={["/topup"]}>
<BackProvider>
<BackBar />
<Routes>
<Route path="/" element={<p>главная</p>} />
<Route path="/topup" element={<Mode />} />
<Route path="/notifications" element={<p>лента</p>} />
</Routes>
</BackProvider>
</MemoryRouter>
);
// Кнопка по-прежнему одна — страница не рисует вторую.
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();
});
});
+89
View File
@@ -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<BackState>({
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]);
}
@@ -1,7 +1,7 @@
import { describe, it, expect, vi, beforeAll, afterAll } from "vitest"; import { describe, it, expect, vi, beforeAll, afterAll } from "vitest";
import { render, screen, within } from "@testing-library/react"; import { render, screen, within } from "@testing-library/react";
import userEvent from "@testing-library/user-event"; 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"; import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
// Ответ как у настоящего водителя: статьи 1С, итог отдельным числом. // Ответ как у настоящего водителя: статьи 1С, итог отдельным числом.
@@ -52,11 +52,16 @@ import { BalancePage, balancePollMs } from "./BalancePage";
import { markPaymentActivity } from "@/lib/paymentWatch"; import { markPaymentActivity } from "@/lib/paymentWatch";
import * as driver from "@/api/driver"; import * as driver from "@/api/driver";
function wrap() { function Search() {
return <p data-testid="search">{useLocation().search}</p>;
}
function wrap(url = "/") {
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } }); const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
return render( return render(
<QueryClientProvider client={qc}> <QueryClientProvider client={qc}>
<MemoryRouter> <MemoryRouter initialEntries={[url]}>
<Search />
<Routes> <Routes>
<Route path="/" element={<BalancePage />} /> <Route path="/" element={<BalancePage />} />
<Route path="/topup" element={<p>экран пополнения</p>} /> <Route path="/topup" element={<p>экран пополнения</p>} />
@@ -136,6 +141,26 @@ describe("главный экран", () => {
await userEvent.click(await screen.findByRole("button", { name: /Долг по штрафам/ })); await userEvent.click(await screen.findByRole("button", { name: /Долг по штрафам/ }));
expect(await screen.findByText(/Превышение скорости/)).toBeInTheDocument(); expect(await screen.findByText(/Превышение скорости/)).toBeInTheDocument();
expect(driver.getFines).toHaveBeenCalled(); 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 () => { it("категории для выбора живут в шторке «Пополнить»", async () => {
+30 -6
View File
@@ -1,6 +1,6 @@
import { useState } from "react"; import { useState } from "react";
import { useQuery } from "@tanstack/react-query"; 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 { ArrowUp, ChevronRight, LogOut } from "lucide-react";
import { getBalance, type StatementKind } from "@/api/driver"; import { getBalance, type StatementKind } from "@/api/driver";
import { formatMoney, isoDaysAgo, isoToday } from "@/lib/format"; import { formatMoney, isoDaysAgo, isoToday } from "@/lib/format";
@@ -29,6 +29,10 @@ const MAIN_BUCKETS = ["Долг аренда", "Долг по штрафам"];
export const balancePollMs = (d?: { pending_topup?: number }): number | false => export const balancePollMs = (d?: { pending_topup?: number }): number | false =>
(d?.pending_topup ?? 0) > 0 || paymentActivityWithin() ? 4000 : 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), refetchInterval: (q) => balancePollMs(q.state.data),
}); });
const [sheet, setSheet] = useState(false); 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 rawFrom = params.get("from");
const [to, setTo] = useState(isoToday()); const rawTo = params.get("to");
const [kind, setKind] = useState<StatementKind>("all"); 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 accounts = data?.accounts ?? [];
const total = data?.total ?? accounts.reduce((s, a) => s + a.balance, 0); const total = data?.total ?? accounts.reduce((s, a) => s + a.balance, 0);
@@ -127,14 +151,14 @@ export function BalancePage() {
{/* ── За что списано ─────────────────────────────────────── */} {/* ── За что списано ─────────────────────────────────────── */}
<Statement from={from} to={to} kind={kind} <Statement from={from} to={to} kind={kind}
onFrom={setFrom} onTo={setTo} onKind={setKind} /> onFrom={(v) => setFilter("from", v)} onTo={(v) => setFilter("to", v)} onKind={setKind} />
<NotificationsRow /> <NotificationsRow />
<div className="flex justify-center mt-6 text-muted text-xs"> <div className="flex justify-center mt-6 text-muted text-xs">
{/* Отдельного раздела «Мои пополнения» нет намеренно: пополнения видны в {/* Отдельного раздела «Мои пополнения» нет намеренно: пополнения видны в
выписке выше по фильтру, а дублирующий пустой экран сбивал с толку. */} выписке выше по фильтру, а дублирующий пустой экран сбивал с толку. */}
<button className="flex items-center gap-1.5" onClick={() => { clear(); nav("/login"); }}> <button className="flex items-center gap-1.5" onClick={() => { clear(); nav("/login", { replace: true }); }}>
<LogOut size={15} /> Выйти <LogOut size={15} /> Выйти
</button> </button>
</div> </div>
+5 -3
View File
@@ -135,9 +135,11 @@ export function DebugPage() {
onClick={() => { onClick={() => {
// Свой вход, отложенный на время просмотра, возвращаем на место: иначе // Свой вход, отложенный на время просмотра, возвращаем на место: иначе
// «посмотреть чужой экран» означало бы заново входить через Telegram. // «посмотреть чужой экран» означало бы заново входить через Telegram.
if (impersonated && stopImpersonation()) { nav("/"); return; } // Уходим заменой записи: системный «назад» не должен возвращать на
// отладку сеанса, который только что закрыли.
if (impersonated && stopImpersonation()) { nav("/", { replace: true }); return; }
clear(); clear();
nav(staff.token ? "/dev" : "/login"); nav(staff.token ? "/dev" : "/login", { replace: true });
}} }}
> >
<LogOut size={16} />{" "} <LogOut size={16} />{" "}
@@ -145,7 +147,7 @@ export function DebugPage() {
</button> </button>
{staff.token && ( {staff.token && (
<button className="text-muted text-xs w-full mt-4" <button className="text-muted text-xs w-full mt-4"
onClick={() => { clear(); staff.clear(); nav("/login"); }}> onClick={() => { clear(); staff.clear(); nav("/login", { replace: true }); }}>
Выйти и из учётки сотрудника Выйти и из учётки сотрудника
</button> </button>
)} )}
@@ -1,7 +1,7 @@
import { describe, it, expect, vi, beforeEach } from "vitest"; import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react"; import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event"; 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", () => ({ vi.mock("@/api/staff", () => ({
staffLogin: vi.fn(async () => ({ access_token: "staff-tok", requires_2fa: false, partial_token: null })), staffLogin: vi.fn(async () => ({ access_token: "staff-tok", requires_2fa: false, partial_token: null })),
@@ -49,6 +49,23 @@ describe("DevLoginPage", () => {
expect(auth.driverName).toBe("Петров Пётр"); expect(auth.driverName).toBe("Петров Пётр");
}); });
it("выбрал водителя — на главную заменой записи: «назад» не вернёт к выбору", async () => {
function Home() {
return <p>главная: {useNavigationType()}</p>;
}
useStaff.getState().setStaff("staff-tok", "vlad");
render(
<MemoryRouter initialEntries={["/login", "/dev"]} initialIndex={1}>
<Routes>
<Route path="/" element={<Home />} />
<Route path="/dev" element={<DevLoginPage />} />
</Routes>
</MemoryRouter>
);
await userEvent.click(await screen.findByRole("button", { name: /Петров Пётр/ }));
expect(await screen.findByText("главная: REPLACE")).toBeInTheDocument();
});
it("двухфакторка: пароль сам по себе сеанса не открывает", async () => { it("двухфакторка: пароль сам по себе сеанса не открывает", async () => {
vi.mocked(staffApi.staffLogin).mockResolvedValueOnce({ vi.mocked(staffApi.staffLogin).mockResolvedValueOnce({
access_token: null, requires_2fa: true, partial_token: "partial", access_token: null, requires_2fa: true, partial_token: "partial",
+11 -3
View File
@@ -3,6 +3,7 @@ import { useNavigate } from "react-router-dom";
import { toast } from "sonner"; import { toast } from "sonner";
import { apiErrorText } from "@/api/driver"; import { apiErrorText } from "@/api/driver";
import { staffLogin, staffLogin2fa } from "@/api/staff"; import { staffLogin, staffLogin2fa } from "@/api/staff";
import { useRouteBack } from "@/lib/back";
import { useStaff } from "@/store/staff"; import { useStaff } from "@/store/staff";
import { DriverPicker } from "@/components/DriverPicker"; import { DriverPicker } from "@/components/DriverPicker";
import { Spinner } from "@/components/Spinner"; import { Spinner } from "@/components/Spinner";
@@ -17,6 +18,9 @@ import { Spinner } from "@/components/Spinner";
*/ */
export function DevLoginPage() { export function DevLoginPage() {
const nav = useNavigate(); const nav = useNavigate();
// «Я водитель» — туда же, куда «Назад» над экраном: откуда пришли, а с
// холодного старта — на главную или ко входу, смотря вошёл ли (routes.tsx).
const toDriver = useRouteBack();
const { token: staffToken, username: staffName, setStaff, clear } = useStaff(); const { token: staffToken, username: staffName, setStaff, clear } = useStaff();
const [username, setUsername] = useState(""); const [username, setUsername] = useState("");
const [password, setPassword] = useState(""); const [password, setPassword] = useState("");
@@ -65,7 +69,9 @@ export function DevLoginPage() {
Сотрудник: {staffName}. Приложение откроется от лица выбранного водителя, Сотрудник: {staffName}. Приложение откроется от лица выбранного водителя,
деньги в этом режиме не двигаются. деньги в этом режиме не двигаются.
</p> </p>
<DriverPicker onPicked={() => nav("/")} /> {/* Сеанс уже сменился — выбор отработал. Заменой записи: системный
«назад» с главной не должен возвращать к выбору водителя. */}
<DriverPicker onPicked={() => nav("/", { replace: true })} />
<button className="btn-ghost mt-5" onClick={clear}>Выйти из учётки сотрудника</button> <button className="btn-ghost mt-5" onClick={clear}>Выйти из учётки сотрудника</button>
</div> </div>
); );
@@ -99,8 +105,10 @@ export function DevLoginPage() {
<button className="btn-primary" disabled={busy || code.length < 6} onClick={() => submit2fa()}> <button className="btn-primary" disabled={busy || code.length < 6} onClick={() => submit2fa()}>
{busy ? <Spinner /> : "Подтвердить"} {busy ? <Spinner /> : "Подтвердить"}
</button> </button>
{/* Не «Назад»: так называется кнопка над экраном, и уводит она с
экрана совсем. Эта — только к вводу логина и пароля. */}
<button className="btn-ghost mt-2" onClick={() => { setPartial(null); setCode(""); }}> <button className="btn-ghost mt-2" onClick={() => { setPartial(null); setCode(""); }}>
Назад Изменить логин
</button> </button>
</> </>
) : ( ) : (
@@ -124,7 +132,7 @@ export function DevLoginPage() {
<button className="btn-primary" disabled={busy || !username || !password} onClick={submit}> <button className="btn-primary" disabled={busy || !username || !password} onClick={submit}>
{busy ? <Spinner /> : "Войти"} {busy ? <Spinner /> : "Войти"}
</button> </button>
<button className="btn-ghost mt-2" onClick={() => nav("/login")}>Я водитель</button> <button className="btn-ghost mt-2" onClick={toDriver}>Я водитель</button>
</> </>
)} )}
</div> </div>
@@ -38,15 +38,13 @@ export function FineDetailPage() {
<div className="pt-16 text-center"> <div className="pt-16 text-center">
<p className="text-sm font-semibold mb-1">Штраф не найден</p> <p className="text-sm font-semibold mb-1">Штраф не найден</p>
<p className="text-muted text-xs mb-6">Возможно, он больше не числится за вами.</p> <p className="text-muted text-xs mb-6">Возможно, он больше не числится за вами.</p>
<button className="btn-ghost" onClick={() => nav("/")}>На главную</button> <button className="btn-ghost" onClick={() => nav("/", { replace: true })}>На главную</button>
</div> </div>
); );
} }
return ( return (
<div className="pt-2 pb-4"> <div className="pt-2 pb-4">
<button className="text-muted text-xs mb-3" onClick={() => nav("/")}>‹ Назад</button>
{f.photos.length > 0 ? ( {f.photos.length > 0 ? (
<div className="mb-4 space-y-2"> <div className="mb-4 space-y-2">
{f.photos.map((src, i) => ( {f.photos.map((src, i) => (
@@ -1,7 +1,7 @@
import { describe, it, expect, vi, beforeEach } from "vitest"; import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react"; import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event"; 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", () => ({ vi.mock("@/api/driver", () => ({
authRequest: vi.fn(async () => ({ status: "code_sent", channel: "tg" })), authRequest: vi.fn(async () => ({ status: "code_sent", channel: "tg" })),
@@ -30,4 +30,29 @@ describe("LoginPage", () => {
await userEvent.click(screen.getByRole("button", { name: /Войти/i })); await userEvent.click(screen.getByRole("button", { name: /Войти/i }));
expect(driver.authVerify).toHaveBeenCalledWith("79143054400", "123456"); expect(driver.authVerify).toHaveBeenCalledWith("79143054400", "123456");
}); });
it("вход по коду — отдельный адрес, и из него есть «Назад» к выбору способа", async () => {
// Раньше режим жил в памяти экрана: ни кнопки, ни системного «назад» — с
// экрана ввода номера было не вернуться к Telegram.
function Where() {
const loc = useLocation();
return <p data-testid="where">{loc.pathname + loc.search}</p>;
}
render(
<MemoryRouter initialEntries={["/login"]}>
<Where />
<Routes><Route path="/login" element={<LoginPage />} /></Routes>
</MemoryRouter>
);
// На выборе способа «Назад» нет — это экран входа, возвращаться с него некуда.
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();
});
}); });
+11 -5
View File
@@ -1,5 +1,5 @@
import { useEffect, useState } from "react"; import { useEffect, useState } from "react";
import { useNavigate } from "react-router-dom"; import { useNavigate, useSearchParams } from "react-router-dom";
import { toast } from "sonner"; import { toast } from "sonner";
import { apiErrorText, authRequest, authVerify, mtsStatus, retryAfterSeconds, tgSession } from "@/api/driver"; import { apiErrorText, authRequest, authVerify, mtsStatus, retryAfterSeconds, tgSession } from "@/api/driver";
import { digitsOnly, formatNational, nationalDigits } from "@/lib/format"; import { digitsOnly, formatNational, nationalDigits } from "@/lib/format";
@@ -8,6 +8,7 @@ import { takeReturnTo } from "@/lib/returnTo";
import { useAuth } from "@/store/auth"; import { useAuth } from "@/store/auth";
import { Spinner } from "@/components/Spinner"; import { Spinner } from "@/components/Spinner";
import { InstallHint } from "@/components/InstallHint"; import { InstallHint } from "@/components/InstallHint";
import { BackButton } from "@/components/BackButton";
// Кулдаун повторной отправки кода — синхронно с бэкендом (60с). Точное значение // Кулдаун повторной отправки кода — синхронно с бэкендом (60с). Точное значение
// приходит в Retry-After на 429; это дефолт после успешной отправки. // приходит в Retry-After на 429; это дефолт после успешной отправки.
@@ -27,7 +28,11 @@ export function LoginPage() {
const [step, setStep] = useState<"phone" | "code">("phone"); const [step, setStep] = useState<"phone" | "code">("phone");
const [channel, setChannel] = useState<string>(""); const [channel, setChannel] = useState<string>("");
const [busy, setBusy] = useState(false); 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 — можно отправлять). // Секунды до разрешённой повторной отправки кода (0 — можно отправлять).
const [cooldown, setCooldown] = useState(0); const [cooldown, setCooldown] = useState(0);
// Prefetched pairing session so the «Войти через Telegram» control is a real // Prefetched pairing session so the «Войти через Telegram» control is a real
@@ -114,8 +119,9 @@ export function LoginPage() {
} }
return ( return (
<div className="pt-16"> <div>
<h1 className="text-xl font-extrabold mb-1">Премиум Водитель</h1> {mode === "code" && <BackButton to="/login" />}
<h1 className="text-xl font-extrabold mb-1 mt-16">Премиум Водитель</h1>
<p className="text-muted text-sm mb-8">Вход в приложение</p> <p className="text-muted text-sm mb-8">Вход в приложение</p>
{mode === "choose" ? ( {mode === "choose" ? (
@@ -168,7 +174,7 @@ export function LoginPage() {
<Spinner /> <Spinner />
</button> </button>
)} )}
<button className="btn-ghost mt-2" onClick={() => setMode("code")}>Войти по коду</button> <button className="btn-ghost mt-2" onClick={() => setParams({ by: "code" })}>Войти по коду</button>
{/* Предложение установки — только на выборе способа входа: это первый {/* Предложение установки — только на выборе способа входа: это первый
экран, который видит человек, открывший приложение впервые. На экран, который видит человек, открывший приложение впервые. На
экранах ввода номера и кода оно отвлекало бы от дела. */} экранах ввода номера и кода оно отвлекало бы от дела. */}
@@ -42,14 +42,13 @@ export function MockPayPage() {
<div className="pt-24 text-center"> <div className="pt-24 text-center">
<p className="text-sm font-semibold mb-1">Учебная оплата недоступна</p> <p className="text-sm font-semibold mb-1">Учебная оплата недоступна</p>
<p className="text-muted text-xs mb-6">Этот экран работает только при просмотре сотрудником.</p> <p className="text-muted text-xs mb-6">Этот экран работает только при просмотре сотрудником.</p>
<button className="btn-ghost" onClick={() => nav("/")}>На главную</button> <button className="btn-ghost" onClick={() => nav("/", { replace: true })}>На главную</button>
</div> </div>
); );
} }
return ( return (
<div className="pt-8"> <div className="pt-8">
<button className="text-muted text-xs mb-3" onClick={() => nav(-1)}>‹ Назад</button>
<h1 className="text-lg font-extrabold mb-1">Учебная оплата</h1> <h1 className="text-lg font-extrabold mb-1">Учебная оплата</h1>
<p className="text-muted text-xs mb-5"> <p className="text-muted text-xs mb-5">
Банка в этом платеже нет: ни списания, ни чека, ни проводки. Выберите, что Банка в этом платеже нет: ни списания, ни чека, ни проводки. Выберите, что
@@ -17,6 +17,7 @@ vi.mock("@/api/driver", () => ({
})); }));
import { MtsLoginPage } from "./MtsLoginPage"; import { MtsLoginPage } from "./MtsLoginPage";
import { BackProvider } from "@/components/BackBar";
import * as driver from "@/api/driver"; import * as driver from "@/api/driver";
import { useAuth } from "@/store/auth"; import { useAuth } from "@/store/auth";
@@ -24,8 +25,13 @@ const started = {
session: "S", poll_secret: "P", status: "pending", expires_in: 140, hhe_uri: null, session: "S", poll_secret: "P", status: "pending", expires_in: 140, hhe_uri: null,
}; };
// Как в App: родителя экрана «Другой способ входа» берёт из таблицы маршрутов.
function wrap() { function wrap() {
return render(<MemoryRouter><MtsLoginPage /></MemoryRouter>); return render(
<MemoryRouter initialEntries={["/login/mts"]}>
<BackProvider><MtsLoginPage /></BackProvider>
</MemoryRouter>
);
} }
async function enterPhone(user: ReturnType<typeof userEvent.setup>) { async function enterPhone(user: ReturnType<typeof userEvent.setup>) {
@@ -90,7 +96,9 @@ describe("MtsLoginPage", () => {
expect(await screen.findByText(/Вход отклонён на телефоне/i)).toBeInTheDocument(); expect(await screen.findByText(/Вход отклонён на телефоне/i)).toBeInTheDocument();
await user.click(screen.getByRole("button", { name: /Войти через Telegram/i })); 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(); expect(useAuth.getState().token).toBeFalsy();
}); });
@@ -3,6 +3,7 @@ import { useNavigate } from "react-router-dom";
import { toast } from "sonner"; import { toast } from "sonner";
import { apiErrorText, mtsCode, mtsPoll, mtsStart } from "@/api/driver"; import { apiErrorText, mtsCode, mtsPoll, mtsStart } from "@/api/driver";
import { digitsOnly, formatNational, nationalDigits } from "@/lib/format"; import { digitsOnly, formatNational, nationalDigits } from "@/lib/format";
import { useRouteBack } from "@/lib/back";
import { takeReturnTo } from "@/lib/returnTo"; import { takeReturnTo } from "@/lib/returnTo";
import { useAuth } from "@/store/auth"; import { useAuth } from "@/store/auth";
import { Spinner } from "@/components/Spinner"; import { Spinner } from "@/components/Spinner";
@@ -35,6 +36,9 @@ const GIVE_UP_MS = 180_000;
export function MtsLoginPage() { export function MtsLoginPage() {
const nav = useNavigate(); const nav = useNavigate();
// К выбору способа входа (родитель в routes.tsx) — шагом назад, а не новой
// записью поверх истории: иначе системный «назад» Android возвращал бы сюда.
const toLogin = useRouteBack();
const setSession = useAuth((s) => s.setSession); const setSession = useAuth((s) => s.setSession);
const [phone, setPhone] = useState(""); const [phone, setPhone] = useState("");
const [code, setCode] = useState(""); const [code, setCode] = useState("");
@@ -137,7 +141,7 @@ export function MtsLoginPage() {
<p className="text-muted text-xs mb-6"> <p className="text-muted text-xs mb-6">
Такое бывает, когда оператор не может доставить подтверждение. Такое бывает, когда оператор не может доставить подтверждение.
</p> </p>
<button className="btn-primary" onClick={() => nav("/login")}> <button className="btn-primary" onClick={toLogin}>
Войти через Telegram Войти через Telegram
</button> </button>
<button className="btn-ghost mt-3" onClick={() => setFailure(null)}> <button className="btn-ghost mt-3" onClick={() => setFailure(null)}>
@@ -200,7 +204,7 @@ export function MtsLoginPage() {
Изменить номер Изменить номер
</button> </button>
)} )}
<button className="btn-ghost mt-2" onClick={() => nav("/login")}> <button className="btn-ghost mt-2" onClick={toLogin}>
Другой способ входа Другой способ входа
</button> </button>
</div> </div>
@@ -3,7 +3,7 @@ import { useNavigate } from "react-router-dom";
import { Bell } from "lucide-react"; import { Bell } from "lucide-react";
import { getNotifications, markNotificationsRead, type DriverNotification } from "@/api/driver"; import { getNotifications, markNotificationsRead, type DriverNotification } from "@/api/driver";
import { AppHeader } from "@/components/AppHeader"; import { useBack } from "@/lib/back";
import { Spinner } from "@/components/Spinner"; import { Spinner } from "@/components/Spinner";
import { OperationIcon } from "@/components/operationIcon"; import { OperationIcon } from "@/components/operationIcon";
@@ -28,6 +28,10 @@ const ICON_BY_KIND: Record<string, string> = {
*/ */
export function NotificationsPage() { export function NotificationsPage() {
const nav = useNavigate(); const nav = useNavigate();
// Уведомление о платеже ведёт на главную — а главная и есть экран, с которого
// сюда пришли. Туда шагом назад, а не новой записью поверх: иначе системный
// «назад» Android возвращал бы в ленту.
const back = useBack("/");
const [items, setItems] = useState<DriverNotification[] | null>(null); const [items, setItems] = useState<DriverNotification[] | null>(null);
const [error, setError] = useState<string | null>(null); const [error, setError] = useState<string | null>(null);
@@ -45,9 +49,10 @@ export function NotificationsPage() {
}; };
}, []); }, []);
// Шапки с названием приложения здесь нет: сверху «Назад» (BackBar в App), под
// ним заголовок экрана — двух строк «откуда» и «где я» достаточно.
return ( return (
<div className="p-4"> <div>
<AppHeader />
<h1 className="text-lg font-bold mb-3">Уведомления</h1> <h1 className="text-lg font-bold mb-3">Уведомления</h1>
{error && <div className="text-sm text-muted">{error}</div>} {error && <div className="text-sm text-muted">{error}</div>}
@@ -65,7 +70,7 @@ export function NotificationsPage() {
key={n.id} key={n.id}
type="button" type="button"
className="flex gap-3 items-start text-left bg-surface border border-line rounded-xl p-3" 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))}
> >
<OperationIcon title={ICON_BY_KIND[n.kind] ?? ""} /> <OperationIcon title={ICON_BY_KIND[n.kind] ?? ""} />
<span className="flex-1 min-w-0"> <span className="flex-1 min-w-0">
@@ -1,8 +1,12 @@
import { useNavigate } from "react-router-dom"; import { useNavigate } from "react-router-dom";
import { useRouteBack } from "@/lib/back";
import { loadPairing } from "@/lib/pairing"; import { loadPairing } from "@/lib/pairing";
export function OnboardingPage() { export function OnboardingPage() {
const nav = useNavigate(); const nav = useNavigate();
// Ко входу (родитель в routes.tsx) — шагом назад, а не новой записью поверх
// истории (см. lib/back).
const back = useRouteBack();
const raw = sessionStorage.getItem("pp-onboarding"); const raw = sessionStorage.getItem("pp-onboarding");
const data = raw ? (JSON.parse(raw) as { tg?: string; max?: string; phone: string }) : null; const data = raw ? (JSON.parse(raw) as { tg?: string; max?: string; phone: string }) : null;
const pairing = loadPairing(); const pairing = loadPairing();
@@ -40,7 +44,7 @@ export function OnboardingPage() {
Подключить MAX Подключить MAX
</a> </a>
)} )}
<button className="btn-ghost" onClick={() => nav("/login")}> <button className="btn-ghost" onClick={back}>
Назад ко входу Назад ко входу
</button> </button>
</div> </div>
@@ -1,7 +1,8 @@
import { describe, it, expect, vi } from "vitest"; import { describe, it, expect, vi } from "vitest";
import { render, screen, waitFor } from "@testing-library/react"; import { render, screen, waitFor } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query"; 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"]; const states = ["FORM", "PAID"];
vi.mock("@/api/driver", () => ({ vi.mock("@/api/driver", () => ({
@@ -26,4 +27,23 @@ describe("PaymentPage", () => {
expect(screen.getByRole("link", { name: /Оплатить/i })).toHaveAttribute("href", "https://qr.nspk.ru/x"); expect(screen.getByRole("link", { name: /Оплатить/i })).toHaveAttribute("href", "https://qr.nspk.ru/x");
await waitFor(() => expect(screen.getByText(/Оплачено/i)).toBeInTheDocument(), { timeout: 3000 }); await waitFor(() => expect(screen.getByText(/Оплачено/i)).toBeInTheDocument(), { timeout: 3000 });
}); });
it("с итога на главную — заменой записи, а не поверх «Оплачено»", async () => {
// Иначе системный «назад» с главной возвращал бы на отработавший итог.
function Home() {
return <p>главная: {useNavigationType()}</p>;
}
render(
<QueryClientProvider client={new QueryClient()}>
<MemoryRouter initialEntries={["/", "/pay/o9"]} initialIndex={1}>
<Routes>
<Route path="/" element={<Home />} />
<Route path="/pay/:orderId" element={<PaymentPage />} />
</Routes>
</MemoryRouter>
</QueryClientProvider>
);
await userEvent.click(await screen.findByRole("button", { name: "На главную" }, { timeout: 3000 }));
expect(await screen.findByText("главная: REPLACE")).toBeInTheDocument();
});
}); });
@@ -40,6 +40,10 @@ export function PaymentPage() {
} }
}, [paid, qc]); }, [paid, qc]);
// С итога оплаты на главную — заменой записи: системный «назад» с главной не
// должен возвращать на отработавший экран «Оплачено».
const home = () => nav("/", { replace: true });
const retry = ( const retry = (
<button className="btn-primary mt-8" onClick={() => nav("/topup", { state: { bucket: st.bucket }, replace: true })}> <button className="btn-primary mt-8" onClick={() => nav("/topup", { state: { bucket: st.bucket }, replace: true })}>
Пополнить ещё раз Пополнить ещё раз
@@ -54,7 +58,7 @@ export function PaymentPage() {
<p className="text-muted text-xs mt-1"> <p className="text-muted text-xs mt-1">
{st.base != null ? `${st.bucket ?? "Баланс"} пополнен на ${formatMoney(st.base)}` : "Баланс пополнен"} {st.base != null ? `${st.bucket ?? "Баланс"} пополнен на ${formatMoney(st.base)}` : "Баланс пополнен"}
</p> </p>
<button className="btn-primary mt-8" onClick={() => nav("/")}>На главную</button> <button className="btn-primary mt-8" onClick={home}>На главную</button>
</div> </div>
); );
} }
@@ -88,7 +92,7 @@ export function PaymentPage() {
<span className="w-14 h-14 rounded-full bg-neg text-white flex items-center justify-center mb-3"><Undo2 size={28} /></span> <span className="w-14 h-14 rounded-full bg-neg text-white flex items-center justify-center mb-3"><Undo2 size={28} /></span>
<p className="text-lg font-extrabold">Платёж возвращён</p> <p className="text-lg font-extrabold">Платёж возвращён</p>
<p className="text-muted text-xs mt-1">Деньги вернулись на счёт, с которого платили. Баланс пересчитаем.</p> <p className="text-muted text-xs mt-1">Деньги вернулись на счёт, с которого платили. Баланс пересчитаем.</p>
<button className="btn-primary mt-8" onClick={() => nav("/")}>На главную</button> <button className="btn-primary mt-8" onClick={home}>На главную</button>
</div> </div>
); );
} }
@@ -102,7 +106,7 @@ export function PaymentPage() {
<p className="text-lg font-extrabold">Не удаётся проверить оплату</p> <p className="text-lg font-extrabold">Не удаётся проверить оплату</p>
<p className="text-muted text-xs mt-1">Похоже, пропала связь. Если вы уже оплатили, деньги дойдут.</p> <p className="text-muted text-xs mt-1">Похоже, пропала связь. Если вы уже оплатили, деньги дойдут.</p>
<button className="btn-primary mt-8" onClick={() => refetch()}>Проверить ещё раз</button> <button className="btn-primary mt-8" onClick={() => refetch()}>Проверить ещё раз</button>
<button className="btn-ghost mt-3" onClick={() => nav("/")}>На главную</button> <button className="btn-ghost mt-3" onClick={home}>На главную</button>
</div> </div>
); );
} }
@@ -1,7 +1,7 @@
import { describe, it, expect, vi } from "vitest"; import { describe, it, expect, vi } from "vitest";
import { render, screen } from "@testing-library/react"; import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event"; 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"; import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
vi.mock("@/api/driver", () => ({ vi.mock("@/api/driver", () => ({
@@ -60,6 +60,31 @@ describe("TopupPage", () => {
await userEvent.click(screen.getByRole("button", { name: /Оплатить/i })); await userEvent.click(screen.getByRole("button", { name: /Оплатить/i }));
expect(driver.topup).toHaveBeenCalledWith("Долг по штрафам", 500, "qr", false); expect(driver.topup).toHaveBeenCalledWith("Долг по штрафам", 500, "qr", false);
}); });
it("платёж создан — «Назад» с оплаты не возвращает к набору суммы", async () => {
// Экран оплаты подменяет клавиатуру в истории: шаг назад с него ведёт туда,
// откуда пришли пополнять, а не к уже отработавшей форме.
function StepBack() {
const nav = useNavigate();
return <button onClick={() => nav(-1)}>шаг назад</button>;
}
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={["/", "/topup"]} initialIndex={1}>
<Routes>
<Route path="/" element={<p>главная</p>} />
<Route path="/topup" element={<TopupPage />} />
<Route path="/pay/:orderId" element={<StepBack />} />
</Routes>
</MemoryRouter>
</QueryClientProvider>
);
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("боевая оплата под просмотром", () => { describe("боевая оплата под просмотром", () => {
+8 -4
View File
@@ -44,16 +44,22 @@ export function TopupPage() {
setBusy(true); setBusy(true);
try { try {
const r = await topup(bucket, base, method as "qr" | "card", livePay); const r = await topup(bucket, base, method as "qr" | "card", livePay);
// Платёж уже создан — клавиатура суммы своё отработала. Уходим с неё
// заменой записи: «Назад» с оплаты ведёт на экран, откуда пришли
// пополнять, а не к повторному набору той же суммы.
// Учебный платёж (сотрудник смотрит от чужого лица): банка нет, платить // Учебный платёж (сотрудник смотрит от чужого лица): банка нет, платить
// негде — сразу на экран выбора исхода, дальше всё как у водителя. // негде — сразу на экран выбора исхода, дальше всё как у водителя.
if (r.mock) { 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; return;
} }
// Отметка ДО ухода на оплату: вернись водитель на баланс жестом «назад» // Отметка ДО ухода на оплату: вернись водитель на баланс жестом «назад»
// раньше вебхука банка, экран обязан опрашивать себя и подхватить платёж. // раньше вебхука банка, экран обязан опрашивать себя и подхватить платёж.
markPaymentActivity(); 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) { } catch (err: unknown) {
// Текст с сервера, а не глухое «не удалось»: минимум СБП, потолок суммы и // Текст с сервера, а не глухое «не удалось»: минимум СБП, потолок суммы и
// неизвестная категория объясняются словами, иначе экран молча не реагирует. // неизвестная категория объясняются словами, иначе экран молча не реагирует.
@@ -65,8 +71,6 @@ export function TopupPage() {
return ( return (
<div className="pt-2"> <div className="pt-2">
<button className="text-muted text-xs mb-3" onClick={() => nav(-1)}>‹ Назад</button>
{/* Категорию выбирают в шторке на главном экране. Пришли оттуда — показываем {/* Категорию выбирают в шторке на главном экране. Пришли оттуда — показываем
выбранное строкой, а не рядом чипов: второй выбор того же самого сбивает выбранное строкой, а не рядом чипов: второй выбор того же самого сбивает
с толку. Чипы остаются для входа сюда напрямую (кнопка «Пополнить» без с толку. Чипы остаются для входа сюда напрямую (кнопка «Пополнить» без
+146
View File
@@ -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: <Route> там быть не должно. */
const sources = import.meta.glob<string>(["./**/*.tsx", "!./**/*.test.tsx", "!./App.tsx"], {
query: "?raw",
import: "default",
eager: true,
});
/** Комментарии упоминают <Route> словами — проверяем только код. */
function stripComments(src: string): string {
return src.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
}
function Where() {
return <p data-testid="where">{useLocation().pathname}</p>;
}
function renderAt(url: string) {
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
return render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={[url]}>
<Where />
<App />
</MemoryRouter>
</QueryClientProvider>
);
}
describe("«Назад» на каждом экране", () => {
beforeEach(() => {
// Любой запрос (ky ходит через глобальный fetch) не отвечает никогда.
vi.stubGlobal("fetch", vi.fn(() => new Promise<Response>(() => {})));
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 должен взять тот же экран, что нарисовал <Routes>.
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 рисует экраны только из таблицы маршрутов", () => {
// <Route>, вписанный в App мимо таблицы, остался бы без «Назад» и без
// проверки выше. Разрешены только ROUTES.map и перехват неизвестных адресов.
const code = stripComments(appSource);
expect(code.match(/<Route\s/g)).toHaveLength(2);
expect(code).toContain("<Route key={r.path} path={r.path}");
expect(code).toContain('<Route path="*"');
});
it("вложенных <Routes> в страницах и компонентах нет", () => {
// Экран, заведённый внутри страницы, тоже прошёл бы мимо таблицы.
const nested = Object.entries(sources)
.filter(([, src]) => /<Routes?[\s>/]/.test(stripComments(src)))
.map(([file]) => file);
expect(Object.keys(sources).length).toBeGreaterThan(10);
expect(nested).toEqual([]);
});
});
+75
View File
@@ -0,0 +1,75 @@
import type { ReactNode } from "react";
import { matchRoutes, type Params } from "react-router-dom";
import type { BackMode } from "@/lib/back";
import { LoginPage } from "@/pages/LoginPage";
import { MtsLoginPage } from "@/pages/MtsLoginPage";
import { TgWaitPage } from "@/pages/TgWaitPage";
import { OnboardingPage } from "@/pages/OnboardingPage";
import { BalancePage } from "@/pages/BalancePage";
import { TopupPage } from "@/pages/TopupPage";
import { PaymentPage } from "@/pages/PaymentPage";
import { DevLoginPage } from "@/pages/DevLoginPage";
import { DebugPage } from "@/pages/DebugPage";
import { MockPayPage } from "@/pages/MockPayPage";
import { FineDetailPage } from "@/pages/FineDetailPage";
import { NotificationsPage } from "@/pages/NotificationsPage";
/** Что известно при выборе родителя: параметры пути, строка запроса, вход. */
export interface ParentCtx {
params: Params;
search: URLSearchParams;
/** Есть токен водителя — свой вход или просмотр сотрудником. */
signedIn: boolean;
}
/** Куда ведёт «Назад», когда в истории этого запуска позади ничего нет.
* null — только у главной и у экранов входа: там кнопки «Назад» нет. */
export type Parent = string | ((ctx: ParentCtx) => string) | null;
export interface AppRoute {
path: string;
element: ReactNode;
/** Обязателен: экран без родителя не соберётся. См. CLAUDE.md приложения. */
parent: Parent;
/** "auth" — только вошедшему водителю, "staff" — ещё и только сотруднику,
* "guest" — экран входа: вошедшего уводит на главную (см. GuestOnly в App). */
guard?: "auth" | "staff" | "guest";
/** По умолчанию «Назад» идёт шагом по истории — см. BackMode. */
back?: BackMode;
}
/**
* Все экраны приложения — единственный источник и для <Routes> в App, и для
* кнопки «Назад» (BackBar), и для теста-сторожа, который проверяет её на каждом.
*/
export const ROUTES: AppRoute[] = [
{ path: "/", element: <BalancePage />, guard: "auth", parent: null },
{ path: "/login", element: <LoginPage />, guard: "guest", parent: null },
{ path: "/login/mts", element: <MtsLoginPage />, guard: "guest", parent: "/login" },
{ path: "/tg-wait", element: <TgWaitPage />, guard: "guest", parent: "/login" },
{ path: "/onboarding", element: <OnboardingPage />, guard: "guest", parent: "/login" },
// Сотрудник, уже вошедший водителем, попадает сюда долгим тапом с главной —
// туда и возвращаем; без входа возвращаться некуда, кроме экрана входа.
{ path: "/dev", element: <DevLoginPage />, parent: ({ signedIn }) => (signedIn ? "/" : "/login") },
{ path: "/notifications", element: <NotificationsPage />, guard: "auth", parent: "/" },
{ path: "/topup", element: <TopupPage />, guard: "auth", parent: "/" },
{ path: "/pay/:orderId", element: <PaymentPage />, guard: "auth", parent: "/" },
{ path: "/mock-pay/:orderId", element: <MockPayPage />, guard: "auth", parent: "/" },
// Карточку открывают из списка штрафов — к нему и возвращаем, даже если её
// открыли пушем «Новый штраф» с холодного старта.
{ path: "/fines/:fineId", element: <FineDetailPage />, guard: "auth", parent: "/?kind=fines" },
{ path: "/debug", element: <DebugPage />, guard: "staff", parent: "/" },
];
/** Маршрут из таблицы, под который попадает адрес, — с параметрами пути. */
export function findRoute(pathname: string): { route: AppRoute; params: Params } | null {
// Тем же ранжированием, что у <Routes> (статичный сегмент сильнее параметра),
// а не первым совпадением по порядку таблицы: иначе «Назад» взял бы родителя
// не того экрана, что нарисован.
const hit = matchRoutes(ROUTES, pathname)?.[0];
return hit ? { route: hit.route, params: hit.params } : null;
}
export function resolveParent(parent: Exclude<Parent, null>, ctx: ParentCtx): string {
return typeof parent === "function" ? parent(ctx) : parent;
}