Bot OCR KK — Ekstraksi Data lewat Telegram
Bot Telegram yang mengekstrak foto Kartu Keluarga memakai Google Gemini, memvalidasi data dan referensi wilayah, lalu menyimpan hasilnya ke basis data SmartGov.
Tangkapan layar
Ringkasan
Apa yang dikerjakan sistem ini.
Bot OCR KK membantu operator desa mengubah informasi dari foto Kartu Keluarga menjadi data terstruktur. Operator masuk lewat perintah bot, memeriksa sesinya, dan mengirim foto kartu keluarga; layanan OCR berbasis Google Gemini membaca identitas keluarga dan seluruh anggota yang tercantum.
Hasil ekstraksi melewati pembersihan teks, penguraian tanggal, validasi field, pencocokan data referensi kependudukan, dan pemeriksaan kode wilayah sebelum disimpan. Layanan pembuatan data mencocokkan atau membuat entri keluarga dan penduduk di MySQL sesuai struktur SmartGov, sementara operator menerima respons progres dan pesan kesalahan langsung di Telegram.
Implementasinya memakai Node.js dengan handler bot, perintah, dan autentikasi yang terpisah, ditambah layanan OCR, validasi, referensi, wilayah, dan pembuatan data. Sharp memproses gambar sebelum dikirim ke model, Winston mencatat log aplikasi, dan utilitas metrik evaluasi mengukur kualitas ekstraksi. Aplikasinya dipaketkan dengan Docker dan Docker Compose.
Daftar fitur
Rincian kemampuan
13 kemampuan yang diverifikasi langsung terhadap kode sumber proyek.
- Perintah bot untuk memulai, masuk, dan memeriksa sesi
- Penerimaan foto Kartu Keluarga melalui Telegram
- Ekstraksi data keluarga dan anggota memakai Google Gemini
- Pemrosesan gambar sebelum dikirim ke layanan OCR
- Pembersihan teks dan penguraian format tanggal
- Validasi field hasil ekstraksi
- Pencocokan data referensi kependudukan
- Penelusuran dan pemeriksaan kode wilayah
- Pembuatan atau pencocokan data keluarga dan penduduk
- Hasil tersimpan di MySQL mengikuti struktur data SmartGov
- Utilitas metrik evaluasi untuk mengukur kualitas ekstraksi
- Respons progres dan pesan kesalahan untuk operator
- Pencatatan log aplikasi dan pemaketan Docker Compose
Teknologi
Dibangun dengan 7 teknologi.
- Node.js
- Telegram Bot API
- Google Gemini
- MySQL
- Sharp
- Winston
- Docker
Pertanyaan umum
Yang biasanya ditanyakan.
Kenapa lewat Telegram, bukan unggahan web?
Karena operator desa memang sudah memotret dokumen dengan ponselnya. Bot menghapus langkah memindahkan foto itu ke komputer lalu ke formulir; mereka mengirimkannya dari tempat mereka sudah berada.
Apa yang mencegah hasil OCR yang salah masuk ke basis data?
Teks hasil ekstraksi melewati pembersihan, penguraian tanggal, validasi field, pencocokan referensi kependudukan, dan pemeriksaan kode wilayah sebelum apa pun ditulis, dan operator melihat kesalahannya di chat, bukan setelah terlanjur tersimpan.
Bagaimana kualitas ekstraksi diukur?
Ada utilitas metrik evaluasi yang menilai hasil ekstraksi, sehingga perubahan pada prompt atau pra-pemrosesan gambar bisa dinilai dengan angka, bukan dengan kesan.
Satu bidang
Proyek serupa.
SmartGovt — Administrasi & Pelayanan Desa
Platform pemerintahan desa: data penduduk dan keluarga, layanan surat, GIS, statistik wilayah, administrasi RT/RW, portal warga, dan penilaian Desa Anti Korupsi.
Laravel 12 · PHP 8.2 · Blade · Alpine.js · +15
Mekar Cilacap — Portal & Marketplace BUMDes/KMP
Platform digitalisasi BUMDes Kabupaten Cilacap: frontend Next.js 16 dengan API Laravel terpisah untuk direktori badan usaha, marketplace produk, buku kas dan laporan bulanan, LPJ, program kerja, dan bagi hasil.
Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · +10
Web Builder — SaaS Website Desa
Platform SaaS multi-tenant untuk website desa: editor visual GrapesJS, domain kustom dengan TLS on demand, impor WordPress, analisis SEO, dan integrasi data SmartGovt.
Next.js 15 · React 19 · TypeScript · Laravel 13 · +12