Fasáda Events

Všetko ide cez jednu fasádu, RoundlyConsulting\Events\Facades\Events — skratku nad singletonom EventsManager, bez globálneho aliasu. Miesto konania, kategória, podujatie s dvoma typmi vstupeniek, RSVP, skenovanie pri vstupe a hľadanie v okolí:

use RoundlyConsulting\Events\Facades\Events;
use RoundlyConsulting\Money\Money;

// A reusable venue: its timezone is how every wall-clock time below is read
$venue = Events::venues()->make('Blue Note')
    ->address(street: 'Hlavná 1', city: 'Bratislava', postalCode: '811 01', country: 'SK')
    ->coordinates(48.1439, 17.1097)
    ->timezone('Europe/Bratislava')
    ->create();

Events::categories()->make(['en' => 'Jazz', 'sk' => 'Jazz'])->create();   // categories are curated

$event = Events::make(['en' => 'Jazz Night', 'sk' => 'Jazzový večer'])
    ->description(['en' => 'A live quartet, then an open jam session.'])
    ->organizedBy($user)
    ->at($venue)
    ->startsAt('2026-11-14 20:00')                 // 20:00 in Bratislava, stored as UTC
    ->duration('3 hours')                          // or 'PT3H', a CarbonInterval, or ->endsAt(...)
    ->capacity(120)
    ->category('jazz')
    ->labels(['Live', 'Late night'])
    ->poster($request->file('poster'))
    ->tier('Free entry', key: 'free')
    ->tier('Supporter', price: Money::ofMajor('15', 'EUR'), capacity: 30)   // key "supporter"
    ->publish();

// RSVP: a seat while there is one, the waitlist once it is full
$rsvp = Events::for($event)->rsvp($attendee)->going(tier: 'free');
$rsvp->isGoing();                                   // or isWaitlisted(), isHeld()

// At the door: scan the attendee's QR code, as the signed-in staff member
$result = Events::for($event)->by($doorStaff)->checkIn($scannedCode);   // organizers and co-hosts only
$result->firstCheckIn;                              // false if the code was already used

// Discovery: upcoming published events (cancelled ones flagged by phase) within 25 km, nearest first
Events::browse()->upcoming()->near($here, km: 25)->orderByDistance($here)->paginate();

Metódy manažéra

forgetAttendee(), container() a perform() sú verejné pre vnútorné prepojenie balíka a označené ako @internal — z kódu aplikácie ich nevolajte.

Handle for($event)

Events::for($event) vráti nemenný EventHandle. by($actor) pred každým ďalším volaním overí policy podujatia, asSystem() beží ako dôveryhodný kód a silently() zapisuje bez notifikácií — každá z týchto metód vráti nový handle. Bez by() je volanie dôveryhodným PHP (úloha, seeder, príkaz) a policy sa nepýta. Mutátor vráti handle, takže volania sa dajú reťaziť; metóda, ktorá niečo vytvára alebo číta, vráti svoj výsledok. Naviazané podujatie sa aktualizuje na mieste, takže event() vráti aktuálny stav:

$handle = Events::for($event)->by($organizer);    // checks the policy before every call

$handle->tiers()->add('Crew', hidden: true, key: 'crew');
$handle->hosts()->add($partnerTeam);
$handle->publish()->event();                      // a mutator returns the handle; event() is the bound, current model

Events::for($event)->asSystem()->postpone('Storm warning');          // trusted code: no actor, no policy
Events::for($event)->silently()->reschedule('2026-12-05 20:00');     // domain events still fire, no notices

$handle = Events::for($event);

$handle->phase();                // EventPhase — what every package rule reads
$handle->status();               // the lifecycle state (EventStatus with the shipped lifecycle)
$handle->can('cancel');          // false when the actor lacks the transition ability
$handle->allowedTransitions();   // list<string> of transition names allowed now
$handle->counts();               // EventCounts {going, interested, waitlisted, seatsLeft}
$handle->ics($viewer);           // IcsCalendar
$handle->jsonLd();               // schema.org data, or null

manager(), actor(), isSystem(), isSilent(), authorize() a context() sú verejné pre pod-handle a označené ako @internal.

Typy vstupeniek: ->tiers()

Typ vstupenky iného podujatia sa nikdy nenájde (TierNotFoundException):

Odpoveď: ->rsvp($attendee)

Účastník, ktorý odpovedá sám za seba, potrebuje rsvp; ktokoľvek, kto odpovedá za niekoho iného, potrebuje manageAttendees:

Zoznam hostí: ->attendees()

Každá metóda prijme model účastníka alebo jeho Rsvp; RSVP iného podujatia sa odmietne:

Čakacia listina, spoluorganizátori, pozvánky a štítky

Events::venues()

Nemenný: by() vráti nový prístup, ktorého zápisy overujú VenuePolicy:

Events::rsvps()

Events::invitations()

Ako $by odovzdajte používateľa z požiadavky: pozvaný s účtom odpovedá len prihlásený ako on sám.

Builder podujatia

Events::make($title) vráti EventBuilder. Settery si uložia, čo dostanú, a harmonogram vyriešia až pri create(), keď je známe časové pásmo, takže ich poradie nikdy nezmení výsledný okamih; tam, kde to ide, validujú hneď:

Events::for($event)->edit() vráti EventEditor s rovnakými settermi pre existujúce podujatie a navyše title(): zmenia sa len polia, ktorých sa dotknete, save() spustí update() na handle a toData() vráti UpdateEventData. Slug, kategória, štítky, typy vstupeniek, plagát a spoluorganizátori majú vlastné metódy handle. Builder typu vstupenky a builder miesta konania opisujú ich vlastné stránky.

Traity modelov

OrganizesEvents implementuje kontrakt Organizer s predvolenými hodnotami a pridáva organizedEvents(), coHostedEvents() a organizeEvent($title) — pozrite Organizátori, spoluorganizátori a pozvánky. Oba traity idú cez manažér, takže Events::fake() zaznamená, čo robia.

PHP API dôveruje volajúcemu

Fasáda vždy vynucuje doménové pravidlá — miesta, okná, fázy, pozvánky, limity skupiny. Policy sa pýta, len keď cez by() uvediete aktéra. V kontroléri preto vždy odovzdajte prihláseného používateľa: handle bez by() skopírovaný do kontroléra pri vstupe by dovolil ktorémukoľvek prihlásenému používateľovi urobiť check-in komukoľvek.