Lompat ke konten utama
StableTerakhir diperbarui: 9 Okt 2026, 09.28

Log Aktivitas Tenant

Log Aktivitas (Audit Log) merekam setiap tindakan mutasi, penghapusan, pembaruan akses, dan pengaturan kritis yang dilakukan oleh semua staf dalam portal admin tenant DagangBot Anda. Fasilitas ini sangat krusial bagi kepatuhan bisnis, penyelesaian sengketa kesalahan pengoperasian (human error), dan pemantauan keamanan operasional berkelanjutan. Log aktivitas menyajikan data historis secara komprehensif, dari perubahan harga hingga pengubahan konfigurasi tingkat lanjut.

Stable

1. Ikhtisar & Nilai Bisnis

Rekam jejak mutasi menjamin pertanggungjawaban dalam seluruh siklus operasional aplikasi. Pada platform dengan ribuan penyesuaian inventaris per hari, keberadaan pelacakan mutasi otomatis menjadi fondasi pengawasan tingkat atas. Manfaat utama log aktivitas:

  • Transparansi Staf dan Peran (Role Accountability): Mengetahui secara pasti siapa yang menghapus produk diskon, mengedit prompt dasar, atau membalas pesan secara manual. Anda tidak akan pernah kehilangan kendali tentang "siapa melakukan apa" dan "kapan". Rekaman mencakup ID spesifik pengguna (user_id), email, nama staf, beserta peran manajerial yang melekat.
  • Penelusuran Kesalahan (Forensik Insiden): Jika sebuah perubahan operasional menghambat proses penjualan otomatis, admin pusat dapat melakukan investigasi rentang waktu kejadian. Pemulihan dari kelalaian (human error) sangat bergantung pada visibilitas waktu absolut dan konteks mutasi.
  • Pencatatan Konteks Detail Jaringan: Log ini tidak hanya membungkus muatan (payload) asli data, namun juga mencatat alamat IP Address publik dan spesifikasi perangkat peramban web staf (melalui atribut User Agent). Pelacakan alamat IP ini krusial saat mengidentifikasi akses mencurigakan dari jaringan asing.
  • Isolasi Keamanan Lintas-Cabang (Multi-Branch Security): Arsitektur sistem DagangBot akan memastikan isolasi data; pengguna yang hanya diberi hak melihat operasional Cabang A dipastikan tidak mampu memeriksa data log riwayat penghapusan yang menimpa Cabang B.
Log Tidak Dapat Dimodifikasi

Struktur log bersifat tambahan-saja (append-only) pada sisi arsitektur database platform. Entri rekam jejak ini dikunci secara mutlak; tidak bisa dihapus atau disunting oleh entitas admin tenant mana pun. Ketegasan desain ini memastikan catatan tetap netral, dapat diandalkan (tamper-proof), dan utuh secara historis.

2. Alur Visual & Antarmuka

Antarmuka log disajikan sebagai barisan data berbentuk tabel raksasa (data grid), dilengkapi saringan (filter) khusus untuk meringankan navigasi pencarian di tengah ribuan kueri harian. Tabel utama menyuguhkan kolom-kolom referensi kilat yang menguraikan identitas subjek pelaksana, objek tipe (resource type), serta stempel waktu presisi. Admin tidak perlu berpindah halaman berkat hadirnya jendela rincian sembulan (modal dialog) untuk membedah objek JSON.

3. Panduan Langkah-demi-Langkah

Untuk melacak kembali aktivitas operasional staf harian secara prosedural, ikuti serangkaian instruksi komprehensif berikut.

  1. 1

    Langkah 1: Membuka Modul Audit Log

    Dari panel navigasi sisi kiri di dasbor portal DagangBot, cari dan pilih menu Pengaturan Akses (di beberapa instalasi disebut Keamanan), lalu pilih navigasi tab Log Aktivitas (Audit Log). Modul mungkin memerlukan sepersekian detik untuk mengalkulasi indeks pangkalan data terbaru.

  2. 2

    Langkah 2: Menyaring Rentang Waktu (Date Range)

    Saat layar selesai dimuat, Anda secara otomatis melihat entri kejadian yang dieksekusi teranyar (descending order). Gunakan antarmuka input date picker untuk menyaring parameter histori start_date dan end_date. Anda disarankan mengerucutkan pencarian hari atau minggu secara spesifik demi mempercepat keluaran.

  3. 3

    Gunakan kotak kolom pencarian teks bebas yang ada untuk mengetikkan nama entitas target, ID internal transaksi (resource_id), komponen surel staf admin, atau bahkan alamat IP Address. Pemrosesan pencarian akan menyisir melintasi seluruh pangkalan parameter yang tersedia.

  4. 4

    Langkah 4: Menentukan Parameter Jenis Aksi Khusus

    Anda dapat mengelompokkan kategori insiden berisiko tinggi. Klik dropdown tipe aksi (Action) untuk memilih penyaringan tunggal yang persis (misal memfokuskan investigasi hanya pada pencabutan akses atau penghapusan pengguna).

  5. 5

    Langkah 5: Memilih Pembatasan Cabang (Branch Filtering)

    Bila organisasi mengelola ragam lokasi, menu pilih Branch akan mereduksi visibilitas khusus untuk area kantor bersangkutan. Pastikan profil pengguna admin Anda diotorisasi pada level yang sesuai.

  6. 6

    Langkah 6: Memeriksa Rincian Komparasi Kejadian

    Klik baris rekam jejak yang hendak Anda evaluasi. Layar akan memicu dialog rincian berisikan paparan spesifik User Agent (perangkat yang digunakan) serta komparasi Payload mentah (before/after) modifikasi.

