ladill-care/app/Models/AuditLog.php

<?php

namespace App\Models;

use App\Models\Concerns\BelongsToOwner;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

class AuditLog extends Model
{
    use BelongsToOwner;

    protected $table = 'care_audit_logs';

    public $timestamps = false;

    protected $fillable = [
        'owner_ref', 'organization_id', 'actor_ref', 'action',
        'subject_type', 'subject_id', 'metadata', 'ip_address', 'created_at',
    ];

    protected function casts(): array
    {
        return [
            'metadata' => 'array',
            'created_at' => 'datetime',
        ];
    }

    public function organization(): BelongsTo
    {
        return $this->belongsTo(Organization::class, 'organization_id');
    }

    public static function record(
        string $ownerRef,
        string $action,
        ?int $organizationId = null,
        ?string $actorRef = null,
        ?string $subjectType = null,
        ?int $subjectId = null,
        ?array $metadata = null,
    ): self {
        return static::create([
            'owner_ref' => $ownerRef,
            'organization_id' => $organizationId,
            'actor_ref' => $actorRef,
            'action' => $action,
            'subject_type' => $subjectType,
            'subject_id' => $subjectId,
            'metadata' => $metadata,
            'ip_address' => request()?->ip(),
            'created_at' => now(),
        ]);
    }
}