Skip to content

"Explore With Me" — стильная афиша для планирования досуга и встреч с друзьями. Создавайте события, зовите компанию и открывайте лучшие активности в городе с помощью микросервисов на Java и Spring Boot.

Notifications You must be signed in to change notification settings

1EVILGUN1/java-explore-with-me

Repository files navigation

Explore With Me — Ваш проводник в мир ярких событий

Explore-With-Me Banner

Добро пожаловать в "Explore With Me" — стильное и современное приложение-афишу, которое превращает планирование досуга в увлекательное приключение! Это не просто инструмент для поиска мероприятий, а настоящий помощник, который вдохновляет на новые впечатления, объединяет друзей и делает каждую встречу незабываемой.


О проекте

"Explore With Me" — это идеальное решение для тех, кто хочет разнообразить свой отдых и проводить время с близкими. Будь то поход на выставку, вечер в кинотеатре или спонтанный пикник в парке, наше приложение поможет вам организовать всё быстро и с удовольствием. Мы создали его, чтобы вы могли легко находить интересные события, собирать компанию и наслаждаться каждым моментом.

Проект родился как практическая задача для команды из 5 разработчиков, но превратился в нечто большее — полноценное приложение с амбициями стать вашим верным спутником в мире событий. Мы вложили душу в проработку микросервисной архитектуры и современных технологий, чтобы вы получили удобный и надежный инструмент.

Чем мы гордимся?

  • Создание событий с WOW-эффектом: Укажите дату, место и тип мероприятия — и ваше событие готово к покорению сердец!
  • Приглашения в два клика: Выбирайте друзей из списка контактов и зовите их с собой — просто и элегантно.
  • Синхронизация с жизнью: Интеграция с календарями покажет, кто из друзей свободен, чтобы присоединиться.
  • Афиша мечты: Откройте для себя лучшие события города, добавляйте их в свои планы и делитесь находками с друзьями.

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

  • main-service — сердце приложения, где живёт вся основная логика.
  • stat-service — умный аналитик, собирающий статистику ваших действий.
  • папка postman — сокровищница с тестами API для проверки магии в деле.

Технологии, которые нас вдохновляют

  • Java 21 — мощь и современность.
  • Spring Boot 3.3.2 — элегантность и скорость разработки.
  • Maven — порядок в зависимостях.
  • PostgreSQL — надежность данных.
  • Docker — магия контейнеров для лёгкого запуска.

Как запустить Explore With Me?

Мы сделали всё, чтобы вы могли запустить приложение без лишних хлопот. Следуйте этим шагам, и уже через несколько минут вы будете планировать своё первое событие!

Что вам понадобится

  • Docker: Для магии контейнеров.
  • JDK 21: Чтобы код ожил.
  • Maven: Для сборки нашего проекта.

Пошаговая инструкция

  1. Соберите проект с любовью

    • Откройте корневую папку проекта в терминале.
    • Введите команду:
      mvn clean install
      Это создаст готовые модули main-service и stat-service.
  2. Запустите волшебство с Docker

    • Убедитесь, что Docker готов к работе.
    • Выполните:
      docker-compose up -d
      Сервисы запустятся в фоновом режиме, как по мановению волшебной палочки!

Порты для доступа

  • stats-server: 9090 — статистика в ваших руках.
  • stats-db: 5432 — база данных статистики.
  • ewm-service: 8080 — главный сервис приложения.
  • ewm-db: 5433 — база данных событий.

Ключевые эндпоинты API

Вот где начинается магия:

  • /admin/categories — управление категориями (для админов).
  • /categories — просмотр категорий.
  • /admin/compilations — создание подборок событий (админ).
  • /compilations — вдохновение из подборок.
  • /admin/events — управление событиями (админ).
  • /events — афиша всех возможностей.
  • /users/{userId}/events — ваши личные события.
  • /users/{userId}/requests — ваши запросы.
  • /users/{userId} — всё о пользователе.
  • /admin/users — управление пользователями (админ).

Для тестирования используйте коллекцию Postman из папки postman — это ваш ключ к проверке API!


Что ждёт нас впереди?

"Explore With Me" — это только начало. У нас есть грандиозные планы, чтобы сделать приложение ещё круче:

  • Скорость на максимум: Оптимизируем SQL-запросы в stat-service с индексами, чтобы всё летало даже при миллионах событий.
  • Голос народа: Добавим комментарии и рейтинги в main-service, чтобы вы могли делиться впечатлениями и выбирать лучшее.
  • Социальная магия: Подключим шаринг через API соцсетей (Telegram, VK) — зовите друзей одним касанием!
  • В кармане: Разработаем мобильное приложение на React Native, чтобы "Explore With Me" был с вами везде.

"Explore With Me" — это больше, чем приложение. Это ваш билет в мир ярких событий, дружеских встреч и незабываемых эмоций. Запускайте, исследуйте, вдохновляйтесь — и делитесь с нами своими идеями, чтобы мы стали ещё лучше!

About

"Explore With Me" — стильная афиша для планирования досуга и встреч с друзьями. Создавайте события, зовите компанию и открывайте лучшие активности в городе с помощью микросервисов на Java и Spring Boot.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published