Menghubungkan Seluruh Titik: Cetak Biru Arsitektur yang Hidup#
Di sepanjang lima bagian pertama dari seri tulisan ini, kita telah membedah setiap lapisan arsitektur Holigo secara terpisah: strategi migrasi bertahap per fitur, batas tiga lapisan kode, aliran event-to-state BLoC, dependency injection modular dengan get_it, middleware navigasi dengan go_router, hingga lapisan data tangguh dengan wrapper Dio dan penyimpanan ganda.
Pada Part 6 ini, seluruh potongan sistem tersebut akhirnya bertemu. Kita akan melihat bagaimana seluruh bagian tersebut bekerja bersama secara harmonis di lingkungan produksi melalui laboratorium percontohan kami: Modul Tiket Kapal Laut (Pelni).
Lebih dari sekadar operasi data sederhana, modul pemesanan tiket perjalanan nyata harus menghadapi tantangan teknis lintas domain: perhitungan tarif dinamis, cache SQLite lokal untuk rute pelabuhan tersering, integrasi REST API pihak ketiga, hingga kebutuhan pemasaran visual musiman yang berubah cepat. Berikut adalah bagaimana cetak biru Kapal dijadikan fondasi bagi modul perjalanan berikutnya, bagaimana remote configuration dari backend memungkinkan kampanye visual tanpa rilis store, serta bagaimana otomatisasi ARB menyelesaikan kendala penerjemahan multibahasa.
Fitur Kapal dipilih karena cakupannya ringkas namun lengkap: interaksi rute, remote API kuota, cache SQLite lokal, dan alur BLoC terisolasi.
- ✓Nol Desain Fondasi Ulang: Developer langsung memakai kontrak repository, use case, dan injector dari cetak biru.
- ✓Fokus ke Aturan Bisnis: Energi difokuskan 100% pada pemilihan gerbong, kursi, dan transit stasiun.
- ✓Alur Kompleks di Atas Fondasi Kokoh: Multi-penumpang, bagasi dinamis, asuransi, dan add-on tertampung tanpa merusak arsitektur.
- ✓Zero Regression: Perubahan besar pada flow pesawat tidak mengganggu kestabilan tiket kapal atau kereta.
Nilai terbesar dari fitur pertama bukanlah fitur itu sendiri, melainkan cetak biru arsitektur yang diwariskan ke seluruh fitur berikutnya.
Penggandaan Pola: Melipatgandakan Fondasi Kapal ke Kereta, Bus, dan Pesawat#
Ketika kami memilih modul Kapal sebagai proyek pilot pada Part 1, tujuannya bukan semata merilis fitur tiket kapal laut; tujuannya adalah membangun cetakan arsitektur (architectural mold) yang dapat diduplikasi oleh seluruh tim developer ke seluruh lini produk Holigo lainnya.
Cetak biru anatomi yang dirumuskan di fitur Kapal terbukti langsung dapat diterapkan ke fitur lain:
- Pemisahan Kontrak Antarmuka Repository: Kontrak abstrak
ShipRepositorymenyembunyikan sumber data di baliknya. Ketika tim mulai membangun fitur tiket Kereta Api dan Bus, developer tidak perlu lagi berdebat mengenai struktur folder, batas lapisan, atau alur data. Mereka menduplikasi pola yang sama:TrainRepositoryImplmengoordinasikan data ketersediaan kursi real-time dari API server dengan riwayat pencarian stasiun di database SQLite lokal. - Use Case yang Terfokus: Logika bisnis mandiri seperti
GetHarbourListUseCase,SearchShipSchedulesUseCase, danCalculateShipFareUseCasemenjaga kode bisnis tetap terpisah dari widget UI. Ketika modul tiket Pesawat menyusul dengan alur multi-penumpang, bagasi dinamis, dan denah kursi, engineer dapat memusatkan 100% konsentrasi mereka pada perhitungan aturan bisnis tiket penerbangan tanpa perlu membangun fondasi dasar dari nol lagi. - Peningkatan Kecepatan Tim: Menggunakan kembali cetak biru yang sudah teruji memangkas waktu pengembangan dan verifikasi fitur perjalanan berikutnya sekitar 35-40%. Developer baru yang bergabung ke tim cukup mempelajari modul Kapal untuk langsung memahami bagaimana seluruh fitur lain di aplikasi dibangun.
Konfigurasi Dinamis Backend: Tema Hari Raya Tanpa Antre Review Store#
Dalam industri aplikasi konsumen mobile, dinamika pemasaran dan momentum perayaan bergerak jauh lebih cepat daripada siklus review rilis Apple App Store dan Google Play Store. Menunggu proses review binary 48 jam hanya untuk menampilkan banner bertema Idul Fitri atau Natal di dashboard tiket adalah hal yang sangat merugikan momentum bisnis.
Untuk memberikan kelincahan kampanye bagi tim produk dan pemasaran tanpa mengorbankan stabilitas aplikasi, kami menerapkan Konfigurasi Dinamis Berbasis Backend (Backend-Driven Config):
- 01Kendali Penuh di User: User bebas memilih mode Terang, Gelap, atau Mengikuti Sistem melalui pengaturan aplikasi.
- 02Penyimpanan Lokal: Pilihan disimpan di shared_preferences dan langsung diload sebelum first frame.
- 03Sifat: Deterministik dalam kode tanpa bergantung pada koneksi internet backend.
- 01Kebutuhan Bisnis: Mengubah dekorasi UI saat perayaan Lebaran, Natal, Tahun Baru, atau promo spesial.
- 02Remote Config: Diambil via config API saat aplikasi dibuka; BLoC mengupdate aset banner dan warna aksen.
- 03Keuntungan Utama: Tampilan berubah instan tanpa perlu menunggu review rilis Google Play & App Store.
Backend-driven theme memberi fleksibilitas bisnis tanpa rilis store, namun harus dirancang berdiri mandiri agar tidak merusak preferensi light/dark mode pengguna.
Saat aplikasi dibuka, service konfigurasi global mengambil payload kampanye dinamis dari server backend. Ketika hari raya besar atau promo flash sale tiba, server dapat mengubah atribut visual aplikasi secara instan:
- Aksen Visual Bertema Khusus: Warna aksen, banner promo, dan ilustrasi ucapan hari raya berganti secara otomatis pada form pencarian tiket dan kartu beranda.
- Menghormati Otonomi Pengguna: Hal yang sangat krusial, tema acara dari backend diisolasi secara arsitektur dari preferensi Mode Gelap/Terang pengguna. Jika pengguna memilih Mode Gelap demi kenyamanan mata, aplikasi tetap berada dalam Mode Gelap, dan hanya memadukan aksen warna festival ke dalam palet gelap tanpa membuat pengguna silau dengan warna putih yang tidak diinginkan.
- Jaminan Fallback Offline: Jika pengguna membuka aplikasi di area dengan sinyal buruk dan endpoint config gagal merespons, aplikasi seketika menggunakan nilai default lokal tanpa menampilkan dialog error yang mengganggu transaksi pengguna.
Pipeline Lokalisasi Multibahasa: Memecah Berkas ARB Menjadi Modular#
Holigo melayani basis pengguna yang luas dengan Bahasa Indonesia sebagai bahasa utama dan Bahasa Inggris sebagai opsi internasional. Kami menggunakan sistem lokalisasi bawaan Flutter (flutter_localizations), yang mengompilasi berkas Application Resource Bundle (.arb) berformat JSON menjadi kelas Dart yang strongly-typed.
Namun, di dalam tim engineering yang berkembang, mengelola ratusan teks terjemahan di dalam satu berkas monolitik raksasa app_id.arb adalah sumber konflik git merge yang tak ada habisnya. Jika dua developer menambahkan teks untuk fitur yang berbeda di hari yang sama, menyelesaikan konflik merge pada berkas JSON berisi ribuan baris sangat rawan menimbulkan typo dan error sintaks.
Untuk mengatasi friksi ini, kami merancang Pipeline Lokalisasi ARB Modular Otomatis:
Split ARB Files
Per-Feature ARBsString teks dipisah per modul fitur (intl_ship_id.arb, intl_auth_id.arb) agar rapi.
Automated Merge
CLI ScriptScript otomatis menggabungkan seluruh ARB fitur menjadi file app_id.arb dan app_en.arb.
Code Generation
flutter gen-l10nFlutter tool meng-generate kelas AppLocalizations dengan type-safety penuh di compile-time.
Live Runtime Locale
Language BLoCLanguageBloc mengupdate Locale aktif secara instan tanpa perlu merestart aplikasi.
Memecah string terjemahan per fitur dan mengotomasi proses merger mencegah konflik git massal ketika puluhan teks baru ditambahkan bersamaan.
- Berkas ARB Terpisah per Modul Fitur: Setiap modul mengelola string terjemahannya sendiri di dalam foldernya masing-masing (misalnya
features/ship/l10n/intl_ship_id.arbdanfeatures/auth/l10n/intl_auth_id.arb). - Skrip CLI Penggabung Otomatis: Skrip otomatis memindai seluruh folder fitur, menggabungkan kunci-kunci terjemahan ke dalam berkas utama
app_id.arbdanapp_en.arb, serta memvalidasi agar tidak ada kunci teks yang duplikat. - Generasi Kode Compile-Time: Perintah resmi
flutter gen-l10nmenghasilkan kelasAppLocalizationsdengan jaminan keamanan tipe di compile-time. Teks terjemahan yang hilang akan langsung terdeteksi oleh Dart analyzer sebelum kode sempat dijalankan. - Pergantian Bahasa Runtime yang Mulus: BLoC bahasa global mengelola state bahasa aktif di memori, memungkinkan pengguna beralih antara Bahasa Indonesia dan Bahasa Inggris secara instan tanpa perlu merestart aplikasi.
Harga Operasional: Ketidakselarasan Kode dan Tata Kelola Otomasi#
Mengoperasikan arsitektur modular yang dipadukan dengan konfigurasi backend menghadirkan fleksibilitas tinggi, namun menuntut disiplin operasional nyata dari para engineer:
Pertama, Mendiagnosis Perbedaan Kode vs Server: Ketika tampilan antarmuka dipengaruhi oleh payload backend, mereproduksi bug visual menuntut pemahaman tidak hanya pada kode aplikasi, melainkan juga data konfigurasi persis yang dikirimkan server pada jam tersebut. Menyediakan environment staging dengan toggle konfigurasi yang dapat diubah-ubah menjadi kebutuhan wajib tim QA.
Kedua, Ritual Dua Langkah Lokalisasi: Memecah berkas ARB mengharuskan developer mengeksekusi skrip merge-and-generate setiap kali menambahkan teks UI baru. Jika langkah ini terlewat, build lokal akan gagal. Kami mengatasi masalah ini dengan memasukkan skrip penggabung ARB ke dalam git pre-commit hook dan pipeline validasi pull-request di CI.
Ketiga, Mengelola Modul yang Masih Berupa Skeleton: Meskipun fitur transportasi inti sudah sepenuhnya mengadopsi pola Clean Architecture, beberapa modul pendukung (seperti webview promo lama dan layar pengaturan sekunder) masih berada dalam fase transisi bertahap. Mencatat technical debt secara transparan sangat penting agar tim tidak memiliki asumsi keliru.
Apa yang Bisa Dibawa dari Cerita Ini#
Jika kamu sedang mengembangkan arsitektur Flutter multi-fitur dengan kebutuhan konfigurasi dinamis dan lokalisasi:
- Perlakukan Fitur Pertama Sebagai Cetakan yang Hidup: Berikan perhatian ekstra pada modul pertama yang kamu migrasi. Standar arsitektur, pola penamaan, dan batasan lapisan yang kamu sepakati di sana akan diwarisi oleh seluruh fitur berikutnya.
- Pisahkan Tema Pemasaran dari Aksesibilitas Pengguna: Saat mengimplementasikan tema dinamis dari backend, pastikan tema acara tidak menimpa pengaturan mode gelap/terang yang telah dipilih pengguna.
- Pecah Berkas Terjemahan per Domain Fitur: Hindari konflik git merge massal dengan menjaga file ARB tetap terisolasi per modul, lalu gunakan skrip otomasi untuk menyatukannya kembali.
- Otomatisasi Langkah Kompilasi ke Pipeline CI: Setiap langkah manual yang menuntut developer menjalankan skrip tambahan pasti akan terlupakan suatu hari nanti. Tanamkan script tersebut langsung ke dalam pre-commit hook atau pemeriksaan otomatis CI.
Penutup#
Fitur tiket Kapal (Pelni) membuktikan bahwa investasi waktu di awal untuk merancang Clean Architecture yang disiplin akan membuahkan imbal hasil efisiensi teknis yang berlipat ganda di masa depan. Dengan menetapkan batas lapisan yang tegas, menghadirkan tema dinamis tanpa rilis store, serta mengotomasi pipeline lokalisasi, Holigo membangun platform yang kokoh dan siap menampung puluhan fitur baru.
Pada Part 7 (bagian penutup dari seri ini), kita akan memusatkan perhatian pada realitas penting dalam rekayasa perangkat lunak mobile: Kualitas dan Rilis (Quality and Release). Kita akan mengulas konfigurasi environment, cakupan automated testing, pipeline CI/CD, keamanan penandatanganan rilis, serta pelajaran berharga yang akan saya terapkan berbeda jika mengulang perjalanan ini dari awal.
Terima kasih telah membaca :)
P.S. Seri ini ditulis di level keputusan desain arsitektur dan sistem rekayasa perangkat lunak, tanpa membuka kode rahasia atau data internal perusahaan. Jika kamu memiliki pertanyaan seputar pipeline ARB, arsitektur tema dinamis dari backend, atau perancangan modul transaksi, mari berdiskusi!