Plate Enrollment

Pengenalan

Plate Enrollment adalah proses mendaftarkan plat nomor kendaraan ke dalam sistem sebagai data referensi yang digunakan oleh mesin License Plate Recognition (LPR). Konsepnya serupa dengan Face Enrollment, namun objek yang diidentifikasi adalah kendaraan, bukan wajah orang.

Setiap enrollment plat menyimpan satu atau lebih foto kendaraan beserta atribut kendaraan: nama pemilik, nomor plat, merek, warna, jenis, dan status. Ketika kamera LPR membaca plat nomor dari kendaraan yang melintas, sistem mencocokkan hasilnya dengan database enrollment ini dan menghasilkan event yang merujuk pada data kendaraan yang terdaftar.

Cara Menggunakan

Menambah Plat Nomor Baru

Mengedit Enrollment Plat

Menghapus Enrollment Plat

Untuk menghapus satu enrollment: klik ikon Hapus di kolom Aksi pada baris yang sesuai, kemudian konfirmasi dialog yang muncul. Dialog akan menampilkan nama pemilik dan nomor plat untuk memastikan data yang akan dihapus sudah benar.

Untuk menghapus beberapa enrollment sekaligus: centang baris yang ingin dihapus menggunakan checkbox di kolom paling kiri, lalu klik tombol Hapus Terpilih (N) di toolbar, dan konfirmasi dialog konfirmasi massal.

Pencarian dan Filter

Tabel Plate Enrollment menyediakan beberapa cara untuk menemukan data:

• Cari berdasarkan nama pemilik atau nomor plat — ketik di kotak pencarian di toolbar; pencarian berjalan setelah jeda singkat (debounce 500ms)
• Filter Status — pilih status dari dropdown untuk menampilkan hanya enrollment dengan status tertentu
• Reset Filter — klik tombol Reset Filter untuk menghapus semua filter aktif sekaligus
• Pagination — navigasi antar halaman dan atur jumlah data per halaman (default: 10 data per halaman)

Konsep Plat Nomor Indonesia

Format plat nomor kendaraan di Indonesia terdiri dari tiga bagian:

[Kode Wilayah] [Nomor] [Seri Huruf]
Contoh: B 1234 ABC

Beberapa kode wilayah yang umum digunakan:

Fitur Utama

API Reference

Semua endpoint memerlukan header Authorization: Bearer <token>. Basis URL mengikuti variabel lingkungan VITE_API_URL yang dikonfigurasi pada instalasi Lenz.

Seluruh request yang mengirim data kendaraan (POST dan PUT) menggunakan Content-Type: multipart/form-data karena menyertakan file gambar.

GET /api/enrolled-plates — Daftar Plat Terdaftar

Mengambil daftar enrollment plat dengan dukungan pagination, pencarian, dan filter status.

curl "${VITE_API_URL}/api/enrolled-plates?page=1&limit=10&search=B+1234" \
  -H "Authorization: Bearer ${TOKEN}"

{
  "ok": true,
  "message": "successfully get enrolled plates",
  "result": {
    "limit": 10,
    "current_page": 1,
    "total_data": 2,
    "total_page": 1,
    "offset": 0,
    "vehicles": [
      {
        "id": 1,
        "unique_id": "VH-001",
        "name": "Budi Santoso",
        "plate_number": "B 1234 ABC",
        "type": "car",
        "brand": "Toyota",
        "color": "Putih",
        "status": "whitelist",
        "created_at": "2024-01-01T00:00:00Z",
        "updated_at": "2024-01-01T00:00:00Z",
        "deleted_at": null,
        "vehicles": [
          { "id": 1, "enrolled_plate_id": 1, "variation": 1, "created_at": "2024-01-01T00:00:00Z" }
        ]
      }
    ]
  }
}

POST /api/enrolled-plates — Tambah Plat Baru

Mendaftarkan satu kendaraan baru ke sistem. Content-Type harus multipart/form-data.

curl -X POST "${VITE_API_URL}/api/enrolled-plates" \
  -H "Authorization: Bearer ${TOKEN}" \
  -F "name=Budi Santoso" \
  -F "plate_number=B 1234 ABC" \
  -F "brand=Toyota" \
  -F "color=Putih" \
  -F "type=car" \
  -F "status=whitelist" \
  -F "images=@/path/to/foto-kendaraan.jpg"

