================================================================================
PANDUAN DEPLOYMENT & INSTALASI CPANEL / HOSTING
SISTEM INFORMASI PEMBAYARAN SISWA
MA BAHRUL ULUM KECAMATAN KEPOHBARU KABUPATEN BOJONEGORO
================================================================================

A. PERSYARATAN SERVER / HOSTING (cPanel)
--------------------------------------------------------------------------------
1. Web Server   : Apache / LiteSpeed / Nginx
2. Versi PHP    : PHP 8.1 atau PHP 8.2 (Disarankan PHP 8.2)
3. Ekstensi PHP : 
   - pdo, pdo_mysql (Wajib untuk database)
   - mbstring, openssl (Keamanan enkripsi & string)
   - gd (Pengolahan foto siswa & logo)
   - curl (Pengiriman notifikasi WhatsApp MPWA)
   - fileinfo (Validasi upload berkas)
   - zip (Ekspor/impor berkas)
4. Database     : MySQL 5.7+ / MySQL 8.x / MariaDB 10.3+

B. LANGKAH-LANGKAH INSTALASI DI CPANEL
--------------------------------------------------------------------------------
1. Masuk ke cPanel Hosting Anda.
2. Buka menu "MySQL Database Wizard" atau "Databases":
   - Buat database baru, contoh: u123456_mabu_pay
   - Buat user database baru, contoh: u123456_admin
   - Buat password yang kuat dan catat.
   - Berikan hak akses penuh (ALL PRIVILEGES) kepada user tersebut pada database.

3. Import Skema Database:
   - Buka menu "phpMyAdmin" di cPanel.
   - Pilih database yang baru dibuat.
   - Klik tab "Import", pilih berkas `database/database.sql` yang ada di dalam paket zip ini, lalu klik "Go / Kirim".

4. Upload Berkas ke File Manager:
   - Buka menu "File Manager" di cPanel.
   - Masuk ke folder root domain Anda (biasanya `public_html` atau subdomain folder `sub.domain.sch.id`).
   - Upload berkas ZIP ini (`ma_bahrul_ulum_payment_cpanel.zip`).
   - Klik kanan pada berkas zip, pilih "Extract".
   - Pastikan berkas `.htaccess` dan `index.php` berada langsung di dalam `public_html`.

5. Konfigurasi Koneksi Database:
   - Di File Manager, buka berkas `config/database.php`.
   - Sesuaikan konstanta berikut dengan data MySQL Anda:
     define('DB_HOST', 'localhost'); // atau 127.0.0.1
     define('DB_NAME', 'u123456_mabu_pay');
     define('DB_USER', 'u123456_admin');
     define('DB_PASS', 'PasswordDatabaseAnda');
   - Simpan perubahan.

6. Pemeriksaan Perizinan Folder (File Permissions):
   - Pastikan folder `uploads/` dan `logs/` memiliki permission 0755 atau 0775 agar dapat ditulis oleh sistem saat upload foto dan pencatatan log.

7. Akses Aplikasi di Browser:
   - Buka domain Anda: https://domainanda.sch.id
   - Anda akan langsung diarahkan ke halaman login.
   - Atau Anda dapat menggunakan installer visual otomatis di: https://domainanda.sch.id/public/install.php

C. AKUN DEMO BAWAAN (DEFAULT USERS)
--------------------------------------------------------------------------------
1. Super Administrator:
   - Username : admin
   - Password : Admin@12345
   - Akses    : Akses penuh (Master data, tagihan, pembayaran, WhatsApp, backup, audit log)

2. Bendahara Madrasah:
   - Username : bendahara
   - Password : Bendahara@12345
   - Akses    : Loket kasir, input pembayaran, cetak kuitansi, cek tagihan, laporan kas

3. Wali Siswa (Contoh):
   - Username : wali001
   - Password : Wali@12345
   - Akses    : Portal wali murid (melihat tagihan ananda, status SPP, dan unduh kuitansi)

*CATATAN KEAMANAN:
Segera ubah kata sandi akun default di atas setelah sistem berhasil dipasang di server produksi!

D. INTEGRASI WHATSAPP GATEWAY (MPWA)
--------------------------------------------------------------------------------
1. Login sebagai Super Admin.
2. Masuk ke Dashboard Admin -> WhatsApp Center.
3. Masukkan:
   - Endpoint : https://wa.pelajar.my.id/send-message (atau endpoint server MPWA Anda)
   - API Key  : Kunci API rahasia dari akun MPWA Anda
   - Sender   : Nomor WhatsApp pengirim (contoh: 6281234567890)
4. Klik "Simpan Pengaturan" dan uji koneksi melalui tombol "Kirim Pesan Test".
================================================================================