feat(bonuses): экран «Бонусы» — уровень, серии, цели, история

- /bonuses: уровень (Новичок→Легенда) с прогрессом до следующего, заработанное,
  карточки программ (заказы недели с тиром, скидка 70+, оплата вовремя,
  без нарушений, код друга), ближайшие цели, история начислений
- карточка-вход на главной под «Пополнить» (скрывается, если бонус-API недоступен)
- push «Бонус начислен» ведёт сюда же (deep link через guard+returnTo)
This commit is contained in:
tremble7681 committed 2026-10-05 22:53:45 +10:00
1 parent ab2ad8d471
commit e6e1d705b3
7 files changed
+512 -3

No files matched your search

@@ -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.",
+60
View File
@@ -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<typeof BonusesSchema>;
export const getBonuses = async () =>
BonusesSchema.parse(await api.get("driver/bonuses").json());
// ── Вход по номеру через МТС ID ──────────────────────────────────────────────
// Оператор подтверждает владение номером sim-push'ем, а если push не дошёл —
// СМС с кодом. Ответ от МТС приезжает нам колбэком СНАРУЖИ, поэтому приложение
@@ -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 },
+37 -3
View File
@@ -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() {
)}
</div>
<button className="btn-primary flex items-center justify-center gap-2 mb-5"
<button className="btn-primary flex items-center justify-center gap-2 mb-3"
onClick={() => setSheet(true)}>
<ArrowUp size={18} /> Пополнить
</button>
{/* ── Бонусы ────────────────────────────────────────────── */}
{bonuses.data && (
<button
className="card w-full flex items-center gap-3 p-4 mb-5 text-left"
onClick={() => nav("/bonuses")}
>
<div className="w-10 h-10 rounded-full bg-accent-soft flex items-center justify-center shrink-0">
<Gift size={20} className="text-accent" />
</div>
<div className="min-w-0 flex-1">
<div className="text-sm font-semibold">Бонусы</div>
<div className="text-muted text-xs truncate">
{bonuses.data.level.title} · {bonuses.data.level.days} дн.
{bonuses.data.goals[0] ? ` · ${bonuses.data.goals[0].text}` : ""}
</div>
</div>
<div className="text-right shrink-0">
<b className="text-pos text-sm whitespace-nowrap">
{formatMoney(bonuses.data.sums.earned)}
</b>
<ChevronRight size={16} className="text-muted ml-1 inline" />
</div>
</button>
)}
{/* ── За что списано ─────────────────────────────────────── */}
<Statement from={from} to={to} kind={kind}
onFrom={(v) => setFilter("from", v)} onTo={(v) => setFilter("to", v)} onKind={setKind} />
@@ -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 <p data-testid="search">{useLocation().search}</p>;
}
function wrap(url = "/bonuses") {
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
return render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={[url]}>
<Search />
<Routes>
<Route path="/bonuses" element={<BonusesPage />} />
<Route path="/" element={<p>главная</p>} />
</Routes>
</MemoryRouter>
</QueryClientProvider>
);
}
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();
});
});
@@ -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 (
<div className="h-2 rounded-full bg-line-soft overflow-hidden mt-2">
<div
className={`h-full rounded-full ${tone === "pos" ? "bg-pos" : "bg-accent"}`}
style={{ width: `${pct}%` }}
/>
</div>
);
}
function ProgramIcon({ program }: { program: string }) {
const cls = "w-5 h-5 text-accent shrink-0";
switch (program) {
case "orders": return <BarChart3 className={cls} />;
case "discount": return <Flame className={cls} />;
case "payment": return <CalendarCheck className={cls} />;
case "clean": return <ShieldCheck className={cls} />;
case "tenure": return <Trophy className={cls} />;
case "friend": return <Users className={cls} />;
default: return <Gift className={cls} />;
}
}
function Card({ children, tone = "plain" }: { children: React.ReactNode; tone?: "plain" | "pos" }) {
return (
<div
className={`card p-4 ${tone === "pos" ? "border-pos/40 bg-pos/5" : ""}`}
>
{children}
</div>
);
}
const CardTitle = ({ icon, children }: { icon: React.ReactNode; children: React.ReactNode }) => (
<div className="flex items-center gap-2 text-ink-soft text-sm font-medium">
{icon}
<span>{children}</span>
</div>
);
const STATUS_LABEL: Record<string, { text: string; cls: string }> = {
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 (
<div>
<h1 className="text-lg font-bold mb-3">Бонусы</h1>
<div className="card p-4 text-sm">
<p className="text-ink-soft">Не удалось загрузить бонусы. Проверьте связь.</p>
<button className="btn-primary mt-3 w-full" onClick={() => void refetch()}>
Попробовать снова
</button>
</div>
</div>
);
}
if (!data) {
return (
<div>
<h1 className="text-lg font-bold mb-3">Бонусы</h1>
<Spinner />
</div>
);
}
return <BonusesBody b={data} />;
}
function BonusesBody({ b }: { b: Bonuses }) {
const o = b.week.orders;
const weekFrom = formatDate(b.week.monday);
return (
<div className="space-y-3">
<h1 className="text-lg font-bold">Бонусы</h1>
{/* Уровень + заработанное — первое, ради чего экран открывают */}
<div className="card p-4">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-3">
<div className="w-11 h-11 rounded-full bg-accent-soft flex items-center justify-center shrink-0">
<Trophy className="w-6 h-6 text-accent" />
</div>
<div>
<div className="text-xl font-bold leading-tight">{b.level.title}</div>
<div className="text-muted text-sm">{b.level.subtitle}</div>
</div>
</div>
<div className="text-right shrink-0">
<div className="text-xl font-bold text-pos">{formatMoney(b.sums.earned)}</div>
<div className="text-muted text-xs">заработано</div>
</div>
</div>
<div className="mt-4">
<div className="flex justify-between text-sm">
<span className="text-ink-soft">{b.level.days} дн. в парке</span>
{b.level.next && (
<span className="text-muted">
до «{b.level.next.title}» — {b.level.next.days_left} дн.
</span>
)}
</div>
<Bar value={b.level.days % 30 || 30} max={30} />
</div>
{b.sums.pending > 0 && (
<div className="mt-2 text-xs text-muted">
Ещё {formatMoney(b.sums.pending)} ждёт подтверждения менеджера
</div>
)}
</div>
{/* Ближайшие цели — «ещё 13 заказов и…» (памятка из презентации) */}
{b.goals.length > 0 && (
<div className="card p-4">
<CardTitle icon={<Target className="w-5 h-5 text-accent" />}>До ближайших целей</CardTitle>
<ul className="mt-2 space-y-1.5 text-sm">
{b.goals.map((g, i) => (
<li key={i} className="flex items-start gap-2">
<ChevronRight className="w-4 h-4 text-muted mt-0.5 shrink-0" />
<span>{g.text}</span>
</li>
))}
</ul>
</div>
)}
{/* Заказы за неделю */}
<Card>
<CardTitle icon={<BarChart3 className="w-5 h-5 text-accent" />}>
Заказы за неделю (с {weekFrom})
</CardTitle>
<div className="flex items-baseline justify-between mt-1">
<div className="text-2xl font-bold tabular-nums">{o.total}</div>
<div className="text-muted text-sm">Яндекс {o.yandex} · Максим {o.maxim}</div>
</div>
<Bar value={o.total} max={o.next_tier?.minimum ?? 140} />
<div className="mt-2 text-sm text-ink-soft">
{o.tier_amount > 0
? `Тир набран: ${formatMoney(o.tier_amount)} за неделю`
: o.next_tier
? `Ещё ${o.next_tier.minimum - o.total} заказов — и ${formatMoney(o.next_tier.amount)}`
: "Максимальный тир недели"}
</div>
</Card>
{/* Скидка 70+ */}
{b.discount.active ? (
<Card tone="pos">
<CardTitle icon={<Flame className="w-5 h-5 text-pos" />}>Скидка на аренду активна</CardTitle>
<div className="text-2xl font-bold text-pos mt-1">
−{formatMoney(b.discount.per_day)} в сутки
</div>
<div className="mt-1 text-sm text-ink-soft">
до {formatDate(b.discount.ends_at)} · серия {b.discount.series} из {b.discount.max_series}
</div>
<div className="mt-1 text-xs text-muted">
Продли: {b.discount.threshold}+ заказов в одном агрегаторе на этой неделе
</div>
</Card>
) : (
<Card>
<CardTitle icon={<Flame className="w-5 h-5 text-accent" />}>
Скидка за {b.discount.threshold}+ заказов
</CardTitle>
<div className="flex items-baseline justify-between mt-1">
<div className="text-2xl font-bold tabular-nums">{b.discount.this_week_best}</div>
<div className="text-muted text-sm">из {b.discount.threshold} в одном агрегаторе</div>
</div>
<Bar value={b.discount.this_week_best} max={b.discount.threshold} />
<div className="mt-2 text-sm text-ink-soft">
Дальше — −{formatMoney(b.discount.per_day)} с аренды каждый день следующей недели
</div>
</Card>
)}
{/* Оплата вовремя */}
<Card>
<CardTitle icon={<CalendarCheck className="w-5 h-5 text-accent" />}>Оплата вовремя</CardTitle>
<div className="text-2xl font-bold mt-1">{b.payment_streak.weeks} нед. подряд</div>
<div className="mt-1 text-sm text-ink-soft">
+{formatMoney(b.payment_streak.weekly_amount)} за каждую неделю без просрочки
</div>
</Card>
{/* Без нарушений */}
<Card>
<CardTitle icon={<ShieldCheck className="w-5 h-5 text-accent" />}>Без нарушений</CardTitle>
<div className="text-2xl font-bold mt-1">{b.clean.days} дн.</div>
{b.clean.next && (
<>
<Bar value={b.clean.days} max={b.clean.next.days} tone="pos" />
<div className="mt-2 text-sm text-ink-soft">
ещё {b.clean.next.days - b.clean.days} дн. — и {formatMoney(b.clean.next.amount)}
</div>
</>
)}
</Card>
{/* Приведи друга */}
<Card>
<CardTitle icon={<Users className="w-5 h-5 text-accent" />}>Приведи друга</CardTitle>
<div className="flex items-baseline justify-between mt-1">
<div>
<div className="text-muted text-xs">твой код</div>
<div className="text-2xl font-bold tracking-wide">{b.referral.code}</div>
</div>
<div className="text-right text-sm text-ink-soft">
до {formatMoney(b.referral.connect_amount + b.referral.days_amount)}
<div className="text-muted text-xs">
{b.referral.invited.length > 0
? `друзей привёл: ${b.referral.invited.length}`
: `за друга, который проработает ${b.referral.work_days} дн.`}
</div>
</div>
</div>
<div className="mt-2 text-xs text-muted">
Назови код менеджеру при подключении друга — бонус придёт сюда
</div>
</Card>
{/* История начислений */}
<div className="card p-0 overflow-hidden">
<div className="px-4 pt-4 pb-2 text-sm font-medium text-ink-soft">История начислений</div>
{b.accruals.length === 0 && (
<div className="px-4 pb-4 text-muted text-sm">
Пока пусто: начисления появляются после первой закрытой недели
</div>
)}
<ul>
{b.accruals.map((a) => {
const st = STATUS_LABEL[a.status] ?? { text: a.status, cls: "text-muted" };
return (
<li key={a.id} className="flex items-center gap-3 px-4 py-3 border-t border-line">
<ProgramIcon program={a.program} />
<div className="min-w-0 flex-1">
<div className="text-sm">{a.title}</div>
<div className={`text-xs ${st.cls}`}>{st.text}</div>
</div>
<div className="text-sm font-semibold tabular-nums whitespace-nowrap">
{formatMoney(a.amount)}
</div>
</li>
);
})}
</ul>
</div>
</div>
);
}
+4
View File
@@ -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: <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: "/" },