ShareIt

ShareIt — учебный сервис для шеринга вещей: пользователи добавляют вещи, ищут доступные, бронируют на даты и оставляют комментарии после аренды.

Возможности

Реализовано

• CRUD пользователей
• CRUD вещей
• Поиск доступных вещей по тексту
• Бронирования вещей:
  • создание бронирования
  • подтверждение/отклонение владельцем
  • просмотр бронирования
  • списки бронирований (для арендатора и владельца) с фильтрами по состоянию
• Комментарии к вещам (после завершённой аренды)

Архитектура

Слои приложения:

• Controller: REST API
• Service: бизнес-логика
• Repository: Spring Data JPA (PostgreSQL / H2 для тестов)

Обработка ошибок централизована через @RestControllerAdvice.

REST API

Для методов, работающих от имени пользователя, используется заголовок:

• X-Sharer-User-Id: <userId>

Ниже перечислены основные endpoints текущей версии.

Пользователи: /users

Метод	Endpoint	Описание
POST	/users	Создать пользователя
PATCH	/users/{userId}	Обновить пользователя (частично)
GET	/users/{userId}	Получить пользователя по id
GET	/users	Получить список пользователей
DELETE	/users/{userId}	Удалить пользователя

Вещи: /items

Метод	Endpoint	Описание
POST	/items	Создать вещь
PATCH	/items/{itemId}	Обновить вещь (только владелец)
GET	/items/{itemId}	Получить вещь по id (с комментариями; для владельца — с last/next booking)
GET	/items	Получить вещи владельца (с last/next booking и комментариями)
GET	/items/search?text=...	Поиск доступных вещей
POST	/items/{itemId}/comment	Добавить комментарий к вещи

Бронирования: /bookings

Метод	Endpoint	Описание
POST	/bookings	Создать бронирование
PATCH	/bookings/{bookingId}?approved={true|false}	Подтвердить/отклонить бронирование (только владелец)
GET	/bookings/{bookingId}	Получить бронирование (владелец или автор)
GET	/bookings?state={state}	Список бронирований текущего пользователя (арендатора)
GET	/bookings/owner?state={state}	Список бронирований для вещей текущего пользователя (владельца)

state — фильтр по состоянию бронирования:

• ALL (по умолчанию) — все бронирования
• CURRENT — текущие (start <= now <= end)
• PAST — завершённые (end < now)
• FUTURE — будущие (start > now)
• WAITING — ожидают подтверждения владельцем
• REJECTED — отклонены владельцем

Технологии

• Java 21
• Spring Boot
• Spring Data JPA (Hibernate)
• PostgreSQL (основная БД)
• H2 (тестовая БД)
• Maven
• Lombok
• Jakarta Validation
• JUnit 5, Spring Boot Test, MockMvc

Как запустить

Требования

• JDK 21
• Maven 3.9+
• PostgreSQL 14+

Подготовка PostgreSQL

По умолчанию приложение ожидает настройки из src/main/resources/application.properties:

• URL: jdbc:postgresql://localhost:5432/shareit
• user: shareit
• password: shareit

База данных поднимается через Docker Compose (см. compose.yaml).

Запуск PostgreSQL:

docker compose up -d

Проверка, что PostgreSQL поднялся:

docker compose ps

Ожидаемое состояние сервиса db:

• статус running
• healthcheck healthy

Посмотреть логи:

docker logs -f shareit-db

Остановка PostgreSQL:

docker compose down

Таблицы создаются автоматически при старте приложения из src/main/resources/schema.sql.

Сборка и тесты

Тесты используют H2 (настройки в src/main/resources/application-test.properties).

mvn test

H2-консоль включена в тестовом профиле:

• если запустить приложение с профилем test, будет доступна по пути /h2-console

Примечание: при mvn test используется H2, но веб-сервер не поднимается, поэтому H2 Console в браузере недоступна.

Пример запуска приложения с профилем test (для доступа к H2 Console):

mvn spring-boot:run -Dspring-boot.run.profiles=test

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

mvn spring-boot:run

Качество кода

Checkstyle (если включён)

mvn checkstyle:check