URL Shortener Service

Сервис для сокращения URL-адресов с возможностью кэширования часто используемых ссылок.

Технологии

• Java 17
• Spring Boot 3.4.3 (Data, Web, JPA, Hibernate)
• Мониторинг: ELK
• NoSQL: Redis
• SQL: PostgreSQL
• Контейнеризация: Docker/Docker Compose
• Документация: Swagger
• Миграции: Liquibase
• Тестирование: JUnit/Mockito/TestContainers

Функциональность

• Создание коротких URL
• Перенаправление по короткому URL на оригинальный адрес
• Кэширование часто используемых URL
• REST API с документацией Swagger
• Веб-интерфейс для создания и мониторинга сокращенных ссылок

Запуск проекта

Предварительные требования

• JDK 17
• Node.js 16+
• Docker и Docker Compose

Быстрый запуск

1. для Windows

.\build-and-run.ps1

2. для Linux/MacOS

.\build-and-run.sh

Пошаговая инструкция для ручного запуска

1. Клонируйте репозиторий:

git clone https://github.com/therealadik/url_shortener_service.git
cd url_shortener_service

2. Соберите backend:

./gradlew clean build -x test

3. Соберите frontend:

cd frontend
npm install
cd ..

4. Запустите все сервисы через Docker Compose:

docker-compose up -d

Доступ к приложению

После запуска всех компонентов:

• Веб-интерфейс: http://localhost
• Swagger UI: http://localhost:8080/swagger-ui.html

Лицензия

Этот проект является открытым исходным кодом и распространяется под лицензией MIT. Вы можете свободно использовать, изменять и распространять код проекта в соответствии с условиями лицензии MIT.