Where2Play 🎲

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

📋 О проекте

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

Основные возможности

• Для игроков:

  • Поиск и регистрация на игровые события
  • Просмотр предстоящих встреч с фильтрацией по играм, темам и локациям
  • Система отзывов об организаторах
  • Управление профилем пользователя

• Для организаторов:

  • Создание и управление игровыми событиями
  • Настройка параметров встреч (дата, место, количество игроков, игры)
  • Автоматическое управление количеством участников

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

Backend

• Java SE/EE — основной язык разработки
• Spring Framework:
  • Spring Boot — основной фреймворк
  • Spring Web (MVC) — обработка HTTP-запросов
  • Spring Data JPA — работа с БД через ORM
  • Spring Security — аутентификация и авторизация
• Hibernate — JPA-провайдер для работы с базой данных

Frontend

• Thymeleaf — шаблонизатор для Server-Side Rendering
• JavaScript — клиентская логика и AJAX-запросы
• HTML/CSS — разметка и стилизация

База данных

• PostgreSQL 15 — реляционная СУБД
• Схема в 3NF (третья нормальная форма)
• Триггеры и хранимые процедуры на PL/pgSQL

📄 Подробное описание БД: Документация БД (DOCX) Документация БД (PDF)

🚀 Настройка и запуск

Требования

• Java 17+
• Maven 3.6+
• PostgreSQL 15+
• Git

1) Клонирование проекта

git clone https://github.com/RRRaptoRRR/Where2Play_prototype.git
cd Where2Play_prototype

2) Подготовка базы данных (PostgreSQL)

1. Создайте базу данных и пользователя:

CREATE DATABASE where2play;
CREATE USER where2play_user WITH ENCRYPTED PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE where2play TO where2play_user;

2. Запустите SQL-скрипты для инициализации схемы. Все скрипты находятся в файлах Документация БД (DOCX) Документация БД (PDF)

3) Настройка конфигурации приложения

Откройте файл src/main/resources/application.properties и укажите параметры подключения к PostgreSQL:

# PostgreSQL Connection
spring.datasource.url=jdbc:postgresql://localhost:5432/where2play
spring.datasource.username=where2play_user
spring.datasource.password=your_password
spring.datasource.driver-class-name=org.postgresql.Driver

# JPA/Hibernate Configuration
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=false
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
spring.jpa.properties.hibernate.format_sql=true

Альтернатива — переменные окружения:

Можно также переопределить параметры через переменные окружения системы (полезно для разных окружений):

export SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/where2play
export SPRING_DATASOURCE_USERNAME=where2play_user
export SPRING_DATASOURCE_PASSWORD=your_password

4) Сборка проекта

mvn clean install

5) Запуск приложения

mvn spring-boot:run

или запустите через JAR:

java -jar target/where2play-1.0.0.jar

6) Проверка запуска

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

http://localhost:8080