Files
mechanic-pwa/driver-pwa/frontend/src/routes.tsx
T

82 lines
5.2 KiB
TypeScript

import type { ReactNode } from "react";
import { matchRoutes, type Params } from "react-router-dom";
import type { BackMode } from "@/lib/back";
import { LoginPage } from "@/pages/LoginPage";
import { MtsLoginPage } from "@/pages/MtsLoginPage";
import { TgWaitPage } from "@/pages/TgWaitPage";
import { OnboardingPage } from "@/pages/OnboardingPage";
import { BalancePage } from "@/pages/BalancePage";
import { TopupPage } from "@/pages/TopupPage";
import { PaymentPage } from "@/pages/PaymentPage";
import { DevLoginPage } from "@/pages/DevLoginPage";
import { DebugPage } from "@/pages/DebugPage";
import { MockPayPage } from "@/pages/MockPayPage";
import { FineDetailPage } from "@/pages/FineDetailPage";
import { NotificationsPage } from "@/pages/NotificationsPage";
import { BonusesPage } from "@/pages/BonusesPage";
/** Что известно при выборе родителя: параметры пути, строка запроса, вход. */
export interface ParentCtx {
params: Params;
search: URLSearchParams;
/** Есть токен водителя — свой вход или просмотр сотрудником. */
signedIn: boolean;
}
/** Куда ведёт «Назад», когда в истории этого запуска позади ничего нет.
* null — только у главной и у экранов входа: там кнопки «Назад» нет. */
export type Parent = string | ((ctx: ParentCtx) => string) | null;
export interface AppRoute {
path: string;
element: ReactNode;
/** Обязателен: экран без родителя не соберётся. См. CLAUDE.md приложения. */
parent: Parent;
/** "auth" — только вошедшему водителю, "staff" — ещё и только сотруднику,
* "guest" — экран входа: вошедшего уводит на главную (см. GuestOnly в App). */
guard?: "auth" | "staff" | "guest";
/** По умолчанию «Назад» идёт шагом по истории — см. BackMode. */
back?: BackMode;
}
/**
* Все экраны приложения — единственный источник и для <Routes> в App, и для
* кнопки «Назад» (BackBar), и для теста-сторожа, который проверяет её на каждом.
*/
export const ROUTES: AppRoute[] = [
{ path: "/", element: <BalancePage />, guard: "auth", parent: null },
{ path: "/login", element: <LoginPage />, guard: "guest", parent: null },
{ path: "/login/mts", element: <MtsLoginPage />, guard: "guest", parent: "/login" },
{ path: "/tg-wait", element: <TgWaitPage />, guard: "guest", parent: "/login" },
{ path: "/onboarding", element: <OnboardingPage />, guard: "guest", parent: "/login" },
// Сотрудник, уже вошедший водителем, попадает сюда долгим тапом с главной —
// туда и возвращаем; без входа возвращаться некуда, кроме экрана входа.
{ path: "/dev", element: <DevLoginPage />, parent: ({ signedIn }) => (signedIn ? "/" : "/login") },
{ path: "/notifications", element: <NotificationsPage />, guard: "auth", parent: "/" },
// Бонусы открывают карточкой с главной и пушем «Бонус начислен» — оба
// случая возвращаются на главную.
{ path: "/bonuses", element: <BonusesPage />, guard: "auth", parent: "/" },
{ path: "/topup", element: <TopupPage />, guard: "auth", parent: "/" },
{ path: "/pay/:orderId", element: <PaymentPage />, guard: "auth", parent: "/" },
{ path: "/mock-pay/:orderId", element: <MockPayPage />, guard: "auth", parent: "/" },
// Карточку открывают из списка штрафов — к нему и возвращаем, даже если её
// открыли пушем «Новый штраф» с холодного старта.
{ path: "/fines/:fineId", element: <FineDetailPage />, guard: "auth", parent: "/?kind=fines" },
// Экран «Бонусы» спрятан до поэтапного внедрения (октябрь 2026). Старые
// push-ссылки /bonuses ловит catch-all в App и ведут на главную.
{ path: "/debug", element: <DebugPage />, guard: "staff", parent: "/" },
];
/** Маршрут из таблицы, под который попадает адрес, — с параметрами пути. */
export function findRoute(pathname: string): { route: AppRoute; params: Params } | null {
// Тем же ранжированием, что у <Routes> (статичный сегмент сильнее параметра),
// а не первым совпадением по порядку таблицы: иначе «Назад» взял бы родителя
// не того экрана, что нарисован.
const hit = matchRoutes(ROUTES, pathname)?.[0];
return hit ? { route: hit.route, params: hit.params } : null;
}
export function resolveParent(parent: Exclude<Parent, null>, ctx: ParentCtx): string {
return typeof parent === "function" ? parent(ctx) : parent;
}