Face Enrollment
Daftarkan wajah ke sistem untuk dipakai dalam Face Recognition matching, lengkap dengan custom field, alias, dan batch import.
Pengenalan
Face Enrollment adalah proses mendaftarkan data wajah seseorang ke dalam sistem sebagai data referensi yang digunakan oleh mesin Face Recognition. Setiap enrollment menyimpan satu atau lebih foto wajah, data identitas (nama, NIK, tanggal lahir, dan seterusnya), serta metadata tambahan seperti alias dan custom field. Data inilah yang menjadi acuan ketika sistem mencocokkan wajah yang tertangkap kamera CCTV secara real-time.
Setiap enrollment diidentifikasi oleh face_id — sebuah pengenal unik yang digenerate otomatis atau dapat ditentukan secara manual. Enrollment juga terikat pada sebuah keyspace, yaitu ruang isolasi populasi yang memungkinkan Anda memisahkan kumpulan enrollment untuk keperluan berbeda (misalnya: karyawan, tamu VIP, atau unit kerja tertentu). Ketika sebuah wajah terdeteksi di kamera, sistem mencari kecocokan di dalam keyspace yang dikonfigurasi dan menghasilkan event yang merujuk pada face_id yang cocok.
Setiap wajah yang Anda daftarkan akan dikonversi menjadi embedding vector dan disimpan di Fremis. Ketika kamera CCTV mendeteksi wajah, sistem mencocokkan dengan database enrollment ini secara real-time.
Untuk mendaftarkan wajah dari watchlist Interpol atau cekal imigrasi, gunakan halaman khusus: Interpol Enrollment dan Cekal Enrollment. Halaman ini hanya membahas enrollment biasa (umum).
Cara Menggunakan
Menambah Wajah Baru
Buka menu Face Enrollment
Akses halaman /face-enrollment dari sidebar Lenz Dashboard. Anda akan melihat tabel daftar enrollment yang sudah ada beserta toolbar di bagian atas.
Klik tombol "Daftarkan Orang Baru"
Di toolbar, klik tombol Daftarkan Orang Baru untuk membuka form pendaftaran perorangan. Jika Anda ingin mendaftarkan banyak orang sekaligus, gunakan tombol Pendaftaran Massal — lihat Batch Import di bawah.
Isi data identitas
Lengkapi informasi berikut pada form:
- Nama — nama lengkap, wajib diisi
- Nomor Identitas / NIK — pengenal unik untuk individu ini, wajib diisi
- Tanggal Lahir — format
YYYY-MM-DD, opsional - Tempat Lahir — opsional
- Jenis Kelamin — pilih
maleataufemale, opsional - Nama Alias — nama panggilan atau nama lain yang digunakan orang ini, opsional, dapat diisi hingga 3 alias
Alias berfungsi sebagai nama alternatif yang dapat dipakai untuk pencarian. Gunakan alias untuk nama panggilan, nama sebelum menikah, atau ejaan alternatif.
Upload foto wajah
Gunakan area Gambar Wajah untuk mengunggah satu atau lebih foto. Foto harus berformat JPEG/JPG. Seret file ke area dropzone, atau klik untuk memilih dari file manager.
Anda dapat mengunggah lebih dari satu foto per orang untuk meningkatkan akurasi matching pada kondisi angle dan pencahayaan yang berbeda. Setiap foto akan menjadi satu variasi (variation) dalam sistem.
(Opsional) Isi Custom Field
Jika administrator sistem telah mengkonfigurasi custom field di menu Configuration, bidang-bidang tambahan akan muncul di bagian Informasi Tambahan. Custom field mendukung tipe data: Input Teks, Area Teks, Angka, Tanggal, Boolean, Dropdown, File, dan Gambar.
Jika custom field tidak muncul, hubungi administrator untuk mengkonfigurasinya terlebih dahulu.
(Opsional) Atur Keyspace
Secara default, enrollment disimpan di keyspace default. Jika sistem Anda menggunakan beberapa keyspace untuk memisahkan populasi, pilih keyspace yang sesuai. Enrollment di keyspace berbeda tidak akan saling mempengaruhi dalam proses matching.
Klik "Daftarkan Orang"
Klik tombol Daftarkan Orang untuk menyimpan. Sistem akan mengirimkan data ke POST /api/enrollment menggunakan multipart/form-data. Setelah berhasil tersimpan, embedding vector akan digenerate secara asinkron di background oleh Fremis.
Mengedit Enrollment
Buka enrollment yang ingin diedit
Klik baris pada tabel, atau klik ikon Edit di kolom Aksi pada baris yang sesuai. Form edit akan terbuka dalam mode tampilan (view) terlebih dahulu.
Aktifkan mode edit
Klik tombol Edit di dalam dialog untuk mengaktifkan mode pengeditan.
Ubah field yang diinginkan
Semua field yang tersedia pada form tambah juga dapat diubah di sini, termasuk nama, NIK, tanggal lahir, gender, tempat lahir, alias, status, dan custom field.
Kelola foto (opsional)
- Tambah foto baru — gunakan area Gambar Tambahan untuk mengunggah foto tambahan
- Hapus foto lama — klik tombol hapus pada foto yang ingin dihapus; foto yang dihapus akan masuk ke daftar
deleted_variationsyang dikirim saat update
Simpan perubahan
Klik Perbarui Orang untuk menyimpan. Sistem akan memanggil PUT /api/enrollment/:id.
Menghapus Enrollment
Penghapusan bersifat permanen. Embedding vector di Fremis juga akan dihapus bersamaan. Data tidak dapat dipulihkan setelah dihapus.
Untuk menghapus satu enrollment: klik ikon Hapus di kolom Aksi pada baris yang sesuai, kemudian konfirmasi dialog yang muncul.
Untuk menghapus beberapa enrollment sekaligus: centang baris yang ingin dihapus, lalu klik tombol Hapus Terpilih (N) di toolbar, dan konfirmasi dialog konfirmasi massal.
Pencarian dan Filter
Tabel enrollment menyediakan beberapa cara untuk menemukan data:
- Cari berdasarkan nama atau ID — ketik di kotak pencarian di toolbar; pencarian berjalan setelah jeda singkat (debounce)
- Filter Status — pilih status enrollment dari dropdown untuk menampilkan hanya enrollment dengan status tertentu
- Filter Custom Field — jika custom field dikonfigurasi sebagai filterable, filter tambahan akan muncul otomatis di toolbar
- Pagination — navigasi antar halaman dan atur jumlah data per halaman
- URL sinkron — semua filter dan pagination tersimpan di URL, sehingga halaman dapat di-bookmark dan dibagikan
Batch Import
Untuk mendaftarkan banyak orang sekaligus, gunakan fitur Pendaftaran Massal:
- Klik tombol Pendaftaran Massal di toolbar
- Unduh template CSV dengan klik Unduh Contoh CSV untuk melihat format yang diperlukan
- Siapkan folder dengan struktur: folder
face_images/berisi subfolder per orang (contoh:john_doe/,jane_smith/), dan subfolder per orang berisi foto-fotonya - Isi file CSV sesuai template — kolom
folder_namemerujuk pada nama subfolder diface_images/ - Untuk custom field bertipe file atau image, siapkan folder terpisah dan upload bersama CSV
- Upload CSV dan folder gambar wajah, lalu klik Mulai Pendaftaran Massal
- Biarkan jendela terbuka hingga proses selesai — menutup jendela akan menghentikan proses
Log progress tersedia selama proses berjalan. Setelah selesai, Anda dapat mengunduh CSV daftar enrollment yang gagal dan log error untuk ditindaklanjuti.
Fitur Utama
Multi-foto per orang
Simpan banyak variation wajah untuk meningkatkan akurasi matching pada angle dan pencahayaan berbeda.
Custom Field
Tambahkan atribut tambahan bertipe teks, angka, tanggal, boolean, dropdown, file, atau gambar sesuai kebutuhan.
Alias Names
Daftarkan nama panggilan atau nama alternatif untuk memudahkan pencarian.
Keyspace Isolation
Pisahkan populasi enrollment per use-case agar proses matching tidak bercampur.
Batch Import
Daftarkan banyak orang sekaligus melalui CSV dan folder gambar yang terstruktur.
Status & Filter
Kelola status enrollment dan filter data dengan cepat melalui toolbar pencarian yang komprehensif.
API Reference
Dokumentasi endpoint lengkap (parameter, request body, contoh response, dan code sample dalam berbagai bahasa) tersedia di halaman terpisah:
Format Foto yang Didukung
- Format file — JPEG atau JPG saja; file PNG atau format lain tidak diterima
- Jumlah foto — minimal satu foto per enrollment; tidak ada batas maksimum, namun rekomendasi 3–5 foto untuk hasil terbaik
- Resolusi — rekomendasi minimum 480×480 piksel; foto beresolusi rendah dapat menyebabkan embedding gagal digenerate
- Komposisi — satu wajah per foto; wajah menghadap ke depan atau sedikit menyamping; pencahayaan merata dan cukup
- Kualitas — tidak buram, tidak terpotong di area wajah, tidak terhalang benda
- EXIF — data EXIF (lokasi, perangkat) dihapus otomatis oleh backend untuk menjaga privasi