# 📦 PANDUAN INSTALASI — Aplikasi SPP Sekolah

Terima kasih telah membeli **Aplikasi SPP Sekolah**. Ikuti langkah berikut. Cukup 5–10 menit.

---

## ✅ Kebutuhan
- **XAMPP** (PHP 8.2 atau lebih baru) — unduh gratis di https://www.apachefriends.org
- Sudah termasuk semua library (folder `vendor`), **tidak perlu Composer**.

> Semua contoh di bawah memakai XAMPP di `C:\xampp`. Sesuaikan bila lokasi Anda berbeda.

---

## 🚀 Langkah Instalasi

### 1) Ekstrak
Ekstrak folder aplikasi ini ke mana saja, contoh: `C:\xampp\htdocs\spp`.

### 2) Nyalakan XAMPP
Buka **XAMPP Control Panel** → klik **Start** pada **Apache** dan **MySQL**.

### 3) Buat & Impor Database
1. Buka browser: **http://localhost/phpmyadmin**
2. Klik tab **Import** (Impor) di atas.
3. Pilih file **`database.sql`** (ada di dalam folder aplikasi ini).
4. Klik **Go / Kirim**.

> File ini otomatis membuat database bernama **`spp_single`** beserta semua datanya. Selesai — tidak perlu buat database manual.

### 4) Cek Pengaturan (.env)
Buka file **`.env`** di folder aplikasi dengan Notepad. Untuk XAMPP standar (MySQL user `root` tanpa password) **tidak perlu diubah**.
Jika MySQL Anda memakai password, ubah baris ini:
```
DB_PASSWORD=passwordanda
```

### 5) Jalankan Aplikasi
Buka **Command Prompt (CMD)** di folder aplikasi:
- Klik kanan di dalam folder sambil tekan **Shift** → **Open in Terminal / Buka jendela perintah di sini**, atau ketik `cmd` di address bar Windows Explorer folder tersebut.

Lalu jalankan **dua perintah** ini (satu per satu):

```
C:\xampp\php\php.exe artisan storage:link
C:\xampp\php\php.exe artisan serve
```

- Perintah **pertama** membuat tautan agar logo/QRIS/bukti pembayaran tampil. Cukup dijalankan **sekali**.
- Perintah **kedua** menjalankan aplikasi.

### 6) Buka Aplikasi
Buka browser ke alamat yang muncul, biasanya:
**http://127.0.0.1:8000**

---

## 🔑 Login Pertama

| Peran | Username | Password |
|-------|----------|----------|
| **Admin** (akses penuh) | `admin` | `admin123` |
| **Petugas** (loket) | `petugas` | `petugas123` |

> **Segera ganti password** setelah login (menu **Ganti Sandi**).

Login juga bisa: buka **http://127.0.0.1:8000** → halaman login.
Portal orang tua (cek tagihan): **http://127.0.0.1:8000/portal**

---

## 🛡️ Setelah Terpasang (Disarankan)
1. **Ganti password** akun admin & petugas.
2. Buka menu **Data Sekolah** → isi identitas sekolah, tarif SPP, logo, QRIS/rekening, template WhatsApp.
3. Hapus data siswa contoh, lalu **impor data siswa Anda** (menu Data Siswa → Impor → unggah Excel).
4. (Opsional, untuk keamanan lebih) buat kunci aplikasi baru:
   ```
   C:\xampp\php\php.exe artisan key:generate
   ```

---

## 🧰 Solusi Masalah Umum

**Halaman error / blank (500)**
- Pastikan Apache & MySQL menyala.
- Pastikan database `spp_single` sudah diimpor.
- Jalankan: `C:\xampp\php\php.exe artisan optimize:clear`

**"could not find driver"**
- Aktifkan `pdo_mysql` di `C:\xampp\php\php.ini` (biasanya sudah aktif). Restart Apache.

**Logo/QRIS/bukti tidak muncul**
- Jalankan sekali: `C:\xampp\php\php.exe artisan storage:link`

**Ingin akses tanpa `artisan serve` (lewat Apache)**
- Taruh folder di `C:\xampp\htdocs\`, lalu buka `http://localhost/NAMAFOLDER/public`
- Tetap perlu menjalankan `storage:link` sekali.

---

Butuh bantuan? Lihat **PANDUAN-PENGGUNAAN.md** untuk cara memakai setiap fitur.