====================================================================
         PANDUAN INSTALASI CEPAT - DASHBOARD PIUTANG
====================================================================

🎯 LANGKAH SINGKAT:

1. EXTRACT semua file ke folder web server Anda
   Contoh: C:\xampp\htdocs\piutang-dashboard\
   
2. BUKA browser dan akses:
   http://localhost/piutang-dashboard/
   
3. SELESAI! Dashboard sudah bisa digunakan.

====================================================================

📁 DAFTAR FILE:

✓ index.php                    - Dashboard utama
✓ data_config.php              - Konfigurasi dan data
✓ api.php                      - API untuk AJAX
✓ export.php                   - Handler export data
✓ import.php                   - Handler import data
✓ download_template.php        - Download template Excel
✓ Template_Import_Piutang.xlsx - Template untuk import
✓ README.md                    - Dokumentasi lengkap

====================================================================

🚀 FITUR YANG TERSEDIA:

1️⃣  DASHBOARD INTERAKTIF
    → Pilih periode tahun ajaran
    → Lihat statistik real-time
    → Grafik visualisasi
    → Tabel detail dengan expand/collapse
    
2️⃣  EXPORT DATA
    → Klik tombol "Export" di header
    → Data otomatis terdownload dalam format Excel/CSV
    
3️⃣  IMPORT DATA
    → Klik tombol "Import" di header  
    → Upload file Excel/CSV
    → Download template jika perlu
    
====================================================================

💡 TIPS PENGGUNAAN:

• Untuk menambah periode baru:
  Edit file data_config.php, tambahkan di array $periods
  
• Untuk menambah data sekolah:
  Edit file data_config.php, tambahkan di array $dataByPeriod
  
• Untuk menggunakan import:
  Download template Excel terlebih dahulu
  Isi data sesuai format
  Upload melalui halaman import

====================================================================

📊 FORMAT DATA:

Struktur data di Excel/CSV:
┌────┬─────────────────┬────────────┬────────────┬─────────┐
│ No │ Unit Sekolah    │ Target     │ Capaian    │ Dst...  │
├────┼─────────────────┼────────────┼────────────┼─────────┤
│ 1  │ SDJ BATAM       │ 2850000000 │ 2750000000 │ ...     │
│    │ → SPP           │ 2400000000 │ 2350000000 │ ...     │
│    │ → UANG PANGKAL  │ 450000000  │ 400000000  │ ...     │
└────┴─────────────────┴────────────┴────────────┴─────────┘

PENTING:
✓ Detail jenis ditandai dengan "→" di awal
✓ Angka tanpa titik/koma (misal: 2850000000)
✓ Piutang & Persentase dihitung otomatis

====================================================================

⚠️ TROUBLESHOOTING:

❌ Dashboard tidak muncul?
   → Pastikan semua file di folder yang sama
   → Pastikan web server (Apache) sudah jalan
   → Cek apakah PHP terinstall dengan baik
   
❌ Export tidak berfungsi?
   → Gunakan export CSV sebagai alternatif
   → Pastikan folder memiliki permission write
   
❌ Import gagal?
   → Periksa format file sesuai template
   → Pastikan angka tanpa format currency
   → Download dan gunakan template yang disediakan

====================================================================

📞 BANTUAN:

Dokumentasi lengkap: Baca file README.md
Template Excel: Template_Import_Piutang.xlsx

====================================================================

Version: 5.0 | Last Updated: January 2025

====================================================================
