Pintu Masuk yang Rentan: Mengapa main.dart Kerap Menjadi Tempat Sampah Teknis#
Dalam banyak basis kode aplikasi mobile yang sedang berkembang pesat, berkas main.dart perlahan-lahan merosot fungsinya menjadi tempat penampungan kode yang tidak terkelola. Semuanya bermula dengan niat baik, diawali hanya beberapa baris inisialisasi awal. Namun seiring bertambahnya fitur bisnis, satu berkas itu tak terhindarkan menumpuk inisialisasi Firebase, listener notifikasi, query penyimpanan lokal, perakitan interceptor jaringan, hingga jaring logika kondisional yang rumit untuk menentukan layar mana yang harus tampil pertama kali.
Ketika pengguna lama membutuhkan dialog verifikasi PIN atau biometrik, pengguna baru harus melihat karusel onboarding, sesi yang habis harus dialihkan ke login, dan kampanye pemasaran deep link menuntut pengalihan instan, pintu masuk aplikasi akan runtuh oleh beban kompleksitasnya sendiri. Satu saja unhandled exception terjadi saat proses bootstrap, pengguna akan terjebak di layar hitam (black screen) sebelum widget Flutter pertama sempat dirender.
Pada Part 4 dari seri ini, saya ingin membagikan bagaimana kami merapikan kembali pintu masuk Holigo melalui dua pilar arsitektur utama: alur inisialisasi bootstrap yang berurutan secara terprediksi, serta navigasi deklaratif menggunakan go_router yang dipandu oleh gerbang authentication middleware terpusat.
Bindings & Env
Phase 1Inisialisasi Flutter Engine bindings dan load konfigurasi environment (develop / production).
Firebase & DI
Phase 2Inisialisasi Firebase core, Crashlytics, dan build dependency graph get_it service locator.
State Hydration
Phase 3Load preferensi tema & bahasa dari secure storage sebelum frame pertama dirender.
Launch & Gate
Phase 4Jalankan runApp dengan Global Providers, langsung dialihkan oleh Auth Middleware.
Memuat tema dan bahasa sebelum first frame mencegah efek 'flicker' atau kedipan layar yang merusak pengalaman visual pengguna.
Alur Startup Terurut: Inisialisasi Deterministik dan Hidrasi Bebas Kedip (Zero-Flicker)#
Alur startup aplikasi harus berjalan secara deterministik: setiap subsistem harus diinisialisasi dalam urutan yang pasti dan tidak boleh saling mendahului. Di Holigo, kami membagi alur startup menjadi empat fase yang terisolasi rapi:
- Engine Bindings dan Konfigurasi Environment: Sebelum panggilan framework dilakukan,
WidgetsFlutterBinding.ensureInitialized()memastikan binary messenger Flutter siap bekerja. Kami langsung memuat konfigurasi environment target (develop vs production), menjamin aplikasi terikat ke endpoint server yang tepat sejak siklus proses pertama. - Infrastruktur Pihak Ketiga dan Dependency Injection: Kami menginisialisasi Firebase Core, Crashlytics, dan pelacak analitik, yang segera disusul oleh pemanggilan
setupLocator()terpusat untuk membangun seluruh grafik dependensiget_it. - Pra-Hidrasi State (Pencegah Efek Kedipan Layar): Salah satu pengalaman pengguna yang paling mengganggu adalah membuka aplikasi dalam mode gelap, namun sempat melihat kilatan layar putih sesaat karena preferensi tema dimuat secara asinkron di latar belakang. Untuk mengatasinya, kami memuat preferensi Tema dan Bahasa tersimpan dari local storage langsung ke memori sebelum proses render pertama dimulai.
- Pemasangan Root Widget: Terakhir, fungsi
runApp()mengeksekusi widget utama yang dibungkus oleh provider BLoC global, dan kendali routing langsung diserahkan sepenuhnya kepadago_router.
Dengan memperlakukan preferensi tema dan bahasa sebagai state aktif yang sudah siap sebelum frame pertama terbit, Holigo merender tampilan awalnya dengan 100% konsistensi visual tanpa efek berkedip.
Gerbang Penjaga Sesi: Routing Deklaratif dengan Auth Middleware#
Begitu runApp() berjalan, sistem navigasi harus segera menjawab pertanyaan fundamental: ke mana pengguna ini harus diarahkan?
Pada basis kode warisan lama kami, keputusan ini tersebar di berbagai tempat: splash screen memeriksa token JWT, home screen mengecek jenis akun, dan listener deep-link memotong jalur navigasi secara terpisah. Hal ini menciptakan celah keamanan di mana pengguna yang belum login terkadang bisa menekan tombol kembali (back button) dan menyusup ke layar transaksi privat.
Untuk menutup semua celah tersebut, kami menempatkan Auth Middleware terpusat sebagai satu-satunya gerbang evaluasi di dalam logika redirect deklaratif go_router:
Middleware membaca tipe pengguna, validitas token JWT, permission notifikasi, dan status PIN untuk mengarahkan pengguna secara tepat.
- →Belum Terotentikasi: User baru atau sesi kadaluarsa dialihkan ke layar onboarding dan login.
- →Fitur Terbatas: Fitur transaksi finansial terkunci hingga otentikasi berhasil.
- ✓Pemeriksaan PIN: User terdaftar dengan sesi tersimpan diarahkan ke verifikasi PIN cepat.
- ✓Masuk Dashboard: Setelah validasi PIN sukses, user langsung masuk ke 5-tab dashboard utama.
Menyatukan pengecekan sesi ke dalam router middleware memastikan tidak ada celah navigasi (backdoor) ke halaman privat aplikasi.
Middleware ini mengevaluasi parameter sesi secara deterministik sebelum mengizinkan setiap transisi navigasi:
- Pengguna Tamu / Belum Login: Jika tidak ada token JWT valid atau sesi telah kadaluarsa, pengguna otomatis dialihkan ke modul
/logindan registrasi. Layar pemesanan tiket terkunci rapat. - Pengguna Terdaftar dengan Sesi Aktif: Jika profil pengguna ditemukan di perangkat, middleware mengarahkan mereka ke
/pin-verification. Langkah ini mewajibkan konfirmasi biometrik atau PIN standar perbankan sebelum fitur transaksi dapat diakses. - Sesi Terverifikasi Penuh: Setelah PIN tervalidasi, pengguna langsung dipersilakan masuk ke dashboard utama dengan lima tab menu.
Karena evaluasi ini berada langsung di dalam alur redirect router, pengguna yang membuka aplikasi melalui deep link maupun manipulasi URL eksternal akan melewati aturan verifikasi yang persis sama. Tidak ada celah pintu belakang (backdoor) yang dapat dilewati.
Sub-Rute Modular dengan go_router#
Seiring Holigo menampung layanan tagihan PPOB, top-up digital, tiket bus, kereta api, kapal laut, hingga tiket pesawat, mengelola ratusan rute dalam satu berkas file navigasi akan memicu konflik git merge harian yang melelahkan tim developer.
Kami mengatasi hal ini dengan memecah go_router ke dalam kelompok rute modular per domain fitur:
Mencakup layar Login, Registrasi, Lupa Password, OTP SMS, dan Input/Verifikasi PIN.
StatefulShellRoute dengan 5 persistent tab: Beranda, Riwayat, Explore, Notifikasi, dan Akun.
Rute modular mandiri: Pencarian rute, pemilihan tiket/kursi, form penumpang, dan pembayaran.
Halaman 404 terpadu, handling link kadaluarsa, dan jembatan deep link eksternal.
Memecah rute ke file terpisah per kelompok fitur mengurangi konflik git antar anggota tim secara drastis saat menambah halaman baru.
- Kelompok Rute Autentikasi (
/auth/*): Menangani alur login, pendaftaran akun, validasi OTP SMS, lupa kata sandi, hingga pengaturan dan verifikasi PIN. - Dashboard Shell (
/dashboard/*): MenggunakanStatefulShellRouteuntuk mengelola tumpukan navigasi independen di lima tab menu utama: Beranda, Riwayat Transaksi, Explore, Notifikasi, dan Profil Akun. Pengguna dapat berpindah antar tab tanpa kehilangan posisi scroll atau isi formulir yang sedang diisi. - Kelompok Rute Fitur Transaksi (
/ship/*,/flight/*,/train/*): Setiap domain transportasi memiliki berkas manifes rutenya sendiri yang mencakup alur pencarian rute, denah pemilihan kursi/dek kapal, data penumpang, dan halaman pembayaran. - Halaman Fallback 404 Terpadu: Rute yang tidak dikenali atau tautan promo yang sudah tidak berlaku ditangkap secara anggun oleh layar 404 khusus yang memandu pengguna kembali ke halaman utama dashboard.
Ketika seorang engineer membangun fitur baru, mereka menulis manifes rute fiturnya di berkas terpisah. Berkas router sentral cukup mengimpor dan menggabungkan manifes tersebut, menghilangkan potensi konflik git secara tuntas.
Pelajaran Lapangan dan Tantangan yang Terus Dikelola#
Disiplin arsitektur menuntut kewaspadaan yang tidak pernah berhenti. Meskipun arsitektur navigasi ini menghadirkan ketenangan di production, ada jebakan rekayasa perangkat lunak yang terus kami kelola secara sadar:
Pertama, Penyusupan Tanggung Jawab ke Middleware: Dari waktu ke waktu, developer tergoda menyisipkan pemeriksaan izin notifikasi perangkat, pengecekan fingerprint perangkat keras, hingga kampanye banner ke dalam auth middleware. Jika gerbang navigasi dibebani terlalu banyak urusan sekunder, latensi startup aplikasi akan menurun. Kami secara rutin merefaktor logika pelengkap tersebut agar berjalan sebagai background service mandiri setelah pengguna berhasil masuk.
Kedua, Beban Pre-Fetching Data di Dashboard: Agar layar terasa sangat responsif, dashboard shell Holigo memulai pengambilan data awal untuk konfigurasi aplikasi, daftar negara, dan master pelabuhan kapal saat tab pertama dipasang. Meskipun pendekatan ini menghilangkan loading spinner di layar berikutnya, dashboard jadi memikul beban koordinasi data yang bukan murni urusan tampilan. Menggeser hidrasi data ini ke sync engine khusus adalah target perbaikan teknis kami berikutnya.
Apa yang Bisa Dibawa dari Cerita Ini#
Jika kamu sedang menata arsitektur navigasi dan pintu masuk startup untuk aplikasi Flutter berskala tim:
- Jadikan
main.dartKhusus untuk Bootstrap: Batasi isimain.darthanya untuk inisialisasi engine Flutter, SDK pihak ketiga, dan service locator. Keputusan rute layar pertama sepenuhnya milik router. - Hidrasi State Visual Sebelum First Frame: Muat preferensi tema dan bahasa dari penyimpanan lokal sebelum merender widget utama untuk mematikan kedipan visual layar secara permanen.
- Pusatkan Verifikasi Sesi di Router Middleware: Jadikan router redirect sebagai satu-satunya penilai sesi pengguna agar akses via deep-link maupun restart aplikasi tunduk pada standar keamanan yang seragam.
- Bagi Rute Berdasarkan Kelompok Domain Fitur: Hindari file rute tunggal yang monolitik; pecah ke manifes fitur mandiri untuk menjaga produktivitas tim dan mencegah konflik merge.
Penutup#
Pintu masuk aplikasi yang tertata rapi menentukan ketangguhan seluruh basis kode mobile. Dengan menerapkan urutan inisialisasi yang terprediksi serta memusatkan evaluasi sesi di dalam go_router, Holigo memastikan bahwa setiap sesi pengguna diawali di atas fondasi yang aman dan stabil.
Pada Part 5 nanti, kita akan turun ke lapisan Data: bagaimana wrapper Dio terpusat, penanganan error fungsional dengan Either, dan arsitektur penyimpanan ganda menjaga komunikasi jaringan dan kerahasiaan token pengguna tetap terlindungi di lingkungan produksi.
Terima kasih telah membaca :)
P.S. Seri ini ditulis di level keputusan desain arsitektur dan sistem rekayasa perangkat lunak, tanpa membuka kode atau data internal perusahaan. Jika kamu memiliki pertanyaan mengenai implementasi go_router, navigasi shell stateful, atau perancangan auth middleware, mari berdiskusi!