STINV V2.10.241 — PV2 AUTO SNAPSHOT (NOVEMBER 2026)
======================================================
Tujuan: menghilangkan kebutuhan membuka Engine Periodik > Hitung Ulang ketika
bulan baru (contoh 2026-11) dibuka pada Valuasi/Kartu Stok/Rekonsiliasi/Laporan.

INSTALL
1. Backup SOURCE dan DB di luar server. Pastikan cutover PV2 SUDAH AKTIF.
2. Uji pada clone database terlebih dahulu; bandingkan hasil periode 2026-10.
3. Ekstrak isi PATCH dan TIMPA path relatif yang sama pada folder STINV.
4. Login dengan hak laporan, buka Valuasi Stok bulan 2026-11. Periode akan
   terbentuk otomatis di pv2_periods, pv2_product_periods, pv2_movement_values.
5. Periksa Rekonsiliasi dan export XLSX; lakukan transaksi uji pembelian/penjualan
   di salinan DB dan lihat perubahan snapshot pada bulan OPEN.
6. Setelah lulus, pasang pada produksi pada jeda transaksi.

PERILAKU
- Hanya tabel PV2 hasil perhitungan yang diperbarui; mutasi, faktur, pajak,
  pembayaran, dan stok fisik tidak diubah.
- Laporan meminta snapshot OPEN yang belum ada atau stale: rebuild internal
  bulanan, dalam transaction+lock; tidak memerlukan klik manual.
- Snapshot FINAL / Tutup Buku: tidak pernah di-rebuild otomatis.
- Perubahan stok awal sebelum cutover, diskon/qty tidak konsisten, atau source
  anomali tetap ditolak; error integritas ditampilkan (tidak fallback Moving).
- Proses di dalam transaksi approval memakai validasi ketat dan jalur integrasi
  approval yang sudah ada; tidak memulai transaksi nested.
- Batas auto-rebuild 24 bulan sejak cutover; rentang lebih panjang memerlukan
  maintenance/review terpisah. Auto hanya saat laporan dibuka atau approval
  didukung, bukan daemon/background scheduler.
- Rebuild internal tetap terjadi (matematika tidak bisa tanpa menghitung),
  hanya langkah manual Hitung Ulang yang dihilangkan.
- Versi tetap 2.10.241 dan changelog tidak disentuh.

DIAGNOSIS
Jika November masih menampilkan pesan lama, restart OPcache/PHP dan pastikan
file modules/periodic/engine.php pada server sudah tertimpa.
Jika gagal karena FINAL/Tutup Buku/data tidak konsisten, jangan hapus tabel
atau ubah status periodik langsung; periksa log dan backup.

QA: lint PHP/struktur secara offline; belum uji transaksi MariaDB produksi.
