Слоистая архитектура

Слоистая (layered) архитектура — самый распространённый способ организации кода в Java-приложениях. Код делится на слои, каждый из которых отвечает за свою область и зависит только от слоя ниже.

Классические три слоя в Spring Boot:

┌─────────────────────────────┐
│  Controller (@RestController) │  ← HTTP: принять запрос, вернуть ответ
├─────────────────────────────┤
│  Service (@Service)          │  ← Бизнес-логика: что нужно сделать
├─────────────────────────────┤
│  Repository (@Repository)    │  ← Работа с данными: как сохранить/получить
└─────────────────────────────┘

Правило зависимостей: Controller знает о Service, Service знает о Repository. Но не наоборот. Repository не должен зависеть от Controller — иначе слои теряют смысл.

@RestController  // HTTP-слой
class UserController {
    private final UserService service;
    UserDto get(@PathVariable Long id) { return service.getUser(id); }
}

@Service         // Бизнес-слой
class UserService {
    private final UserRepository repo;
    UserDto getUser(Long id) { return toDto(repo.findById(id)); }
}

@Repository      // Данные
interface UserRepository extends JpaRepository<User, Long> {}