Если браузер сам выбирает сектор через 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, но не списывает вторую награду. Новый ключ не помогает обойти лимит, потому что право на попытку проверяется отдельно. В логах токен и пользовательские данные маскируются.
Транзакция защищает фонд от двух одновременных побед
- Проверить состояние кампании, участника, период и неиспользованный лимит.
- В транзакции заблокировать доступную запись фонда или применить атомарное условное обновление.
- Выбрать сектор по утверждённым весам только среди доступных наград.
- Записать spin, уменьшить фонд и зафиксировать правило, по которому сделан выбор.
- Сформировать короткоживущий claim token либо сразу создать награду в аккаунте.
- После 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. Для реализации подготовьте утверждённые правила, веса, фонд, модель участника, тексты состояний и процедуру ручного разбора спорной выдачи.