================================================================================ CATATAN RILIS & PEMBARUAN SISTEM KELUARGAMART (VERSI 1.3.0) ================================================================================ Tanggal rilis dokumentasi: 27 Oktober 2026 Status: Catatan perubahan source; pembaruan fitur & stabilitas operasional. Pembaruan Versi 1.3.0 berfokus pada pemisahan alur pengepakan gudang melalui modul Packing Order, fitur pengajuan retur pesanan di B2B E-Commerce, penomoran dokumen berformat tanggal lengkap dengan reset sequence bulanan, perbaikan tuntas metode pembayaran Cash/COD tanpa popup payment gateway, serta kelengkapan naskah dan storyboard video presentasi omnichannel. -------------------------------------------------------------------------------- 1. MODUL BARU ERP: PACKING ORDER TERPISAH UNTUK FULFILLMENT B2B -------------------------------------------------------------------------------- • Pemisahan Alur Kerja Pengepakan (Fulfillment): Pesanan grosir dari B2B kini memiliki modul antrean tersendiri di ERP (Distribusi & Pengiriman -> Packing Order). Staf gudang tidak lagi harus mencari pesanan di daftar Sales Order umum ritel. • Tampilan Antarmuka Standar & Ergonomis: Mengadopsi komponen kanonikal antarmuka KeluargaMart (KDataTable, KStatCard, dan DetailItem) dengan 4 kartu statistik utama: Menunggu Dipacking, Sedang Dipacking, Siap Dikirim, dan Selesai Dikirim. • Filter Multi-Toko / Cabang & Pencarian Cepat: Dilengkapi selektor filter per Toko/Outlet dan pencarian nomor referensi pesanan untuk mempercepat operasional gudang multi-cabang. • Alur Operasional Terpadu: Aksi bertahap mulai dari Ambil Pesanan (Start Packing), input nomor resi / catatan packing, penugasan kurir armada, hingga konfirmasi siap kirim. Referensi commit: 1f12615, 17e9d15, 4143ffe, 9dddca4, dan b4e9fa1. -------------------------------------------------------------------------------- 2. MODUL RETUR BARANG DI B2B E-COMMERCE -------------------------------------------------------------------------------- • Pengajuan Pengembalian Barang Terstruktur: Mitra pembeli B2B dapat mengajukan retur barang belanjaan langsung dari halaman riwayat pesanan (Account Orders) jika menerima barang rusak atau cacat. • Formulir Bukti Lengkap: Mendukung input kuantitas retur, pemilihan alasan pengembalian (barang cacat, kemasan bocor, barang kurang), dan upload foto bukti fisik secara langsung. • Sinkronisasi Status ke ERP: Pengajuan retur langsung terhubung ke sistem ERP untuk diverifikasi oleh staf gudang/toko sebelum penerbitan kredit nota atau penggantian fisik barang. Referensi commit: 17e9d15. -------------------------------------------------------------------------------- 3. PENOMORAN DOKUMEN: FORMAT TANGGAL LENGKAP & RESET SEQUENCE BULANAN -------------------------------------------------------------------------------- • Format Tanggal Lengkap YYYYMMDD Dipertahankan: Nomor dokumen penting (Purchase Order, Transfer Stok, dan Jurnal Keuangan) tetap memuat tanggal lengkap kalender sehingga waktu transaksi langsung terbaca jelas dari nomor dokumen (contoh: PO-20261027-0001). • Reset Nomor Urut (Sequence Counter) per Bulan: Nomor urut tidak lagi direset harian, melainkan direset setiap awal bulan. Hal ini menjaga kesinambungan urutan transaksi selama satu bulan buku pembukuan dan memudahkan pencocokan saat audit laporan keuangan. Referensi commit: 2f7b9d3 dan f29859a. -------------------------------------------------------------------------------- 4. PERBAIKAN METODE PEMBAYARAN TUNAI (COD / CASH) DI B2B -------------------------------------------------------------------------------- • Bebas dari Popup Payment Gateway: Memperbaiki kendala di mana memilih metode Cash / Bayar di Tempat sempat memunculkan popup Midtrans Snap. • Modal Panduan Pembayaran Tunai: Metode pembayaran Cash kini diklasifikasikan dengan jenis `kind: 'cash'`. Halaman konfirmasi checkout dan detail pesanan menampilkan modal petunjuk pembayaran tunai resmi serta menyembunyikan tombol pembayaran kartu/gateway. • Catatan Metode di Backend: Backend menyimpan catatan metode pembayaran tunai secara transparan pada rincian faktur dan slip pengantaran pesanan. Referensi commit: 8ac3cbf. -------------------------------------------------------------------------------- 5. ALUR TRANSFER STOK, APPROVAL FALLBACK & ISOLASI MOVEMENT HARIAN -------------------------------------------------------------------------------- • Alur Persetujuan Cadangan (Approval Fallback): Proses persetujuan perpindahan stok kini memiliki mekanisme fallback otomatis yang aman jika supervisor outlet asal sedang tidak bertugas, mencegah barang tertahan di gudang. • Isolasi Nomor Movement Stok Harian: Penomoran baris transaksi mutasi stok (stock movement) diisolasi dalam lingkup hari untuk mencegah error benturan nomor unik (unique constraint collision) pada PostgreSQL saat lalu lintas transaksi tinggi. • Validasi Gudang & Toko Aktif: Kueri inventori dan opsi gudang diperketat agar hanya menampilkan gudang yang berada di bawah toko/cabang yang aktif beroperasi. Referensi commit: 2f7b9d3, 13c5562, 95f28ae, dan 4c32cad. -------------------------------------------------------------------------------- 6. PELACAKAN PENGIRIMAN REAL-TIME & STABILITAS HYDRATION B2B -------------------------------------------------------------------------------- • Auto-Refresh Status Pengiriman B2B & ERP: Perubahan status pengiriman pesanan (Delivery Order) kini diperbarui secara otomatis di layar pembeli B2B saat barang berpindah status (Processing -> In-Transit -> Delivered -> Completed). • Pencegahan SSR Hydration Mismatch: Memperbaiki glitch rendering SSR/CSR pada Nuxt di halaman akun pesanan B2B dan memastikan token otorisasi tersambung dengan aman pada saat pergantian halaman pagination dan filter pesanan. Referensi commit: 1998441, fe177d8, dan 02ba2d2. -------------------------------------------------------------------------------- 7. DOKUMENTASI LENGKAP PANDUAN & SKRIP VIDEO PRESENTASI -------------------------------------------------------------------------------- • Storyboard Adegan Presentasi Omnichannel: Penyusunan dokumen `docs/PANDUAN_ALUR_VIDEO_PRESENTASI.md` yang memuat rekomendasi urutan pengerjaan video, daftar aksi klik layar vs pembuktian data di ERP, serta tabel akun login untuk seluruh peran (Kasir, Sales, SPV, BM, Gudang, AR). • Skrip Siap Rekam (Voiceover Word-for-Word): Penyusunan dokumen `docs/SKRIP_VIDEO_PRESENTASI_LENGKAP.md` yang memuat naskah suara kata-demi-kata berdurasi terukur (10–16 menit per video) untuk 3 topik utama: POS Kasir Toko, B2B E-Commerce & Gudang, serta ERP Sales & Penagihan LHPP. Referensi commit: 0d148d8 dan d1fd076. ================================================================================