{
  "ok": true,
  "message": "successfully enrolled plate",
  "result": {
    "id": 42,
    "unique_id": "VH-042",
    "name": "Budi Santoso",
    "plate_number": "B 1234 ABC",
    "type": "car",
    "brand": "Toyota",
    "color": "Putih",
    "status": "whitelist",
    "created_at": "2024-06-01T08:00:00Z",
    "updated_at": "2024-06-01T08:00:00Z",
    "deleted_at": null
  }
}

GET /api/enrolled-plates/:id — Detail Plat

Mengambil detail lengkap satu enrollment plat berdasarkan ID numeriknya, termasuk daftar variasi gambar.

curl "${VITE_API_URL}/api/enrolled-plates/42" \
  -H "Authorization: Bearer ${TOKEN}"

{
  "ok": true,
  "message": "successfully get detail enrolled plate",
  "vehicle": {
    "id": 42,
    "unique_id": "VH-042",
    "name": "Budi Santoso",
    "plate_number": "B 1234 ABC",
    "type": "car",
    "brand": "Toyota",
    "color": "Putih",
    "status": "whitelist",
    "created_at": "2024-06-01T08:00:00Z",
    "updated_at": "2024-06-01T08:00:00Z",
    "deleted_at": null,
    "vehicles": [
      { "id": 10, "enrolled_plate_id": 42, "variation": 1, "created_at": "2024-06-01T08:00:00Z" }
    ]
  }
}

PUT /api/enrolled-plates/:id — Update Plat

Memperbarui data enrollment plat yang sudah ada. Content-Type harus multipart/form-data. Field name, plate_number, dan brand tetap wajib diisi meskipun nilainya tidak berubah.

curl -X PUT "${VITE_API_URL}/api/enrolled-plates/42" \
  -H "Authorization: Bearer ${TOKEN}" \
  -F "name=Budi Santoso" \
  -F "plate_number=B 1234 ABC" \
  -F "brand=Toyota" \
  -F "status=blacklist" \
  -F "images=@/path/to/foto-baru.jpg"

DELETE /api/enrolled-plates/:id — Hapus Plat

Menghapus enrollment plat secara permanen beserta seluruh data foto yang terkait.

curl -X DELETE "${VITE_API_URL}/api/enrolled-plates/42" \
  -H "Authorization: Bearer ${TOKEN}"

{
  "ok": true,
  "message": "successfully deleted enrolled plate"
}

GET /api/vehicles — Daftar Kendaraan

Mengambil daftar kendaraan yang tersedia di sistem. Endpoint ini digunakan secara internal untuk keperluan referensi data kendaraan.

curl "${VITE_API_URL}/api/vehicles" \
  -H "Authorization: Bearer ${TOKEN}"

GET /api/enrolled-plates/statuses — Status Enrollment

Mengambil ringkasan jumlah enrollment yang dikelompokkan berdasarkan status. Digunakan untuk menampilkan pilihan filter status di toolbar.

curl "${VITE_API_URL}/api/enrolled-plates/statuses" \
  -H "Authorization: Bearer ${TOKEN}"

{
  "ok": true,
  "message": "success",
  "result": {
    "total": 150,
    "statuses": [
      { "status": "whitelist", "total": 100 },
      { "status": "blacklist", "total": 30 },
      { "status": "normal", "total": 20 }
    ]
  }
}

Format Foto Kendaraan

• Format file — JPEG atau JPG saja; file PNG atau format lain tidak diterima
• Jumlah foto — minimal satu foto per enrollment; tidak ada batas maksimum yang didokumentasikan, namun rekomendasi 2–3 foto (tampak depan, tampak belakang, dan tampak samping) untuk referensi visual yang lebih baik
• Resolusi — rekomendasi minimum 640×480 piksel; foto beresolusi rendah dapat menyulitkan identifikasi visual
• Komposisi — plat nomor harus terlihat jelas dan tidak tertutup; pencahayaan merata; hindari foto malam hari tanpa lampu yang memadai
• Kualitas — tidak buram, tidak terpotong di area plat, tidak terhalang benda atau orang lain
• Ukuran file — tidak ada batasan ukuran yang ditetapkan secara eksplisit, namun disarankan di bawah 5 MB per file untuk performa upload yang optimal

Tips dan Troubleshooting

Selanjutnya