Dev Log: Kejujuran Sistem
Bangun sistem yang mengatakan kebenaran.
Sebuah sistem hanya akan sebagus sinyal yang dihasilkannya. Jika kueri Anda menyembunyikan pemborosan, pemeriksaan kesehatan (health check) Anda berbohong, atau alat Anda mengulang pekerjaan yang sama, maka sistem Anda tidak jujur.
Saya menghabiskan hari ini mengerjakan empat utas teknis yang berbeda. Masing-masing mengikuti satu tema tunggal: membuat sistem menjadi jujur.
- Performa Database Berhenti mengambil data yang tidak Anda gunakan.
- Gunakan detektor N+1 di lingkungan pengembangan Anda. Ini mengubah lazy-load yang tersembunyi menjadi daftar tugas yang jelas.
- Hapus eager load yang tidak digunakan. Jika tampilan (view) Anda tidak menggunakan sebuah kolom, jangan ambil kolom tersebut.
- Lakukan memoize pada konstanta per permintaan. Jangan menghitung ulang nilai yang sama berkali-kali dalam satu siklus.
- Kelompokkan kueri dasbor. Ganti dua puluh panggilan hitung (count) kecil dengan satu kueri yang dikelompokkan.
- Pemeriksaan Kesehatan (Health Check) yang Nyata Pemeriksaan yang hanya memverifikasi apakah sebuah konfigurasi ada bukanlah sebuah health check. Itu adalah pemeriksaan konfigurasi.
- Sebuah health check yang nyata harus membuktikan keterjangkauan (reachability).
- Buka socket ke host dan port target.
- Gunakan kontrak atau antarmuka (interface) untuk beralih antara probe TCP, HTTP, atau TLS.
- Jalankan setiap probe pada koneksinya sendiri. Satu layanan yang lambat tidak boleh menghentikan seluruh alat pemantauan Anda.
- Alat AI yang Lebih Aman (MCP) Saat Anda memberikan akses ke sistem Anda kepada agen AI, Anda harus berasumsi bahwa ia akan melakukan kesalahan.
- Gunakan kunci idempotensi (idempotency keys). Jika agen mencoba kembali sebuah permintaan, server harus mengembalikan hasil yang sama alih-alih membuat duplikat.
- Bersihkan (scrub) data pribadi saat keluar. Perlakukan jalur respons sebagai batas publik.
- Gunakan kode kesalahan bertipe (typed error codes). Jangan kirim string mentah. Seorang agen membutuhkan kode terstruktur seperti
"not_found"untuk bertindak dengan benar.
- Identitas dan Atur Ulang Kata Sandi Urutan sangat penting saat Anda menyentuh banyak sistem.
- Jika pengaturan ulang kata sandi memengaruhi banyak direktori, pilih satu sumber kebenaran (source of truth).
- Tulis ke direktori otoritatif terlebih dahulu.
- Dokumentasikan urutannya. "Ini berhasil saat saya mencobanya" bukanlah jaminan keberhasilan saat terjadi kegagalan.
Tujuannya bukan untuk membangun fitur yang mencolok. Tujuannya adalah membangun sistem yang tetap dapat dipercaya saat Anda tidak sedang melihatnya.