Studi Kasus Fitur Kapal: Satu Pola, Konfigurasi Backend, dan Lokalisasi - Part 6
Architecture & Decision Log·6 November 2026·10 menit baca
Semua catatan

Studi Kasus Fitur Kapal: Satu Pola, Konfigurasi Backend, dan Lokalisasi - Part 6

Fitur tiket Kapal (Pelni) sebagai studi kasus utuh: bagaimana modul transportasi lain menduplikasi polanya, bagaimana konfigurasi backend mengubah tema hari raya tanpa rilis store, dan alur lokalisasi ARB modular.

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.

FIG.
Cetak Biru Fitur Kapal: Fondasi yang Dipakai Ulang Fitur Lain
Pattern Multiplication
Fitur Kapal (Pelni) Sebagai Cetak Biru (Blueprint)Laboratorium Pilot

Fitur Kapal dipilih karena cakupannya ringkas namun lengkap: interaksi rute, remote API kuota, cache SQLite lokal, dan alur BLoC terisolasi.

3-Layer Structure
BLoC Event/State
Central Dio Client
SQLite & Storage
Fitur Kereta & Bus (Adopsi Cepat)
Ekspansi Pola
  • ✓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.
Waktu pengembangan fitur baru berkurang berkat pemakaian ulang kontrak
Fitur Pesawat (Kompleksitas Tinggi)
Stabilitas Teruji
  • ✓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.
Skalabilitas multi-tim berjalan mulus dan minim konflik
Pelajaran Kunci:

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 ShipRepository menyembunyikan 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: TrainRepositoryImpl mengoordinasikan 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, dan CalculateShipFareUseCase menjaga 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):

FIG.
Tema Dinamis: Kontrol Pengguna vs Backend-Driven Config
Konfigurasi Dinamis Lintas Platform
Tema Pengguna (Light / Dark Mode)Lokal & Permanen
  1. 01Kendali Penuh di User: User bebas memilih mode Terang, Gelap, atau Mengikuti Sistem melalui pengaturan aplikasi.
  2. 02Penyimpanan Lokal: Pilihan disimpan di shared_preferences dan langsung diload sebelum first frame.
  3. 03Sifat: Deterministik dalam kode tanpa bergantung pada koneksi internet backend.
Menjaga kenyamanan visual pengguna setiap saat secara lokal
Tema Acara Backend (Event / Festive)Dinamis Tanpa Rilis Store
  1. 01Kebutuhan Bisnis: Mengubah dekorasi UI saat perayaan Lebaran, Natal, Tahun Baru, atau promo spesial.
  2. 02Remote Config: Diambil via config API saat aplikasi dibuka; BLoC mengupdate aset banner dan warna aksen.
  3. 03Keuntungan Utama: Tampilan berubah instan tanpa perlu menunggu review rilis Google Play & App Store.
Wajib sediakan fallback lokal jika koneksi config gagal
Pelajaran Kunci:

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:

FIG.
Pipeline Lokalisasi: Dari File ARB Terpisah ke Kelas Dart
Multilingual Architecture
01

Split ARB Files

Per-Feature ARBs

String teks dipisah per modul fitur (intl_ship_id.arb, intl_auth_id.arb) agar rapi.

02

Automated Merge

CLI Script

Script otomatis menggabungkan seluruh ARB fitur menjadi file app_id.arb dan app_en.arb.

03

Code Generation

flutter gen-l10n

Flutter tool meng-generate kelas AppLocalizations dengan type-safety penuh di compile-time.

04

Live Runtime Locale

Language BLoC

LanguageBloc mengupdate Locale aktif secara instan tanpa perlu merestart aplikasi.

Pelajaran Kunci:

Memecah string terjemahan per fitur dan mengotomasi proses merger mencegah konflik git massal ketika puluhan teks baru ditambahkan bersamaan.

  1. Berkas ARB Terpisah per Modul Fitur: Setiap modul mengelola string terjemahannya sendiri di dalam foldernya masing-masing (misalnya features/ship/l10n/intl_ship_id.arb dan features/auth/l10n/intl_auth_id.arb).
  2. Skrip CLI Penggabung Otomatis: Skrip otomatis memindai seluruh folder fitur, menggabungkan kunci-kunci terjemahan ke dalam berkas utama app_id.arb dan app_en.arb, serta memvalidasi agar tidak ada kunci teks yang duplikat.
  3. Generasi Kode Compile-Time: Perintah resmi flutter gen-l10n menghasilkan kelas AppLocalizations dengan jaminan keamanan tipe di compile-time. Teks terjemahan yang hilang akan langsung terdeteksi oleh Dart analyzer sebelum kode sempat dijalankan.
  4. 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!