Models and schema

Seven tables, seven models. Every model stores its timestamps in UTC whatever app.timezone says. Write through the facade, never with save() on these models — the handle keeps seats, counters, notices, locks and the fake right. The models carry reads, relations and scopes.

Tables

events-migrations publishes seven anonymous, forward-only migrations (no down()), timestamped on publish and never auto-loaded. Morph pairs are <name>_type (a string) + <name>_id (the configured key type). Translatable and slug columns are jsonb on PostgreSQL and json on MySQL.

The events table is indexed for listings (visibility, status, starts_at), start, end, local days, venue and organizer. The per-locale slug indexes cover translatable.locales at migration time; add a later locale’s index with php artisan sluggable:indexes followed by the event model’s class name.

Models

The Event model

Relations: venue() (trashed venues included), organizer() (MorphTo; null once its row is gone), tiers() (ordered by position, then id), rsvps(), hosts() and invitations(). Casts: status to the configured lifecycle’s state enum; visibility, attendance_mode and guest_list to their enums; online_url encrypted; every timestamp a CarbonImmutable in UTC.

Query scopes

Every API filter is one of these scopes, so PHP and HTTP filter identically:

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 uses the uuid (getRouteKeyName()); a malformed uuid is a 404 without a query. Binding applies no visibility rule — authorize view. A force delete removes the poster files (media-library removes nothing on its own); a soft delete keeps them.

Venue, AdmissionTier and Rsvp

• Venue — owner() and events() relations, formattedAddress(), the coordinates attribute (?Coordinates), the scopes ownedBy($owner) and near($point, $km), plus geolocation’s withinRadius() (the bounding box alone).
• AdmissionTier — event() (trashed included); isFree(), isOnSale() (inside the sale window now) and seatsLeft(); price is a Money or null.
• Rsvp — event(), attendee(), tier() (trashed included) and checkedInBy(); isGoing(), isHeld(), isWaitlisted(), isInterested(), isCheckedIn(), partySize(), waitlistPosition(), paymentIdempotencyKey() (ev-hold-…), checkInCode() and checkInQr().

Swapping a model

namespace App\Models;

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

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

Four models are swappable — event, venue, tier and rsvp; EventHost, EventInvitation and ReminderDelivery are final. The package resolves every model through this seam — relations, queries, the policy registration, the tag types and the factories — so your subclass is the one created and returned. A class that is not a subclass of the package’s throws the toolkit’s InvalidConfigurationException, naming the key.

Enums

Every enum except EventOperation, EventTagType and FindingSeverity uses enums-for-laravel’s Helpers: label() (translated, English and Slovak), labels(), values(), options(), toOptions(), fromName(), tryFromName(), is(), isIn(), validationRule() and the rest of that trait. English labels include “Awaiting payment” for RsvpStatus::Held, “In person and online” for AttendanceMode::Mixed and “By hand” for 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

Data objects

Every DTO is final readonly and constructor-promoted. Inputs:

Results:

Contracts