---
proyek: Mesa (PT Megariamas Sentosa)
modul: mesa
odoo: 18.0 Enterprise
kategori: Report
tanggal: 2026-10-28
branch: krs/fix-report-grade-transaksi
dasar: d75a9f5 (snapshot grade di stock.move / stock.move.line / account.move.line)
commit: fb7c502
status: Lolos uji lokal · sudah di-push · belum PR · belum di-deploy
tags:
- mesa
- report
- grade
- inventory
---
> Index: [[Mesa — Index]] · Kategori: **Report**
# Grade Transaksi pada Report Inventory
**Tanggal:** 28 Oktober 2026
**Modul:** `mesa` · folder `mesa/models/reports/`
**Status:** ✅ kode selesai · ✅ lolos uji lokal · ⏳ belum diuji di staging · ✅ di-push ([fb7c502](https://repo.sinerka.id/SINERKA/mesa_dev/commit/fb7c502)) · ⏳ belum PR · ⏳ belum di-deploy
## Latar Belakang
Hotfix `d75a9f5` mengubah grade di level transaksi dari *related* ke **snapshot**. Grade
sekarang tersimpan di `stock.move`, `stock.move.line`, dan `account.move.line` saat
transaksi dibuat (onchange product, create, write, import).
Tapi 5 report inventory masih mengambil grade dari **master produk**
(`pp.snk_grade_id` / `pt.snk_grade_id`). Akibatnya, kalau grade produk diganti, report
untuk transaksi lama ikut berubah ke grade baru, tidak sesuai dengan grade saat transaksi terjadi.
## Solusi
Penyesuaian tarikan data grade supaya report memakai **grade transaksi terkait**:
- [x] STO Monitoring
- [x] Inventory Transfer
- [x] Stock Balance Site vs Gudang
- [x] Stock Card
- [x] Stock Summary / Stock Periode
---
## Alur Penentuan Grade
```mermaid
flowchart TD
A["Generate report"] --> B{"Jenis baris report?"}
B -- "baris transaksi
(Inventory Transfer, STO Monitoring,
mutasi Stock Card)" --> C["Grade = stock_move_line.snk_grade_id
/ stock_move.snk_grade_id"]
B -- "baris saldo
(Initial/Ending Stock Card,
Stock Periode, Stock Balance)" --> D["Cari transaksi done terakhir
MAX(ARRAY[epoch, sml.id, grade])"]
B -- "STO line belum ada DO" --> E["Grade = STO line.snk_grade_id"]
D --> F{"Ada transaksi?"}
F -- "ya" --> C
F -- "tidak (Stock Periode)" --> G["Bawa grade periode sebelumnya"]
C --> H{"Grade NULL?
(data lama belum backfill)"}
G --> H
E --> H
H -- "tidak" --> I["Pakai grade transaksi"]
H -- "ya" --> J["Fallback: product.product.snk_grade_id"]
I --> K{"Filter grade di wizard?"}
J --> K
K -- "tidak" --> L["Baris masuk report"]
K -- "ya, cocok" --> L
K -- "ya, tidak cocok" --> M["Baris di-skip"]
classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef todo fill:#f3f4f6,stroke:#9ca3af,color:#374151,stroke-dasharray:4 3
class I,L ok
class M err
class J todo
```
**Keterangan warna:** hijau = grade transaksi dipakai / baris masuk report ·
merah = baris di-skip oleh filter · abu-abu putus-putus = fallback ke master produk
(hanya untuk data lama sampai backfill selesai).
---
## Rincian Perubahan per Report
### 1. Inventory Transfer
- [x] Kolom grade = `COALESCE(sml.snk_grade_id, sm.snk_grade_id, pp.snk_grade_id)`
- [x] Filter grade wizard pakai ekspresi yang sama (sebelumnya `pp.snk_grade_id`)
- [x] Field `snk_grade_id` di `snk.report.inventory.transfer` diubah dari *related* ke template
menjadi Many2one biasa + `index=True`, diisi langsung oleh wizard
File: `report_inventory_transfer.py`, `report_inventory_transfer_wizard.py`
### 2. STO Monitoring
- [x] Grade diambil dari `stock.move` DO (helper baru `_get_move_grade_id`)
- [x] Pengelompokan move DO sekarang per **(produk, grade)**. Satu DO dengan produk sama tapi
grade beda → jadi 2 baris
- [x] STO line yang belum punya DO → pakai grade di STO line
- [x] Filter grade dipindah dari domain produk ke grade transaksi, dan diterapkan **setelah**
STO line di-match, supaya line yang sudah punya DO tidak muncul palsu sebagai "belum DO"
File: `report_monitoring_sto_wizard.py`
### 3. Stock Balance Site vs Gudang
- [x] Stock on-hand (quant) tidak punya grade. Grade diambil dari **transaksi done terakhir**
per (lokasi, produk, lot)
- [x] Filter grade dipindah dari domain produk ke grade hasil per baris
- [x] Field `snk_grade_id` di `report_stock_balance_site_gudang` diubah dari *related* ke
produk menjadi Many2one biasa + `index=True`
- [x] Durasi + jumlah key dicatat di log `[STOCK BALANCE]`
File: `report_stock_balance_site_gudang_report.py`, `report_stock_balance_site_gudang_wizard.py`
### 4. Stock Card
- [x] Baris mutasi → grade move line itu sendiri
- [x] **Initial Balance** → grade transaksi terakhir sebelum `date_start`
(kalau saldo awal 0: grade transaksi pertama di periode)
- [x] **Ending Balance** → grade transaksi terakhir s/d `date_end`
- [x] Saldo berjalan tetap per produk–lokasi–lot (tidak dipecah per grade)
File: `report_stock_card_wizard.py`
### 5. Stock Summary / Stock Periode
- [x] Grade per periode = transaksi terakhir di periode tsb. Kalau tidak ada mutasi, dibawa dari
periode sebelumnya (ikut pola *fast forward* `temp_rolling_balances`)
- [x] Filter grade dipindah dari `base_where` ke hasil akhir per periode. Kalau tetap di
`base_where`, saldo produk yang pernah ganti grade jadi terpotong
File: `report_stock_periode_wizard.py`
---
## Keputusan Teknis
| Keputusan | Alasan |
|---|---|
| Saldo **tidak** dipecah per grade | Grade di move keluar = grade produk saat itu, bukan grade stok yang fisik keluar. Kalau dipecah, bucket per grade bisa minus. |
| "Transaksi terakhir" pakai `MAX(ARRAY[epoch, sml.id, grade])` | Cukup satu pass agregasi di CTE yang sudah ada, tanpa sort / `DISTINCT ON` tambahan atas seluruh histori. |
| Fallback ke `product.product.snk_grade_id` | Data lama yang belum di-backfill grade-nya `NULL`, jadi report tidak boleh kosong. |
| Tanpa migration / naik version | Tipe kolom tetap `int4` (Many2one). Cukup `-u mesa` untuk membuat index baru. |
---
## Hasil Uji Lokal (28 Okt 2026)
**Lingkungan:** docker lokal · DB `MESA_DEV` (28 GB, 2,4 jt move line, 1,74 jt sudah punya grade)
· user admin · site **WEB SORELLA** (10710) · gudang **GUDANG JEMBATAN 3** · periode
Des 2025 – Feb 2026 (STO: Jun – Agu 2026, karena hanya periode itu yang ada STO-nya).
Uji dijalankan lewat `odoo shell` dalam satu transaksi lalu **di-rollback**. DB tidak berubah.
### Kode lama (HEAD) vs kode baru, data apa adanya
| Report | Baris lama | Baris baru | Durasi lama | Durasi baru |
|---|---|---|---|---|
| STO Monitoring | 6 | 6 | 0,37 s | 0,36 s |
| Inventory Transfer | 81.080 | 81.080 | 10,35 s | 9,27 s |
| Stock Balance Site vs Gudang | 9.175 | 9.175 | 39,79 s | 39,85 s |
| Stock Card | 84.006 | 84.006 | 8,21 s | 7,76 s |
| Stock Periode | 36.218 | 36.218 | 4,21 s | 4,64 s |
- [x] Jumlah baris identik, durasi setara (selisihnya masih dalam noise)
- [x] Query grade baru di Stock Balance hanya **0,43 s**. Sisa ~39 s ada di blok price map /
forecast, yang memang kode lama.
- [x] Inventory Transfer: 0 dari 81.080 baris yang grade-nya beda dengan grade move line
- [x] Stock Card: 4.983 baris grade kosong, **semuanya** produk yang grade master-nya juga kosong (wajar)
### Simulasi produk ganti grade
Produk `[S25-73018MX4XLG] NATURAL BAMBOO PANTY PACK (MX4, XLG)`: grade master diganti **7 → 1**,
lalu report di-generate ulang.
- [x] 5.340 move line produk tsb tetap grade 7 (snapshot tidak ikut berubah)
- [x] Stock Card: 1.080 baris → grade 7
- [x] Stock Periode: 4 baris → grade 7
- [x] Inventory Transfer: 1.200 baris → grade 7
- [x] Stock Balance: 1 baris → grade 7
- [x] STO Monitoring (uji terpisah, produk 803926 grade 7 → 1): baris DO tetap grade 7
### Filter grade
- [x] Filter grade lama (7): produk uji tetap muncul, tidak ada grade lain yang bocor
(Stock Periode & Inventory Transfer: 0 baris grade lain)
- [x] Filter grade baru (1): produk uji **tidak** muncul
- [x] STO Monitoring filter grade 1 → "Tidak ada data" (benar, DO-nya grade 7)
### Temuan sampingan (bukan dari perubahan ini)
- `DELETE FROM snk_report_inventory_transfer` (bersihkan buffer lama) makan 2–4 menit saat
81 rb baris di-insert dan di-delete dalam **satu transaksi** (statistik planner masih
menganggap tabel kosong, jadi cek FK cascade ke `snk_report_transfer_attr_rel` pakai seq scan).
Kemungkinan besar hanya artefak cara uji. Di pemakaian normal, generate & delete beda
transaksi. Perlu dipantau di staging.
- Stock Balance ~40 s untuk 1 site, hampir semuanya di blok price map / forecast (kode lama),
layak dioptimasi terpisah.
---
## Checklist Sebelum Deploy
- [x] Generate kelima report tanpa error (lokal, `MESA_DEV`)
- [x] Uji produk yang **pernah ganti grade**: transaksi lama tetap tampil grade lama
- [x] Uji filter grade di setiap wizard
- [x] Bandingkan jumlah baris & durasi kode lama vs baru
- [x] Upgrade modul di lokal (29 Okt 2026): `docker compose exec web odoo -u mesa -d MESA_DEV --stop-after-init --no-http`
→ 17 detik, 0 ERROR. Tidak ada migration yang jalan (manifest `0.9` = DB `18.0.0.9`).
Index `snk_report_inventory_transfer__snk_grade_id_index` &
`report_stock_balance_site_gudang__snk_grade_id_index` terbentuk. Smoke test setelah
upgrade (Inventory Transfer & Stock Balance generate + ORM read) lolos.
Di lokal nama service-nya `web`, bukan `odoo`.
- [ ] Upgrade modul di **staging** pada copy DB production
- [ ] STO Monitoring: cek DO dengan produk sama tapi grade beda → terpecah 2 baris
(kasusnya tidak ada di data lokal)
- [ ] Stock Periode: cek periode tanpa mutasi tetap membawa grade periode sebelumnya
- [ ] `EXPLAIN (ANALYZE, BUFFERS)` Stock Card & Stock Periode di site besar, tulis angka before/after
- [ ] Pastikan backfill grade data lama (Server Action) sudah jalan, supaya fallback master produk jarang terpakai
- [x] Commit `fb7c502` di branch `krs/fix-report-grade-transaksi`, sudah di-push ke origin
- [ ] PR `krs/fix-report-grade-transaksi` → `development`
- [ ] `pg_dump` production sebelum upgrade
- [ ] Deploy ke production lewat CLI