Files
softclick-landing/.agents/skills/FILES-OVERVIEW.md
2026-04-02 23:35:06 +03:00

8.7 KiB
Raw Blame History

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

Обновление структуры: документы по деплою перенесены в 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

Дополнительная информация:

  1. DEPLOYMENT.md - Полная инструкция по всем платформам
  2. DEPLOY-QUICK.md - Быстрая шпаргалка
  3. PLATFORMS.md - Детальное сравнение платформ
  4. DEPLOYMENT-CHECKLIST.md - Чеклист для деплоя

История изменений:

  1. LATEST-FIXES.md - Последние исправления (Node.js v18)
  2. FIXES-SUMMARY.md - Полная сводка всех исправлений

Специфичные платформы:

  1. deploy-yandex-cloud.md - Яндекс.Облако
  2. 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

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 дизайн
  • ✅ Российские аналоги зарубежных решений
  • ✅ Минималистичный дизайн без фотографий

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


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