4. Parameter & Spesifikasi Teknis

Modul daftar pencarian dilindungi oleh skema mekanisme pembatas jumlah kueri (limit clamp) yang sangat kuat, demi menjamin responsivitas ketersediaan beban di tengah derunya pencatatan arus log yang dapat mencapai belasan ribu mutasi per hari. API peladen dirancang menyeimbangkan ekstraksi data rinci investigatif dan keamanan pangkalan data sentral.

Sistem Filter Pencarian Lanjutan

API backend yang melayani daftar kueri log ini menawarkan serangkaian parameter masukan (query string) yang akan dievaluasi lewat konjungsi (AND) untuk menyempitkan tumpukan hasil luaran:

  • Pencarian Bebas Lebar (Search Wildcard): Mengirimkan parameter kueri search akan memerintahkan basis data PostgreSQL mengeksekusi pemeriksaan pola teks yang tidak mempedulikan huruf besar-kecil (case-insensitive ILIKE matching). Sistem menyuntikkan operator sintaks wildcard (tanda %) pada awalan dan akhiran kueri masukan Anda. Rentang kolom basis data yang tersapu operasi ini meliputi:

    • action (contoh kueri kata kunci aksi delete, suspend, create).
    • resource_type (contoh penargetan spesifik modul product, user, system_prompt).
    • resource_id (amat krusial apabila ID spesifik heksadesimal telah diketahui dan disalin).
    • ip_address (berperan melacak anomali penyerang dari jaringan koneksi internet luar).
    • u.name dan u.email (memeriksa penelusuran aktor berdasarkan penggalan identitas profil).
  • Filter Spesifik Sama-Persis (Exact Literal Match): Alih-alih pencarian leksikal luas, endpoint ini juga memfasilitasi pencocokan parameter yang akurat. Pengiriman parameter kunci seperti action, branch_id, maupun user_id akan ditransformasikan menjadi pencocokan matematis (=), memanfaatkan infrastruktur indeks tabel murni untuk menghasilkan respons milidetik.

  • Standardisasi Filter Rentang Waktu (Date Range Standard): Isian rentang periode pencarian (parameter start_date dan end_date) wajib merujuk secara eksklusif kepada format standar pengenal zona stempel waktu absolut RFC3339. Implementasi keharusan standar ini diberlakukan demi menolak kesalahan kalkulasi akibat perbedaan zona waktu perangkat para staf. Sebagai teladan, format valid 2026-10-08T15:04:05Z menyimbolkan rujukan mutlak pemetaan UTC/GMT nol (Zulu). Modul pemroses internal parser Golang akan langsung menolak dan mengabaikan skema penulisan kalender konvensional seperti pola regional 2026/10/08 15:04.

Arsitektur Paginasi dan Batasan Kapasitas Ekstraksi

Mekanisme pengambilan dataset rekaman menggunakan pola skema paginasi offset-based cursor, yang memastikan konsistensi urutan kronologis kejadian masa lalu:

  • Variabel parameter offset memegang kontrol komando atas kursor lompatan pengabaian barisan historis (titik inisialisasi default disetel murni di sumbu 0).
  • Variabel utama limit secara krusial mendefinisikan batas absolut angka kapasitas baris entri data. Angka kueri luaran skala default dialokasikan di angka 25 unit insiden.
  • Paling mendasar, arsitektur peladen memaksakan penerapan pemotongan batas atas (hard clamping restriction) mutlak di maksimum 200 baris. Kebijakan pertahanan ini krusial melindungi pangkalan data dari ancaman ekstraksi manipulatif (Query of Death). Apabila sebuah sesi mesin antarmuka klien secara tidak sengaja menuntut pengambilan paksa senilai limit=500, alat internal akan diam-diam mereposisi nilainya menyentuh dinding wajar 200 tanpa mengembalikan pesan peringatan galat, sehingga alur pemantauan tabel operasional akan senantiasa berjalan mulus tanpa interupsi keruntuhan sistem memori.

