Doc_chelvyn/Mesa/Report/Mesa — Grade Transaksi pada...

221 lines
9.8 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: 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