Memulai

Panduan login, navigasi awal, dan konsep dasar yang perlu dipahami sebelum memakai Lenz.

Pengenalan

Halaman ini memandu Anda dari pertama kali membuka Lenz hingga siap menggunakan fitur-fiturnya. Anda akan mempelajari cara login, struktur navigasi sidebar, serta tiga konsep kunci — Role, Federation Mode, dan pengaturan tampilan — yang menentukan apa yang bisa Anda akses dan bagaimana sistem berperilaku.

Anda perlu akun yang sudah di-provision oleh administrator untuk login. Hubungi admin sistem Anda jika belum punya kredensial.

Buka URL Lenz

Buka peramban dan akses URL Lenz Anda — misalnya https://lenz.example.com untuk deployment produksi, atau http://localhost:5173 untuk lingkungan pengembangan.

Masukkan kredensial

Isi field Username / Email dan Password yang diberikan oleh administrator.

Sistem memvalidasi kredensial via endpoint POST /api/auth/token. Jika berhasil, Anda akan diarahkan ke halaman utama Dashboard.

Login via API key digunakan untuk keperluan service-to-service atau pengujian cepat tanpa sesi interaktif. Token yang dihasilkan memiliki hak akses sesuai API key yang dipakai.

curl -X POST "${VITE_API_URL}/api/auth/token" \
  -H "x-api-key: <YOUR_API_KEY>"

Ganti <YOUR_API_KEY> dengan API key yang telah di-generate di halaman Configuration → API Key. Respons yang berhasil mengembalikan access token yang dapat dipakai untuk request selanjutnya.

Sidebar di sisi kiri layar adalah titik masuk utama ke semua fitur Lenz. Menu dikelompokkan berdasarkan fungsi sehingga Anda dapat langsung menuju bagian yang dibutuhkan. Menu yang tidak muncul berarti role akun Anda tidak memiliki permission untuk mengaksesnya — bukan berarti fitur tersebut tidak tersedia di sistem.

Streams & Video

Daftar CCTV per site, manajemen video, analitik offline, dan assignment pipeline ke stream.

Events & Alerts

Live events, riwayat event, alert history, dan aturan notifikasi.

Search

Pencarian wajah, plat kendaraan, log pencarian, dan log face match.

Enrollment

Pendaftaran wajah dan plat kendaraan ke database sistem.

Monitoring

Resource Visionaire, statistik analitik, floorplan, dan tracking.

Configuration

User & role, API key, preferences, retention, alert, media server, workflows, dan lisensi.

Peta Halaman Lengkap

Tabel berikut mencantumkan seluruh halaman yang tersedia di Lenz beserta tujuan utamanya.

Menu	Tujuan Utama
Streams	Daftar dan manajemen stream CCTV per node
Stream Detail	Tampilan live stream satu kamera beserta analitik
Streams — Site	Kelola pengelompokan stream berdasarkan site
Video Management	Manajemen rekaman dan file video
Video Analysis	Analitik video offline; lihat hasil analisis per job
Assignment	Hubungkan pipeline analitik ke stream tertentu
Tracking	Pelacakan objek lintas kamera
Events	Live event feed dari seluruh stream
Event History	Riwayat event yang sudah terjadi
Alert History	Riwayat alert yang dipicu oleh aturan notifikasi
Face Search	Pencarian wajah berdasarkan gambar atau parameter
Plate Search	Pencarian plat kendaraan
Search	Halaman pencarian terpadu
Face Search Logs	Riwayat aktivitas pencarian wajah
Plate Search Logs	Riwayat aktivitas pencarian plat
Audit Logs	Log seluruh aktivitas pengguna di sistem
Face Match Logs	Riwayat hasil pencocokan wajah
Face Enrollment	Daftarkan wajah ke database pengenalan
Plate Enrollment	Daftarkan plat kendaraan ke database
User Access	Kelola akun pengguna dan assignment role
API Key	Generate dan kelola API key
Model API Key	Kelola API key untuk model eksternal
Retention Config	Atur kebijakan retensi data
Alert	Buat dan kelola aturan alert
Remotes	Manajemen instance Visionaire remote
License	Status dan manajemen lisensi sistem
Notification Channels	Konfigurasi kanal notifikasi (email, webhook, dll.)
Credentials	Kelola kredensial pihak ketiga
Workflows	Buat dan kelola alur kerja otomasi
Media Servers	Manajemen NVR dan server rekaman
Sites	Kelola lokasi fisik (site)
Resource Monitoring	Pantau penggunaan CPU, memori, dan GPU Visionaire
Statistics	Statistik analitik agregat
Floorplans	Tampilan denah lantai dengan posisi kamera
Preferences	Pengaturan akun, tema, bahasa, dan feature flag
Account	Profil dan pengaturan akun Anda
Extension Settings	Konfigurasi ekstensi yang terpasang

Konsep Penting Sebelum Mulai

Role & Permissions

Setiap akun memiliki satu role yang menentukan menu dan tindakan apa saja yang dapat diakses. Role bawaan yang tersedia adalah superadmin, admin, operator, dan viewer — masing-masing dengan cakupan permission yang berbeda. Jika sebuah menu tidak muncul di sidebar Anda, kemungkinan besar role Anda tidak memiliki permission untuk resource tersebut; hubungi administrator untuk penyesuaian.

Jika Anda mendapatkan respons 403 Forbidden, hubungi administrator untuk menambahkan permission yang dibutuhkan ke role Anda.

Federation Mode

Federation Mode adalah toggle yang tersedia di Preferences → Feature. Saat aktif, Lenz mengelola beberapa backend Visionaire sekaligus dan menyertakan parameter instance pada setiap request API agar data dari setiap instance tidak bercampur. Pengaturan ini umumnya diaktifkan oleh administrator sistem — sebagai operator sehari-hari, Anda tidak perlu mengubahnya kecuali diarahkan.

Tema & Bahasa

Lenz mendukung dark mode dan light mode, serta antarmuka dalam Bahasa Indonesia dan English. Untuk mengubah preferensi tampilan, buka halaman Preferences dari menu sidebar atau klik avatar akun Anda di sudut kanan atas. Pilihan bahasa juga tersedia langsung di halaman login.

Logout

Untuk keluar dari sesi, klik avatar atau nama akun Anda di sudut kanan atas, lalu pilih Logout. Sistem akan merevoke token aktif via POST /api/auth/logout, sehingga sesi tidak dapat dilanjutkan tanpa login ulang. Pastikan Anda logout dari perangkat bersama untuk menjaga keamanan akun.