feat(pwa): вход для сотрудника, просмотр от лица водителя и вкладка «Отладка»

Приложение обкатывается на боевом контуре, поэтому интерфейс надо проверять на
живых данных — а живые данные лежат у настоящих водителей.

* «Вход для сотрудника» (/dev) — логин учётки CRM, поддержан второй шаг 2FA;
  дальше поиск водителя по ФИО/телефону/id и просмотр его экранов.
* Плашка «Смотрю как …» над всеми экранами: интерфейс в этом режиме неотличим
  от водительского, и чужой баланс легко принять за свой.
* Вкладка «Отладка» (/debug, водителю недоступна): смена водителя, driver_id,
  режим, срок токена, адрес API, коммит и время сборки, журнал последних
  40 ответивших запросов, сброс кэша сервис-воркера.
* Пополнение под просмотром идёт в учебный контур: экран /mock-pay/:orderId
  выбирает, что «ответит» банк, а настоящий экран оплаты разбирает эти статусы
  своим боевым кодом. Ни рубля, ни чека 54-ФЗ.

Заодно доезжает незакоммиченная работа прошлой сессии: дев-прокси в
vite.config.ts, его тест и разобранный .env.example.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
tremble7681andClaude Opus 5 committed 2026-08-18 13:15:02 +10:00
1 parent aff1a45006
commit ceec3db364
27 files changed
+1308 -17

No files matched your search

