Disiplin Pasukan: Pentingnya Code Review Dalam Projek Enterprise

Bila buat projek freelance seorang diri, kita bebas buat apa saja. Nak namakan pembolehubah temp2, nak hardcode sedikit konfigurasi sementara, atau terus git push ke main pukul dua pagi—semua risiko tu kita tanggung sendiri.

Keadaan berubah sepenuhnya bila anda masuk ke projek enterprise atau sistem yang diguna oleh puluhan ribu pengguna serentak, apatah lagi kalau melibatkan transaksi kewangan, data pelanggan, atau integrasi agensi luar. Dalam pasukan yang ada lima hingga lima belas orang developer, satu baris kod yang cuai boleh buat servis utama terhenti dan memaksa satu pasukan berjaga malam buat rollback.

Di sinilah Code Review (semakan Pull Request) berfungsi sebagai jaringan keselamatan terakhir sebelum kod masuk ke persekitaran production.

Code review bukan sesi mencari salah kawan

Ramai junior developer rasa gementar dan cepat bersikap defensive bila Pull Request (PR) mereka menerima banyak komen daripada senior. Mereka anggap setiap teguran tu macam tanda kerja mereka tak cukup bagus.

Sebenarnya, code review yang sihat memisahkan kod daripada penulisnya. Kalau seorang senior tegur supaya anda guna using atau try/finally untuk tutup sambungan pangkalan data, tujuannya bukan nak tunjuk siapa lagi pandai—tujuannya ialah memastikan sistem tak kehabisan connection pool bila trafik naik mendadak hari Isnin nanti.

Sebaliknya, sebagai penyemak pula, cara menulis komen sangat menentukan budaya pasukan. Bandingkan dua ayat ini:

  • “Kenapa tulis macam ni? Lambat sangat.”
  • “Loop ni buat query ke DB setiap kali pusingan. Kalau kita tarik semua rekod sekali gus guna WHERE IN sebelum loop, beban DB akan turun banyak.”

Yang kedua memberi konteks teknikal dan mengajar tanpa merendahkan sesiapa.

Apa yang patut disemak—dan apa yang patut diserahkan kepada mesin

Jangan buang masa manusia menyemak benda yang boleh diselesaikan oleh alat automasi. Soal indentation, titik koma, susunan import, atau gaya penamaan biarlah linter, Prettier, EditorConfig, atau CI pipeline yang tegur sebelum PR dibuka.

Bila manusia membaca PR, fokus patut diberi kepada empat perkara yang mesin susah nak tangkap:

  • Kesan kepada pangkalan data dan prestasi: Adakah kod baru ni mencipta N+1 query dalam ORM seperti Entity Framework atau Eloquent? Adakah terdapat query pada jadual besar tanpa index yang sesuai?
  • Keselamatan dan integriti data: Adakah input pengguna disahkan di sebelah pelayan (server-side validation), bukan sekadar di UI? Kalau kod tu melibatkan potongan baki atau pengesahan bayaran, adakah ia dibungkus dalam database transaction supaya tak berlaku race condition?
  • Pengendalian ralat (error handling): Apa jadi kalau API pihak ketiga seperti gerbang pembayaran atau servis emel tiba-tiba timeout? Adakah ralat tu dilog dengan maklumat yang cukup untuk debugging, atau ditelan senyap-senyap oleh blok catch yang kosong?
  • Keterbacaan untuk orang seterusnya: Kalau anda bercuti minggu depan dan berlaku insiden di production, bolehkah rakan sepasukan faham aliran logik fungsi tersebut dalam masa lima minit tanpa perlu telefon anda?

Elakkan PR raksasa yang akhirnya dapat “LGTM” kosong

Satu kesilapan biasa dalam pasukan ialah mengumpulkan kerja dua minggu menjadi satu PR dengan 1,800 baris perubahan. Bila PR terlalu besar, penyemak akan letih selepas fail kesepuluh dan akhirnya tekan Approve dengan komen “LGTM” semata-mata sebab nak cepat.

Pecahkan ciri besar kepada PR kecil yang fokus—satu untuk perubahan skema pangkalan data, satu untuk servis logik teras, dan satu lagi untuk antaramuka atau endpoint API. PR yang mengambil masa 15 minit untuk disemak menghasilkan maklum balas yang jauh lebih tajam berbanding PR yang mengambil masa dua jam.

Perkongsian ilmu dua hala

Selain menjaga kualiti sistem, code review adalah tempat paling semula jadi untuk knowledge transfer. Pengaturcara baru belajar corak reka bentuk dan perangkap production melalui komen yang mereka terima. Pada masa yang sama, pengaturcara senior pun kerap belajar cara baharu atau ciri bahasa terkini yang lebih kemas daripada kod yang dihantar oleh ahli pasukan yang lebih muda.

Menulis perisian dalam skala enterprise adalah kerja berpasukan. Bila seluruh pasukan bersetuju bahawa setiap baris kod wajar disemak oleh sepasang mata kedua sebelum dilepaskan, kualiti sistem naik dan tekanan ketika deployment hari Jumaat pun jadi jauh lebih terkawal.