LogTrack — Sistem Telemetri Armada & Logistik Milk-Run Otomotif Terpadu

LogTrack adalah platform manajemen logistik industri terpadu (Full-Stack Web & Mobile) yang dirancang untuk mengotomatisasi rantai pasok komponen manufaktur otomotif dengan metode pengiriman berputar (milk-run). Sistem ini menghubungkan pusat perakitan (Distribution Center/DC), pabrik pemasok suku cadang (Supplier Plant), armada truk pengiriman, dan tim pengemudi dalam satu ekosistem digital terkoordinasi secara langsung (real-time).

Sistem ini bekerja seperti menara pengawas cerdas (Control Tower): tim operasional (dispatcher) di kantor pusat dapat memantau posisi truk bergerak di peta secara langsung, mengevaluasi ketepatan waktu kedatangan pengemudi (ETA), dan memantau status muatan komponen. Di sisi lain, para supir di jalan dibekali aplikasi mobile khusus untuk verifikasi kedatangan via GPS geofence 3-tier, mencatat fisik part number komponen, menandatangani dokumen serah terima secara digital, dan menerbitkan Surat Jalan Elektronik (e-DN) tanpa perlu lagi menggunakan kertas manual.

Proyek ini berfokus pada keandalan pelacakan posisi presisi tinggi, otomatisasi penilaian performa pengiriman industri berstandar AADA (Accumulative Accuracy & Delivery Accuracy), keamanan data multi-peran, serta integrasi mulus antara backend NestJS, dashboard web React, dan aplikasi mobile React Native pada perangkat fisik Android nyata.

---

Ringkasan Proyek

• Kategori: Industrial Supply Chain, Fleet Telemetry & Mobile Systems
• Peran: Full-Stack & Mobile Systems Engineer (Solo Developer)
• Fokus Utama: Pelacakan armada real-time (WebSocket), geofencing industri bertingkat, digitalisasi manifest part otomotif, e-Delivery Note, dan evaluasi ketepatan waktu (AADA)
• Backend & Arsitektur: NestJS (Node.js/TypeScript), Socket.IO (WebSocket Gateway), Arsitektur Modular, JWT Authentication & Role-Based Access Control (Admin, Dispatcher, Driver)
• Database & Data Logistik: PostgreSQL 16 (Docker), Prisma ORM, Skema Relasional Multi-Entitas (Shipments, Parts Manifest, Tracking History, Digital Signatures)
• Aplikasi Mobile (Driver): React Native (Expo SDK 54 / Android Native), Leaflet WebView Map Engine, Expo Location, Digital SVG Signature Pad, Dual-Mode Telemetry (Live Sensor & Smart Simulation)
• Dashboard Web (Control Tower): React 18, Vite, Tailwind CSS, TanStack Query, Peta Interaktif Leaflet/OpenStreetMap, Print-Ready Document Engine

---

Latar Belakang & Motivasi

Dalam industri manufaktur dan otomotif, komponen mesin (seperti pompa hidrolik, filter oli, roller, dan seal kit) harus dikirimkan dari berbagai pabrik pemasok ke pabrik perakitan utama tepat waktu dengan jadwal ketat yang disebut pola milk-run.

Sebelumnya, operasional lapangan menghadapi berbagai kendala yang sering merugikan perusahaan:

1. Surat Jalan Kertas Manual Sering Hilang atau Rusak: Surat jalan konvensional rawan basah di jalan, tulisan tangan sulit dibaca, dan sering terjadi selisih jumlah barang antara catatan supir dan petugas gudang tanpa ada bukti sah serah terima.
2. Ketiadaan Bukti Kedatangan Otentik: Sering kali pengemudi mengaku sudah sampai di pabrik tepat waktu, padahal masih terjebak macet atau baru tiba berjam-jam kemudian. Tidak adanya validasi lokasi membuat evaluasi performa vendor menjadi subjektif.
3. Pencatatan Selisih Barang Lambat Diketahui: Jika ada suku cadang yang kurang dari pabrik pemasok, kantor pusat baru mengetahuinya beberapa hari kemudian saat laporan fisik masuk, menyebabkan lini perakitan pabrik berisiko terhenti (downtime).
4. Alur Pelacakan Tradisional yang Terputus: Kantor dispatcher harus menelepon supir satu per satu untuk menanyakan keberadaan truk, yang selain mengganggu konsentrasi supir saat menyetir juga tidak memberikan gambaran visual posisi armada di lapangan.

