Employee Management System

Laboratory Work №1: Spring Boot REST API Development

---

О проекте

Данный проект представляет собой реализацию RESTful API для управления базой данных сотрудников. Система построена в соответствии с принципами SOLID и использует многослойную архитектуру, обеспечивающую чистоту и поддерживаемость кода.

---

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

Технология	Описание
Java 17	Язык разработки (LTS)
Spring Boot 3.4.3	Фреймворк для построения API
Maven	Система сборки и управления зависимостями
Lombok	Устранение шаблонного кода
Checkstyle	Контроль стандартов оформления кода

---

Архитектурные слои

Приложение спроектировано с четким разделением ответственности:

• Controller: Точка входа, обработка HTTP-запросов и валидация путей.
• Service: Бизнес-логика, сортировка, фильтрация и обработка данных.
• Repository: Слой хранения данных (реализован In-Memory Storage).
• Mapper: Конвертация между внутренними Entity и внешними DTO.
• DTO: Объекты для безопасной передачи данных через API.

---

API Reference

Метод	URL	Описание
POST	/api/v1/employees	Создание нового сотрудника
GET	/api/v1/employees	Получение полного списка
GET	/api/v1/employees?category={val}	Фильтрация по категории (@RequestParam)
GET	/api/v1/employees/{id}	Поиск сотрудника по ID (@PathVariable)

---

Инструкция по запуску

1. Проверка стиля кода

./mvnw checkstyle:check