Kualitas dan Rilis di Holigo: Apa yang Berhasil, Apa yang Masih PR, dan Pelajaran Berharga - Part 7
Architecture & Decision Log·13 November 2026·10 menit baca
Semua catatan

Kualitas dan Rilis di Holigo: Apa yang Berhasil, Apa yang Masih PR, dan Pelajaran Berharga - Part 7

Retrospektif penutup seri migrasi Holigo: evaluasi jujur pemisahan environment, automated testing, pipeline rilis CI/CD, dan pelajaran jika mengulang dari nol.

Bagian yang Jarang Dituliskan: Menatap Realitas Rekayasa Perangkat Lunak Secara Jujur#

Di sepanjang enam bagian pertama dari seri tulisan ini, kita telah membahas berbagai keputusan arsitektur yang mengubah Holigo dari basis kode GetX yang penuh keterikatan (tightly coupled) menjadi sistem yang modular dan mudah diuji berbasis Clean Architecture dan BLoC. Kita telah mengulas batas-batas tiga lapisan kode, dependency injection berbasis service locator, navigasi deklaratif, jalur data terpusat, hingga cetak biru modul tiket Kapal (Pelni).

Namun, tulisan seputar arsitektur perangkat lunak kerap kali terjebak dalam bias yang seragam: artikel teknologi cenderung melukiskan gambaran ideal di mana setiap pola arsitektur berjalan tanpa cela dan semua persoalan teknis lenyap dalam semalam.

Pada bagian penutup ini, saya ingin membagikan retrospektif yang jujur dan apa adanya. Migrasi arsitektur berskala besar pada kenyataannya tidak pernah benar-benar "selesai sempurna" tanpa meninggalkan pekerjaan rumah (PR), catatan teknis, dan pelajaran berharga di lapangan. Membicarakan sisi-sisi yang belum sempurna (seperti isolasi environment, cakupan automated testing, pipeline build, hingga keamanan penandatanganan rilis) jauh lebih bermanfaat bagi sesama engineer daripada berpura-pura bahwa segalanya berlangsung mulus tanpa friksi.

FIG.
Pemisahan Environment: Bahaya Default Produksi vs Entry Point Khusus
Keamanan Lingkungan Rilis
Pola Lama: Default ProduksiRisiko Tinggi Insiden Data
  1. 01Satu File main.dart: Environment develop dan production ditentukan dengan mengedit konstanta di satu file.
  2. 02Default ke Live Server: Developer yang menjalankan app untuk uji coba lokal bisa tak sengaja memanggil API produksi.
  3. 03Human Error: Rawan lupa mengembalikan konstanta sebelum melakukan git commit atau build APK.
Bahaya fatal transaksi uji coba tercatat di database live
Pola Baru: Entry Point TerisolasiAman · Deterministic Flavors
  1. 01main_dev.dart & main_prod.dart: Setiap environment memiliki berkas entry point dan konfigurasi endpoint terisolasi.
  2. 02Aman Secara Default: Build lokal otomatis menggunakan environment develop; data produksi terkunci rapat.
  3. 03Skrip Build Otomatis: CI/CD memilih flavor target secara eksplisit saat kompilasi rilis resmi.
Entry point mandiri menjamin kebersihan database transaksi
Pelajaran Kunci:

Lingkungan yang aman harus menjadi default; jangan pernah mengandalkan disiplin ingatan developer untuk menghindari kesalahan koneksi ke server produksi.

Pemisahan Environment: Menghapus Bahaya Fatal Default Produksi#

Ketika tim kami mengaudit aplikasi lama pada fase awal migrasi, kami menemukan ranjau operasional yang sangat berbahaya: meskipun secara teknis kode memiliki konstanta untuk server develop dan production, berkas entry point tunggal aplikasi justru tersetel default langsung mengarah ke server produksi secara hening.

