feat(timetable): Artist domain — 7 enums + 9 Eloquent models

Enums under App\Enums\Artist\ (PascalCase per FormBuilder convention,
snake_case wire values per RFC):
- ArtistEngagementStatus (D9, 9 states + Dutch labels)
- BumaHandledBy (D26)
- FeeType, PaymentStatus
- AdvanceSectionType, AdvanceSectionSubmissionStatus, AdvanceSubmissionStatus

Models:
- Artist (org-scoped, slug-unique-per-org via creating boot hook)
- ArtistEngagement (per-event booking, denorm organisation_id)
- Genre, Stage (event-scoped, ordered scope), StageDay (Pivot, int PK)
- Performance (engagement-scoped, isParked() helper)
- AdvanceSection, AdvanceSubmission, ArtistContact (primary scope)

OrganisationScope wired:
- Direct organisation_id: Artist, Genre, ArtistEngagement
- FK-chain via tenantScopeStrategy(): Stage→Event, Performance→Engagement,
  AdvanceSection→Engagement, AdvanceSubmission→Section→Engagement,
  ArtistContact→Artist, StageDay→Stage→Event

Soft-deletes: Artist, ArtistEngagement, Performance (per RFC §5.4).
LogsActivity baseline (logFillable+dontSubmitEmptyLogs) on all business
models — actual mutation surfaces wire LogOptions in Session 2+.

Inverse relations added on Organisation, Event, Company.
companies.handles_buma cast added.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

api/app/Models/AdvanceSection.php

@@ -0,0 +1,79 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use App\Enums\Artist\AdvanceSectionSubmissionStatus;
+use App\Enums\Artist\AdvanceSectionType;
+use App\Models\Scopes\OrganisationScope;
+use Illuminate\Database\Eloquent\Concerns\HasUlids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Spatie\Activitylog\Models\Concerns\LogsActivity;
+use Spatie\Activitylog\Support\LogOptions;
+
+final class AdvanceSection extends Model
+{
+    use HasFactory;
+    use HasUlids;
+    use LogsActivity;
+
+    protected static function booted(): void
+    {
+        self::addGlobalScope(new OrganisationScope);
+    }
+
+    /** @return array{via: class-string, fk: string} */
+    public static function tenantScopeStrategy(): array
+    {
+        return ['via' => ArtistEngagement::class, 'fk' => 'engagement_id'];
+    }
+
+    protected $fillable = [
+        'engagement_id',
+        'name',
+        'type',
+        'is_open',
+        'open_from',
+        'open_to',
+        'sort_order',
+        'submission_status',
+        'last_submitted_at',
+        'last_submitted_by',
+        'submission_diff',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'type' => AdvanceSectionType::class,
+            'submission_status' => AdvanceSectionSubmissionStatus::class,
+            'is_open' => 'boolean',
+            'open_from' => 'datetime',
+            'open_to' => 'datetime',
+            'sort_order' => 'integer',
+            'last_submitted_at' => 'datetime',
+            'submission_diff' => 'array',
+        ];
+    }
+
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()
+            ->logFillable()
+            ->dontSubmitEmptyLogs();
+    }
+
+    public function engagement(): BelongsTo
+    {
+        return $this->belongsTo(ArtistEngagement::class, 'engagement_id');
+    }
+
+    public function submissions(): HasMany
+    {
+        return $this->hasMany(AdvanceSubmission::class);
+    }
+}

