From 0c353f729985c5e2dec6eb5d4e20becbe8b33a60 Mon Sep 17 00:00:00 2001 From: vladtechno Date: Fri, 25 Sep 2026 21:53:48 +1000 Subject: [PATCH] =?UTF-8?q?feat(nav):=20=D0=B5=D0=B4=D0=B8=D0=BD=D0=B0?= =?UTF-8?q?=D1=8F=20=D1=88=D0=B0=D0=BF=D0=BA=D0=B0=20=C2=AB=D0=9D=D0=B0?= =?UTF-8?q?=D0=B7=D0=B0=D0=B4=C2=BB=20=D0=BD=D0=B0=20=D0=B2=D1=81=D0=B5?= =?UTF-8?q?=D1=85=20=D1=8D=D0=BA=D1=80=D0=B0=D0=BD=D0=B0=D1=85=20+=20?= =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=D0=BE=20=D0=B4=D0=BB=D1=8F?= =?UTF-8?q?=20=D0=BD=D0=BE=D0=B2=D1=8B=D1=85=20=D1=80=D0=B0=D0=B7=D0=B4?= =?UTF-8?q?=D0=B5=D0=BB=D0=BE=D0=B2=20(=D0=B7=D0=B0=D0=B4=D0=B0=D1=87?= =?UTF-8?q?=D0=B0=206385)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Четыре разных варианта «назад» (текстовые ссылки, иконка без подписи, круглая кнопка, navigate(-1) без запасного пути) заменены одним ScreenHeader. - Таблица экранов src/routes.tsx с обязательным родителем; App рисует маршруты только из неё, ScreenHeader берёт родителя из контекста. - lib/back.ts: история этого запуска — шаг назад (steps для многошаговых потоков), иначе — родитель с replace. - Шапка есть и в загрузке/ошибке/«не найдено» (карточка машины, осмотры, создание ремонта, склад), и пока грузятся права на склад (был пустой экран). - После завершения/удаления/сохранения — назад по истории или replace: «Назад» не ведёт на отработанную форму или удалённый осмотр. - Фото на весь экран: крестик ниже статус-бара, 44 px, тап мимо фото закрывает. - Тест-сторож обходит таблицу с зависшей сетью и требует «Назад» на своём экране; ErrorBoundary вместо белого экрана. - mechanic-pwa/CLAUDE.md — правило и чек-лист нового раздела. Эмодзи плиток главного меню не тронуты. Co-Authored-By: Claude Opus 5.5 --- mechanic-pwa/CLAUDE.md | 31 ++++ mechanic-pwa/frontend/src/App.tsx | 102 +++++++------ .../frontend/src/components/ErrorBoundary.tsx | 53 +++++++ .../src/components/ScreenHeader.test.tsx | 79 +++++++++++ .../frontend/src/components/ScreenHeader.tsx | 91 ++++++++++++ .../damage-flow/PhotoAnnotateStep.tsx | 9 +- .../components/damage-flow/ZoneDetailView.tsx | 7 +- .../src/components/repairs/MechanicsField.tsx | 2 +- .../components/repairs/PartsPickerModal.tsx | 2 +- .../components/repairs/WorksPickerModal.tsx | 2 +- mechanic-pwa/frontend/src/lib/back.test.tsx | 134 ++++++++++++++++++ mechanic-pwa/frontend/src/lib/back.ts | 69 +++++++++ mechanic-pwa/frontend/src/pages/Home.tsx | 15 +- .../frontend/src/pages/InspectionEditor.tsx | 62 ++++---- .../frontend/src/pages/InspectionReview.tsx | 57 +++++--- .../frontend/src/pages/TtStateDetail.tsx | 58 +++++--- .../frontend/src/pages/VehicleCard.tsx | 38 ++--- .../src/pages/repairs/CarSelectPage.test.tsx | 27 +++- .../src/pages/repairs/CarSelectPage.tsx | 22 ++- .../src/pages/repairs/CreateRepairPage.tsx | 55 ++++--- .../src/pages/repairs/EditRepairPage.tsx | 32 ++--- .../src/pages/repairs/RepairDetailPage.tsx | 28 +--- .../src/pages/repairs/RepairsFeedPage.tsx | 24 ++-- .../pages/warehouse/PartsIssueJournalPage.tsx | 17 +-- .../pages/warehouse/PartsIssuePage.test.tsx | 67 +++++++++ .../src/pages/warehouse/PartsIssuePage.tsx | 33 ++--- .../src/pages/warehouse/ReceiptDetailPage.tsx | 17 +-- .../pages/warehouse/ReceivingDraftPage.tsx | 46 ++++-- .../src/pages/warehouse/ReceivingPage.tsx | 15 +- .../src/pages/warehouse/StocktakePage.tsx | 21 ++- .../src/pages/warehouse/StocktakeResult.tsx | 23 +-- .../pages/warehouse/StocktakeSessionPage.tsx | 32 ++--- .../src/pages/warehouse/TyreJournalPage.tsx | 22 +-- .../src/pages/warehouse/TyreSizesPage.tsx | 19 +-- .../src/pages/warehouse/TyresPage.tsx | 44 +++--- mechanic-pwa/frontend/src/routes.tsx | 96 +++++++++++++ .../frontend/src/test/backGuard.test.tsx | 122 ++++++++++++++++ 37 files changed, 1152 insertions(+), 421 deletions(-) create mode 100644 mechanic-pwa/CLAUDE.md create mode 100644 mechanic-pwa/frontend/src/components/ErrorBoundary.tsx create mode 100644 mechanic-pwa/frontend/src/components/ScreenHeader.test.tsx create mode 100644 mechanic-pwa/frontend/src/components/ScreenHeader.tsx create mode 100644 mechanic-pwa/frontend/src/lib/back.test.tsx create mode 100644 mechanic-pwa/frontend/src/lib/back.ts create mode 100644 mechanic-pwa/frontend/src/pages/warehouse/PartsIssuePage.test.tsx create mode 100644 mechanic-pwa/frontend/src/routes.tsx create mode 100644 mechanic-pwa/frontend/src/test/backGuard.test.tsx diff --git a/mechanic-pwa/CLAUDE.md b/mechanic-pwa/CLAUDE.md new file mode 100644 index 0000000..248bce3 --- /dev/null +++ b/mechanic-pwa/CLAUDE.md @@ -0,0 +1,31 @@ +# Премиум Механик (mechanic PWA) + +Фронт — `frontend/` (React 19, react-router 7, vitest). Бэкенд общий с CRM, здесь его нет. + +## Кнопка «Назад» на каждом экране + +**Зачем.** У PWA, установленного на iPhone, нет системной «Назад»; свайп от края работает через раз, а после холодного старта или открытия из пуша не делает ничего — истории нет. Экран без кнопки в интерфейсе — ловушка, из него не выйти (задача 6385). На Android системная «Назад» есть, и она должна вести туда же, куда кнопка в шапке. + +**Контракт.** +- Каждый экран, кроме главной (`/`) и входа (`/login`), показывает «Назад» слева в шапке во всех состояниях: загрузка, ошибка, пусто, «не найдено», проверка прав, итог. Подпись и доступное имя — «Назад», шеврон lucide `ChevronLeft`, зона нажатия не меньше 44×44, не под статус-баром. +- Смысл один — `useBack(parent)` из `src/lib/back.ts`: есть история в этом запуске (`history.state.idx > 0`) — `navigate(-1)`; нет — `navigate(parent, { replace: true })`. Голый `navigate(-1)` и push родителя запрещены (push даёт петлю с системной «Назад»). +- Родитель — обязательное поле `parent` в таблице `src/routes.tsx`, из которой App рисует ``. `null` — только у главной и входа. Можно функцией от params/search; страница уточняет родителя через `back=` у шапки (осмотр → карточка его машины). +- После действия, которое тратит форму или удаляет запись (создать, завершить, провести, выдать, удалить), «Назад» не должен вести в отработанную форму или удалённую запись: + - итог — родитель, который стоит в истории прямо позади (правка → карточка ремонта, удаление осмотра → карточка машины), — шаг назад `useBack(parent)`, поток из нескольких экранов — `{ steps: N }` (выбор машины → форма ремонта). Не replace на родителя: он лёг бы в историю второй раз, и первое «Назад» открывало бы тот же экран; + - итог — новый экран (завершённый осмотр, проведённый приход) — переход с `{ replace: true }`. +- Режим или оверлей на весь экран (шаг мастера, пикер, просмотр фото) — своя видимая кнопка закрытия не меньше 44px ниже статус-бара (`BackButton` или `h-11`; у `bg-black/*` — отступ `env(safe-area-inset-top)`). Режим, который дёшево держать в адресе, — search-параметр с push (как `?car=` у выдачи резины и запчастей). +- Падение рендера ловит `src/components/ErrorBoundary.tsx`: шапка с «Назад» и «Перезагрузить» вместо белого экрана; сбрасывается сменой пути или search (режим `?car=`). + +**Новый раздел — чек-лист.** +1. Строка в `APP_ROUTES` (`src/routes.tsx`): `path`, `element`, `guard`, `parent`. +2. Шапка — только `ScreenHeader` из `src/components/ScreenHeader.tsx` (`title`, `subtitle`, `right` — действия, children — вторая строка: поиск, фильтры). В ранних `return` загрузки и ошибки — тоже `ScreenHeader`. +3. Режим внутри экрана — `onBack` у `ScreenHeader`; кнопка в оверлее — `BackButton`. +4. `npm test` зелёный: `src/test/backGuard.test.tsx` открывает каждый маршрут таблицы при вечно висящей сети и падает, если «Назад» в шапке нет, экран увёл на другой адрес или упал (шапка заглушки ErrorBoundary не в счёт). Экрану, которому нужен state перехода, — запись в `SAMPLE_STATE` теста. + +**Где что.** +- `src/lib/back.ts` — `canGoBackInApp()`, `useBack(fallback, { mode, steps })`, `RouteParentContext`. +- `src/components/ScreenHeader.tsx` — `ScreenHeader` и `BackButton`. +- `src/routes.tsx` — таблица маршрутов; `src/App.tsx` — гейты прав, родитель в контекст, ErrorBoundary. +- Тесты: `src/lib/back.test.tsx` (BrowserRouter: шаг назад и холодный старт), `src/components/ScreenHeader.test.tsx`, `src/test/backGuard.test.tsx`. MemoryRouter не пишет `window.history` — в нём всегда путь холодного старта. + +**Команды** (из `frontend/`): `npm test` — vitest; `npm run build` — `tsc -b` и сборка vite. diff --git a/mechanic-pwa/frontend/src/App.tsx b/mechanic-pwa/frontend/src/App.tsx index 8542737..4fd5e41 100644 --- a/mechanic-pwa/frontend/src/App.tsx +++ b/mechanic-pwa/frontend/src/App.tsx @@ -1,30 +1,13 @@ -import { Routes, Route, Navigate } from "react-router-dom"; +import { Routes, Route, Navigate, useLocation, useParams, useSearchParams } from "react-router-dom"; import { useQuery } from "@tanstack/react-query"; +import { Loader2 } from "lucide-react"; import { useAuth } from "@/store/auth"; import { getMe } from "@/api/me"; import { useMeSync } from "@/hooks/useMeSync"; -import Login from "@/pages/Login"; -import ActionMenu from "@/pages/ActionMenu"; -import Home from "@/pages/Home"; -import VehicleCard from "@/pages/VehicleCard"; -import InspectionEditor from "@/pages/InspectionEditor"; -import InspectionReview from "@/pages/InspectionReview"; -import TtStateDetail from "@/pages/TtStateDetail"; -import RepairsFeedPage from "@/pages/repairs/RepairsFeedPage"; -import RepairDetailPage from "@/pages/repairs/RepairDetailPage"; -import EditRepairPage from "@/pages/repairs/EditRepairPage"; -import CarSelectPage from "@/pages/repairs/CarSelectPage"; -import CreateRepairPage from "@/pages/repairs/CreateRepairPage"; -import ReceivingPage from "@/pages/warehouse/ReceivingPage"; -import ReceivingDraftPage from "@/pages/warehouse/ReceivingDraftPage"; -import ReceiptDetailPage from "@/pages/warehouse/ReceiptDetailPage"; -import StocktakePage from "@/pages/warehouse/StocktakePage"; -import TyresPage from "@/pages/warehouse/TyresPage"; -import TyreSizesPage from "@/pages/warehouse/TyreSizesPage"; -import TyreJournalPage from "@/pages/warehouse/TyreJournalPage"; -import PartsIssuePage from "@/pages/warehouse/PartsIssuePage"; -import PartsIssueJournalPage from "@/pages/warehouse/PartsIssueJournalPage"; -import StocktakeSessionPage from "@/pages/warehouse/StocktakeSessionPage"; +import { RouteParentContext } from "@/lib/back"; +import { ScreenHeader } from "@/components/ScreenHeader"; +import ErrorBoundary from "@/components/ErrorBoundary"; +import { APP_ROUTES, type AppRoute } from "@/routes"; function RequireAuth({ children }: { children: React.ReactNode }) { const token = useAuth((s) => s.token); @@ -32,6 +15,21 @@ function RequireAuth({ children }: { children: React.ReactNode }) { return <>{children}; } +/** + * Пока /me не пришёл — уже шапка с «Назад», а не пустой экран: на слабой + * связи проверка прав идёт секунды, и без кнопки из экрана было не выйти. + */ +function GuardLoading() { + return ( +
+ +
+ +
+
+ ); +} + /** * Складские разделы пока только админам. Сервер и так отдаёт 403, но без * клиентской проверки прямой ссылкой можно было бы открыть пустой экран с @@ -41,7 +39,7 @@ function RequireAdmin({ children }: { children: React.ReactNode }) { const token = useAuth((s) => s.token); const meQuery = useQuery({ queryKey: ["me"], queryFn: getMe, staleTime: 60_000, enabled: !!token }); if (!token) return ; - if (meQuery.isLoading) return null; + if (meQuery.isLoading) return ; if (!meQuery.data?.is_admin) return ; return <>{children}; } @@ -54,7 +52,7 @@ function RequireTyres({ children }: { children: React.ReactNode }) { const token = useAuth((s) => s.token); const meQuery = useQuery({ queryKey: ["me"], queryFn: getMe, staleTime: 60_000, enabled: !!token }); if (!token) return ; - if (meQuery.isLoading) return null; + if (meQuery.isLoading) return ; const me = meQuery.data; if (!me?.is_admin && !me?.permissions?.includes("warehouse:tyres")) { return ; @@ -62,41 +60,41 @@ function RequireTyres({ children }: { children: React.ReactNode }) { return <>{children}; } +/** + * Экран из таблицы маршрутов: гейт доступа, родитель для кнопки «Назад» + * (ScreenHeader берёт его из контекста) и страховка от падения рендера. + */ +function RouteScreen({ route }: { route: AppRoute }) { + const params = useParams(); + const [search] = useSearchParams(); + // Сброс ошибки — по пути И search: режим ?car= у выдачи живёт на том же + // пути, и «Назад» из упавшей формы к выбору машины иначе оставлял бы ошибку. + const { pathname, search: query } = useLocation(); + const parent = typeof route.parent === "function" ? route.parent({ params, search }) : route.parent; + const guarded = + route.guard === "admin" ? {route.element} + : route.guard === "tyres" ? {route.element} + : route.guard === "auth" ? {route.element} + : route.element; + return ( + + {guarded} + + ); +} + export default function App() { // У35: фоновая сверка прав механика раз в 5 минут — выкидывает на /login // с сообщением «Доступ отозван», если админ снял can_login_pwa или вывел // пользователя из отдела механиков. useMeSync(); + // Экраны и их родители — в src/routes.tsx (одна таблица на App и тест «Назад»). return ( - } /> - } /> - } /> - } /> - } /> - } /> - } /> - {/* Раздел «Ремонт» — активируется в PR-5 (Фича 1). */} - } /> - } /> - } /> - } /> - } /> - } /> - {/* Склад — приёмка и инвентаризация с телефона (пока только админы). */} - } /> - } /> - } /> - } /> - } /> - {/* Сезонная выдача резины — по складскому праву (не только админам). */} - } /> - } /> - } /> - {/* Выдача запчастей (5763) — всем, кто вошёл в PWA: гейт на сервере require_mechanic. */} - } /> - } /> + {APP_ROUTES.map((r) => ( + } /> + ))} } /> ); diff --git a/mechanic-pwa/frontend/src/components/ErrorBoundary.tsx b/mechanic-pwa/frontend/src/components/ErrorBoundary.tsx new file mode 100644 index 0000000..dd58535 --- /dev/null +++ b/mechanic-pwa/frontend/src/components/ErrorBoundary.tsx @@ -0,0 +1,53 @@ +/** + * Страховка от падения рендера. Без неё ошибка в любом экране оставляла белый + * лист без единой кнопки — на iPhone из такого PWA не выйти ничем, кроме + * выгрузки приложения. Здесь — обычная шапка с «Назад» и «Перезагрузить». + */ +import { Component, type ErrorInfo, type ReactNode } from "react"; +import { RotateCw } from "lucide-react"; +import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; + +interface Props { + children: ReactNode; + /** Сменился адрес (путь или search) — прежняя ошибка к новому экрану не относится. */ + resetKey?: string; +} + +interface State { + error: Error | null; +} + +export default class ErrorBoundary extends Component { + state: State = { error: null }; + + static getDerivedStateFromError(error: Error): State { + return { error }; + } + + componentDidCatch(error: Error, info: ErrorInfo) { + console.error("Экран упал при отрисовке", error, info.componentStack); + } + + componentDidUpdate(prev: Props) { + if (this.state.error && prev.resetKey !== this.props.resetKey) this.setState({ error: null }); + } + + render() { + if (!this.state.error) return this.props.children; + return ( +
+ +
+

+ Экран не открылся из-за сбоя. Вернитесь назад или перезагрузите приложение. +

+ +
+
+ ); + } +} diff --git a/mechanic-pwa/frontend/src/components/ScreenHeader.test.tsx b/mechanic-pwa/frontend/src/components/ScreenHeader.test.tsx new file mode 100644 index 0000000..f31e4df --- /dev/null +++ b/mechanic-pwa/frontend/src/components/ScreenHeader.test.tsx @@ -0,0 +1,79 @@ +/** + * Шапка экрана: кого считает родителем и когда кнопки нет. MemoryRouter + * window.history не трогает — здесь всегда путь холодного старта (replace + * на родителя); ветка «есть история» — в src/lib/back.test.tsx. + */ +import { render, screen } from "@testing-library/react"; +import userEvent from "@testing-library/user-event"; +import { vi } from "vitest"; +import { MemoryRouter, Route, Routes, useLocation } from "react-router-dom"; +import { RouteParentContext } from "@/lib/back"; +import { ScreenHeader } from "@/components/ScreenHeader"; +import ErrorBoundary from "@/components/ErrorBoundary"; + +function Where() { + return

{useLocation().pathname}

; +} + +function renderAt(ui: React.ReactNode, parent: string | null | undefined) { + return render( + + + {ui}} + /> + } /> + + , + ); +} + +test("родитель из таблицы маршрутов (контекст) → «Назад» ведёт к нему", async () => { + const user = userEvent.setup(); + renderAt(, "/repairs"); + await user.click(screen.getByRole("button", { name: "Назад" })); + expect(screen.getByTestId("where")).toHaveTextContent("/repairs"); +}); + +test("back страницы перекрывает табличного родителя", async () => { + const user = userEvent.setup(); + renderAt(, "/vehicles"); + await user.click(screen.getByRole("button", { name: "Назад" })); + expect(screen.getByTestId("where")).toHaveTextContent("/vehicles/7"); +}); + +test("onBack — своё действие вместо навигации", async () => { + const user = userEvent.setup(); + const onBack = vi.fn(); + renderAt(, "/"); + await user.click(screen.getByRole("button", { name: "Назад" })); + expect(onBack).toHaveBeenCalledOnce(); + expect(screen.queryByTestId("where")).toBeNull(); +}); + +test("родитель null (главная, вход) → кнопки нет", () => { + renderAt(, null); + expect(screen.queryByRole("button", { name: "Назад" })).toBeNull(); +}); + +test("вне таблицы маршрутов кнопка всё равно есть (к главной)", async () => { + const user = userEvent.setup(); + renderAt(, undefined); + await user.click(screen.getByRole("button", { name: "Назад" })); + expect(screen.getByTestId("where")).toHaveTextContent("/"); +}); + +function Boom(): never { + throw new Error("сломалось"); +} + +test("упавший экран → шапка с «Назад» и «Перезагрузить» вместо белого листа", async () => { + const quiet = vi.spyOn(console, "error").mockImplementation(() => {}); + const user = userEvent.setup(); + renderAt(, "/wh/tyres"); + expect(screen.getByRole("button", { name: "Перезагрузить" })).toBeInTheDocument(); + await user.click(screen.getByRole("button", { name: "Назад" })); + expect(screen.getByTestId("where")).toHaveTextContent("/wh/tyres"); + quiet.mockRestore(); +}); diff --git a/mechanic-pwa/frontend/src/components/ScreenHeader.tsx b/mechanic-pwa/frontend/src/components/ScreenHeader.tsx new file mode 100644 index 0000000..c1af135 --- /dev/null +++ b/mechanic-pwa/frontend/src/components/ScreenHeader.tsx @@ -0,0 +1,91 @@ +/** + * Шапка экрана с кнопкой «Назад» — одна на всё приложение (задача 6385). + * + * У установленного на iPhone PWA нет системной «Назад», поэтому она есть в + * шапке каждого экрана, кроме главной и входа, — и в загрузке, и в ошибке, и + * в «не найдено». Куда ведёт: по истории на шаг назад, а без истории — к + * родителю из таблицы маршрутов (src/routes.tsx), см. src/lib/back.ts. + * + * Шапка липкая (sticky top-0): в index.css она опущена ниже статус-бара iOS. + */ +import type { ReactNode } from "react"; +import { ChevronLeft } from "lucide-react"; +import { Button } from "@/components/ui/button"; +import { cn } from "@/lib/utils"; +import { useBack, useRouteParent, type BackMode } from "@/lib/back"; + +/** Шеврон + подпись; зона нажатия не меньше 44×44 — жмут в перчатках. */ +export function BackButton({ + onClick, label = "Назад", className, disabled, +}: { + onClick: () => void; + label?: string; + className?: string; + disabled?: boolean; +}) { + return ( + + ); +} + +interface Props { + title?: ReactNode; + subtitle?: ReactNode; + /** Действия экрана справа. Без них там распорка — заголовок стоит по центру. */ + right?: ReactNode; + /** Вторая строка шапки: поиск, фильтры, прогресс. */ + children?: ReactNode; + /** Родитель вместо табличного — когда экран знает больше (id машины осмотра). */ + back?: string; + /** "parent" — всегда к родителю с replace, мимо истории. */ + backMode?: BackMode; + /** Своё действие целиком — для режимов внутри экрана (форма → выбор машины). */ + onBack?: () => void; +} + +export function ScreenHeader({ title, subtitle, right, children, back, backMode, onBack }: Props) { + const routeParent = useRouteParent(); + // Вне таблицы маршрутов (тест отдельного компонента) родитель — главная: + // кнопка должна быть всегда, а не только там, где её не забыли подключить. + const parent = back ?? (routeParent === undefined ? "/" : routeParent); + const goBack = useBack(parent ?? "/", { mode: backMode }); + const showBack = !!onBack || parent !== null; + + return ( +
+
+ {showBack ? ( + + ) : ( + + )} +
+ {/* До двух строк, а не обрезка на полуслове: на 375px рядом с «Назад» + и кнопками действий «Выдача резины» в одну строку не влезает. + Две строки по 20px ниже кнопки в 44px — шапка не растёт. */} +

{title}

+ {subtitle != null && subtitle !== "" && ( +

{subtitle}

+ )} +
+ {right ? ( +
{right}
+ ) : ( + + )} +
+ {children} +
+ ); +} diff --git a/mechanic-pwa/frontend/src/components/damage-flow/PhotoAnnotateStep.tsx b/mechanic-pwa/frontend/src/components/damage-flow/PhotoAnnotateStep.tsx index 0ca66cc..0189db1 100644 --- a/mechanic-pwa/frontend/src/components/damage-flow/PhotoAnnotateStep.tsx +++ b/mechanic-pwa/frontend/src/components/damage-flow/PhotoAnnotateStep.tsx @@ -1,5 +1,6 @@ import { useEffect, useRef, useState } from "react"; import { Button } from "@/components/ui/button"; +import { BackButton } from "@/components/ScreenHeader"; interface Props { photoFile: File; @@ -180,10 +181,12 @@ export function PhotoAnnotateStep({ photoFile, zoneLabel, onSubmit, onCancel }: return (
-
-
+
+ {/* Шаг назад дублируем в шапке: системной «Назад» на iPhone нет, а ищут её сверху. */} + +
Обведите повреждение
-

{zoneLabel}

+

{zoneLabel}

diff --git a/mechanic-pwa/frontend/src/components/repairs/PartsPickerModal.tsx b/mechanic-pwa/frontend/src/components/repairs/PartsPickerModal.tsx index 61821a4..0d041b5 100644 --- a/mechanic-pwa/frontend/src/components/repairs/PartsPickerModal.tsx +++ b/mechanic-pwa/frontend/src/components/repairs/PartsPickerModal.tsx @@ -62,7 +62,7 @@ export default function PartsPickerModal({ open, carId, onPick, onClose }: Props return (
- diff --git a/mechanic-pwa/frontend/src/lib/back.test.tsx b/mechanic-pwa/frontend/src/lib/back.test.tsx new file mode 100644 index 0000000..251f56f --- /dev/null +++ b/mechanic-pwa/frontend/src/lib/back.test.tsx @@ -0,0 +1,134 @@ +/** + * Смысл «Назад» (src/lib/back.ts). BrowserRouter в jsdom пишет настоящий + * window.history, поэтому путь «есть история» проверяется честно; popstate в + * jsdom асинхронный — ждём через findBy*. + */ +import { render, screen } from "@testing-library/react"; +import userEvent from "@testing-library/user-event"; +import { BrowserRouter, Link, MemoryRouter, Route, Routes } from "react-router-dom"; +import { canGoBackInApp, useBack, type BackMode } from "@/lib/back"; + +function BackTo({ fallback, mode }: { fallback: string; mode?: BackMode }) { + const back = useBack(fallback, { mode }); + return ; +} + +function TestApp({ mode }: { mode?: BackMode }) { + return ( + + в А} /> +

экран А

в Б} /> +

экран Б

} /> + экран-родитель

} /> +
+ ); +} + +const idx = () => (window.history.state as { idx?: number } | null)?.idx; + +beforeEach(() => { + // Каждый тест — новый запуск: запись без idx, BrowserRouter проставит 0. + window.history.replaceState(null, "", "/"); +}); + +test("есть история в приложении → ровно на одну запись назад", async () => { + const user = userEvent.setup(); + render(); + await user.click(screen.getByText("в А")); + await user.click(screen.getByText("в Б")); + expect(idx()).toBe(2); + expect(canGoBackInApp()).toBe(true); + const length = window.history.length; + + await user.click(screen.getByRole("button", { name: "Назад" })); + + expect(await screen.findByText("экран А")).toBeInTheDocument(); + expect(window.location.pathname).toBe("/a"); + expect(idx()).toBe(1); + expect(window.history.length).toBe(length); // шаг назад, а не новая запись +}); + +test("холодный старт (idx 0: пуш, ссылка) → replace на родителя, история не растёт", async () => { + window.history.replaceState(null, "", "/b"); + const user = userEvent.setup(); + render(); + expect(idx()).toBe(0); + expect(canGoBackInApp()).toBe(false); + const length = window.history.length; + + await user.click(screen.getByRole("button", { name: "Назад" })); + + expect(await screen.findByText("экран-родитель")).toBeInTheDocument(); + expect(window.location.pathname).toBe("/parent"); + expect(window.history.length).toBe(length); + expect(idx()).toBe(0); +}); + +test("режим parent → к родителю с replace даже при истории позади", async () => { + const user = userEvent.setup(); + render(); + await user.click(screen.getByText("в А")); + await user.click(screen.getByText("в Б")); + const length = window.history.length; + + await user.click(screen.getByRole("button", { name: "Назад" })); + + expect(await screen.findByText("экран-родитель")).toBeInTheDocument(); + expect(idx()).toBe(2); // replace держит счётчик — запись Б заменена + expect(window.history.length).toBe(length); +}); + +/** Поток создания ремонта в миниатюре: меню → лента → выбор машины → форма. */ +function Save({ steps }: { steps: number }) { + const leave = useBack("/repairs", { steps }); + return ; +} + +function FlowApp() { + return ( + +

меню

в ленту} /> +

лента

добавить} /> +

выбор машины

машина 5} /> + } /> +
+ ); +} + +test("steps: 2 — поток уходит из истории целиком, «Назад» с ленты ведёт в меню, а не в выбор", async () => { + const user = userEvent.setup(); + render(); + await user.click(screen.getByText("в ленту")); + await user.click(screen.getByText("добавить")); + await user.click(screen.getByText("машина 5")); + expect(idx()).toBe(3); + + await user.click(screen.getByRole("button", { name: "Сохранить" })); + expect(await screen.findByText("лента")).toBeInTheDocument(); + expect(idx()).toBe(1); + + await user.click(screen.getByRole("button", { name: "Назад" })); + expect(await screen.findByText("меню")).toBeInTheDocument(); + expect(window.location.pathname).toBe("/"); +}); + +test("steps: 2, а позади меньше двух записей (форма открыта ссылкой) → replace на fallback", async () => { + window.history.replaceState(null, "", "/repairs/new/5"); + const user = userEvent.setup(); + render(); + const length = window.history.length; + + await user.click(screen.getByRole("button", { name: "Сохранить" })); + + expect(await screen.findByText("лента")).toBeInTheDocument(); + expect(idx()).toBe(0); + expect(window.history.length).toBe(length); +}); + +test("MemoryRouter window.history не трогает → всегда путь холодного старта", async () => { + const user = userEvent.setup(); + render(); + expect(canGoBackInApp()).toBe(false); + await user.click(screen.getByRole("button", { name: "Назад" })); + expect(await screen.findByText("экран-родитель")).toBeInTheDocument(); +}); diff --git a/mechanic-pwa/frontend/src/lib/back.ts b/mechanic-pwa/frontend/src/lib/back.ts new file mode 100644 index 0000000..ab83cd2 --- /dev/null +++ b/mechanic-pwa/frontend/src/lib/back.ts @@ -0,0 +1,69 @@ +/** + * Кнопка «Назад» внутри приложения (задача 6385). + * + * У PWA, установленного на iPhone, нет системной кнопки «Назад», а свайп от + * края работает через раз и после холодного старта или открытия из пуша не + * делает ничего — истории нет. Поэтому шаг назад даёт сам интерфейс, и его + * смысл собран здесь, в одном месте: + * - в этом запуске приложения есть куда вернуться → navigate(-1); + * - иначе → на родительский экран с replace (не push: push родителя давал + * бы петлю с системной «Назад» на Android). + */ +import { createContext, useCallback, useContext } from "react"; +import { useNavigate } from "react-router-dom"; + +/** + * Есть ли в этом запуске экран позади текущего. + * + * `idx` — собственный счётчик записей BrowserRouter в history.state: 0 — первая + * запись запуска (холодный старт, открытие из пуша, внешняя ссылка), push + * увеличивает, replace сохраняет. `location.key` не годится (replace даёт + * новый ключ без истории позади), `history.length` тоже (считает записи до + * приложения). MemoryRouter history не трогает — там всегда false. + */ +export function canGoBackInApp(): boolean { + return inAppDepth() > 0; +} + +/** Сколько записей этого запуска позади текущей (тот же idx; нет его — 0). */ +function inAppDepth(): number { + const idx = (window.history.state as { idx?: unknown } | null)?.idx; + return typeof idx === "number" && idx > 0 ? idx : 0; +} + +/** + * history — шаг назад по истории, если она есть (обычный случай); + * parent — всегда к родителю с replace: для экранов, куда возвращаться по + * истории неправильно. + */ +export type BackMode = "history" | "parent"; + +/** + * Колбэк «на шаг назад»; fallback — родительский экран. + * + * Им же уходят с отработанной формы, когда родитель стоит в истории прямо + * позади: replace на родителя положил бы его туда второй раз, и первое + * «Назад» с него вело бы на него же. steps — сколько записей снять разом: + * поток из нескольких экранов (выбор машины → форма) уходит целиком. Записей + * позади меньше — replace на fallback. + */ +export function useBack(fallback: string, opts?: { mode?: BackMode; steps?: number }): () => void { + const navigate = useNavigate(); + const mode = opts?.mode ?? "history"; + const steps = opts?.steps ?? 1; + return useCallback(() => { + if (mode === "history" && inAppDepth() >= steps) navigate(-steps); + else navigate(fallback, { replace: true }); + }, [navigate, fallback, mode, steps]); +} + +/** + * Родитель текущего экрана — из таблицы маршрутов (src/routes.tsx), кладёт + * App. null — у экрана родителя нет (главная, вход); undefined — экран + * отрисован вне таблицы (изолированный тест компонента). + */ +export const RouteParentContext = createContext(undefined); + +export function useRouteParent(): string | null | undefined { + return useContext(RouteParentContext); +} diff --git a/mechanic-pwa/frontend/src/pages/Home.tsx b/mechanic-pwa/frontend/src/pages/Home.tsx index 8186a0d..9409699 100644 --- a/mechanic-pwa/frontend/src/pages/Home.tsx +++ b/mechanic-pwa/frontend/src/pages/Home.tsx @@ -4,6 +4,7 @@ import { useNavigate, useSearchParams } from "react-router-dom"; import { listVehicles } from "@/api/vehicles"; import { Input } from "@/components/ui/input"; import { Card } from "@/components/ui/card"; +import { ScreenHeader } from "@/components/ScreenHeader"; const ACTION_TITLES: Record = { inspect: "Осмотр", @@ -57,19 +58,7 @@ export default function Home() { return (
-
- -
-

- Машины{subtitle && ` — ${subtitle}`} -

-
-
+
{ toast.success("Осмотр завершён"); - navigate(`/inspections/${insId}`); + // replace: завершённый осмотр — уже не форма, «Назад» из итога ведёт + // дальше, а не обратно в редактор. + navigate(`/inspections/${insId}`, { replace: true }); }, onError: () => toast.error("Не удалось завершить"), }); @@ -157,9 +160,17 @@ export default function InspectionEditor() { onError: () => toast.error("Не удалось удалить"), }); - if (isLoading) return
Загружаю…
; - if (isError || !ins) - return
Осмотр не найден.
; + if (isLoading || isError || !ins) + return ( + <> + + {isLoading ? ( +
Загружаю…
+ ) : ( +
Осмотр не найден.
+ )} + + ); // Photos lookup by side+slot for initialPhotoId const photosBySide = new Map(); @@ -176,24 +187,14 @@ export default function InspectionEditor() { }; return ( -
- - -
-

- Осмотр #{ins.id}{" "} - ({ins.type}) -

-
- {new Date(ins.started_at).toLocaleString("ru-RU")} -
-
- + <> + {/* Без истории «Назад» ведёт на карточку машины этого осмотра. */} + +

Схема — тапните на зону, чтобы добавить метку @@ -304,6 +305,11 @@ export default function InspectionEditor() { {flow.kind === "capture" && ( + setFlow({ kind: "classify", zoneId: flow.zoneId, zoneLabel: flow.zoneLabel, points: flow.points }) + } onCancel={() => setFlow({ kind: "idle" })} onPhotoCaptured={(file) => setFlow({ @@ -503,23 +509,29 @@ export default function InspectionEditor() { )}

+ ); } function CapturePhotoStep({ zoneLabel, + onBack, onCancel, onPhotoCaptured, }: { zoneLabel: string; + onBack: () => void; onCancel: () => void; onPhotoCaptured: (file: File) => void; }) { return (
-
-
Фото повреждения
-

{zoneLabel}

+
+ +
+
Фото повреждения
+

{zoneLabel}

+
= { @@ -92,6 +95,10 @@ export default function InspectionReview() { queryKey: ["inspection", insId], queryFn: () => getInspection(insId), }); + // Родитель осмотра — карточка его машины; пока не загрузился — список машин. + const vehicleId = ins?.vehicle?.id ?? ins?.vehicle_id; + const vehiclePath = vehicleId ? `/vehicles/${vehicleId}` : "/vehicles"; + const backToVehicle = useBack(vehiclePath); const { data: me } = useQuery({ queryKey: ["me"], @@ -106,7 +113,10 @@ export default function InspectionReview() { onSuccess: () => { toast.success("Осмотр удалён"); queryClient.invalidateQueries({ queryKey: ["vehicle"] }); - navigate(-1); + // Редактора этого осмотра позади больше нет («Завершить» заменяет его + // итогом), позади — карточка машины: шаг назад к ней. Не replace на неё — + // карточка встала бы в историю второй раз. Без истории — replace. + backToVehicle(); }, onError: () => toast.error("Не удалось удалить осмотр"), }); @@ -147,14 +157,23 @@ export default function InspectionReview() { onSuccess: (updated) => { queryClient.setQueryData(["inspection", insId], updated); queryClient.invalidateQueries({ queryKey: ["vehicle"] }); - navigate(`/inspections/${insId}/edit`); + // replace: осмотр снова в работе, его место в истории занимает редактор. + navigate(`/inspections/${insId}/edit`, { replace: true }); }, onError: () => toast.error("Не удалось вернуть осмотр в работу"), }); - if (isLoading) return
Загружаю…
; - if (isError || !ins) - return
Осмотр не найден.
; + if (isLoading || isError || !ins) + return ( + <> + + {isLoading ? ( +
Загружаю…
+ ) : ( +
Осмотр не найден.
+ )} + + ); const notesDirty = (notesDraft ?? "") !== (ins.notes ?? ""); @@ -182,16 +201,9 @@ export default function InspectionReview() { const extraMarkerPhotos = markerPhotoIds.filter((id) => !photosById.has(id)); return ( -
- - -

Осмотр #{ins.id}

- + <> + +
{ins.vehicle && ( setPreview(null)} >
e.stopPropagation()} + onClick={(e) => e.target !== e.currentTarget && e.stopPropagation()} > {preview.kind === "photo" ? ( )}
+ ); } diff --git a/mechanic-pwa/frontend/src/pages/TtStateDetail.tsx b/mechanic-pwa/frontend/src/pages/TtStateDetail.tsx index 54563b8..d75b62e 100644 --- a/mechanic-pwa/frontend/src/pages/TtStateDetail.tsx +++ b/mechanic-pwa/frontend/src/pages/TtStateDetail.tsx @@ -1,7 +1,8 @@ import { useState, useMemo, useRef, useEffect } from "react"; -import { useParams, useNavigate } from "react-router-dom"; +import { useParams, useLocation } from "react-router-dom"; import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query"; import { toast } from "sonner"; +import { X } from "lucide-react"; import { getTtState, deleteTtState, @@ -11,6 +12,8 @@ import { } from "@/api/vehicles"; import { getMe } from "@/api/me"; import { Card } from "@/components/ui/card"; +import { ScreenHeader } from "@/components/ScreenHeader"; +import { useBack } from "@/lib/back"; import { TtDamageMap } from "@/components/tt/TtDamageMap"; interface ZoneLabels { @@ -75,8 +78,13 @@ type PreviewItem = export default function TtStateDetail() { const { id } = useParams<{ id: string }>(); - const navigate = useNavigate(); + const location = useLocation(); const stateId = Number(id); + // Машины в ответе нет — её id приходит из карточки машины (state перехода). + // Без него (ссылка, перезагрузка без state) родитель — список машин. + const fromVehicle = (location.state as { vehicleId?: number } | null)?.vehicleId; + const vehiclePath = fromVehicle ? `/vehicles/${fromVehicle}` : "/vehicles"; + const backToVehicle = useBack(vehiclePath); const zoneRefs = useRef>({}); const { data: state, isLoading, isError } = useQuery({ @@ -111,7 +119,9 @@ export default function TtStateDetail() { toast.success("Осмотр удалён"); // Drop any cached tt-history for vehicle list so новый рендер не покажет удалённый. queryClient.invalidateQueries({ queryKey: ["vehicle"] }); - navigate(-1); + // Шаг назад к карточке машины (она стоит прямо позади) — не replace на + // неё: карточка встала бы в историю второй раз. Без истории — replace. + backToVehicle(); }, onError: () => toast.error("Не удалось удалить осмотр"), }); @@ -136,10 +146,17 @@ export default function TtStateDetail() { zoneRefs.current = {}; }, [stateId]); - if (isLoading) - return
Загружаю…
; - if (isError || !state) - return
Осмотр не найден.
; + if (isLoading || isError || !state) + return ( + <> + + {isLoading ? ( +
Загружаю…
+ ) : ( +
Осмотр не найден.
+ )} + + ); const date = state.unix_time ? new Date(state.unix_time * 1000).toLocaleString("ru-RU") @@ -160,14 +177,9 @@ export default function TtStateDetail() { } return ( -
- - + <> + +
Element Mechanic
@@ -259,7 +271,8 @@ export default function TtStateDetail() { ref={(el) => { zoneRefs.current[zid] = el; }} - className="scroll-mt-4" + // Прокрутка к зоне не должна прятать заголовок под липкой шапкой. + className="scroll-mt-[calc(env(safe-area-inset-top)+5rem)]" >

{label} @@ -343,20 +356,24 @@ export default function TtStateDetail() {

)} + {/* Отступы safe-area: крестик не должен уйти под статус-бар iOS. + Тап по тёмному полю вокруг фото закрывает, по самому фото — нет. */} {preview && (
setPreview(null)} >
{preview.kind === "zone" && preview.photo.image_with_lines_id && ( @@ -373,7 +390,7 @@ export default function TtStateDetail() {
e.stopPropagation()} + onClick={(e) => e.target !== e.currentTarget && e.stopPropagation()} > )}
+ ); } diff --git a/mechanic-pwa/frontend/src/pages/VehicleCard.tsx b/mechanic-pwa/frontend/src/pages/VehicleCard.tsx index f7d195a..b282a82 100644 --- a/mechanic-pwa/frontend/src/pages/VehicleCard.tsx +++ b/mechanic-pwa/frontend/src/pages/VehicleCard.tsx @@ -1,5 +1,5 @@ import { useState } from "react"; -import { useParams, useNavigate, useSearchParams } from "react-router-dom"; +import { useParams, useNavigate } from "react-router-dom"; import { useQuery, useMutation } from "@tanstack/react-query"; import { toast } from "sonner"; import { getVehicle, getTtHistory } from "@/api/vehicles"; @@ -8,6 +8,7 @@ import { Button } from "@/components/ui/button"; import { Card } from "@/components/ui/card"; import { Input } from "@/components/ui/input"; import { Label } from "@/components/ui/label"; +import { ScreenHeader } from "@/components/ScreenHeader"; const INSPECTION_TYPE_LABELS: Record = { handover: "Выдача", @@ -42,11 +43,8 @@ function timeAgo(iso: string): string { export default function VehicleCard() { const { id } = useParams<{ id: string }>(); const navigate = useNavigate(); - const [searchParams] = useSearchParams(); const vehicleId = Number(id); - const action = searchParams.get("action") || undefined; - const [pendingType, setPendingType] = useState(null); const [mileageInput, setMileageInput] = useState(""); const [mileageSource, setMileageSource] = useState< @@ -95,20 +93,23 @@ export default function VehicleCard() { setMileageSource(null); }; - if (isLoading) - return
Загружаю…
; - if (isError || !v) - return
Машина не найдена.
; + // «Назад» — к списку машин (с тем же ?action=); родитель в src/routes.tsx. + if (isLoading || isError || !v) + return ( + <> + + {isLoading ? ( +
Загружаю…
+ ) : ( +
Машина не найдена.
+ )} + + ); return ( -
- - + <> + +
{v.license_plate}
@@ -239,7 +240,9 @@ export default function VehicleCard() { navigate(`/tt-states/${s.id}`)} + // id машины в ответе по TT-осмотру нет — передаём, чтобы + // «Назад» и удаление вели на эту карточку. + onClick={() => navigate(`/tt-states/${s.id}`, { state: { vehicleId } })} >
@@ -367,5 +370,6 @@ export default function VehicleCard() {
)}
+ ); } diff --git a/mechanic-pwa/frontend/src/pages/repairs/CarSelectPage.test.tsx b/mechanic-pwa/frontend/src/pages/repairs/CarSelectPage.test.tsx index b90cb8a..58d585c 100644 --- a/mechanic-pwa/frontend/src/pages/repairs/CarSelectPage.test.tsx +++ b/mechanic-pwa/frontend/src/pages/repairs/CarSelectPage.test.tsx @@ -13,6 +13,7 @@ vi.mock("@/api/repairsCreate", () => ({ })); import CarSelectPage from "@/pages/repairs/CarSelectPage"; +import { RouteParentContext } from "@/lib/back"; beforeEach(() => navigate.mockClear()); @@ -26,7 +27,7 @@ test("«Машина не из парка» → ввод номера → naviga await user.click(screen.getByText("Продолжить →")); expect(navigate).toHaveBeenCalledWith("/repairs/new-external", { - state: { plate: "х999хх199", make: "Toyota Camry" }, + state: { plate: "х999хх199", make: "Toyota Camry", fromPicker: true }, }); }); @@ -39,13 +40,35 @@ test("марка опциональна → make=null если поле пуст await user.click(screen.getByText("Продолжить →")); expect(navigate).toHaveBeenCalledWith("/repairs/new-external", { - state: { plate: "А001АА125", make: null }, + state: { plate: "А001АА125", make: null, fromPicker: true }, }); }); +test("машина из парка → форма с меткой fromPicker (после сохранения выбор уходит из истории)", async () => { + const { searchCars } = await import("@/api/repairsCreate"); + vi.mocked(searchCars).mockResolvedValueOnce([ + { id: 5, plate: "А005АА125", brand: "Kia", model: "Rio" }, + ]); + const user = userEvent.setup(); + render(); + await user.click(await screen.findByText("А005АА125")); + expect(navigate).toHaveBeenCalledWith("/repairs/new/5", { state: { fromPicker: true } }); +}); + test("«Продолжить» заблокирована без номера", async () => { const user = userEvent.setup(); render(); await user.click(screen.getByText("+ Машина не из парка")); expect(screen.getByText("Продолжить →").closest("button")).toBeDisabled(); }); + +test("«Назад» без истории (открыли ссылкой) → к родителю из таблицы маршрутов, replace", async () => { + const user = userEvent.setup(); + render( + + + , + ); + await user.click(screen.getByRole("button", { name: "Назад" })); + expect(navigate).toHaveBeenCalledWith("/repairs", { replace: true }); +}); diff --git a/mechanic-pwa/frontend/src/pages/repairs/CarSelectPage.tsx b/mechanic-pwa/frontend/src/pages/repairs/CarSelectPage.tsx index c369415..7d7ed9f 100644 --- a/mechanic-pwa/frontend/src/pages/repairs/CarSelectPage.tsx +++ b/mechanic-pwa/frontend/src/pages/repairs/CarSelectPage.tsx @@ -3,13 +3,15 @@ * * Открывается из `/repairs` по кнопке «+ Добавить ремонт». * Поиск по госномеру (У44 — релевантность). После тапа на строку - * переходим в `/repairs/new/:carId` (CreateRepairPage). + * переходим в `/repairs/new/:carId` (CreateRepairPage). Метка fromPicker в + * state — форма после сохранения снимает из истории и себя, и этот экран. */ import { useEffect, useState } from "react"; import { useNavigate } from "react-router-dom"; -import { ChevronLeft, Search } from "lucide-react"; +import { Search } from "lucide-react"; import { Button } from "@/components/ui/button"; import { Input } from "@/components/ui/input"; +import { ScreenHeader } from "@/components/ScreenHeader"; import { searchCars, type CarBrief } from "@/api/repairsCreate"; export default function CarSelectPage() { @@ -25,7 +27,7 @@ export default function CarSelectPage() { const continueExternal = () => { const plate = extPlate.trim(); if (!plate) return; - navigate("/repairs/new-external", { state: { plate, make: extMake.trim() || null } }); + navigate("/repairs/new-external", { state: { plate, make: extMake.trim() || null, fromPicker: true } }); }; useEffect(() => { @@ -50,13 +52,7 @@ export default function CarSelectPage() { return (
-
-
- -

Выберите машину

-
+
@@ -69,7 +65,7 @@ export default function CarSelectPage() { />
-
+

Машина с улицы

diff --git a/mechanic-pwa/frontend/src/pages/repairs/CreateRepairPage.tsx b/mechanic-pwa/frontend/src/pages/repairs/CreateRepairPage.tsx index c243811..0dc30c9 100644 --- a/mechanic-pwa/frontend/src/pages/repairs/CreateRepairPage.tsx +++ b/mechanic-pwa/frontend/src/pages/repairs/CreateRepairPage.tsx @@ -16,9 +16,11 @@ */ import { useEffect, useMemo, useRef, useState } from "react"; import { useNavigate, useParams, useLocation } from "react-router-dom"; -import { ChevronLeft, Plus, Trash2, Pencil, Camera } from "lucide-react"; +import { Plus, Trash2, Pencil, Camera } from "lucide-react"; import { toast } from "sonner"; import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; +import { useBack } from "@/lib/back"; import { Input } from "@/components/ui/input"; import { Label } from "@/components/ui/label"; import { repairCanSubmit, repairSubmitWhyDisabled } from "@/lib/repairForm"; @@ -113,6 +115,13 @@ export default function CreateRepairPage() { const isExternal = !carIdRaw; const externalState = location.state as { plate: string; make: string | null } | null; const carId = carIdRaw ? Number(carIdRaw) : 0; + // Ремонт сохранён — поток создания уходит из истории целиком. Форму открыли + // из выбора машины (метка fromPicker в state), а его — из ленты: лента стоит + // двумя записями раньше, туда и возвращаемся, и «Назад» с ленты ведёт в + // меню, а не в выбор машины отработанного ремонта. Без выбора позади + // (ссылка, холодный старт) — лента вместо формы с replace. + const fromPicker = !!(location.state as { fromPicker?: boolean } | null)?.fromPicker; + const leaveCreateFlow = useBack("/repairs", fromPicker ? { steps: 2 } : { mode: "parent" }); // Idempotency-Key для этой формы — стабилен между ре-сабмитами (У20). const idemKey = useRef(uuid4()); @@ -160,7 +169,12 @@ export default function CreateRepairPage() { setMileage(null); return; } - if (!carId) return; + // Битый адрес (/repairs/new/0, /repairs/new/abc) раньше давал вечную + // «Загрузку» без шапки — теперь понятная ошибка и «Назад». + if (!Number.isInteger(carId) || carId <= 0) { + setCtxError("Машина не найдена — выберите её заново"); + return; + } getCarContext(carId) .then((c) => { setCtx(c); @@ -394,7 +408,7 @@ export default function CreateRepairPage() { idemKey.current, ); toast.success(`Ремонт #${result.id} сохранён`); - navigate("/repairs", { replace: true }); + leaveCreateFlow(); } catch (e) { toast.error((e as Error).message || "Не удалось сохранить"); } finally { @@ -404,30 +418,32 @@ export default function CreateRepairPage() { if (ctxError) { return ( -
-
- {ctxError} + <> + +
+
+ {ctxError} +
-
+ ); } if (!ctx) { return ( -
-
Загрузка…
-
+ <> + +
+
Загрузка…
+
+ ); } return (
-
-
- -

Новый ремонт

+ {submitting ? "Сохранение…" : "Сохранить"} -
+ } + >
{ctx.plate}
@@ -449,7 +466,7 @@ export default function CreateRepairPage() { : " · Без водителя"}
-
+
{/* Пробег */} diff --git a/mechanic-pwa/frontend/src/pages/repairs/EditRepairPage.tsx b/mechanic-pwa/frontend/src/pages/repairs/EditRepairPage.tsx index 39c1384..8cd2976 100644 --- a/mechanic-pwa/frontend/src/pages/repairs/EditRepairPage.tsx +++ b/mechanic-pwa/frontend/src/pages/repairs/EditRepairPage.tsx @@ -6,9 +6,11 @@ * НЕ редактируются — для смены фото нужно дождаться PR-9. */ import { useEffect, useMemo, useState } from "react"; -import { useNavigate, useParams } from "react-router-dom"; -import { ChevronLeft, Plus, Trash2 } from "lucide-react"; +import { useParams } from "react-router-dom"; +import { Plus, Trash2 } from "lucide-react"; import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; +import { useBack, useRouteParent } from "@/lib/back"; import { Input } from "@/components/ui/input"; import { Label } from "@/components/ui/label"; import { @@ -69,7 +71,11 @@ function fmt(n: number): string { export default function EditRepairPage() { const { id } = useParams<{ id: string }>(); - const navigate = useNavigate(); + // «Отмена» и «Сохранить» уходят тем же шагом назад, что и шапка (родитель + // из src/routes.tsx): карточка ремонта стоит в истории прямо позади правки, + // replace на неё положил бы её туда второй раз — первое «Назад» с карточки + // открывало бы её же. Карточка при возврате грузится заново. + const backToRepair = useBack(useRouteParent() ?? `/repairs/${id}`); const [detail, setDetail] = useState(null); const [loading, setLoading] = useState(true); const [saving, setSaving] = useState(false); @@ -259,7 +265,7 @@ export default function EditRepairPage() { ? { mechanic_ids: mechanics.map((m) => m.mechanic_id) } : {}), }); - navigate(`/repairs/${detail.id}`, { replace: true }); + backToRepair(); } catch (e) { setError((e as Error).message || "Не удалось сохранить"); setSaving(false); @@ -268,20 +274,7 @@ export default function EditRepairPage() { return (
-
-
- -

- Правка ремонта {detail ? `#${detail.id}` : ""} -

-
-
+
{loading && ( @@ -505,7 +498,8 @@ export default function EditRepairPage() { {/* Sticky footer */} {detail && (
- -
-

- {data ? `Ремонт #${data.id}` : "Ремонт"} -

- {data && ( -
- {fmtDateTime(data.created_at)} -
- )} -
-
-
+
{loading && ( diff --git a/mechanic-pwa/frontend/src/pages/repairs/RepairsFeedPage.tsx b/mechanic-pwa/frontend/src/pages/repairs/RepairsFeedPage.tsx index 49ee43d..b6b014e 100644 --- a/mechanic-pwa/frontend/src/pages/repairs/RepairsFeedPage.tsx +++ b/mechanic-pwa/frontend/src/pages/repairs/RepairsFeedPage.tsx @@ -14,9 +14,10 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react"; import { useNavigate } from "react-router-dom"; import { useQuery } from "@tanstack/react-query"; import { HTTPError } from "ky"; -import { ChevronLeft, Plus, Search, Wrench, X } from "lucide-react"; +import { Plus, Search, Wrench, X } from "lucide-react"; import { Button } from "@/components/ui/button"; import { Input } from "@/components/ui/input"; +import { ScreenHeader } from "@/components/ScreenHeader"; import { useRepairsFeed } from "@/hooks/useRepairsFeed"; import { formatFeedTimestamp } from "@/lib/timeFormat"; import { getRepairsMonthStats, type FeedItem } from "@/api/repairsFeed"; @@ -99,19 +100,9 @@ export default function RepairsFeedPage() { return (
-
-
- -

Ремонт

+ Добавить -
+ } + > {/* Поиск по ленте. Без autoFocus: экран открывают ради списка, а не ради поиска — не выдёргиваем клавиатуру на каждом заходе. */}
@@ -150,7 +142,7 @@ export default function RepairsFeedPage() { )}
-
+
{/* Итого слева — сумма работ и количество ремонтов за текущий месяц diff --git a/mechanic-pwa/frontend/src/pages/warehouse/PartsIssueJournalPage.tsx b/mechanic-pwa/frontend/src/pages/warehouse/PartsIssueJournalPage.tsx index 1817d1b..db67c93 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/PartsIssueJournalPage.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/PartsIssueJournalPage.tsx @@ -7,10 +7,9 @@ * есть ли карточка ремонта. Переключатель оставляет только выдачи без ремонта. */ import { useState } from "react"; -import { useNavigate } from "react-router-dom"; import { useQuery } from "@tanstack/react-query"; -import { ChevronLeft } from "lucide-react"; import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; import { getPartsIssues, type PartsIssue } from "@/api/warehouse"; const FILTERS: { key: boolean; label: string }[] = [ @@ -32,7 +31,6 @@ function fmtDateTime(iso: string): string { } export default function PartsIssueJournalPage() { - const navigate = useNavigate(); const [withoutRepair, setWithoutRepair] = useState(false); const q = useQuery({ @@ -44,16 +42,7 @@ export default function PartsIssueJournalPage() { return (
-
-
- -
-

Журнал выдач

-

всего записей: {q.data?.total ?? 0}

-
-
+
{FILTERS.map((f) => (
-
+
{q.isLoading &&

Загрузка…

} diff --git a/mechanic-pwa/frontend/src/pages/warehouse/PartsIssuePage.test.tsx b/mechanic-pwa/frontend/src/pages/warehouse/PartsIssuePage.test.tsx new file mode 100644 index 0000000..12b2b92 --- /dev/null +++ b/mechanic-pwa/frontend/src/pages/warehouse/PartsIssuePage.test.tsx @@ -0,0 +1,67 @@ +/** + * Режим «форма машины» (?car=) — отдельная запись истории: «Назад» в шапке и + * системная «Назад» Android возвращают к списку машин одинаково. BrowserRouter + * в jsdom пишет настоящий window.history — проверяем по нему. + */ +import { render, screen, waitFor } from "@testing-library/react"; +import userEvent from "@testing-library/user-event"; +import { QueryClient, QueryClientProvider } from "@tanstack/react-query"; +import { BrowserRouter, Route, Routes } from "react-router-dom"; +import { vi } from "vitest"; + +vi.mock("@/api/repairsCreate", () => ({ + searchCars: vi.fn().mockResolvedValue([{ id: 5, plate: "А001АА125", brand: "Kia", model: "Rio" }]), + getCarContext: vi.fn().mockResolvedValue({ + id: 5, plate: "А001АА125", brand: "Kia", model: "Rio", + mileage_starline: null, driver_id: null, driver_name: null, + }), +})); +vi.mock("@/api/warehouse", () => ({ issueParts: vi.fn(), apiErrorText: vi.fn() })); + +import PartsIssuePage from "@/pages/warehouse/PartsIssuePage"; + +const idx = () => (window.history.state as { idx?: number } | null)?.idx; + +function renderPage() { + const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } }); + return render( + + + + } /> + + + , + ); +} + +test("выбор машины кладётся в историю, «Назад» в форме возвращает к списку машин", async () => { + window.history.replaceState(null, "", "/wh/issues"); + const user = userEvent.setup(); + renderPage(); + + await user.click(await screen.findByText("А001АА125")); + expect(window.location.search).toBe("?car=5"); + expect(idx()).toBe(1); + await screen.findByText("Водитель не определён"); + + await user.click(screen.getByRole("button", { name: "Назад" })); + + await waitFor(() => expect(window.location.search).toBe("")); + expect(idx()).toBe(0); + expect(await screen.findByPlaceholderText("Госномер…")).toBeInTheDocument(); +}); + +test("форма открыта ссылкой (истории нет) → «Назад» заменяет её списком машин", async () => { + window.history.replaceState(null, "", "/wh/issues?car=5"); + const user = userEvent.setup(); + renderPage(); + await screen.findByText("Водитель не определён"); + const length = window.history.length; + + await user.click(screen.getByRole("button", { name: "Назад" })); + + expect(await screen.findByPlaceholderText("Госномер…")).toBeInTheDocument(); + expect(window.location.search).toBe(""); + expect(window.history.length).toBe(length); +}); diff --git a/mechanic-pwa/frontend/src/pages/warehouse/PartsIssuePage.tsx b/mechanic-pwa/frontend/src/pages/warehouse/PartsIssuePage.tsx index 7584ef5..d170299 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/PartsIssuePage.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/PartsIssuePage.tsx @@ -13,11 +13,13 @@ import { useMemo, useState } from "react"; import { useNavigate, useSearchParams } from "react-router-dom"; import { useQuery } from "@tanstack/react-query"; -import { ChevronLeft, History, Plus, Trash2 } from "lucide-react"; +import { History, Plus, Trash2 } from "lucide-react"; import { toast } from "sonner"; import { Button } from "@/components/ui/button"; import { Input } from "@/components/ui/input"; +import { ScreenHeader } from "@/components/ScreenHeader"; import CarPicker from "@/components/warehouse/CarPicker"; +import { useBack } from "@/lib/back"; import PartsPickerModal from "@/components/repairs/PartsPickerModal"; import QtyStepper from "@/components/repairs/QtyStepper"; import { getCarContext, type PartCatalogItem } from "@/api/repairsCreate"; @@ -49,34 +51,29 @@ export default function PartsIssuePage() { const navigate = useNavigate(); const [sp, setSp] = useSearchParams(); const carId = sp.get("car") ? Number(sp.get("car")) : null; + // Выбор машины — отдельная запись истории (push): системная «Назад» на + // Android и «Назад» в шапке одинаково возвращают к списку машин. Туда же — + // после выдачи: заполненная форма в истории не остаётся. + const backToPicker = useBack("/wh/issues"); return (
-
-
-
- -

Выдача запчастей

-
+ navigate("/wh/issues/journal")}> Журнал -
-
+ } + /> {carId ? ( // key — чтобы смена машины давала чистую форму и новый ключ идемпотентности. - setSp({}, { replace: true })} /> + ) : ( - setSp({ car: String(id) }, { replace: true })} /> + setSp({ car: String(id) })} /> )}
); diff --git a/mechanic-pwa/frontend/src/pages/warehouse/ReceiptDetailPage.tsx b/mechanic-pwa/frontend/src/pages/warehouse/ReceiptDetailPage.tsx index 70f0d71..b470156 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/ReceiptDetailPage.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/ReceiptDetailPage.tsx @@ -10,10 +10,9 @@ * Единственное, что берётся из «сегодня» — сколько от каждой партии ещё * лежит на складе: по нему сразу видно, что уже разошлось. */ -import { useNavigate, useParams } from "react-router-dom"; +import { useParams } from "react-router-dom"; import { useQuery } from "@tanstack/react-query"; -import { ChevronLeft } from "lucide-react"; -import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; import { fmtMoney } from "@/lib/repairsFeed"; import { getReceipt } from "@/api/warehouse"; @@ -28,7 +27,6 @@ function fmtDate(iso: string | null): string { export default function ReceiptDetailPage() { const { id } = useParams<{ id: string }>(); - const navigate = useNavigate(); const query = useQuery({ queryKey: ["wh-receipt", Number(id)], queryFn: () => getReceipt(Number(id)), @@ -39,16 +37,7 @@ export default function ReceiptDetailPage() { return (
-
-
- -

Приход

- -
-
+
{query.isLoading &&
} diff --git a/mechanic-pwa/frontend/src/pages/warehouse/ReceivingDraftPage.tsx b/mechanic-pwa/frontend/src/pages/warehouse/ReceivingDraftPage.tsx index 281ad06..aed7381 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/ReceivingDraftPage.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/ReceivingDraftPage.tsx @@ -11,9 +11,11 @@ import { useEffect, useState } from "react"; import { useNavigate, useParams } from "react-router-dom"; import { useQuery, useQueryClient } from "@tanstack/react-query"; -import { ChevronLeft, Loader2, Plus, Trash2, X } from "lucide-react"; +import { Loader2, Plus, Trash2, X } from "lucide-react"; import { toast } from "sonner"; import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; +import { useBack } from "@/lib/back"; import { Input } from "@/components/ui/input"; import { Label } from "@/components/ui/label"; import { fmtMoney } from "@/lib/repairsFeed"; @@ -39,6 +41,7 @@ export default function ReceivingDraftPage() { const { id } = useParams<{ id: string }>(); const draftId = Number(id); const navigate = useNavigate(); + const backToReceiving = useBack("/wh/receiving"); const queryClient = useQueryClient(); const [draft, setDraft] = useState(null); @@ -55,7 +58,10 @@ export default function ReceivingDraftPage() { }); useEffect(() => { - if (!draftId) return; + if (!draftId) { + setLoading(false); // битый адрес — сразу «не загрузился», без вечного скелета + return; + } setLoading(true); getDraft(draftId) .then(setDraft) @@ -111,7 +117,9 @@ export default function ReceivingDraftPage() { try { await rejectDraft(draft.id); toast.success("Черновик отклонён"); - navigate("/wh/receiving", { replace: true }); + // Шаг назад к приёмке (она стоит прямо позади) — не replace на неё: + // «Приёмка» встала бы в историю второй раз. Без истории — replace. + backToReceiving(); } catch (e) { toast.error((e as Error).message || "Не удалось отклонить"); setBusy(false); @@ -120,19 +128,15 @@ export default function ReceivingDraftPage() { return (
-
-
- -

Проверка накладной

- -
-
+
{loading &&
} + {!loading && !draft && ( +
+ Черновик не загрузился — вернитесь к списку накладных. +
+ )} {draft && ( <> @@ -363,10 +367,22 @@ export default function ReceivingDraftPage() { )} + {/* Отступы safe-area: крестик не должен уйти под статус-бар iOS. */} {lightbox && ( -
setLightbox(null)}> +
setLightbox(null)} + >
-
diff --git a/mechanic-pwa/frontend/src/pages/warehouse/ReceivingPage.tsx b/mechanic-pwa/frontend/src/pages/warehouse/ReceivingPage.tsx index f4b7f94..0ef616f 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/ReceivingPage.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/ReceivingPage.tsx @@ -9,9 +9,9 @@ import { useCallback, useRef, useState } from "react"; import { useNavigate } from "react-router-dom"; import { useQuery } from "@tanstack/react-query"; -import { Camera, ChevronLeft, ChevronRight, FileText, Loader2, PackageCheck } from "lucide-react"; +import { Camera, ChevronRight, FileText, Loader2, PackageCheck } from "lucide-react"; import { toast } from "sonner"; -import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; import { downscaleImage } from "@/lib/imageDownscale"; import { fmtMoney } from "@/lib/repairsFeed"; import { getDrafts, getReceipts, scanInvoice } from "@/api/warehouse"; @@ -67,16 +67,7 @@ export default function ReceivingPage() { return (
-
-
- -

Приёмка

- -
-
+
{/* Главное действие */} diff --git a/mechanic-pwa/frontend/src/pages/warehouse/StocktakePage.tsx b/mechanic-pwa/frontend/src/pages/warehouse/StocktakePage.tsx index 5189d02..abd8940 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/StocktakePage.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/StocktakePage.tsx @@ -8,9 +8,10 @@ import { useState } from "react"; import { useNavigate } from "react-router-dom"; import { useQuery } from "@tanstack/react-query"; -import { ChevronLeft, ChevronRight, ClipboardList, Plus } from "lucide-react"; +import { ChevronRight, ClipboardList, Plus } from "lucide-react"; import { toast } from "sonner"; import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; import { Label } from "@/components/ui/label"; import { fmtMoney } from "@/lib/repairsFeed"; import { createStocktake, getPlaces, getStocktakes, type Stocktake } from "@/api/warehouse"; @@ -54,19 +55,15 @@ export default function StocktakePage() { return (
-
-
- -

Инвентаризация

+ setNewOpen(true)}> Начать -
-
+ } + />
{listQuery.isLoading &&
} @@ -140,10 +137,10 @@ export default function StocktakePage() {

- -
diff --git a/mechanic-pwa/frontend/src/pages/warehouse/StocktakeResult.tsx b/mechanic-pwa/frontend/src/pages/warehouse/StocktakeResult.tsx index 2dcc33b..66b9b97 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/StocktakeResult.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/StocktakeResult.tsx @@ -14,8 +14,8 @@ * желанию. Группы без строк не показываются вовсе. */ import { useMemo, useState } from "react"; -import { AlertTriangle, CheckCircle2, ChevronDown, ChevronLeft, ChevronRight } from "lucide-react"; -import { Button } from "@/components/ui/button"; +import { AlertTriangle, CheckCircle2, ChevronDown, ChevronRight } from "lucide-react"; +import { ScreenHeader } from "@/components/ScreenHeader"; import { fmtMoney } from "@/lib/repairsFeed"; import type { StocktakeDetail, StocktakeLine } from "@/api/warehouse"; import { @@ -38,12 +38,8 @@ function fmtDateTime(iso: string | null): string { }).format(d); } -export default function StocktakeResult({ - st, onBack, -}: { - st: StocktakeDetail; - onBack: () => void; -}) { +/** «Назад» — из общей шапки: экран живёт на адресе сессии, родитель — список пересчётов. */ +export default function StocktakeResult({ st }: { st: StocktakeDetail }) { const s = useMemo(() => buildSummary(st.lines), [st.lines]); const groups = s.groups; const notCounted = s.walked.left; @@ -61,16 +57,7 @@ export default function StocktakeResult({ return (
-
-
- -

Итоги пересчёта

- -
-
+
diff --git a/mechanic-pwa/frontend/src/pages/warehouse/StocktakeSessionPage.tsx b/mechanic-pwa/frontend/src/pages/warehouse/StocktakeSessionPage.tsx index 294c7cc..53074c7 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/StocktakeSessionPage.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/StocktakeSessionPage.tsx @@ -29,11 +29,13 @@ * так работает и ссылка из списка, и переход сразу после «Провести». */ import { useCallback, useEffect, useMemo, useRef, useState } from "react"; -import { useNavigate, useParams } from "react-router-dom"; -import { ChevronLeft, Loader2, Plus, RefreshCw, Trash2 } from "lucide-react"; +import { useParams } from "react-router-dom"; +import { Loader2, Plus, RefreshCw, Trash2 } from "lucide-react"; import { toast } from "sonner"; import { useQuery } from "@tanstack/react-query"; import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; +import { useBack } from "@/lib/back"; import { Input } from "@/components/ui/input"; import PartsPickerModal from "@/components/repairs/PartsPickerModal"; import QtyStepper from "@/components/repairs/QtyStepper"; @@ -56,7 +58,9 @@ import StocktakeResult from "./StocktakeResult"; export default function StocktakeSessionPage() { const { id } = useParams<{ id: string }>(); const stId = Number(id); - const navigate = useNavigate(); + // После удаления — шаг назад к списку (он стоит прямо позади), не replace + // на него: список встал бы в историю второй раз. Без истории — replace. + const backToList = useBack("/wh/stocktake"); const [data, setData] = useState(null); const [onlyPending, setOnlyPending] = useState(true); @@ -115,7 +119,7 @@ export default function StocktakeSessionPage() { // нечего, а рабочий список с фильтром «только непосчитанные» показывал бы // ровно то, чего человек НЕ делал. if (st && !isDraft) { - return navigate("/wh/stocktake")} />; + return ; } const applyLine = (updated: StocktakeLine) => @@ -204,7 +208,7 @@ export default function StocktakeSessionPage() { setBusy(true); try { await deleteStocktake(stId); - navigate("/wh/stocktake", { replace: true }); + backToList(); } catch (e) { toast.error(await apiErrorText(e, "Не удалось удалить")); setBusy(false); @@ -215,17 +219,7 @@ export default function StocktakeSessionPage() { return (
-
-
- -

- {st?.place_code ? `Зона ${st.place_code}` : "Весь склад"} -

- -
+ {st && (
@@ -248,7 +242,7 @@ export default function StocktakeSessionPage() {
)} -
+
{query.isLoading &&
} @@ -408,10 +402,10 @@ function FindQtyDialog({
- -
diff --git a/mechanic-pwa/frontend/src/pages/warehouse/TyreJournalPage.tsx b/mechanic-pwa/frontend/src/pages/warehouse/TyreJournalPage.tsx index b074881..f7c61e2 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/TyreJournalPage.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/TyreJournalPage.tsx @@ -7,10 +7,9 @@ * кладовщик сверяется прямо у склада. */ import { useState } from "react"; -import { useNavigate } from "react-router-dom"; import { useQuery } from "@tanstack/react-query"; -import { ChevronLeft } from "lucide-react"; import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; import { getTyreSets, TYRE_GRADE_LABEL, type TyreSet } from "@/api/warehouse"; const STATUS_LABEL: Record = { @@ -34,7 +33,6 @@ function fmtDate(iso: string | null): string { } export default function TyreJournalPage() { - const navigate = useNavigate(); const [status, setStatus] = useState("on_car"); const q = useQuery({ @@ -47,18 +45,10 @@ export default function TyreJournalPage() { return (
-
-
- -
-

Выданные комплекты

-

- на машинах: {q.data?.on_car ?? 0} · всего записей: {q.data?.total ?? 0} -

-
-
+
{FILTERS.map((f) => (
-
+
{q.isLoading &&

Загрузка…

} diff --git a/mechanic-pwa/frontend/src/pages/warehouse/TyreSizesPage.tsx b/mechanic-pwa/frontend/src/pages/warehouse/TyreSizesPage.tsx index 6cbd2a2..bd3fbae 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/TyreSizesPage.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/TyreSizesPage.tsx @@ -10,11 +10,11 @@ * «225/65/17» с телефона долго и легко ошибиться. */ import { useMemo, useState } from "react"; -import { useNavigate } from "react-router-dom"; import { useQuery, useQueryClient } from "@tanstack/react-query"; -import { Check, ChevronLeft } from "lucide-react"; +import { Check } from "lucide-react"; import { toast } from "sonner"; import { Button } from "@/components/ui/button"; +import { ScreenHeader } from "@/components/ScreenHeader"; import { apiErrorText, getTyreSizes, @@ -24,7 +24,6 @@ import { } from "@/api/warehouse"; export default function TyreSizesPage() { - const navigate = useNavigate(); const qc = useQueryClient(); const [savingKey, setSavingKey] = useState(null); @@ -53,19 +52,7 @@ export default function TyreSizesPage() { return (
-
-
- -
-

Штатные размеры

-

- заполнено {filled} из {rows.length} -

-
-
-
+ {known.map((s) => ( diff --git a/mechanic-pwa/frontend/src/pages/warehouse/TyresPage.tsx b/mechanic-pwa/frontend/src/pages/warehouse/TyresPage.tsx index 65a7651..9d0e22c 100644 --- a/mechanic-pwa/frontend/src/pages/warehouse/TyresPage.tsx +++ b/mechanic-pwa/frontend/src/pages/warehouse/TyresPage.tsx @@ -13,11 +13,13 @@ import { useEffect, useMemo, useState } from "react"; import { useNavigate, useSearchParams } from "react-router-dom"; import { useQuery } from "@tanstack/react-query"; -import { ChevronLeft, Circle, History, Ruler } from "lucide-react"; +import { Circle, History, Ruler } from "lucide-react"; import { toast } from "sonner"; import { Button } from "@/components/ui/button"; import { Input } from "@/components/ui/input"; +import { ScreenHeader } from "@/components/ScreenHeader"; import CarPicker from "@/components/warehouse/CarPicker"; +import { useBack } from "@/lib/back"; import { apiErrorText, getTyreContext, @@ -64,38 +66,38 @@ export default function TyresPage() { const navigate = useNavigate(); const [sp, setSp] = useSearchParams(); const carId = sp.get("car") ? Number(sp.get("car")) : null; + // Выбор машины — отдельная запись истории (push): системная «Назад» на + // Android и «Назад» в шапке одинаково возвращают к списку машин. Туда же — + // после выдачи: заполненная форма в истории не остаётся. + const backToPicker = useBack("/wh/tyres"); return (
-
-
-
- -

Выдача резины

-
-
+ - -
-
-
+ + } + /> {carId ? ( - setSp({}, { replace: true })} /> + ) : ( - setSp({ car: String(id) }, { replace: true })} /> + setSp({ car: String(id) })} /> )}
); diff --git a/mechanic-pwa/frontend/src/routes.tsx b/mechanic-pwa/frontend/src/routes.tsx new file mode 100644 index 0000000..d4c54b0 --- /dev/null +++ b/mechanic-pwa/frontend/src/routes.tsx @@ -0,0 +1,96 @@ +/** + * Таблица маршрутов — единственный источник правды о том, какие экраны есть, + * кого на них пускать и кто у каждого родитель (куда ведёт «Назад», когда + * истории позади нет). App рисует из неё, тест кнопки «Назад» + * (src/test/backGuard.test.tsx) обходит её же — новый экран без кнопки + * «Назад» тест не пропустит. + * + * parent обязателен: null — только у главной и входа. Страница может + * уточнить родителя сама, когда узнает больше (осмотр → карточка его машины). + */ +import type { ReactNode } from "react"; +import type { Params } from "react-router-dom"; +import Login from "@/pages/Login"; +import ActionMenu from "@/pages/ActionMenu"; +import Home from "@/pages/Home"; +import VehicleCard from "@/pages/VehicleCard"; +import InspectionEditor from "@/pages/InspectionEditor"; +import InspectionReview from "@/pages/InspectionReview"; +import TtStateDetail from "@/pages/TtStateDetail"; +import RepairsFeedPage from "@/pages/repairs/RepairsFeedPage"; +import RepairDetailPage from "@/pages/repairs/RepairDetailPage"; +import EditRepairPage from "@/pages/repairs/EditRepairPage"; +import CarSelectPage from "@/pages/repairs/CarSelectPage"; +import CreateRepairPage from "@/pages/repairs/CreateRepairPage"; +import ReceivingPage from "@/pages/warehouse/ReceivingPage"; +import ReceivingDraftPage from "@/pages/warehouse/ReceivingDraftPage"; +import ReceiptDetailPage from "@/pages/warehouse/ReceiptDetailPage"; +import StocktakePage from "@/pages/warehouse/StocktakePage"; +import TyresPage from "@/pages/warehouse/TyresPage"; +import TyreSizesPage from "@/pages/warehouse/TyreSizesPage"; +import TyreJournalPage from "@/pages/warehouse/TyreJournalPage"; +import PartsIssuePage from "@/pages/warehouse/PartsIssuePage"; +import PartsIssueJournalPage from "@/pages/warehouse/PartsIssueJournalPage"; +import StocktakeSessionPage from "@/pages/warehouse/StocktakeSessionPage"; + +export interface ParentCtx { + params: Params; + search: URLSearchParams; +} + +export type RouteParent = string | ((ctx: ParentCtx) => string) | null; + +/** + * Кого пускать: public — всех; auth — вошедших; admin — только админов; + * tyres — админов и тех, у кого складское право на резину (warehouse:tyres). + */ +export type RouteGuard = "public" | "auth" | "admin" | "tyres"; + +export interface AppRoute { + path: string; + element: ReactNode; + guard: RouteGuard; + parent: RouteParent; +} + +/** Список машин помнит, зачем его открыли (?action=inspect), — возвращаем туда же. */ +function vehiclesList({ search }: ParentCtx): string { + const action = search.get("action"); + return action ? `/vehicles?action=${encodeURIComponent(action)}` : "/vehicles"; +} + +export const APP_ROUTES: AppRoute[] = [ + { path: "/login", element: , guard: "public", parent: null }, + { path: "/", element: , guard: "auth", parent: null }, + { path: "/vehicles", element: , guard: "auth", parent: "/" }, + { path: "/vehicles/:id", element: , guard: "auth", parent: vehiclesList }, + // Осмотры: машину страница узнаёт после загрузки и сама ведёт на её карточку. + { path: "/inspections/:id/edit", element: , guard: "auth", parent: "/vehicles" }, + { path: "/inspections/:id", element: , guard: "auth", parent: "/vehicles" }, + { path: "/tt-states/:id", element: , guard: "auth", parent: "/vehicles" }, + // Раздел «Ремонт» — активируется в PR-5 (Фича 1). + { path: "/repairs", element: , guard: "auth", parent: "/" }, + { path: "/repairs/new", element: , guard: "auth", parent: "/repairs" }, + { path: "/repairs/new/:carId", element: , guard: "auth", parent: "/repairs/new" }, + { path: "/repairs/new-external", element: , guard: "auth", parent: "/repairs/new" }, + { path: "/repairs/:id", element: , guard: "auth", parent: "/repairs" }, + { + path: "/repairs/:id/edit", + element: , + guard: "auth", + parent: ({ params }) => `/repairs/${params.id}`, + }, + // Склад — приёмка и инвентаризация с телефона (пока только админы). + { path: "/wh/receiving", element: , guard: "admin", parent: "/" }, + { path: "/wh/receiving/:id", element: , guard: "admin", parent: "/wh/receiving" }, + { path: "/wh/receipts/:id", element: , guard: "admin", parent: "/wh/receiving" }, + { path: "/wh/stocktake", element: , guard: "admin", parent: "/" }, + { path: "/wh/stocktake/:id", element: , guard: "admin", parent: "/wh/stocktake" }, + // Сезонная выдача резины — по складскому праву (не только админам). + { path: "/wh/tyres", element: , guard: "tyres", parent: "/" }, + { path: "/wh/tyres/sizes", element: , guard: "tyres", parent: "/wh/tyres" }, + { path: "/wh/tyres/journal", element: , guard: "tyres", parent: "/wh/tyres" }, + // Выдача запчастей (5763) — всем, кто вошёл в PWA: гейт на сервере require_mechanic. + { path: "/wh/issues", element: , guard: "auth", parent: "/" }, + { path: "/wh/issues/journal", element: , guard: "auth", parent: "/wh/issues" }, +]; diff --git a/mechanic-pwa/frontend/src/test/backGuard.test.tsx b/mechanic-pwa/frontend/src/test/backGuard.test.tsx new file mode 100644 index 0000000..05c6df9 --- /dev/null +++ b/mechanic-pwa/frontend/src/test/backGuard.test.tsx @@ -0,0 +1,122 @@ +/** + * Правило «Назад на каждом экране» (задача 6385), закреплённое тестом. + * + * Обходит ТУ ЖЕ таблицу маршрутов, из которой App рисует , и открывает + * каждый экран по примерному адресу, пока вся сеть висит: именно в загрузке + * кнопку и забывали (экран «Загружаю…» без шапки — ловушка на iPhone). + * Экран с родителем обязан показать «Назад» в шапке, главная и вход — нет. + * Новый раздел без кнопки этот тест не пропустит. + */ +import { render, screen } from "@testing-library/react"; +import { QueryClient, QueryClientProvider } from "@tanstack/react-query"; +import { MemoryRouter, useLocation } from "react-router-dom"; +import { vi } from "vitest"; + +// ky-клиент приложения: любой запрос висит вечно, .json()/.text() — тоже. +vi.mock("@/api/client", () => { + const hang = () => new Promise(() => {}); + const request = () => + Object.assign(hang(), { json: hang, text: hang, blob: hang, arrayBuffer: hang }); + return { api: new Proxy({}, { get: () => request }) }; +}); +// Схема машины тянет файл из public/ через «?url» — в vitest такой импорт не +// резолвится. В загрузке схема всё равно не рисуется. +vi.mock("@/components/vehicle-scheme/VendorVehicleScheme", () => ({ + VendorVehicleScheme: () => null, +})); + +import App from "@/App"; +import { APP_ROUTES, type AppRoute } from "@/routes"; +import { useAuth } from "@/store/auth"; +import type { Me } from "@/api/me"; + +// Админ с правом на резину — чтобы гейты пустили на все складские экраны. +const ADMIN: Me = { + id: 1, + name: "Тест", + permissions: ["admin", "warehouse:tyres"], + is_admin: true, + can_login_pwa: true, + departments: [], + support: { tg_username: null, phone: null }, +}; + +/** Примерный адрес: параметры маршрута → 1 (/repairs/:id/edit → /repairs/1/edit). */ +const sampleUrl = (path: string) => path.replace(/:[^/]+/g, "1"); + +/** Экраны, которые без state перехода сразу уводят на другой, — даём им state. */ +const SAMPLE_STATE: Record = { + "/repairs/new-external": { plate: "А001АА125", make: null, fromPicker: true }, +}; + +/** Где роутер в итоге: «Назад» должен быть у проверяемого экрана, а не у того, куда он увёл. */ +function Where() { + return ; +} + +function renderRoute(route: AppRoute, me: Me | null) { + useAuth.setState({ token: route.guard === "public" ? null : "test-token" }); + const qc = new QueryClient({ defaultOptions: { queries: { retry: false, gcTime: Infinity } } }); + if (me) qc.setQueryData(["me"], me); + return render( + + + + + + , + ); +} + +async function expectBackInHeader(route: AppRoute) { + const backs = await screen.findAllByRole("button", { name: "Назад" }); + expect(backs.length).toBeGreaterThan(0); + expect(backs[0].closest("header")).not.toBeNull(); + expectOwnScreen(route); +} + +/** + * Кнопка — от самого экрана: он не увёл на другой адрес и не упал. Упавший + * экран показывает шапку ErrorBoundary с «Назад» — без этой проверки раздел + * без своей шапки, падающий в jsdom, прошёл бы тест. + */ +function expectOwnScreen(route: AppRoute) { + expect(screen.getByTestId("where").textContent, "экран увёл на другой адрес").toBe(sampleUrl(route.path)); + expect( + screen.queryByRole("button", { name: "Перезагрузить" }), + "экран упал — «Назад» от заглушки ErrorBoundary, а не от самого экрана", + ).toBeNull(); +} + +beforeAll(() => { + // Прямые fetch (фото, схемы, справочники зон) — тоже вечная загрузка. + vi.stubGlobal("fetch", vi.fn(() => new Promise(() => {}))); +}); +afterAll(() => { + vi.unstubAllGlobals(); +}); + +// parent: null — не лазейка: без родителя только главная и вход. +test("без родителя только главная и вход", () => { + expect(APP_ROUTES.filter((r) => r.parent === null).map((r) => r.path).sort()).toEqual(["/", "/login"]); +}); + +test.each(APP_ROUTES.map((r) => [r.path, r] as const))("экран %s", async (_path, route) => { + renderRoute(route, ADMIN); + if (route.parent === null) { + // Главная и вход: дождались экрана — кнопки «Назад» на нём нет. + await screen.findByRole("heading", { level: 1 }); + expect(screen.queryByRole("button", { name: "Назад" })).toBeNull(); + expectOwnScreen(route); + return; + } + await expectBackInHeader(route); +}); + +// Пока /me не пришёл, гейты складских разделов уже рисуют шапку. +test.each( + APP_ROUTES.filter((r) => r.guard === "admin" || r.guard === "tyres").map((r) => [r.path, r] as const), +)("проверка прав на %s — тоже с «Назад»", async (_path, route) => { + renderRoute(route, null); + await expectBackInHeader(route); +});