Какие слои стоит добавлять в дефолтную структуру Laravel-проекта (роуты/контроллеры/модели)?

Стандартная структура Laravel (Routes → Controllers → Models) подходит для небольших проектов, но для enterprise-приложений требуется дополнительное разделение ответственности.

Рекомендуемые слои архитектуры

1. Маршруты (Routes)

• Определяют endpoints API или веб-страниц

• Должны быть максимально простыми

// routes/api.php
Route::apiResource('users', UserController::class);
Route::post('users/{user}/activate', [UserController::class, 'activate']);

2. Контроллеры (Controllers)

• Принимают запросы и возвращают ответы

• Должны быть "тонкими" без бизнес-логики

class UserController extends Controller {
    public function __construct(
        private UserService $userService
    ) {}
    
    public function store(CreateUserRequest $request) {
        $user = $this->userService->createUser($request->validated());
        return new UserResource($user);
    }
}

3. Form Request

• Валидация входящих данных

• Авторизация запросов

4. Сервисный слой (Services)

• Содержит бизнес-логику приложения

• Координирует работу между различными компонентами

5. Репозитории (Repositories)

• Абстракция для работы с данными

• Инкапсулируют запросы к базе данных

6. Модели (Models)

• Представляют бизнес-сущности

• Содержат отношения и базовые scopes

7. DTO (Data Transfer Objects)

• Объекты для передачи данных между слоями

• Обеспечивают типизованные данные

Пример структуры

app/
├── Http/
│   ├── Controllers/
│   └── Requests/
├── Services/
├── Repositories/
├── DTO/
└── Models/

Вывод

Добавление сервисного слоя и репозиториев к стандартной структуре Laravel создает более поддерживаемую и тестируемую архитектуру, особенно для сложных приложений с насыщенной бизнес-логикой.