Skip to content

nemk0ff/Bookstore

Repository files navigation

Книжный магазин

Данный проект является доработанной версией проекта, разработанного в рамках учебного курса по Java-разработке от ООО "Сенла"

Исходную версию вы можете найти здесь

Для быстрого перехода к инструкции по запуску: нажмите сюда

Для быстрого перехода к инструкции по тестированию: нажмите сюда


Модернизация проекта

В рамках развития проекта была проведена комплексная модернизация архитектуры и инфраструктуры:

Ключевые улучшения:

Миграция на Spring Boot:

  • Переход с классического Spring MVC на Spring Boot 3.4.4 для упрощения конфигурации и ускорения разработки
  • Автоматизация управления зависимостями через Spring Boot Starter POM
  • Встроенный сервер Tomcat (замена standalone Tomcat)

Контейнеризация:

  • Реализация Docker-образа приложения
  • Оркестрация сервисов через docker-compose.yml:
    • Spring Boot приложение
    • MySQL база данных

Документирование API:

  • Интеграция Swagger UI с кастомными настройками:
  • Группировка эндпоинтов по функциональным блокам
  • Примеры запросов/ответов
  • JWT-аутентификация в документации
  • Автогенерация OpenAPI 3.0 спецификации -Визуализация архитектуры

Создание диаграммы компонентов:

ComponentDiagram

🐳 Запуск приложения через Docker

Чтобы поднять контейнер с приложением:

  1. Перейдите в директорию с docker-конфигурацией:

    cd docker/
  2. Запустите сборку и запуск контейнеров:

    docker-compose up --build

Тестирование API

Через Swagger UI:

  • Откройте Swagger в браузере по адресу http://localhost:8080/swagger-ui/index.html#/

  • Используйте встроенный интерфейс для отправки запросов

  • Для авторизованных запросов:

    • Нажмите кнопку "Authorize"
    • Введите токен (если требуется)

Через Postman:

  • Скачайте коллекцию

  • Импортируйте в Postman (File → Import)

  • При необходимости обновите токены авторизации

Releases

No releases published

Packages

 
 
 

Contributors

Languages