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