# 📁 Обзор файлов проекта

> **Обновление структуры:** документы по деплою перенесены в **`scripts/docs/`**; промпты и гайды для агентов — в **`.agents/skills/`** (этот каталог). Исходный код приложения — в **`src/`**.

## 🚀 НАЧНИТЕ С ЭТОГО ФАЙЛА
**→ START-HERE.md** - Быстрый старт для деплоя на Netlify

---

## 📖 Документация по деплою (в порядке важности)

### Обязательно прочитать:
1. **COMMIT-AND-DEPLOY.md** - Пошаговая инструкция коммита и деплоя
2. **NETLIFY-FIX.md** - Решение проблем с Netlify
3. **NODE-VERSION-FIX.md** - Информация о Node.js v18

### Дополнительная информация:
4. **DEPLOYMENT.md** - Полная инструкция по всем платформам
5. **DEPLOY-QUICK.md** - Быстрая шпаргалка
6. **PLATFORMS.md** - Детальное сравнение платформ
7. **DEPLOYMENT-CHECKLIST.md** - Чеклист для деплоя

### История изменений:
8. **LATEST-FIXES.md** - Последние исправления (Node.js v18)
9. **FIXES-SUMMARY.md** - Полная сводка всех исправлений

### Специфичные платформы:
10. **deploy-yandex-cloud.md** - Яндекс.Облако
11. **deploy-traditional-hosting.md** - Timeweb, Beget, Reg.ru

---

## 🔧 Конфигурационные файлы

### Главные конфигурации:
- **package.json** - Зависимости и скрипты
  - Содержит `engines` для Node.js 18
- **vite.config.ts** - Конфигурация Vite
  - `outDir: 'build'` - выходная папка
- **tsconfig.json** - TypeScript конфигурация

### Деплой конфигурации:
- **.nvmrc** - Фиксация Node.js 18 (для Netlify)
- **netlify.toml** - Настройки Netlify
  - `publish = "build"`
  - `NODE_VERSION = "18"`
- **vercel.json** - Настройки Vercel (опционально)
- **.htaccess** - Для Apache хостинга
- **.gitignore** - Исключения для Git

### Стили и сборка:
- **postcss.config.js** - PostCSS конфигурация
- **tailwind.config.js** - Tailwind CSS v4 конфигурация
- **/styles/globals.css** - Глобальные стили
- **/styles/animations.css** - Анимации

---

## 🛠 Скрипты и утилиты

### Скрипты проверки:
- **check-build.sh** - Проверка сборки (Linux/Mac)
- **check-build.bat** - Проверка сборки (Windows)
  - Проверяют Node.js версию
  - Собирают проект
  - Показывают output директорию

### Скрипты деплоя:
- **deploy.sh** - Полуавтоматический деплой (Linux/Mac)
- **deploy.bat** - Полуавтоматический деплой (Windows)

---

## 📱 Исходный код приложения

### Корневые файлы:
- **App.tsx** - Главный компонент с роутингом
- **main.tsx** - Точка входа приложения
- **index.html** - HTML шаблон

### Компоненты:
- **/components/Header.tsx** - Шапка с навигацией
- **/components/Footer.tsx** - Подвал сайта
- **/components/Hero.tsx** - Hero-секция с метриками
- **/components/About.tsx** - О компании
- **/components/Services.tsx** - Услуги
- **/components/Solutions.tsx** - Решения
- **/components/Cases.tsx** - Кейсы
- **/components/Contact.tsx** - Контакты
- **/components/ContactModal.tsx** - Модальное окно
- **/components/CategoryPage.tsx** - Шаблон страницы категории
- **/components/ui/** - UI компоненты (shadcn/ui)

### Страницы:
- **/pages/HomePage.tsx** - Главная страница
- **/pages/RussianSoftwarePage.tsx** - Российское ПО
- **/pages/RussianHardwarePage.tsx** - Российское оборудование
- **/pages/CloudPage.tsx** - Облачные решения
- **/pages/CybersecurityPage.tsx** - Кибербезопасность
- **/pages/BusinessPage.tsx** - Бизнес-приложения
- **/pages/AISolutionsPage.tsx** - AI решения
- **/pages/CADandGISPage.tsx** - CAD/GIS системы
- **/pages/IndustrialSolutionsPage.tsx** - Промышленные решения
- **/pages/HardwareSolutionsPage.tsx** - Оборудование
- **/pages/GovernmentPage.tsx** - Госсектор
- **/pages/ConsultingPage.tsx** - Консалтинг
- **/pages/IntegrationPage.tsx** - Интеграция
- **/pages/ImplementationPage.tsx** - Внедрение
- **/pages/SupportPage.tsx** - Поддержка
- **/pages/ManagedServicesPage.tsx** - Управляемые услуги
- **/pages/SubscriptionPage.tsx** - Подписки
- **/pages/SpecializedServicesPage.tsx** - Спец. услуги

