Doc_chelvyn/Easset Mac/Duplikat Nomor Inventaris/Bug Report Duplikat Nomor I...

15 KiB
Raw Permalink Blame History

proyek modul kategori urutan-baca tanggal branch status tags
e-Asset Patra Jasa pj_easset Duplikat Nomor Inventaris 1 dari 3 — laporan 2026-09-04 cj/easet Workaround — sumber sudah ditutup, 48 nomor kembar belum dibersihkan
easset
bug-report
duplikat-nomor-inventaris
sequence

Index: Easset — Index · Kasus: Duplikat Nomor Inventaris (1 dari 3 — laporan) Lanjut ke data: Daftar Duplikat Nomor Inventaris — DB master3 · Alat: Server Action Audit & Perbaikan Duplikat Nomor Inventaris

Tanggal: 04 September 2026

Server/Environment: Development lokal (branch cj/easet) — diperiksa pada 5 database, lihat tabel Besaran Masalah

Project: e-Asset Patra Jasa (pj_easset)

Status: ⚠️ Workaround — sumber duplikat sudah ditutup dan diuji; 48 nomor kembar yang terlanjur ada belum dibersihkan

Catatan revisi. Versi pertama dokumen ini disusun dari pembacaan kode saja dan menuding dua penyebab yang ternyata tidak terjadi. Setelah data sungguhan diperiksa, penyebabnya berbeda. Bagian Dugaan yang Gugur di bawah menjelaskan koreksinya.


Ringkasan Masalah

Ditemukan Nomor Inventaris yang dipakai lebih dari satu aset di beberapa database. Nomor Inventaris adalah identitas unik tiap aset — dipakai sebagai isi QR barcode, label fisik, acuan stock opname, dan kunci pencocokan di API mobile. Ketika satu nomor menunjuk ke lebih dari satu aset, seluruh proses yang bersandar padanya menjadi ambigu.

Akar masalahnya ada pada interaksi antara impor data dan counter penomoran. Nomor yang dibawa file impor masuk ke database tanpa memajukan counter. Counter lalu tertinggal jauh di belakang data yang sudah beredar, dan begitu sistem membuat nomor sendiri, angka yang keluar sudah dipakai record lain.

Yang membuat ini menumpuk tanpa ketahuan: sistem tidak pernah menolak nomor kembar. Tidak ada validasi keunikan sama sekali pada field ini.


Besaran Masalah per Database

Pemeriksaan dijalankan pada seluruh database yang ada di container development lokal:

| Database | Total aset | Nomor kembar | Record terdampak |

|---|---|---|---|

| Pre_Live | 38.682 | 11 | 40 |

| master3 | 39.136 | 48 | 96 |

| master2 | 38.885 | 8 | 16 |

| EASSET | 304 | 0 | 0 |

| master | 6 | 0 | 0 |

Angka production belum diukur. Seluruh angka di atas berasal dari database development. Sebelum memutuskan lingkup pembersihan, Server Action Audit & Perbaikan Duplikat Nomor Inventaris#SA-1 — Audit Duplikat Nomor Inventaris pada Server Action Audit & Perbaikan Duplikat Nomor Inventaris perlu dijalankan langsung di database production untuk mendapat angka yang sebenarnya.

master3 adalah database intake, bukan salinan production

Seluruh 39.136 aset di master3 dibuat oleh user admin dalam rentang 1 September 2026 09:01 sampai 2 September 2026 09:18 — tidak ada satu pun record yang lebih tua. Database ini bukan salinan production berikut riwayatnya, melainkan hasil intake data penuh dari sistem lama, dan ini database termuda yang ada.

Konsekuensinya penting: 48 duplikat di master3 lahir dari proses intake itu sendiri, bukan warisan kotoran production. Datanya diimpor pada 1 September, lalu sebagian diimpor ulang pada 2 September pukul 02:17:27 — seluruh 48 record kedua tercipta pada detik yang sama.

Dengan kata lain, kalau intake ini dijalankan ulang untuk membangun production, duplikat yang sama akan terbentuk lagi selama file sumber dan prosedurnya tidak berubah.

Pola duplikat berbeda antar database

