# 🚀 Quick Start: Perbaikan Saldo Kas & Bank

## ⚡ Langkah Cepat (5 Menit)

### 1. Preview Masalah
```bash
php artisan saldo:recalculate --dry-run
```

Ini akan menampilkan:
- Akun mana saja yang saldonya tidak sesuai
- Berapa selisihnya
- Tanpa mengubah database

### 2. Perbaiki Saldo
```bash
php artisan saldo:recalculate
```

Ini akan:
- Menghitung ulang saldo dari jurnal_entry
- Mengupdate kolom `saldo` di tabel `akun`
- Memperbaiki ketidaksesuaian

### 3. Verifikasi
- Buka dashboard
- Cek apakah "Saldo Kas & Bank Akhir" sudah sesuai
- Bandingkan dengan laporan BKU

## 📊 Contoh Output

```
🔄 Memulai recalculate saldo akun...

📅 Periode: 2025 - 1
🔍 Filter: Hanya akun kas (is_kas = 1)
📊 Total akun yang akan diproses: 15

  ✅ 111000 - Kas Yayasan
     Saldo Lama: 1,205,210,985,792.89
     Saldo Baru: 22,616,202,660.64
     Selisih: -1,182,594,783,132.25

  ✅ 111001 - Bank BRI Unit 1
     Saldo Lama: 15,234,567,890.12
     Saldo Baru: 5,123,456,789.00
     Selisih: -10,111,111,101.12

📈 RINGKASAN:
+----------------+--------+
| Status         | Jumlah |
+----------------+--------+
| ✅ Diupdate    | 8      |
| ⏭️  Tidak berubah | 6      |
| ❌ Error       | 1      |
| 📊 Total       | 15     |
+----------------+--------+

✅ Recalculate saldo selesai!
```

## 🔍 Troubleshooting

### Error: "There are no commands defined in the 'saldo' namespace"
**Penyebab:** Laravel belum meload command baru

**Solusi:**
```bash
# Clear cache
php artisan clear-compiled
php artisan config:clear

# Coba lagi
php artisan saldo:recalculate --dry-run
```

### Error: "php is not recognized"
**Solusi:** Pastikan PHP sudah terinstall dan ada di PATH

### Error: "Periode tidak ditemukan"
**Solusi:** Pastikan ada periode dengan status = 1 di tabel `periode`

### Saldo masih tidak sesuai setelah recalculate
**Kemungkinan:**
1. Ada transaksi yang tidak membuat jurnal_entry
2. Ada jurnal_entry yang salah
3. Ada data duplikat

**Solusi:** Jalankan query investigasi di `check_saldo_query.sql`

## 📞 Butuh Bantuan?

Lihat dokumentasi lengkap di: `ANALISIS_MASALAH_SALDO.md`
