Doc_chelvyn/Easset Mac/Bug & Fixing/Easset — List Fixing.md

2125 lines
57 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

---
proyek: e-Asset Patra Jasa
modul: pj_easset
odoo: 18.0 Community
kategori: Bug & Fixing
periode: 2026-07-17 → 2026-09-17
status: Berjalan
tags:
- easset
- bug-fixing
- log
---
> Index: [[Easset — Index]] · Kategori: **Bug & Fixing**
>
> Log utama semua perbaikan `pj_easset`. Entri terbaru di atas.
> Dokumen mendalam untuk kasus tertentu: [[Easset — Print Barcode Margin Atas & Barcode Terpotong]] ·
> [[Asset — Submit, Filter Jenis Aset, dan Tombol Generate Barcode]] ·
> [[Bug Report Duplikat Nomor Inventaris pada Data Aset]]
## 2026-09-17 — Tombol Withdraw Approval Tetap Muncul di Aset yang Sudah Approved
**File:**
- `pj_easset/models/base/tier_definition.py`
- `pj_easset/models/maintenance/snk_maintenance_equipment.py`
- `pj_easset/views/base/tier_definition_view.xml`
- `pj_easset/i18n/id.po`
**Permintaan:** kalau di Tier Definition field **Can Restart Validation**
dicentang, tombol restart approval (label "Withdraw Approval") harus tetap
muncul walaupun aset sudah berstatus **Approved**.
**Penyebab:** ada tiga hal yang menutup jalurnya sekaligus.
1. `_compute_hide_restart_validation` hanya melihat review berstatus
`pending/waiting/rejected`. Aset approved semua review-nya `approved`,
jadi hasilnya selalu hidden.
2. Tombol di view masih ikut `hide_reviews`, yang selalu `True` begitu status
keluar dari `_state_from` (termasuk `approved`).
3. `restart_validation()` di `base_tier_validation` hanya menghapus review
kalau status masih di `_state_from` — kalaupun tombol muncul, review lama
tidak terhapus.
**Perbaikan:**
1. `_compute_hide_restart_validation`: kalau status di `_state_to`
(approved), tombol muncul selama model mengizinkan lewat hook baru
`_can_restart_after_approved()` **dan** ada tier definition di review
yang `can_restart_validation`-nya dicentang. Logika `hide_reviews`
(sembunyikan di cancel/done/dll) dipindah ke compute ini, jadi view
cukup `invisible="not review_ids or hide_restart_validation"`.
2. Hook `_can_restart_after_approved()` default `False`; hanya
`maintenance.equipment` yang `True`. Transaksi / opname / request tidak
ikut karena side effect saat done (relokasi, dispose, dsb) tidak boleh
diulang.
3. `restart_validation()` di equipment: aset approved dikembalikan ke
`draft` **sebelum** `super()` supaya review lama ikut ter-unlink. Kalau
tidak ada definition yang mengizinkan → `UserError` (jaga-jaga untuk
pemanggilan lewat API / shell).
4. `validate_tier()` equipment: transaksi **Registrasi** tidak dibuat ulang
kalau aset sudah punya (kasus restart lalu approve ulang). Dicek sekali
dengan satu `search` untuk seluruh recordset, bukan per record. Nomor
inventaris & barcode sudah ada guard sebelumnya; jadwal preventif sudah
dedup di wizard-nya.
**Diuji (`Pre_Live`, odoo shell, rollback):** aset approved dengan definition
`can_restart=True` → `hide_restart_validation=False` → restart → status draft,
review 0 → submit + approve ulang → approved, transaksi registrasi tetap 1.
Definition `can_restart=False` → tombol hidden dan `restart_validation()`
lempar UserError.
**Catatan:** endpoint `/api/asset/{number}/restart` masih menolak selain
status refused ("Only refused assets can be restarted") — tidak disentuh,
perlu keputusan tim apakah API mobile juga boleh restart dari approved.
**Deploy:** perubahan Python + XML, tidak ada perubahan struktur DB → tidak
perlu naik version manifest / migration. Jalankan `-u pj_easset` sekali
(template tombol berubah), lalu restart service Odoo.
---
## 2026-09-09 — Perizinan: Jenis Aset Terisi Otomatis dari Nomor Inventarisasi
**File:**
- `pj_easset/models/maintenance/snk_maintenance_permit.py`
- `pj_easset/views/maintenance/snk_maintenance_permit.xml` (komentar)
**Permintaan:** kalau Nomor Inventarisasi diisi lebih dulu, Jenis Aset ikut terisi
sesuai nomor tersebut — tidak harus mengisi Jenis Aset dulu.
**Sebelumnya:** 70dc0f2 menaikkan Jenis Aset ke atas Nomor Inventarisasi supaya
domain sudah membatasi sejak nomor mulai dipilih. Urutan sebaliknya tetap
diperbolehkan (domain Nomor Inventarisasi memang tidak membatasi apa pun selagi
Jenis Aset kosong), tapi Jenis Aset harus diisi manual dan barulah peringatan
muncul kalau ternyata tidak cocok.
**Perbaikan:** `_onchange_equipment_ids_asset_category` — begitu Nomor
Inventarisasi diisi selagi Jenis Aset masih kosong, Jenis Aset diambil dari nomor
pertama yang dipilih, sehingga domain langsung membatasi pilihan berikutnya.
Catatan implementasi:
- **Hanya mengisi yang kosong.** Jenis Aset yang sudah dipilih user tidak pernah
ditimpa; mengganti Jenis Aset ke jenis lain tetap memunculkan peringatan lama.
- **Dipisah dari onchange peringatan** yang memantau `equipment_ids` *dan*
`asset_category_id`. Kalau digabung, Jenis Aset yang baru dikosongkan user
langsung terisi lagi sehingga tidak bisa dikosongkan sama sekali.
- **Peringatan ikut dikeluarkan di method yang sama.** Odoo mengumpulkan onchange
per field lewat `inspect.getmembers` yang urutannya alfabetis
(`odoo/models.py:_onchange_methods`), jadi `_onchange_equipment_ids` bisa jalan
lebih dulu — saat Jenis Aset masih kosong dan belum ada yang bisa dibandingkan.
Dengan pengecekan ulang setelah pengisian, memilih beberapa nomor yang jenisnya
campur tetap langsung diperingatkan.
- `@api.constrains('equipment_ids', 'asset_category_id')` tidak diubah — tetap
jadi penjaga terakhir saat simpan, termasuk lewat API dan impor. Pengisian
otomatis sengaja hanya di onchange (jalur form), tidak di `create()`, supaya
perilaku API tidak berubah.
**Deploy:** perubahan Python → restart service Odoo (`-u pj_easset` kalau ingin
sekalian memuat ulang view). Tidak ada perubahan struktur DB.
---
## 2026-09-09 — Jenis Perizinan Ikut Muncul saat Memfilter Jenis Aset
**File:**
- `pj_easset/views/maintenance/snk_equipment_maintenance_view.xml`
- `pj_easset/models/maintenance/snk_maintenance_equipment.py`
- `pj_easset/models/maintenance/snk_maintenance_permit.py`
- `pj_easset/models/maintenance/snk_maintenance_permit_request.py`
- `pj_easset/static/src/js/domain_selector_category.js` (baru)
**Gejala:** memilih Jenis Aset menampilkan seluruh 1272 kategori — 15 Jenis
Perizinan (Nomor Induk Berusaha, SHGB, IMB, dst.) ikut jadi pilihan, padahal
perizinan disimpan di `snk.maintenance.permit` sehingga pilihan itu selalu
menghasilkan nol aset. Terjadi di dua tempat: kotak pencarian menu Aset dan
dialog **Tambahkan Penyaring Sendiri** (operator *di dalam* → daftar dropdown
maupun **Cari Lebih…**).
**Akar masalah — dua jalur berbeda:**
*a. Kotak pencarian.* `category_id` pada search view aset
(`maintenance.hr_equipment_view_search`) tidak punya domain. Search bar memakai
domain search view sebagai `args` `name_search`:
```js
// web/static/src/search/search_bar/search_bar.js:303-327
let domain = [];
if (searchItem.domain) { domain = new Domain(searchItem.domain).toList(context); }
const options = await this.orm.call(relation, "name_search", [], { args: domain, ... });
```
Perbaikan c6b351d memasang domain serupa di search view Perizinan, tapi search
view Aset belum ikut.
*b. Tambahkan Penyaring Sendiri.* Editor filter Odoo **sengaja** membuang domain
setiap field many2one, jadi domain search view maupun domain Python tidak pernah
sampai ke pemilih nilainya:
```js
// web/static/src/core/tree_editor/tree_editor_value_editors.js:81-89
function getDomain(fieldDef) {
if (fieldDef.type === "many2one") {
return [];
}
try { return new Domain(fieldDef.domain || []).toList(); } catch { return []; }
}
```
Field many2many tidak kena (baris `try` di atas tetap memakai domainnya) —
karena itu `category_ids` di Opname sudah tersaring sejak awal, sementara
`category_id` tidak.
**Perbaikan:**
1. `domain="[('is_license', '=', False)]"` pada `category_id` di search view aset
(lewat `position="attributes"`), sejalan dengan penyaringan Group By pada
cb5d0d0.
2. Domain dinaikkan ke definisi field Python supaya tiap model membawa batasannya
sendiri, bukan hanya di view:
- `maintenance.equipment.category_id` → `is_license = False`
- `snk.maintenance.permit.category_id` (Jenis Perizinan) → `is_license = True`
- `snk.maintenance.permit.asset_category_id` (Jenis Aset) → `is_license = False`
- `snk.maintenance.permit.request.asset_category_id` → `is_license = False`
(`category_id`-nya sudah punya domain sejak awal)
Domain di view tetap menang — `getFieldDomain`
(`web/static/src/model/relational_model/utils.js:313-326`) memakai domain view
lebih dulu dan definisi Python hanya cadangan — jadi cabang perizinan pada form
aset (`domain="[('is_license','=',True)]"`) tidak terpengaruh. Domain Python
juga tidak dipaksakan di sisi server, sehingga impor dan API tidak berubah.
3. Patch OWL `domain_selector_category.js`: `TreeEditor.getValueEditorInfo`
mengembalikan domain field ke editor filter, khusus field yang menunjuk
`maintenance.equipment.category` dan hanya untuk dua komponen yang memang
menerima prop `domain` (`DomainSelectorAutocomplete` dan
`DomainSelectorSingleAutocomplete`). Model lain tidak ikut berubah perilakunya.
**Sengaja dibiarkan:** `snk.maintenance.transaction.category_id` tidak diberi
domain karena transaksi melayani aset maupun perizinan (`is_license` per record),
jadi filternya memang harus bisa memilih keduanya.
**Deploy:** perubahan XML + Python (atribut field, bukan kolom) + asset JS baru →
`-u pj_easset` sekali lalu restart service; hard refresh browser
(Cmd/Ctrl+Shift+R). Tidak ada perubahan struktur DB, version manifest tidak perlu
naik.
---
## 2026-09-08 — Impor Transaksi: Nomor Transaksi & Data Aset Tidak Ikut Masuk
**File:**
- `pj_easset/models/maintenance/snk_maintenance_transaction.py`
- `pj_easset/views/maintenance/snk_maintenance_transaction.xml`
**Gejala:**
1. Kolom **Nomor Transaksi** tidak bisa dipetakan saat impor — Odoo selalu
menimpanya dengan nomor auto-generate.
2. Tab **Asset Information** kosong semua pada transaksi hasil impor.
3. Transaksi Perpindahan: **Golongan Aset, Klasifikasi, Subklasifikasi,
Aset Holder, User Person, User Ruangan** tidak terisi walaupun kolomnya
ada di file impor; khusus **Aset Holder** pilihannya memang tidak pernah
muncul di dropdown pemetaan kolom.
**Akar masalah:**
*a. Field `readonly=True` hilang dari daftar kolom impor.* `base_import`
melewati setiap field yang readonly di level Python:
```python
# odoo/addons/base_import/models/base_import.py:361
if field.get('readonly'):
continue
```
`name`, `group_id`, `classification_id`, `subclassification_id`, `unit_id`
(Aset Holder), `location_id` (User Ruangan), dan `dept_id` semuanya
`readonly=True` di definisi field, jadi tidak pernah tampil di dropdown
pemetaan — kolomnya ada di file, tapi tidak ada field tujuan yang bisa
dipilih. Field readonly lain di model yang sama (`owner_partner_id`,
`owner_partner_address`, `next_partner_id`, `next_partner_address`, `cost`,
`currency_id`) kena efek yang sama.
*b. Impor tidak menjalankan onchange.* Seluruh isi tab Asset Information
(dan data pemegang aset) di form diisi oleh `onchange_equipment`. Impor
memanggil `create()` langsung, onchange tidak pernah jalan → field-field
itu tetap kosong.
**Perbaikan:**
1. **Tidak ada lagi `readonly=True` di definisi field** pada model ini —
readonly seluruhnya dipasang di view (`readonly="1"` + `force_save="1"`).
Berlaku untuk 13 field: `name`, `group_id`, `classification_id`,
`subclassification_id`, `unit_id`, `location_id`, `dept_id`,
`owner_partner_id`, `owner_partner_address`, `next_partner_id`,
`next_partner_address`, `cost`, `currency_id`. Tampilan form tidak
berubah — field tetap tidak bisa diketik manual — tapi kolomnya kini
muncul di dropdown pemetaan impor.
Pola ini yang dipakai seterusnya: **readonly di view, bukan di backend.**
`readonly=True` di definisi field bukan cuma mengunci form, tapi ikut
mengunci impor, sedangkan `readonly="1"` di view hanya mengunci form.
2. `create()` mengisi snapshot data aset dari `equipment_id` lewat method
baru `_prepare_equipment_snapshot()` (kembaran `onchange_equipment`).
Yang diisi hanya field yang **tidak dikirim pemanggil** (`setdefault`),
jadi nilai dari file impor maupun dari form tidak pernah ditimpa.
Equipment di-browse sekali untuk seluruh batch (tanpa query per baris),
sekalian menghapus browse-di-dalam-loop pada logika `unit_id` lama.
3. Nomor transaksi: kalau file impor mengisi kolom Nomor, nomor itu dipakai
apa adanya; kalau kosong, sequence tetap jalan dan tahun/bulannya
mengikuti **Tanggal Transaksi** (`ir_sequence_date`, sudah ada sejak
commit `b8782ac`).
**Cara uji (UI):**
- Menu *Transaksi* → tombol **Impor** (⚙ / Favorites → Import records).
Pada layar pemetaan kolom, dropdown kini memuat *Nomor*, *Golongan Aset*,
*Klasifikasi Aset*, *Subklasifikasi Aset*, *Asset Holder*, *User Ruangan*,
*Departemen*.
- Impor 1 baris Perpindahan berisi Nomor Transaksi + Tanggal Transaksi +
Nomor Inventarisasi (equipment) saja → buka recordnya: Nomor sesuai file,
tab **Asset Information** terisi, dan Golongan/Klasifikasi/Subklasifikasi/
Aset Holder/User Person/User Ruangan ikut terisi dari data asetnya.
- Impor baris tanpa kolom Nomor → nomor auto-generate dengan tahun/bulan
mengikuti Tanggal Transaksi, bukan tanggal impor.
**Catatan:** transaksi yang **sudah terlanjur diimpor** tidak ikut terisi
mundur — perbaikan ini hanya berlaku saat record dibuat. Kalau data lama
perlu dibetulkan, impor ulang (atau hapus lalu impor ulang) batch tersebut.
**Deploy:** tidak ada perubahan struktur DB → tidak perlu migration/naik
version. Jalankan `-u pj_easset` (update view) lalu restart Odoo.
---
## 2026-08-05 — API Update Transaksi Gagal Gara-gara maintenance_task_checklist_ids
**File:**
- `pj_easset/controllers/asset_transaction/asset_transaction.py`
(`_validate_maintenance_checklist_payload` → `_drop_maintenance_checklist_if_unsupported`)
- `pj_easset/controllers/swagger.py` (deskripsi endpoint create & update)
**Gejala:** `PUT /api/asset-transaction/update/<id>` dari mobile balas
`400 "maintenance_task_checklist_ids can only be sent when type is maintenance"`
padahal field lain di payload valid.
**Akar masalah:** validasi lama menolak payload apa pun yang memuat key
`maintenance_task_checklist_ids` kalau tipenya bukan `maintenance`:
```python
if 'maintenance_task_checklist_ids' not in payload:
return
transaction_type = payload.get('type') or current_type
if transaction_type != 'maintenance':
raise ValueError(...)
```
Yang dinilai **keberadaan key**, bukan isinya — jadi kirim array kosong `[]`
pun tetap 400. Mobile membangun payload dengan mengirim seluruh field apa
adanya, sehingga key itu selalu ikut terkirim dan **setiap update transaksi
non-maintenance gagal total**, walaupun yang mau diubah cuma `description`.
**Perbaikan:** checklist Bill of Task memang cuma ada di transaksi Pemeliharaan
(di form Odoo pun notebook-nya `invisible` untuk tipe lain), jadi tidak ada
alasan menggagalkan seluruh request. Sekarang key-nya cukup di-`pop` dari
payload — hasilnya sama persis seperti kalau mobile tidak mengirimnya, field
lain tetap tersimpan. Berlaku untuk endpoint create maupun update.
Tipe yang dipakai tetap: `payload['type']` kalau dikirim, kalau tidak baru
jatuh ke tipe record yang tersimpan (`current_type`).
**Verifikasi di Pre_Live:**
| Kasus | Hasil |
|---|---|
| `type=relocation` + checklist | dibuang, key lain utuh |
| `type=maintenance` + checklist | dipertahankan |
| tanpa `type`, record `dispose` | dibuang |
| tanpa `type`, record `maintenance` | dipertahankan |
End-to-end `PUT /api/asset-transaction/update/9` (TRANS-2026-07-00009,
relocation, draft) dengan payload yang sebelumnya 400 → sekarang
`200 "Asset transaction updated successfully"`, `maintenance_task_checklist_ids`
tetap 0 baris (tidak ikut ditulis). `description` sengaja dikirim sama persis
dengan nilai lamanya supaya data Pre_Live tidak berubah.
**Deploy:** perubahan Python controller saja → restart service Odoo, tidak
perlu migration / naik version.
## 2026-08-05 — Transaksi Penghapusan Nomor Aset: Tab Asset Information Disembunyikan
**File:** `pj_easset/views/maintenance/snk_maintenance_transaction.xml`
(page `asset_information`)
**Path:** Aset > Transaksi, `type = dispose` + `type_dispose = asset_number`.
Pada Penghapusan Nomor Aset, penghapusan berlaku ke seluruh aset di bawah satu
Nomor Aset — tidak ada satu `equipment_id` yang jadi acuan. Field-field di form
utama (`equipment_id`, brand, kategori, dst.) sudah disembunyikan untuk kondisi
ini, tapi tab **Asset Information** masih tampil dan isinya kosong semua karena
sumber datanya `equipment_id` yang memang tidak diisi.
**Perbaikan:** tab ikut disembunyikan dengan kondisi yang sama persis seperti
yang sudah dipakai field-field lain di view ini:
```xml
<page name="asset_information" string="Asset Information"
invisible="type == 'dispose' and type_dispose == 'asset_number'">
```
**Deploy:** perubahan view saja → `-u pj_easset`, tidak perlu migration.
Sudah dites upgrade di Pre_Live, bersih tanpa error validasi view.
## 2026-08-05 — Dashboard Perizinan: Chart per Asset Holder Bukan Milik User Login
**File:**
- `pj_easset/models/maintenance/snk_maintenance_permit.py`
(method baru `get_permit_count_per_holder`)
- `pj_easset/static/src/js/permit_dashboard.js`
- `pj_easset/static/src/xml/permit_dashboard.xml` (empty state chart)
**Akar masalah:** chart "Total Perizinan per Asset Holder" mengagregasi
`snk.maintenance.permit` lewat tiga `readGroup` di sisi client **tanpa batasan
unit sama sekali** — holder yang muncul murni sisa hasil record rule. Selama
record rule benar hasilnya kebetulan benar; begitu ada user yang tidak masuk
grup maintenance mana pun (record rule tidak berlaku sama sekali untuknya),
chart langsung menampilkan seluruh holder di semua unit.
**Perbaikan:** agregasi dipindah ke server lewat `get_permit_count_per_holder`
(`@api.model`) yang bertitik tolak dari `self.env.user.unit_ids` — bukan dari
data permit. Satu `_read_group` (`unit_id`, `state`) menggantikan tiga
`readGroup` client, dan holder yang dikirim dijamin milik user login. Method
dipanggil tanpa `sudo()`, jadi record rule tetap berlaku di atas domain-nya.
Holder yang jumlah perizinannya 0 tidak dikirim ke chart (user HO seperti
`admin`/`risma` punya 22 unit — bar kosong semua bikin chart tidak terbaca).
Kalau tidak ada holder yang punya data, chart diganti teks "Belum ada
perizinan untuk Asset Holder Anda".
**Semua status ikut dihitung (atas permintaan user).** Semula chart hanya
menghitung status Aktif/Kadaluarsa/Lifetime, jadi di Pre_Live cuma muncul 2
bar (Patra Semarang 2, Patra Bali 1) — 411 dari 414 perizinan masih Non-Aktif
karena tombol **Aktifkan** belum ditekan. Sekarang status `inactive` ikut
masuk sebagai segmen **"Non-Aktif"** (abu-abu `#95a5a6`), sesuai judul chart
"**Total** Perizinan per Asset Holder".
Hasilnya total chart == jumlah record yang user lihat di menu Perizinan:
```
admin chart=414 record terlihat=414
patrasemarang-1 chart=14 record terlihat=14 (Patra Semarang 10 + Tanpa Aset Holder 4)
gmbali chart=16 record terlihat=16 (Patra Bali 12 + Tanpa Aset Holder 4)
```
**Chart gepeng — `flex: 1` menganulir `height`.** Setelah semua holder ikut
tampil (14 bar untuk admin), chart-nya berdesakan di ruang ±120px sampai label
holder di-skip Chart.js. Penyebabnya `.o_chart_container` di
`aset_dashboard.scss` punya `flex: 1` (= `flex-basis: 0%`); di dalam
`.o_aset_chart_card` yang flex-column dan tingginya ikut konten, basis 0 bikin
container kolaps — `height: 360px` dari `.o_chart_container_tall` **tidak
pernah terpakai**, dan inline `style="height:..."` pun ikut diabaikan.
Perbaikan: class baru `.o_permit_holder_chart` di `permit_dashboard.scss`
dengan `flex: 0 0 auto` + `min-height: 360px`, jadi kendali tinggi balik ke
`height`. Tingginya di-set dari JS: `max(360, jumlah_holder * 34 + 80)` px
(±34px per holder supaya bar setebal `maxBarThickness` 22px muat beserta
jaraknya). Untuk admin dengan 14 holder → 556px.
Class `.o_chart_container_tall` sengaja tidak diutak-atik karena dipakai juga
oleh Dashboard Aset (`chart_unit_asset`, `chart_disposal`) — perbaikannya
di-scope ke chart perizinan saja.
**Perizinan tanpa Aset Holder tetap dihitung.** Ada perizinan yang memang
by design tidak punya Aset Holder (di Pre_Live ada 4: id 1894 `SHMSRS 197/VI`,
1895 `3218`, 1896 `26`, 2040 `6575`), dan record rule permit memang sengaja
meloloskannya ke semua user lewat klausa `('unit_id','=',False)`. Record ini
masuk ke chart sebagai baris **"Tanpa Aset Holder"**, bukan dibuang.
> **Jangan diutak-atik:** klausa `('unit_id','=',False)` di
> `rule_permit_*_unit` (`security.xml`) itu **disengaja**, bukan bug. Sempat
> dikira bug karena login Patra Semarang menampilkan 14 record padahal
> unit-nya cuma punya 10 — 4 selisihnya persis perizinan tanpa Aset Holder
> tadi. Perilaku itu memang yang diinginkan. `security.xml` tidak diubah.
>
> Catatan lain: rule permit di `security.xml` memang terdefinisi dua kali
> dengan XML ID yang sama (blok "Record Rule Permit" di akhir file menimpa
> definisi di atasnya). Hasil akhirnya kebetulan sama-sama benar, tapi
> membingungkan saat dibaca — kandidat cleanup, bukan bug aktif.
**Verifikasi di Pre_Live** (`odoo shell`, simulasi aktivasi di-rollback):
```
patrasemarang-1 → [Patra Semarang 2, Tanpa Aset Holder 1]
gmbali → [Patra Bali 1]
admin (22 unit) → [Patra Bali 1, Patra Semarang 2]
```
**Catatan data:** 411 dari 414 perizinan di Pre_Live masih `is_active = false`
(Status "Non-Aktif") padahal `approval_status = approved`, sedangkan chart &
kartu dashboard hanya menghitung Aktif/Kadaluarsa/Lifetime. Jadi dashboard
akan terlihat sepi sampai perizinan diaktifkan. Kondisi data, bukan bug kode.
**Deploy:** tidak ada perubahan struktur DB → tidak perlu migration / naik
version. Restart service Odoo (perubahan Python) + `-u pj_easset` sekali atau
hard refresh browser (perubahan asset JS/XML).
---
## 2026-08-04 — API Dashboard: Angka Mobile Beda dengan Dashboard Odoo
**File:**
- `pj_easset/controllers/maintenance/asset_dashboard_domains.py` (baru)
- `pj_easset/controllers/maintenance/asset_dashboard.py`
- `pj_easset/controllers/maintenance/equipment_asset.py`
(method `_asset_dashboard_filter_domain`)
- `pj_easset/controllers/swagger.py`
**Akar masalah:** tiga commit perbaikan dashboard terakhir (`97b7385`,
`49cccb6`, `4a419a8`) hanya menyentuh dashboard OWL (`aset_dashboard.js`),
API `/api/asset-dashboard` tidak pernah ikut diperbarui sejak 17 Juli.
Jadi mobile masih memakai logika lama.
Lima divergensi yang bikin angkanya beda:
1. **Basis filter tanggal.** OWL pakai `create_date` (dengan konversi tengah
malam lokal → UTC), API masih pakai `acquisition_date`. Semua aset yang
`acquisition_date`-nya kosong (mayoritas data integrasi) hilang dari
hitungan API.
2. **Card Nomor Inventarisasi.** OWL menghitung nomor UNIK dan memfilter
`number not in [False, '']`; API menghitung jumlah record dengan
`number != False` — yang di Odoo jadi `IS NOT NULL`, sehingga aset dengan
`number` string kosong ikut terhitung.
3. **Card Nomor Aset.** OWL ambil dari master `snk.asset.number`, API ambil
dari equipment yang punya `asset_number_id`.
4. **Card Perizinan.** OWL filter `create_date` permit sendiri, API filter
`equipment_ids.acquisition_date` — permit tanpa equipment tidak terhitung
sama sekali.
5. **Chart Usulan Penghapusan.** OWL filter `create_date` transaksi dan grup
equipment ikut syarat `asset_number_id != False`; API filter
`equipment_id.acquisition_date` (usulan mode Penghapusan Nomor Aset yang
tanpa `equipment_id` hilang) dan grup equipment tanpa syarat nomor aset.
**Perbaikan:** domain bersama dipindah ke `asset_dashboard_domains.py`
(`HAS_INVENT_NUMBER` + `as_of_snapshot_domain`), dipakai oleh endpoint
dashboard maupun drill-down list, disamakan persis dengan OWL. Drill-down
`/api/asset-non-license/list` ikut pindah ke `create_date`; parameter bulan
diganti `created_month`/`created_year` (nama lama `acquisition_month`/
`acquisition_year` tetap diterima). Swagger sudah diperbarui.
**Catatan:** card Nomor Aset sekarang menghitung `snk.asset.number`, jadi
drill-down-nya diarahkan ke `/api/master/asset-number/list`. Endpoint master
itu belum mendukung `as_of_date`, sehingga jumlah listnya hanya persis sama
dengan angka card saat filter tanggal = hari ini.
**Deploy:** tidak ada perubahan struktur DB → tidak perlu migration / naik
version. Cukup restart service Odoo (perubahan Python saja).
---
## 2026-08-03 — Print Barcode: Margin Atas Tidak Konsisten & Barcode Terpotong
**File:** `pj_easset/controllers/maintenance/equipment_asset.py`
(method `get_equipment_barcode_multi_html`, endpoint
`/api/equipment/barcode_multi.html`)
Label barcode di-render sebagai HTML string di dalam controller (bukan
QWeb template). Hasil print punya margin atas yang berubah-ubah dan bagian
atas barcode ikut terpotong.
**Penyebab:** di blok `@media print`, `.barcode-img` dan `.asset-number`
pakai **negative margin** `-3mm` yang menarik konten keluar dari area cell,
sementara `.page-cell` pakai `vertical-align: top` + `padding-top` yang
nilainya beda antara CSS layar (`5mm`) dan CSS print (`2mm`). Jadi posisi di
preview ≠ posisi di kertas, dan tinggi barcode `24mm` + teks membuat total
konten melebihi label 33mm.
**Perbaikan (khusus vertikal — layout kiri-kanan sengaja tidak disentuh):**
negative margin dihapus, `.page-cell` diubah dari `vertical-align: top` +
`padding-top` menjadi `vertical-align: middle` + `padding: 0 0 2mm` (sama di
CSS layar maupun print), dan `.asset-number` diberi `line-height: 1.1`. Lebar
cell `53mm`, `text-align: center`, tinggi barcode (`22mm` layar / `24mm`
print), dan `.page` tetap seperti semula — jadi posisi horizontal barcode
tidak berubah sama sekali.
Sisa ruang (33mm − ±28mm konten) dibagi rata atas-bawah oleh browser →
margin atas konsisten di setiap label dan tidak ada yang terpotong.
`padding-bottom: 2mm` menaikkan konten **1mm** (naiknya selalu setengah dari
angka padding-bottom) sesuai permintaan "atasnya dinaikin sedikit".
**Catatan tersisa:** `.page` di blok print masih `width: 107mm !important`
padahal `@page` = `106mm`. Tidak berpengaruh ke margin atas (ini horizontal),
tapi kalau kolom kanan terlihat geser/terpotong, samakan jadi `106mm`.
**Deploy:** hanya controller Python, tidak ada perubahan struktur DB →
**tidak perlu** naik version manifest / migration. Cukup restart service Odoo.
📄 **Detail lengkap:** lihat [[Easset — Print Barcode Margin Atas & Barcode Terpotong]] (lokasi kode, cara
kerja perbaikan, tabel penyetelan `padding-bottom`, riwayat 3 versi method,
dan langkah tes via UI).
---
## 2026-08-01 — Transaksi Pemeliharaan: Status Transaksi, Jadwal, & Aktivitas Tidak Sinkron Jadi Done saat Approval
**File:**
- `pj_easset/models/maintenance/snk_maintenance_transaction.py`
- `pj_easset/models/maintenance/snk_maintenance_request.py`
- `pj_easset/models/base/tier_validation.py` (baru)
- `pj_easset/i18n/id.po`
Approval Transaksi Pemeliharaan (`type = maintenance`) tidak menutup Periode
Pemeliharaan (jadwal) yang ditunjuknya.
**Penyebab:** field `request_id` di form transaksi berdomain
`('state', 'not in', ['done','cancel','refused'])`, jadi jadwal yang dipilih
biasanya masih `draft`/`submit` dan review-nya masih menggantung. Saat
transaksi disetujui, `action_done()` memanggil `request_id.action_done()` yang
menulis `state = 'done'`. Di `maintenance.request`, `done` termasuk
`_state_to`, sehingga `base_tier_validation._tier_validation_check_state_on_write()`
ikut jalan dan melempar `ValidationError`:
- `"A validation process is still open for at least one record."` (jadwal
sudah punya review pending), atau
- `"This action needs to be validated ... Reviews pending"` (jadwal belum punya
review tapi kena tier definition).
`skip_validation_check` **tidak** menutup gerbang ini — context itu cuma dipakai
`_tier_validation_check_write_allowed`. Akibatnya seluruh transaksi approval
ikut rollback: transaksi, jadwal, dan aktivitasnya sama-sama tidak jadi Done.
**Perbaikan:**
1. `_close_pending_reviews()` ditambahkan sebagai method `tier.validation`
(`models/base/tier_validation.py`): review `waiting`/`pending` di-approve dan
`snk.tier.approval.request` terkait di-set `approve`. Dokumen yang ditutup
otomatis mengikuti dokumen lain jadi tidak nyangkut di kotak persetujuan.
2. `snk.maintenance.transaction.action_done()`: jadwal dikumpulkan dulu selama
loop lalu ditutup sekali untuk seluruh batch — `_close_pending_reviews()`
dulu, baru `action_done()` dengan context `skip_tier_state_check`. Aktivitas
transaksi sendiri (pengingat review) ikut di-`action_done()`.
3. `maintenance.request._check_state_conditions()` di-override: kalau context
`skip_tier_state_check` aktif, gerbang tier dilewati (review-nya memang sudah
ditutup lebih dulu).
4. `maintenance.request.action_done()` jadi bulk write (bukan per record) dan
`stage_id` hanya ditulis kalau stage Done memang ada — sebelumnya
`done_stage.id` bernilai `False` saat stage Done belum dikonfigurasi dan
malah mengosongkan stage jadwal.
5. Arah sebaliknya (approve jadwal → transaksi ikut Done) disamakan: review
transaksi ikut ditutup, dan `search` per jadwal + nested loop diganti satu
`search` untuk seluruh batch.
6. Sinkronisasi jadwal kembar (equipment + tanggal sama) di `write()`: dulu
`search` di dalam loop dan cuma menyamakan `stage_id` — sekarang satu
`search` untuk seluruh batch, dan kalau stage-nya Done maka `state`, review,
serta aktivitasnya ikut ditutup (sebelumnya stage Done tapi status masih
Waiting).
7. `UserError('Maintenance Request must be approved before done.')` dibungkus
`_()` + entri terjemahan ditambahkan ke `id.po`.
**Deploy:** perubahan Python murni, tidak ada perubahan struktur DB → tidak
perlu naik version manifest / migration. Perlu restart service Odoo karena ada
file model baru (`models/base/tier_validation.py`), lalu
`-u pj_easset --stop-after-init`.
**Belum diuji di DB** — verifikasi lewat pembacaan kode `base_tier_validation`
dan `snk_tier_validation`, belum dijalankan di `Pre_Live`.
---
## 2026-08-01 — Box Notifikasi Approval Lambat (± 3 detik tiap buka halaman)
**File:**
- `snk_tier_validation/models/tier_validation.py`
- `pj_easset/models/user/res_users.py`
Box notifikasi approval di systray memanggil `res.users.review_user_count()`
setiap halaman dimuat. Di DB `Pre_Live` panggilan itu makan **3,2 detik**
padahal cuma ada 5 approval pending.
**Penyebab:** domain `('rejected', '=', False)` dan `('can_review', '=', True)`
dipakai di `search()`. Keduanya field compute, dan `_search_rejected` bawaan
`base_tier_validation` melakukan:
```python
self.search([(self._state_field, 'in', self._state_from)]).filtered(lambda r: r.rejected)
```
Untuk `maintenance.equipment` itu = **38.660 record** di-`search` lalu
di-compute satu per satu di Python (`review_ids`, pesan HTML validated /
rejected). Diukur: `_search_rejected` 3,04 s, `_search_can_review` 3,08 s
(yang ini ikut memanggil `_search_rejected` lagi lewat leaf `rejected`).
Diperparah `review_user_count` versi kita yang `_read_group` per
`definition_id`, bukan per `model` seperti versi upstream — satu model bisa
punya 18–23 tier definition, jadi scan 38k record itu berulang sebanyak
jumlah definition yang punya review pending.
**Perbaikan:**
1. Override `_search_rejected` di `snk_tier_validation`. Record disebut
rejected kalau punya `tier.review` berstatus `rejected`, jadi kandidat
diambil langsung dari `tier.review` (indexed di `model` + `status`) —
bukan scan tabel utama. Hasilnya diverifikasi identik dengan implementasi
lama di 5 model tier-validated (`maintenance.equipment`,
`snk.maintenance.transaction`, `maintenance.request`,
`snk.maintenance.opname`, `snk.maintenance.permit.request`).
2. `review_user_count` ditulis ulang: sekali query `tier.review`, resolve
record **sekali per model** (bukan per definition), lalu `rejected` /
`can_review` dievaluasi pakai `filtered()` di kandidat yang sudah kecil.
Grouping per definition tetap dipertahankan. `print()` debug dihapus.
**Hasil ukur (`Pre_Live`, user Administrator, output tetap sama persis):**
| | Sebelum | Sesudah |
|---|---|---|
| `review_user_count()` | 3,2 s | 0,008 s |
| `_search_rejected` (equipment) | 3,04 s | 0,001 s |
| `search_count([('can_review','=',True)])` (domain yang dipakai saat box diklik) | ± 3 s | 0,005 s |
**Catatan:** `_search_validated` di `base_tier_validation` punya pola sama
(full scan `_state_from` + `filtered`). Tidak ikut diperbaiki karena bukan
jalur box notifikasi, tapi akan menimbulkan stall serupa kalau dipakai di
filter/domain view.
**Deploy:** perubahan Python murni, tidak ada perubahan struktur DB →
tidak perlu naik version manifest / migration. Cukup restart service Odoo.
---
## 2026-07-27 — Geo Tagging Aset Ketimpa Lokasi Orang yang Buka Form (commit `086096e`)
**Aset yang dibuat dari mobile di lokasi A berubah jadi lokasi B begitu form-nya dibuka di Odoo web.** Contoh kasus: aset dibuat di Rawa Buntu, lalu dibuka pakai akun yang sama dari Serpong — `geo_tag` jadi Serpong.
Penyebabnya dua hal yang saling menutupi:
1. Widget `geo_location` (`static/src/js/permit_geolocation.js`) menembak `navigator.geolocation` **setiap form di-mount** selama field masih kosong, tanpa membedakan record baru atau lama. Jadi bukan "membaca geo lama", tapi **menimpa** dengan posisi orang yang sedang membuka form.
2. `POST /api/asset/create` sebenarnya sudah menerima `geo_tag`, tapi **tidak terdokumentasi di swagger** sehingga tim mobile tidak pernah mengirimnya → field kosong → jadi sasaran empuk poin 1.
Perbaikan:
- **Widget**: auto-capture hanya untuk record baru yang belum tersimpan (`record.isNew`). Record tersimpan tidak pernah ditimpa; tombol map-marker manual tetap ada untuk isi ulang yang disengaja. Widget ini dipakai juga di form Perizinan, Permohonan Perizinan, dan Master Lokasi — ketiganya ikut aman.
- **`/api/asset/create`**: terima alias `geolocation` / `geo_location` / `geo_tagging`, dan pasangan `latitude` + `longitude` (dirakit jadi `"lat,long"`). Fallback terakhir `location_id.geo_tag`, karena onchange `location_id` tidak jalan lewat API.
- **Swagger**: `geo_tag`, `latitude`, `longitude` didokumentasikan di create asset, plus catatan bahwa nilai ini dikunci saat create.
Urutan pengisian `geo_tag` saat create: `geo_tag`/alias → `latitude`+`longitude` → `location_id.geo_tag` → kosong.
⚠️ Konsep yang perlu dipegang: **server tidak bisa tahu posisi fisik penginput** (request HTTP tidak membawa GPS; IP address terlalu meleset untuk geo tagging aset). Geo tagging harus direkam device di titik kejadian — mobile wajib ambil GPS saat tombol Simpan ditekan, bukan saat form dibuka, dan jangan pakai `getLastKnownLocation` yang bisa mengembalikan posisi basi.
Catatan lain: `geo_tag` bertipe `Char` dan menyimpan apa adanya, jadi isinya bisa campur — record dari web berisi teks alamat (hasil reverse geocode Nominatim di JS), record dari API berisi koordinat mentah. Belum diseragamkan. Aset lama yang sudah terlanjur ketimpa tidak terkoreksi otomatis; perbaikannya lewat `PUT /api/asset/{number}/update`.
File yang diubah:
- `pj_easset/static/src/js/permit_geolocation.js`
- `pj_easset/controllers/maintenance/equipment_asset.py`
- `pj_easset/controllers/swagger.py`
Catatan deploy: tidak ada perubahan field/model → **tidak perlu naik version manifest / migration**. Ada perubahan JS asset: jalankan `-u pj_easset` sekali lalu hard refresh (Cmd/Ctrl+Shift+R). Widget hanya jalan di HTTPS/localhost — di HTTP polos `navigator.geolocation` selalu ditolak browser.
Cara tes cepat: DevTools → Sensors → Location "Other…" isi `-6.315933, 106.689623` → buat aset baru (geo terisi) → ganti Sensors ke koordinat lain → buka lagi aset tadi → nilainya harus tetap.
## 2026-07-20 — Seragamkan Response API: Field Kosong → `null` (commit `1ceb953`)
**Semua field kosong di response API sekarang dibalikin `null`** — sebelumnya campur: field char/selection/date kosong bocor sebagai `false` (perilaku default Odoo saat field kosong dibaca di Python), sebagian lain dibalikin string kosong `""`. Field bertipe boolean tetap `true`/`false`.
- Pola perbaikan: `rec.field` → `rec.field or None` dan `... if rec.x else ""` → `else None` di semua serializer/response dict.
- Yang **tidak** diubah (sengaja): parsing input query/payload (mis. `(kwargs.get(...) or '').strip()`), helper upload yang membuat attachment (nama record), dan vals untuk `create()`/`write()` (Odoo butuh `False` untuk mengosongkan field).
- ⚠️ Breaking change ringan untuk frontend: cek `=== ""` / `=== false` pada field kosong harus diganti cek `null`.
Swagger ikut disesuaikan: contoh response yang menampilkan `""` untuk field kosong (`type_dispose`, `warranty_date`, `partner_id`, `license_status`, dll.) diganti `null`. Contoh **request payload** create/update tetap memakai `False` (konvensi Odoo untuk mengosongkan field saat write).
File yang diubah (356 baris konversi, 9 file + swagger):
- `pj_easset/controllers/swagger.py` (contoh response)
- `pj_easset/controllers/asset_transaction/asset_transaction.py`
- `pj_easset/controllers/auth_user/auth_user.py` (termasuk `/api/partners/list`: email/mobile/phone/alamat, `user_id`/`user_name` hasil search kosong)
- `pj_easset/controllers/maintenance/equipment_asset.py` (termasuk response approve: `approval_status`, `condition`)
- `pj_easset/controllers/maintenance/maintenance_permit.py` (termasuk `_binary_value` & `_attachment_url`: attachment kosong → `null`)
- `pj_easset/controllers/maintenance/maintenance_permit_request.py`
- `pj_easset/controllers/maintenance/maintenance_request.py`
- `pj_easset/controllers/maintenance/maintenance_transaction.py`
- `pj_easset/controllers/product/product.py`
- `pj_easset/controllers/uom/uom.py`
Catatan deploy: hanya controller — cukup restart Odoo, tanpa `-u pj_easset`.
## 2026-07-19 — Fix AccessError List Opname untuk Role Non-Manager (commit `b01cc21`)
**`GET /api/maintenance-opname/list` error 500 untuk role tertentu** — record rule `maintenance.equipment` (unit/follow) memblokir pembacaan nama/nomor equipment di luar unit user saat serialisasi list. Fix: baca equipment line pakai `sudo()` sempit (`opname.line_ids.sudo().mapped('equipment_id')`) — search opname tetap pakai hak akses user login.
File yang diubah: `pj_easset/controllers/maintenance/maintenance_opname.py`
Catatan deploy: hanya controller — cukup restart Odoo.
## 2026-07-19 — Pagination + Nested Object di API Jadwal Pemeliharaan (commit `e841d96`)
**`GET /api/maintenance-request/calendar`**:
- Pagination: param `page` (default 1) & `limit` (default 10) + blok `meta` (`total`, `page`, `limit`, `total_pages`) — pola sama dengan `/api/asset-license-change-request/list`.
- Field relasi jadi nested object: `equipment_id`/`asset_number_id`/`technician_id` → `{id, name}`, `stage_id` → `{id, name, done}` (field flat `*_name`, `is_stage_done` dihapus).
- ⚠️ Breaking change untuk konsumer yang membaca field flat lama; tanpa param, response kini maksimal 10 baris.
File yang diubah:
- `pj_easset/controllers/maintenance/maintenance_request.py`
- `pj_easset/controllers/swagger.py`
Catatan deploy: hanya controller/swagger — cukup restart Odoo.
## 2026-07-17 — Riwayat Perubahan Data di Detail Asset License (commit `1d460e1`)
**Section baru `change_request_history` pada response `GET /api/asset-license/detail/{id_or_number}`** — menampilkan Riwayat Perubahan Data: daftar permintaan perubahan data (model `snk.maintenance.permit.request`, relasi `permit_request_ids`) yang terkait record perizinan tersebut, urut `name desc` (terbaru dulu):
- Field per record: `id`, `name`, `type_id` (Tipe Permintaan), `permit_id`, `published_date`, `expired_date`, `partner_id` (Penerbit), `equipment_ids` (id/number/name), `unit_id` (Aset Holder), `location_id`, `approval_status`.
- Field relasional dikirim sebagai object `{id, name}`, konsisten dengan field lain di response detail.
- Section ini ikut muncul di response endpoint lain yang memakai serializer detail yang sama (`activate`, `deactivate`, `create`, `update`) — perubahan aditif, tidak mengubah field yang sudah ada.
- Swagger: deskripsi + contoh `change_request_history` di path `/api/asset-license/detail/{id_or_number}`.
File yang diubah:
- `pj_easset/controllers/maintenance/maintenance_permit.py`
- `pj_easset/controllers/swagger.py`
Catatan deploy: hanya controller/swagger — cukup restart Odoo, tanpa `-u pj_easset`.
## 2026-07-17 — Dashboard Aset Drill-Down / Bisa Diklik (commit `79a6759`)
**Card & chart `/api/asset-dashboard` sekarang bisa diklik** — frontend tinggal meneruskan `list_params` yang disediakan dashboard ke endpoint list aset:
- `GET /api/asset-non-license/list` — parameter filter baru (semua opsional, bisa digabung + pagination, param invalid → 400):
- `dashboard_card` (`invent` / `asset`) — drill-down card Nomor Inventarisasi / Nomor Aset
- `as_of_date` (YYYY-MM-DD) — snapshot kumulatif `acquisition_date`, sama dengan filter dashboard
- `active` (`true` / `false`) — chart inventaris Aktif vs Arsip
- `condition` (`active/inactive/broken/dispose`) — chart kondisi aset
- `unit_id` — chart per asset holder
- `acquisition_month` (1–12) + `acquisition_year` (default tahun `as_of_date`) — chart per bulan
- Domain identik dengan perhitungan dashboard → jumlah list = angka yang diklik.
- `GET /api/asset-dashboard` — tiap card dan item chart berbasis aset (`cards`, `charts.inventaris`, `charts.condition`, `charts.unit_asset`, `charts.month.items` baru per bulan) menyertakan `list_endpoint` + `list_params` siap pakai. Card permit → `/api/asset-license/list`.
- Catatan: list punya filter dasar `is_license = False` sedangkan dashboard menghitung semua equipment — jika ada equipment license, jumlah list bisa sedikit lebih kecil dari card. Chart `disposal`/`opname`/`maintenance` belum diberi `list_params` (modelnya bukan list aset).
- Swagger: parameter baru di `/api/asset-non-license/list` + contoh `list_params` di `/api/asset-dashboard`.
File yang diubah:
- `pj_easset/controllers/maintenance/equipment_asset.py`
- `pj_easset/controllers/maintenance/asset_dashboard.py`
- `pj_easset/controllers/swagger.py`
Catatan deploy: hanya controller/swagger — cukup restart Odoo, tanpa `-u pj_easset`.
## 2026-07-17 — API Jadwal Pemeliharaan Aset (commit `07c1f75`)
**Endpoint baru `GET /api/maintenance-request/calendar`** — list jadwal pemeliharaan aset dari menu Pemeliharaan Aset > Tanggal Pemeliharaan Aset (model `maintenance.request`, calendar view `equipment.request.calendar`), auth `Api-Key` header, urut `schedule_date ASC`:
- Query param opsional: `date_from` / `date_to` (YYYY-MM-DD, rentang `schedule_date`), `technician_id` (field `user_id` — Teknisi), `equipment_id` (alias `asset_id`), `state`.
- `state` menerima: `todo` (stage belum done — filter "Todo" di UI), `active` (`archive = False` — filter "Aktif" di UI), atau nilai field state (`draft/submit/approved/refused/done/cancel`).
- Response per record: id, name, `schedule_date` + `schedule_date_end` (schedule_date + duration jam) + `duration`, equipment + asset number (id/nama), technician (id/nama), `state`, stage (id/nama/`is_stage_done`), `archive`, `maintenance_type`, `priority`.
- Validasi param salah → 400 dengan pesan jelas.
- Swagger: path `/api/maintenance-request/calendar` + tag baru "Maintenance Schedule" di `controllers/swagger.py`.
File yang diubah:
- `pj_easset/controllers/maintenance/maintenance_request.py`
- `pj_easset/controllers/swagger.py`
Catatan deploy: hanya controller/swagger — cukup restart Odoo, tanpa `-u pj_easset`.
## 2026-07-17 — Fix unit_id kosong di Penghapusan Nomor Aset (commit `4fca089`)
**Bug:** create Transaksi Aset mode Penghapusan Nomor Aset ditolak record rule `Transaction - Maintenance Manager (Unit)` ("tidak memiliki akses 'buat'"), termasuk untuk Administrator dengan role Manager Peralatan.
**Penyebab:** saat memilih tipe Penghapusan Nomor Aset, `equipment_id` dikosongkan → `onchange_equipment` ikut menyapu `unit_id` jadi kosong → domain rule per-unit (`unit_id` / `next_unit_id` harus termasuk unit user) gagal di kedua sisi.
**Fix** di `pj_easset/models/maintenance/snk_maintenance_transaction.py`:
- `onchange_equipment`: `unit_id` fallback ke unit user saat equipment kosong.
- `create()`: jaring pengaman — kalau `unit_id` tetap kosong (termasuk create via API), otomatis diisi unit pertama user.
**Catatan:** user tetap wajib punya minimal satu Unit (field `unit_ids` di form user); kalau kosong, rule tetap menolak (konfigurasi data, bukan kode).
Catatan deploy: perubahan Python saja — cukup restart Odoo, tanpa `-u pj_easset`.
## 2026-07-17 — API Dashboard Aset (commit `8cd4216`)
**Endpoint baru `GET /api/asset-dashboard`** — replikasi Dashboard Aset OWL (`static/src/js/aset_dashboard.js`) ke REST API, mengikuti pola `/api/permit-dashboard` (butuh `Api-Key` + session login via `require_api_session`):
- Query param `as_of_date` (default hari ini) — snapshot kumulatif berdasarkan `acquisition_date`, dan `opname_year` (default tahun `as_of_date`) — filter lokal chart Ratio Opname, independen dari filter global.
- Response `data.filters`: echo `as_of_date`, `opname_year`, plus `opname_years` (daftar tahun dropdown, dari opname paling awal s/d tahun berjalan).
- Response `data.cards`: Nomor Inventarisasi, Nomor Aset, Perizinan — count + percent + model + domain.
- Response `data.charts`:
- `inventaris` — aktif vs arsip
- `disposal` — usulan penghapusan (transaksi dispose) per unit: nomor aset unik + nomor inventarisasi unik (`read_group lazy=False`, tanpa nested loop)
- `month` — total nomor inventarisasi per bulan pada tahun `as_of_date`
- `condition` — Active / Inactive / Broken / Disposed
- `opname` — status opname **hari ini** (Submit/Done/Rejected; sengaja tidak ikut filter tanggal, sama seperti OWL)
- `opname_coverage` — ratio sudah/belum opname kumulatif s/d 31 Des `opname_year`
- `maintenance` — maintenance.request per stage (Scheduling/Check/Done)
- `unit_asset` — nomor inventarisasi per asset holder, terurut terbanyak
- Beda kecil dari OWL: top-N + "Lainnya" tidak dilakukan server — API kembalikan daftar lengkap terurut, konsumen yang memotong.
- Swagger: path `/api/asset-dashboard` + tag baru "Asset Dashboard" di `controllers/swagger.py`.
File yang diubah:
- `pj_easset/controllers/maintenance/asset_dashboard.py` **(baru)**
- `pj_easset/controllers/maintenance/__init__.py`
- `pj_easset/controllers/swagger.py`
Catatan deploy: hanya controller/swagger — cukup restart Odoo, tanpa `-u pj_easset`.
## 2026-07-17 — API Tipe Penghapusan Aset (commit `1dfcf84`)
**Fixing endpoint asset-transaction untuk fitur Tipe Penghapusan** (lanjutan commit `b4ccd35`):
- `POST /api/asset-transaction/create` & `PUT /api/asset-transaction/update/{transaction_id}`: payload menerima `type_dispose` (`asset_number` / `inventory_number`) dan `asset_number_id`. Validasi `asset_number_id` wajib saat `type_dispose=asset_number` ditangani constraint model → API balas 400. `equipment_id` tidak wajib di mode nomor aset. *(sudah ter-cover sejak commit `b4ccd35`)*
- `GET /api/asset-transaction/detail/{transaction_id}`: response menyertakan `type_dispose` dan `asset_number_id` / objek `asset_number`. *(sudah ter-cover sejak commit `b4ccd35`)*
- `GET /api/asset-transaction/table`: response kini menyertakan `type_dispose`. **(baru)**
- `GET /api/asset-transaction/master/selections`: kini menyertakan opsi `type_dispose` (Penghapusan Nomor Aset / Penghapusan Nomor Inventarisasi). **(baru)**
- Endpoint baru `GET /api/asset-transaction/master/asset-numbers`: lookup Nomor Aset dari `snk.asset.number` (field `name`), filter `active=True`, support param `keyword`, format `{id, name}`. **(baru)**
- `POST /api/asset-transaction/approve/{transaction_id}`: tanpa perubahan controller — memanggil `validate_tier()` → `action_done()` model, jadi logika "Done → semua aset HBM dengan nomor aset sama otomatis Dispose" sudah berlaku.
- Semua perubahan didokumentasikan di swagger (`controllers/swagger.py`).
File yang diubah:
- `pj_easset/controllers/asset_transaction/asset_transaction.py`
- `pj_easset/controllers/swagger.py`
Catatan deploy: hanya controller/swagger — cukup restart Odoo, tanpa `-u pj_easset`.
## 2026-07-17 — Tipe Penghapusan Aset (commit `b4ccd35`)
**Fixing Transaksi Penghapusan Aset** — form Transaksi Aset jenis Penghapusan:
- Field baru `type_dispose` (Tipe Penghapusan) di `snk.maintenance.transaction`, muncul & wajib saat tipe transaksi = Penghapusan. Pilihan: Penghapusan Nomor Aset / Penghapusan Nomor Inventarisasi.
- Mode **Penghapusan Nomor Aset**:
- Field `asset_number_id` (Nomor Aset, lookup ke `snk.asset.number`) tampil editable & wajib, posisi di atas Nomor Inventarisasi.
- Field `equipment_id` (Nomor Inventarisasi) disembunyikan dan tidak wajib.
- Saat transaksi Done: semua aset dengan `asset_type = HBM` yang memakai nomor aset tersebut otomatis berubah kondisi menjadi Dispose.
- Mode **Penghapusan Nomor Inventarisasi**: form tetap seperti sebelumnya; dropdown equipment difilter hanya aset `asset_type = HBI`.
- Terjemahan label ditambahkan di `pj_easset/i18n/id.po`.
- API: `type_dispose` ikut diekspos di serializer GET + whitelist create `controllers/asset_transaction/asset_transaction.py`, dan didokumentasikan di schema POST/PUT `controllers/swagger.py`.
File yang diubah:
- `pj_easset/models/maintenance/snk_maintenance_transaction.py`
- `pj_easset/views/maintenance/snk_maintenance_transaction.xml`
- `pj_easset/i18n/id.po`
- `pj_easset/controllers/asset_transaction/asset_transaction.py`
- `pj_easset/controllers/swagger.py`
Catatan deploy: perubahan aditif (kolom baru), tanpa migration script — cukup `-u pj_easset` lalu restart.
---
# Easset — List Fixing (Dashboard Aset & Penghapusan)
Modul: `pj_easset` · Odoo 18 Community · Branch kerja: `cj/easet` · Commit: `1b416cc` (poin 1–6), `330733a` (poin 7–10)
---
## 1. Filter Tanggal Perolehan → "Data Aset per Tanggal"
**Path UI:** Dashboard Aset → filter tanggal di kanan atas
Label filter diubah dari **"Per Tanggal Perolehan"** menjadi **"Data Aset per Tanggal"**.
Perilaku filter tidak berubah (snapshot kumulatif s/d tanggal terpilih).
**File:** `pj_easset/static/src/xml/aset_dashboard.xml`
---
## 2. Rename Chart "Usulan Penghapusan Aset"
Judul chart diubah menjadi **"Usulan Penghapusan Nomor Aset"**.
**File:** `pj_easset/static/src/xml/aset_dashboard.xml`
---
## 3. Business Logic Penghapusan (HBM vs HBI)
**Model:** `snk.maintenance.transaction` → `action_done()`
**File:** `pj_easset/models/maintenance/snk_maintenance_transaction.py`
- **HBM:** saat transaksi dispose selesai (done), jika equipment bertipe HBM dan
punya Nomor Aset (`asset_number_id`), **seluruh Nomor Inventarisasi**
(`maintenance.equipment`) yang terafiliasi dengan Nomor Aset tersebut ikut
di-set `condition = 'dispose'`.
- **HBI:** tidak pakai Nomor Aset → penghapusan hanya berlaku pada equipment
transaksi itu sendiri (level Nomor Inventarisasi). Guard pakai
`asset_type == 'hbm'`, jadi data HBI yang keliru terisi Nomor Aset tetap
tidak kena cascade.
Detail implementasi:
- Afiliasi di-prefetch **satu kali** dengan satu `search` untuk seluruh batch
(no N+1), lalu `filtered()` in-memory di dalam loop.
- Equipment yang sudah `dispose` di-exclude dari cascade.
- Write pakai `skip_validation_check=True` (konsisten pola tier validation).
---
## 4. Chart Usulan Penghapusan: Bar → Pie + Tooltip Detail
**File:** `pj_easset/static/src/js/aset_dashboard.js`
- Tipe chart diubah dari **horizontal bar** menjadi **pie** (satu slice per unit,
warna auto `generateColors()`, legend di bawah).
- Ukuran slice = jumlah **Nomor Aset unik** yang diusulkan dihapus per unit.
Top-12 unit, sisanya digabung ke slice "Lainnya".
- **Klik / hover / tap slice** → tooltip dua baris per unit, **keduanya murni
dari transaksi usulan** (bukan afiliasi master Aset — sempat dicoba model
afiliasi lalu di-revert karena angkanya membingungkan, mis. 37 utk Bali):
- `Nomor Aset diusulkan dihapus: N` (unik `asset_number_id` di transaksi dispose)
- `Nomor Inventarisasi diusulkan dihapus: N` (unik `equipment_id` di transaksi
dispose **yang punya nomor aset** — usulan mode inventarisasi/HBI tanpa
nomor aset tidak dihitung, karena chart ini khusus penghapusan nomor aset)
- Cara verifikasi di UI: Transaksi Aset → filter Jenis = Penghapusan →
group by Asset Holder lalu Nomor Aset lalu Nomor Inventarisasi — jumlah
group (di luar "Tidak Ada") = angka tooltip.
- Data diambil dengan 2 `readGroup` paralel (`Promise.all`), tanpa fetch per record.
- Fix ikutan: usulan mode **Penghapusan Nomor Aset** tidak punya
`equipment_id`, sehingga filter tanggal global (`equipment_id.acquisition_date`)
sebelumnya mengecualikan mereka dari chart. Sekarang filter tanggal hanya
diberlakukan pada usulan yang punya equipment; usulan tanpa equipment tetap
tampil.
---
## 5. Bar Chart "Ratio Opname" — Label Tooltip
Tooltip bar Sudah/Belum Opname: `(36 aset)` → `(36 Nomor Inventarisasi)`.
**File:** `pj_easset/static/src/js/aset_dashboard.js` (`_buildOpnameRatioChart`)
---
## 6. Chart "Opname by Status" → per Hari Ini
- **Tidak lagi ter-filter** oleh filter tanggal global dashboard.
- Data yang ditampilkan hanya opname **bertanggal hari ini** (`date = today`,
dihitung dari waktu lokal browser, bukan UTC — aman untuk WIB/WITA).
- Judul chart diubah menjadi **"Opname by Status per hari ini"**.
**File:**
- `pj_easset/static/src/js/aset_dashboard.js` (query domain)
- `pj_easset/static/src/xml/aset_dashboard.xml` (judul)
---
## 7. Format Qty Aset → Bilangan Bulat
**Model:** `maintenance.equipment`
**File:** `pj_easset/models/maintenance/snk_maintenance_equipment.py`
Field berikut tampil sebagai bilangan bulat (tanpa desimal) di List Aset,
Detail Aset, dan semua view lain model ini:
| Label | Field |
|---|---|
| Jumlah item aset | `quantity` |
| Qty aktif | `inventory_quantity` |
| Qty rusak | `broken_quantity` |
| Qty hilang | `loss_quantity` |
| Qty dihapuskan | `dispose_quantity` |
Implementasi: `digits=(16, 0)` di definisi field — berlaku global tanpa edit
XML per view; nilai yang di-write ke depan ikut dibulatkan oleh ORM.
Kolom DB auto-convert `float8 → numeric` oleh `_auto_init` saat upgrade
(**tidak perlu** migration script; sudah diverifikasi tidak ada nilai pecahan
di data existing).
---
## 8. Detail Aset: "Asset Holder Address" → `owner_partner_id`
**Model:** `maintenance.equipment`
**File:** `pj_easset/views/maintenance/snk_equipment_maintenance_view.xml`
- Field `owner_partner_id` (many2one) **dimunculkan** — label tampil
"Asset Holder Address" via terjemahan `id.po` yang sudah ada.
- Field `owner_partner_address` (char) **tetap tampil tapi tanpa label**,
posisi tepat di bawah nilai `owner_partner_id` dan **sejajar kolom nilai**
(pola `label for` + `div` berisi kedua field, alamat `class="d-block"`).
*(Revisi commit `f86d592` lalu `60a97a4` — awalnya di-hide `invisible="1"`
di `330733a`.)*
---
## 9. Detail Aset: Label "Geo Location" → "Geo Location Input"
**Field:** `geo_tag` (char) · **Model:** `maintenance.equipment`
**File:** `pj_easset/i18n/id.po` (msgid "Geo Tagging")
---
## 10. Fix: Atribut `groups` Mengandung Newline
**File:** `pj_easset/views/maintenance/snk_maintenance_request.xml`
Atribut `groups` pada button archive mengandung baris baru sehingga Odoo
warning *"group pj_easset.group_maintenance_user does not exist"* saat load
view dan pembatasan group tidak berlaku. Sudah dirapikan jadi satu baris.
---
## Cara Deploy
### Poin 1–6 (commit `1b416cc`)
Tidak ada perubahan struktur DB (field/model baru) → **tidak perlu migration
/ naik version manifest**.
- Poin 3 (Python): restart service Odoo.
- Poin 1, 2, 4, 5, 6 (JS/XML asset): hard refresh browser (Cmd/Ctrl+Shift+R);
kalau assets tidak dalam mode dev, jalankan `-u pj_easset` sekali.
### Poin 7–10 (commit `330733a`)
Ada perubahan struktur kolom (float8 → numeric) → version manifest naik
`0.5 → 0.6`, **wajib upgrade modul** (migration script tidak perlu, ORM
handle konversinya otomatis).
Sudah dites: upgrade dari `18.0.0.5` maupun jalur penuh dari `18.0.0.1`
(migration 0.2/0.4/0.5 ikut jalan) — keduanya bersih tanpa error.
```bash
git pull
# backup dulu
docker exec <db-container> pg_dump -U <user> <db> > backup_$(date +%Y%m%d).sql
# upgrade (ALTER TABLE butuh lock singkat di maintenance_equipment —
# jalankan saat tidak ada user aktif menulis)
docker exec <web-container> odoo -c /etc/odoo/odoo.conf -u pj_easset -d <db> --stop-after-init --no-http
docker restart <web-container>
```