api/app/Models/AdvanceSubmission.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use App\Enums\Artist\AdvanceSubmissionStatus;
+use App\Models\Scopes\OrganisationScope;
+use Illuminate\Database\Eloquent\Concerns\HasUlids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Spatie\Activitylog\Models\Concerns\LogsActivity;
+use Spatie\Activitylog\Support\LogOptions;
+
+final class AdvanceSubmission extends Model
+{
+    use HasFactory;
+    use HasUlids;
+    use LogsActivity;
+
+    protected static function booted(): void
+    {
+        self::addGlobalScope(new OrganisationScope);
+    }
+
+    /** @return array{via: class-string, fk: string} */
+    public static function tenantScopeStrategy(): array
+    {
+        return ['via' => AdvanceSection::class, 'fk' => 'advance_section_id'];
+    }
+
+    protected $fillable = [
+        'advance_section_id',
+        'submitted_by_name',
+        'submitted_by_email',
+        'submitted_at',
+        'status',
+        'reviewed_by',
+        'reviewed_at',
+        'data',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'status' => AdvanceSubmissionStatus::class,
+            'submitted_at' => 'datetime',
+            'reviewed_at' => 'datetime',
+            'data' => 'array',
+        ];
+    }
+
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()
+            ->logFillable()
+            ->dontSubmitEmptyLogs();
+    }
+
+    public function section(): BelongsTo
+    {
+        return $this->belongsTo(AdvanceSection::class, 'advance_section_id');
+    }
+
+    public function reviewer(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'reviewed_by');
+    }
+}

api/app/Models/Artist.php

@@ -0,0 +1,107 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use App\Models\Scopes\OrganisationScope;
+use Illuminate\Database\Eloquent\Concerns\HasUlids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+use Illuminate\Support\Str;
+use Spatie\Activitylog\Models\Concerns\LogsActivity;
+use Spatie\Activitylog\Support\LogOptions;
+
+final class Artist extends Model
+{
+    use HasFactory;
+    use HasUlids;
+    use LogsActivity;
+    use SoftDeletes;
+
+    protected static function booted(): void
+    {
+        self::addGlobalScope(new OrganisationScope);
+
+        self::creating(function (Artist $artist): void {
+            if (empty($artist->slug)) {
+                $artist->slug = $artist->generateUniqueSlug($artist->name);
+            }
+        });
+    }
+
+    protected $fillable = [
+        'organisation_id',
+        'name',
+        'slug',
+        'default_genre_id',
+        'default_draw',
+        'star_rating',
+        'home_base_country',
+        'agent_company_id',
+        'notes',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'default_draw' => 'integer',
+            'star_rating' => 'integer',
+        ];
+    }
+
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()
+            ->logFillable()
+            ->dontSubmitEmptyLogs();
+    }
+
+    private function generateUniqueSlug(string $name): string
+    {
+        $base = Str::slug($name);
+        $slug = $base;
+        $suffix = 2;
+
+        while (
+            self::withoutGlobalScope(OrganisationScope::class)
+                ->withTrashed()
+                ->where('organisation_id', $this->organisation_id)
+                ->where('slug', $slug)
+                ->exists()
+        ) {
+            $slug = "{$base}-{$suffix}";
+            $suffix++;
+        }
+
+        return $slug;
+    }
+
+    public function organisation(): BelongsTo
+    {
+        return $this->belongsTo(Organisation::class);
+    }
+
+    public function defaultGenre(): BelongsTo
+    {
+        return $this->belongsTo(Genre::class, 'default_genre_id');
+    }
+
+    public function agentCompany(): BelongsTo
+    {
+        return $this->belongsTo(Company::class, 'agent_company_id');
+    }
+
+    public function contacts(): HasMany
+    {
+        return $this->hasMany(ArtistContact::class);
+    }
+
+    public function engagements(): HasMany
+    {
+        return $this->hasMany(ArtistEngagement::class);
+    }
+}

api/app/Models/ArtistContact.php

