BrainSpark - Документация проекта

Обзор проекта

BrainSpark - это инновационное веб-приложение для тренировки мозга, основанное на японской методике профессора Рюты Кавасимы. Приложение помогает развивать когнитивные способности через ежедневные математические упражнения и еженедельные тесты, направленные на активацию префронтальной коры мозга.

Ключевые особенности

• 🚀 Ежедневные математические тренировки - арифметические задачи на скорость
• 📊 Еженедельные когнитивные тесты - счет, память слов, тест Струпа
• 📈 Отслеживание прогресса - детальная статистика и визуализация результатов
• ⚙️ Настраиваемые параметры - количество задач, персонализация опыта
• 🌍 Многоязычная поддержка - русский и английский языки
• 📱 Адаптивный дизайн - поддержка мобильных и десктопных устройств
• 🔧 Режим отладки - инструменты для разработки и тестирования

Архитектура и технологии

Технологический стек

• Фреймворк: SvelteKit 2.16.0
• Язык: TypeScript 5.0.0
• Система сборки: Vite 6.2.6
• Библиотеки:
  • Chart.js 4.4.9 - для визуализации статистики
  • svelte-i18n 4.0.1 - для интернационализации
• Развертывание: Netlify

Архитектура приложения

src/
├── lib/
│   ├── components/        # Переиспользуемые компоненты
│   │   ├── ActionCard.svelte
│   │   ├── HeroSection.svelte
│   │   ├── NotificationCard.svelte
│   │   ├── drill/         # Компоненты для тренировок
│   │   ├── onboarding/    # Онбординг для новых пользователей
│   │   ├── settings/      # Компоненты настроек
│   │   ├── statistics/    # Компоненты статистики
│   │   └── weekly-tests/  # Еженедельные тесты
│   ├── stores/           # Глобальное управление состоянием
│   ├── i18n/            # Локализация
│   └── utils/           # Вспомогательные функции
└── routes/              # Маршруты приложения
    ├── +layout.svelte   # Корневой макет
    ├── +page.svelte     # Главная страница
    ├── drill/           # Страница тренировок
    ├── settings/        # Страница настроек
    ├── statistics/      # Страница статистики
    └── weekly-test/     # Страница еженедельных тестов

Установка и запуск

Системные требования

• Node.js 16+
• npm или yarn
• Git

Локальная разработка

1. Клонирование репозитория:

   git clone <repository-url>
   cd train-brain-scelte
   

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

   npm install
   

3. Запуск сервера разработки:

   npm run dev
   

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

   npm run build
   

Развертывание на Netlify

1. Подключение репозитория к Netlify
2. Настройка переменных окружения:
   • VITE_DEBUG_MODE_ENABLED = "false" для продакшена
   • VITE_DEBUG_MODE_AUTO = "false" для продакшена
3. Автоматическое развертывание при пуше в main ветку

Настройки приложения

Доступные параметры

• Количество ежедневных задач: 10-100
• Язык интерфейса: Русский/Английский
• Сброс онбординга
• Сброс всех данных прогресса

Сохранение настроек

Настройки сохраняются в localStorage браузера и синхронизируются между сессиями.

Будущие улучшения

Планируемые функции

• Синхронизация между устройствами
• Социальные функции (достижения, лидерборды)
• Расширенная аналитика (персональные рекомендации)
• Экспорт данных в различные форматы
• Темная тема интерфейса

Технические улучшения

• PWA функциональность
• Уведомления о ежедневных тренировках
• Интеграция с внешними сервисами
• API для мобильных приложений

Поддержка и развитие

Команда разработки

Проект создан в рамках VIBE CODE LAB - конкурса для молодых IT-специалистов, фокусирующегося на креативном подходе к разработке и инновационных решениях.

Лицензия

Проект является частной разработкой и предназначен для личного использования и демонстрации навыков разработки.

Контакты

Для вопросов и предложений пишите в Телеграм: @icatok5

Документация обновлена: 28 сентября 2025 Версия проекта: 0.0.1 SvelteKit версии: 2.16.0