# Solusi Masalah Saldo BKU - Quick Start

## Masalah Anda
Saldo akhir bulan Juli **belum tertulis** menjadi saldo awal di bulan Agustus untuk tiap akunnya.

## Penyebab
Sistem tidak otomatis menyimpan saldo akhir bulan ke tabel `riwayat_saldo`, sehingga bulan berikutnya tidak punya saldo awal.

## Solusi Cepat

### 1️⃣ Jalankan Command Tutup Buku untuk Juli 2025

Buka terminal/command prompt di folder project, lalu jalankan:

```bash
php artisan buku:tutup-bulan 7 2025
```

**Apa yang dilakukan command ini?**
- Menghitung saldo akhir Juli untuk semua akun kas di semua unit
- Menyimpan ke tabel `riwayat_saldo` dengan tanggal 31 Juli 2025 23:59:59
- Saldo ini akan otomatis menjadi saldo awal Agustus

### 2️⃣ Verifikasi Hasilnya

Setelah command selesai, cek:
1. **Di database:** Tabel `riwayat_saldo` sekarang ada entry baru dengan deskripsi "Saldo Akhir Bulan 7/2025 - Tutup Buku"
2. **Di aplikasi:** Buka laporan BKU bulan Agustus, saldo awal sekarang sudah terisi!

### 3️⃣ Untuk Bulan-Bulan Berikutnya

**✅ Otomatis (Sudah Aktif!)**

Sistem sekarang **otomatis tutup buku** tanpa perlu cron job!

**Cara Kerjanya:**
- Saat user login di **tanggal 1-5** setiap bulan
- Sistem otomatis tutup buku bulan lalu
- Hanya berjalan 1x per hari (tidak memberatkan server)

**Tidak Perlu Lakukan Apa-apa!** 🎉

**Jika Ingin Manual:**
```bash
# Tutup buku bulan Agustus
php artisan buku:tutup-bulan 8 2025

# Tutup buku bulan September  
php artisan buku:tutup-bulan 9 2025
```

## Contoh Output Command

```
=== TUTUP BUKU BULANAN ===
Bulan: 7, Tahun: 2025
Tanggal Akhir: 2025-07-31 23:59:59

--- Processing Unit: Unit Yayasan (ID: 1) ---
  ✓ [111101] Kas - Rp 10.000.000,00
  ✓ [111201] Bank BCA - Rp 50.000.000,00

=== SELESAI ===
Total diproses: 2
Total dilewati: 0
```

## FAQ

**Q: Aman tidak kalau dijalankan berulang kali?**  
A: Aman! Command akan skip akun yang sudah ditutup.

**Q: Bagaimana kalau ada transaksi yang ditambah setelah tutup buku?**  
A: Hapus entry di `riwayat_saldo` untuk bulan tersebut, lalu jalankan ulang command.

**Q: Bisa tutup buku untuk unit tertentu saja?**  
A: Bisa! Tambahkan `--unit_id=1` (ganti 1 dengan ID unit Anda)
```bash
php artisan buku:tutup-bulan 7 2025 --unit_id=1
```

## File yang Dibuat

1. **Command:** `app/Console/Commands/TutupBukuBulanan.php`
2. **Dokumentasi Lengkap:** `CARA_TUTUP_BUKU.md`
3. **Quick Start (file ini):** `QUICK_START_TUTUP_BUKU.md`

---

**Butuh bantuan?** Lihat dokumentasi lengkap di `CARA_TUTUP_BUKU.md`