Anatomi Rincian JSON (Muatan Payload details)

Informasi kolom pelengkap atribut details yang disediakan pada tanggapan tabel API dirumuskan dari representasi bungkus json.RawMessage murni. Kontainer ini menyerap tangkapan rincian objek muatan rekam data sistem sebelum dieksekusinya pembaruan operasional akhir. Skema arsitektur DagangBot memastikan adanya proses pemurnian otomatis (sanitization coercion). Sekiranya aksi murni tidak membawa substansi internal tubuh modifikasi (misalnya insiden login, penghapusan, atau penonaktifan absolut), utilitas penormalisasi backend akan menyulap muatan data null rentan keruntuhan pembacaan, ke representasi fungsional braket pelindung himpunan kosong {}.

Berikut rujukan ilustrasi skenario lapangan yang menunjukkan bentuk asli muatan objek respons JSON details saat direktur cabang berencana memperbarui limit anggaran profil harian serta nomenklatur papan nama gerai kantor cabangnya secara simultan:

json
{
  "action_type": "branch_budget_and_identity_modification",
  "actor_role": "tenant_branch_manager",
  "previous_state": {
    "branch_name": "Kantor Cabang Lama Sudirman",
    "is_active": true,
    "daily_budget_limit": 500000,
    "whatsapp_enabled": false
  },
  "new_state": {
    "branch_name": "Gerai Sentral Sudirman Utama",
    "is_active": true,
    "daily_budget_limit": 1250000,
    "whatsapp_enabled": true
  },
  "modified_fields": [
    "branch_name", 
    "daily_budget_limit",
    "whatsapp_enabled"
  ],
  "justification_notes": "Akselerasi pemasaran periode jelang musim belanja."
}

Arsitektur pencatatan format struktur dinamis (schema-less payload format) ini memungkinkan pihak desainer UI merender modul antarmuka beda selisih yang secara presisi mewarnai rincian tambahan status modifikasi blok baru menggunakan sorotan markah warna hijau berderet dengan informasi lawas yang usang, menjadikan pembedahan riwayat data begitu intuitif untuk ditelusuri.

Ringkasan fungsional parameter operasional sistem pelacakan Log Aktivitas:

Spesifikasi Parameter Query Definisi Tipe Aturan Restriksi Limitasi API Pangkalan Sentral
limit Integer Batas kuota mutlak volume baris rekam luaran log harian halaman. Standar nilai dasar berada pada patokan bawaan 25 unit; restriksi peladen (hard clamping mechanism) melarang keras kueri eksekusi yang melampaui puncak ambang batas aman bernilai 200 rekaman.
offset Integer Kursor instrumen pergeseran lompatan paginasi konvensional, nilai inisialisasi default disetel memijak sumbu awalan 0.
search String Mekanisme penelusuran leksikal komprehensif tipe Wildcard search pattern operator matcher (skema fungsional berbasis operator ILIKE). Menarget dan mencocokkan silang deretan bidikan tabel: action, rentang resource_type, identifikasi resource_id, pelacak letak ip_address, dan identitas turunan profil pengguna yakni u.name yang tersinkronisasi paralel elemen surel akun u.email.
action String Mekanisme filter spesifik identifikasi ekuivalen persis (exact direct match operator) pencarian kaku kategori aksi log. (Contoh kueri: manipulasi penghapusan user_delete_permanently).
branch_id / user_id String UUID Penyaringan filter isolasi selektif untuk reduksi visibilitas pada teritori kewenangan pengelola spesifik kantor cabang bisnis (Branch) bersangkutan ataupun pengurutan penelusuran pelaksana aktivitas milik utuh administrator spesifik.
start_date & end_date String Spesifikasi stempel pengenal tanggal yang dieksekusi secara wajib mematuhi pemetaan konversi absolut terstruktur waktu zona RFC3339 Parser. Parameter masukan kueri wajib merujuk secara persis pada notasi kalibrasi mutlak, layaknya penulisan format 2026-10-08T00:00:00Z.
details (Dalam Response) JSON Mentah Rincian anatomi muatan properti bodi komparasi fragmen modifikasi dinamika rekaman; yang akan segera dikoersi normalisasi pemurnian pelindung himpunan wadah objek kosong {} sekiranya insiden fungsional operasi kueri tak dikonfirmasi menyimpan ketersediaan bodi payload substansi operasional rinci.

