DI a akcie

Fasáda je odporúčaná voľba, nie jediná cesta. Tri rovnocenné vstupné body spúšťajú rovnaký kód:

• Fasáda OpeningHours — najkratší zápis, ktorý používa celá táto dokumentácia.
• Manažér RoundlyConsulting\OpeningHours\OpeningHoursManager — koreň fasády, injektovaný cez konštruktor. Rovnaké API, explicitná závislosť a žiadne statické volania. Je registrovaný ako scoped, takže jedna inštancia (a jedno memo) slúži celému requestu alebo jobu.
• Akcie — jednoúčelové triedy s metódou execute(), ktoré zapojíte do vlastných akcií, jobov a príkazov.

Injektovanie manažéra alebo volanie akcie

use RoundlyConsulting\OpeningHours\Actions\AddExceptionAction;
use RoundlyConsulting\OpeningHours\DataTransferObjects\ExceptionData;
use RoundlyConsulting\OpeningHours\OpeningHoursManager;

final class CloseForHoliday
{
    public function __construct(private OpeningHoursManager $hours) {}

    public function __invoke(Clinic $clinic, string $date): void
    {
        $this->hours->exceptions($clinic)->closed($date, label: 'Holiday');
    }
}

// The raw action — no relation reset, no fake:
app(AddExceptionAction::class)->execute($clinic->openingHoursCalendar(), ExceptionData::make('2026-12-24'));

OpeningHours::fake() vymení okrem fasády aj väzbu v kontajneri, takže sa zaznamená aj manažér injektovaný cez konštruktor a trait vlastníka. Akcia volaná priamo zapisuje naozaj — bez resetu vzťahu a bez fake.

OpeningHoursManager nie je final: vytvorte podtriedu, zaregistrujte ju v kontajneri a zmeníte jeho správanie. Manažér resolvuje akcie pri každom volaní, takže balík rešpektuje aj vašu vlastnú väzbu akcie.

Metóda fasády → akcia

Čítania — for(), calendar(), has(), exceptions()->all(), validate(), definitionData() — vlastnú akciu nemajú. PruneAction a MaterializeIntervalsAction sú @internal: spúšťajte ich cez opening-hours:prune a opening-hours:materialize (alebo MaterializeIntervalsJob), nie z vlastného kódu. AddExceptionAction, RemoveExceptionAction a DeleteCalendarAction prijímajú hlavičku Calendar — vráti ju OpeningHours::calendar($owner).