oauth-redirect-fix

docs/oauth-setup.md

@@ -1,6 +1,21 @@
 # 🔐 Настройка OAuth Провайдеров
 
-## 🎯 Быстрая настройка для менеджера
+## 🎯 Архитектура OAuth
+
+**Важно понимать разделение:**
+- **Frontend**: `testing.discours.io` - где пользователь нажимает кнопку входа
+- **Backend**: `v3.dscrs.site` - где обрабатывается OAuth логика
+- **Callback URL**: Всегда должен указывать на **backend** (`v3.dscrs.site`)
+
+## 🔄 OAuth Flow (пошагово):
+
+1. Пользователь на `testing.discours.io` нажимает "Войти через GitHub"
+2. Фронтенд редиректит на `v3.dscrs.site/oauth/github` 
+3. Backend редиректит на `github.com` с callback_uri=`v3.dscrs.site/oauth/github/callback`
+4. GitHub после авторизации редиректит на `v3.dscrs.site/oauth/github/callback`
+5. Backend обрабатывает callback и редиректит обратно на `testing.discours.io`
+
+## 🎯 Быстрая настройка
 
 ### 1. Google OAuth
 
@@ -109,6 +124,11 @@ heroku config:set GOOGLE_CLIENT_ID=xxx GOOGLE_CLIENT_SECRET=yyy
 **Ошибка redirect_uri_mismatch:**
 - Проверить точное соответствие URL в настройках провайдера
 - Убедиться что протокол (http/https) совпадает
+- **ВАЖНО**: Callback URL должен указывать на backend (`v3.dscrs.site`), НЕ на frontend (`testing.discours.io`)
+
+**Ошибка "redirect_uri is not associated with this application":**
+- Callback URL в настройках провайдера должен быть `v3.dscrs.site/oauth/{provider}/callback`
+- НЕ указывать frontend URL в настройках провайдера
 
 **VK ошибка "Code challenge method is unsupported":**
 - Это нормально, VK не поддерживает PKCE