5. Relasi & Integrasi

Infrastruktur Audit Log bertindak krusial menduduki posisi pilar penyokong tata integritas visibilitas manajerial, berelasi struktural sangat lekat berkesinambungan secara komprehensif ke pelbagai sinkronisasi ekosistem modul platform tenant lainnya:

  • Manajemen Pengaturan Konfigurasi Prompt Bot DagangBot: Kegagalan operasional interaksi balasan sistem kecerdasan akibat dari krisis insiden modifikasi panduan struktur skrip dasar (System Master Prompt) secara tidak sadar kini bisa dilacak. Pemilik bisnis sanggup melacak siapa figur pasti staf pelaku yang mengubah karakter kecerdasan dan mengembalikannya segera berdasarkan pencatatan stempel waktunya.
  • Portal Pengaturan Hak Level Self-Service RBAC Admin: Seandainya skenario radar pelacak audit mencatat dan mendapati adanya insiden fiktif penghapusan otorisasi staf atau penyusupan pendelegasian area cabang yang bukan wewenang, administrator tingkat kepemilikan tertinggi (Owner Level) langsung sanggup menonaktifkan, mencabut paksa, hingga membatalkan hak kendali pelaku penyabotase profil itu secara permanen.
  • Kontrol Penjualan Commerce Checkout & Status Logistik Pembayaran: Rincian riwayat absolut sengketa komersial pelaporan bukti pemutusan pembatalan sepihak pesanan (insiden Aksi Cancel Order secara sepihak), sewaktu pesanan sesungguhnya sudah lunas ditransfer pembayaran dari nasabah pembeli, terekam menjadi memori rujukan konkret kekal yang tidak akan terbantahkan.
  • Katalog Produk & Perubahan Harga Barang: Melacak jejak kapan persisnya barang persediaan dipadamkan ketersediaannya, serta komparasi perubahan harga produk garmen yang terindikasi dicabut deskripsi potongannya menjelang cetakan stiker label logistik dieksekusi.

6. Pemecahan Masalah (Troubleshooting)

Ikuti instrumen matriks solusi di bawah bila menemukan hambatan atas keluaran anomali tabel atau kendala dari mekanisme antarmuka pencarian riwayat log platform audit ini. Persoalan pelaporan riwayat rekaman umumnya berpusat di rentang waktu sintaksis kalender yang terabaikan, atau keterbatasan penyajian arus ekstraksi kuota pangkalan data.