@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use App\Models\Scopes\OrganisationScope;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Concerns\HasUlids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Spatie\Activitylog\Models\Concerns\LogsActivity;
+use Spatie\Activitylog\Support\LogOptions;
+
+final class ArtistContact extends Model
+{
+    use HasFactory;
+    use HasUlids;
+    use LogsActivity;
+
+    protected static function booted(): void
+    {
+        self::addGlobalScope(new OrganisationScope);
+    }
+
+    /** @return array{via: class-string, fk: string} */
+    public static function tenantScopeStrategy(): array
+    {
+        return ['via' => Artist::class, 'fk' => 'artist_id'];
+    }
+
+    protected $fillable = [
+        'artist_id',
+        'name',
+        'email',
+        'phone',
+        'role',
+        'is_primary',
+        'receives_briefing',
+        'receives_infosheet',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'is_primary' => 'boolean',
+            'receives_briefing' => 'boolean',
+            'receives_infosheet' => 'boolean',
+        ];
+    }
+
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()
+            ->logFillable()
+            ->dontSubmitEmptyLogs();
+    }
+
+    public function artist(): BelongsTo
+    {
+        return $this->belongsTo(Artist::class);
+    }
+
+    public function scopePrimary(Builder $query): Builder
+    {
+        return $query->where('is_primary', true);
+    }
+}

api/app/Models/ArtistEngagement.php

@@ -0,0 +1,123 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use App\Enums\Artist\ArtistEngagementStatus;
+use App\Enums\Artist\BumaHandledBy;
+use App\Enums\Artist\FeeType;
+use App\Enums\Artist\PaymentStatus;
+use App\Models\Scopes\OrganisationScope;
+use Illuminate\Database\Eloquent\Concerns\HasUlids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+use Spatie\Activitylog\Models\Concerns\LogsActivity;
+use Spatie\Activitylog\Support\LogOptions;
+
+final class ArtistEngagement extends Model
+{
+    use HasFactory;
+    use HasUlids;
+    use LogsActivity;
+    use SoftDeletes;
+
+    protected static function booted(): void
+    {
+        self::addGlobalScope(new OrganisationScope);
+    }
+
+    protected $fillable = [
+        'organisation_id',
+        'artist_id',
+        'event_id',
+        'booking_status',
+        'project_leader_id',
+        'fee_amount',
+        'fee_currency',
+        'fee_type',
+        'buma_applicable',
+        'buma_percentage',
+        'buma_handled_by',
+        'vat_applicable',
+        'vat_percentage',
+        'deal_breakdown',
+        'deposit_percentage',
+        'deposit_due_date',
+        'balance_due_date',
+        'payment_status',
+        'crew_count',
+        'guests_count',
+        'requested_at',
+        'option_expires_at',
+        'advance_open_from',
+        'advance_open_to',
+        'portal_token',
+        'advancing_completed_count',
+        'advancing_total_count',
+        'notes',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'booking_status' => ArtistEngagementStatus::class,
+            'fee_type' => FeeType::class,
+            'buma_handled_by' => BumaHandledBy::class,
+            'payment_status' => PaymentStatus::class,
+            'buma_applicable' => 'boolean',
+            'vat_applicable' => 'boolean',
+            'deal_breakdown' => 'array',
+            'deposit_due_date' => 'date',
+            'balance_due_date' => 'date',
+            'crew_count' => 'integer',
+            'guests_count' => 'integer',
+            'requested_at' => 'datetime',
+            'option_expires_at' => 'datetime',
+            'advance_open_from' => 'datetime',
+            'advance_open_to' => 'datetime',
+            'advancing_completed_count' => 'integer',
+            'advancing_total_count' => 'integer',
+        ];
+    }
+
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()
+            ->logFillable()
+            ->dontSubmitEmptyLogs();
+    }
+
+    public function organisation(): BelongsTo
+    {
+        return $this->belongsTo(Organisation::class);
+    }
+
+    public function artist(): BelongsTo
+    {
+        return $this->belongsTo(Artist::class);
+    }
+
+    public function event(): BelongsTo
+    {
+        return $this->belongsTo(Event::class);
+    }
+
+    public function projectLeader(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'project_leader_id');
+    }
+
+    public function performances(): HasMany
+    {
+        return $this->hasMany(Performance::class, 'engagement_id');
+    }
+
+    public function advanceSections(): HasMany
+    {
+        return $this->hasMany(AdvanceSection::class, 'engagement_id');
+    }
+}

