Modely a schéma

Sedem tabuliek, sedem modelov. Každý model ukladá časové značky v UTC bez ohľadu na app.timezone. Zapisujte cez fasádu, nikdy cez save() na týchto modeloch — handle udržiava miesta, počítadlá, notifikácie, zámky aj fake v poriadku. Modely slúžia na čítanie, vzťahy a scopes.

Tabuľky

events-migrations publikuje sedem anonymných migrácií len smerom vpred (bez down()), s časovou značkou z publikovania a nikdy nenačítaných automaticky. Morph dvojice sú <name>_type (reťazec) + <name>_id (nakonfigurovaný typ kľúča). Preložiteľné stĺpce a slugy sú na PostgreSQL jsonb a na MySQL json.

Tabuľka events má indexy pre zoznamy (visibility, status, starts_at), začiatok, koniec, miestne dni, miesto konania a organizátora. Indexy slugov pre jednotlivé jazyky pokrývajú translatable.locales v čase migrácie; index neskôr pridaného jazyka doplníte cez php artisan sluggable:indexes s názvom triedy modelu podujatia.

Modely

Model Event

Vzťahy: venue() (vrátane zmazaných miest konania), organizer() (MorphTo; null, keď jeho riadok zanikne), tiers() (podľa position, potom id), rsvps(), hosts() a invitations(). Casty: status na enum stavov nakonfigurovaného životného cyklu; visibility, attendance_mode a guest_list na ich enumy; online_url šifrovane; každá časová značka ako CarbonImmutable v UTC.

Query scopes

Každý filter API je jedným z týchto scopes, takže PHP aj HTTP filtrujú rovnako:

use RoundlyConsulting\Events\Models\Event;

Event::query()->visibleTo($user)->listed()->active()->free()->withSeatsAvailable()
    ->search('jazz')->popular()->paginate();

Event::query()->managedBy($user)->get();          // the events $user manages, drafts included
Event::query()->organizedBy($team)->upcoming()->get();
Event::query()->atVenue($venue)->inPerson()->get();

Route-model binding používa uuid (getRouteKeyName()); chybné uuid je 404 bez dotazu. Binding neuplatňuje žiadne pravidlo viditeľnosti — overte view. Trvalé zmazanie odstráni súbory plagátu (media-library sama nič neodstráni); soft delete ich ponechá.

Venue, AdmissionTier a Rsvp

• Venue — vzťahy owner() a events(), formattedAddress(), atribút coordinates (?Coordinates), scopes ownedBy($owner) a near($point, $km) a k tomu withinRadius() z geolocation (samotný ohraničujúci obdĺžnik).
• AdmissionTier — event() (vrátane zmazaných); isFree(), isOnSale() (práve v období predaja) a seatsLeft(); price je Money alebo null.
• Rsvp — event(), attendee(), tier() (vrátane zmazaných) a checkedInBy(); isGoing(), isHeld(), isWaitlisted(), isInterested(), isCheckedIn(), partySize(), waitlistPosition(), paymentIdempotencyKey() (ev-hold-…), checkInCode() a checkInQr().

Výmena modelu

namespace App\Models;

final class Event extends \RoundlyConsulting\Events\Models\Event
{
    // your relations, casts, traits
}

// config/events.php
'models' => ['event' => App\Models\Event::class],

Vymeniteľné sú štyri modely — event, venue, tier a rsvp; EventHost, EventInvitation a ReminderDelivery sú final. Balík získava každý model cez toto miesto — vzťahy, dotazy, registráciu policy, typy štítkov aj factories —, takže vzniká a vracia sa vaša podtrieda. Trieda, ktorá nie je podtriedou modelu balíka, vyhodí InvalidConfigurationException z toolkitu s názvom kľúča.

Enumy

Každý enum okrem EventOperation, EventTagType a FindingSeverity používa Helpers z enums-for-laravel: label() (preložený, v angličtine a slovenčine), labels(), values(), options(), toOptions(), fromName(), tryFromName(), is(), isIn(), validationRule() a ďalšie metódy tohto traitu. Slovenské popisy sú napríklad „Čaká na platbu“ pre RsvpStatus::Held, „Osobne aj online“ pre AttendanceMode::Mixed a „Ručne“ pre CheckInMethod::Manual:

use RoundlyConsulting\Events\Enums\RsvpStatus;

RsvpStatus::Waitlisted->label();              // "On the waitlist" ("Na čakacej listine" in sk)
$rsvp->status->takesSeats();                   // going or held
$event->phase->isActive();                     // RSVPs and check-in run

Dátové objekty

Každé DTO je final readonly s vlastnosťami v konštruktore. Vstupy:

Výsledky:

Kontrakty