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.
|