Files
mechanic-pwa/driver-pwa/frontend/src/App.tsx
T
tremble7681andClaude Opus 5.5 ab2ad8d471 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>
2026-09-25 21:53:48 +10:00

137 lines
7.8 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import type { ReactNode } from "react";
import { useEffect, useState } from "react";
import { Navigate, Route, Routes, useLocation, useNavigate } from "react-router-dom";
import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff";
import { setReturnTo } from "@/lib/returnTo";
import { ImpersonationBar } from "@/components/ImpersonationBar";
import { BackBar, BackProvider } from "@/components/BackBar";
import { ErrorBoundary } from "@/components/ErrorBoundary";
import { ROUTES, findRoute, type AppRoute } from "@/routes";
import { markNotificationsRead } from "@/api/driver";
import { syncSubscription } from "@/lib/push";
function RequireAuth({ children }: { children: ReactNode }) {
const token = useAuth((s) => s.token);
const loc = useLocation();
if (token) return <>{children}</>;
// Запоминаем, куда шёл водитель (напр. ссылку на оплату), чтобы вернуть его
// туда после входа, а не на баланс.
setReturnTo(loc.pathname + loc.search);
return <Navigate to="/login" replace />;
}
/** Отладка существует только для сотрудника: либо он вошёл учёткой CRM, либо
* прямо сейчас смотрит от лица водителя. Обычному водителю адрес /debug ничего
* не даёт — его уводит на главную. */
function RequireStaff({ children }: { children: ReactNode }) {
const impersonated = useAuth((s) => s.impersonated);
const staffToken = useStaff((s) => s.token);
return impersonated || staffToken ? <>{children}</> : <Navigate to="/" replace />;
}
/**
* Экраны входа — только тому, кто ещё не вошёл. Вход после ссылки или пуша
* заменяет лишь последнюю запись истории, и экран входа остаётся позади: шаг
* назад (кнопкой или жестом) показал бы вошедшему выбор способа входа — без
* «Назад» и без пути дальше, кроме нового, платного входа. Отсюда — на главную.
*
* Смотрим на вход, с которым ПРИШЛИ на эту запись: токен, появившийся уже здесь,
* значит, что экран сам довёл вход и сейчас уведёт водителя туда, куда тот шёл
* (returnTo). Перебить его уходом на главную — потерять ссылку на оплату.
*/
function GuestOnly({ children }: { children: ReactNode }) {
const signedIn = useAuth((s) => !!s.token);
const { key } = useLocation();
const [arrived, setArrived] = useState({ key, signedIn });
if (arrived.key !== key) setArrived({ key, signedIn });
const wasSignedIn = arrived.key === key ? arrived.signedIn : signedIn;
return wasSignedIn ? <Navigate to="/" replace /> : <>{children}</>;
}
/**
* Нажатие по пушу — единственный честный признак, что уведомление увидели.
* Сам воркер отметить его не может: токен водителя лежит в хранилище страницы,
* ему недоступном. Поэтому воркер добавляет к адресу `?n=<номер>`, а отмечает
* страница — и тут же убирает параметр, чтобы он не остался в истории.
*/
function MarkPushRead() {
const loc = useLocation();
const nav = useNavigate();
useEffect(() => {
const params = new URLSearchParams(loc.search);
const raw = params.get("n");
if (!raw) return;
const id = Number(raw);
if (Number.isFinite(id) && id > 0) void markNotificationsRead([id], "push");
params.delete("n");
const rest = params.toString();
nav(loc.pathname + (rest ? `?${rest}` : ""), { replace: true });
}, [loc.search, loc.pathname, nav]);
return null;
}
/**
* Подписка на пуши живёт в браузере и переживает выход и смену водителя, а на
* сервере она привязана к тому, кто подписался. Разъехаться они могут молча:
* приложение видит подписку и считает уведомления включёнными, а сервер шлёт их
* прежнему водителю — или никому. Кнопки «выключить» у нас нет, так что выйти из
* этого состояния человеку нечем.
*
* Поэтому при каждом входе отдаём подписку серверу заново: эндпоинт переписывает
* её по endpoint на текущего водителя. Молча — водителю тут показывать нечего,
* а разрешения этот вызов не спрашивает.
*/
function SyncPushSubscription() {
const driverId = useAuth((s) => s.driverId);
useEffect(() => {
if (!driverId) return;
void syncSubscription().catch(() => undefined);
}, [driverId]);
return null;
}
function guarded(r: AppRoute): ReactNode {
if (r.guard === "staff") return <RequireAuth><RequireStaff>{r.element}</RequireStaff></RequireAuth>;
if (r.guard === "auth") return <RequireAuth>{r.element}</RequireAuth>;
if (r.guard === "guest") return <GuestOnly>{r.element}</GuestOnly>;
return r.element;
}
export default function App() {
const loc = useLocation();
// Упавшей главной или экрану входа «Назад» сверху не положен — вместо него
// страховка сама предложит «На главную».
const root = findRoute(loc.pathname)?.route.parent === null;
return (
<BackProvider>
{/* Отступ сверху не меньше системной полосы iPhone: если приложение когда-нибудь
начнёт рисовать под ней, «Назад» всё равно останется под пальцем. */}
<div className="mx-auto max-w-md min-h-full px-4 pt-[max(0.75rem,env(safe-area-inset-top))] pb-8">
{/* Плашка живёт над маршрутами: чей экран открыт, видно на каждом из них,
а не только там, где про неё вспомнили. Сама решает, показываться ли. */}
<ImpersonationBar />
{/* «Назад» — тоже над маршрутами и вне страховки от падений: есть на любом
экране кроме главной и входа, в любом его состоянии (см. routes.tsx). */}
<BackBar />
<SyncPushSubscription />
<MarkPushRead />
{/* Ключ — адрес целиком: выбор на экране живёт в строке запроса
(?kind=, ?by=code), и уход с неё — уже другой экран. */}
<ErrorBoundary resetKey={loc.pathname + loc.search} home={root}>
<Routes>
{/* Экраны — только из таблицы ROUTES: по ней же BackBar ищет родителя,
а тест-сторож проверяет «Назад». Сюда <Route> руками не добавлять. */}
{ROUTES.map((r) => (
<Route key={r.path} path={r.path} element={guarded(r)} />
))}
<Route path="*" element={<Navigate to="/" replace />} />
</Routes>
</ErrorBoundary>
</div>
</BackProvider>
);
}