DI a akcie

Fasáda je odporúčaná voľba, nie jediná cesta. Rovnaký kód spúšťajú tri vstupy: fasáda Tickets (najkratší zápis), manažér RoundlyConsulting\Tickets\TicketsManager — koreň fasády, singleton v kontajneri — injektovaný cez konštruktor (rovnaké API, explicitná závislosť, žiadne statické volania) a akcie (final readonly triedy s jedinou metódou execute(), ktoré skladáte do vlastných akcií, jobov a príkazov):

use RoundlyConsulting\Tickets\Actions\Assignment\AssignTicketAction;
use RoundlyConsulting\Tickets\Facades\Tickets;
use RoundlyConsulting\Tickets\TicketsManager;

// Facade
Tickets::for($ticket)->by($agent)->assign($user);

// Dependency injection: the same API
public function __construct(private TicketsManager $tickets) {}
$this->tickets->for($ticket)->by($agent)->assign($user);

// The raw action
app(AssignTicketAction::class)->execute($ticket, $user, actor: $agent);

Injektovanie manažéra

use Illuminate\Http\Request;
use RoundlyConsulting\Comments\Models\Comment;
use RoundlyConsulting\Tickets\TicketsManager;

final class TicketReplyController
{
    public function __construct(private TicketsManager $tickets) {}

    public function __invoke(Request $request, string $reference): Comment
    {
        return $this->tickets->for($reference)->by($request->user())->reply($request->input('body'));
    }
}

Volanie akcie

use RoundlyConsulting\Tickets\Actions\Merge\MergeTicketsAction;

app(MergeTicketsAction::class)->execute($source, $target, reason: 'duplicate', actor: $agent);

?Model $actor = null, bool $system = false fungujú všade rovnako: null použije prihláseného používateľa (pri tickets.actor.from_auth, na tickets.actor.guard), system: true znamená nikoho. ConvertGuestAction a DeleteCategoryAction berú len $actor — fasáda žiadneho neodovzdá, takže sa pripíšu prihlásenému používateľovi.

Metóda fasády → akcia

Menné priestory sú relatívne k RoundlyConsulting\Tickets\Actions:

• Handly a pod-prístupy si každú akciu berú z kontajnera, takže väzba akcie vo vašej aplikácii platí pre všetky cesty — fasádu, injektovaného manažéra, handle, builder aj metódu modelu.
• Tickets::fake() vymení manažéra aj v kontajneri, takže sa podvrhne aj injektovaný TicketsManager. Priame volanie akcie sa nezaznamená — zaznamenávajú sa len volania manažéra.
• Interné stavebné bloky na fasáde nie sú a nevolajte ich: Internal\AllocateReferenceAction, RecordActivityAction, ApplyAutomationAction, AutoWatchAction, ResolveAuthorRoleAction, ResolveTagsAction, ChangeTicketTagsAction, WriteFieldValuesAction, WriteTicketCommentAction a BumpGuestAccessAction.