Skip to Content

Log Aktivitas

  • Code: SET-LOG
  • Module: Settings
  • Type: System Record

1. Overview

Log Aktivitas mencatat setiap perubahan data di tenant: siapa melakukan apa, kapan, pada data apa, dan apa yang berubah. Ada dua tampilan: satu timeline gabungan lintas modul di Settings, dan satu panel khusus di tiap fitur yang hanya menampilkan log milik data fitur itu.

Hasil yang diharapkan: owner dan auditor bisa menelusuri perubahan apa pun tanpa bantuan tim teknis.

2. Problem

Tanpa jejak yang tercatat otomatis, penelusuran siapa mengubah apa hanya bisa mengandalkan ingatan atau laporan lisan. Akibatnya:

  • Kesalahan data (harga, status, akses) sulit dilacak penyebabnya tanpa jejak perubahan.
  • Owner perlu memastikan tidak ada perubahan yang tidak sah pada pengaturan penting.
  • Satu aksi bisa mengubah beberapa data sekaligus; perubahan terkait perlu terlihat bersama.

3. Goals & Non-goals

3.1 Goals

  • Penyebab kesalahan data bisa ditelusuri sampai ke siapa yang mengubahnya dan kapan.
  • Perubahan pada pengaturan penting bisa diperiksa sewaktu-waktu tanpa bantuan tim teknis.
  • Perubahan yang terjadi dalam satu aksi terlihat sebagai satu rangkaian, bukan potongan yang terpisah-pisah.
  • Penelusuran bisa dipersempit ke periode, pelaku, atau jenis data tertentu saat menyelidiki suatu kejadian.

3.2 Non-goals

  • Mengubah atau menghapus log dari dalam aplikasi.
  • Ekspor log ke berkas eksternal.
  • Peringatan otomatis saat terjadi perubahan tertentu.

4. Business Rules

Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Log Aktivitas di seluruh aplikasi, pada semua layar dan aksi yang melibatkannya, siapa pun yang melakukannya. Aturan ini menjadi sumber kebenaran tunggal: bila bagian lain di PRD ini tampak berbeda, aturan di sinilah yang berlaku.

  • BR-01 Log hanya bisa bertambah. Tidak ada aksi untuk mengubah maupun menghapusnya.
  • BR-02 Log tercipta otomatis setiap ada perubahan data, tidak pernah dibuat atau disunting secara manual.
  • BR-03 Perubahan yang terjadi dalam satu aksi dikelompokkan sebagai satu log induk beserta log turunannya.
  • BR-04 Log ditampilkan berurutan dari yang terbaru dan dimuat bertahap saat ditelusuri.
  • BR-05 Pilihan filter mengikuti data log yang benar-benar pernah tercatat, bukan daftar tetap.

5. Flow

5.1 Main Flowchart

  1. Timeline Log — Seluruh perubahan ditampilkan berurutan dari yang terbaru, masing-masing memuat pelaku, jenis datanya, dan waktu kejadiannya.
  2. Persempit Pencarian — Penelusuran dipersempit berdasarkan jenis aktivitas, jenis data, pelaku, atau rentang tanggal. Hasil penyaringan bisa dibagikan lewat tautan halaman.
  3. Muat Log Berikutnya — Log lama dimuat bertahap sesuai kebutuhan penelusuran.
  4. Detail Perubahan — Satu log dibuka untuk melihat nilai lama dan nilai barunya, beserta perubahan lain yang terjadi dalam aksi yang sama.

6. Document Structure

6.1 General

FieldTipeWajibDefaultAturan
Id LogTeks—Dibuat sistemPenanda log
Jenis LogTeks—Modul data yang berubahDitetapkan sistem
AktivitasEnum—Jenis perubahan yang terjadiMisalnya created, updated, deleted
Judul & PesanTeks—Disusun sistem dari perubahannyaTeks yang ditampilkan di daftar
PelakuRef. Pengguna—Pengguna yang melakukan perubahanNama, email, dan foto pengguna
Data TerkaitRef. Data—Data yang berubahJenis dan penanda datanya
PerubahanObjek, banyak—Selisih sebelum dan sesudahDaftar field beserta nilai lama dan nilai barunya
MetadataObjek—Direkam saat perubahan terjadiAlamat IP dan perangkat yang dipakai
WaktuTanggal & Waktu—Saat perubahan terjadiDitampilkan absolut maupun relatif
Log TurunanRef. Log, banyak——Log lain dalam satu aksi yang sama, strukturnya identik (BR-03)