Risiko dari kesalahan konfigurasi ini sangat nyata:

  • Developer yang menyalakan build debug lokal hanya untuk mencoba tata letak sebuah tombol baru berisiko memicu request jaringan yang tanpa sengaja mencemari database transaksi live pengguna.
  • Developer kerap mengedit konstanta alamat endpoint di main.dart secara manual di laptop masing-masing, menciptakan risiko lupa mengembalikan konfigurasi sebelum melakukan git commit atau tanpa sengaja merilis APK uji coba ke toko aplikasi.

Kami segera menuntaskan kerentanan ini dengan menerapkan Dedicated Entry Points dan Flutter Flavors:

  • main_dev.dart: Target peluncuran standar untuk proses development lokal. Berkas ini terkunci hanya ke server uji coba (sandbox), menyalakan pencatatan log curl lengkap, serta menampilkan banner visual penanda environment develop di appbar.
  • main_prod.dart: Dikhususkan khusus untuk proses kompilasi rilis resmi. Alamat endpoint, API key, dan kredensial rahasia disuntikkan melalui flag compile-time, dengan seluruh logging debug dinonaktifkan secara total.

Dengan menjadikan lingkungan sandbox yang aman sebagai nilai bawaan (safe by default), kami mematikan risiko human error dan menjaga kebersihan database produksi.

Pengujian di Dunia Nyata: Prasyarat vs Kenyataan Cakupan Tes#

Pada Part 3, saya sempat menekankan sebuah prinsip penting: arsitektur yang modular membuat aplikasi mudah diuji, namun arsitektur tidak akan menuliskan pengujian untuk kita.

Ketika kami berhasil memigrasikan fitur tiket Kapal, tim merasa sangat bangga dengan lapisan domain Dart murni dan aliran state BLoC yang deterministik. Secara teori, setiap use case dan repository kini dapat diuji dan di-mock dalam hitungan milidetik. Namun di lapangan, ketika tenggat waktu sprint semakin ketat dan kebutuhan bisnis menuntut rilis cepat untuk fitur pesawat, kereta api, dan pembayaran tagihan, penulisan automated test sempat tertinggal di belakang kecepatan rilis fitur.

Selama beberapa bulan, jumlah automated test kami tergolong sangat minim dibandingkan dengan pesatnya pertambahan modul fitur. Meskipun arsitektur berhasil mengisolasi bug ke modul fiturnya masing-masing, pendeteksian regresi di lapangan masih terlalu bergantung pada verifikasi manual dari tim QA.

Sadar akan adanya technical debt ini, kami mulai menyusun roadmap pengujian terstruktur:

  • Kami memprioritaskan automated unit test pada logika finansial yang bernilai tinggi: use case kalkulasi tarif tiket, pemformatan mata uang, dan interceptor refresh token.
  • Kami menyusun pengujian stream BLoC menggunakan library bloc_test, memastikan bahwa input event tertentu menghasilkan transisi state yang presisi.
  • Perjalanan menuju cakupan tes yang ideal adalah pekerjaan rumah yang terus kami cicil, namun batas lapisan yang tegas membuat proses penulisan tes tersebut menjadi sangat teratur dan mudah diulang.

Gerbang Kualitas Otomatis: Dari Pre-Commit Hingga Rilis ke Store#

Dalam kultur engineering yang matang, kualitas rilis tidak boleh bergantung pada daya ingat developer atau ketelitian inspeksi manual semata. Build aplikasi yang dirilis ke pengguna tidak boleh berasal dari laptop pribadi seorang engineer, di mana variabel lingkungan lokal yang tidak sengaja terpasang, baris kode git yang belum ter-push, atau versi Flutter SDK yang usang dapat mengotori binary rilis.

Kami membangun Pipeline Kualitas CI/CD Otomatis:

FIG.
Roadmap Kualitas: Dari Analisis Statis ke Rilis Otomatis
CI/CD Quality Pipeline
01

Pre-Commit Lint

Local Check

Menjalankan dart analyze dan format otomatis sebelum perubahan dikomit ke git repository.

02

CI Test Suite

Pull Request Guard

Automated unit test untuk Use Case, Repository, dan BLoC state stream berjalan di server CI.

03

Secure Signing

Keystore Vault

Proses penandatanganan APK/AAB dan IPA dilakukan otomatis via encrypted keystore vault.

