Add project and deployment instruction (docs/DEPLOYMENT.md)

Co-authored-by: Cursor <cursoragent@cursor.com>

FIX_TRACE_ERROR.md

@@ -0,0 +1,61 @@
+# Исправление ошибки NameError: name 'trace' is not defined
+
+## Проблема
+
+В логах Open WebUI появляется ошибка:
+```
+NameError: name 'trace' is not defined
+```
+
+Эта ошибка может возникать, если скрипт `rebrand.sh` случайно изменил код Python в контейнере.
+
+## Решение
+
+**1. Пересоздайте контейнер Open WebUI:**
+
+```bash
+cd /home/its/iiEasyWeb
+sudo docker compose stop open-webui
+sudo docker compose rm -f open-webui
+sudo docker compose up -d open-webui
+```
+
+Это создаст чистый контейнер без изменений в коде.
+
+**2. Подождите 30-40 секунд** и проверьте статус:
+
+```bash
+sudo docker compose ps open-webui
+```
+
+**3. Проверьте логи на наличие ошибок:**
+
+```bash
+sudo docker compose logs open-webui --tail 50
+```
+
+**4. Если нужно применить ребрендинг:**
+
+После пересоздания контейнера, если нужно применить логотипы, используйте:
+- **Рекомендуется**: Admin Panel Open WebUI (Settings → Appearance → Logo) - это сохраняется в базе данных
+- **Альтернатива**: Запустите обновленный скрипт `rebrand.sh` (он был исправлен и больше не должен ломать код)
+
+## Проверка OAuth
+
+После пересоздания контейнера проверьте OAuth:
+
+1. Убедитесь, что в `.env` правильный slug:
+   ```bash
+   grep OPENID_CONNECT_ISSUER .env
+   ```
+   Должно быть: `OPENID_CONNECT_ISSUER=https://auth.iieasy.ru/application/o/ii-easy-web/`
+
+2. Проверьте endpoint Authentik:
+   ```bash
+   curl https://auth.iieasy.ru/application/o/ii-easy-web/.well-known/openid-configuration
+   ```
+   Должен вернуться JSON, а не HTML "Not Found"
+
+3. Если endpoint возвращает "Not Found", проверьте в Authentik:
+   - Application с slug `ii-easy-web` существует
+   - Redirect URI настроен: `https://odo.iieasy.ru/oauth/oidc/callback`