Beranda / Super Admin / Log Sampah & Pemulihan

Log Sampah & Pemulihan Event (Soft Delete)

Log Sampah & Pemulihan adalah fitur perlindungan data di BukuTamu Pro yang mencegah kehilangan data penting akibat kelalaian pengguna. Ketika Event Organizer (EO) menghapus event, sistem akan menyimpannya sebagai sampah sementara (Soft Delete). Super Admin dapat mengembalikan (restore) data tersebut atau mengeksekusi pembersihan permanen secara menyeluruh (Cascade Cleanup) termasuk file fisik di server.

Jaminan Pemulihan Data Klien

Fungsi pemulihan data ini tersembunyi sepenuhnya dari antarmuka luar dan hanya dapat dikelola oleh Super Admin. Ini memberikan nilai tambah yang luar biasa bagi layanan whitelabel Anda: Anda bertindak sebagai penyelamat data jika klien tidak sengaja menghapus event penting mereka sebelum acara dimulai.

Fitur Unggulan Log Sampah

  • Soft Delete Protection: Menahan data event yang dihapus agar tidak langsung lenyap dari database server.
  • One-Click Recovery: Mengembalikan seluruh relasi data event (tamu, undangan, pengaturan tampilan, meja) secara utuh dalam sekali klik.
  • Cascade Cleanup Engine: Menghapus file media fisik beserta sisa-sisa data relasi secara menyeluruh dari server dan database agar penyimpanan tetap efisien.

Skenario Salah Hapus Event

Bayangkan seorang EO tidak sengaja menekan tombol hapus pada event pernikahan akbar yang dijadwalkan besok hari. Semua daftar tamu dan riwayat RSVP tampak hilang seketika. Jangan panik! Sebagai Super Admin, Anda cukup masuk ke dasbor Trash Log di rute /admin/events/trash, temukan event tersebut, lalu klik Restore. Seketika itu juga seluruh relasi data tamu kembali normal.

1. Memulihkan Data Terhapus Sementara

Cara mengembalikan data event yang terhapus secara tidak sengaja oleh EO:

Langkah Tindakan:

  1. Masuk ke dasbor Super Admin Anda.
  2. Akses menu Trash Log di bilah navigasi samping (atau langsung akses rute /admin/events/trash).
  3. Anda akan melihat daftar event yang terhapus sementara di tabel Trash Log Events.
  4. Gunakan kolom pencarian untuk menyaring berdasarkan nama event atau nama EO pemilik.
  5. Klik tombol ♻️ Restore berwarna hijau di kolom aksi.
  6. Sistem akan menampilkan modal konfirmasi SweetAlert: Restore Event? Yakin ingin mere-store event ini ke EO?. Klik Ya, Restore untuk mengonfirmasi. Event akan dikembalikan ke status aktif dan dapat diakses kembali oleh EO yang bersangkutan.

2. Eksekusi Penghapusan Permanen & Pembersihan File

Menghapus data sampah secara permanen agar ruang penyimpanan server kembali lega:

Langkah Tindakan:

  1. Pada dasbor Trash Log, temukan event yang ingin dihapus secara permanen.
  2. Klik tombol 🗑️ Hapus Permanen berwarna merah di kolom aksi.
  3. Sistem akan menampilkan modal peringatan SweetAlert: Hapus Permanen? Seluruh data tamu dan souvenir akan musnah. Tindakan ini tidak dapat dibatalkan!.
  4. Jika Anda mengklik Ya, Hapus Permanen, sistem akan secara otomatis menjalankan proses pembersihan file fisik (media file cleanup) dari direktori server berikut:
    • Cover & Featured Image Event: Berkas cover utama dan gambar unggulan event dari tabel events.
    • Cover E-Invitation: Berkas gambar cover undangan dari tabel event_einvitation_settings.
    • Welcome BG Assets & Frame Overlay: Berkas overlay frame dan seluruh aset gambar latar yang diunggah dari tabel event_welcome_settings.
    • Selfie Foto Tamu: Semua foto selfie tamu yang diunggah saat melakukan registrasi dari tabel guests.
    • File Undangan Temporer: Seluruh berkas PDF e-invitation sementara yang tersimpan di direktori /uploads/einvitations/tmp/einv_{uuid}_*.
  5. Setelah pembersihan file fisik selesai, database akan menjalankan kueri penghapusan berantai (cascade delete) untuk menghapus data event dan relasi tabel lainnya (tamu, RSVP, log, dan pengaturan) secara permanen dari database server.

3. Audit Log & Penanganan Kegagalan

Sistem BukuTamu Pro tidak menampilkan riwayat audit log tempat sampah dalam bentuk tabel visual di antarmuka admin demi menyederhanakan dasbor. Namun, semua proses audit penghapusan dicatat secara internal:

Log Aplikasi Internal:

Jika terjadi kendala saat proses penghapusan file fisik dari server (misalnya masalah hak akses file atau permission), sistem akan secara senyap mencatat detail error tersebut ke log aplikasi internal dengan format: [AdminEventController::forceDelete] File cleanup failed: [pesan error] dengan level log ERROR. Anda dapat memeriksa log ini di server untuk keperluan penelusuran masalah (troubleshooting).

Peringatan Kritis Kehilangan Data

Eksekusi Hapus Permanen akan melenyapkan file fisik dan database secara permanen. Pastikan Anda tidak menghapus data dari event yang sedang berjalan atau event masa lalu yang laporannya masih dibutuhkan oleh EO untuk audit pembukuan mereka.

Tanya Jawab (FAQ)

T: Berapa lama data sampah (Soft Delete) disimpan sebelum dihapus otomatis?

J: Secara default, sistem menyimpan data sampah di database hingga Super Admin mengambil tindakan. Pembersihan data secara berkala dapat dilakukan dengan menekan tombol Hapus Permanen pada event-event yang sudah tidak aktif.

T: Mengapa foto selfie tamu atau berkas media tidak ikut kembali setelah saya memulihkan (restore) data event?

J: Proses Soft Delete hanya menandai status event terhapus tanpa memodifikasi berkas fisik. Namun, jika ada pihak yang menghapus file fisik di direktori server secara manual (misalnya via File Manager cPanel), berkas media tersebut tidak akan bisa ditampilkan lagi meskipun event berhasil dipulihkan.

T: Apakah klien EO dapat melihat menu Trash Log ini di dasbor mereka?

J: Tidak. Menu Trash Log ini hanya dapat diakses oleh akun dengan peran Super Admin di rute /admin/events/trash guna menjaga keamanan data.

Pelajari Selanjutnya