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
+1148 -81

No files matched your search

+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([]);
});
});