From 7034c6aaae3e8855f09dd20265b9795e6c25119e Mon Sep 17 00:00:00 2001
From: vladtechno
Date: Tue, 6 Oct 2026 20:51:29 +1000
Subject: [PATCH] =?UTF-8?q?Reapply=20"feat(bonuses):=20=D1=8D=D0=BA=D1=80?=
=?UTF-8?q?=D0=B0=D0=BD=20=C2=AB=D0=91=D0=BE=D0=BD=D1=83=D1=81=D1=8B=C2=BB?=
=?UTF-8?q?=20=E2=80=94=20=D1=83=D1=80=D0=BE=D0=B2=D0=B5=D0=BD=D1=8C,=20?=
=?UTF-8?q?=D1=81=D0=B5=D1=80=D0=B8=D0=B8,=20=D1=86=D0=B5=D0=BB=D0=B8,=20?=
=?UTF-8?q?=D0=B8=D1=81=D1=82=D0=BE=D1=80=D0=B8=D1=8F"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
This reverts commit f6bc3da47babaa483b56144c95811c06f8562f61.
---
driver-pwa/frontend/src/App.back.test.tsx | 3 +
driver-pwa/frontend/src/api/driver.ts | 60 ++++
.../frontend/src/pages/BalancePage.test.tsx | 16 +
driver-pwa/frontend/src/pages/BalancePage.tsx | 40 ++-
.../frontend/src/pages/BonusesPage.test.tsx | 113 +++++++
driver-pwa/frontend/src/pages/BonusesPage.tsx | 279 ++++++++++++++++++
driver-pwa/frontend/src/routes.tsx | 4 +
7 files changed, 512 insertions(+), 3 deletions(-)
create mode 100644 driver-pwa/frontend/src/pages/BonusesPage.test.tsx
create mode 100644 driver-pwa/frontend/src/pages/BonusesPage.tsx
diff --git a/driver-pwa/frontend/src/App.back.test.tsx b/driver-pwa/frontend/src/App.back.test.tsx
index b29385f..da87c7d 100644
--- a/driver-pwa/frontend/src/App.back.test.tsx
+++ b/driver-pwa/frontend/src/App.back.test.tsx
@@ -6,6 +6,9 @@ import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { useEffect, type ReactNode } from "react";
vi.mock("@/api/driver", () => ({
+ // Карточка бонусов на главной: null -> карточка спрятана, тестам баланса
+ // она не мешает.
+ getBonuses: vi.fn(async () => null),
getNotifications: vi.fn(async () => ({
items: [
{ id: 5, kind: "fine", title: "Новый штраф", body: "Постановление от 13.08.2026.",
diff --git a/driver-pwa/frontend/src/api/driver.ts b/driver-pwa/frontend/src/api/driver.ts
index 052f1f8..2e504b9 100644
--- a/driver-pwa/frontend/src/api/driver.ts
+++ b/driver-pwa/frontend/src/api/driver.ts
@@ -237,6 +237,66 @@ export const unsubscribePush = async (endpoint: string) =>
/** Пробное уведомление себе. Доступно только при просмотре сотрудником. */
export const sendTestPush = async () => api.post("driver/push/test").json();
+// ── Бонусы (система лояльности) ──────────────────────────────────────────────
+
+export const BonusesSchema = z.object({
+ level: z.object({
+ code: z.string(),
+ title: z.string(),
+ subtitle: z.string(),
+ days: z.number(),
+ next: z.object({ title: z.string(), days_left: z.number() }).nullable(),
+ series_start: z.string().nullable().default(null),
+ }),
+ week: z.object({
+ monday: z.string(),
+ orders: z.object({
+ yandex: z.number(),
+ maxim: z.number(),
+ total: z.number(),
+ tier_amount: z.number().default(0),
+ next_tier: z.object({ minimum: z.number(), amount: z.number() }).nullable().default(null),
+ }),
+ }),
+ payment_streak: z.object({
+ weeks: z.number(), weekly_amount: z.number(), monthly_cap: z.number(),
+ }),
+ clean: z.object({
+ days: z.number(),
+ next: z.object({ days: z.number(), amount: z.number() }).nullable().default(null),
+ }),
+ discount: z.object({
+ active: z.boolean(),
+ per_day: z.number(),
+ series: z.number(),
+ max_series: z.number(),
+ threshold: z.number(),
+ this_week_best: z.number(),
+ ends_at: z.string().nullable().default(null),
+ }),
+ sums: z.object({ pending: z.number(), earned: z.number(), this_month: z.number() }),
+ referral: z.object({
+ code: z.string(),
+ connect_amount: z.number(),
+ days_amount: z.number(),
+ work_days: z.number(),
+ invited: z.array(z.object({
+ driver_id: z.number(), days: z.number(), connected: z.boolean(),
+ })).default([]),
+ }),
+ goals: z.array(z.object({
+ kind: z.string(), text: z.string(), left: z.number(),
+ })).default([]),
+ accruals: z.array(z.object({
+ id: z.number(), program: z.string(), kind: z.string(), amount: z.number(),
+ title: z.string(), status: z.string(), date: z.string().nullable().default(null),
+ })).default([]),
+});
+export type Bonuses = z.infer;
+
+export const getBonuses = async () =>
+ BonusesSchema.parse(await api.get("driver/bonuses").json());
+
// ── Вход по номеру через МТС ID ──────────────────────────────────────────────
// Оператор подтверждает владение номером sim-push'ем, а если push не дошёл —
// СМС с кодом. Ответ от МТС приезжает нам колбэком СНАРУЖИ, поэтому приложение
diff --git a/driver-pwa/frontend/src/pages/BalancePage.test.tsx b/driver-pwa/frontend/src/pages/BalancePage.test.tsx
index c60d4d3..a543409 100644
--- a/driver-pwa/frontend/src/pages/BalancePage.test.tsx
+++ b/driver-pwa/frontend/src/pages/BalancePage.test.tsx
@@ -9,6 +9,22 @@ vi.mock("@/api/driver", () => ({
// Колокольчик в шапке главного экрана спрашивает счётчик непрочитанного.
getNotifications: vi.fn(async () => ({ items: [], unread: 0 })),
markNotificationsRead: vi.fn(async () => ({ marked: 0 })),
+ // Карточка бонусов на главной: та же форма, что отдаёт /driver/bonuses.
+ getBonuses: vi.fn(async () => ({
+ level: { code: "rhythm", title: "В ритме", subtitle: "Третья неделя", days: 18,
+ next: { title: "Первый месяц", days_left: 12 }, series_start: null },
+ week: { monday: "2026-08-10", orders: { yandex: 90, maxim: 37, total: 127,
+ tier_amount: 1200, next_tier: { minimum: 140, amount: 1500 } } },
+ payment_streak: { weeks: 3, weekly_amount: 500, monthly_cap: 3500 },
+ clean: { days: 18, next: { days: 30, amount: 1000 } },
+ discount: { active: true, per_day: 500, series: 2, max_series: 3, threshold: 70,
+ this_week_best: 90, ends_at: "2026-08-16" },
+ sums: { pending: 700, earned: 4300, this_month: 4300 },
+ referral: { code: "PP-2630", connect_amount: 2000, days_amount: 8000, work_days: 21,
+ invited: [{ driver_id: 9001, days: 9, connected: true }] },
+ goals: [{ kind: "orders", text: "Ещё 13 заказов до 1 500 ₽ за неделю", left: 13 }],
+ accruals: [],
+ })),
getBalance: vi.fn(async () => ({
accounts: [
{ bucket: "Долг аренда", balance: -3050, payable: true },
diff --git a/driver-pwa/frontend/src/pages/BalancePage.tsx b/driver-pwa/frontend/src/pages/BalancePage.tsx
index 07231c0..3987bc6 100644
--- a/driver-pwa/frontend/src/pages/BalancePage.tsx
+++ b/driver-pwa/frontend/src/pages/BalancePage.tsx
@@ -1,8 +1,8 @@
import { useState } from "react";
import { useQuery } from "@tanstack/react-query";
import { useNavigate, useSearchParams } from "react-router-dom";
-import { ArrowUp, ChevronRight, LogOut } from "lucide-react";
-import { getBalance, type StatementKind } from "@/api/driver";
+import { ArrowUp, ChevronRight, Gift, LogOut } from "lucide-react";
+import { getBalance, getBonuses, type StatementKind } from "@/api/driver";
import { formatMoney, isoDaysAgo, isoToday } from "@/lib/format";
import { paymentActivityWithin } from "@/lib/paymentWatch";
import { useAuth } from "@/store/auth";
@@ -49,6 +49,15 @@ export function BalancePage() {
refetchInterval: (q) => balancePollMs(q.state.data),
});
const [sheet, setSheet] = useState(false);
+ // Витрина бонусов на главной: если бонусная подсистема недоступна — карточку
+ // молча прячем, главный экран не должен падать из-за неё. Тот же ключ кэша,
+ // что у /bonuses: переход туда не бьёт в API второй раз.
+ const bonuses = useQuery({
+ queryKey: ["bonuses"],
+ queryFn: getBonuses,
+ retry: 0,
+ staleTime: 60_000,
+ });
// Фильтр выписки живёт в адресе (?kind=&from=&to=), а не в памяти экрана:
// вернувшись «Назад» из карточки штрафа, водитель видит тот же список штрафов,
// а не «Все операции», и F5 его не сбрасывает. Меняем заменой записи — выбор
@@ -144,11 +153,36 @@ export function BalancePage() {
)}
-
+ {/* ── Бонусы ────────────────────────────────────────────── */}
+ {bonuses.data && (
+
+ )}
+
{/* ── За что списано ─────────────────────────────────────── */}
setFilter("from", v)} onTo={(v) => setFilter("to", v)} onKind={setKind} />
diff --git a/driver-pwa/frontend/src/pages/BonusesPage.test.tsx b/driver-pwa/frontend/src/pages/BonusesPage.test.tsx
new file mode 100644
index 0000000..5373184
--- /dev/null
+++ b/driver-pwa/frontend/src/pages/BonusesPage.test.tsx
@@ -0,0 +1,113 @@
+import { describe, it, expect, vi } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { MemoryRouter, Route, Routes, useLocation } from "react-router-dom";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+
+// Экран из презентации владельца: уровень «В ритме», 18/21 день, 127/140
+// заказов, скидка активна второй неделей, в истории — подтверждённый бонус.
+vi.mock("@/api/driver", () => ({
+ getBonuses: vi.fn(async () => ({
+ level: { code: "rhythm", title: "В ритме", subtitle: "Третья неделя", days: 18,
+ next: { title: "Первый месяц", days_left: 12 }, series_start: null },
+ week: { monday: "2026-08-10", orders: { yandex: 90, maxim: 37, total: 127,
+ tier_amount: 1200, next_tier: { minimum: 140, amount: 1500 } } },
+ payment_streak: { weeks: 3, weekly_amount: 500, monthly_cap: 3500 },
+ clean: { days: 18, next: { days: 30, amount: 1000 } },
+ discount: { active: true, per_day: 500, series: 2, max_series: 3, threshold: 70,
+ this_week_best: 90, ends_at: "2026-08-16" },
+ sums: { pending: 700, earned: 4300, this_month: 4300 },
+ referral: { code: "PP-2630", connect_amount: 2000, days_amount: 8000, work_days: 21,
+ invited: [{ driver_id: 9001, days: 9, connected: true }] },
+ goals: [
+ { kind: "orders", text: "Ещё 13 заказов до 1 500 ₽ за неделю", left: 13 },
+ { kind: "level", text: "До уровня «Первый месяц» — 12 дн.", left: 12 },
+ ],
+ accruals: [
+ { id: 1, program: "orders", kind: "money", amount: 1200,
+ title: "127 заказов за неделю", status: "approved", date: "2026-08-16" },
+ { id: 2, program: "payment", kind: "money", amount: 500,
+ title: "Неделя без просрочки аренды", status: "pending", date: "2026-08-16" },
+ ],
+ })),
+}));
+
+import { BonusesPage } from "./BonusesPage";
+
+function Search() {
+ return {useLocation().search}
;
+}
+
+function wrap(url = "/bonuses") {
+ const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
+ return render(
+
+
+
+
+ } />
+ главная
} />
+
+
+
+ );
+}
+
+describe("экран бонусов", () => {
+ it("уровень, заработанное и путь до следующего уровня", async () => {
+ wrap();
+ expect(await screen.findByText("В ритме")).toBeInTheDocument();
+ expect(screen.getByText("18 дн. в парке")).toBeInTheDocument();
+ expect(screen.getByText(/до «Первый месяц» — 12 дн./)).toBeInTheDocument();
+ expect(screen.getByText("4 300 ₽")).toBeInTheDocument(); // заработано
+ expect(screen.getByText(/700 ₽ ждёт подтверждения/)).toBeInTheDocument();
+ });
+
+ it("заказы недели: сколько есть и сколько до следующего тира", async () => {
+ wrap();
+ expect(await screen.findByText("127")).toBeInTheDocument();
+ expect(screen.getByText("Яндекс 90 · Максим 37")).toBeInTheDocument();
+ // Тир 120–139 уже набран — показываем его сумму и путь до максимума.
+ expect(screen.getByText("Тир набран: 1 200 ₽ за неделю")).toBeInTheDocument();
+ });
+
+ it("активная скидка показывается зелёной картой с серией", async () => {
+ wrap();
+ expect(await screen.findByText("−500 ₽ в сутки")).toBeInTheDocument();
+ expect(screen.getByText(/серия 2 из 3/)).toBeInTheDocument();
+ });
+
+ it("серии оплат и «без нарушений» с вехой", async () => {
+ wrap();
+ expect(await screen.findByText("3 нед. подряд")).toBeInTheDocument();
+ expect(screen.getByText(/ещё 12 дн. — и 1 000 ₽/)).toBeInTheDocument();
+ });
+
+ it("код друга и ближайшие цели", async () => {
+ wrap();
+ expect(await screen.findByText("PP-2630")).toBeInTheDocument();
+ expect(screen.getByText("Ещё 13 заказов до 1 500 ₽ за неделю")).toBeInTheDocument();
+ expect(screen.getByText(/друзей привёл: 1/)).toBeInTheDocument();
+ });
+
+ it("история начислений с разницей «начислено / ждёт»", async () => {
+ wrap();
+ expect(await screen.findByText("127 заказов за неделю")).toBeInTheDocument();
+ expect(screen.getByText("начислено")).toBeInTheDocument();
+ expect(screen.getByText("ждёт подтверждения")).toBeInTheDocument();
+ });
+
+ it("ошибка загрузки предлагает повторить, а не белый экран", async () => {
+ const { getBonuses } = await import("@/api/driver");
+ vi.mocked(getBonuses).mockRejectedValueOnce(new Error("boom"));
+ wrap();
+ expect(await screen.findByRole("button", { name: /Попробовать снова/ })).toBeInTheDocument();
+ });
+
+ it("клик по карточке на главной — отдельный маршрут /bonuses", async () => {
+ // Сам маршрут описан в routes.tsx и покрыт сторожем routes.test.tsx
+ // («Назад» на каждом экране); здесь проверяем только сам экран.
+ wrap();
+ expect(screen.getByTestId("search").textContent).toBe("");
+ expect(screen.queryByText("главная")).not.toBeInTheDocument();
+ });
+});
diff --git a/driver-pwa/frontend/src/pages/BonusesPage.tsx b/driver-pwa/frontend/src/pages/BonusesPage.tsx
new file mode 100644
index 0000000..625bc84
--- /dev/null
+++ b/driver-pwa/frontend/src/pages/BonusesPage.tsx
@@ -0,0 +1,279 @@
+import { useQuery } from "@tanstack/react-query";
+import {
+ BarChart3, CalendarCheck, ChevronRight, Flame, Gift, ShieldCheck, Target,
+ Trophy, Users,
+} from "lucide-react";
+
+import { getBonuses, type Bonuses } from "@/api/driver";
+import { Spinner } from "@/components/Spinner";
+import { formatDate, formatMoney } from "@/lib/format";
+
+/** Полоса прогресса: тонкая, с мягкими краями — как «до следующей цели». */
+function Bar({ value, max, tone = "accent" }: { value: number; max: number; tone?: "accent" | "pos" }) {
+ const pct = max > 0 ? Math.min(100, Math.round((value / max) * 100)) : 0;
+ return (
+
+ );
+}
+
+function ProgramIcon({ program }: { program: string }) {
+ const cls = "w-5 h-5 text-accent shrink-0";
+ switch (program) {
+ case "orders": return ;
+ case "discount": return ;
+ case "payment": return ;
+ case "clean": return ;
+ case "tenure": return ;
+ case "friend": return ;
+ default: return ;
+ }
+}
+
+function Card({ children, tone = "plain" }: { children: React.ReactNode; tone?: "plain" | "pos" }) {
+ return (
+
+ {children}
+
+ );
+}
+
+const CardTitle = ({ icon, children }: { icon: React.ReactNode; children: React.ReactNode }) => (
+
+ {icon}
+ {children}
+
+);
+
+const STATUS_LABEL: Record = {
+ pending: { text: "ждёт подтверждения", cls: "text-muted" },
+ approved: { text: "начислено", cls: "text-pos font-medium" },
+ posted: { text: "начислено", cls: "text-pos font-medium" },
+};
+
+/**
+ * Бонусы — витрина системы лояльности: уровень, серии, прогресс до следующей
+ * суммы и история начислений. Числа считаются тем же движком, что и в CRM,
+ * поэтому с менеджером всегда одинаковые (docs/bonus-rules.md на бэкенде).
+ */
+export function BonusesPage() {
+ const { data, error, refetch } = useQuery({
+ queryKey: ["bonuses"],
+ queryFn: getBonuses,
+ staleTime: 60_000,
+ });
+
+ if (error) {
+ return (
+
+
Бонусы
+
+
Не удалось загрузить бонусы. Проверьте связь.
+
+
+
+ );
+ }
+ if (!data) {
+ return (
+
+
Бонусы
+
+
+ );
+ }
+
+ return ;
+}
+
+function BonusesBody({ b }: { b: Bonuses }) {
+ const o = b.week.orders;
+ const weekFrom = formatDate(b.week.monday);
+
+ return (
+
+
Бонусы
+
+ {/* Уровень + заработанное — первое, ради чего экран открывают */}
+
+
+
+
+
+
+
+
{b.level.title}
+
{b.level.subtitle}
+
+
+
+
{formatMoney(b.sums.earned)}
+
заработано
+
+
+
+
+
+ {b.level.days} дн. в парке
+ {b.level.next && (
+
+ до «{b.level.next.title}» — {b.level.next.days_left} дн.
+
+ )}
+
+
+
+
+ {b.sums.pending > 0 && (
+
+ Ещё {formatMoney(b.sums.pending)} ждёт подтверждения менеджера
+
+ )}
+
+
+ {/* Ближайшие цели — «ещё 13 заказов и…» (памятка из презентации) */}
+ {b.goals.length > 0 && (
+
+
}>До ближайших целей
+
+ {b.goals.map((g, i) => (
+ -
+
+ {g.text}
+
+ ))}
+
+
+ )}
+
+ {/* Заказы за неделю */}
+
+ }>
+ Заказы за неделю (с {weekFrom})
+
+
+
{o.total}
+
Яндекс {o.yandex} · Максим {o.maxim}
+
+
+
+ {o.tier_amount > 0
+ ? `Тир набран: ${formatMoney(o.tier_amount)} за неделю`
+ : o.next_tier
+ ? `Ещё ${o.next_tier.minimum - o.total} заказов — и ${formatMoney(o.next_tier.amount)}`
+ : "Максимальный тир недели"}
+
+
+
+ {/* Скидка 70+ */}
+ {b.discount.active ? (
+
+ }>Скидка на аренду активна
+
+ −{formatMoney(b.discount.per_day)} в сутки
+
+
+ до {formatDate(b.discount.ends_at)} · серия {b.discount.series} из {b.discount.max_series}
+
+
+ Продли: {b.discount.threshold}+ заказов в одном агрегаторе на этой неделе
+
+
+ ) : (
+
+ }>
+ Скидка за {b.discount.threshold}+ заказов
+
+
+
{b.discount.this_week_best}
+
из {b.discount.threshold} в одном агрегаторе
+
+
+
+ Дальше — −{formatMoney(b.discount.per_day)} с аренды каждый день следующей недели
+
+
+ )}
+
+ {/* Оплата вовремя */}
+
+ }>Оплата вовремя
+ {b.payment_streak.weeks} нед. подряд
+
+ +{formatMoney(b.payment_streak.weekly_amount)} за каждую неделю без просрочки
+
+
+
+ {/* Без нарушений */}
+
+ }>Без нарушений
+ {b.clean.days} дн.
+ {b.clean.next && (
+ <>
+
+
+ ещё {b.clean.next.days - b.clean.days} дн. — и {formatMoney(b.clean.next.amount)}
+
+ >
+ )}
+
+
+ {/* Приведи друга */}
+
+ }>Приведи друга
+
+
+
твой код
+
{b.referral.code}
+
+
+ до {formatMoney(b.referral.connect_amount + b.referral.days_amount)}
+
+ {b.referral.invited.length > 0
+ ? `друзей привёл: ${b.referral.invited.length}`
+ : `за друга, который проработает ${b.referral.work_days} дн.`}
+
+
+
+
+ Назови код менеджеру при подключении друга — бонус придёт сюда
+
+
+
+ {/* История начислений */}
+
+
История начислений
+ {b.accruals.length === 0 && (
+
+ Пока пусто: начисления появляются после первой закрытой недели
+
+ )}
+
+
+
+ );
+}
diff --git a/driver-pwa/frontend/src/routes.tsx b/driver-pwa/frontend/src/routes.tsx
index 7a333b2..d2e5709 100644
--- a/driver-pwa/frontend/src/routes.tsx
+++ b/driver-pwa/frontend/src/routes.tsx
@@ -13,6 +13,7 @@ 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 {
@@ -52,6 +53,9 @@ export const ROUTES: AppRoute[] = [
// туда и возвращаем; без входа возвращаться некуда, кроме экрана входа.
{ path: "/dev", element: , parent: ({ signedIn }) => (signedIn ? "/" : "/login") },
{ path: "/notifications", element: , guard: "auth", parent: "/" },
+ // Бонусы открывают карточкой с главной и пушем «Бонус начислен» — оба
+ // случая возвращаются на главную.
+ { path: "/bonuses", element: , guard: "auth", parent: "/" },
{ path: "/topup", element: , guard: "auth", parent: "/" },
{ path: "/pay/:orderId", element: , guard: "auth", parent: "/" },
{ path: "/mock-pay/:orderId", element: , guard: "auth", parent: "/" },