Keduanya tercakup oleh perbaikan Rilis 1:

  • master3 — 48 nomor, masing-masing 2 record, batch kedua seluruhnya pada detik yang sama. Ciri khas file yang sama diimpor dua kali. Tertangkap oleh pemeriksaan "nomor sudah terpakai aset lain".

  • Pre_Live — 11 nomor tetapi 40 record, terkonsentrasi: A-2019-0002 dipakai 9 aset sekaligus, A-2018-0002 dipakai 7 aset, semuanya pada hari yang sama. Ciri khas satu file impor yang di dalamnya sendiri memuat nomor kembar. Tertangkap oleh pemeriksaan "nomor kembar di dalam satu file".

⚠️ Dampak Rilis 1 terhadap prosedur intake

Setelah Rilis 1 aktif, intake yang memuat nomor bermasalah tidak lagi diterima diam-diam — proses impor akan berhenti dan menampilkan daftar nomornya. Ini perilaku yang dikehendaki, tetapi mengubah cara kerja tim data: file sumber harus dibereskan lebih dulu, lalu impor diulang. Perubahan prosedur ini perlu disampaikan ke tim yang menjalankan intake sebelum Rilis 1 naik.


Timeline & Error

Error 1: Tidak ada pesan error — duplikat tercipta senyap


(tidak ada error message — inilah inti masalahnya)

pj_easset/models/maintenance/snk_maintenance_equipment.py:39


number = fields.Char(string='Equipment Number', copy=False)

Tidak ada _sql_constraints, tidak ada @api.constrains keunikan. Nomor kembar lolos dari semua jalur input: entri manual, impor Excel, maupun API. Sebagai pembanding, model Nomor Aset (snk.asset.number) sudah punya penjaga tersebut sejak awal (snk_asset_number.py:20-30).

Penyebab: Perlindungan keunikan diterapkan pada Nomor Aset, tidak pernah pada Nomor Inventaris.

Status: ✅ Ditutup di Rilis 1 — pemeriksaan keunikan kini berjalan di create() dan write().


Error 2: Counter tertinggal jauh di belakang data — penyebab utama

Format Nomor Inventaris adalah KODE-TAHUN_PEROLEHAN-URUT, contoh A-2023-1945. Bagian URUT diambil dari counter ir.sequence milik Jenis Aset, dipecah per tahun perolehan.

Ketika impor membawa kolom Nomor Inventaris yang sudah terisi, nomor itu ditulis apa adanya ke database — dan counter tidak ikut bergerak. Setelah beberapa kali impor, jaraknya menganga:

| Awalan | Nomor tertinggi terpakai | Posisi counter | Tertinggal |

|---|---|---|---|

| A-2023 | 5011 | 1958 | 3054 |

| D-2024 | 2906 | 706 | 2201 |

| A-2024 | 2518 | 716 | 1803 |

| M-2023 | 1782 | 13 | 1770 |

| D-2022 | 2139 | 828 | 1312 |

Begitu ada aset baru yang nomornya dibuat sistem, counter mengeluarkan A-2023-1958 — padahal nomor itu sudah dipakai aset lain sejak lama. Setiap penomoran otomatis berikutnya dijamin menghasilkan duplikat, dan akan terus begitu sampai counter menyusul.

Penyebab: Nomor yang masuk dari luar tidak pernah memajukan counter, sehingga counter kehilangan sinkronisasi dengan data sebenarnya.

Status: ✅ Ditutup di Rilis 1 — counter kini otomatis menyusul, baik saat menerima nomor dari impor maupun saat mendeteksi tabrakan.


Error 3: Impor ulang file yang sama menggandakan nomor

Seluruh 48 duplikat memiliki pola yang identik:


48 record dibuat 2026-09-01 (beberapa waktu, impor bertahap)

48 record dibuat 2026-09-02 02:17:27 ← seluruhnya pada detik yang sama

Timestamp yang persis sama pada batch kedua menunjukkan satu kali proses impor. Nomor-nomornya sudah ada di file, dan seluruhnya sudah terpakai sejak sehari sebelumnya.

Contoh satu pasangan:

| id | number | acquisition_date | dibuat |

|---|---|---|---|

| 1910389 | A-2023-1945 | 2023-11-17 | 2026-09-01 |

| 1920770 | A-2023-1945 | 2023-12-05 | 2026-09-02 |

Perilaku ini berasal dari snk_maintenance_equipment.py:296 (sebelum perbaikan):


if rec.number:

continue

Baris itu ditambahkan commit f9abbbd — "fix: nomor inventaris kosong saat import aset" (01 Agustus 2026) — untuk alasan yang benar: nomor dari file tidak boleh ditimpa. Efek sampingnya, nomor itu juga tidak pernah diperiksa.

