Pelacak Armada & Kunjungan Canvassing Lapangan

Masalah

Tim yang mengirim orang ke lapangan (canvassing sales, pengiriman, kunjungan) perlu tahu ke mana perjalanan sebenarnya berlangsung. Tantangannya bukan sekadar menampilkan peta, melainkan memastikan data lokasi dari ponsel dengan sinyal tidak stabil tidak pernah hilang diam-diam, dan rute yang mencurigakan mudah terlihat.

Yang Kami Bangun

1. Aplikasi driver Flutter yang merekam GPS ke database lokal, menyaring pergerakan yang tidak berarti langsung di perangkat untuk menghemat baterai dan kuota, mengunggah secara batch, dan baru menghapus data setelah server mengonfirmasi penyimpanannya. Setiap titik membawa penanda lokasi palsu (mock location) dari sistem operasi.
2. API penerimaan data Go yang memvalidasi setiap batch lalu mengirimkannya ke NATS JetStream, dan baru membalas ke ponsel setelah pesan tersimpan dengan aman. Writer terpisah membaca stream dan menulis ke PostgreSQL + PostGIS; penulisan bersifat idempoten sehingga pengiriman ulang tidak menimbulkan duplikat.
3. Dashboard supervisor berbasis Vue dengan peta Leaflet yang menerima pembaruan langsung melalui WebSocket.
4. Layanan anomali rute berbasis Python (FastAPI) yang menilai pola perjalanan yang tidak wajar.
5. Integrasi Odoo 19 melalui XML-RPC, termasuk sinkronisasi data karyawan, serta single sign-on melalui identity provider OIDC di samping login email/password.

Arsitektur & Stack

• Layanan Go (chi, pgx): API penerimaan data dan stream writer.
• NATS JetStream di antara penerimaan dan penyimpanan; PostgreSQL + PostGIS untuk data spasial.
• Aplikasi mobile Flutter (Riverpod, Drift/SQLite); dashboard Vue + Vite + Leaflet.
• Layanan anomali Python + FastAPI; Odoo 19 melalui XML-RPC.
• Integration test terhadap PostGIS dan NATS sungguhan dengan Testcontainers, kontrak OpenAPI yang dicek di CI, dan Docker Compose untuk infrastruktur lokal.