Рулетка DCHDonate - инструкция пользователя

Есть две страницы:

• Админка - настройка пароля, подключений DA/DP, Telegram Chat ID и стоимости стрима.
• Рулетка - управление лотами и колесом.

1. Открой админку: https://dchdonate.ru/settingsdonate
2. Если видишь блок “Первичная установка пароля администратора” - введи пароль и нажми кнопку "Задать пароль".
3. После установки перейди к пункту 1.2 (вход).

Скриншот A1. Попроси себя пометить: 1 — токен, 2 — user_id.

1. Введи пароль в блоке “Вход администратора”.
2. Нажми “Войти”.
3. Проверь строку статуса: должно быть “Вход выполнен”.

Скриншот A1. Попроси себя пометить: 1 — токен, 2 — user_id.

1. Нажми “Выйти”.
2. Убедись, что управление на рулетке стало недоступным (кнопки заблокируются).

1. В админке найди блок DonationAlerts.
2. Нажми “Подключить DA”.
3. Тебя перенаправит на DonationAlerts - дай разрешение приложению.
4. После возврата в админку индикатор DA станет активным.

Индикатор до подключения

Индикатор после подключения

1. Нажми “Отключить DA”.
2. Проверь, что индикатор DA стал неактивным.

1. Открой страницу DP API.
2. Скопируй API ключ.
3. Скопируй User ID (числовой).

1 - ключ, 2 - user_id.

1. В админке нажми “Подключить DP”.
2. В модальном окне вставь ключ и user_id.
3. Нажми “Сохранить”.
4. Убедись, что DP стал “подключён” (индикатор активен).

1 - ключ, 2 - user_id, 3 - кнопка “Сохранить”.

активний индикатор

1. Нажми “Отключить DP”.
2. Проверь, что индикатор DP стал неактивным.

1. Открой @userinfobot и нажми Start.
2. Скопируй свой id (числовой).

1. В админке найди поле Telegram Chat ID.
2. Вставь ID и нажми “Сохранить”.

1. В админке найди поле “Стоимость стрима (₽)”.
2. Введи целое число (например 4000) и нажми “Сохранить”.
3. На рулетке в вкладке колеса появится баннер с текущей стоимостью.

Поле стоимости стрима

Баннер на странице рулетки

Баннер на странице рулетки, если стоимость не задана

1. Открой рулетку: https://dchdonate.ru/
2. Перейди на вкладку “Лоты”.
3. Введи название и сумму.
4. Нажми кнопку добавления (+ Добавить лот).

У каждого лота есть числовое поле + (delta). Оно принимает положительные и отрицательные значения. Изменение применяется по Enter и сохраняется в базе.

1. Найди нужный лот в списке.
2. В поле “+” введи, например, 100 и нажми Enter - сумма увеличится.
3. Введи -1000 и нажми Enter - сумма уменьшится.

1. Кликни по названию (если оно редактируемое) или используй элемент редактирования рядом.
2. Внеси изменения и сохрани (Enter/потеря фокуса - зависит от реализации).

Объединение делается перетаскиванием одного лота на другой (как правило - за “ручку” перетаскивания).

1. Убедись, что авторизация активна.
2. Возьми лот за “ручку” (иконка/зона перетаскивания).
3. Перетащи на второй лот и отпусти.
4. Сумма первого прибавится ко второму, первый исчезнет.

1. Перейди на вкладку “Колесо”.
2. Слева отображается список участников/лотов с чекбоксами.
3. Чекбокс включён → лот участвует. Выключен → не участвует.

1. Включить все - включает все лоты, которые не заблокированы порогом.
2. Отключить все - выключает все лоты.
3. Перегенерировать цвета - меняет цвета сегментов (визуально).

1. Убедись, что включён хотя бы один лот.
2. Нажми кнопку «Крутить».
3. Дождись остановки. Победитель определяется указателем.

После остановки колеса показывается окно с победившим лотом.

1. Нажми «Крутить» и дождись результата.
2. В модалке будет кнопка «Списать за стрим».

• Берёт текущую “Стоимость стрима” из админки.
• Списывает эту сумму с победившего лота.
• Если после списания сумма стала ≤ 0 - лот может быть удалён (зависит от серверной логики).
• Список лотов обновляется, и порог стоимости снова применяется.

1. В списке лотов нажми иконку удаления (корзина) напротив нужного лота.
2. Лот исчезнет из списка и из колеса (если участвовал).

1. Нажми кнопку “Удалить всё / Очистить”.
2. Подтверди действие (если есть подтверждение).

1. Сделай тестовый донат в DA или DP.
2. Убедись, что донат появился по ссылке истории.
3. Проверь, что сумма соответствующего лота изменилась (если в твоём режиме донаты попадают в лоты).
4. Проверь, что Telegram-уведомление пришло (если включено).

• Открой админку и выполни вход.
• В DevTools на рулетке проверь /api/state → authed: true.
• Если ранее переключал домены/куки - очисти cookies для dchdonate.ru и войди заново.

• Изменение суммы должно отправляться на сервер (а не только менять локальный state).
• Проверь в Network запрос POST /api/lots/<id>/plus (статус 200).
• Если автообновление мешает вводу - включи “паузу автообновления при фокусе в input”.

• Проверь, что стоимость стрима задана > 0 в админке.
• Проверь, что после пересчёта вызывается перерисовка (обычно через save()/renderAll()).

• Проверь корректность OAuth Client Secret (не API key).
• Проверь redirect_uri (www/не-www).