Lewati ke konten utama

Audit Trail (Activity Log)

Starter Kit ini menggunakan Spatie Laravel Activitylog v5 sebagai engine pendata aktivitas (audit trail).

PENTING: Untuk mendukung konsistensi identifier, starter kit ini menggunakan UUID v7 untuk tabel activity_log. Hal ini dicapai dengan menggunakan custom model App\Models\Activity yang meng-override model bawaan Spatie.

Fitur Utama​

  • Pelacakan Otomatis Model: Mencatat event created, updated, dan deleted pada model yang aktif.
  • Native Activity Resource: Dashboard pusat untuk melihat seluruh log aktivitas di /app/activities.
  • Filtered Timeline: Tombol "Activities" pada tabel user memungkinkan Anda melihat log spesifik untuk user tersebut dengan satu klik.
  • Batching & Events: Mendukung sistem batching v5 untuk melacak rangkaian perubahan yang berkaitan.

Cara Penggunaan untuk Model Baru​

Jika Anda ingin mengaktifkan Audit Trail pada model baru (contoh: Post):

1. Tambahkan Trait di Model​

Gunakan trait HasActivity dari Spatie:

declare(strict_types=1);

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Spatie\Activitylog\Support\LogOptions;
use Spatie\Activitylog\Models\Concerns\HasActivity;

class Post extends Model
{
    use HasActivity;

    public function getActivitylogOptions(): LogOptions
    {
        return LogOptions::defaults()
            ->logUnguarded() // Mencatat semua field yang diubah
            ->logOnlyDirty()  // Hanya catat field yang benar-benar berubah
            ->dontLogEmptyChanges(); // Jangan buat log jika tidak ada perubahan
    }
}

Di file konfigurasi tabel (contoh: PostsTable.php), tambahkan action untuk memfilter log:

use App\Filament\Resources\Activities\ActivityResource;
use Filament\Tables\Actions\Action;

Action::make('activities')
    ->label(__('Activities'))
    ->icon('heroicon-o-clock')
    ->url(fn (Post $record): string => ActivityResource::getUrl('index', [
        'tableFilters[subject_type][value]' => get_class($record),
        'tableSearch' => $record->id,
    ])),

Dashboard Global​

Anda dapat mengakses seluruh log aktivitas melalui menu Activities di sidebar panel admin. Log ini mencakup informasi mengenai:

  • Log Time: Kapan aktivitas terjadi.
  • Causer: Siapa yang melakukan perubahan (User atau System).
  • Event: Jenis aktivitas (created, updated, deleted).
  • Subject: Model apa yang diubah.
  • Description: Detail singkat mengenai perubahan tersebut.

Referensi​

Update Behavior Resource Activity​

Resource Activity sekarang menerapkan pembatasan visibilitas berbasis role:

  • super_admin dan admin: dapat melihat seluruh aktivitas.
  • member: hanya melihat aktivitas miliknya sendiri.

Implementasi query juga kompatibel dengan data lama dan baru pada kolom causer_type:

  • alias morph map (user)
  • FQCN model (App\\Models\\User)

Dengan pendekatan ini, policy lebih konsisten untuk audit trail dan perilaku test member scope menjadi deterministic.