api/app/Models/Company.php

@@ -28,6 +28,7 @@ final class Company extends Model
         'organisation_id',
         'name',
         'type',
+        'handles_buma',
         'kvk_number',
         'contact_first_name',
         'contact_last_name',
@@ -35,6 +36,13 @@ final class Company extends Model
         'contact_phone',
     ];
 
+    protected function casts(): array
+    {
+        return [
+            'handles_buma' => 'boolean',
+        ];
+    }
+
     public function getContactFullNameAttribute(): ?string
     {
         if (! $this->contact_first_name) {
@@ -54,6 +62,11 @@ final class Company extends Model
         return $this->hasMany(Person::class);
     }
 
+    public function artistsAsAgent(): HasMany
+    {
+        return $this->hasMany(Artist::class, 'agent_company_id');
+    }
+
     /** @param Builder<self> $query */
     public function scopeOrdered(Builder $query): Builder
     {

api/app/Models/Event.php

@@ -27,7 +27,7 @@ final class Event extends Model
 
     protected static function booted(): void
     {
-        static::addGlobalScope(new OrganisationScope());
+        self::addGlobalScope(new OrganisationScope);
     }
 
     /** @var array<string, list<string>> Allowed status transitions */
@@ -153,6 +153,21 @@ final class Event extends Model
             ->orderBy('name');
     }
 
+    public function stages(): HasMany
+    {
+        return $this->hasMany(Stage::class);
+    }
+
+    public function artistEngagements(): HasMany
+    {
+        return $this->hasMany(ArtistEngagement::class);
+    }
+
+    public function performances(): HasMany
+    {
+        return $this->hasMany(Performance::class);
+    }
+
     // ----- Status State Machine -----
 
     public function canTransitionTo(string $newStatus): bool

api/app/Models/Genre.php

@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use App\Models\Scopes\OrganisationScope;
+use Illuminate\Database\Eloquent\Concerns\HasUlids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Spatie\Activitylog\Models\Concerns\LogsActivity;
+use Spatie\Activitylog\Support\LogOptions;
+
+final class Genre extends Model
+{
+    use HasFactory;
+    use HasUlids;
+    use LogsActivity;
+
+    protected static function booted(): void
+    {
+        self::addGlobalScope(new OrganisationScope);
+    }
+
+    protected $fillable = [
+        'organisation_id',
+        'name',
+        'color',
+        'sort_order',
+        'is_active',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'sort_order' => 'integer',
+            'is_active' => 'boolean',
+        ];
+    }
+
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()
+            ->logFillable()
+            ->dontSubmitEmptyLogs();
+    }
+
+    public function organisation(): BelongsTo
+    {
+        return $this->belongsTo(Organisation::class);
+    }
+
+    public function artists(): HasMany
+    {
+        return $this->hasMany(Artist::class, 'default_genre_id');
+    }
+}

api/app/Models/Organisation.php

@@ -100,4 +100,19 @@ final class Organisation extends Model
     {
         return $this->hasMany(EmailLog::class);
     }
+
+    public function artists(): HasMany
+    {
+        return $this->hasMany(Artist::class);
+    }
+
+    public function genres(): HasMany
+    {
+        return $this->hasMany(Genre::class);
+    }
+
+    public function artistEngagements(): HasMany
+    {
+        return $this->hasMany(ArtistEngagement::class);
+    }
 }

api/app/Models/Performance.php