7. UI Structure

Bagian ini mendefinisikan cara Log Aktivitas ditampilkan dan dioperasikan: susunan feed dan filter beserta sumber pilihannya. Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.

7.1 Feed

Bukan tabel, melainkan daftar satu kolom yang dimuat bertahap, terbaru di atas.

BagianContoh NilaiKomponen
PelakuBudi SantosoAvatar, Text
PesanMengubah harga beli produk Minyak Goreng 2LText
Jenis Log & EventProduk · updatedBadge
Waktu5 menit laluText, absolut dan relatif
PerubahanHarga Beli: Rp 12.000 → Rp 12.500Tabel nilai lama ke nilai baru, bisa diperluas
Log Turunan3 perubahan terkaitAccordion, hanya bila ada

7.2 Advance Filter

FieldKontrolSumber PilihanDefault
EventMulti SelectEvent yang pernah tercatat (BR-05)Kosong
Jenis LogMulti SelectJenis log yang pernah tercatat (BR-05)Kosong
PelakuMulti SelectPengguna yang pernah tercatat sebagai pelaku (BR-05)Kosong
TanggalDate Range Picker—Kosong

8. User Stories

US-01 - Melihat semua log aktivitas

Sebagai owner, saya ingin melihat semua perubahan data di tenant dalam satu tempat, agar mudah diaudit.

IDKriteria penerimaan
AC-01.1Halaman hanya bisa dibuka pengguna dengan izin list log aktivitas; lainnya diarahkan ke unauthorized.
AC-01.2Setiap log menampilkan pelaku, pesan, jenis log, event, dan waktu.
AC-01.3Log dimuat bertahap lewat tombol muat lebih banyak; tombol disembunyikan bila data habis.
AC-01.4Perubahan field ditampilkan sebagai tabel nilai lama → nilai baru; nilai kosong ditandai sebagai tidak ada nilai.
AC-01.5Log yang punya log turunan menampilkan akordeon “lihat perubahan terkait”.
AC-01.6Pelaku sudah dihapus — log tetap harus bisa ditampilkan (BR-01).
AC-01.7Nilai perubahan berupa objek atau array — ditampilkan terstruktur, bukan teks mentah.

US-02 - Menyaring log

Sebagai auditor, saya ingin menyaring log, agar cepat menemukan perubahan yang dicari.

IDKriteria penerimaan
AC-02.1Filter event, jenis log, dan pelaku berupa pilihan multi yang mengikuti data log yang pernah tercatat (BR-05).
AC-02.2Filter rentang tanggal: satu tanggal atau rentang; dikirim sebagai start_date dan end_date (yyyy-MM-dd). Satu tanggal berarti start_date = end_date.
AC-02.3Filter tersimpan di URL dan dipulihkan saat halaman dibuka ulang.
AC-02.4Filter bisa direset ke kosong.
AC-02.5URL berisi filter yang tidak valid — filter kembali ke default kosong.

US-03 - Log per fitur

Sebagai admin, saya ingin melihat log langsung dari halaman fitur, agar tidak perlu menyaring manual.

IDKriteria penerimaan
AC-03.1Tombol Log Aktivitas di halaman daftar menampilkan log semua data fitur; di halaman detail menampilkan log data tersebut saja.
AC-03.2Panel memakai format tampilan yang sama dengan halaman global, dengan filter event, pelaku, dan rentang tanggal.
AC-03.3Fitur tanpa log aktivitas — Peran & Izin dan Pengelola File belum punya panel log di UI.

9. User Scenarios

RoleScenario
OwnerMencari siapa yang mengubah harga beli produk minggu lalu
AuditorMenyaring semua perubahan yang dilakukan satu pengguna dalam rentang tanggal tertentu
OwnerMemeriksa perubahan peran dan hak akses setelah ada insiden
AdminMembagikan tautan hasil filter log ke rekan (filter tersimpan di URL)

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat Log Aktivitas
(Global)
settings:activity-log:list:any—
Lihat Log Aktivitas
(Per Fitur)
Izin lihat daftar atau detail pada fitur terkaitMengikuti halaman tempat panel dibuka

11. Notifications

Fitur ini tidak memicu notifikasi.

12. Dependencies

PRD terkait

  • Semua fitur yang diaudit (Appearance, Company, Stores, Entities, Employees, Users, Purchase Order, dan lainnya).
  • Users — pelaku log adalah pengguna.
Terakhir diperbarui