Penyebab: Nomor eksplisit dari impor dipercaya penuh tanpa dibandingkan dengan data yang sudah ada.

Status: ✅ Ditutup di Rilis 1 — nomor dari file tetap dihormati, tetapi ditolak bila sudah terpakai.


Error 4: Pembentukan nomor tersebar di dua jalur

Nomor diisi di dua tempat terpisah: melalui @api.constrains saat create, dan lagi saat approval (snk_maintenance_equipment.py:836-838 sebelum perbaikan).

@api.constrains hanya tereksekusi bila field yang dipantau ikut dikirim dalam operasi tulis. Bila tidak, nomor tetap kosong dan baru terisi belakangan.

Penyebab: Pengisian nilai diletakkan di @api.constrains, yang secara desain Odoo adalah validator, bukan setter.

Status: ✅ Ditutup di Rilis 1 — pembentukan nomor dipindahkan ke create(), satu jalur.


Dugaan yang Gugur Setelah Data Diperiksa

Dua dugaan pada versi pertama dokumen ini tidak terbukti. Dicatat di sini agar tidak diselidiki ulang:

| Dugaan awal | Hasil pemeriksaan |

|---|---|

| Beberapa Jenis Aset berbagi satu Subklasifikasi tetapi memakai sequence berbeda, sehingga menghitung sendiri-sendiri | Tidak terjadi. Query pemeriksaan mengembalikan 0 baris — seluruh Jenis Aset di bawah satu Subklasifikasi sudah memakai sequence yang sama. Konfigurasi master data sudah benar. |

| Counter di-reset per tahun sementara tahun tidak muncul di nomor, sehingga nomor berulang antar tahun | Tidak terjadi. Tahun justru ada di dalam nomor (A-2023-1945), diambil dari %(year)s pada prefix sequence. Pemecahan counter per tahun memang disengaja dan sudah benar. |

Pelajarannya: kedua dugaan itu masuk akal secara pembacaan kode, tetapi konfigurasi master data yang sesungguhnya sudah benar sejak awal. Yang rusak adalah sinkronisasi antara counter dan data, bukan strukturnya.


Root Cause Summary

| # | Masalah | Penyebab | Status |

|---|---------|----------|--------|

| 1 | Nomor kembar lolos tanpa error | Tidak ada penjaga keunikan pada maintenance.equipment.number | ✅ Ditutup di Rilis 1 |

| 2 | Penomoran otomatis menabrak data lama | Nomor dari impor tidak memajukan counter → counter tertinggal ribuan angka | ✅ Ditutup di Rilis 1 |

| 3 | Impor ulang menggandakan nomor | Nomor eksplisit dari file diterima tanpa diperiksa | ✅ Ditutup di Rilis 1 |

| 4 | Waktu pengisian nomor tidak konsisten | Pengisian diletakkan di @api.constrains, bukan create() | ✅ Ditutup di Rilis 1 |

| 5 | Nomor kembar sudah terlanjur ada | Akibat nomor 1–3 di atas | ❌ Belum dibersihkan |


Perbaikan yang Sudah Dikerjakan (Rilis 1)

Berkas yang berubah: models/maintenance/snk_maintenance_equipment.py, i18n/id.po, __manifest__.py (versi 0.9 → 1.0).

  1. Pemeriksaan keunikan pada create() dan write() — mencakup nomor kembar di dalam satu file impor, nomor yang sudah terpakai aset lain, dan satu nomor yang dipasang ke banyak aset sekaligus. Pemeriksaan memakai sudo() karena keunikan berlaku global, sementara record rule membatasi pandangan user ke unitnya sendiri.

  2. Counter menyusul otomatis. Saat impor membawa nomor eksplisit, counter langsung dimajukan melewati nomor tertinggi yang terpakai — sehingga ketertinggalan tidak pernah terbentuk lagi. Bila tabrakan tetap terdeteksi, counter dimajukan sekali lompat, bukan dicoba satu per satu.

  3. Pembentukan nomor dipindahkan ke create(), keluar dari @api.constrains.

  4. Format nomor tidak berubah — KODE-TAHUN_PEROLEHAN-URUT dipertahankan persis. Tidak ada label fisik yang perlu dicetak ulang akibat Rilis 1.

Hasil pengujian di DB development

| Skenario uji | Hasil |

|---|---|

| Impor ulang nomor yang sudah terpakai | ditolak |

| Nomor kembar di dalam satu file impor | ditolak |