@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use App\Models\Scopes\OrganisationScope;
+use Illuminate\Database\Eloquent\Concerns\HasUlids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+use Spatie\Activitylog\Models\Concerns\LogsActivity;
+use Spatie\Activitylog\Support\LogOptions;
+
+final class Performance extends Model
+{
+    use HasFactory;
+    use HasUlids;
+    use LogsActivity;
+    use SoftDeletes;
+
+    protected static function booted(): void
+    {
+        self::addGlobalScope(new OrganisationScope);
+    }
+
+    /** @return array{via: class-string, fk: string} */
+    public static function tenantScopeStrategy(): array
+    {
+        return ['via' => ArtistEngagement::class, 'fk' => 'engagement_id'];
+    }
+
+    protected $fillable = [
+        'engagement_id',
+        'event_id',
+        'stage_id',
+        'lane',
+        'start_at',
+        'end_at',
+        'version',
+        'notes',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'lane' => 'integer',
+            'start_at' => 'datetime',
+            'end_at' => 'datetime',
+            'version' => 'integer',
+        ];
+    }
+
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()
+            ->logFillable()
+            ->dontSubmitEmptyLogs();
+    }
+
+    public function engagement(): BelongsTo
+    {
+        return $this->belongsTo(ArtistEngagement::class, 'engagement_id');
+    }
+
+    public function event(): BelongsTo
+    {
+        return $this->belongsTo(Event::class);
+    }
+
+    public function stage(): BelongsTo
+    {
+        return $this->belongsTo(Stage::class);
+    }
+
+    public function isParked(): bool
+    {
+        return $this->stage_id === null;
+    }
+}

api/app/Models/Stage.php

@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use App\Models\Scopes\OrganisationScope;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Concerns\HasUlids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Spatie\Activitylog\Models\Concerns\LogsActivity;
+use Spatie\Activitylog\Support\LogOptions;
+
+final class Stage extends Model
+{
+    use HasFactory;
+    use HasUlids;
+    use LogsActivity;
+
+    protected static function booted(): void
+    {
+        self::addGlobalScope(new OrganisationScope);
+    }
+
+    /** @return array{via: class-string, fk: string} */
+    public static function tenantScopeStrategy(): array
+    {
+        return ['via' => Event::class, 'fk' => 'event_id'];
+    }
+
+    protected $fillable = [
+        'event_id',
+        'name',
+        'color',
+        'capacity',
+        'sort_order',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'capacity' => 'integer',
+            'sort_order' => 'integer',
+        ];
+    }
+
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()
+            ->logFillable()
+            ->dontSubmitEmptyLogs();
+    }
+
+    public function event(): BelongsTo
+    {
+        return $this->belongsTo(Event::class);
+    }
+
+    public function stageDays(): HasMany
+    {
+        return $this->hasMany(StageDay::class);
+    }
+
+    public function performances(): HasMany
+    {
+        return $this->hasMany(Performance::class);
+    }
+
+    public function scopeOrdered(Builder $query): Builder
+    {
+        return $query->orderBy('sort_order')->orderBy('created_at');
+    }
+}

api/app/Models/StageDay.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use App\Models\Scopes\OrganisationScope;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\Pivot;
+
+/**
+ * Pivot stage↔event. Integer auto-increment PK; pure pivot, no
+ * timestamps, no soft deletes. Multi-tenancy inherited via `stage_id`.
+ */
+final class StageDay extends Pivot
+{
+    use HasFactory;
+
+    public $incrementing = true;
+
+    public $timestamps = false;
+
+    protected $table = 'stage_days';
+
+    protected static function booted(): void
+    {
+        self::addGlobalScope(new OrganisationScope);
+    }
+
+    /** @return array{via: class-string, fk: string} */
+    public static function tenantScopeStrategy(): array
+    {
+        return ['via' => Stage::class, 'fk' => 'stage_id'];
+    }
+
+    protected $fillable = [
+        'stage_id',
+        'event_id',
+    ];
+
+    public function stage(): BelongsTo
+    {
+        return $this->belongsTo(Stage::class);
+    }
+
+    public function event(): BelongsTo
+    {
+        return $this->belongsTo(Event::class);
+    }
+}