Saya merancang dan membangun LogTrack untuk menjawab tantangan operasional tersebut secara menyeluruh:

1. Menghadirkan pelacakan armada hidup (live tracking) berbasis WebSocket yang hemat kuota dan bergerak mulus tanpa kedip (zero-blink).
2. Menerapkan validasi kedatangan otomatis berbasis GPS Geofence 3 tingkat (Zona Hijau, Kuning, dan Merah) untuk mencegah kecurangan titik tiba.
3. Menghitung skor ketepatan waktu dan akurasi barang secara otomatis dengan toleransi industri AADA (toleransi jendela waktu ±30 menit).
4. Menghilangkan ketergantungan kertas 100% melalui Surat Jalan Elektronik (e-DN) berlogo resmi perusahaan lengkap dengan tanda tangan digital legal antara PIC Supplier dan Petugas DC.
5. Memastikan privasi dan integritas data pengemudi di mana setiap supir hanya dapat mengakses order tugas miliknya sendiri.

---

Kontribusi Teknis Saya

Arsitektur Telemetri Real-Time Dual-Platform (Web & Mobile)

• Mengembangkan telemetry engine berbasis Socket.IO pada backend NestJS yang mampu menerima ratusan pancaran koordinat pengemudi per detik dan mendistribusikannya ke dashboard web dispatcher tanpa jeda (low latency).
• Pada aplikasi mobile Android, saya mengintegrasikan mesin peta Leaflet di dalam WebView dengan mekanisme injeksi JavaScript dinamis (smooth coordinate injection), sehingga ikon truk bergerak dengan animasi halus tanpa perlu me-reload peta sama sekali.

Sistem Validasi Geofence 3-Tier Industri

• Menerapkan algoritma kalkulasi jarak Haversine presisi tinggi untuk memvalidasi posisi kedatangan truk di fasilitas industri:
  • Tier 1 (Green Zone $\le 300\text{ m}$): Truk sudah berada tepat di dermaga loading/receiving, sistem mengizinkan konfirmasi tiba seketika tanpa jeda.
  • Tier 2 (Yellow Zone $301\text{ m} - 1.000\text{ m}$): Truk terdeteksi di perimeter luar fasilitas (misal: antrean pos satpam atau area parkir tunggu). Sistem mewajibkan supir memilih justifikasi alasan resmi sebelum kedatangan dicatat ke riwayat log.
  • Tier 3 (Red Zone $> 1.000\text{ m}$): Truk masih berada di luar area aman; tombol kedatangan langsung diblokir (hard block) untuk mencegah klaim palsu.

Mesin Evaluasi Otomatis AADA (Delivery & Accumulative Accuracy)

• Membangun logic engine backend yang mengevaluasi performa pengiriman secara objektif:
  • Delivery Accuracy (DA): Membandingkan jam tiba riil pengemudi dengan target jadwal (ETA Schedule) menggunakan toleransi jendela industri ±30 menit. Jika tepat waktu bernilai skor penuh (1.0), jika terlambat atau terlalu dini otomatis diberi catatan deviasi resmi.
  • Accumulative Accuracy (AA): Menghitung persentase kecocokan fisik antara jumlah barang pesanan (planned), barang yang diserahkan pemasok (actual supplier), dan barang yang diterima gudang (DC received), lengkap dengan pencatatan alasan selisih (shortage reason).

Digitalisasi Penuh Dokumen Surat Jalan Elektronik (e-DN)

