LogOptions on Artist, ArtistEngagement, Stage, Performance, Genre now
list the specific attributes the audit log captures (per §8 last
paragraph) instead of logFillable. Each model gets a distinct
log_name (artist / artist_engagement / stage / performance / genre)
so the activity-log filter can scope queries by domain.
tapActivity() on every model adds organisation_id (and event_id where
relevant) to the activity entry's properties. The audit-log filter in
the SPA can then query
`->where('properties->event_id', $event->id)` without joining through
multiple subject types.
Performance gets dontLogIfAttributesChangedOnly(['updated_at',
'version']) so the bookkeeping touch from PerformanceObserver doesn't
generate noise when nothing user-meaningful changed.
Custom activity events emitted by services for the cases where the
auto-log can't infer intent:
performance.moved — LaneCascadeService::move writes a single
parent entry with cascade_count and
cascaded_ids[] after the cascade-bump
commits. Per-row updates still flow
through the model trait so the audit log
shows both the summary and the diffs.
stage.day_added /
stage.day_removed — StageDayService::replaceDays writes one
entry per added/removed event_id, performed
on the parent Stage so the log groups by
stage rather than by pivot row.
stage.reordered — StageService::reorder writes one entry on
the parent Event with the full new
stage_ids[] order.
artist_engagement.
status_changed /
cancelled — ArtistEngagementService::transitionStatus
emits one of these depending on the target
status; pairs with the auto-logged `updated`
row.
The remaining artist_engagement.option_expired event lands in Step 10
when the DemoteExpiredOptions command writes a system-causer entry.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
96 lines
2.6 KiB
PHP
96 lines
2.6 KiB
PHP
<?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()
|
|
->logOnly(['start_at', 'end_at', 'stage_id', 'lane', 'notes'])
|
|
->logOnlyDirty()
|
|
// Performance.version is bumped by PerformanceObserver on every
|
|
// dirty save. Skip the auto-log when *only* updated_at + version
|
|
// moved — those rows correspond to bookkeeping touches, not
|
|
// user-meaningful changes (D14).
|
|
->dontLogIfAttributesChangedOnly(['updated_at', 'version'])
|
|
->useLogName('performance');
|
|
}
|
|
|
|
public function tapActivity(Activity $activity, string $eventName): void
|
|
{
|
|
$properties = $activity->properties?->toArray() ?? [];
|
|
$properties['event_id'] = $this->event_id;
|
|
$properties['organisation_id'] = $this->engagement?->organisation_id;
|
|
$activity->properties = collect($properties);
|
|
}
|
|
|
|
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;
|
|
}
|
|
}
|