feat: setup project

2026-09-05 15:27:53 +05:00
parent ae2a7e1ce9
commit c79681dc59
43 changed files with 2194 additions and 14 deletions
@@ -0,0 +1,49 @@
+# Twitch: чек-лист подключения (нужен к M1)
+
+Бот-аккаунт уже есть. Осталось зарегистрировать приложение и получить токены —
+примерно 10 минут действий, делается один раз.
+
+## 1. Приложение (один раз)
+
+1. На аккаунте, который регистрирует приложение (можно сам бот-аккаунт), включите
+   2FA: twitch.tv → Настройки → Безопасность и конфиденциальность. Без 2FA
+   Twitch не даёт создавать приложения.
+2. Зайти на https://dev.twitch.tv/console под этим аккаунтом → **Register Your Application**:
+   - Name: любое уникальное, например `idle-xboct-bot`
+   - OAuth Redirect URLs: `http://localhost:3000/oauth/callback`
+   - Category: **Chat Bot**
+3. Скопировать **Client ID**, затем Manage → **New Secret** → **Client Secret**
+   (показывается один раз).
+
+## 2. Токен бота — чтение и ответы в чате (M1)
+
+Scope: `chat:read chat:edit`.
+
+- Быстрый способ: https://twitchtokengenerator.com → «Chat Bot / Quick Token» →
+  залогиниться **именно бот-аккаунтом** → получить access token и refresh token.
+- Надёжный способ (когда дойдём до M1): мини-OAuth-скрипт на redirect из п.1.
+
+## 3. Токен стримера — Channel Points (нужен только к M5, спотлайт)
+
+Scope: `channel:read:redemptions`. Получается так же (twitchtokengenerator или свой
+OAuth), но залогиниться нужно **аккаунтом стримера**. EventSub-события выкупа наград
+принимают только пользовательский токен владельца канала — токена бота тут недостаточно.
+
+## 4. Куда положить
+
+Файл `.env` в корне `packages/server/` (в git не попадает — уже в .gitignore):
+
+```env
+TWITCH_CLIENT_ID=...
+TWITCH_CLIENT_SECRET=...
+TWITCH_CHANNEL=имя_канала
+
+TWITCH_BOT_TOKEN=...
+TWITCH_BOT_REFRESH=...
+
+TWITCH_STREAMER_TOKEN=...
+TWITCH_STREAMER_REFRESH=...
+```
+
+Refresh-токены обновляет `RefreshingAuthProvider` из twurple автоматически —
+перелогиниваться вручную не придётся.