Artikel
Technical Debt di Odoo yang Dikustomisasi: Checklist Audit
Odoo hasil kustomisasi makin sulit di-upgrade? Pakai checklist audit praktis ini untuk menemukan technical debt, menilai risikonya, dan menentukan prioritas perbaikan.
- bottom
- odoo
Jawaban singkat: technical debt di Odoo yang dikustomisasi adalah selisih antara apa yang dilakukan custom code Anda dan biaya untuk menjaganya tetap berjalan sampai upgrade berikutnya. Cara mengauditnya: buat inventaris semua custom module, cek seberapa banyak yang menduplikasi fitur standar, uji perilakunya terhadap versi yang lebih baru, lalu urutkan setiap item berdasarkan risiko bisnis. Checklist di bawah ini bisa dikerjakan tim kecil dalam beberapa hari, bukan berbulan-bulan.
Mengapa ini penting sekarang
Dokumentasi resmi Odoo cukup tegas. Panduan upgrade database yang dikustomisasi mendefinisikan custom module sebagai modul apa pun yang memperluas kode standar Odoo dan tidak dibuat dengan Studio. Panduan itu menyebut bahwa menghilangkan redundansi antara pengembangan Anda dan versi standar Odoo akan mempermudah proses upgrade. Artinya, Odoo sendiri memandang custom code sebagai hambatan utama saat upgrade.
Dokumentasi upgrade menambahkan batasan keras. Database dengan custom module tidak bisa di-upgrade sampai tersedia versi modul tersebut untuk versi tujuan. Setiap versi mayor didukung selama tiga tahun, dan dokumentasi menyarankan agar tetap memakai versi yang didukung. Jadi custom code yang tidak bisa dimigrasikan pada akhirnya menjadi masalah keamanan dan dukungan, bukan sekadar ketidaknyamanan.
Audit, langkah demi langkah
1. Inventarisasi semua yang bukan standar
Anda tidak bisa mengukur masalah yang belum didaftar. Buat tabel dengan satu baris per item:
| Item | Yang dicatat |
|---|---|
| Custom module | Nama, fungsi, pembuat, tanggal perubahan terakhir, versi Odoo target |
| Aplikasi pihak ketiga | Sumber vendor atau OCA, versi, masih dirawat atau tidak |
| Kustomisasi Studio | Field, view, automation, dan siapa pemiliknya |
| Server action dan automated action | Kode yang tersimpan di database, bukan di repository |
| Report dan template QWeb | Override dokumen standar (invoice, surat jalan) |
| Integrasi eksternal | API, webhook, script terjadwal yang membaca atau menulis ke Odoo |
Yang paling sering terlewat adalah kode yang tersimpan di database (server action, automation Studio) dan integrasi buatan orang yang sudah tidak bekerja lagi di sana. Dua hal ini sumber umum kejutan saat upgrade.
2. Pastikan kode ada di version control
Ajukan tiga pertanyaan. Apakah setiap custom module ada di repository Git? Apakah kode yang berjalan sama dengan isi repository? Apakah seseorang bisa membangun ulang server yang berfungsi hanya dari repository? Jika salah satunya tidak, perbaiki dulu sebelum yang lain. Kode yang hanya ada di server produksi adalah item berisiko tertinggi dalam seluruh audit.
3. Cari redundansi dengan Odoo standar
Inilah langkah yang ditekankan dokumentasi Odoo. Untuk setiap custom module, tanyakan: apakah Odoo standar sekarang sudah bisa melakukannya? Odoo menambah fitur di setiap rilis, dan kustomisasi yang ditulis untuk versi 14 mungkin kini hanya berupa pengaturan konfigurasi.
Beri tiap modul salah satu label:
- Retire: Odoo standar atau aplikasi yang terawat sudah mencakupnya.
- Replace: modul OCA atau vendor yang terawat mencakup sebagian besar fungsinya.
- Keep: modul ini mengandung sesuatu yang spesifik dengan cara kerja Anda.
- Unknown: tidak ada yang bisa menjelaskan mengapa modul ini ada. Anggap berisiko sampai terbukti sebaliknya.
Jujurlah pada tumpukan “Keep”. Kustomisasi yang mencerminkan proses yang benar-benar menjadi keunggulan layak dipertahankan. Kustomisasi yang hanya meniru cara kerja sistem lama biasanya tidak.
4. Periksa cara kode ditulis
Anda tidak perlu membaca setiap baris. Ambil sampel dari modul terbesar atau yang paling sering dipakai, lalu cari tanda bahaya berikut:
- SQL langsung ke tabel Odoo, yang melewati ORM dan sering rusak saat skema berubah antar versi.
- Override method inti dengan menyalin seluruh method, bukan memanggil
super(). Method hasil salinan diam-diam tidak ikut perbaikan dari upstream. - Mengedit file inti Odoo atau enterprise secara langsung. Ini membuat upgrade hampir mustahil.
- ID yang di-hard-code untuk record, perusahaan, pajak, atau akun.
- Tanpa test. Jika modul tidak punya automated test, setiap upgrade berarti pengecekan manual untuk semua yang disentuhnya.
- API yang sudah deprecated dan sintaks view lama, yang didaftar dalam release notes tiap versi.
Cara cepat mengukur risiko override adalah mendaftar model standar mana yang diwarisi modul Anda dan berapa method yang diganti. Semakin banyak perilaku standar yang di-override, semakin besar peluang upgrade merusaknya.
5. Uji terhadap versi yang lebih baru
Ukuran technical debt yang paling andal adalah percobaan upgrade yang sebenarnya. Proses Odoo: minta test database hasil upgrade, perbarui source custom module untuk versi tujuan, lalu uji menyeluruh. Dokumentasi menyebut test database dipakai untuk memverifikasi proses upgrade standar, dan dikirim tanpa filestore, jadi gabungkan dengan filestore produksi sebelum menilai hasilnya.
Jalankan di salinan, jangan pernah di produksi. Catat berapa modul yang gagal di-install, berapa yang gagal test, dan berapa lama tiap perbaikan. Hasilnya adalah estimasi berbasis bukti, bukan tebakan.
6. Cek kualitas data dan performa
Debt bukan hanya soal kode. Cari partner duplikat, produk terbengkalai, entri yang belum direkonsiliasi, dan custom field yang tidak pernah diisi. Periksa juga laporan lambat atau job terjadwal yang makin berat seiring volume data. Membersihkan data sebelum upgrade lebih murah daripada membawa masalahnya ke versi baru.
7. Tinjau kepemilikan dan dokumentasi
Untuk setiap custom module, apakah Anda bisa menyebut penanggung jawab di sisi Anda dan developer yang bisa mengubahnya? Apakah ada dokumen singkat tentang fungsi dan alasannya? Risiko ketergantungan pada satu orang, misalnya satu freelancer yang memegang semua pengetahuan, adalah technical debt walaupun kodenya rapi.
Penilaian: apa yang diperbaiki lebih dulu
Beri tiap modul dua skor 1 sampai 3: tingkat kritis bisnis (apa yang rusak jika gagal) dan risiko upgrade (seberapa banyak override dan seberapa minim test). Lalu tindak dengan urutan:
- Kritis tinggi, risiko tinggi: perbaiki lebih dulu. Tambah test, pindahkan ke version control, rapikan override.
- Kritis rendah, risiko tinggi: retire atau replace jika memungkinkan.
- Kritis tinggi, risiko rendah: dokumentasikan dan pantau.
- Kritis rendah, risiko rendah: biarkan.
Apa yang biasanya terlihat dari audit
Hasil yang umum, berdasarkan pengalaman kami dan bukan statistik universal: segelintir modul menanggung sebagian besar risiko, cukup banyak kustomisasi ternyata sudah redundan, dan sedikit integrasi tanpa dokumentasi perlu ditangani segera. Angka Anda sendiri akan berbeda tergantung usia sistem dan siapa yang membangunnya.
Refactoring tidak gratis dan bersaing dengan pengerjaan fitur. Trade-off yang jujur: pembersihan memakan biaya sekarang untuk menghindari biaya yang lebih besar dan sulit diprediksi saat upgrade. Jika sistem Anda kecil, stabil, dan di versi yang masih didukung, audit ringan mungkin cukup. Jika Anda tertinggal dua versi mayor atau lebih, atau memakai campuran Studio dan custom code yang tidak dipahami siapa pun, audit penuh biasanya sepadan. Proyek OpenUpgrade yang dikelola OCA adalah opsi untuk database Community, tetapi tidak menghilangkan kebutuhan memigrasikan custom module Anda sendiri.
Langkah berikutnya
Jika Anda ingin pendapat kedua, kami senang membahasnya bersama Anda. Teknologia Solutions menawarkan percakapan tanpa biaya untuk meninjau daftar modul Anda, menunjukkan risiko yang mungkin ada, dan mengatakan terus terang apakah audit layak dilakukan. Tanpa kewajiban, dan tanpa tekanan untuk memakai jasa kami.
Sumber: Odoo: Upgrade a customized database, Odoo: Upgrade documentation, OCA OpenUpgrade. Kebijakan dan tooling Odoo berubah antar rilis, jadi mohon verifikasi detailnya ke sumber primer dan dokumentasi versi Anda sebelum bertindak.