Если браузер сам выбирает сектор через Math.random(), пользователь может изменить скрипт, повторить запрос или вызвать функцию из консоли. Сначала сервер решает, разрешена ли попытка и какой приз остался в фонде; только после фиксации результата интерфейс запускает вращение. Так визуальный эффект не становится источником бизнес-истины.

До вёрстки формализуйте правила: кто участвует, сколько попыток доступно, когда они обновляются, что считается выдачей и что происходит при обрыве связи. Юридические условия акции зависят от юрисдикции и механики, поэтому их проверяет владелец кампании до запуска, а интерфейс точно отображает утверждённую редакцию.

Один запрос создаёт один неизменяемый результат

POST /api/promo/spins
Idempotency-Key: 4e7d...

{ "campaign_id": "autumn-2026" }

201 Created
{
  "spin_id": "sp_0184",
  "segment_id": "discount_10",
  "label": "Скидка 10%",
  "claim_token": "signed-short-lived-token"
}

Сервер связывает idempotency key с участником и кампанией. Повтор того же запроса возвращает тот же spin, но не списывает вторую награду. Новый ключ не помогает обойти лимит, потому что право на попытку проверяется отдельно. В логах токен и пользовательские данные маскируются.

Транзакция защищает фонд от двух одновременных побед

  1. Проверить состояние кампании, участника, период и неиспользованный лимит.
  2. В транзакции заблокировать доступную запись фонда или применить атомарное условное обновление.
  3. Выбрать сектор по утверждённым весам только среди доступных наград.
  4. Записать spin, уменьшить фонд и зафиксировать правило, по которому сделан выбор.
  5. Сформировать короткоживущий claim token либо сразу создать награду в аккаунте.
  6. После commit вернуть результат; при сетевом повторе найти его по idempotency key.

Криптографически сильный источник случайности нужен там, где результат имеет ценность. В браузере Web Crypto предоставляет crypto.getRandomValues, но даже качественная клиентская случайность не защищает фонд от модифицированного кода. Для промо с призами выбор и учёт остаются на доверенном сервере.

Симптом сразу указывает на нарушенную границу

НаблюдениеВероятная причинаСледующая проверка
После refresh выпал другой призРезультат не сохранён до анимацииНайти spin по idempotency key
Фонд ушёл ниже нуляНеатомарное уменьшениеЗапустить два параллельных запроса на последнюю единицу
Можно крутить из консолиАвторизация только в UIПовторить API без кнопки и проверить серверный лимит
Приз виден, но не применёнSpin и claim живут раздельно без состоянияСверить журнал выдачи и expiry токена
Колесо остановилось между секторамиГеометрия вычисляется независимо от segment_idПривязать конечный угол к центру сектора
Повторный webhook выдаёт дубльНет уникального внешнего event IDПроверить uniqueness и ответ на replay

Анимация объясняет результат и уважает настройки движения

После ответа API frontend вычисляет конечный угол центра segment_id, добавляет несколько полных оборотов и анимирует transform. Кнопка блокируется на время запроса, но состояние не определяется её disabled-атрибутом. При prefers-reduced-motion колесо может мгновенно перейти к сектору и показать тот же текстовый результат: W3C рекомендует позволять отключать несущественную анимацию, вызванную взаимодействием.

  • Кнопка доступна с клавиатуры и имеет видимый focus.
  • Результат объявляется в отдельной live region, а не только цветом сектора.
  • Во время ожидания есть текстовый статус без бесконечного вращения.
  • После ошибки кнопка возвращается в понятное состояние, исход запроса проверяется по spin_id.
  • Кнопка «крутить ещё раз» появляется только после серверного подтверждения новой попытки.

Антиабьюз ставится на бизнес-действие

Ограничивайте частоту и наблюдайте именно endpoint spins, а не только вход в аккаунт. OWASP рекомендует rate limit и мониторинг на уровне функции, потому что валидный запрос всё равно может злоупотреблять бизнес-правилом. Свяжите сигналы участника, кампании, устройства и аномальной скорости, но не выдавайте блокировку за безошибочное доказательство мошенничества.

Приёмка должна включать refresh во время вращения, двойной клик, два параллельных запроса, повтор того же idempotency key, исчерпание последнего приза и восстановление после timeout. Для реализации подготовьте утверждённые правила, веса, фонд, модель участника, тексты состояний и процедуру ручного разбора спорной выдачи.

Проверенные источники