@@ -0,0 +1,67 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import { MemoryRouter } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
vi.mock("@/api/staff", () => ({
searchDrivers: vi.fn(async () => ({ drivers: [] })),
impersonate: vi.fn(),
}));
// Экран баланса, на который уводит редирект, тянет свои запросы — отдаём пустышки.
vi.mock("@/api/driver", () => ({
apiErrorText: vi.fn(async (_e: unknown, f: string) => f),
getBalance: vi.fn(async () => ({ accounts: [], pending_topup: 0 })),
}));
import App from "@/App";
import { DebugPage } from "./DebugPage";
import { clearLog, pushEntry } from "@/lib/reqlog";
import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff";
function renderAt(path: string) {
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
return render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={[path]}><App /></MemoryRouter>
</QueryClientProvider>
);
}
describe("вкладка отладки", () => {
beforeEach(() => { useAuth.getState().clear(); useStaff.getState().clear(); clearLog(); });
it("водителя на /debug не пускает — уводит в приложение", () => {
useAuth.getState().setSession("t", 42);
renderAt("/debug");
expect(screen.queryByRole("heading", { name: "Отладка" })).not.toBeInTheDocument();
});
it("сотруднику показывает, от чьего лица открыт экран", () => {
useAuth.getState().setSession("t", 42, { impersonated: true, driverName: "Петров Пётр" });
renderAt("/debug");
expect(screen.getByRole("heading", { name: "Отладка" })).toBeInTheDocument();
// Плашка живёт над маршрутами и видна на любом экране, включая этот.
expect(screen.getByText(/Смотрю как/)).toBeInTheDocument();
expect(screen.getAllByText(/Петров Пётр/).length).toBeGreaterThan(0);
});
it("плашки нет у обычного водителя", () => {
useAuth.getState().setSession("t", 42);
renderAt("/");
expect(screen.queryByText(/Смотрю как/)).not.toBeInTheDocument();
});
it("журнал запросов виден со статусами и временем", () => {
useAuth.getState().setSession("t", 42, { impersonated: true, driverName: "Петров" });
pushEntry({ method: "GET", path: "/api/driver/balance", status: 401, ms: 123 });
render(
<QueryClientProvider client={new QueryClient()}>
<MemoryRouter><DebugPage /></MemoryRouter>
</QueryClientProvider>
);
expect(screen.getByText("/api/driver/balance")).toBeInTheDocument();
expect(screen.getByText("401")).toBeInTheDocument();
expect(screen.getByText("123 мс")).toBeInTheDocument();
});
});
+127
View File
@@ -0,0 +1,127 @@
import { useState, useSyncExternalStore } from "react";
import { useNavigate } from "react-router-dom";
import { LogOut, RefreshCw, Trash2, UserCog } from "lucide-react";
import { toast } from "sonner";
import { API_BASE } from "@/api/client";
import { clearLog, getLog, subscribe } from "@/lib/reqlog";
import { expiresIn, readToken } from "@/lib/jwt";
import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff";
import { DriverPicker } from "@/components/DriverPicker";
function Row({ k, v }: { k: string; v: string }) {
return (
<div className="flex justify-between gap-3 py-2 border-b border-line last:border-0">
<span className="text-muted text-xs shrink-0">{k}</span>
<span className="text-xs text-right break-all">{v}</span>
</div>
);
}
/**
* Вкладка «Отладка» — то, чего в приложении водителя нет и быть не должно:
* от чьего лица открыт экран, куда ходят запросы, чем они отвечают.
*
* Показывается только сотруднику (есть учётка CRM или действует просмотр). У
* водителя маршрут ведёт на главную — см. App.
*/
export function DebugPage() {
const nav = useNavigate();
const { token, driverId, driverName, impersonated, clear } = useAuth();
const staff = useStaff();
const log = useSyncExternalStore(subscribe, getLog);
const [switching, setSwitching] = useState(false);
const info = readToken(token);
async function hardReload() {
// Кэш сервис-воркера переживает деплой и показывает вчерашний бандл — на
// отладке это стоит часа «почему правка не приехала».
try {
const regs = await navigator.serviceWorker?.getRegistrations?.();
await Promise.all((regs ?? []).map((r) => r.unregister()));
const keys = await caches?.keys?.();
await Promise.all((keys ?? []).map((k) => caches.delete(k)));
toast.success("Кэш сброшен, перезагружаю");
} catch {
toast.error("Не удалось сбросить кэш");
}
location.reload();
}
return (
<div className="pt-3">
<h1 className="text-lg font-extrabold mb-4">Отладка</h1>
<div className="card p-4 mb-4">
<p className="text-muted text-xs mb-1">Сейчас смотрю</p>
<p className="text-sm font-bold mb-3">
{impersonated ? (driverName ?? `Водитель #${driverId}`) : "Свой аккаунт водителя"}
</p>
<button className="btn-ghost flex items-center justify-center gap-2"
onClick={() => setSwitching((s) => !s)}>
<UserCog size={16} /> {switching ? "Свернуть" : "Сменить водителя"}
</button>
{switching && (
<div className="mt-4">
<DriverPicker onPicked={(d) => { setSwitching(false); toast.success(`Смотрю как ${d.fio}`); }} />
</div>
)}
</div>
<div className="card p-4 mb-4">
<p className="text-muted text-xs mb-2">Сведения</p>
<Row k="driver_id" v={String(driverId ?? "—")} />
<Row k="режим" v={impersonated ? "просмотр сотрудником (imp)" : "обычный вход водителя"} />
<Row k="сотрудник" v={staff.username ?? "не входил"} />
<Row k="токен истекает" v={expiresIn(info?.exp ?? null)} />
<Row k="API" v={API_BASE} />
<Row k="сборка" v={`${__BUILD_COMMIT__} · ${__BUILD_TIME__}`} />
<Row k="сеть" v={navigator.onLine ? "онлайн" : "офлайн"} />
</div>
<div className="card p-4 mb-4">
<div className="flex items-center justify-between mb-2">
<p className="text-muted text-xs">Последние запросы</p>
<button className="text-muted text-xs flex items-center gap-1" onClick={clearLog}>
<Trash2 size={12} /> очистить
</button>
</div>
{log.length === 0 ? (
<p className="text-muted text-xs py-2">Пока пусто</p>
) : (
<div className="font-mono text-[11px] leading-5">
{log.map((e) => (
<div key={e.id} className="flex gap-2 border-b border-line last:border-0 py-1">
<span className={e.status && e.status >= 400 ? "text-neg" : "text-pos"}>
{e.status ?? "—"}
</span>
<span className="text-muted">{e.method}</span>
<span className="truncate">{e.path}</span>
<span className="ml-auto text-muted shrink-0">{e.ms} мс</span>
</div>
))}
</div>
)}
<p className="text-muted text-[11px] mt-2">
Запрос, оборвавшийся без ответа, сюда не попадает.
</p>
</div>
<button className="btn-ghost flex items-center justify-center gap-2 mb-2" onClick={hardReload}>
<RefreshCw size={16} /> Сбросить кэш и перезагрузить
</button>
<button
className="btn-ghost flex items-center justify-center gap-2"
onClick={() => { clear(); nav(staff.token ? "/dev" : "/login"); }}
>
<LogOut size={16} /> {impersonated ? "Выйти из просмотра" : "Выйти"}
</button>
{staff.token && (
<button className="text-muted text-xs w-full mt-4"
onClick={() => { clear(); staff.clear(); nav("/login"); }}>
Выйти и из учётки сотрудника
</button>
)}
</div>
);
}
@@ -0,0 +1,67 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter } from "react-router-dom";
vi.mock("@/api/staff", () => ({
staffLogin: vi.fn(async () => ({ access_token: "staff-tok", requires_2fa: false, partial_token: null })),
staffLogin2fa: vi.fn(async () => ({ access_token: "staff-tok", requires_2fa: false, partial_token: null })),
searchDrivers: vi.fn(async () => ({
drivers: [{ id: 42, fio: "Петров Пётр", phone: "+79141234567", status: "Работает", driver_kind: "park" }],
})),
impersonate: vi.fn(async () => ({
token: "driver-tok",
driver: { id: 42, fio: "Петров Пётр", phone: "+79141234567", status: "Работает", driver_kind: "park" },
})),
}));
vi.mock("@/api/driver", () => ({ apiErrorText: vi.fn(async (_e: unknown, f: string) => f) }));
import { DevLoginPage } from "./DevLoginPage";
import * as staffApi from "@/api/staff";
import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff";
const wrap = () => render(<MemoryRouter><DevLoginPage /></MemoryRouter>);
describe("DevLoginPage", () => {
beforeEach(() => {
useAuth.getState().clear();
useStaff.getState().clear();
vi.clearAllMocks();
});
it("логин учёткой CRM, выбор водителя — и сеанс помечен как просмотр", async () => {
wrap();
await userEvent.type(screen.getByPlaceholderText("Логин"), "vlad");
await userEvent.type(screen.getByPlaceholderText("Пароль"), "secret");
await userEvent.click(screen.getByRole("button", { name: "Войти" }));
expect(staffApi.staffLogin).toHaveBeenCalledWith("vlad", "secret");
expect(useStaff.getState().token).toBe("staff-tok");
await userEvent.click(await screen.findByRole("button", { name: /Петров Пётр/ }));
expect(staffApi.impersonate).toHaveBeenCalledWith(42);
const auth = useAuth.getState();
// Метка просмотра — то, на чём держатся и плашка, и запрет боевой оплаты.
expect(auth.token).toBe("driver-tok");
expect(auth.driverId).toBe(42);
expect(auth.impersonated).toBe(true);
expect(auth.driverName).toBe("Петров Пётр");
});
it("двухфакторка: пароль сам по себе сеанса не открывает", async () => {
vi.mocked(staffApi.staffLogin).mockResolvedValueOnce({
access_token: null, requires_2fa: true, partial_token: "partial",
});
wrap();
await userEvent.type(screen.getByPlaceholderText("Логин"), "vlad");
await userEvent.type(screen.getByPlaceholderText("Пароль"), "secret");
await userEvent.click(screen.getByRole("button", { name: "Войти" }));
expect(useStaff.getState().token).toBeNull();
await userEvent.type(await screen.findByPlaceholderText("000000"), "123456");
await userEvent.click(screen.getByRole("button", { name: "Подтвердить" }));
expect(staffApi.staffLogin2fa).toHaveBeenCalledWith("partial", "123456");
expect(useStaff.getState().token).toBe("staff-tok");
});
});
@@ -0,0 +1,122 @@
import { useState } from "react";
import { useNavigate } from "react-router-dom";
import { toast } from "sonner";
import { apiErrorText } from "@/api/driver";
import { staffLogin, staffLogin2fa } from "@/api/staff";
import { useStaff } from "@/store/staff";
import { DriverPicker } from "@/components/DriverPicker";
import { Spinner } from "@/components/Spinner";
/**
* Вход сотрудника — тот же логин и пароль, что в CRM.
*
* Экран нужен, пока приложение обкатывается: интерфейс проверяется на живых
* данных, а живые данные лежат у настоящих водителей. Отдельного входа «за
* водителя» здесь нет: сотрудник входит СОБОЙ, а дальше выбирает, чей экран
* смотреть, — и это записывается в аудит CRM.
*/
export function DevLoginPage() {
const nav = useNavigate();
const { token: staffToken, username: staffName, setStaff, clear } = useStaff();
const [username, setUsername] = useState("");
const [password, setPassword] = useState("");
const [partial, setPartial] = useState<string | null>(null);
const [code, setCode] = useState("");
const [busy, setBusy] = useState(false);
async function submit() {
if (!username || !password || busy) return;
setBusy(true);
try {
const r = await staffLogin(username, password);
if (r.requires_2fa && r.partial_token) {
setPartial(r.partial_token);
return;
}
if (!r.access_token) throw new Error("no token");
setStaff(r.access_token, username);
} catch (e: unknown) {
toast.error(await apiErrorText(e, "Неверный логин или пароль"));
} finally {
setBusy(false);
}
}
async function submit2fa() {
if (!partial || code.length < 6 || busy) return;
setBusy(true);
try {
const r = await staffLogin2fa(partial, code);
if (!r.access_token) throw new Error("no token");
setStaff(r.access_token, username);
setPartial(null);
} catch (e: unknown) {
toast.error(await apiErrorText(e, "Код не подошёл"));
} finally {
setBusy(false);
}
}
if (staffToken) {
return (
<div className="pt-10">
<h1 className="text-lg font-extrabold mb-1">Кого смотрим</h1>
<p className="text-muted text-xs mb-5">
Сотрудник: {staffName}. Приложение откроется от лица выбранного водителя,
деньги в этом режиме не двигаются.
</p>
<DriverPicker onPicked={() => nav("/")} />
<button className="btn-ghost mt-5" onClick={clear}>Выйти из учётки сотрудника</button>
</div>
);
}
return (
<div className="pt-16">
<h1 className="text-xl font-extrabold mb-1">Вход для сотрудника</h1>
<p className="text-muted text-sm mb-8">Учётная запись Premium CRM</p>
{partial ? (
<>
<p className="text-sm mb-2">Код из приложения-аутентификатора.</p>
<input
inputMode="numeric"
value={code}
onChange={(e) => setCode(e.target.value.replace(/\D/g, "").slice(0, 6))}
placeholder="000000"
className="card w-full px-4 py-3 mb-3 text-base tracking-widest bg-white"
/>
<button className="btn-primary" disabled={busy || code.length < 6} onClick={submit2fa}>
{busy ? <Spinner /> : "Подтвердить"}
</button>
<button className="btn-ghost mt-2" onClick={() => { setPartial(null); setCode(""); }}>
Назад
</button>
</>
) : (
<>
<input
autoCapitalize="none"
autoCorrect="off"
value={username}
onChange={(e) => setUsername(e.target.value)}
placeholder="Логин"
className="card w-full px-4 py-3 mb-2 text-base bg-white"
/>
<input
type="password"
value={password}
onChange={(e) => setPassword(e.target.value)}
onKeyDown={(e) => { if (e.key === "Enter") submit(); }}
placeholder="Пароль"
className="card w-full px-4 py-3 mb-3 text-base bg-white"
/>
<button className="btn-primary" disabled={busy || !username || !password} onClick={submit}>
{busy ? <Spinner /> : "Войти"}
</button>
<button className="btn-ghost mt-2" onClick={() => nav("/login")}>Я водитель</button>
</>
)}
</div>
);
}
@@ -101,6 +101,11 @@ export function LoginPage() {
)}
<p className="text-muted text-xs mt-3">Telegram подтвердит ваш номер автоматически.</p>
<button className="btn-ghost mt-4" onClick={() => setMode("code")}>Войти по коду</button>
{/* Пока идёт обкатка, сотруднику надо попадать внутрь без карточки
водителя и без бота — учёткой CRM. Ссылка неприметная намеренно. */}
<button className="text-muted text-xs w-full mt-6" onClick={() => nav("/dev")}>
Вход для сотрудника
</button>
</>
) : (
<>
@@ -0,0 +1,42 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter, Route, Routes } from "react-router-dom";
vi.mock("@/api/driver", () => ({
mockPayOutcome: vi.fn(async () => ({ order_id: "mock-1", status: "PAID" })),
apiErrorText: vi.fn(async (_e: unknown, f: string) => f),
}));
import { MockPayPage } from "./MockPayPage";
import * as driver from "@/api/driver";
import { useAuth } from "@/store/auth";
const wrap = () =>
render(
<MemoryRouter initialEntries={["/mock-pay/mock-1"]}>
<Routes>
<Route path="/mock-pay/:orderId" element={<MockPayPage />} />
<Route path="/pay/:orderId" element={<p>экран оплаты</p>} />
</Routes>
</MemoryRouter>
);
describe("MockPayPage", () => {
beforeEach(() => { useAuth.getState().clear(); vi.clearAllMocks(); });
it("исход уходит на бэкенд и возвращает на настоящий экран оплаты", async () => {
useAuth.getState().setSession("t", 42, { impersonated: true, driverName: "Петров" });
wrap();
await userEvent.click(screen.getByRole("button", { name: /Банк отклонил/ }));
expect(driver.mockPayOutcome).toHaveBeenCalledWith("mock-1", "rejected");
expect(await screen.findByText("экран оплаты")).toBeInTheDocument();
});
it("водителю тут делать нечего", async () => {
useAuth.getState().setSession("t", 42);
wrap();
expect(screen.getByText(/Учебная оплата недоступна/)).toBeInTheDocument();
expect(driver.mockPayOutcome).not.toHaveBeenCalled();
});
});
@@ -0,0 +1,77 @@
import { useState } from "react";
import { useNavigate, useParams } from "react-router-dom";
import { toast } from "sonner";
import { apiErrorText, mockPayOutcome } from "@/api/driver";
import { useAuth } from "@/store/auth";
import { Spinner } from "@/components/Spinner";
/**
* Учебная «касса»: чем закончится платёж, который сотрудник создал под просмотром.
*
* Это подмена банка, а не экрана приложения. Настоящий экран оплаты
* (`/pay/:orderId`) остаётся тем же самым и разбирает те же статусы — иначе
* отладка проверяла бы поведение, которого у водителя не будет.
*/
const OUTCOMES = [
{ key: "paid", label: "Оплата прошла", hint: "PAID — экран «Оплачено»" },
{ key: "rejected", label: "Банк отклонил", hint: "REJECTED — «Оплата не прошла»" },
{ key: "expired", label: "Счёт протух", hint: "DEADLINE_EXPIRED — «Срок оплаты истёк»" },
{ key: "reversed", label: "Деньги вернулись", hint: "REVERSED — «Платёж возвращён»" },
] as const;
export function MockPayPage() {
const { orderId = "" } = useParams();
const nav = useNavigate();
const impersonated = useAuth((s) => s.impersonated);
const [busy, setBusy] = useState<string | null>(null);
async function choose(outcome: (typeof OUTCOMES)[number]["key"]) {
setBusy(outcome);
try {
await mockPayOutcome(orderId, outcome);
nav(`/pay/${orderId}`, { replace: true });
} catch (e: unknown) {
toast.error(await apiErrorText(e, "Не удалось разыграть исход"));
} finally {
setBusy(null);
}
}
if (!impersonated) {
return (
<div className="pt-24 text-center">
<p className="text-sm font-semibold mb-1">Учебная оплата недоступна</p>
<p className="text-muted text-xs mb-6">Этот экран работает только при просмотре сотрудником.</p>
<button className="btn-ghost" onClick={() => nav("/")}>На главную</button>
</div>
);
}
return (
<div className="pt-8">
<button className="text-muted text-xs mb-3" onClick={() => nav(-1)}>‹ Назад</button>
<h1 className="text-lg font-extrabold mb-1">Учебная оплата</h1>
<p className="text-muted text-xs mb-5">
Банка в этом платеже нет: ни списания, ни чека, ни проводки. Выберите, что
«ответит» банк — приложение покажет ровно то же, что увидел бы водитель.
</p>
<div className="card divide-y divide-line">
{OUTCOMES.map((o) => (
<button
key={o.key}
disabled={busy !== null}
onClick={() => choose(o.key)}
className="w-full text-left px-4 py-3 flex items-center justify-between gap-3 disabled:opacity-50"
>
<span>
<span className="block text-sm font-semibold">{o.label}</span>
<span className="block text-muted text-xs">{o.hint}</span>
</span>
{busy === o.key && <Spinner />}
</button>
))}
</div>
<p className="text-muted text-xs mt-4">Заказ: {orderId}</p>
</div>
);
}
+11 -1
View File
@@ -22,6 +22,9 @@ export function PaymentPage() {
const st = (useLocation().state as
{ payUrl?: string; total?: number; bucket?: string; base?: number; method?: string } | null) ?? {};
const { data, lastFailed, failStreak, refetch } = usePaymentStatus(orderId);
// Учебный платёж узнаётся по номеру заказа, а не по state роутера: state
// теряется при перезагрузке, а префикс — нет (см. backend mock_pay).
const mock = orderId.startsWith("mock-");
const status = data?.status ?? "";
const paid = status === "PAID";
// пока метод не передан в state — узнаём по ссылке: СБП отдаёт платёжку qr.nspk.ru, карта — форму банка
@@ -106,7 +109,14 @@ export function PaymentPage() {
{st.total != null && <p className="text-lg font-extrabold">{formatMoney(st.total)}</p>}
{st.bucket && <p className="text-muted text-xs">{st.bucket}</p>}
</div>
{st.payUrl ? (
{mock ? (
<>
<button className="btn-primary" onClick={() => nav(`/mock-pay/${orderId}`)}>
Выбрать исход
</button>
<p className="text-muted text-xs mt-2">Учебный платёж — банк не задействован</p>
</>
) : st.payUrl ? (
<>
<a className="btn-primary no-underline" href={st.payUrl} target="_blank" rel="noopener">Оплатить</a>
<p className="text-muted text-xs mt-2">Откроется ваше приложение банка</p>
+7 -1
View File
@@ -41,7 +41,13 @@ export function TopupPage() {
setBusy(true);
try {
const r = await topup(bucket, base, method as "qr" | "card");
nav(`/pay/${r.order_id}`, { state: { payUrl: r.pay_url, total: r.total, bucket, base } });
// Учебный платёж (сотрудник смотрит от чужого лица): банка нет, платить
// негде — сразу на экран выбора исхода, дальше всё как у водителя.
if (r.mock) {
nav(`/mock-pay/${r.order_id}`, { state: { total: r.total, bucket, base, method } });
return;
}
nav(`/pay/${r.order_id}`, { state: { payUrl: r.pay_url, total: r.total, bucket, base, method } });
} catch (err: unknown) {
// Текст с сервера, а не глухое «не удалось»: минимум СБП, потолок суммы и
// неизвестная категория объясняются словами, иначе экран молча не реагирует.