refactor: chaange figma structure with single package

2026-04-02 23:35:06 +03:00
parent 64ae1d9f5a
commit 1157854f1d
89 changed files with 277 additions and 2333 deletions
--- a/scripts/docs/COMMIT-AND-DEPLOY.md
+++ b/scripts/docs/COMMIT-AND-DEPLOY.md
@@ -0,0 +1,267 @@
+# 🚀 Готово к коммиту и деплою!
+
+## ✅ Все исправления применены
+
+### Что было исправлено:
+
+1. ✅ **Node.js версия зафиксирована на 18 LTS**
+   - Создан `.nvmrc`
+   - Добавлен `engines` в `package.json`
+   - `netlify.toml` уже содержал NODE_VERSION = "18"
+
+2. ✅ **Vite настроен на сборку в папку `build`**
+   - Обновлён `vite.config.ts`: `outDir: 'build'`
+   - `netlify.toml` указывает `publish = "build"`
+
+3. ✅ **Созданы скрипты проверки**
+   - `check-build.sh` (Linux/Mac)
+   - `check-build.bat` (Windows)
+
+4. ✅ **Создан .gitignore**
+   - Исключены node_modules, логи, кеш
+
+5. ✅ **Документация обновлена**
+   - NODE-VERSION-FIX.md
+   - NETLIFY-FIX.md
+   - LATEST-FIXES.md
+   - README.md
+
+---
+
+## 📋 Шаги для деплоя
+
+### Шаг 1: Проверка локально (опционально)
+
+**Убедитесь что используете Node.js 18:**
+```bash
+# Проверить версию
+node -v
+
+# Если не v18.x.x, установите:
+nvm install 18
+nvm use 18
+```
+
+**Запустите проверку сборки:**
+```bash
+# Linux/Mac
+chmod +x check-build.sh
+./check-build.sh
+
+# Windows
+check-build.bat
+```
+
+**Ожидаемый результат:**
+```
+✅ Node.js версия совместима (v18.x.x)
+✅ BUILD OUTPUT: build
+📋 Для Netlify используйте: publish = "build"
+```
+
+---
+
+### Шаг 2: Коммит изменений
+
+```bash
+# Проверьте что изменилось
+git status
+
+# Добавьте все файлы
+git add .
+
+# Закоммитьте с понятным сообщением
+git commit -m "Fix: Pin Node.js to v18 LTS and configure Vite outDir to 'build'"
+
+# Альтернативный вариант (более детальный):
+git commit -m "Fix deployment configuration
+
+- Pin Node.js to v18 LTS (.nvmrc + package.json engines)
+- Update vite.config.ts outDir from 'dist' to 'build'
+- Update check-build scripts with Node version validation
+- Add comprehensive deployment documentation"
+```
+
+---
+
+### Шаг 3: Пуш в GitHub
+
+```bash
+# Запушьте в main (или master) ветку
+git push origin main
+
+# Или если используете master:
+# git push origin master
+```
+
+---
+
+### Шаг 4: Наблюдайте за деплоем в Netlify
+
+После пуша:
+
+1. **Откройте Netlify Dashboard**
+   - Перейдите на https://app.netlify.com
+   - Откройте ваш сайт
+   - Нажмите на **"Deploys"**
+
+2. **Следите за логами**
+   - Должен начаться новый деплой (обычно в течение 10-30 секунд)
+   - Нажмите на последний деплой чтобы открыть логи
+
+3. **Что искать в логах:**
+
+   **✅ Успешная сборка:**
+   ```
+   v18.x.x is already installed.
+   Now using node v18.x.x (npm v9.x.x)
+   ...
+   npm run build
+   ...
+   vite v5.x.x building for production...
+   ✓ built in X.XXs
+   build/assets/index-xxxxx.js
+   
+   Deploy site
+   ────────────────────────────────────────
+   ✓ Deploy is live!
+   
+   Website URL: https://your-site.netlify.app
+   ```
+
+   **❌ Если ошибка:**
+   - Скопируйте полный текст ошибки
+   - См. раздел "Troubleshooting" ниже
+
+---
+
+## 🎉 После успешного деплоя
+
+### Проверьте сайт:
+
+1. **Откройте URL сайта** (из Netlify Dashboard)
+
+2. **Проверьте основной функционал:**
+   - [ ] Главная страница загружается
+   - [ ] Навигация работает (Header меню)
+   - [ ] Переходы между страницами работают
+   - [ ] Стили применяются корректно
+   - [ ] Модальное окно "Обсудить проект" открывается
+   - [ ] Нет ошибок в консоли браузера (F12)
+
+3. **Проверьте на мобильных устройствах:**
+   - [ ] Мобильное меню работает
+   - [ ] Responsive дизайн корректный
+   - [ ] Кнопки кликабельны
+
+---
+
+## 🔍 Troubleshooting
+
+### Проблема 1: "Deploy directory 'build' does not exist"
+
+**Решение:**
+1. Проверьте логи сборки - успешно ли прошёл `npm run build`?
+2. Если сборка падает, найдите строку с ошибкой
+3. Попробуйте очистить кеш Netlify:
+   - Site settings → Build & deploy → Clear cache and retry deploy
+
+### Проблема 2: Всё ещё используется Node.js v22
+
+**Решение:**
+1. Убедитесь что `.nvmrc` закоммичен: `git log --name-only -1`
+2. Проверьте Netlify environment variables:
+   - Site settings → Environment variables
+   - Удалите переменную `NODE_VERSION` если она там есть (пусть используется .nvmrc)
+3. Очистите кеш и retry deploy
+
+### Проблема 3: Build успешен, но 404 или белый экран
+
+**Решение:**
+1. Проверьте что `publish` в netlify.toml правильный: `build`
+2. В Site settings → Build & deploy → Build settings:
+   - Publish directory должна быть: `build`
+3. Проверьте консоль браузера (F12) на наличие ошибок
+
+### Проблема 4: Netlify всё ещё не работает
+
+**Альтернативы:**
+
+#### Cloudflare Pages (рекомендуется)
+```
+1. https://pages.cloudflare.com
+2. Connect GitHub repository
+3. Build command: npm run build
+4. Build output: build
+5. Environment: NODE_VERSION = 18
+```
+
+#### GitHub Pages (уже настроен)
+```
+1. GitHub repo → Settings → Pages
+2. Source: GitHub Actions
+3. Workflow автоматически задеплоится
+```
+
+---
+
+## 📊 Ожидаемое время деплоя
+
+- **Netlify:** ~2-3 минуты
+- **Cloudflare Pages:** ~2-3 минуты
+- **GitHub Pages:** ~3-5 минут
+
+---
+
+## 📖 Дополнительная документация
+
+Если нужна дополнительная помощь:
+
+- **NODE-VERSION-FIX.md** - детали о Node.js версии
+- **NETLIFY-FIX.md** - решение проблем Netlify
+- **LATEST-FIXES.md** - последние изменения
+- **DEPLOYMENT.md** - полная инструкция по всем платформам
+- **DEPLOY-QUICK.md** - быстрая шпаргалка
+
+---
+
+## 🎯 Команды для копирования
+
+```bash
+# Весь процесс одной командой:
+node -v && \
+git add . && \
+git commit -m "Fix: Pin Node.js to v18 LTS and configure build output" && \
+git push origin main && \
+echo "✅ Pushed! Check Netlify Dashboard for deploy status."
+```
+
+---
+
+## ✅ Финальный чеклист
+
+- [x] Node.js 18 зафиксирован (.nvmrc, package.json)
+- [x] vite.config.ts использует outDir: 'build'
+- [x] netlify.toml использует publish: 'build'
+- [x] Скрипты проверки обновлены
+- [x] .gitignore создан
+- [x] Документация обновлена
+- [ ] **ВАШ ШАГ:** `git add .`
+- [ ] **ВАШ ШАГ:** `git commit -m "..."`
+- [ ] **ВАШ ШАГ:** `git push`
+- [ ] **ПРОВЕРКА:** Netlify Deploy успешен
+- [ ] **ПРОВЕРКА:** Сайт работает
+
+---
+
+## 🎊 Поздравляем!
+
+После успешного деплоя ваш сайт SOFTCLICK будет доступен по URL от Netlify.
+
+Вы также можете:
+- Настроить **кастомный домен** (your-company.ru)
+- Настроить **SSL сертификат** (HTTPS) - Netlify делает это автоматически
+- Подключить **аналитику** (Yandex.Metrika, Google Analytics)
+- Настроить **форму обратной связи** с реальной отправкой
+
+**Удачи с проектом!** 🚀
--- a/scripts/docs/DEPLOY-QUICK.md
+++ b/scripts/docs/DEPLOY-QUICK.md
@@ -0,0 +1,124 @@
+# 🚀 Быстрая шпаргалка по деплою
+
+## ⚠️ ВАЖНО: Сначала проверьте сборку!
+
+**Linux/Mac:**
+```bash
+./check-build.sh
+```
+
+**Windows:**
+```cmd
+check-build.bat
+```
+
+Это покажет, создаётся `dist` или `build`. Используйте правильную папку в настройках!
+
+---
+
+## 1️⃣ Netlify (РЕКОМЕНДУЕТСЯ - 2 минуты)
+```
+1. https://netlify.com → Sign up
+2. "Add new site" → "Import from Git"
+3. Выбрать репозиторий → Deploy
+✅ Готово! Автодеплой включен
+
+📝 netlify.toml уже настроен на папку build
+   Если нужно изменить - см. NETLIFY-FIX.md
+```
+
+## 2️⃣ Cloudflare Pages (Очень быстро)
+```
+1. https://pages.cloudflare.com → Sign up
+2. "Create a project" → Подключить Git
+3. Build: npm run build | Output: dist
+✅ Готово!
+```
+
+## 3️⃣ GitHub Pages (100% бесплатно)
+```
+1. Запушить код в GitHub
+2. Settings → Pages → Source: "GitHub Actions"
+✅ Готово! Файл .github/workflows/deploy.yml уже настроен
+```
+
+## 4️⃣ Яндекс.Облако (Российское)
+```bash
+# Установка CLI
+curl -sSL https://storage.yandexcloud.net/yandexcloud-yc/install.sh | bash
+
+# Создание бакета
+yc storage bucket create --name softclick --public-read
+
+# Деплой
+npm run build
+yc storage s3api sync ./dist/ s3://softclick/
+
+✅ Готово! ~100₽/месяц
+```
+
+## 5️⃣ Обычный хостинг (Timeweb, Beget и т.д.)
+```bash
+# Локально:
+npm run build
+
+# Загрузить через FTP содержимое папки dist/
+# Файл .htaccess уже готов
+
+✅ Готово! от 120₽/месяц
+```
+
+---
+
+## ⚡ Супер-быстрая команда (для всех платформ)
+```bash
+npm run build
+```
+Загрузите содержимое папки `dist/` куда угодно!
+
+---
+
+## 🎯 Что выбрать?
+
+- **Нужно быстро и бесплатно?** → Netlify
+- **Нужен супер-быстрый CDN?** → Cloudflare Pages  
+- **100% бесплатно навсегда?** → GitHub Pages
+- **Только российское?** → Яндекс.Облако
+- **Есть свой хостинг?** → FTP + dist/
+
+---
+
+## 📱 Автоматические скрипты
+
+**Linux/Mac:**
+```bash
+`scripts/deploy.sh` (из корня репозитория)
+```
+
+**Windows:**
+```cmd
+deploy.bat
+```
+
+---
+
+## ❓ Проблемы?
+
+1. Не работает `npm run build`?
+   ```bash
+   rm -rf node_modules dist
+   npm install
+   npm run build
+   ```
+
+2. Белый экран после деплоя?
+   - Проверьте что загружены ВСЕ файлы из `dist/`
+   - Проверьте консоль браузера (F12)
+
+3. 404 при переходе на страницы?
+   - Проверьте `.htaccess` (Apache)
+   - На Netlify/Cloudflare это работает автоматически
+
+---
+
+📖 **Полная инструкция:** `DEPLOYMENT.md`
--- a/scripts/docs/DEPLOYMENT-CHECKLIST.md
+++ b/scripts/docs/DEPLOYMENT-CHECKLIST.md
@@ -0,0 +1,152 @@
+# ✅ Чеклист деплоя SOFTCLICK
+
+## Перед деплоем
+
+- [ ] Код работает локально (`npm run dev`)
+- [ ] Сборка успешна (`npm run build`)
+- [ ] Все изменения закоммичены в Git
+- [ ] Выбрана платформа для деплоя
+
+## 📁 Созданные файлы конфигурации
+
+### Для разных платформ:
+- [x] `netlify.toml` - Netlify
+- [x] `.github/workflows/deploy.yml` - GitHub Pages
+- [x] `.github/workflows/deploy-yandex.yml` - Яндекс.Облако
+- [x] `.htaccess` - Apache хостинг
+- [x] `_redirects` - Cloudflare Pages
+- [x] `_headers` - Cloudflare Pages
+- [x] `vercel.json` - Vercel (опционально)
+
+### Скрипты деплоя:
+- [x] `deploy.sh` - Linux/Mac
+- [x] `deploy.bat` - Windows
+
+### Документация:
+- [x] `DEPLOYMENT.md` - Полная инструкция
+- [x] `DEPLOY-QUICK.md` - Быстрая шпаргалка
+- [x] `deploy-yandex-cloud.md` - Яндекс.Облако
+- [x] `deploy-traditional-hosting.md` - Традиционный хостинг
+
+---
+
+## 🎯 Выбор платформы
+
+### Вариант 1: Netlify (РЕКОМЕНДУЕТСЯ)
+- [ ] Зарегистрироваться на netlify.com
+- [ ] Подключить Git-репозиторий
+- [ ] Запустить деплой
+- [ ] Проверить результат
+
+**Время:** ~2 минуты  
+**Автодеплой:** ✅ Да  
+**Стоимость:** Бесплатно
+
+### Вариант 2: Cloudflare Pages
+- [ ] Зарегистрироваться на pages.cloudflare.com
+- [ ] Подключить Git-репозиторий
+- [ ] Build: `npm run build`, Output: `dist`
+- [ ] Запустить деплой
+
+**Время:** ~3 минуты  
+**Автодеплой:** ✅ Да  
+**Стоимость:** Бесплатно
+
+### Вариант 3: GitHub Pages
+- [ ] Код в GitHub репозитории
+- [ ] Settings → Pages → Source: "GitHub Actions"
+- [ ] Готово (workflow уже настроен)
+
+**Время:** ~1 минута  
+**Автодеплой:** ✅ Да  
+**Стоимость:** Бесплатно
+
+### Вариант 4: Яндекс.Облако
+- [ ] Создать аккаунт на cloud.yandex.ru
+- [ ] Установить Yandex Cloud CLI
+- [ ] Создать бакет Object Storage
+- [ ] Настроить публичный доступ
+- [ ] Загрузить файлы
+
+**Время:** ~10 минут  
+**Автодеплой:** ✅ Да (через GitHub Actions)  
+**Стоимость:** ~50-200₽/месяц
+
+### Вариант 5: Традиционный хостинг
+- [ ] Купить хостинг (Timeweb/Beget/Reg.ru)
+- [ ] Получить FTP доступ
+- [ ] Собрать проект: `npm run build`
+- [ ] Загрузить содержимое `dist/` через FTP
+- [ ] Проверить `.htaccess`
+
+**Время:** ~15 минут  
+**Автодеплой:** ❌ Нет (ручная загрузка)  
+**Стоимость:** от 120₽/месяц
+
+---
+
+## 🔍 После деплоя
+
+- [ ] Сайт открывается
+- [ ] Все страницы загружаются
+- [ ] Навигация работает
+- [ ] Стили применяются
+- [ ] Модальные окна открываются
+- [ ] Нет ошибок в консоли (F12)
+- [ ] Мобильная версия работает
+
+---
+
+## 🐛 Устранение проблем
+
+### Белый экран
+- [ ] Проверить консоль браузера (F12)
+- [ ] Убедиться что все файлы загружены
+- [ ] Проверить путь к CSS файлам
+
+### 404 при переходе на страницы
+- [ ] Проверить `.htaccess` (для Apache)
+- [ ] Проверить конфигурацию rewrites
+- [ ] На Netlify/Cloudflare/GitHub Pages должно работать автоматически
+
+### Ошибки сборки
+```bash
+# Очистить и пересобрать
+rm -rf node_modules dist
+npm install
+npm run build
+```
+
+---
+
+## 📊 Сравнение платформ
+
+| Платформа | Сложность | Время | Автодеплой | Российская | Стоимость |
+|-----------|-----------|-------|------------|------------|-----------|
+| Netlify | ⭐ Легко | 2 мин | ✅ | ❌ | Бесплатно |
+| Cloudflare | ⭐ Легко | 3 мин | ✅ | ❌ | Бесплатно |
+| GitHub Pages | ⭐ Легко | 1 мин | ✅ | ❌ | Бесплатно |
+| Яндекс.Облако | ⭐⭐ Средне | 10 мин | ✅ | ✅ | ~100₽/мес |
+| Традиц. хостинг | ⭐⭐⭐ Сложнее | 15 мин | ❌ | ✅ | от 120₽/мес |
+
+---
+
+## 🎉 Готово!
+
+После успешного деплоя:
+- [ ] Сохранить URL сайта
+- [ ] Настроить кастомный домен (если нужно)
+- [ ] Настроить SSL (HTTPS)
+- [ ] Добавить в поисковики (Google/Яндекс)
+
+---
+
+## 📞 Нужна помощь?
+
+1. **Проблемы со сборкой** → Проверьте `npm run build` локально
+2. **Проблемы с деплоем** → Смотрите логи на платформе
+3. **404 ошибки** → Проверьте конфигурацию роутинга
+4. **Стили не загружаются** → Проверьте консоль браузера
+
+📖 Полная документация: `DEPLOYMENT.md`
+⚡ Быстрая шпаргалка: `DEPLOY-QUICK.md`
--- a/scripts/docs/DEPLOYMENT.md
+++ b/scripts/docs/DEPLOYMENT.md
@@ -0,0 +1,164 @@
+# 🚀 Инструкции по деплою SOFTCLICK
+
+Этот документ содержит все способы публикации вашего сайта.
+
+## 🎯 Быстрый старт
+
+### Локальная сборка
+```bash
+# 1. Установите зависимости
+npm install
+
+# 2. Соберите проект
+npm run build
+
+# 3. Папка dist/ (или build/) содержит готовый сайт
+```
+
+**⚠️ Важно:** Vite может создать папку `dist` или `build` в зависимости от конфигурации. Проверьте, какая папка создаётся после `npm run build`.
+
+---
+
+## 📌 Рекомендуемые платформы
+
+### ⭐ 1. Netlify (САМЫЙ ПРОСТОЙ)
+**✅ Плюсы:** Бесплатно, автоматический деплой, HTTPS, CDN  
+**⏱ Время настройки:** 2 минуты
+
+**Инструкция:**
+1. Регистрация: https://netlify.com
+2. "Add new site" → "Import an existing project"
+3. Выберите ваш Git-репозиторий
+4. Netlify автоматически найдет `netlify.toml`
+5. Нажмите "Deploy" - готово! 🎉
+
+**Автоматизация:** При каждом пуше в репозиторий сайт обновляется автоматически.
+
+---
+
+### ⭐ 2. Cloudflare Pages (САМЫЙ БЫСТРЫЙ)
+**✅ Плюсы:** Бесплатно, очень быстрый CDN, неограниченный трафик  
+**⏱ Время настройки:** 3 минуты
+
+**Инструкция:**
+1. Регистрация: https://pages.cloudflare.com
+2. "Create a project" → подключите Git
+3. Настройки:
+   - Build command: `npm run build`
+   - Build output: `dist`
+4. Deploy - готово! 🎉
+
+---
+
+### ⭐ 3. GitHub Pages (100% БЕСПЛАТНО)
+**✅ Плюсы:** Полностью бесплатно навсегда  
+**⏱ Время настройки:** 1 минута
+
+**Инструкция:**
+1. Запушьте код в GitHub
+2. Settings → Pages → Source: "GitHub Actions"
+3. Готово! Автоматический деплой настроен 🎉
+
+**URL:** `https://username.github.io/repository-name`
+
+---
+
+## 🇷🇺 Российские платформы
+
+### 4. Яндекс.Облако (ИМПОРТОЗАМЕЩЕНИЕ)
+**✅ Плюсы:** Российская платформа, Object Storage + CDN  
+**💰 Стоимость:** ~50-200 ₽/месяц  
+**⏱ Время настройки:** 10 минут
+
+**Подробная инструкция:** См. файл `deploy-yandex-cloud.md`
+
+**Быстрая настройка:**
+```bash
+# 1. Установите Yandex Cloud CLI
+curl -sSL https://storage.yandexcloud.net/yandexcloud-yc/install.sh | bash
+
+# 2. Создайте бакет
+yc storage bucket create --name softclick-website --public-read
+
+# 3. Соберите и загрузите
+npm run build
+yc storage s3api sync ./dist/ s3://softclick-website/
+```
+
+---
+
+### 5. Традиционный хостинг
+**Подходит для:** Timeweb, Beget, Reg.ru, HostiMan  
+**💰 Стоимость:** от 120 ₽/месяц  
+
+**Подробная инструкция:** См. файл `deploy-traditional-hosting.md`
+
+**Краткая версия:**
+1. Соберите проект: `npm run build`
+2. Загрузите содержимое папки `dist/` на хостинг через FTP
+3. Файл `.htaccess` уже готов и настроен
+4. Готово! 🎉
+
+---
+
+## 🛠 Автоматизация
+
+### Автоматический деплой при пуше в Git
+
+**GitHub Actions готовы для:**
+- ✅ GitHub Pages → `.github/workflows/deploy.yml`
+- ✅ Яндекс.Облако → `.github/workflows/deploy-yandex.yml`
+
+**Настройка GitHub Actions для Яндекс.Облако:**
+1. Создайте сервисный аккаунт в Yandex Cloud
+2. Добавьте секреты в GitHub:
+   - `YC_SERVICE_ACCOUNT_KEY_JSON` - ключ сервисного аккаунта
+   - `YC_BUCKET_NAME` - название бакета
+3. При пуше в main автоматически загрузится на Яндекс.Облако
+
+---
+
+## 📋 Сравнительная таблица
+
+| Платформа | Цена | Скорость настройки | Автодеплой | Российская |
+|-----------|------|-------------------|------------|------------|
+| Netlify | Бесплатно | ⚡⚡⚡ 2 мин | ✅ | ❌ |
+| Cloudflare Pages | Бесплатно | ⚡⚡⚡ 3 мин | ✅ | ❌ |
+| GitHub Pages | Бесплатно | ⚡⚡⚡ 1 мин | ✅ | ❌ |
+| Яндекс.Облако | ~100₽/мес | ⚡⚡ 10 мин | ✅ | ✅ |
+| Timeweb/Beget | от 120₽/мес | ⚡ 15 мин | ❌ | ✅ |
+
+---
+
+## 🎯 Рекомендации
+
+**Для быстрого запуска:** Netlify или Cloudflare Pages  
+**Для 100% бесплатно:** GitHub Pages  
+**Для импортозамещения:** Яндекс.Облако  
+**Для полного контроля:** Свой VPS + Nginx
+
+---
+
+## 🆘 Помощь
+
+**Не работает сборка?**
+```bash
+# Очистите кеш и пересоберите
+rm -rf node_modules dist
+npm install
+npm run build
+```
+
+**Проблемы с роутингом?**
+- Проверьте наличие `.htaccess` (Apache) или настройки Nginx
+- На платформах типа Netlify/Cloudflare это работает автоматически
+
+**Белый экран после деплоя?**
+- Проверьте консоль браузера (F12)
+- Убедитесь что загружены все файлы из `dist/`
+
+---
+
+## 📞 Контакты
+
+При возникновении проблем с деплоем - проверьте логи сборки на выбранной платформе.
--- a/scripts/docs/FIXES-SUMMARY.md
+++ b/scripts/docs/FIXES-SUMMARY.md
@@ -0,0 +1,226 @@
+# 📋 Сводка исправлений для деплоя
+
+## 🔧 Последнее обновление: Node.js версия (24.12.2024)
+
+### ❌ Новая проблема
+Netlify использовал Node.js v22.21.1, вызывая проблемы совместимости.
+
+### ✅ Решение
+1. Зафиксирована **Node.js 18 LTS** через:
+   - `.nvmrc` (создан)
+   - `package.json` engines (добавлен)
+   - `netlify.toml` (уже был)
+
+2. Обновлён `vite.config.ts`:
+   - `outDir: 'build'` вместо `'dist'`
+
+3. Обновлены скрипты проверки:
+   - Проверка версии Node.js
+   - Предупреждение о Node.js v22
+
+**Документация:** См. `NODE-VERSION-FIX.md` и `LATEST-FIXES.md`
+
+---
+
+## 🔧 Предыдущие исправления
+
+### 1. Проблема с Netlify
+**Ошибка:** `Deploy directory 'dist' does not exist`
+
+**Причина:** Vite собирает проект в папку `build`, а не `dist`
+
+**Решение:** Обновлён `netlify.toml`:
+```toml
+[build]
+  command = "npm run build"
+  publish = "build"  # Изменено с "dist" на "build"
+```
+
+---
+
+### 2. Добавлены скрипты проверки сборки
+
+**check-build.sh** (Linux/Mac) и **check-build.bat** (Windows)
+
+Эти скрипты:
+- Очищают старые сборки
+- Устанавливают зависимости
+- Собирают проект
+- Показывают, какая папка создана (dist или build)
+- Подсказывают правильные настройки для Netlify
+
+**Использование:**
+```bash
+# Linux/Mac
+chmod +x check-build.sh
+./check-build.sh
+
+# Windows
+check-build.bat
+```
+
+---
+
+### 3. Создан .gitignore
+
+Файл `.gitignore` для исключения:
+- node_modules
+- .env файлов
+- логов
+- кеша
+- системных файлов
+
+---
+
+### 4. Обновлена документация
+
+#### NETLIFY-FIX.md
+Подробное руководство по решению проблем с Netlify:
+- 4 варианта решения
+- Диагностика
+- Проверочный лист
+- Альтернативные платформы
+
+#### README.md
+Добавлен раздел с проверкой сборки перед деплоем
+
+#### DEPLOYMENT.md
+Добавлено предупреждение о возможных разных папках сборки
+
+#### DEPLOY-QUICK.md
+Добавлена информация о проверке сборки
+
+---
+
+## 📁 Новые файлы
+
+```
+/.gitignore                  - Исключения для Git
+/check-build.sh             - Скрипт проверки (Linux/Mac)
+/check-build.bat            - Скрипт проверки (Windows)
+/NETLIFY-FIX.md             - Решение проблем Netlify
+/FIXES-SUMMARY.md           - Этот файл
+/.nvmrc                     - Фиксация Node.js версии
+/NODE-VERSION-FIX.md        - Решение проблем с Node.js версией
+/LATEST-FIXES.md            - Последние исправления
+```
+
+## ✅ Файлы обновлены
+
+```
+/netlify.toml               - publish: "build" вместо "dist"
+/README.md                  - Добавлена секция проверки
+/DEPLOYMENT.md              - Добавлено предупреждение
+/DEPLOY-QUICK.md            - Добавлена информация о проверке
+/vite.config.ts             - outDir: 'build' вместо 'dist'
+/package.json               - Добавлены engines
+```
+
+---
+
+## 🚀 Что делать дальше
+
+### Шаг 1: Закоммитьте изменения
+```bash
+git add .
+git commit -m "Fix: Update deployment configs for build directory"
+git push
+```
+
+### Шаг 2: Деплой на Netlify
+После пуша Netlify автоматически:
+1. Обнаружит новый коммит
+2. Запустит сборку `npm run build`
+3. Найдёт папку `build` (согласно netlify.toml)
+4. Задеплоит сайт
+
+### Шаг 3: Проверка
+После деплоя проверьте:
+- [ ] Сайт открывается
+- [ ] Навигация работает
+- [ ] Стили применяются
+- [ ] Нет ошибок в консоли
+
+---
+
+## 🆘 Если Netlify всё ещё не работает
+
+### Вариант 1: Проверьте настройки Netlify UI
+1. Site settings → Build & deploy → Build settings
+2. Publish directory должна быть: `build`
+3. Если нет - измените вручную
+
+### Вариант 2: Используйте Cloudflare Pages
+Cloudflare лучше определяет настройки автоматически:
+```
+1. https://pages.cloudflare.com
+2. Build: npm run build
+3. Output: build
+```
+
+### Вариант 3: Используйте GitHub Pages
+GitHub Pages workflow уже настроен:
+```
+1. Settings → Pages → Source: "GitHub Actions"
+2. Готово!
+```
+
+---
+
+## 📊 Текущая конфигурация
+
+### Сборка
+- Команда: `npm run build`
+- Output: `build/` (судя по логам Netlify)
+- Конфигурация: `vite.config.ts` (должен создавать dist, но создаёт build)
+
+### Netlify
+- Publish directory: `build`
+- Build command: `npm run build`
+- Node version: 18
+
+### GitHub Pages
+- Workflow: `.github/workflows/deploy.yml`
+- Автоматический деплой: ✅
+
+### Cloudflare Pages
+- Файлы: `_redirects`, `_headers`
+- Build output: `dist` (может потребоваться изменение на `build`)
+
+---
+
+## 🔍 Для разработчиков
+
+### Почему Vite создаёт build вместо dist?
+
+Судя по логам Netlify:
+```
+build/assets/index-Bi1CT-Fn.js   244.81 kB │ gzip: 69.31 kB
+✓ built in 1.93s
+```
+
+Vite явно создаёт папку `build`, хотя в `vite.config.ts` указано `outDir: 'dist'`.
+
+**Возможные причины:**
+1. Конфигурация переопределяется где-то ещё
+2. Netlify использует собственную конфигурацию Vite
+3. Есть конфликт версий
+
+**Решение:**
+- Приняли `build` как output directory
+- Обновили все конфигурации соответственно
+
+---
+
+## ✅ Итог
+
+Все конфигурационные файлы обновлены и готовы к деплою!
+
+**Следующий шаг:**
+```bash
+git add .
+git commit -m "Fix deployment configuration"
+git push
+```
+
+Netlify автоматически задеплоит сайт! 🎉
--- a/scripts/docs/LATEST-FIXES.md
+++ b/scripts/docs/LATEST-FIXES.md
@@ -0,0 +1,230 @@
+# 🔧 Последние исправления (Node.js версия)
+
+## Дата: 24 декабря 2024
+
+## ❌ Проблема
+Netlify использовал Node.js v22.21.1, что вызывало проблемы совместимости с:
+- Vite 5.x
+- Tailwind CSS v4
+- PostCSS
+- TypeScript build tools
+
+## ✅ Решение
+
+### 1. Зафиксирована версия Node.js на 18 LTS
+
+**Создан `.nvmrc`:**
+```
+18
+```
+
+**Обновлён `package.json`:**
+```json
+{
+  "engines": {
+    "node": ">=18.0.0 <22.0.0",
+    "npm": ">=9.0.0"
+  }
+}
+```
+
+**Уже был в `netlify.toml`:**
+```toml
+[build.environment]
+  NODE_VERSION = "18"
+```
+
+### 2. Исправлен output директорий в vite.config.ts
+
+**Было:**
+```typescript
+build: {
+  outDir: 'dist',
+}
+```
+
+**Стало:**
+```typescript
+build: {
+  outDir: 'build',
+}
+```
+
+Теперь Vite создаёт папку `build`, что соответствует настройкам в `netlify.toml`.
+
+### 3. Обновлены скрипты проверки
+
+`check-build.sh` и `check-build.bat` теперь:
+- Проверяют версию Node.js
+- Предупреждают если используется Node.js v22
+- Показывают размер и содержимое build/
+
+---
+
+## 📁 Изменённые файлы
+
+```
+/.nvmrc                    - СОЗДАН (новый)
+/package.json              - ОБНОВЛЁН (добавлен engines)
+/vite.config.ts            - ОБНОВЛЁН (outDir: 'build')
+/check-build.sh            - ОБНОВЛЁН (проверка Node версии)
+/check-build.bat           - ОБНОВЛЁН (проверка Node версии)
+/NODE-VERSION-FIX.md       - СОЗДАН (документация)
+/LATEST-FIXES.md           - СОЗДАН (этот файл)
+/README.md                 - ОБНОВЛЁН (требования Node.js)
+```
+
+---
+
+## 🚀 Что делать дальше
+
+### 1. Закоммитьте все изменения
+```bash
+git status
+git add .
+git commit -m "Fix: Pin Node.js to v18 LTS and set Vite outDir to 'build'"
+git push origin main
+```
+
+### 2. Netlify автоматически начнёт деплой
+
+После пуша Netlify:
+1. Прочитает `.nvmrc` → использует Node.js 18
+2. Установит зависимости с `npm install`
+3. Запустит `npm run build` → Vite создаст папку `build`
+4. Опубликует содержимое `build/` (согласно `netlify.toml`)
+
+### 3. Проверка деплоя
+
+Откройте **Netlify Deploy Logs** и убедитесь что:
+
+```
+✅ v18.x.x is already installed.
+✅ Now using node v18.x.x
+✅ npm run build
+✅ vite v5.x.x building for production...
+✅ build/assets/index-xxxxx.js
+✅ ✓ built in X.XXs
+✅ Deploy successful!
+```
+
+---
+
+## 🔍 Проверка локально (перед коммитом)
+
+Убедитесь что у вас Node.js 18:
+
+```bash
+# Проверить версию Node
+node -v
+
+# Если не 18, установите через nvm
+nvm install 18
+nvm use 18
+
+# Запустите скрипт проверки
+chmod +x check-build.sh
+./check-build.sh
+
+# Должно показать:
+# ✅ Node.js версия совместима (v18.x.x)
+# ✅ BUILD OUTPUT: build
+```
+
+---
+
+## 📊 Сравнение версий Node.js
+
+| Версия | Статус | Совместимость | Рекомендация |
+|--------|--------|---------------|--------------|
+| Node.js 16 | EOL | ⚠️ Устарела | Обновите на 18 |
+| Node.js 18 | LTS ✅ | ✅ Отлично | **Используйте** |
+| Node.js 20 | LTS | ✅ Хорошо | Допустимо |
+| Node.js 22 | Current | ⚠️ Проблемы | Не рекомендуется |
+
+**LTS** = Long Term Support (долгосрочная поддержка)
+
+---
+
+## 🆘 Если деплой всё ещё не работает
+
+### Вариант 1: Очистите кеш Netlify
+
+1. Netlify UI → **Site settings** → **Build & deploy**
+2. Нажмите **"Clear cache and retry deploy"**
+
+### Вариант 2: Проверьте переменные окружения
+
+В Netlify UI:
+1. **Site settings** → **Environment variables**
+2. Убедитесь что `NODE_VERSION` **НЕ** установлена вручную (или равна 18)
+3. Если есть другое значение - удалите его (`.nvmrc` имеет приоритет)
+
+### Вариант 3: Используйте Cloudflare Pages
+
+Cloudflare Pages лучше работает с новыми версиями инструментов:
+
+```
+1. https://pages.cloudflare.com
+2. Подключить GitHub репозиторий
+3. Build command: npm run build
+4. Build output: build
+5. Environment variable: NODE_VERSION = 18
+```
+
+### Вариант 4: Используйте GitHub Pages
+
+Уже настроено автоматически:
+
+```
+1. GitHub repo → Settings → Pages
+2. Source: "GitHub Actions"
+3. Workflow автоматически использует Node 18
+```
+
+---
+
+## ✅ Контрольный список
+
+- [x] Создан `.nvmrc` с версией 18
+- [x] Добавлен `engines` в `package.json`
+- [x] `vite.config.ts` обновлён (outDir: 'build')
+- [x] Скрипты проверки обновлены
+- [x] Документация обновлена
+- [ ] **ВАШ ШАГ:** Закоммитьте изменения
+- [ ] **ВАШ ШАГ:** Запушьте в GitHub
+- [ ] **АВТОМАТИЧЕСКИ:** Netlify запустит деплой
+- [ ] **ПРОВЕРЬТЕ:** Сайт задеплоен успешно
+
+---
+
+## 📖 Дополнительная документация
+
+- **NODE-VERSION-FIX.md** - подробная информация о Node.js версиях
+- **NETLIFY-FIX.md** - решение проблем с Netlify
+- **DEPLOYMENT.md** - полная инструкция по деплою
+- **DEPLOY-QUICK.md** - быстрая шпаргалка
+
+---
+
+## ✨ Ожидаемый результат
+
+После коммита и пуша:
+
+```
+✓ Код запушен в GitHub
+  ↓
+✓ Netlify обнаружил изменения
+  ↓
+✓ Запущен build с Node.js 18
+  ↓
+✓ Vite создал папку build/
+  ↓
+✓ Netlify опубликовал build/
+  ↓
+✓ Сайт доступен: https://your-site.netlify.app
+```
+
+**Время деплоя:** ~2-3 минуты
+
+Удачи! 🚀
--- a/scripts/docs/NETLIFY-FIX.md
+++ b/scripts/docs/NETLIFY-FIX.md
@@ -0,0 +1,195 @@
+# 🔧 Решение проблемы с Netlify Deploy
+
+## Проблема
+```
+Deploy did not succeed: Deploy directory 'dist' does not exist
+```
+
+## Причина
+Vite создаёт папку `build` вместо `dist`, или конфигурация не применяется правильно.
+
+---
+
+## ✅ Решение 1: Обновлён netlify.toml (УЖЕ СДЕЛАНО)
+
+Файл `netlify.toml` обновлён для использования папки `build`:
+
+```toml
+[build]
+  command = "npm run build"
+  publish = "build"
+
+[[redirects]]
+  from = "/*"
+  to = "/index.html"
+  status = 200
+```
+
+**Просто сделайте новый коммит и пуш - должно заработать!**
+
+---
+
+## ✅ Решение 2: Проверка локально
+
+Запустите скрипт проверки:
+
+**Linux/Mac:**
+```bash
+chmod +x check-build.sh
+./check-build.sh
+```
+
+**Windows:**
+```cmd
+check-build.bat
+```
+
+Скрипт покажет, в какую папку собирается проект (dist или build).
+
+---
+
+## ✅ Решение 3: Настройка через Netlify UI
+
+Если проблема сохраняется:
+
+1. Зайдите в **Site settings** → **Build & deploy** → **Build settings**
+2. Измените **Publish directory** на:
+   - `build` (если Vite собирает в build)
+   - `dist` (если Vite собирает в dist)
+3. Сохраните и запустите новый деплой
+
+---
+
+## ✅ Решение 4: Принудительная сборка в dist
+
+Если хотите использовать именно `dist`, убедитесь что `vite.config.ts` правильный:
+
+```typescript
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+  build: {
+    outDir: 'dist',  // Явно указываем dist
+    emptyOutDir: true,
+  },
+});
+```
+
+Затем в `netlify.toml`:
+```toml
+[build]
+  command = "npm run build"
+  publish = "dist"
+```
+
+---
+
+## 🔍 Диагностика
+
+### Проверка логов Netlify
+
+В логах деплоя ищите строки типа:
+```
+build/assets/index-xxxxx.js
+```
+или
+```
+dist/assets/index-xxxxx.js
+```
+
+Это покажет, в какую папку собирается проект.
+
+### Локальная проверка
+
+```bash
+# Очистка
+rm -rf dist build node_modules
+
+# Установка
+npm install
+
+# Сборка
+npm run build
+
+# Проверка результата
+ls -la
+# Должна появиться папка dist или build
+```
+
+---
+
+## 📝 Текущая конфигурация
+
+**netlify.toml** настроен на: `publish = "build"`
+
+Это основано на логах деплоя, где видно:
+```
+build/assets/index-Bi1CT-Fn.js   244.81 kB │ gzip: 69.31 kB
+✓ built in 1.93s
+```
+
+---
+
+## 🚀 Быстрое решение
+
+1. **Закоммитьте изменения:**
+```bash
+git add netlify.toml
+git commit -m "Fix: Update Netlify publish directory to build"
+git push
+```
+
+2. **Netlify автоматически запустит новый деплой**
+
+3. **Готово!** Сайт должен задеплоиться успешно
+
+---
+
+## 🆘 Если всё ещё не работает
+
+### Вариант A: Смените платформу на Cloudflare Pages
+
+Cloudflare Pages лучше определяет конфигурацию автоматически:
+
+1. https://pages.cloudflare.com
+2. Build command: `npm run build`
+3. Build output: попробуйте оба варианта - `dist` или `build`
+
+### Вариант B: Используйте GitHub Pages
+
+GitHub Pages workflow уже настроен в `.github/workflows/deploy.yml`:
+
+1. Settings → Pages → Source: "GitHub Actions"
+2. Готово! Деплой автоматический
+
+---
+
+## 📊 Проверочный лист
+
+- [ ] netlify.toml обновлён (publish = "build")
+- [ ] Закоммичены все изменения
+- [ ] Запушен код в репозиторий
+- [ ] Netlify автоматически запустил новый деплой
+- [ ] Проверены логи деплоя
+- [ ] Сайт открывается успешно
+
+---
+
+## ✅ Ожидаемый результат
+
+После исправления в логах Netlify должно быть:
+
+```
+✓ built in 1.93s
+
+Deploy site
+────────────────────────────────────────────────────────────────
+
+  Deploy successful!
+  
+  Website URL: https://your-site.netlify.app
+```
+
+Удачи! 🚀
--- a/scripts/docs/NODE-VERSION-FIX.md
+++ b/scripts/docs/NODE-VERSION-FIX.md
@@ -0,0 +1,208 @@
+# 🔧 Исправление проблем с версией Node.js
+
+## Проблема
+Netlify использует Node.js v22, которая может быть несовместима с некоторыми пакетами (Vite, Tailwind CSS v4, и др.).
+
+## ✅ Решение (УЖЕ ПРИМЕНЕНО)
+
+Версия Node.js зафиксирована на **18 LTS** следующими способами:
+
+### 1. Файл .nvmrc
+```
+18
+```
+
+### 2. package.json
+```json
+{
+  "engines": {
+    "node": ">=18.0.0 <22.0.0",
+    "npm": ">=9.0.0"
+  }
+}
+```
+
+### 3. netlify.toml
+```toml
+[build.environment]
+  NODE_VERSION = "18"
+```
+
+### 4. vite.config.ts
+Обновлён `outDir` на `build`:
+```typescript
+export default defineConfig({
+  build: {
+    outDir: 'build',  // Изменено с 'dist' на 'build'
+    emptyOutDir: true,
+    sourcemap: false,
+  },
+});
+```
+
+---
+
+## 🚀 Что делать дальше
+
+### Шаг 1: Закоммитьте изменения
+```bash
+git add .
+git commit -m "Fix: Pin Node.js to v18 LTS and update build output to 'build'"
+git push
+```
+
+### Шаг 2: Netlify автоматически запустит деплой
+После пуша Netlify:
+- Использует Node.js v18 (из .nvmrc)
+- Соберёт проект командой `npm run build`
+- Найдёт папку `build` (из vite.config.ts и netlify.toml)
+- Задеплоит сайт
+
+---
+
+## 🔍 Проверка локально
+
+Убедитесь что у вас локально Node.js 18:
+
+```bash
+# Проверить версию
+node -v
+
+# Если используете nvm (рекомендуется)
+nvm install 18
+nvm use 18
+
+# Проверить сборку
+./check-build.sh  # Linux/Mac
+check-build.bat   # Windows
+```
+
+---
+
+## 📊 Почему Node.js 22 вызывает проблемы?
+
+Node.js 22 - это очень новая версия (выпущена в апреле 2024), и многие популярные инструменты ещё не полностью протестированы с ней:
+
+- **Vite 5.x** - стабильно работает на Node 18-20
+- **Tailwind CSS v4** - новая версия, оптимизирована для Node 18+
+- **PostCSS** - лучшая совместимость на Node 18 LTS
+- **TypeScript** - рекомендует Node 18 LTS
+
+**Node.js 18 LTS** (Long Term Support):
+- Поддержка до апреля 2025
+- Максимальная стабильность
+- Совместимость со всеми популярными инструментами
+
+---
+
+## 🆘 Если проблема сохраняется
+
+### 1. Проверьте полные логи Netlify
+
+В Netlify UI зайдите в:
+- **Deploys** → Выберите последний деплой
+- Нажмите на **Deploy log**
+- Найдите строки после "Finished restoring cached build plugins"
+
+### 2. Очистите кеш Netlify
+
+В настройках Netlify:
+1. **Site settings** → **Build & deploy** → **Build settings**
+2. Нажмите **Clear cache and retry deploy**
+
+### 3. Проверьте локальную сборку
+
+```bash
+# Очистите всё
+rm -rf node_modules dist build package-lock.json
+
+# Переустановите зависимости
+npm install
+
+# Соберите
+npm run build
+
+# Проверьте результат
+ls -la build/
+```
+
+Если локально собирается без ошибок, но на Netlify нет - проблема в среде Netlify.
+
+### 4. Альтернативные платформы
+
+Если Netlify продолжает давать ошибки, используйте:
+
+#### Cloudflare Pages (рекомендуется)
+```
+1. https://pages.cloudflare.com
+2. Build: npm run build
+3. Output: build
+4. Node version: 18
+```
+
+#### GitHub Pages
+```
+Settings → Pages → Source: "GitHub Actions"
+(Workflow уже настроен в .github/workflows/deploy.yml)
+```
+
+---
+
+## 📋 Проверочный лист
+
+- [x] Создан `.nvmrc` с версией 18
+- [x] Добавлен `engines` в `package.json`
+- [x] `netlify.toml` указывает `NODE_VERSION = "18"`
+- [x] `vite.config.ts` использует `outDir: 'build'`
+- [x] `netlify.toml` указывает `publish = "build"`
+- [ ] Закоммичены все изменения
+- [ ] Запушен код в GitHub
+- [ ] Netlify запустил новый деплой
+- [ ] Деплой успешен
+
+---
+
+## ✅ Ожидаемый результат
+
+После исправлений в логах Netlify должно быть:
+
+```
+v18.x.x is already installed.
+Now using node v18.x.x (npm v9.x.x)
+...
+npm run build
+...
+vite v5.x.x building for production...
+transforming...
+✓ 1234 modules transformed.
+rendering chunks...
+build/assets/index-xxxxx.js   244.81 kB │ gzip: 69.31 kB
+✓ built in 1.93s
+
+Deploy site
+────────────────────────────────────────
+
+✓ Finished hashing 15 files
+✓ CDN requesting 15 files
+✓ Finished uploading 15 assets
+✓ Deploy is live!
+
+Website URL: https://your-site.netlify.app
+```
+
+---
+
+## 📞 Дополнительная помощь
+
+Если после всех исправлений деплой всё ещё падает:
+
+1. **Скопируйте полный лог** от "Build ready to start" до конца
+2. Найдите строку с ошибкой (обычно красным цветом)
+3. Поищите эту ошибку в интернете или создайте issue
+
+**Полезные ссылки:**
+- Netlify Node.js docs: https://docs.netlify.com/configure-builds/manage-dependencies/#node-js-and-javascript
+- Vite troubleshooting: https://vitejs.dev/guide/troubleshooting.html
+- Node.js LTS releases: https://nodejs.org/en/about/previous-releases
+
+Удачи! 🚀
--- a/scripts/docs/PLATFORMS.md
+++ b/scripts/docs/PLATFORMS.md
@@ -0,0 +1,294 @@
+# 🌐 Подробное сравнение платформ для деплоя
+
+## 🏆 ТОП-3 рекомендации
+
+### 🥇 Netlify - Лучший для начинающих
+
+**✅ Преимущества:**
+- Автоматическое определение фреймворка
+- Встроенный CI/CD
+- Бесплатный SSL сертификат
+- Автоматические превью для pull requests
+- 100 GB трафика/месяц бесплатно
+- Настройка кастомного домена за 1 клик
+
+**❌ Недостатки:**
+- Не российская компания
+- Лимиты на сборки (300 минут/месяц на бесплатном)
+
+**🎯 Идеально для:**
+- Быстрого запуска
+- Прототипов и MVP
+- Автоматического деплоя
+
+**📊 Стоимость:**
+- Free: $0/месяц (достаточно для большинства)
+- Pro: $19/месяц (1000 минут сборки, 400 GB трафика)
+
+---
+
+### 🥈 Cloudflare Pages - Самый быстрый
+
+**✅ Преимущества:**
+- Глобальная CDN сеть
+- НЕОГРАНИЧЕННЫЙ трафик на бесплатном плане
+- Очень высокая скорость загрузки
+- Защита от DDoS атак
+- 500 сборок/месяц
+
+**❌ Недостатки:**
+- Не российская компания
+- Чуть сложнее в настройке чем Netlify
+
+**🎯 Идеально для:**
+- Высоконагруженных сайтов
+- Глобальной аудитории
+- Максимальной скорости
+
+**📊 Стоимость:**
+- Free: $0/месяц (неограниченный трафик!)
+- Платных планов для статических сайтов нет
+
+---
+
+### 🥉 GitHub Pages - Простейший
+
+**✅ Преимущества:**
+- 100% бесплатно навсегда
+- Интеграция с GitHub
+- Автоматический HTTPS
+- Легкая настройка кастомного домена
+- Нет лимитов на сборки
+
+**❌ Недостатки:**
+- Лимит 100 GB трафика/месяц
+- Только публичные репозитории (на бесплатном)
+- Нет серверных функций
+
+**🎯 Идеально для:**
+- Личных проектов
+- Open source проектов
+- Документации
+- Портфолио
+
+**📊 Стоимость:**
+- Free: $0/месяц
+
+---
+
+## 🇷🇺 Российские платформы
+
+### Яндекс.Облако Object Storage + CDN
+
+**✅ Преимущества:**
+- Российская компания
+- Соответствие 152-ФЗ
+- Интеграция с другими сервисами Яндекса
+- Высокая скорость в РФ
+- Можно оплатить картой российского банка
+
+**❌ Недостатки:**
+- Платно (хоть и недорого)
+- Требует больше настройки
+- Нужно самому настраивать CI/CD
+
+**🎯 Идеально для:**
+- Коммерческих проектов в РФ
+- Компаний, требующих импортозамещения
+- Работы с персональными данными
+
+**📊 Стоимость:**
+- Object Storage: ~0.40 ₽/ГБ хранения/месяц
+- CDN трафик: ~0.85 ₽/ГБ
+- Пример: Сайт 50 МБ + 1000 посещений = ~50-100₽/месяц
+
+**🔧 Настройка:**
+- Сложность: Средняя
+- Время: 10-15 минут
+- Требуется: Yandex Cloud CLI
+
+---
+
+### VK Cloud Solutions (Mail.ru Cloud)
+
+**✅ Преимущества:**
+- Российская компания (VK)
+- Object Storage аналогично AWS S3
+- CDN с точками в РФ
+- 152-ФЗ
+
+**❌ Недостатки:**
+- Платно
+- Меньше документации чем у Яндекса
+
+**📊 Стоимость:**
+- Примерно как Яндекс.Облако
+- Есть промо-период с бесплатными ресурсами
+
+---
+
+### Традиционный хостинг (Timeweb, Beget, Reg.ru)
+
+**✅ Преимущества:**
+- Понятный интерфейс
+- Техподдержка на русском
+- Всё в одном месте (домен + хостинг + почта)
+- Можно использовать для других проектов
+
+**❌ Недостатки:**
+- Платно
+- Ручное обновление файлов
+- Нет автоматического деплоя (без настройки)
+
+**📊 Стоимость:**
+- Timeweb: от 169₽/месяц
+- Beget: от 200₽/месяц
+- Reg.ru: от 120₽/месяц
+- HostiMan: от 150₽/месяц
+
+**🔧 Настройка:**
+- Сложность: Легкая (FTP загрузка)
+- Время: 5-10 минут
+- Требуется: FTP клиент (FileZilla)
+
+---
+
+## 📊 Детальное сравнение
+
+| Характеристика | Netlify | Cloudflare | GitHub Pages | Яндекс.Облако | Хостинг |
+|----------------|---------|------------|--------------|---------------|---------|
+| **Цена** | Бесплатно | Бесплатно | Бесплатно | ~100₽/мес | от 120₽/мес |
+| **Трафик** | 100GB | ∞ | 100GB | Pay-as-you-go | ~100GB+ |
+| **SSL** | ✅ Авто | ✅ Авто | ✅ Авто | ✅ (настройка) | ✅ Let's Encrypt |
+| **CDN** | ✅ | ✅✅✅ | ✅ | ✅ (доп. оплата) | ❌/✅ |
+| **Автодеплой** | ✅ | ✅ | ✅ | ✅ (настройка) | ❌ |
+| **Скорость в РФ** | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
+| **Скорость мира** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
+| **Поддержка** | Отличная (EN) | Хорошая (EN) | FAQ | Хорошая (RU) | Отличная (RU) |
+| **152-ФЗ** | ❌ | ❌ | ❌ | ✅ | ✅ |
+| **Сложность** | ⭐ Легко | ⭐ Легко | ⭐ Легко | ⭐⭐ Средне | ⭐⭐ Средне |
+
+---
+
+## 🎯 Рекомендации по выбору
+
+### Выбирайте Netlify если:
+- ✅ Нужен быстрый запуск (2 минуты)
+- ✅ Хотите автоматический деплой
+- ✅ Не важна российская юрисдикция
+- ✅ Трафик до 100 GB/месяц
+
+### Выбирайте Cloudflare Pages если:
+- ✅ Нужна максимальная скорость
+- ✅ Ожидается много трафика
+- ✅ Важна защита от DDoS
+- ✅ Глобальная аудитория
+
+### Выбирайте GitHub Pages если:
+- ✅ Проект на GitHub
+- ✅ Open source
+- ✅ Нужно 100% бесплатно
+- ✅ Простой статический сайт
+
+### Выбирайте Яндекс.Облако если:
+- ✅ Коммерческий проект
+- ✅ Нужна российская платформа
+- ✅ Требуется 152-ФЗ
+- ✅ Работа с ПД граждан РФ
+- ✅ Импортозамещение
+
+### Выбирайте хостинг если:
+- ✅ Уже есть хостинг
+- ✅ Нужна техподдержка на русском
+- ✅ Планируется несколько сайтов
+- ✅ Нужна почта на своем домене
+
+---
+
+## 🚀 Скорость настройки
+
+**Netlify:** 2 минуты
+```
+1. Регистрация (30 сек)
+2. Подключить Git (30 сек)
+3. Деплой (1 мин)
+```
+
+**Cloudflare Pages:** 3 минуты
+```
+1. Регистрация (30 сек)
+2. Подключить Git (1 мин)
+3. Настройка сборки (1 мин)
+4. Деплой (30 сек)
+```
+
+**GitHub Pages:** 1 минута
+```
+1. Код уже на GitHub (0 сек)
+2. Settings → Pages (30 сек)
+3. Выбрать GitHub Actions (30 сек)
+```
+
+**Яндекс.Облако:** 15 минут
+```
+1. Регистрация (2 мин)
+2. Установка CLI (3 мин)
+3. Создание бакета (2 мин)
+4. Настройка доступа (3 мин)
+5. Первый деплой (5 мин)
+```
+
+**Традиционный хостинг:** 20 минут
+```
+1. Покупка хостинга (5 мин)
+2. Получение доступов (5 мин)
+3. Локальная сборка (2 мин)
+4. Загрузка по FTP (5 мин)
+5. Проверка (3 мин)
+```
+
+---
+
+## 💡 Профессиональные советы
+
+### Для стартапов и MVP:
+**Netlify** - начните бесплатно, масштабируйтесь по мере роста
+
+### Для высоконагруженных проектов:
+**Cloudflare Pages** - неограниченный трафик и максимальная скорость
+
+### Для российского бизнеса:
+**Яндекс.Облако** - соответствие законодательству РФ
+
+### Для личных проектов:
+**GitHub Pages** - просто и бесплатно навсегда
+
+### Для корпоративных клиентов:
+**Традиционный хостинг** - полный контроль и поддержка
+
+---
+
+## 🔐 Безопасность и соответствие
+
+| Платформа | HTTPS | 152-ФЗ | GDPR | DDoS защита |
+|-----------|-------|--------|------|-------------|
+| Netlify | ✅ Авто | ❌ | ✅ | ✅ |
+| Cloudflare | ✅ Авто | ❌ | ✅ | ✅✅✅ |
+| GitHub Pages | ✅ Авто | ❌ | ✅ | ✅ |
+| Яндекс.Облако | ✅ | ✅ | ❌ | ✅ (доп.) |
+| Хостинг | ✅ | ✅ | Зависит | Зависит |
+
+---
+
+## 📞 Куда обращаться за помощью
+
+**Netlify:** https://docs.netlify.com  
+**Cloudflare:** https://developers.cloudflare.com/pages  
+**GitHub Pages:** https://docs.github.com/pages  
+**Яндекс.Облако:** https://cloud.yandex.ru/docs  
+**Timeweb:** https://timeweb.com/ru/help  
+**Beget:** https://beget.com/ru/kb  
+
+---
+
+Выбрали платформу? Смотрите `DEPLOYMENT.md` для пошаговых инструкций! 🚀
--- a/scripts/docs/deploy-traditional-hosting.md
+++ b/scripts/docs/deploy-traditional-hosting.md
@@ -0,0 +1,95 @@
+# Деплой на традиционный хостинг
+
+## Для любого хостинга с FTP/SSH доступом
+
+### Шаг 1: Локальная сборка
+```bash
+npm install
+npm run build
+```
+
+### Шаг 2: Загрузка файлов
+После сборки появится папка `dist/` - её содержимое нужно загрузить на хостинг.
+
+**Через FTP:**
+1. Подключитесь к хостингу через FileZilla/WinSCP
+2. Перейдите в папку `public_html` или `www`
+3. Загрузите ВСЁ содержимое папки `dist/` (не саму папку!)
+
+**Через SSH:**
+```bash
+# Соберите локально
+npm run build
+
+# Загрузите через rsync
+rsync -avz --delete dist/ user@your-server.ru:/var/www/html/
+```
+
+### Шаг 3: Настройка .htaccess (для Apache)
+Создайте в корне сайта файл `.htaccess`:
+
+```apache
+<IfModule mod_rewrite.c>
+  RewriteEngine On
+  RewriteBase /
+  RewriteRule ^index\.html$ - [L]
+  RewriteCond %{REQUEST_FILENAME} !-f
+  RewriteCond %{REQUEST_FILENAME} !-d
+  RewriteRule . /index.html [L]
+</IfModule>
+
+# Кеширование статических файлов
+<IfModule mod_expires.c>
+  ExpiresActive On
+  ExpiresByType image/jpg "access plus 1 year"
+  ExpiresByType image/jpeg "access plus 1 year"
+  ExpiresByType image/gif "access plus 1 year"
+  ExpiresByType image/png "access plus 1 year"
+  ExpiresByType image/svg+xml "access plus 1 year"
+  ExpiresByType text/css "access plus 1 month"
+  ExpiresByType application/javascript "access plus 1 month"
+  ExpiresByType text/html "access plus 0 seconds"
+</IfModule>
+
+# Сжатие
+<IfModule mod_deflate.c>
+  AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript
+</IfModule>
+```
+
+### Шаг 4: Настройка для Nginx
+Если на сервере Nginx, добавьте в конфигурацию сайта:
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.ru www.your-domain.ru;
+    root /var/www/html;
+    index index.html;
+
+    # Сжатие
+    gzip on;
+    gzip_types text/plain text/css application/json application/javascript text/xml application/xml;
+
+    # SPA роутинг
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+
+    # Кеширование статики
+    location ~* \.(jpg|jpeg|png|gif|ico|css|js|svg|woff|woff2)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+}
+```
+
+## Рекомендуемые российские хостинги:
+
+1. **Timeweb** - от 169 ₽/мес, отличная поддержка
+2. **Beget** - от 200 ₽/мес, очень стабильный
+3. **Reg.ru** - от 120 ₽/мес, простой интерфейс
+4. **HostiMan** - от 150 ₽/мес
+5. **SpaceWeb** - от 150 ₽/мес
+
+Все эти хостинги поддерживают Node.js и SSH доступ.
--- a/scripts/docs/deploy-yandex-cloud.md
+++ b/scripts/docs/deploy-yandex-cloud.md
@@ -0,0 +1,45 @@
+# Деплой на Яндекс.Облако
+
+## Шаг 1: Подготовка
+1. Зарегистрируйтесь на https://cloud.yandex.ru
+2. Установите Yandex Cloud CLI: https://cloud.yandex.ru/docs/cli/quickstart
+
+## Шаг 2: Создание бакета Object Storage
+```bash
+# Создайте бакет для статического сайта
+yc storage bucket create --name softclick-website --public-read
+
+# Настройте бакет как статический сайт
+yc storage bucket update --name softclick-website \
+  --website-settings '{"index":"index.html","error":"index.html"}'
+```
+
+## Шаг 3: Сборка и загрузка
+```bash
+# Соберите проект
+npm run build
+
+# Загрузите файлы в бакет
+yc storage s3api put-object \
+  --bucket softclick-website \
+  --key dist/ \
+  --body ./dist/
+```
+
+## Шаг 4: Настройка CDN (опционально)
+1. Перейдите в Cloud CDN
+2. Создайте CDN-ресурс
+3. Укажите источник: ваш бакет Object Storage
+4. Настройте кастомный домен
+
+## Автоматизация через GitHub Actions
+Создайте секреты в GitHub:
+- YC_SERVICE_ACCOUNT_KEY_JSON
+- YC_BUCKET_NAME
+
+Деплой будет происходить автоматически при пуше в main.
+
+## Стоимость
+- Object Storage: ~0.40 ₽/ГБ/месяц
+- Трафик CDN: ~0.85 ₽/ГБ
+- Для небольшого сайта: ~50-200 ₽/месяц