| Satu nomor dipasang ke banyak aset sekaligus | ditolak |

| Impor 30 aset lintas tahun tanpa nomor | seluruh nomor unik, 0 bentrok dengan data lama |

| Counter tertinggal 3054 angka, lalu ada impor bernomor | counter menyusul otomatis ke posisi benar |

Seluruh pengujian dijalankan dengan rollback — tidak ada data uji yang tersimpan.


Yang Belum Dikerjakan

Nomor kembar yang sudah terlanjur ada belum dibersihkan (48 nomor / 96 record di master3, 11 nomor / 40 record di Pre_Live, angka production belum diukur). Setelah Rilis 1: duplikat baru berhenti muncul, duplikat lama masih ada.

Dua langkah berikutnya, dan keduanya butuh keputusan:

Langkah A — Membersihkan data lama. Per nomor kembar, record tertua dipertahankan, satunya dinomori ulang. Alat sudah siap (SA-4 pada dokumen server action). Konsekuensi lapangan: setiap aset yang dinomori ulang berarti satu label fisik harus dicetak dan ditempel ulang — sekitar 48 label untuk master3 dan 29 untuk Pre_Live, dan angka production masih perlu diukur. Ini yang perlu masuk perencanaan tim lapangan.

Langkah B — Memasang kunci permanen di database. Unique index pada kolom nomor, agar duplikat tidak mungkin lagi terbentuk lewat jalur apa pun. Baru bisa dipasang setelah Langkah A selesai — selama masih ada duplikat, upgrade modul akan gagal karena index tidak dapat dibuat di atas data yang melanggar.

Satu pertanyaan yang perlu dijawab sebelum Langkah B: pada modul Dashboard Aset ada asumsi bahwa duplikat itu sah (controllers/maintenance/asset_dashboard.py:93-95):


# Metriknya adalah jumlah NOMOR INVENTARISASI unik, bukan jumlah

# record. Satu nomor inventarisasi bisa dipakai beberapa record dan itu

# tetap dihitung satu — read_group mengembalikan satu baris per nomor.

Mohon dikonfirmasi apakah memang ada kondisi bisnis di mana satu Nomor Inventaris sah dipakai beberapa record. Bila tidak ada, Langkah B bisa dijalankan sebagai unique penuh dan perhitungan dashboard ikut disesuaikan.


Rekomendasi Jangka Panjang

  • Nomor identitas wajib punya penjaga keunikan di level database. Validasi aplikasi saja tidak cukup — jalur impor dan API kerap melewatinya.

  • Setiap nomor yang masuk dari luar harus memajukan counter. Ini pelajaran utama dari kasus ini: counter yang tidak sinkron dengan data adalah bom waktu yang meledak diam-diam berbulan-bulan kemudian.

  • Impor perlu laporan pra-eksekusi — baris bermasalah ditampilkan sebelum data masuk, bukan sesudah.

  • Audit berkala. Server Action Audit & Perbaikan Duplikat Nomor Inventaris#SA-1 — Audit Duplikat Nomor Inventaris pada Server Action Audit & Perbaikan Duplikat Nomor Inventaris dapat dijalankan sewaktu-waktu untuk memastikan tidak ada duplikat baru yang lolos.

  • Analisis dari pembacaan kode wajib dikonfirmasi ke data sungguhan sebelum dijadikan dasar keputusan. Dua dugaan pertama pada kasus ini terdengar meyakinkan tetapi keliru.


Warning / Catatan Tambahan

  • Rilis 1 belum di-commit. Perubahan masih di working tree branch cj/easet.

  • Rilis 1 aman naik ke production kapan saja — tidak mengubah data, tidak mengubah format nomor, tidak memasang constraint yang bisa menggagalkan upgrade. Semakin cepat naik, semakin cepat duplikat baru berhenti bertambah.

  • Wajib restart service, bukan tombol Upgrade di UI. Perubahan Python tidak terbaca oleh proses Odoo yang sedang berjalan; menekan tombol Upgrade dari UI hanya memuat ulang XML dan berujung error. Untuk Docker: docker compose restart web.

  • Duplikat berdampak pada stock opname dan API mobile, keduanya memakai Nomor Inventaris sebagai kunci pencocokan. Selama duplikat lama masih ada, hasil scan berpotensi menunjuk record yang keliru.

  • Perbaikan manual melalui database production dilarang. Seluruh perubahan lewat kode yang di-commit, agar berjalan identik di semua server.