create-service

name	create-service
description	Use when creating a small focused service or action object in this Laravel package (no fat services, no static helpers). Covers single-responsibility design, constructor DI, immutable inputs/outputs (DTOs, view models), explicit exceptions, and unit-test scaffolding. Trigger when adding/modifying any class under `src/Support/`, `src/Adapters/`, or any non-controller orchestration class.

Create Service

Pattern per creare un service o action object in Laravel.

Target: Laravel 13.x, PHP 8.3+.

Struttura minima

• input esplicito tramite parametri o DTO
• una responsabilita' chiara
• dipendenze iniettate
• output deterministico o result object semplice

Quando preferire un DTO

• input con molti campi
• validazione/coerenza tra campi
• uso del medesimo payload in piu' layer
• code path sync e async che condividono lo stesso contratto

Quando spezzarlo

• se tocca piu' aggregate indipendenti
• se contiene piu' di un ramo di business maggiore
• se ha codice asincrono e sincrono mescolati