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

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

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

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

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

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

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

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

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

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 и нажми “Сохранить”.
3. Перейди в бота уведомлений и нажми /start. @dendonate_bot

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

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

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

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

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

1 - название, 2 - сумма, 3 - кнопка.

Список лотов после добавления лота.

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

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

1. Кликни по названию.
2. Внеси изменения и сохрани (Enter).

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

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

"Ручки", за которые перетаскиваются лоты.

На скриншоте взялись за "ручку" лота Test и навели его на лот Test2.

Результат объединения двух лотов (Test2 остался, к нему прибавилось значение лота Test).

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

На скриншоте в колесе участвует только один лот - Test3. У лотов Test2 и Test1 недостаточно средств для стрима (в примере стоимость стрима установлена на 4 000).

В админке стоимость стрима уменьшили до 1 700. После этого лот Test1 также начал участвовать в колесе, так как его сумма превышает 1 700.

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

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

1 - поле таймера. 2 - кнопка "Крутить колесо". 3 - подсказка для таймера.

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

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

1 - победитель, 2 - кнопка списания.

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

Список лотов после одного прокрута рулетки (в 9.1 у лота Test3 списали 1 700).

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

Кнопка удаления (корзина).

Модальное окно удаления лота.

Список лотов после удаления лота Test1.

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

Кнопка удаления всех лотов.

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

Уведомления в тг боте (если выполнен пункт 4).

Список лотов после тестовых донатов.

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

• Проверь, что стоимость стрима задана > 0 в админке.