• Menggantikan surat jalan kertas konvensional dengan sertifikat serah terima digital (Electronic Delivery Note) yang resmi:
  • Menyematkan identitas visual logo brand resmi LogTrack pada dokumen cetak maupun tampilan layar mobile/web.
  • Mengintegrasikan kanvas tanda tangan digital berbasis SVG vektor (smooth drawing pad) untuk menangkap tanda tangan legal PIC Pemasok saat barang dimuat dan Petugas DC saat barang dibongkar.
  • Fitur cetak ramah PDF (Print-to-PDF engine) di web dashboard dengan format kop surat standar industri manufaktur.

Dual-Mode Telemetry: Sensor Nyata & Simulasi Cerdas (Smart Drive Simulator)

• Mengingat pengujian sistem logistik sering dilakukan dari meja kerja tanpa supir harus mengendarai truk puluhan kilometer, saya membangun mode simulasi cerdas:
  • Sistem mendeteksi otomatis apakah aplikasi sedang berjalan menggunakan sensor GPS fisik HP atau mode simulasi.
  • Dalam mode simulasi, rute truk secara cerdas menyesuaikan tahapan: mendekati dermaga supplier saat status Assigned, dan bergerak menelusuri rute antar-kota saat status On The Way.
  • Menangani pembacaan koordinat terakhir secara presisi sehingga proses verifikasi geofence, serah terima barang, dan penutupan order dapat diuji secara menyeluruh di perangkat fisik Android tanpa gagal validasi.

Keamanan Multi-Peran & Isolasi Data Supir yang Ketat

• Menerapkan Role-Based Access Control (RBAC) pada backend untuk memisahkan wewenang Admin, Dispatcher, dan Driver.
• Mengunci data tugas di sisi controller dan service backend sehingga akun supir yang baru login dipastikan hanya melihat daftar surat jalan miliknya sendiri, tanpa risiko kebocoran data antar-pengemudi.

---

Fitur Produk Inti

Live Dispatch Control Tower (Web)

• Peta interaktif terpusat yang memantau lokasi seluruh truk secara simultan, lengkap dengan indikator kecepatan, arah laju (heading), dan status siklus pengiriman.

Verifikasi GPS Geofence & Check-In Mandiri (Mobile)

• Supir melakukan validasi kedatangan di pabrik pemasok maupun DC dengan pencocokan lokasi satelit otomatis, lengkap dengan form justifikasi jika tertahan antrean di pintu gerbang.

Pemeriksaan Manifest Part Number Komponen

• Tampilan rincian part number otomotif (nama komponen, jumlah pesanan, jumlah aktual yang dimuat, serta catatan kendala jika stok pabrik pemasok tidak lengkap).

Tanda Tangan Digital & Terbit e-DN Seketika

• Pengesahan serah terima barang langsung di atas layar ponsel menggunakan jari atau stylus, otomatis menerbitkan nomor surat jalan digital unik secara instan.

Evaluasi Otomatis Skor Ketepatan Waktu (AADA Card)

• Kartu analitik visual yang langsung menampilkan apakah pengiriman masuk dalam kategori ON-TIME (Window ±30m) atau terjadi EXCEPTION (terlambat / datang kepagian).

Pencetakan & Pengarsipan Dokumen Resmi

• Dokumen e-DN dapat dibuka kapan saja melalui riwayat order web maupun mobile, serta dapat langsung dicetak atau diekspor ke PDF dengan tata letak resmi bersertifikat.

---

Teknologi & Arsitektur (Tech Stack)

LogTrack dibangun menggunakan tumpukan teknologi modern, terukur, dan berbasis type-safety penuh dari hulu ke hilir:

• Backend Framework: NestJS 10 (Node.js & TypeScript murni)
• Komunikasi Real-Time: Socket.IO Gateway (WebSocket Server & Client)
• Database & ORM: PostgreSQL 16 (Docker Container), Prisma ORM
• Keamanan & Autentikasi: Passport JWT, Bcrypt, Role-Based Access Guards
• Web Control Tower: React 18, Vite, Tailwind CSS, TanStack Query, Lucide Icons
• Aplikasi Mobile Driver: React Native 0.81 (Expo SDK 54), Expo Location, React Navigation
• Peta & Visualisasi Spasial: Leaflet.js, OpenStreetMap Tiles, In-App WebView Native Bridge
• Input Tanda Tangan: SVG Vector Path Capture & Rendering
• Pengujian & Deployment: Docker, Docker Compose, Android Debug Bridge (ADB) Streamed Install pada HP Fisik Android

