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
- Timeline Log — Seluruh perubahan ditampilkan berurutan dari yang terbaru, masing-masing memuat pelaku, jenis datanya, dan waktu kejadiannya.
- Persempit Pencarian — Penelusuran dipersempit berdasarkan jenis aktivitas, jenis data, pelaku, atau rentang tanggal. Hasil penyaringan bisa dibagikan lewat tautan halaman.
- Muat Log Berikutnya — Log lama dimuat bertahap sesuai kebutuhan penelusuran.
- 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
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Id Log | Teks | — | Dibuat sistem | Penanda log |
| Jenis Log | Teks | — | Modul data yang berubah | Ditetapkan sistem |
| Aktivitas | Enum | — | Jenis perubahan yang terjadi | Misalnya created, updated, deleted |
| Judul & Pesan | Teks | — | Disusun sistem dari perubahannya | Teks yang ditampilkan di daftar |
| Pelaku | Ref. Pengguna | — | Pengguna yang melakukan perubahan | Nama, email, dan foto pengguna |
| Data Terkait | Ref. Data | — | Data yang berubah | Jenis dan penanda datanya |
| Perubahan | Objek, banyak | — | Selisih sebelum dan sesudah | Daftar field beserta nilai lama dan nilai barunya |
| Metadata | Objek | — | Direkam saat perubahan terjadi | Alamat IP dan perangkat yang dipakai |
| Waktu | Tanggal & Waktu | — | Saat perubahan terjadi | Ditampilkan absolut maupun relatif |
| Log Turunan | Ref. 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.
| Bagian | Contoh Nilai | Komponen |
|---|---|---|
| Pelaku | Budi Santoso | Avatar, Text |
| Pesan | Mengubah harga beli produk Minyak Goreng 2L | Text |
| Jenis Log & Event | Produk · updated | Badge |
| Waktu | 5 menit lalu | Text, absolut dan relatif |
| Perubahan | Harga Beli: Rp 12.000 → Rp 12.500 | Tabel nilai lama ke nilai baru, bisa diperluas |
| Log Turunan | 3 perubahan terkait | Accordion, hanya bila ada |
7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Event | Multi Select | Event yang pernah tercatat (BR-05) | Kosong |
| Jenis Log | Multi Select | Jenis log yang pernah tercatat (BR-05) | Kosong |
| Pelaku | Multi Select | Pengguna yang pernah tercatat sebagai pelaku (BR-05) | Kosong |
| Tanggal | Date 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Halaman hanya bisa dibuka pengguna dengan izin list log aktivitas; lainnya diarahkan ke unauthorized. |
| AC-01.2 | Setiap log menampilkan pelaku, pesan, jenis log, event, dan waktu. |
| AC-01.3 | Log dimuat bertahap lewat tombol muat lebih banyak; tombol disembunyikan bila data habis. |
| AC-01.4 | Perubahan field ditampilkan sebagai tabel nilai lama → nilai baru; nilai kosong ditandai sebagai tidak ada nilai. |
| AC-01.5 | Log yang punya log turunan menampilkan akordeon “lihat perubahan terkait”. |
| AC-01.6 | Pelaku sudah dihapus — log tetap harus bisa ditampilkan (BR-01). |
| AC-01.7 | Nilai 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Filter event, jenis log, dan pelaku berupa pilihan multi yang mengikuti data log yang pernah tercatat (BR-05). |
| AC-02.2 | Filter 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.3 | Filter tersimpan di URL dan dipulihkan saat halaman dibuka ulang. |
| AC-02.4 | Filter bisa direset ke kosong. |
| AC-02.5 | URL 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Tombol Log Aktivitas di halaman daftar menampilkan log semua data fitur; di halaman detail menampilkan log data tersebut saja. |
| AC-03.2 | Panel memakai format tampilan yang sama dengan halaman global, dengan filter event, pelaku, dan rentang tanggal. |
| AC-03.3 | Fitur tanpa log aktivitas — Peran & Izin dan Pengelola File belum punya panel log di UI. |
9. User Scenarios
| Role | Scenario |
|---|---|
| Owner | Mencari siapa yang mengubah harga beli produk minggu lalu |
| Auditor | Menyaring semua perubahan yang dilakukan satu pengguna dalam rentang tanggal tertentu |
| Owner | Memeriksa perubahan peran dan hak akses setelah ada insiden |
| Admin | Membagikan tautan hasil filter log ke rekan (filter tersimpan di URL) |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat Log Aktivitas (Global) | settings:activity-log:list:any | — |
| Lihat Log Aktivitas (Per Fitur) | Izin lihat daftar atau detail pada fitur terkait | Mengikuti 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.