3D Quiz Game

Описание

Интерактивное веб-приложение-викторина с 3D-графикой, поддержкой мультиязычности, модульной архитектурой и современным стеком технологий. Проект предназначен для обучения, развлечения и демонстрации современных подходов к разработке SPA.

---

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

├── public/         # Статические ресурсы (изображения, шрифты, favicon)
└── src/           # Исходный код приложения
    ├── app/       # Корневые компоненты и конфигурация
    ├── pages/     # Страницы приложения (HomePage, GamePage и др.)
    ├── shared/    # Общие утилиты, константы и типы
    ├── ui/        # Переиспользуемые UI-компоненты
    ├── modules/   # Основные модули приложения
    │   ├── core/  # Базовая функциональность (роутинг, состояние)
    │   └── game/  # Игровая логика и компоненты
    ├── styles/    # Глобальные стили и темы
    ├── api/       # Работа с внешними API
    └── config/    # Конфигурационные файлы

Назначение директорий

Основные директории

• src/pages/ - Компоненты страниц приложения. Каждая страница представляет отдельный маршрут.
• src/shared/ - Общие ресурсы: константы, типы, утилиты и хелперы, используемые во всем приложении.
• src/ui/ - Библиотека переиспользуемых UI-компонентов (кнопки, списки, формы).
• src/modules/ - Функциональные модули приложения, каждый со своей бизнес-логикой.
• src/app/ - Корневая конфигурация приложения, провайдеры и основные настройки.

Вспомогательные директории

• public/ - Статические ресурсы, доступные напрямую через веб-сервер.
• src/styles/ - Глобальные стили, переменные, миксины и темы.
• src/api/ - Сервисы и утилиты для работы с внешними API.
• src/config/ - Конфигурационные файлы (i18n, роутинг, константы окружения).

---

Технологии

• React — UI-библиотека
• React Router — маршрутизация
• Three.js — 3D-графика
• i18next — мультиязычность
• SCSS — стилизация
• Vite — сборка
• ESLint, Stylelint — качество кода
• Husky — git-хуки

---

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

1. Установка зависимостей

   npm install

2. Запуск в режиме разработки

   npm run dev

3. Сборка для продакшена

   npm run build

4. Запуск тестов (если внедрены)

   npm test

---