---

Tantangan Teknis & Solusi

1. Menjaga Pergerakan Truk Tetap Mulus di Peta Tanpa Me-Reload Tampilan

• Tantangan: Memperbarui koordinat truk setiap beberapa detik pada peta WebView di Android sering kali menyebabkan layar berkedip (white screen flicker), yang sangat mengganggu kenyamanan mata pengemudi.
• Solusi: Saya merancang komponen InAppMap dengan struktur HTML/JS Leaflet statis yang di-memoize. Pembaruan titik koordinat tidak lagi merender ulang seluruh komponen, melainkan disuntikkan secara dinamis via injectJavaScript langsung ke objek marker Leaflet yang sudah aktif. Hasilnya, truk berpindah secara halus (60fps zero-blink animation).

2. Mencegah Kegagalan Validasi GPS Saat Uji Coba Lapangan di HP Nyata

• Tantangan: Ketika pengemudi mencoba aplikasi di HP fisik nyata di dalam ruangan (misal di kota lain), pemanggilan sensor GPS bawaan mengembalikan koordinat fisik ruangan pengguna yang berjarak ratusan kilometer dari pabrik di Balikpapan, sehingga kedatangan selalu ditolak oleh sistem geofence.
• Solusi: Saya membangun mekanisme Dual-Mode Telemetry. Aplikasi secara cerdas membedakan antara Live GPS Active dan Simulation Mode. Dalam mode simulasi, sistem memprioritaskan titik koordinat simulasi perjalanan terakhir, sehingga pengujian alur verifikasi komponen dan penerbitan e-DN tetap dapat dilakukan secara sempurna tanpa harus berkendara fisik ke lokasi.

3. Mencegah Selisih Data Barang Antara Supir dan Gudang Penerima

• Tantangan: Pada pengiriman multi-part, sering terjadi perdebatan antara supir dan petugas penerima mengenai siapa yang bertanggung jawab atas kekurangan komponen yang terjadi selama di perjalanan.
• Solusi: Saya menerapkan sistem pencatatan kuantitas berjenjang 3 titik: kuantitas rencana (Plan Qty), kuantitas serah terima pemasok (Supplier Actual Qty), dan kuantitas fisik yang dihitung di gudang tujuan (DC Received Qty). Setiap perubahan kuantitas wajib disertai alasan resmi serta dikunci dengan tanda tangan digital legal dari masing-masing pihak pada dokumen e-DN yang tidak dapat diubah lagi (tamper-evident).

---

Pembelajaran & Poin Kunci

• Integrasi Penuh Full-Stack & Mobile: Memperdalam keahlian menghubungkan arsitektur backend industri (NestJS + Prisma) dengan aplikasi web kontrol dan aplikasi mobile native Android yang saling bertukar data secara instan melalui WebSocket.
• Penerapan Logika Bisnis Nyata (AADA & Milk-Run): Belajar menerjemahkan proses bisnis logistik manufaktur otomotif yang rumit menjadi kode program fungsional, mulai dari perhitungan geofence bertingkat hingga evaluasi ketepatan waktu dengan jendela toleransi.
• Penyelesaian Masalah di Perangkat Keras Nyata: Mendapatkan pengalaman berharga dalam menangani kendala teknis pada perangkat mobile fisik Android asli, seperti optimasi konsumsi baterai GPS, perizinan lokasi di latar belakang, dan kestabilan komunikasi data via ADB.
• Standar Dokumen & Desain Berorientasi Pengguna: Menyadari pentingnya menyatukan aspek estetika desain modern dengan fungsionalitas resmi perusahaan, seperti menghasilkan surat jalan elektronik yang bersih, memiliki identitas merek yang kuat, dan mudah dibaca oleh pekerja lapangan.