From e6e1d705b3f2aa105aa4fbbd9f2505a530935342 Mon Sep 17 00:00:00 2001 From: vladtechno Date: Mon, 5 Oct 2026 22:53:45 +1000 Subject: [PATCH] =?UTF-8?q?feat(bonuses):=20=D1=8D=D0=BA=D1=80=D0=B0=D0=BD?= =?UTF-8?q?=20=C2=AB=D0=91=D0=BE=D0=BD=D1=83=D1=81=D1=8B=C2=BB=20=E2=80=94?= =?UTF-8?q?=20=D1=83=D1=80=D0=BE=D0=B2=D0=B5=D0=BD=D1=8C,=20=D1=81=D0=B5?= =?UTF-8?q?=D1=80=D0=B8=D0=B8,=20=D1=86=D0=B5=D0=BB=D0=B8,=20=D0=B8=D1=81?= =?UTF-8?q?=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 - /bonuses: уровень (Новичок→Легенда) с прогрессом до следующего, заработанное, карточки программ (заказы недели с тиром, скидка 70+, оплата вовремя, без нарушений, код друга), ближайшие цели, история начислений - карточка-вход на главной под «Пополнить» (скрывается, если бонус-API недоступен) - push «Бонус начислен» ведёт сюда же (deep link через guard+returnTo) --- 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 && ( +
+ Пока пусто: начисления появляются после первой закрытой недели +
+ )} +
    + {b.accruals.map((a) => { + const st = STATUS_LABEL[a.status] ?? { text: a.status, cls: "text-muted" }; + return ( +
  • + +
    +
    {a.title}
    +
    {st.text}
    +
    +
    + {formatMoney(a.amount)} +
    +
  • + ); + })} +
+
+
+ ); +} diff --git a/driver-pwa/frontend/src/routes.tsx b/driver-pwa/frontend/src/routes.tsx index 5db4ac9..c4f97d3 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: "/" },