221 lines
9.8 KiB
Markdown
221 lines
9.8 KiB
Markdown
---
|
||
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<br/>(Inventory Transfer, STO Monitoring,<br/>mutasi Stock Card)" --> C["Grade = stock_move_line.snk_grade_id<br/>/ stock_move.snk_grade_id"]
|
||
B -- "baris saldo<br/>(Initial/Ending Stock Card,<br/>Stock Periode, Stock Balance)" --> D["Cari transaksi done terakhir<br/>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?<br/>(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
|