PaveFest

Интерактивное веб-приложение для планирования посещения фестиваля: выбирайте события, стройте удобный маршрут на день и следите за своей программой в одном месте. Приложение работает полностью в браузере и хранит данные пользователя в `localStorage`, поэтому для демо-запуска не нужен отдельный бэкенд или база данных.

• 👤 Аккаунт пользователя

  • Регистрация и вход (демо-аутентификация через localStorage)
  • Профиль с редактированием основных данных
  • Загрузка / ссылка на аватар
  • Экспорт и очистка данных профиля

• 🗓 Список событий фестиваля

  • Предзаполненный каталог событий с категориями (музыка, мастер-классы, кино, еда, искусство, спорт)
  • Фильтрация по категориям и поиск по названию
  • Добавление событий в личный планировщик

• 🧭 Планировщик маршрута

  • Отображение выбранных событий как маршрута на день
  • Несколько сценариев оптимизации (по времени, по популярности, сбалансированный и т.п.)
  • Подсчёт общей длительности и «рейтингов» маршрута
  • Сохранение плана в localStorage для конкретного пользователя

• 🤖 Нейросеть помощник планирования

  • Автоматизация распределния маршрутов
  • Поддержка более 10-15 мероприятий
  • Автподбор самых выгодных мероприятий
  • Сохранения данных в локальном хранилище

• 🎨 Современный UI

  • Светлая/тёмная тема
  • Адаптивная вёрстка (удобно на десктопе и ноутбуке)
  • Компоненты на базе shadcn/ui и Radix UI

• Next.js 14 (App Router)
• React + TypeScript
• Tailwind CSS
• shadcn/ui (UI-компоненты на базе Radix)
• lucide-react (иконки)
• react-hot-toast (уведомления)

• Node.js: версии >= 18 (LTS)
• npm (по умолчанию) или любая другая пакетная система:
  • npm / yarn / pnpm

git clone https://github.com/Spector323/CODE-GUSH

cd CODE-GUSH

Или просто распакуйте архив в папку CODE-GUSH/ и перейдите в неё:

cd CODE-GUSH

npm install
# или
yarn
# или
pnpm install

npm run dev
# или
yarn dev
# или
pnpm dev

После запуска приложение будет доступно по адресу:

• http://localhost:3000

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

Собрать:

npm run build
# или
yarn build
# или
pnpm build

Запустить production-сервер:

npm start
# или
yarn start
# или
pnpm start

По умолчанию сервер также будет доступен по адресу:

• http://localhost:3000

1. Открыть главную страницу
   Перейдите на http://localhost:3000. На главной есть описание сервиса и кнопка перехода к демо.

2. Создать аккаунт

   • В шапке нажмите кнопку авторизации (модальное окно).
   • Выберите регистрацию, заполните поля (Имя, Имя пользователя, Email, Пароль).
   • Данные сохраняются в localStorage вашего браузера.

3. Авторизоваться

   • Переключитесь на режим «Вход».
   • Введите имя пользователя и пароль, которые указали при регистрации.
   • После входа в шапке появится аватар и меню аккаунта.

4. Выбрать события

   • Перейдите на страницу События (/events).
   • Отфильтруйте события по категории или воспользуйтесь поиском.
   • Добавляйте события в планировщик (кнопка добавления/галочка).

5. Построить маршрут

   • Перейдите на страницу Планировщик (/planner).
   • Посмотрите свой текущий маршрут.
   • Переключайте режимы оптимизации (по времени, популярности, балансу и т.д.).
   • Сохранённый план остаётся в браузере до очистки данных.

6. Управление профилем

   • На странице Профиль (/profile) можно:
     • Изменить основные данные (имя, username, email и т.д.).
     • Загрузить аватар.
     • Экспортировать профиль в JSON.
     • Очистить локальные данные.

В package.json доступны стандартные скрипты:

npm run dev      # запуск dev-сервера
npm run build    # production-сборка
npm start        # запуск production-сервера
npm run lint     # проверка кода линтером

• Проект предназначен как демо: логин/регистрация и данные пользователя не защищены и не предназначены для продакшена.
• Все данные хранятся локально в браузере (localStorage), отдельного сервера и БД не требуется.
• Для деплоя на любой хостинг, поддерживающий Next.js, достаточно выполнить npm run build и затем запустить npm start (или настроить адаптированный runtime на выбранной платформе).