nakama/EMPTY_SCREEN_FIX.md

Исправление: Пустой экран после верификации

🔴 Проблема

После успешной верификации UI открывается, но моментально пропадает (полностью пустой экран).

---

✅ Что исправлено

1. Улучшена обработка ошибок

• Добавлено подробное логирование в консоль браузера
• Теперь видно, на каком этапе происходит ошибка

2. Исправлен пустой экран

• Вместо return null теперь показывается сообщение с кнопкой перезагрузки
• Это помогает понять, что происходит

3. Отложен запуск initDataChecker

• initDataChecker теперь запускается только после успешной загрузки пользователя
• Это предотвращает преждевременную перезагрузку страницы

4. Улучшена валидация данных

• Проверяется, что userData действительно получен
• Если null или undefined - показывается ошибка

---

🔍 Как диагностировать

Шаг 1: Откройте консоль браузера

1. В Telegram откройте приложение
2. Нажмите F12 или Cmd+Option+I (Mac)
3. Перейдите на вкладку Console

Шаг 2: Посмотрите логи

Должны увидеть:

[App] Начало инициализации...
[App] Telegram WebApp найден, initData: есть
[API] verifyAuth: отправка запроса...
[API] verifyAuth: получен ответ: { hasUser: true, userId: "...", username: "..." }
[App] verifyAuth вернул: данные пользователя
[App] Пользователь установлен, ID: ...
[App] Инициализация завершена, loading: false

Если видите ошибку:

[API] verifyAuth: ошибка: { message: "...", status: 401/500 }
[App] Ошибка инициализации: ...

---

🐛 Возможные причины

1. Ошибка 401 (Unauthorized)

Причина: initData невалиден или истек

Решение:

• Перезагрузите приложение в Telegram
• Убедитесь, что используете официальный клиент Telegram

2. Ошибка 500 (Server Error)

Причина: Проблема на backend

Решение:

# Проверьте логи backend
docker logs nakama-backend --tail 100

# Ищите ошибки:
# - "Ошибка verify"
# - "MongoDB connection"
# - "MinIO connection"

3. userData = null/undefined

Причина: Backend не вернул данные пользователя

Решение:

• Проверьте маршрут /api/auth/verify на backend
• Убедитесь, что пользователь существует в БД
• Проверьте, что respondWithUser работает правильно

4. Ошибка в компонентах Feed/Layout

Причина: Компонент падает при рендеринге

Решение:

• В консоли браузера будет красная ошибка с указанием файла и строки
• Проверьте, что все данные пользователя присутствуют (user.settings, user.photoUrl, etc.)

---

🔧 Быстрое решение

1. Перезагрузите приложение

// В консоли браузера
window.location.reload()

2. Проверьте backend

# Проверьте, что backend работает
curl http://your-backend-url/api/health

# Проверьте логи
docker logs nakama-backend -f

3. Проверьте MongoDB

# Подключитесь к MongoDB
docker exec -it nakama-mongodb mongosh

# Проверьте пользователей
use nakama
db.users.find().limit(5)

---

📋 Контрольный список

• Консоль браузера открыта (F12)
• Видны логи [App] и [API]
• Нет красных ошибок в консоли
• Backend доступен (/api/health)
• MongoDB подключена
• Пользователь существует в БД
• initData валиден (не истек)

---

💡 Если все еще не работает

Отправьте мне:

1. Логи из консоли браузера (скопируйте все сообщения)
2. Логи backend (docker logs nakama-backend --tail 200)
3. Скриншот пустого экрана
4. Ошибки из консоли (красные сообщения)

---

✅ После исправления

После применения исправлений вы должны видеть:

• ✅ Логи в консоли на каждом этапе
• ✅ Сообщение об ошибке вместо пустого экрана
• ✅ Кнопку "Перезагрузить" если что-то пошло не так

Теперь откройте приложение и посмотрите консоль браузера! 🔍