04

Store Deploy

Continuous Delivery

Binary dirilis langsung ke Google Play Internal Track dan Apple TestFlight tanpa laptop developer.

Pelajaran Kunci:

Rilis yang datang dari pipeline otomatis menghilangkan sindrom 'works on my machine' dan memastikan setiap perubahan binary dapat direproduksi secara transparan.

  1. Linting dan Format Pre-Commit: Git hooks otomatis menjalankan dart analyze dan dart format di komputer lokal sebelum commit diizinkan, memastikan konsistensi gaya penulisan kode dan mencegah warning masuk ke repositori.
  2. Gerbang Kualitas di Pull Request: Saat developer membuat pull request, server CI memicu runner terisolasi untuk menjalankan analisis statis, mengeksekusi rangkaian automated unit test, serta memverifikasi bahwa berkas lokalisasi ARB modular berhasil dikompilasi tanpa error. Tombol merge terkunci jika ada tes yang gagal.
  3. Brankas Keystore Hardware: Berkas Android Keystore dan iOS Distribution Provisioning Profile tersimpan aman di dalam brankas rahasia terenkripsi pada server CI. Tidak ada developer yang menyimpan private key produksi di laptop kerja mereka.
  4. Distribusi Rilis Berkelanjutan (CD): Setelah kode di-merge ke branch rilis, pipeline secara otomatis mengompilasi App Bundle (.aab) dan binary iOS (.ipa) yang sudah ditandatangani, lalu mengunggahnya langsung ke jalur Google Play Internal Testing dan Apple TestFlight untuk verifikasi tim QA dan stakeholder.

Pipeline ini menghapus sindrom klasik "works on my machine" untuk selamanya dan membuat ritme rilis aplikasi menjadi transparan, aman, dan dapat direproduksi kapan saja.

Retrospektif Jujur: Apa yang Akan Saya Ubah Jika Mengulang dari Awal#

Melihat kembali seluruh perjalanan migrasi multi-tahun ini, ada empat keputusan fundamental yang akan saya lakukan secara berbeda jika diberi kesempatan mengulang dari hari pertama:

FIG.
Matriks Retrospektif: Pelajaran Nyata dari Perjalanan Migrasi
Architectural Wisdom
01Environment Sejak Hari PertamaFondasi Awal

Pisahkan konfigurasi develop dan produksi sejak baris kode pertama, bukan setelah aplikasi membesar.

02Tes Bersama Fitur PilotWarisan Pola

Tulis unit test lengkap di fitur pertama (Kapal) agar contoh tes ikut terduplikasi ke fitur berikutnya.

03Otomasi CI/CD Lebih AwalEfisiensi Tim

Membangun pipeline saat fitur masih sedikit jauh lebih murah dan mudah daripada saat modul sudah puluhan.

04Catat Tech Debt Secara JujurIntegritas Tim

Modul yang masih partial atau skeleton wajib dicatat apa adanya agar tidak ada asumsi keliru di tim.

Pelajaran Kunci:

Keputusan arsitektur yang diambil dengan sadar, lengkap beserta konsekuensi dan harga yang harus dibayar, jauh lebih berharga daripada memaksakan pola yang hanya terlihat sempurna di atas kertas.

Disiplin Arsitektur→Kolaborasi Tim→Skalabilitas Jangka Panjang
  1. Pisahkan Environment Sebelum Menulis Fitur Pertama: Seharusnya kami memisahkan main_dev.dart dan main_prod.dart sejak baris kode pertama, bukan memperbaikinya setelah beberapa fitur sudah berjalan. Keamanan lingkungan kerja harus selalu mendahului pengembangan fitur.
  2. Sertakan Contoh Unit Test Bersama Fitur Pilot: Kami membangun fitur Kapal sebagai cetak biru arsitektur, namun kami tidak melengkapinya dengan contoh unit test yang lengkap saat dirilis. Akibatnya, ketika tim menduplikasi blueprint Kapal ke fitur berikutnya, mereka mewarisi struktur lapisannya namun melewatkan penulisan tesnya. Menyertakan contoh tes berstandar tinggi di modul pilot akan menanamkan budaya testing sejak hari pertama.
  3. Bangun Otomasi CI/CD Lebih Awal: Membangun pipeline otomasi saat aplikasi baru memiliki dua modul sangatlah mudah dan bebas hambatan. Menambahkan pipeline integrasi berkelanjutan saat aplikasi sudah memiliki belasan fitur yang sedang aktif dikembangkan membutuhkan energi yang berkali-kali lipat lebih besar.
  4. Catat Technical Debt Secara Terbuka dan Jujur: Dalam setiap migrasi bertahap, beberapa modul pasti akan tertinggal sebagai skeleton atau refactor parsial. Mendokumentasikan modul-modul yang belum selesai secara transparan mencegah timbulnya asumsi keliru dan menjaga technical debt tetap terpantau oleh pimpinan produk.

