Hexlet tests and linter status:

My tests and linter status:

SonarQube:

Task Manager — это полнофункциональный REST API для системы управления задачами, разработанный на Spring Boot.

Проект включает в себя следующие основные сущности:

• User — пользователь системы
• Task — задача с возможностью назначения исполнителя и статуса
• TaskStatus — статус задачи
• Label — метки для категории задач

Возможности:

• CRUD операции над сущностями
• Привязка исполнителей, статусов и меток к задачам
• Фильтрация задач по названию, исполнителю, статусу и меткам
• Аутентификация пользователей и защита маршрутов

Технологии

• Java 21
• Spring Boot — (Web, Data JPA, Validation, Security)
• MapStruct - для маппинга данных из одного объекта в другой
• Datafake - библиотека для наполнения БД (продакшен и тестирование)
• H2 Database — Локальная БД
• PostgreSQL — Серверная БД
• JUnit5, MockWebServer, Instansio, JsonUnit— тестирование
• Gradle, GitHub Actions, SonarQube — CI/CD и покрытие
• Sentry — отслеживание ошибок

Установка и запуск локально

1. Клонировать репозиторий:

git [email protected]:sergeycherkasovv/java-project-99.git
cd java-project-99

2. Запустить локально:

make start-prod

3. Открыть в браузере

http://localhost:8080

username: [email protected]
password: qwerty

4. OpenAPI(Swagger) документация

http://localhost:8080/swagger-ui.html

5. Посмотреть доступные команды:

make help

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

java-project-99
├── .github/                          # CI (GitHub Actions)
├── src/
│   ├── main/
│   │   ├── java/hexlet/code/         
│   │   │   ├── component/            # Наполнение БД и ключи
│   │   │   ├── config/               # Конфигурации Spring Security
│   │   │   ├── controller/           # REST контроллеры
│   │   │   ├── exception/            # Кастомные исключения
│   │   │   ├── handler/              # Глобальный обработчик исключений
│   │   │   ├── dto/                  # Классы DTO для передачи данных
│   │   │   ├── mapper/               # Маппинг между DTO и сущностями
│   │   │   ├── model/                # Модели: Task, Label, TaskStatus, User, AuthRequest
│   │   │   ├── repository/           # Репозитории Spring Data
│   │   │   ├── service/              # Сервисы (бизнес-логика)
│   │   │   ├── specification/        # Фильтрация задач
│   │   │   ├── util/                 # Security 
│   │   │   └── AppApplication.java   # Точка входа Spring Boot
│   │   └── resources/
│   │       └── application.yml       # Конфиги Spring
│   └── test/
│       └── java/hexlet/code/         
│           ├── controller/           # Интеграционные тесты
│           └── util/                 # Наполнение БД для тестов
├── build.gradle.kts                  # Gradle сборка (Kotlin DSL)
├── Makefile                          # Команды для сборки, запуска и тестов
└── README.md  

📮 Автор

Разработано в рамках обучения на Hexlet. Автор: sergeycherkasovv

Почта: [email protected]