Integrasi Kamera, OCR, dan API untuk Inspeksi Kontainer

Sebelum menghubungkan kamera dan API, tim perlu menyepakati kontrak data. Field dasar meliputi ID inspeksi, nomor kontainer, timestamp, sumber kamera, jenis hasil model, gambar bukti, status review, dan catatan operator.

Kontrak data mencegah integrasi menjadi rapuh. Jika field dan status tidak jelas, dashboard akan sulit membedakan antara data yang belum diproses, data yang gagal dibaca, dan data yang sudah dikoreksi manusia.

Pola yang umum adalah edge device atau service kamera mengirim hasil awal ke API, API menyimpan dan memberi status, lalu dashboard mengambil data terbaru. Live video dapat berjalan langsung dari kamera atau edge device ke browser jika arsitektur membutuhkan latensi rendah.

Pemisahan ini membuat sistem lebih mudah diawasi. Jika OCR bermasalah, tim dapat memeriksa service kamera. Jika data tidak muncul di dashboard, tim dapat memeriksa API, auth, atau format payload tanpa menebak seluruh rantai sekaligus.

Hasil OCR sebaiknya divalidasi terhadap struktur nomor kontainer dan bukti gambar. Validasi format membantu mendeteksi pembacaan yang jelas tidak masuk akal sebelum data dipakai di proses berikutnya.

Namun validasi format bukan bukti bahwa nomor benar. Operator tetap perlu akses ke gambar dan mekanisme koreksi, terutama untuk kontainer dengan cat pudar, pencahayaan buruk, atau angka yang tertutup objek.

Integrasi yang baik menyediakan log yang bisa dipahami operator dan teknisi: kapan frame diterima, kapan OCR selesai, apakah API menerima payload, dan apakah dashboard menampilkan status terbaru.

Tanpa observability, masalah kecil mudah terlihat seperti kegagalan total. Dengan status yang jelas, tim bisa membedakan antara kamera offline, model lambat, API menolak payload, atau browser hanya belum memuat data terbaru.