================================================================================ CATATAN RILIS & PEMBARUAN SISTEM KELUARGAMART (VERSI 1.2.0) ================================================================================ Tanggal rilis dokumentasi: 26 Oktober 2026 Status: Catatan perubahan source; bukan konfirmasi deployment produksi. Pembaruan ini berfokus pada ketepatan kas kasir, keamanan penutupan shift, kelengkapan histori stok, keandalan checkout B2B, serta transfer antar gudang sesuai pergerakan barang fisik. ERP, POS, dan B2B memakai versi platform serta catatan rilis bersama yang diselaraskan ke 1.2.0. -------------------------------------------------------------------------------- 1. KASIR POS: KAS MASUK, KAS KELUAR & PENUTUPAN SHIFT LEBIH TERJAGA -------------------------------------------------------------------------------- • Ringkasan dan Detail Shift Menggunakan Pencatatan yang Sama: Riwayat kas tersimpan dibaca dari backend. Kas masuk Rp8.000 menambah kas yang diharapkan tepat sekali. Modal awal, penjualan tunai, kas masuk, kas keluar, kas fisik, serta selisih ditampilkan agar mudah diperiksa. • Uang Non-Tunai dan Transaksi Batal Tidak Menambah Laci: Perhitungan membedakan penjualan tunai dari pembayaran non-tunai. Refund tunai mengurangi kas tepat sekali, bukan dihitung berulang. • Penutupan Berselisih Tidak Bisa Lolos Sembarangan: Penutupan normal ditolak jika kas fisik tidak sesuai. Override hanya untuk admin/owner berwenang dengan alasan dan audit. Shift tertutup dilindungi dari perubahan finansial susulan, termasuk permintaan bersamaan. Referensi commit: 3bad1e8 dan c9f9ef2. -------------------------------------------------------------------------------- 2. HISTORI STOK MASUK & KELUAR LEBIH LENGKAP DAN KONSISTEN -------------------------------------------------------------------------------- • Penerimaan Pembelian dan Pembatalan Penjualan Tercatat: Perubahan saldo dan movement diproses secara atomik. Kegagalan pencatatan membatalkan transaksi terkait agar tidak tersimpan setengah jadi. • Opname, Filter, dan Total Lebih Tepat: Arah masuk/keluar mengikuti perubahan saldo. Cakupan gudang mengikuti hak akses. Total mengikuti seluruh hasil filter, bukan hanya halaman terlihat. • Request Berulang Tidak Menggandakan Stok: Bukti operasi persisten melindungi pengulangan input manual/penerimaan. Referensi commit: c9f9ef2. -------------------------------------------------------------------------------- 3. CHECKOUT GROSIR B2B LEBIH ANDAL -------------------------------------------------------------------------------- • Pesan Kendala Lebih Jelas dan Aman: Kesalahan minimum belanja, harga/satuan, stok, dan hak akses ditangani sesuai jenisnya tanpa membocorkan detail internal server. Form dan keranjang tetap tersedia ketika validasi gagal. • Pesanan Berhasil Tidak Lagi Dilaporkan Gagal Karena Refresh: Kegagalan memuat histori sesudah commit tidak membatalkan keberhasilan checkout. Kendala inisialisasi pembayaran diarahkan ke pesanan yang sama. • Retry Tidak Membentuk Pesanan Ganda: Keranjang dikunci dan bukti checkout disimpan. Pesanan, item, perubahan stok, pengosongan keranjang, serta bukti checkout berada dalam transaksi konsisten. Referensi commit: c9f9ef2. -------------------------------------------------------------------------------- 4. TRANSFER GUDANG MENGIKUTI PENGIRIMAN & PENERIMAAN FISIK -------------------------------------------------------------------------------- • Draft Tidak Mengubah Saldo: Draft hanya menyimpan rencana. Konfirmasi kirim mengurangi stok asal dan mencatat transit; gudang tujuan belum bertambah sebelum penerimaan fisik. • Penerimaan Bisa Parsial, Rusak, atau Berselisih: Hanya barang baik yang diterima menambah stok siap jual. Sisa transit tetap terlacak. Barang rusak dicatat terpisah; kehilangan memerlukan otorisasi, alasan, dan audit. Penerimaan melebihi jumlah kirim ditolak. • Pengiriman dan Penerimaan Berulang Dikendalikan: Request ulang atau bersamaan tidak boleh menggandakan saldo dan movement. Referensi commit: c9f9ef2. -------------------------------------------------------------------------------- 5. VOUCHER SERAH TERIMA PERSISTEN & CETAK ULANG BACA-SAJA -------------------------------------------------------------------------------- • Voucher Mengikuti Data Transfer Aktual: Dokumen pengiriman memiliki nomor unik, snapshot identitas perusahaan, gudang, operator, waktu kirim, produk, satuan, kuantitas, serta catatan. Tersedia ruang pemeriksaan/selisih dan tanda tangan serah terima. • Cetak Ulang Tidak Memindahkan Stok: Snapshot menjaga isi dokumen saat data lain berubah. Pencetakan ulang bukan pemicu mutasi stok maupun movement baru. Referensi commit: c9f9ef2. -------------------------------------------------------------------------------- 6. TIKET BANTUAN, NOTIFIKASI MENDESAK & INFORMASI VERSI -------------------------------------------------------------------------------- • Detail Tiket Lebih Mudah Dibaca di ERP: Detail laporan ditampilkan pada tabel/modal serta halaman rincian tiket. Hak kelola tiket didukung pembaruan permission melalui migration 000133. Tiket mendesak memiliki peringatan suara. • Label Versi pada Login ERP dan POS: Commit 7d67730 menambahkan label v1.1.0 saat itu. Label versi dan catatan rilis platform kini diselaraskan ke 1.2.0; perubahan ini tidak mengubah atribusi versi historis commit asal. Referensi commit: 771105d dan 7d67730. -------------------------------------------------------------------------------- 7. CATATAN DATABASE, BATASAN & BUKTI VERIFIKASI -------------------------------------------------------------------------------- • Migration yang Terkait: 000133: hak kelola tiket bantuan. 000134: audit penutupan dan perlindungan integritas kas shift. 000135: lifecycle transfer, transit, voucher, dan audit penerimaan. 000136: bukti idempotensi operasi stok. 000137: bukti checkout persisten. • Data Lama Tidak Dibuat-buat: Movement historis yang tidak pernah tercatat tidak direkonstruksi otomatis. Transfer lama yang sudah dikirim memerlukan rekonsiliasi berbasis bukti. Voucher memerlukan identitas perusahaan tersimpan pada konfigurasi. • Batas Akuntansi Tetap Berlaku: Pembaruan reversal dan tutup buku adalah bagian rilis 1.1.0, bukan fitur baru 1.2.0. Posting GL POS, pembayaran invoice, settlement gateway, retur, dan HPP belum diaktifkan. Mapping akun dan kebijakan koreksi lintas periode masih memerlukan keputusan bisnis. • Bukti yang Sudah Dicatat Berasal dari Lingkungan Lokal: Rincian skenario, hasil pengujian transaksi, quality gates, warning nonfatal, dan batas verifikasi tersedia di CATATAN-PERBAIKAN-INTEGRITAS-TRANSAKSI.txt. Hasil tersebut bukan klaim pengujian ulang saat penyusunan changelog ini. Tidak ada klaim write ke production atau deployment dari catatan rilis ini. -------------------------------------------------------------------------------- 8. RIWAYAT LENGKAP COMMIT & VERSI -------------------------------------------------------------------------------- CHANGELOG.md memuat ringkasan rilis beserta arsip versi sebelumnya. CHANGELOG-COMMITS.txt mencatat seluruh 1122 commit reachable saat penyusunan, masing-masing tepat sekali dengan hash lengkap, tanggal, subjek asli, dan atribusi versi: - 1.0.0: 19 commit jalur utama monorepo sampai eb49cd7 (inklusif). - 1.1.0: 22 commit sesudah eb49cd7 sampai bump 86b4173 (inklusif). - 1.2.0: 4 commit sesudah 86b4173 sampai c9f9ef2 (inklusif). - Historis impor / versi tidak ditetapkan: 1077 commit repositori asal. Tidak ada tag Git saat penyusunan. Versi tidak ditebak dari tanggal commit. Dual-tag alias legacy GHCR 0f887c8 telah dibatalkan d59dd5b dalam riwayat 1.1.0; pasangan commit tetap dicatat, bukan dianggap fitur aktif. Catatan TXT rilis 1.1.0 tetap dipertahankan tanpa perubahan. ================================================================================