_____       _           _      _     _       
  / ____|     (_)         (_)    | |   | |      
 | (___   ___  _  ___  ___ _  ___| |__ | | ___  
  \___ \ / _ \| |/ _ \/ __| |/ _ \ '_ \| |/ _ \ 
  ____) | (_) | | (_) \__ \ |  __/ |_) | | (_) |
 |_____/ \___/| |\___/|___/_|\___|_.__/|_|\___/ 
             _/ |                                
            |__/                                 

🎯 О проекте

Sojmieblo — интерактивное веб-приложение для деформации лиц в реальном времени с эффектами WebGL.

✨ Возможности

• 🎨 Деформация в реальном времени — наводите мышь и смотрите как меняется изображение
• 💾 Сохранение работ — создавайте галерею своих творений
• ⚡ Плавная работа — WebGL ускорение обеспечивает 60 FPS
• 🖼️ Простая загрузка — перетащите файл или вставьте из буфера обмена
• 🎚️ Настраиваемые параметры — регулируйте силу и размер кисти
• 📱 Работает везде — адаптивный дизайн для всех устройств

🚀 Быстрый старт

Локальный запуск

git clone https://github.com/Efidripy/sojmieblo.git
cd sojmieblo
npm install
npm start

Приложение будет доступно по адресу: http://localhost:3000

Проверка bounded smoke:

powershell -NoProfile -ExecutionPolicy Bypass -File .\tests\smoke-home.ps1

Развертывание на сервере

Автоматическая установка:

curl -fsSL https://raw.githubusercontent.com/Efidripy/sojmieblo/main/install.sh | sudo bash

С Nginx reverse proxy:

wget https://raw.githubusercontent.com/Efidripy/sojmieblo/main/deploy_sojmieblo.sh
chmod +x deploy_sojmieblo.sh
sudo ./deploy_sojmieblo.sh

📖 Подробные инструкции по установке и настройке: TECHNICAL.md

📋 Системные требования

• Node.js 18+ (рекомендуется 20.x LTS)
• Браузер с поддержкой WebGL (Chrome, Firefox, Safari, Edge)
• RAM минимум 512MB для работы сервера
• Дисковое пространство зависит от количества сохраненных работ

🎮 Как использовать

1. Загрузите изображение — нажмите кнопку "Загрузить" или перетащите файл
2. Деформируйте — наведите мышь на область и удерживайте кнопку
3. Настройте параметры — используйте колесико мыши для изменения размера кисти
4. Сохраните результат — нажмите кнопку "Сохранить"
5. Просмотрите галерею — все сохраненные работы доступны в боковой панели

Горячие клавиши

• Колесико мыши — изменить размер кисти
• Левый клик — сбросить деформацию
• Ctrl+V — вставить изображение из буфера обмена
• ESC — закрыть модальное окно

⚙️ Конфигурация

Основные настройки приложения находятся в public/config.js:

• Размер кисти: 20-300px (по умолчанию 100px)
• Максимальный размер файла: 30MB
• Сила деформации: настраивается автоматически при удержании

📖 Подробная документация по настройке: TECHNICAL.md

🔧 Управление сервисом

# Проверка статуса
systemctl status sojmieblo

# Просмотр логов
journalctl -u sojmieblo -f

# Перезапуск
systemctl restart sojmieblo

📖 Полное руководство по управлению и troubleshooting: TECHNICAL.md

📖 Документация

• TECHNICAL.md — подробная техническая документация
  • Архитектура и технический стек
  • Конфигурация сервера (Express, Nginx)
  • Инструкции по развертыванию
  • API Reference
  • Troubleshooting и диагностика
  • Performance оптимизация

🤝 Контрибьюция

Приветствуем вклад в проект!

1. Форкните репозиторий
2. Создайте ветку для своей фичи (git checkout -b feature/amazing-feature)
3. Закоммитьте изменения (git commit -m 'Add amazing feature')
4. Запушьте ветку (git push origin feature/amazing-feature)
5. Откройте Pull Request

📄 Лицензия

MIT License — свободно используйте, модифицируйте и распространяйте.

🌟 Авторы

Создано с ❤️ командой Sojmieblo

---

🔗 Полезные ссылки:

• 📖 Техническая документация
• 🐛 Сообщить об ошибке
• 💡 Предложить улучшение