# 📘 Panduan Modul: Tools (Utilitas System Administrator)

> [!IMPORTANT]
> **STATUS FITUR VARIAN: SINKRONISASI SENTINEL (NON-VARIANT STANDAR)**
> Utilitas sinkronisasi stok pada `Locker.php` saat ini beroperasi murni untuk produk non-variant di versi produksi/live PT. INDOSAN. Rekonstruksi dan sinkronisasi saldo pada tabel `stock_locker_variant` secara live hanya mensinkronkan baris data dengan nilai sentinel **`variant_id = 1`** karena feature flag `singleVariantStandard.enabled` bernilai `false`.

## 1. Peran & Fungsi Utama
Modul ini merupakan suite utilitas perawatan database dan perbaikan data transaksional yang digunakan oleh System Administrator atau Developer saat melakukan audit/mismatch data:
- **`Locker.php`**: Berfungsi untuk merekonstruksi, memvalidasi, dan menyinkronkan paksa saldo `stock_locker` dan `stock_locker_variant` apabila terdeteksi selisih stok dengan fisik gudang.
- **`SerialNumber.php`**: Utilitas untuk menyinkronkan ulang status kepemilikan dan posisi file serial number produk (aktif, terjual, void, dll).
- **`DataProduk.php` / `DataProduk2.php`**: Pemulihan data katalog produk, perbaikan antrean FIFO HPP produk, dan sinkronisasi HPP rata-rata.
- **`PaymentSource.php`**: Memperbaiki data relasi sumber pembayaran transaksi.
- **`DataBase.php`**: Utilitas administrasi database secara langsung.

---

## 2. Aliran Finansial & Mutasi Persediaan
- **Fungsi Korektif Pasca-Transaksi**: Modul ini tidak digunakan untuk mencatat transaksi operasional harian, melainkan digunakan secara manual untuk memperbaiki data (*data repair*) jika terjadi kegagalan proses.
- **Memperbaiki Stock Locker**: Dapat menulis ulang isi tabel `stock_locker` dan `stock_locker_variant` guna mencocokkan nilainya jika terjadi desinkronisasi.