---

## 🎨 Статические ресурсы

### Public файлы:
- **/public/favicon.svg** - Иконка сайта (буква "S")

---

## 📚 Дополнительные файлы

- **README.md** - Основной README проекта
- **Attributions.md** - Лицензии и атрибуты
- **guidelines/Guidelines.md** - Руководство по разработке

---

## 🗂 Структура проекта

```
/
├── 🚀 START-HERE.md                    ← НАЧНИТЕ ОТСЮДА
├── 📖 Документация по деплою
│   ├── COMMIT-AND-DEPLOY.md
│   ├── NETLIFY-FIX.md
│   ├── NODE-VERSION-FIX.md
│   ├── DEPLOYMENT.md
│   ├── DEPLOY-QUICK.md
│   ├── PLATFORMS.md
│   ├── DEPLOYMENT-CHECKLIST.md
│   ├── LATEST-FIXES.md
│   ├── FIXES-SUMMARY.md
│   ├── deploy-yandex-cloud.md
│   └── deploy-traditional-hosting.md
├── 🔧 Конфигурации
│   ├── .nvmrc
│   ├── .gitignore
│   ├── package.json
│   ├── vite.config.ts
│   ├── tsconfig.json
│   ├── netlify.toml
│   ├── postcss.config.js
│   ├── tailwind.config.js
│   ├── .htaccess
│   └── vercel.json
├── 🛠 Скрипты
│   ├── check-build.sh
│   ├── check-build.bat
│   ├── deploy.sh
│   └── deploy.bat
├── 📱 Исходный код
│   ├── App.tsx
│   ├── main.tsx
│   ├── index.html
│   ├── /components/      (React компоненты)
│   ├── /pages/           (Страницы)
│   ├── /styles/          (Стили)
│   └── /public/          (Статические файлы)
└── 📚 Прочее
    ├── README.md
    ├── Attributions.md
    └── guidelines/
```

---

## 🎯 Какой файл читать?

### Хочу быстро задеплоить на Netlify:
→ **START-HERE.md**

### Netlify выдаёт ошибку:
→ **NETLIFY-FIX.md**

### Проблемы с Node.js версией:
→ **NODE-VERSION-FIX.md**

### Хочу сравнить платформы:
→ **PLATFORMS.md**

### Нужна полная инструкция:
→ **DEPLOYMENT.md**

### Хочу задеплоить на Яндекс.Облако:
→ **deploy-yandex-cloud.md**

### Что было исправлено:
→ **LATEST-FIXES.md** или **FIXES-SUMMARY.md**

---

## 📋 NPM Scripts

```bash
npm run dev      # Запуск dev-сервера (http://localhost:5173)
npm run build    # Сборка для продакшена (→ build/)
npm run preview  # Предпросмотр продакшен-сборки
```

---

## ✨ Особенности проекта

- ✅ **React 18** + **TypeScript**
- ✅ **Vite 5** для быстрой сборки
- ✅ **Tailwind CSS v4** для стилизации
- ✅ **React Router** для навигации
- ✅ **Lucide Icons** для иконок
- ✅ **shadcn/ui** компоненты
- ✅ **Responsive дизайн**
- ✅ **Российские аналоги** зарубежных решений
- ✅ **Минималистичный дизайн** без фотографий

---

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

- Vite: https://vitejs.dev
- React: https://react.dev
- Tailwind CSS: https://tailwindcss.com
- Netlify: https://netlify.com
- Node.js: https://nodejs.org

---

Этот файл создан для быстрой навигации по проекту. Начните с **START-HERE.md**! 🚀