909 lines
20 KiB
Markdown
909 lines
20 KiB
Markdown
---
|
||
proyek: e-Asset Patra Jasa
|
||
modul: pj_easset
|
||
kategori: Duplikat Nomor Inventaris
|
||
urutan-baca: 3 dari 3 — alat
|
||
tanggal: 2026-09-04
|
||
status: SA-1 siap pakai · SA-2 & SA-3 hasilnya AMAN · SA-4 menunggu keputusan cetak ulang label
|
||
tags:
|
||
- easset
|
||
- server-action
|
||
- runbook
|
||
- duplikat-nomor-inventaris
|
||
---
|
||
|
||
> Index: [[Easset — Index]] · Kasus: **Duplikat Nomor Inventaris** (3 dari 3 — alat)
|
||
> Laporan: [[Bug Report Duplikat Nomor Inventaris pada Data Aset]] ·
|
||
> Data hasil SA-1: [[Daftar Duplikat Nomor Inventaris — DB master3]]
|
||
|
||
**Tanggal dibuat:** 04 September 2026
|
||
|
||
**Project:** e-Asset Patra Jasa (`pj_easset`)
|
||
|
||
**Terkait:** [[Bug Report Duplikat Nomor Inventaris pada Data Aset]] (bug report) · [[Daftar Duplikat Nomor Inventaris — DB master3]] (data hasil SA-1)
|
||
|
||
**Status pemakaian:** SA-1 siap dipakai kapan saja · **SA-2 & SA-3 sudah dijalankan, hasilnya AMAN** · **SA-4 menunggu keputusan soal cetak ulang label**
|
||
|
||
|
||
|
||
> **Catatan 04 Sep 2026 (sesudah data diperiksa).** SA-2 dan SA-3 dibuat untuk membuktikan dua dugaan yang **ternyata tidak terbukti**: konfigurasi sequence per Jenis Aset sudah benar, dan pemecahan counter per tahun memang disengaja. Penyebab sebenarnya adalah **counter yang tertinggal jauh di belakang data** karena nomor dari impor tidak pernah memajukannya. Keduanya tetap berguna sebagai pemeriksaan berkala, tapi bukan lagi alat diagnosis utama untuk kasus ini. Prasyarat SA-4 soal "generator masih rusak" **sudah terpenuhi** — perbaikan generator sudah masuk di Rilis 1.
|
||
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
## Kegunaan Dokumen Ini
|
||
|
||
|
||
|
||
Kumpulan kode Server Action yang dijalankan **langsung dari UI Odoo**, tanpa akses psql maupun CLI ke server production. Dipakai untuk:
|
||
|
||
|
||
|
||
1. **Mendata** duplikat Nomor Inventaris yang sudah terlanjur ada (SA-1)
|
||
|
||
2. **Membuktikan** dugaan root cause pada konfigurasi master data (SA-2, SA-3)
|
||
|
||
3. **Membersihkan** duplikat setelah keputusan bisnis turun dan kode diperbaiki (SA-4)
|
||
|
||
|
||
|
||
Tiga yang pertama **read-only** — aman dijalankan di production kapan pun, termasuk saat jam kerja. Yang keempat **mengubah data** dan punya prasyarat ketat.
|
||
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
## Cara Membuat Server Action di UI
|
||
|
||
|
||
|
||
1. Aktifkan **Developer Mode**: **Pengaturan → Umum → Developer Tools → Activate the developer mode**
|
||
|
||
2. Buka **Pengaturan → Teknis → Tindakan → Tindakan Server** (*Settings → Technical → Actions → Server Actions*)
|
||
|
||
3. Klik **Baru**, lalu isi:
|
||
|
||
- **Nama Tindakan** — sesuai judul tiap SA di bawah
|
||
|
||
- **Model** — sesuai keterangan tiap SA
|
||
|
||
- **Jenis Tindakan** — **Jalankan Kode Python** (*Execute Python Code*)
|
||
|
||
4. Tempel kode ke kolom **Kode Python**
|
||
|
||
5. **Simpan**, lalu klik tombol **Jalankan** (*Run*) di kanan atas form
|
||
|
||
|
||
|
||
Untuk memunculkannya di menu roda gigi ⚙️ pada tampilan list, isi juga field **Available in the Actions menu** (`binding_model_id`) dengan model yang sama. Opsional — tombol **Jalankan** di form sudah cukup untuk pemakaian sesekali.
|
||
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
## Catatan Penting: Batasan Kode Server Action
|
||
|
||
|
||
|
||
Server Action dieksekusi lewat `safe_eval`, **bukan** Python biasa. Variabel yang tersedia hanya yang terdaftar di `odoo/addons/base/models/ir_actions.py:925-937`:
|
||
|
||
|
||
|
||
| Tersedia | Keterangan |
|
||
|
||
|---|---|
|
||
|
||
| `env` | Environment aktif |
|
||
|
||
| `model` | Model yang dipilih di field **Model** |
|
||
|
||
| `record` / `records` | Record aktif — `None` bila dijalankan dari tombol Run |
|
||
|
||
| `UserError` | Satu-satunya exception yang tersedia |
|
||
|
||
| `log(message, level)` | Menulis ke tabel `ir_logging` |
|
||
|
||
| `_logger` | Logger ke file log server |
|
||
|
||
| `datetime`, `time`, `dateutil`, `timezone` | Wrapper aman |
|
||
|
||
| `Command`, `float_compare`, `b64encode`, `b64decode` | Helper |
|
||
|
||
| `uid`, `user` | User yang menjalankan |
|
||
|
||
|
||
|
||
**Yang TIDAK tersedia** dan sering bikin error:
|
||
|
||
|
||
|
||
- ❌ `fields` — jadi `fields.Date.today()` **gagal**. Pakai `datetime.date.today()`
|
||
|
||
- ❌ `_` (fungsi terjemahan) — tulis string apa adanya
|
||
|
||
- ❌ `ValidationError`, `AccessError` — hanya `UserError` yang ada
|
||
|
||
- ❌ `import` apa pun
|
||
|
||
|
||
|
||
Cara menampilkan hasil ke layar: **`raise UserError("...")`**. Terdengar seperti error, tetapi inilah cara baku Odoo menampilkan teks laporan dari Server Action ke dialog UI. Karena `raise` membatalkan transaksi, ini justru **menjamin action read-only tidak meninggalkan perubahan apa pun**.
|
||
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
## SA-1 — Audit Duplikat Nomor Inventaris
|
||
|
||
|
||
|
||
> **Model:** `maintenance.equipment` (Peralatan / Aset)
|
||
|
||
> **Sifat:** 🟢 Read-only — aman dijalankan di production
|
||
|
||
> **Hasil:** membuka tampilan list berisi seluruh record yang nomornya kembar, sudah dikelompokkan per nomor
|
||
|
||
|
||
|
||
Menjawab pertanyaan: **berapa banyak duplikatnya, dan record mana saja?** Angka inilah yang menentukan besarnya pekerjaan pembersihan bila Opsi A yang dipilih PM.
|
||
|
||
|
||
|
||
```python
|
||
|
||
# Pengelompokan dijalankan di database lewat satu query read_group, bukan
|
||
|
||
# ditarik ke Python lalu dihitung manual. Pola ini sama dengan yang dipakai
|
||
|
||
# Dashboard Aset di controllers/maintenance/asset_dashboard.py:96.
|
||
|
||
#
|
||
|
||
# active_test=False supaya aset yang sudah diarsipkan ikut terhitung —
|
||
|
||
# duplikat tetap duplikat meski salah satu record sudah di-arsip.
|
||
|
||
groups = env['maintenance.equipment'].with_context(active_test=False).read_group(
|
||
|
||
domain=[('number', 'not in', [False, ''])],
|
||
|
||
fields=['number'],
|
||
|
||
groupby=['number'],
|
||
|
||
lazy=False,
|
||
|
||
)
|
||
|
||
|
||
|
||
duplicate_groups = [g for g in groups if g.get('__count', 0) > 1]
|
||
|
||
dup_numbers = [g['number'] for g in duplicate_groups]
|
||
|
||
|
||
|
||
if not dup_numbers:
|
||
|
||
raise UserError(
|
||
|
||
"HASIL AUDIT: BERSIH\n\n"
|
||
|
||
"Tidak ditemukan duplikat Nomor Inventaris.\n"
|
||
|
||
"Total nomor unik terdaftar: %s" % len(groups)
|
||
|
||
)
|
||
|
||
|
||
|
||
total_records = sum(g['__count'] for g in duplicate_groups)
|
||
|
||
worst = sorted(duplicate_groups, key=lambda g: g['__count'], reverse=True)[:10]
|
||
|
||
|
||
|
||
# Ringkasan ditulis ke ir_logging supaya ada jejak audit kapan dan oleh siapa
|
||
|
||
# pengecekan ini dijalankan.
|
||
|
||
log(
|
||
|
||
"Audit duplikat nomor inventaris: %s nomor kembar, %s record terdampak"
|
||
|
||
% (len(dup_numbers), total_records),
|
||
|
||
level="warning",
|
||
|
||
)
|
||
|
||
|
||
|
||
action = {
|
||
|
||
'type': 'ir.actions.act_window',
|
||
|
||
'name': 'Duplikat Nomor Inventaris — %s nomor / %s record' % (len(dup_numbers), total_records),
|
||
|
||
'res_model': 'maintenance.equipment',
|
||
|
||
'view_mode': 'list,form',
|
||
|
||
'domain': [('number', 'in', dup_numbers)],
|
||
|
||
'context': {'active_test': False, 'group_by': 'number'},
|
||
|
||
'target': 'current',
|
||
|
||
}
|
||
|
||
```
|
||
|
||
|
||
|
||
**Cara membaca hasilnya:** tampilan list terbuka dalam keadaan sudah ter-*group by* Nomor Inventaris. Setiap grup dengan jumlah lebih dari 1 adalah satu kasus duplikat. Judul jendela memuat totalnya.
|
||
|
||
|
||
|
||
Bila ingin ringkasan berupa teks saja tanpa membuka list, ganti blok `action = {...}` di atas dengan:
|
||
|
||
|
||
|
||
```python
|
||
|
||
lines = ['%s → %s record' % (g['number'], g['__count']) for g in worst]
|
||
|
||
raise UserError(
|
||
|
||
"HASIL AUDIT DUPLIKAT NOMOR INVENTARIS\n\n"
|
||
|
||
"Nomor kembar : %s\n"
|
||
|
||
"Record terdampak: %s\n\n"
|
||
|
||
"10 duplikat terbanyak:\n%s"
|
||
|
||
% (len(dup_numbers), total_records, "\n".join(lines))
|
||
|
||
)
|
||
|
||
```
|
||
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
## SA-2 — Audit Konfigurasi Jenis Aset vs Sequence
|
||
|
||
|
||
|
||
> **Model:** `maintenance.equipment.category` (Jenis Aset)
|
||
|
||
> **Sifat:** 🟢 Read-only — aman dijalankan di production
|
||
|
||
> **Hasil:** dialog berisi daftar Subklasifikasi yang berisiko menghasilkan nomor kembar
|
||
|
||
|
||
|
||
Ini **pembuktian otomatis atas Error 2** di bug report. Menggantikan Langkah Verifikasi 1–2 yang tadinya harus dikerjakan manual lewat *Group By*.
|
||
|
||
|
||
|
||
Yang dicari: Subklasifikasi yang dipakai oleh **lebih dari satu Jenis Aset**, dan Jenis Aset tersebut memakai **sequence yang berbeda-beda**. Kombinasi itulah yang dijamin menghasilkan nomor identik.
|
||
|
||
|
||
|
||
```python
|
||
|
||
rows = env['maintenance.equipment.category'].with_context(active_test=False).search_read(
|
||
|
||
domain=[('is_license', '=', False)],
|
||
|
||
fields=['name', 'maintenance_subclassification_id', 'sequence_id'],
|
||
|
||
)
|
||
|
||
|
||
|
||
# Pengelompokan pakai dict — bukan loop bersarang, dan tanpa query di dalamnya.
|
||
|
||
by_subclass = {}
|
||
|
||
for row in rows:
|
||
|
||
subclass = row['maintenance_subclassification_id']
|
||
|
||
if not subclass:
|
||
|
||
continue
|
||
|
||
entry = by_subclass.setdefault(subclass[0], {'name': subclass[1], 'categories': []})
|
||
|
||
entry['categories'].append(row)
|
||
|
||
|
||
|
||
risky = []
|
||
|
||
tanpa_sequence = []
|
||
|
||
jml_tanpa_sequence = 0
|
||
|
||
|
||
|
||
for subclass_id, entry in by_subclass.items():
|
||
|
||
categories = entry['categories']
|
||
|
||
|
||
|
||
# Jenis Aset TANPA sequence tidak pernah menghasilkan nomor sama sekali,
|
||
|
||
# jadi tidak mungkin menabrak siapa pun. Itu masalah lain — asetnya tidak
|
||
|
||
# dapat Nomor Inventaris — dan dilaporkan terpisah, bukan sebagai risiko
|
||
|
||
# duplikat. Menghitungnya sebagai "counter berbeda" hanya melahirkan
|
||
|
||
# peringatan palsu.
|
||
|
||
kosong = []
|
||
|
||
bersequence = []
|
||
|
||
for c in categories:
|
||
|
||
if c['sequence_id']:
|
||
|
||
bersequence.append(c)
|
||
|
||
else:
|
||
|
||
kosong.append(c['name'])
|
||
|
||
if kosong:
|
||
|
||
jml_tanpa_sequence += len(kosong)
|
||
|
||
tanpa_sequence.append('%s → %s' % (entry['name'], ", ".join(kosong)))
|
||
|
||
|
||
|
||
if len(bersequence) < 2:
|
||
|
||
continue
|
||
|
||
sequence_ids = set()
|
||
|
||
detail = []
|
||
|
||
for c in bersequence:
|
||
|
||
sequence_ids.add(c['sequence_id'][0])
|
||
|
||
detail.append(' - %s [sequence: %s]' % (c['name'], c['sequence_id'][1]))
|
||
|
||
if len(sequence_ids) < 2:
|
||
|
||
continue
|
||
|
||
risky.append('%s → %s Jenis Aset, %s sequence berbeda\n%s' % (
|
||
|
||
entry['name'], len(bersequence), len(sequence_ids), "\n".join(detail),
|
||
|
||
))
|
||
|
||
|
||
|
||
bagian = []
|
||
|
||
if risky:
|
||
|
||
bagian.append(
|
||
|
||
"RISIKO DUPLIKAT DITEMUKAN\n\n"
|
||
|
||
"%s Subklasifikasi di bawah ini dipakai oleh beberapa Jenis Aset dengan "
|
||
|
||
"sequence TERPISAH. Tiap sequence menghitung sendiri dari 1, sementara "
|
||
|
||
"prefix nomor hanya mengambil kode Subklasifikasi — sehingga nomor yang "
|
||
|
||
"dihasilkan dijamin kembar.\n\n%s" % (len(risky), "\n\n".join(risky))
|
||
|
||
)
|
||
|
||
else:
|
||
|
||
bagian.append(
|
||
|
||
"RISIKO DUPLIKAT: TIDAK ADA\n\n"
|
||
|
||
"Seluruh Jenis Aset di bawah satu Subklasifikasi memakai sequence yang "
|
||
|
||
"sama. Konfigurasi sudah benar."
|
||
|
||
)
|
||
|
||
|
||
|
||
if tanpa_sequence:
|
||
|
||
bagian.append(
|
||
|
||
"CATATAN TERPISAH — BUKAN RISIKO DUPLIKAT\n\n"
|
||
|
||
"%s Jenis Aset belum punya sequence. Aset di bawahnya tidak akan "
|
||
|
||
"mendapat Nomor Inventaris sama sekali (nomornya kosong), tetapi juga "
|
||
|
||
"tidak bisa menabrak nomor milik aset lain.\n\n%s"
|
||
|
||
% (jml_tanpa_sequence, "\n".join(tanpa_sequence))
|
||
|
||
)
|
||
|
||
|
||
|
||
raise UserError("\n\n".join(bagian))
|
||
|
||
```
|
||
|
||
|
||
|
||
**Cara membaca hasilnya:**
|
||
|
||
|
||
|
||
- **"AMAN"** → Error 2 gugur sebagai penyebab. Tersangka bergeser ke SA-3 atau ke jalur import.
|
||
|
||
- **"DITEMUKAN RISIKO"** → Error 2 terbukti. Daftar yang muncul adalah Subklasifikasi yang wajib dibereskan konfigurasinya, bukan sekadar datanya.
|
||
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
## SA-3 — Audit Date Range pada Sequence
|
||
|
||
|
||
|
||
> **Model:** `maintenance.equipment.category` (Jenis Aset)
|
||
|
||
> **Sifat:** 🟢 Read-only — aman dijalankan di production
|
||
|
||
> **Hasil:** dialog berisi daftar sequence yang counter-nya me-reset per rentang tanggal
|
||
|
||
|
||
|
||
Pembuktian **Error 3**. Sequence dengan **Use Date Range** aktif akan memulai hitungan dari 1 lagi di tiap rentang tanggal, padahal unsur tahun tidak pernah muncul di nomor akhir. Faktor ini bisa memicu duplikat **walaupun tiap Jenis Aset sudah punya Subklasifikasi sendiri**.
|
||
|
||
|
||
|
||
```python
|
||
|
||
rows = env['maintenance.equipment.category'].with_context(active_test=False).search_read(
|
||
|
||
domain=[('sequence_id', '!=', False), ('is_license', '=', False)],
|
||
|
||
fields=['name', 'sequence_id'],
|
||
|
||
)
|
||
|
||
|
||
|
||
if not rows:
|
||
|
||
raise UserError("Tidak ada Jenis Aset yang punya sequence. Periksa konfigurasi master data.")
|
||
|
||
|
||
|
||
sequence_ids = list({row['sequence_id'][0] for row in rows})
|
||
|
||
|
||
|
||
# ir.sequence perlu sudo() — user biasa umumnya tidak punya akses baca ke model
|
||
|
||
# teknis ini.
|
||
|
||
dated = env['ir.sequence'].sudo().search_read(
|
||
|
||
domain=[('id', 'in', sequence_ids), ('use_date_range', '=', True)],
|
||
|
||
fields=['name', 'prefix', 'padding'],
|
||
|
||
)
|
||
|
||
|
||
|
||
if not dated:
|
||
|
||
raise UserError(
|
||
|
||
"AMAN\n\n"
|
||
|
||
"Dari %s sequence yang dipakai Jenis Aset, tidak ada satu pun yang "
|
||
|
||
"mengaktifkan Use Date Range." % len(sequence_ids)
|
||
|
||
)
|
||
|
||
|
||
|
||
# Use Date Range HANYA berbahaya kalau tahun tidak ikut muncul di nomor akhir.
|
||
|
||
# Bila prefix memuat %(year)s atau %(range_year)s, counter yang me-reset tiap
|
||
|
||
# tahun justru BENAR dan disengaja: A-2023-0001 dan A-2024-0001 adalah dua
|
||
|
||
# nomor yang berbeda. Memvonis semua date range sebagai masalah hanya
|
||
|
||
# menghasilkan alarm palsu.
|
||
|
||
berisiko = []
|
||
|
||
aman = []
|
||
|
||
for d in dated:
|
||
|
||
prefix = d['prefix'] or ''
|
||
|
||
baris = '%s [prefix: %s]' % (d['name'], prefix or '(kosong)')
|
||
|
||
if '%(year)s' in prefix or '%(range_year)s' in prefix:
|
||
|
||
aman.append(baris)
|
||
|
||
else:
|
||
|
||
berisiko.append(baris)
|
||
|
||
|
||
|
||
if not berisiko:
|
||
|
||
raise UserError(
|
||
|
||
"AMAN\n\n"
|
||
|
||
"%s sequence memakai Use Date Range, dan SELURUHNYA memuat unsur tahun "
|
||
|
||
"pada prefix. Counter yang me-reset tiap tahun memang disengaja dan "
|
||
|
||
"tidak menghasilkan duplikat.\n\n%s" % (len(aman), "\n".join(aman))
|
||
|
||
)
|
||
|
||
|
||
|
||
raise UserError(
|
||
|
||
"RISIKO DUPLIKAT DITEMUKAN\n\n"
|
||
|
||
"%s sequence di bawah ini memakai Use Date Range TANPA unsur tahun pada "
|
||
|
||
"prefix. Counter me-reset tiap rentang tanggal sementara nomor akhirnya "
|
||
|
||
"tidak membedakan tahun, sehingga nomor yang sama terulang antar "
|
||
|
||
"periode.\n\n%s\n\nSequence yang sudah benar (tahun ikut di prefix): %s"
|
||
|
||
% (len(berisiko), "\n".join(berisiko), len(aman))
|
||
|
||
)
|
||
|
||
```
|
||
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
## SA-4 — Penomoran Ulang Duplikat
|
||
|
||
|
||
|
||
> **Model:** `maintenance.equipment` (Peralatan / Aset)
|
||
|
||
> **Sifat:** 🔴 **MENGUBAH DATA** — jangan dijalankan sebelum prasyarat terpenuhi
|
||
|
||
> **Hasil:** laporan pemetaan nomor lama → nomor baru
|
||
|
||
|
||
|
||
### ⛔ Prasyarat wajib — penuhi semuanya sebelum menjalankan
|
||
|
||
|
||
|
||
1. **PM sudah memutuskan Opsi A** (Nomor Inventaris wajib unik). Bila yang dipilih Opsi B, action ini **tidak relevan** dan tidak boleh dijalankan.
|
||
|
||
2. ~~**Akar masalahnya sudah diperbaiki lebih dulu di kode.**~~ ✅ **Sudah terpenuhi.** `_generate_equipment_number()` kini memeriksa tabrakan dan memajukan counter yang tertinggal sebelum mengembalikan nomor, jadi nomor pengganti yang dihasilkan SA-4 dijamin bebas bentrok. Sudah diuji: impor 30 aset lintas tahun menghasilkan 30 nomor unik tanpa satu pun bentrok dengan data lama.
|
||
|
||
3. **`pg_dump` database sudah diambil** dan sudah diverifikasi bisa di-restore.
|
||
|
||
4. **Dijalankan di staging lebih dulu** memakai salinan data production.
|
||
|
||
5. **Sudah dijalankan dalam mode `DRY_RUN = True`**, dan hasil pemetaannya sudah dibaca serta disetujui.
|
||
|
||
|
||
|
||
### Konsekuensi di lapangan
|
||
|
||
|
||
|
||
Nomor Inventaris tercetak pada QR barcode dan label fisik aset (`snk_maintenance_equipment.py:531-550`). Setiap nomor yang berubah **menuntut pencetakan dan penempelan ulang label di lapangan**. Laporan keluaran action ini adalah daftar kerja tim lapangan — simpan hasilnya.
|
||
|
||
|
||
|
||
### Kode
|
||
|
||
|
||
|
||
```python
|
||
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
|
||
# UBAH KE False HANYA SETELAH SELURUH PRASYARAT DI ATAS TERPENUHI
|
||
|
||
# dan hasil dry-run sudah diperiksa serta disetujui.
|
||
|
||
# ═══════════════════════════════════════════════════════════════════
|
||
|
||
DRY_RUN = True
|
||
|
||
|
||
|
||
Equipment = env['maintenance.equipment'].with_context(active_test=False)
|
||
|
||
|
||
|
||
groups = Equipment.read_group(
|
||
|
||
domain=[('number', 'not in', [False, ''])],
|
||
|
||
fields=['number'],
|
||
|
||
groupby=['number'],
|
||
|
||
lazy=False,
|
||
|
||
)
|
||
|
||
dup_numbers = [g['number'] for g in groups if g.get('__count', 0) > 1]
|
||
|
||
|
||
|
||
if not dup_numbers:
|
||
|
||
raise UserError("Tidak ada duplikat Nomor Inventaris. Tidak ada yang perlu dikerjakan.")
|
||
|
||
|
||
|
||
# order='number, id' memastikan record TERTUA (id terkecil) berada di urutan
|
||
|
||
# pertama tiap kelompok — record itulah yang nomornya dipertahankan.
|
||
|
||
duplicates = Equipment.search([('number', 'in', dup_numbers)], order='number, id')
|
||
|
||
|
||
|
||
by_number = {}
|
||
|
||
for rec in duplicates:
|
||
|
||
by_number.setdefault(rec.number, []).append(rec)
|
||
|
||
|
||
|
||
# Diratakan pakai extend, bukan loop bersarang: yang dipertahankan adalah
|
||
|
||
# elemen pertama, sisanya masuk antrean penomoran ulang.
|
||
|
||
to_renumber = []
|
||
|
||
for number, recs in by_number.items():
|
||
|
||
to_renumber.extend(recs[1:])
|
||
|
||
|
||
|
||
report = []
|
||
|
||
skipped = []
|
||
|
||
changed = 0
|
||
|
||
|
||
|
||
for rec in to_renumber:
|
||
|
||
old_number = rec.number
|
||
|
||
new_number = rec._generate_equipment_number()
|
||
|
||
if not new_number:
|
||
|
||
skipped.append('%s (id %s) — sequence Jenis Aset atau Subklasifikasi belum lengkap' % (old_number, rec.id))
|
||
|
||
continue
|
||
|
||
report.append('%s → %s [id %s] %s' % (old_number, new_number, rec.id, rec.display_name or ''))
|
||
|
||
if not DRY_RUN:
|
||
|
||
# write per record memang tidak bisa dijadikan bulk: tiap record
|
||
|
||
# menerima nilai yang BERBEDA, dan next_by_id() sendiri menulis ke
|
||
|
||
# ir.sequence tiap kali dipanggil.
|
||
|
||
# safe_eval memblokir STORE_ATTR, jadi `rec.number = x` DITOLAK di
|
||
|
||
# server action. Nilainya harus ditulis lewat write().
|
||
|
||
rec.with_context(skip_validation_check=True).write({'number': new_number})
|
||
|
||
# Barcode wajib dibuat ulang, isinya adalah nomor inventaris.
|
||
|
||
rec.generate_barcode()
|
||
|
||
changed += 1
|
||
|
||
|
||
|
||
if not DRY_RUN:
|
||
|
||
log("Penomoran ulang duplikat nomor inventaris: %s record diubah oleh %s" % (changed, user.name), level="warning")
|
||
|
||
|
||
|
||
header = "MODE UJI COBA (DRY RUN) — TIDAK ADA DATA YANG DIUBAH" if DRY_RUN else "DATA TELAH DIUBAH — %s record" % changed
|
||
|
||
body = "\n".join(report) if report else "(tidak ada)"
|
||
|
||
skip_body = ("\n\nDILEWATI (master data belum lengkap):\n" + "\n".join(skipped)) if skipped else ""
|
||
|
||
|
||
|
||
message = (
|
||
|
||
"%s\n\n"
|
||
|
||
"Nomor kembar : %s\n"
|
||
|
||
"Record dipertahankan: %s (tertua per nomor)\n"
|
||
|
||
"Record dinomori ulang: %s\n\n"
|
||
|
||
"PEMETAAN NOMOR LAMA → NOMOR BARU\n"
|
||
|
||
"(salin daftar ini — jadi acuan cetak ulang label di lapangan)\n\n%s%s"
|
||
|
||
% (header, len(dup_numbers), len(by_number), len(report), body, skip_body)
|
||
|
||
)
|
||
|
||
|
||
|
||
if DRY_RUN:
|
||
|
||
# raise membatalkan transaksi — inilah yang menjamin dry-run benar-benar
|
||
|
||
# tidak meninggalkan perubahan apa pun di database.
|
||
|
||
raise UserError(message)
|
||
|
||
|
||
|
||
raise UserError(message)
|
||
|
||
```
|
||
|
||
|
||
|
||
### Kenapa baris terakhir tetap `raise` walau bukan dry-run
|
||
|
||
|
||
|
||
`raise UserError` **membatalkan transaksi**, termasuk perubahan yang baru saja ditulis. Jadi pada kode di atas, versi `DRY_RUN = False` pun **belum benar-benar menyimpan** — ini disengaja sebagai lapisan pengaman terakhir.
|
||
|
||
|
||
|
||
Ketika benar-benar siap mengeksekusi, ganti dua baris penutup itu menjadi:
|
||
|
||
|
||
|
||
```python
|
||
|
||
action = {
|
||
|
||
'type': 'ir.actions.client',
|
||
|
||
'tag': 'display_notification',
|
||
|
||
'params': {
|
||
|
||
'title': 'Penomoran ulang selesai',
|
||
|
||
'message': '%s record telah dinomori ulang. Periksa log untuk pemetaan lengkap.' % changed,
|
||
|
||
'type': 'success',
|
||
|
||
'sticky': True,
|
||
|
||
},
|
||
|
||
}
|
||
|
||
```
|
||
|
||
|
||
|
||
Sebelum menggantinya, **simpan dulu keluaran dry-run** — pemetaan nomor lama → nomor baru tidak akan bisa direkonstruksi setelah data berubah.
|
||
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
## Urutan Pemakaian yang Disarankan
|
||
|
||
|
||
|
||
| Tahap | Action | Tujuan | Kapan |
|
||
|
||
|---|---|---|---|
|
||
|
||
| 1 | **SA-1** | Mengukur besaran duplikat | ✅ Sudah — hasilnya 48 nomor / 96 record |
|
||
|
||
| 2 | **SA-2** | Membuktikan Error 2 | ✅ Sudah — hasilnya AMAN, dugaan gugur |
|
||
|
||
| 3 | **SA-3** | Membuktikan Error 3 | ✅ Sudah — hasilnya AMAN, dugaan gugur |
|
||
|
||
| 4 | — | **Perbaikan generator + validasi impor** | ✅ Sudah — Rilis 1, teruji di DB dev |
|
||
|
||
| 5 | — | **Rilis 1 naik ke production** | Menunggu — aman kapan saja |
|
||
|
||
| 6 | **SA-4** dry-run | Menyusun rencana penomoran ulang | Setelah Rilis 1 naik, di staging |
|
||
|
||
| 7 | — | **Persetujuan cetak ulang 48 label** | Menunggu keputusan tim lapangan |
|
||
|
||
| 8 | **SA-4** eksekusi | Pembersihan data | Setelah dry-run disetujui + `pg_dump` diambil |
|
||
|
||
| 9 | — | **Unique index (Rilis 2)** | Setelah data bersih |
|
||
|
||
|
||
|
||
Tahap 1–3 tidak perlu menunggu siapa pun. Justru hasilnya yang membuat keputusan di tahap 4 punya dasar angka.
|
||
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
## Catatan Tambahan
|
||
|
||
|
||
|
||
- **Server Action bersifat sementara, bukan pengganti perbaikan kode.** SA-4 hanya membereskan data yang sudah rusak. Selama `_generate_equipment_number()` belum diperbaiki, duplikat baru akan terus bermunculan. Perbaikan permanen tetap harus masuk ke repository lengkap dengan migration script — naikkan `version` di `__manifest__.py`, buat `migrations/<version>/pre-migrate.py` yang idempotent.
|
||
|
||
- **Jangan menyimpan SA-4 dalam keadaan `DRY_RUN = False`.** Setelah selesai dipakai, kembalikan ke `True` atau hapus server action-nya, agar tidak ada yang menjalankannya tanpa sengaja lewat menu roda gigi.
|
||
|
||
- **SA-1 s/d SA-3 layak dijadwalkan berkala.** Setelah perbaikan naik ke production, jalankan SA-1 sesekali untuk memastikan tidak ada duplikat baru yang lolos.
|
||
|
||
- **Seluruh action di sini memakai ORM, bukan SQL mentah**, sehingga cache, hak akses, dan constraint Odoo tetap dihormati — sesuai standar yang berlaku di project ini. |