Gejala Indikasi Keluhan Diagnostik Penyebab Teknis Operasional Resolusi Mitigasi Prosedural
Tombol fitur alat Export ke CSV gagal me-render data bulanan utuh jika antrean hasil rekaman melampaui himpunan beberapa ratusan blok data. Restriksi sistem arsitektur pengamanan sentral batas operasi memaksakan pembatasan pemangkasan ketat ambang batas di luaran variabel limit=200 guna menahan lonjakan tarikan kueri kapasitas pangkalan data. Pemanggilan tugas ekspor rutin endpoint API berskala masif harus dilanjutkan programatik menggunakan skrip pendelegasian iterasi penarikan parsial bertahap memanipulasi rentang rotasi pelompatan indeks parameter offset berlapis (offset programmatic skip pagination loop).
Kueri instrumen penyaring nama pelaksana staf yang diinputkan tidak sanggup memunculkan daftar pengembalian tabel histori aksi terdahulunya. Filter masukan komponen daftar turun dropdown pencarian selektif Exact Match User sayangnya masih terkait membelenggu di ID struktural user_id alih-alih melepaskan sistem pencarian parameter teks murni sapu bebas search. Anda disarankan sangat membebaskan daftar turun setelan filter pengguna ke setelan lengang kosong "Semua Staf", usai itu ketik ejaan parsial profil personel (misal kueri "Joko") murni dalam kotak alat isian bar Search Box. Mekanisme pangkalan data operator Wildcard ILike akan menyisir bebas ke ranah relasional surel surel u.email sekaligus atribut ganda persimpangan elemen irisan u.name.
Gagal melacak jejak rekaman di waktu lampau terbelenggu galat kembalian API merah berstatus notifikasi krisis peringatan "Error invalid date format syntax" Format teks rujukan sintaksis isian pembatas masa parameter operasional utilitas start_date ditolak mentah dan divalidasi gagal patuh paten memeluk stempel rujukan universal mutlak Golang Parser Validation Engine RFC3339. Evaluasi instrumen peramban widget frontend komputasi aplikasi Anda wajib kalibrasi murni dipastikan menyuntikkan referensi format penanggalan yang terikat persis dan taat utuh standar universal notasi zona nol mutlak absolut (Zulu time offset marker), yang tersusun baku semisal string struktur tata letak 2026-10-08T15:04:05Z. Kerangka rujukan sintaks konvensional kedaerahan format lokal tata pola penulisan (seperti keliru mencatat 2026/10/08) tidak disokong dan otomatis digugurkan oleh backend.
Kolom pengenal nama sebutan atribusi spesifik subjek aktor pelaksana operasi di papan tabel secara aneh tercatatkan menggunakan label anonim atribusi misterius "System" Rutinitas peristiwa eksekusi proses fungsional operasi manuver tindakan ini pada realitas lapangan sesungguhnya mutlak tidak dilakukan lewat intervensi inisialisasi administrator biologis fisik perwakilan campur tangan admin staf manusia sejati. Kejadian misterius rujukan atribusi "System" merupakan operasi lumrah rutinitas otonomi yang sangat lazim; seperti kejadian penataan pembatasan pemusnahan periodik Retention Period Policy Data Purge Operation atas sisa dokumen pesan kedaluwarsa melampaui usianya, yang dikerjakan mutlak independen seratus persen otomatis oleh skenario penjadwal periodik siklus sirkuler berkala rutinitas mandiri background backend cron job task berkat pengondisian klausa fungsi database query coercion bernama COALESCE(u.name, 'System').
Kolom elemen himpunan wadah rincian atribut panel tabel pangkalan details muncul disajikan berwujud kosong himpunan lengang bertanda kosongan representasi perlindungan {} tatkala diinspeksi diklik; padahal tindakan diklaim sebagai aksi penyuntingan (Update Modifier Action). Modul aplikasi microservice handler peladen pemicu yang mengatur fungsionalitas bersangkutan tersebut kebetulan gagal, tidak mendukung operasional rekam penuh, absensi absah menyertakan absensi bodi sisipan, hingga luput melampirkan bundel paket injeksi susunan struktur payload modifikasi rincian anatomi muatan pembaruan selisih utuhnya. Operasi fungsional pelaporan aplikasi sistem kejadian tersebut terbatas semata mengantarkan komponen atribut porsi dangkal klasifikasi tipe aksi tipe modifikasi operasional permukaan semata. Modul skema Golang Backend Rest Interface menormalkannya dari titik kerentanan fatal nilai rujukan mentah null di dasar pangkalan diubah bertransformasi menjadi elemen kosongan aman objek {} agar mesin antarmuka peladen klien di ujung pengguna JavaScript UI Client tidak runtuh crash bertabrakan meledak dengan ancaman Null Pointer Exception Array Crash. Apabila informasi spesifik sisa operasional tersebut sangat dibutuhkan utuh, periksa lewat pencocokan eksternal silang di basis tabel fungsional dengan pengenal sasaran rujukan elemen pilar resource_id.
Data insiden kejadian rotasi jejak waktu kronologis siang dan hari senja terkesan terdistorsi, tersisih menghilang anjlok tertinggal anomali bersembunyi menyelusup terbalik memutar menimpa hari esok secara sirkuler tak lazim secara membingungkan. Indikator sinkronisasi paten indeks kueri rentang filter pencarian kursor waktu kalibrasi filter penyaringan waktu rentang tidak merespons kalibrasi paten kesamaan perhitungan mutlak simetris koordinat nol UTC Absolute Persistence Backend Storage Marker Engine Server Index. Sinkronkan preferensi kalkulasi pengaturan rujukan rotasi sistem dasbor UI pelacakan manajemen antarmuka penyaring komersial staf untuk disiplin meneruskan parameter stempel nilai berakhiran pilar penunjuk Zulu Zero Marker stempel huruf mutlak zona (Z) dan senantiasa kalibrasikan komponen komputasi waktu terminal dasar di mesin PC perangkat User Agent mengacu harmonis sinkron bergeser kepada letak persis pusat poros Waktu Universal Terkoordinasi Internasional UTC Universal Equivalent Mapping Sync Coordinate Standard.

7. Referensi Terkait

Pelajari instrumen kontrol keamanan tenant secara komprehensif lewat integrasi panduan navigasi terpadu di modul-modul turunan ini:

content/docs/features/activity-log.mdx
Terakhir diperbarui: 9 Okt 2026, 09.28

Dokumentasi teknis DagangBot