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

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

LOGO_SETUP.md

@@ -0,0 +1,109 @@
+# Инструкция по настройке логотипов и favicon в Open WebUI
+
+## Проблема: Логотипы не меняются
+
+Open WebUI может использовать скомпилированные статические файлы или кешировать логотипы. Есть несколько способов решения.
+
+## Способ 1: Через Admin Panel (рекомендуется)
+
+Это самый надежный способ, так как настройки сохраняются в базе данных.
+
+1. Откройте Open WebUI: `https://odo.iieasy.ru` или `http://localhost:3001`
+2. Войдите как администратор
+3. Перейдите в **Settings** → **Appearance** (или **Admin** → **Settings** → **Appearance`)
+4. Найдите секцию **Logo** или **Branding**
+5. Загрузите ваши файлы:
+   - **Logo**: `media/logo.png` или `media/logo-light.svg`
+   - **Favicon**: `media/favicon.png` или `media/favicon.ico`
+6. Сохраните изменения
+
+## Способ 2: Через скрипт ребрендинга + перезапуск
+
+1. Убедитесь, что файлы есть в папке `media/`:
+   ```bash
+   ls -la media/logo* media/favicon*
+   ```
+
+2. Запустите скрипт ребрендинга:
+   ```bash
+   cd /home/its/iiEasyWeb
+   sudo ./scripts/rebrand.sh
+   ```
+
+3. **ВАЖНО:** Перезапустите контейнер для применения изменений:
+   ```bash
+   sudo docker compose restart open-webui
+   ```
+
+4. Очистите кеш браузера:
+   - **Chrome/Edge**: `Ctrl+Shift+Delete` → Очистить кеш изображений
+   - **Firefox**: `Ctrl+Shift+Delete` → Кеш
+   - Или используйте режим инкогнито: `Ctrl+Shift+N`
+
+5. Обновите страницу с принудительной перезагрузкой: `Ctrl+F5` или `Ctrl+Shift+R`
+
+## Способ 3: Прямое копирование в контейнер
+
+Если скрипт не работает, скопируйте файлы вручную:
+
+```bash
+# Найдите где находятся favicon файлы
+docker exec open-webui find /app -name "favicon.png" -o -name "favicon.ico" | head -5
+
+# Скопируйте ваши файлы
+docker cp media/favicon.png open-webui:/app/web/build/_app/immutable/favicon.png
+docker cp media/logo.png open-webui:/app/web/build/_app/immutable/logo.png
+
+# Перезапустите контейнер
+docker compose restart open-webui
+```
+
+## Способ 4: Использование монтированного volume
+
+Файлы уже смонтированы в контейнер через volume:
+- `./media:/app/media:ro`
+- `./media:/app/web/static/custom:ro`
+
+Можно использовать эти пути в настройках Open WebUI или скопировать оттуда:
+
+```bash
+# Скопировать из смонтированной папки в нужное место
+docker exec open-webui cp /app/media/logo.png /app/web/build/_app/immutable/logo.png
+docker exec open-webui cp /app/media/favicon.png /app/web/build/_app/immutable/favicon.png
+```
+
+## Проверка
+
+После применения изменений:
+
+1. Откройте браузер в режиме инкогнито
+2. Откройте `https://odo.iieasy.ru` или `http://localhost:3001`
+3. Проверьте favicon во вкладке браузера
+4. Проверьте логотип на странице
+
+## Если ничего не помогает
+
+1. Проверьте в браузере (F12 → Network), какие файлы запрашиваются:
+   - Откройте вкладку Network
+   - Обновите страницу
+   - Найдите запросы к `favicon.*` или `logo.*`
+   - Посмотрите полный URL запроса
+
+2. Найдите эти файлы в контейнере и замените их:
+   ```bash
+   docker exec open-webui find /app -path "*/favicon*" -o -path "*/logo*" | grep -v node_modules
+   ```
+
+3. Используйте Admin Panel Open WebUI - это самый надежный способ.
+
+## Настройка через переменные окружения (если поддерживается)
+
+Некоторые версии Open WebUI поддерживают переменные окружения для логотипов. Добавьте в `docker-compose.yml`:
+
+```yaml
+environment:
+  - CUSTOM_LOGO_URL=/static/custom/logo.png
+  - CUSTOM_FAVICON_URL=/static/custom/favicon.ico
+```
+
+Но лучше использовать Admin Panel, так как настройки сохраняются в базе данных.