feat(nav): кнопка «Назад» на каждом экране + правило для новых разделов (задача 6385)
На айфоне у установленного приложения нет системной «назад», а жест от края после холодного старта или открытия из пуша не делает ничего — водитель застревал в «Уведомлениях», на ожидании Telegram и оплаты, на спиннере штрафа. - Все экраны заводятся в таблице src/routes.tsx с обязательным родителем (null — только у главной и входа); App рисует <Route> только из неё. - BackBar над маршрутами показывает «Назад» (44 px) в любом состоянии экрана. Логика в lib/back.ts: есть история этого запуска (history.state.idx > 0) — шаг назад, нет — на родителя с replace. - Тест-сторож обходит таблицу с зависшей сетью и требует «Назад» на каждом экране с родителем; список «корневых» экранов закреплён. - После входа/оплаты/выхода переходы с replace — «Назад» не возвращает на отработанную форму; экраны входа уводят вошедшего на главную. - Фильтр выписки (?kind=, период) и вход по коду (?by=code) — в адресе: «Назад» из штрафа возвращает к списку штрафов. - ErrorBoundary вместо белого экрана при падении. - driver-pwa/CLAUDE.md — правило и чек-лист нового раздела. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
7d8f4b8998
commit
ab2ad8d471
29 files changed
+1148
-81
No files matched your search
@@ -0,0 +1,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([]);
|
||||
});
|
||||
});
|
||||
Reference in new issue
Block a user