DI a akcie

Fasáda je odporúčaná voľba, nie jediná cesta. Každý zápis je akcia, manažér sprístupňuje každú z nich a fasáda je skratka nad manažérom — tri vstupy, ktoré spúšťajú ten istý kód: fasáda Events (najkratší zápis); RoundlyConsulting\Events\EventsManager — 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 úloh a príkazov:

use RoundlyConsulting\Events\Actions\Events\CancelEventAction;
use RoundlyConsulting\Events\EventsManager;
use RoundlyConsulting\Events\Facades\Events;

// Facade
Events::for($event)->by($organizer)->cancel('Venue flooded');

// Dependency injection: the same API
public function __construct(private EventsManager $events) {}
$this->events->for($event)->by($organizer)->cancel('Venue flooded');

// The raw action (no handle policy check, no fake recording)
app(CancelEventAction::class)->execute($event, actor: $organizer, reason: 'Venue flooded');

// Model traits delegate to the manager
$user->rsvp($event)->going();

Injektovanie manažéra

use Illuminate\Http\Request;
use RoundlyConsulting\Events\EventsManager;
use RoundlyConsulting\Events\Models\Event;
use RoundlyConsulting\Events\Models\Rsvp;

final class JoinEventController
{
    public function __construct(private EventsManager $events) {}

    public function __invoke(Request $request, Event $event): Rsvp
    {
        // by() checks the event policy (rsvp) for the signed-in user
        return $this->events->for($event)->by($request->user())
            ->rsvp($request->user())
            ->going(tier: $request->input('tier'), guests: (int) $request->input('guests', 0));
    }
}

Manažér je bezpečný pod Octane: nedrží kontajner a každú akciu si pri každom volaní vezme z aktuálneho, takže platí väzba, ktorú urobíte vy — alebo sandbox požiadavky.

Volanie akcie

use RoundlyConsulting\Events\Actions\Rsvps\PromoteWaitlistAction;
use RoundlyConsulting\Events\Actions\Venues\GeocodeVenueAction;

// Trusted code (a job, a command): no handle policy check and no fake recording
$promoted = app(PromoteWaitlistAction::class)->execute($event, limit: 5);
app(GeocodeVenueAction::class)->execute($venue, force: true);

Priame volanie akcie preskočí kontrolu policy na handle aj zaznamenanie vo fake. Niekoľko akcií si policy overí samo, keď im odovzdáte aktéra: CreateEventAction (create a to, že organizátor aktéra povoľuje), akcie miest konania (policy miesta konania) a CheckInByCodeAction (skenovanie bez určenia podujatia). Príznak $system pri stavových akciách spustí lifecycle ako systém — to isté robí handle bez by().

Metóda fasády → akcia

49 akcií pre aplikáciu; menné priestory sú relatívne k RoundlyConsulting\Events\Actions:

• Manažér si každú akciu pri každom volaní vezme z kontajnera, takže väzba akcie vo vašej aplikácii platí pre všetky cesty — fasádu, injektovaného manažéra, handle, pod-handle, builder aj trait modelu.
• Events::fake() vymení manažéra za fasádou aj v kontajneri, takže sa podvrhne aj injektovaný EventsManager. Priame volanie akcie sa nezaznamená.
• Stavebné bloky v Actions\Internal — zmeny miest, automatické posúvanie, vypršanie rezervácií, nároky na pripomienky, vydávanie kódov, háčik pri mazaní, výpočet harmonogramu, zápisy spoluorganizátorov a podobne — sú @internal a nie sú súčasťou verejného API.