📝 Update: документация n8n исключения

✅ Что сделано:
- app/page.tsx: Проверка source/utm_source параметров (n8n, chat, from_n8n)
- app/plans/page.tsx: Аналогичная проверка для 3-step flow
- app/api/create-user/route.ts: Разрешение создания без telegramId если source=n8n

🔓 ИСКЛЮЧЕНИЯ для n8n:
- ?source=n8n
- ?utm_source=n8n
- ?utm_source=chat
- ?from_n8n=true

🎯 ЛОГИКА:
1. Переход через Telegram Mini App → требуется tgUser.id ✅
2. Переход из n8n (прямая ссылка) → НЕ требуется, генерируется временный ID ✅
3. Переход из браузера напрямую → блокируется ❌

💡 Для временных ID используется Date.now() но только если fromN8n=true

TRIAL-USERNAME-FIX.md

@@ -179,3 +179,90 @@ export async function POST(request: NextRequest) {
 3. Нужно переоткрыть через `@Chat_8n8_bot` → "Открыть приложение"
 
 **Теперь система автоматически блокирует такие попытки!** ✅
+
+---
+
+## 🔓 UPDATE: Исключение для n8n переходов (5677b48)
+
+### Проблема после первого фикса:
+
+После блокировки создания без Telegram ID - **перестали работать переходы из n8n**! 
+
+n8n workflow отправляет пользователей по **прямой ссылке** (открывается в браузере), где `window.Telegram?.WebApp` недоступен.
+
+### Решение:
+
+Добавлены **URL параметры-исключения** для n8n переходов:
+
+```typescript
+// Проверяем источник перехода
+const urlParams = new URLSearchParams(window.location.search);
+const source = urlParams.get('source') || urlParams.get('utm_source');
+const fromN8n = source === 'n8n' || source === 'chat' || urlParams.has('from_n8n');
+
+// Блокируем ТОЛЬКО если нет Telegram ID И это НЕ n8n переход
+if (!tgUser?.id && !fromN8n) {
+  showToastNotification('❌ Откройте приложение через Telegram бота');
+  return;
+}
+
+// Для n8n переходов генерируем временный ID
+const userId = tgUser?.id || Date.now();
+```
+
+### Поддерживаемые параметры:
+
+1. `?source=n8n` - рекомендуемый
+2. `?utm_source=n8n` - для аналитики
+3. `?utm_source=chat` - альтернативный вариант
+4. `?from_n8n=true` - явное указание
+
+### Примеры ссылок из n8n:
+
+```
+✅ https://app.umbrix.net/?source=n8n
+✅ https://app.umbrix.net/plans?utm_source=chat
+✅ https://app.umbrix.net/?from_n8n=true&ref=user123
+❌ https://app.umbrix.net/ (без параметров - блокируется)
+```
+
+### Итоговая логика:
+
+| Способ входа | Telegram ID | URL параметры | Результат |
+|-------------|-------------|---------------|-----------|
+| Telegram Mini App | ✅ Есть | Любые | ✅ Создается с реальным ID |
+| n8n workflow | ❌ Нет | `?source=n8n` | ✅ Создается с временным ID |
+| Прямая ссылка | ❌ Нет | Нет параметров | ❌ **БЛОКИРОВКА** |
+
+### Backend поддержка:
+
+```typescript
+// app/api/create-user/route.ts
+const { telegramId, source } = await request.json();
+
+// Разрешаем n8n переходы
+const fromN8n = source === 'n8n' || source === 'chat';
+
+if (!telegramId && !fromN8n) {
+  return NextResponse.json(
+    { success: false, error: 'Telegram ID required' },
+    { status: 400 }
+  );
+}
+```
+
+### Проверка в production:
+
+```bash
+# 1. Переход через n8n (должен работать)
+curl -X POST https://app.umbrix.net/api/create-user \
+  -H "Content-Type: application/json" \
+  -d '{"planType":"trial","source":"n8n"}'
+
+# 2. Переход без параметров (должен блокироваться)
+curl -X POST https://app.umbrix.net/api/create-user \
+  -H "Content-Type: application/json" \
+  -d '{"planType":"trial"}'
+```
+
+**Деплой**: PM2 перезапущен (pid 50711), коммит `5677b48` ✅

app/api/create-user/route.ts

@@ -29,7 +29,8 @@ export async function POST(request: NextRequest) {
       telegramUsername, 
       firstName, 
       lastName, 
-      referrerId 
+      referrerId,
+      source  // Источник перехода (n8n, chat и т.д.)
     } = await request.json();
     
     logger.debug('📥 Received data:', { 
@@ -40,11 +41,15 @@ export async function POST(request: NextRequest) {
       telegramUsername, 
       firstName, 
       lastName, 
-      referrerId 
+      referrerId,
+      source
     });
 
-    // ⚠️ ВАЛИДАЦИЯ: telegramId обязателен!
+    // 🔓 ИСКЛЮЧЕНИЕ: Разрешаем n8n переходы даже без telegramId
-    if (!telegramId) {
+    const fromN8n = source === 'n8n' || source === 'chat';
+
+    // ⚠️ ВАЛИДАЦИЯ: telegramId обязателен (кроме n8n переходов)
+    if (!telegramId && !fromN8n) {
       logger.error('❌ VALIDATION FAILED: No telegramId provided');
       return NextResponse.json(
         { 

app/page.tsx

@@ -213,24 +213,32 @@ export default function Home() {
         fullData: tgUser
       });
 
-      // ⚠️ ВАЖНО: Если Telegram не передал данные - НЕ создаем trial!
+      // 🔓 ИСКЛЮЧЕНИЕ: Разрешаем создание для n8n переходов (когда есть source или utm параметры)
-      if (!tgUser?.id) {
+      const source = urlParams.get('source') || urlParams.get('utm_source');
+      const fromN8n = source === 'n8n' || source === 'chat' || urlParams.has('from_n8n');
+      
+      // ⚠️ ВАЖНО: Если Telegram не передал данные И это не n8n переход - блокируем!
+      if (!tgUser?.id && !fromN8n) {
         console.error('❌ TRIAL BLOCKED: No Telegram user data!');
         showToastNotification('❌ Откройте приложение через Telegram бота');
         setIsLoading(false);
         return;
       }
 
+      // Для n8n переходов генерируем временный ID
+      const userId = tgUser?.id || Date.now();
+
       // Создаем trial подписку через API
       const response = await fetch('/api/create-user', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
           planType: 'trial',
-          telegramId: tgUser.id,  // Теперь 100% есть
+          telegramId: userId,  // Telegram ID или временный для n8n
           telegramUsername: tgUser?.username || undefined,
           firstName: tgUser?.first_name || undefined,
           referrerId: referrerId || undefined,
+          source: fromN8n ? (source || 'n8n') : undefined,  // Помечаем n8n переходы
         }),
       });
 

app/plans/page.tsx

@@ -188,24 +188,33 @@ export default function PlansNew() {
         } : null
       });
 
-      // ⚠️ ВАЖНО: Если Telegram не передал user.id - блокируем создание
+      // 🔓 ИСКЛЮЧЕНИЕ: Проверяем переход из n8n
-      if (!user?.id) {
+      const urlParams = new URLSearchParams(window.location.search);
+      const source = urlParams.get('source') || urlParams.get('utm_source');
+      const fromN8n = source === 'n8n' || source === 'chat' || urlParams.has('from_n8n');
+
+      // ⚠️ ВАЖНО: Если Telegram не передал user.id И это не n8n переход - блокируем
+      if (!user?.id && !fromN8n) {
         console.error('❌ USER CREATION BLOCKED: No Telegram user ID!');
         alert('❌ Откройте приложение через Telegram бота\n\nПриложение должно быть открыто в Telegram Mini App, а не в браузере.');
         setStep('plan');
         setIsCreatingUser(false);
         return;
       }
+
+      // Для n8n переходов генерируем временный ID
+      const userId = user?.id || Date.now();
       
       const requestBody = {
         planType,
         period,
         locationIds,
-        telegramId: user.id,  // Теперь 100% есть
+        telegramId: userId,  // Telegram ID или временный для n8n
         telegramUsername: user?.username || null,
         firstName: user?.first_name || null,
         lastName: user?.last_name || null,
-        referrerId: referrerId || null, // Добавляем referrerId
+        referrerId: referrerId || null,
+        source: fromN8n ? (source || 'n8n') : null,  // Помечаем n8n переходы
       };
       
       console.log('📤 REQUEST BODY:', requestBody);