RouteForce

Platform Distribusi FMCG untuk Sales Lapangan dengan Arsitektur Microservice & Offline-First

Latar Belakang

Di industri distribusi FMCG Indonesia, sales lapangan harus keliling mengunjungi puluhan toko kecil setiap hari. Masalahnya, banyak toko yang lokasinya di gang sempit atau basement yang tidak ada sinyal internet sama sekali. Akibatnya:

• Order yang sudah dicatat di kertas bisa hilang atau salah ketik saat diinput ulang di kantor
• Sales bisa "titip absen" tanpa benar-benar datang ke toko, karena tidak ada cara membuktikan kehadirannya
• Stok gudang sering jebol karena beberapa sales memesan barang yang sama dalam waktu berdekatan, dan sistem tidak bisa menahan stok secara real-time
• Supervisor hanya bisa tahu kondisi lapangan setelah sales kembali ke kantor di sore hari
• Ada toko yang riwayat bayarnya buruk tapi tetap bisa ambil barang secara kredit, karena pengecekannya masih manual

Solusi

RouteForce menyelesaikan masalah ini lewat dua aplikasi: mobile PWA yang bisa dipakai sales meski tanpa internet, dan dashboard web untuk supervisor mengontrol seluruh operasi dari kantor. Di balik layar, sistem ini berjalan di atas tiga microservice yang saling berkomunikasi lewat gRPC dan message queue.

Order Tanpa Perlu Internet

Semua data produk sudah tersimpan di perangkat sales. Jadi mau di basement atau di pelosok desa, sales tetap bisa buat order. Begitu sinyal kembali, semua transaksi otomatis terkirim ke server tanpa perlu input ulang.

Bukti Kunjungan yang Tidak Bisa Dipalsukan

Setiap kali sales check-in di toko, sistem menghitung jarak GPS-nya ke koordinat toko yang sudah terdaftar. Kalau jaraknya lebih dari 100 meter, sistem langsung menandai sebagai pelanggaran. Supervisor bisa lihat semua bukti ini di peta interaktif.

Stok Gudang yang Tidak Bisa Jebol

Saat sales membuat order, stok langsung "ditahan" (reserved) selama 15 menit. Sales lain tidak bisa memesan barang yang sama jika stoknya sudah habis. Kalau dalam 15 menit order tidak dikonfirmasi, stok otomatis dilepas kembali. Mekanisme ini memakai distributed lock di Redis supaya aman meski diakses bersamaan oleh banyak sales.

Pengecekan Kredit Otomatis

Sebelum order kredit dikonfirmasi, AI Service mengecek riwayat pembayaran toko tersebut: berapa utang yang belum lunas, apakah pernah telat bayar, dan seberapa sering beli. Kalau berisiko tinggi, order otomatis dipaksa jadi bayar tunai (COD). Kalau risikonya sedang, order masuk antrean persetujuan supervisor dulu.

Peta Lapangan Real-Time

Supervisor bisa melihat semua aktivitas tim di peta interaktif: lokasi toko mana yang sudah dikunjungi (hijau), sedang dikunjungi (kuning), atau ada pelanggaran radius (merah). Lengkap dengan garis batas wilayah dan rute perjalanan sales.

Tidak Ada Transaksi yang Hilang

Sistem menggunakan Transactional Outbox Pattern. Artinya, setiap kali order masuk ke database, event notifikasinya juga tercatat di tabel yang sama dalam satu transaksi. Baru kemudian worker mengirim event tersebut ke RabbitMQ untuk diproses oleh service lain. Jadi meski RabbitMQ sempat mati, tidak ada event yang hilang.

Hasil

• Sales bisa membuat order lengkap tanpa internet, dan semuanya tersinkronisasi otomatis saat koneksi kembali
• Kecurangan check-in terdeteksi secara otomatis lewat validasi GPS Haversine dengan presisi hingga satuan meter
• Stok multi-gudang terjaga akurat tanpa overselling, berkat reservasi dua tahap dengan distributed lock Redis
• Toko berisiko tinggi otomatis dipaksa bayar tunai, mengurangi potensi piutang macet
• Seluruh sistem (10 container Docker) bisa di-deploy dengan satu perintah docker compose up
• Setiap request bisa ditelusuri dari frontend sampai database lewat distributed tracing (OpenTelemetry + Jaeger)

Teknologi

Backend: Go, Python, gRPC, Protocol Buffers, RabbitMQ, JWT, bcrypt Database: PostgreSQL 16, MongoDB 7, Redis 7 Frontend: React, Vite, React Native Web, Leaflet, IndexedDB Observability: OpenTelemetry, Jaeger Infrastructure: Docker, Docker Compose, Nginx

---

Tertarik membangun sistem distribusi serupa? Hubungi saya untuk berdiskusi lebih lanjut.