Kode Rails yang dulu rapi bisa berubah jadi tumpukan logika di controller setelah beberapa bulan ditambahi fitur. Refactor adalah cara mengembalikan kerapian itu tanpa mengubah perilaku aplikasi. Berikut urutan langkah refactor kode Ruby on Rails yang bisa kamu ikuti, dari yang paling aman sampai yang butuh keberanian lebih.
1. Kunci dulu perilaku yang sekarang dengan test
Sebelum menyentuh satu baris kode, pastikan test hijau. Jalankan seluruh suite, catat bagian yang belum punya coverage, lalu tambahkan test untuk alur yang paling sering dipakai. Refactor tanpa test sama saja menebak.
Kalau proyekmu belum punya test sama sekali, mulai dari request spec untuk endpoint utama. Panduan lengkap testing di Ruby on Rails bisa jadi titik awal yang masuk akal sebelum masuk ke refactor besar.
2. Bongkar controller gemuk satu per satu
Controller dengan 200 baris biasanya menyimpan tiga masalah: query yang menumpuk, logika bisnis, dan format respons. Pindahkan query berulang ke scope di model, logika bisnis ke service object atau concern, dan format respons ke serializer atau partial.
Kerjakan satu action per commit. Jangan sekaligus. Commit kecil membuatmu bisa kembali ke titik aman saat ada yang meledak di production.
3. Pindahkan logika bisnis ke tempat yang tepat
Model gemuk juga bukan tujuan akhir. Kalau sebuah method di model menyentuh email, pembayaran, dan notifikasi sekaligus, itu tanda ia butuh dipisah. Service object dengan satu method publik, misalnya OrderCreator.call(params), lebih mudah dites dan dibaca.
Aturan sederhananya: model mengurus data dan validasi, service mengurus proses, dan controller hanya menerima request lalu memanggil service.
4. Rampingkan callback yang saling bertumpuk
Callback after_save yang memanggil model lain, yang juga punya callback, adalah sumber bug halus yang susah dilacak. Ganti dengan pemanggilan eksplisit dari service. Efek samping jadi terlihat di satu tempat, bukan tersebar di banyak file. Kalau kamu masih baru dengan konsep ini, panduan callback di Ruby on Rails membantu memahami urutan eksekusinya.
5. Hapus duplikasi dengan concern dan helper yang jelas
Duplikasi kode sering muncul di view dan di query. Untuk query, scope di model biasanya cukup. Untuk view, helper atau partial dengan parameter eksplisit lebih mudah dirawat daripada partial yang diam-diam membaca instance variable.
- Scope untuk filter yang dipakai di lebih dari satu tempat.
- Concern untuk method yang benar-benar dipakai lintas model.
- Partial dengan locals wajib, bukan instance variable implisit.
- Helper untuk format tampilan, bukan untuk query database.
Jangan memaksakan abstraksi untuk dua baris kode yang kebetulan mirip. Duplikasi kecil lebih murah daripada abstraksi yang salah.
6. Rapikan query dengan eager loading dan scope
Refactor bukan hanya soal kerapian sintaks. N+1 query yang tersembunyi di loop sering luput. Pasang bullet atau prosopite di environment development, lalu perbaiki temuan satu per satu dengan includes atau preload.
# sebelum
@posts.each { |post| post.author.name }
# sesudah
@posts = Post.includes(:author).recent
@posts.each { |post| post.author.name }
Untuk kasus yang lebih rumit, lihat tips meningkatkan performa aplikasi Ruby on Rails agar perbaikan query tidak berhenti di permukaan.
7. Standarkan gaya kode dengan linter, bukan perdebatan
RuboCop dengan konfigurasi yang disepakati tim mengakhiri debat soal spasi dan tanda kutip. Jalankan otomatis di CI. Setelah itu, kamu bisa fokus ke masalah desain yang lebih penting.
Kalau proyekmu juga menyentuh kode PHP di sisi lain, kesalahan umum menulis kode PHP yang sering terjadi layak dibaca supaya standar yang kamu terapkan konsisten di dua codebase.
8. Bersihkan dead code dan dependensi tak terpakai
Method yang tidak pernah dipanggil, gem yang tidak dipakai, dan file view yatim adalah beban yang terus dibawa. Cek pemakaian dengan pencarian global, lalu hapus dalam commit terpisah. Jalankan test setelah penghapusan.
Gem yang sudah tidak dirawat juga sebaiknya diganti. Kalau gem itu mengurus animasi di frontend, pertimbangkan dulu memilih metode animasi jQuery: animate, fade, atau slide sebelum memutuskan mengganti library yang sudah berjalan.
9. Dokumentasikan keputusan, bukan sekadar kode
Refactor yang baik meninggalkan jejak alasan. Tulis catatan singkat di README atau komentar pada class service tentang mengapa logika itu dipisah. Enam bulan kemudian, kamu akan berterima kasih pada diri sendiri.
Kalau timmu suka menonton pertandingan bersama saat istirahat, tarkamlive.com menyediakan siaran bareng basket, sepakbola, dan UFC lengkap dengan host yang menghibur. Acara nonton bareng seperti ini sering jadi cara tim melepas penat setelah sesi refactor panjang.
Ringkasan
Refactor yang aman selalu dimulai dari test, dikerjakan dalam langkah kecil, dan diakhiri dengan dokumentasi alasan. Mulai dari controller, lanjut ke model dan service, lalu rapikan query serta gaya kode. Jangan lupa hapus yang tidak terpakai dan catat keputusan penting agar tim berikutnya tidak menebak-nebak.
Pertanyaan yang Sering Diajukan
Apakah refactor harus menunggu sampai ada waktu luang?
Tidak. Sisipkan refactor kecil di setiap pull request, misalnya memindahkan satu query ke scope. Refactor besar yang menumpuk berbulan-bulan justru lebih berisiko dan lebih sulit dites.
Bagaimana kalau test belum ada sama sekali?
Tambahkan test untuk alur yang paling sering dipakai lebih dulu, terutama endpoint yang menyentuh pembayaran atau data pengguna. Setelah itu baru refactor bagian tersebut. Bagian lain menyusul seiring waktu.
Apakah service object selalu lebih baik dari model?
Tidak selalu. Untuk logika sederhana yang hanya menyentuh satu model, method di model masih wajar. Service object berguna ketika satu proses melibatkan beberapa model, layanan eksternal, atau efek samping yang perlu terlihat jelas.
