←../kembali_ke_proyek
⚡ Proyek 2024·completed·Operasional Lapangan Enterprise

>_ Bagaimana Saya Membangun Aplikasi Pelaporan Lapangan Bertag Lokasi yang Tangguh untuk Operasi di Sinyal Lemah

Aplikasi pelaporan lapangan Android native dengan Kotlin dan MVVM: penguncian koordinat GPS presisi tinggi, kompresi gambar di background (3,8MB menjadi ~400KB), dan sinkronisasi multipart REST API.

Fama Agent — architecture.hub
Camera & FusedGPS
Ambil foto & koordinat akurasi tinggi
core
Media Compressor
Downscale & penyematan metadata EXIF/Geo
Kotlin ViewModel
Manajemen state MVVM & antrean retry
Central REST API
Upload multipart & autentikasi token

Gambar 1.0 — Arsitektur end-to-end dan alur data untuk Fama Agent

# Gambaran Perjalanan

Aplikasi pelaporan petugas lapangan berbasis Android untuk mengirim bukti foto, titik lokasi GPS akurat, dan laporan aktivitas langsung ke kantor pusat.

Titik Awal (Masalah)

Pelaporan tim lapangan lewat grup pesan tidak terstruktur, sulit diverifikasi titik lokasinya, dan foto sering gagal terkirim saat sinyal seluler lemah.

Mengapa Ini Penting (Hasil & Dampak)

Menyediakan sistem pelaporan terpusat dengan bukti koordinat GPS tervalidasi dan kompresi foto otomatis yang hemat kuota serta stabil di jaringan lapangan.

# Fase 1: Arsitektur Sistem & Pipeline

Arsitektur sistem dirancang secara modular agar setiap lapisan memiliki tanggung jawab yang terisolasi dengan jelas:

TAHAP 01

Camera & FusedGPS

Ambil foto & koordinat akurasi tinggi

TAHAP 02

Media Compressor

Downscale & penyematan metadata EXIF/Geo

TAHAP 03

Kotlin ViewModel

Manajemen state MVVM & antrean retry

TAHAP 04

Central REST API

Upload multipart & autentikasi token

Hasil Teknis Utama

  • Pengambilan laporan lapangan lengkap dengan teks, foto kamera, dan titik koordinat GPS
  • Kompresi gambar otomatis di sisi perangkat sebelum dikirim ke REST API pusat
  • Arsitektur MVVM dengan penanganan state loading, error, dan retry yang stabil

# Fase 2: Keputusan Engineering & Implementasi

[Keputusan 01]Menerapkan kompresi bitmap di background thread sebelum multipart upload untuk mencegah OutOfMemoryError dan mempercepat pengiriman di jaringan 3G/4G lemah.
[Keputusan 02]Menggunakan FusedLocationProviderClient dengan validasi akurasi radius agar titik koordinat laporan benar-benar presisi saat dikirim.
[Keputusan 03]Memisahkan UI Activity/Fragment dari logika jaringan menggunakan arsitektur MVVM agar pengiriman data tidak batal saat rotasi layar.
ReportViewModel.kt
fun submitFieldReport(note: String, photo: File, loc: Location) {
  viewModelScope.launch {
    _uiState.value = ReportUiState.Uploading
    val compressed = imageCompressor.compressToMaxKb(photo, maxKb = 450)
    repository.uploadMultipart(note, compressed, loc.latitude, loc.longitude)
      .onSuccess { _uiState.value = ReportUiState.Success(it.reportId) }
      .onFailure { _uiState.value = ReportUiState.Error(it.message) }
  }
}

# Fase 3: Layar Aplikasi & Alur Operasional

1. Capture & Geo-Tagging

Pengambilan foto bukti langsung dari kamera disertai penguncian koordinat GPS otomatis.

2. Antrean Upload Pintar

Kompresi ukuran gambar otomatis dan indikator status pengiriman ke server pusat.

3. Riwayat & Status Laporan

Daftar laporan yang sudah terkirim beserta waktu, lokasi, dan status verifikasi.