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

9.8 KiB
Raw Blame History

proyek modul odoo kategori tanggal branch dasar commit status tags
Mesa (PT Megariamas Sentosa) mesa 18.0 Enterprise Report 2026-10-28 krs/fix-report-grade-transaksi d75a9f5 (snapshot grade di stock.move / stock.move.line / account.move.line) fb7c502 Lolos uji lokal · sudah di-push · belum PR · belum di-deploy
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) · ⏳ 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:

  • STO Monitoring
  • Inventory Transfer
  • Stock Balance Site vs Gudang
  • Stock Card
  • Stock Summary / Stock Periode

Alur Penentuan Grade

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

  • Kolom grade = COALESCE(sml.snk_grade_id, sm.snk_grade_id, pp.snk_grade_id)
  • Filter grade wizard pakai ekspresi yang sama (sebelumnya pp.snk_grade_id)
  • 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

  • Grade diambil dari stock.move DO (helper baru _get_move_grade_id)
  • Pengelompokan move DO sekarang per (produk, grade). Satu DO dengan produk sama tapi grade beda → jadi 2 baris
  • STO line yang belum punya DO → pakai grade di STO line
  • 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

  • Stock on-hand (quant) tidak punya grade. Grade diambil dari transaksi done terakhir per (lokasi, produk, lot)
  • Filter grade dipindah dari domain produk ke grade hasil per baris
  • Field snk_grade_id di report_stock_balance_site_gudang diubah dari related ke produk menjadi Many2one biasa + index=True
  • 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

  • Baris mutasi → grade move line itu sendiri
  • Initial Balance → grade transaksi terakhir sebelum date_start (kalau saldo awal 0: grade transaksi pertama di periode)
  • Ending Balance → grade transaksi terakhir s/d date_end
  • Saldo berjalan tetap per produk–lokasi–lot (tidak dipecah per grade)

File: report_stock_card_wizard.py

5. Stock Summary / Stock Periode

  • Grade per periode = transaksi terakhir di periode tsb. Kalau tidak ada mutasi, dibawa dari periode sebelumnya (ikut pola fast forward temp_rolling_balances)
  • 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
  • Jumlah baris identik, durasi setara (selisihnya masih dalam noise)
  • Query grade baru di Stock Balance hanya 0,43 s. Sisa ~39 s ada di blok price map / forecast, yang memang kode lama.
  • Inventory Transfer: 0 dari 81.080 baris yang grade-nya beda dengan grade move line
  • 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.

  • 5.340 move line produk tsb tetap grade 7 (snapshot tidak ikut berubah)
  • Stock Card: 1.080 baris → grade 7
  • Stock Periode: 4 baris → grade 7
  • Inventory Transfer: 1.200 baris → grade 7
  • Stock Balance: 1 baris → grade 7
  • STO Monitoring (uji terpisah, produk 803926 grade 7 → 1): baris DO tetap grade 7

Filter grade

  • Filter grade lama (7): produk uji tetap muncul, tidak ada grade lain yang bocor (Stock Periode & Inventory Transfer: 0 baris grade lain)
  • Filter grade baru (1): produk uji tidak muncul
  • 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

  • Generate kelima report tanpa error (lokal, MESA_DEV)
  • Uji produk yang pernah ganti grade: transaksi lama tetap tampil grade lama
  • Uji filter grade di setiap wizard
  • Bandingkan jumlah baris & durasi kode lama vs baru
  • 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
  • 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