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

472 lines
15 KiB
Markdown
Raw Permalink Normal View History

---
proyek: e-Asset Patra Jasa
modul: pj_easset
kategori: Duplikat Nomor Inventaris
urutan-baca: 1 dari 3 — laporan
tanggal: 2026-09-04
branch: cj/easet
status: Workaround — sumber sudah ditutup, 48 nomor kembar belum dibersihkan
tags:
- 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|SA-1]] pada [[Server Action Audit & Perbaikan Duplikat Nomor Inventaris|dokumen server action]] 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`
```python
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):
```python
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`):
```python
# 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|SA-1]] pada [[Server Action Audit & Perbaikan Duplikat Nomor Inventaris|dokumen server action]] 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.