Ringkasan Pelajaran dari Seri 7 Tulisan Ini#

Jika kamu sedang memimpin atau terlibat dalam migrasi arsitektur aplikasi mobile berskala besar, berikut adalah prinsip-prinsip utama yang memandu perjalanan kami:

  • Hindari Jebakan Rewrite Total: Migrasi bertahap per fitur menggunakan Strangler Fig pattern melindungi pendapatan bisnis harian dan memecah risiko teknis yang masif menjadi bagian-bagian kecil yang terkendali.
  • Tetapkan Standar Pola Sebelum Menambah Fitur Kedua: Manfaatkan modul pilot untuk merumuskan batas lapisan Presentation, Domain, dan Data. Produktivitas tim akan berlipat ganda ketika engineer menduplikasi cetak biru yang sudah teruji.
  • Gunakan Alur State Satu Arah dan DI yang Eksplisit: Pasangkan BLoC dengan injector fitur modular di get_it. Transisi event-to-state yang deterministik memberikan ketenangan pikiran dan kestabilan jangka panjang di production.
  • Jaga Pintu Masuk Aplikasi dengan Ketat: Perlakukan proses startup sebagai urutan inisialisasi yang disiplin. Gunakan middleware navigasi deklaratif seperti go_router untuk menegakkan keamanan sesi secara terpusat di seluruh rute dan deep link.
  • Perkokoh Lapisan Data: Pusatkan klien HTTP, otomatisasi refresh token di interceptor, pisahkan brankas terenkripsi dari cache biasa, dan gantikan blok try-catch yang berserakan dengan batas functional result Either.
  • Otomatisasi Mutu Tanpa Kompromi: Pre-commit hook, gerbang tes di CI, dan distribusi rilis otomatis melindungi tim dari kesalahan manusia dan memastikan setiap binary rilis dapat direproduksi secara transparan.

Penutup Seri#

Migrasi arsitektur pada hakikatnya bukan tentang mengadopsi library manajemen state yang paling tren atau mengejar kesempurnaan teori di atas kertas semata. Ini adalah tentang menata ulang bagaimana sebuah tim rekayasa perangkat lunak merancang, menguji, dan merawat produk digital dengan penuh rasa percaya diri dalam jangka panjang.

Setiap keputusan arsitektur selalu memiliki harga yang harus dibayar. Ciri dari kematangan seorang senior engineer bukanlah menemukan pola yang bebas dari trade-off (karena pola semacam itu tidak pernah ada), melainkan memahami secara mendalam konsekuensi dari setiap pilihan yang diambil, dan secara sadar memilih konsekuensi yang sanggup dikelola bersama oleh tim.

Kepada seluruh pembaca yang telah mengikuti perjalanan ini dari Part 1 hingga Part 7: terima kasih telah meluangkan waktu membaca cerita saya :)

P.S. Seluruh seri ini ditulis di level keputusan desain arsitektur, rekayasa perangkat lunak, dan kepemimpinan teknis, tanpa membuka kode rahasia atau data internal perusahaan. Jika kamu sedang menavigasi transisi arsitektur serupa di organisasimu atau ingin berdiskusi seputar arsitektur Flutter tingkat lanjut, mari terhubung dan bertukar pengalaman!