240 lines
8.7 KiB
Markdown
240 lines
8.7 KiB
Markdown
# 📁 Обзор файлов проекта
|
||
|
||
> **Обновление структуры:** документы по деплою перенесены в **`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**! 🚀
|