========================================================================
PANDUAN LENGKAP INSTALASI & DEPLOYMENT cPANEL / HOSTING
YAYASAN KOALISI PEREMPUAN INDONESIA PEDULI AL-AQSA (KPIPA)
Domain Target: https://kpipa.my.id
Standar Akuntansi: ISAK 35 & PSAK 109
File Paket: kpipa-my-id-full-package.zip
========================================================================

Aplikasi web dan sistem akuntansi keuangan nirlaba ini dibangun menggunakan:
- PHP Native 8.0+ (Sangat ringan, support semua shared hosting & VPS)
- MySQL / MariaDB dengan koneksi PDO aman (Anti SQL Injection)
- CSS3 Emerald & Gold (#0A5C36, #C5A059) & Vanilla JavaScript responsif
- Tanpa dependensi runtime berat (Langsung jalan di cPanel / DirectAdmin).

------------------------------------------------------------------------
LANGKAH 1: UPLOAD FILE KE PUBLIC_HTML cPANEL
------------------------------------------------------------------------
1. Login ke cPanel hosting Anda (misal: cpanel.kpipa.my.id).
2. Pilih menu "File Manager".
3. Masuk ke folder root domain: `public_html/`
4. Upload file `kpipa-my-id-full-package.zip`.
5. Klik kanan file `.zip` tersebut di cPanel, lalu pilih "Extract" (Ekstrak ke public_html/).
6. Pastikan file `index.php`, folder `config/`, folder `database/`, folder `admin/`, dll berada langsung di dalam `public_html/`.

------------------------------------------------------------------------
LANGKAH 2: BUAT DATABASE MYSQL DI cPANEL
------------------------------------------------------------------------
1. Di cPanel, buka menu "MySQL Database Wizard" atau "MySQL Databases".
2. Langkah 2.1 - Buat Database Baru:
   Nama Database : kpipa_db (atau misal: username_kpipa)
3. Langkah 2.2 - Buat User Database:
   Username      : kpipa_user (atau misal: username_admin)
   Password      : (Buat password yang kuat, misal: KpipaBerkah2026!# dan CATAT)
4. Langkah 2.3 - Hubungkan User ke Database:
   Centang opsi "ALL PRIVILEGES" (Semua Hak Akses), lalu klik "Make Changes".

------------------------------------------------------------------------
LANGKAH 3: IMPORT DATABASE kpipa.sql
------------------------------------------------------------------------
Ada 2 cara mudah (pilih salah satu):

CARA A (Melalui phpMyAdmin cPanel - Paling Direkomendasikan):
1. Di cPanel, buka menu "phpMyAdmin".
2. Pilih database yang baru Anda buat (`kpipa_db`) di menu sebelah kiri.
3. Klik tab "Import" di bagian atas.
4. Klik tombol "Choose File" / "Pilih File" dan arahkan ke file:
   `database/kpipa.sql`
5. Klik tombol "Go" / "Kirim" di bagian bawah.
6. Tunggu hingga muncul notifikasi hijau "Import has been successfully finished" (19 tabel berhasil dibuat dengan akun COA ISAK 35 lengkap).

CARA B (Melalui Installer Otomatis Browser):
1. Sesuaikan dulu `config/database.php` (lihat Langkah 4).
2. Buka browser: https://kpipa.my.id/install.php
3. Masukkan username/password admin yang diinginkan, lalu klik "Mulai Instalasi Database Sekarang".

------------------------------------------------------------------------
LANGKAH 4: SESUAIKAN KONFIGURASI DATABASE
------------------------------------------------------------------------
1. Di File Manager cPanel, buka dan edit file:
   `config/database.php`
2. Sesuaikan 4 baris variabel dengan data database Anda di Langkah 2:
   
   $host = 'localhost';
   $dbname = 'NAMA_DATABASE_ANDA';    // contoh: kpipa_db
   $username = 'USER_DATABASE_ANDA';   // contoh: kpipa_user
   $password = 'PASSWORD_ANDA';        // password database Anda

3. Klik "Save Changes" (Simpan).

------------------------------------------------------------------------
LANGKAH 5: HAPUS FILE INSTALL.PHP (KEAMANAN SISTEM)
------------------------------------------------------------------------
Setelah database berhasil di-import dan web dapat dibuka:
1. Kembali ke File Manager cPanel.
2. HAPUS file: `public_html/install.php`
   (Hal ini untuk mencegah orang lain mereset ulang database Anda).

------------------------------------------------------------------------
LANGKAH 6: AKSES APLIKASI WEB & PANEL AKUNTANSI
------------------------------------------------------------------------
1. Website Publik (Donasi Online, Al-Aqsha 144 Dunum, Kuitansi Mandiri):
   👉 https://kpipa.my.id/

2. Panel Admin & Akuntansi ISAK 35:
   👉 https://kpipa.my.id/admin/

   Akun Default Super Administrator:
   - Username: admin (atau ketua_umum)
   - Password: password123

   Akun Default Bendahara / Akuntan:
   - Username: bendahara (atau akuntan)
   - Password: password123

   Akun Default Kasir Stan:
   - Username: kasir
   - Password: password123

   *Segera ubah password default Anda di menu Admin > Pengguna & Role!

------------------------------------------------------------------------
DAFTAR MODUL AKUNTANSI & KEUANGAN (ISAK 35 & PSAK 109):
------------------------------------------------------------------------
1. Ringkasan Keuangan (KPI Dashboard): Saldo riil Kas & Bank, total donasi terikat/tidak terikat, rasio amil.
2. Bagan Akun (Chart of Accounts / COA): Struktur kode 5-digit (1xxxx Aset, 2xxxx Liabilitas, 3xxxx Aset Neto, 4xxxx Pendapatan, 5xxxx Beban Program, 6xxxx Beban Amil).
3. Buku Jurnal Umum: Double-entry debit/kredit seimbang otomatis dari donasi masuk, kasir, dan manual voucher.
4. Buku Besar: Filter mutasi per rekening bank (BSI 717 888 2020, Mandiri, Muamalat, Kas Tunai) dengan saldo berjalan.
5. Laporan Posisi Keuangan (Neraca Seimbang): Aset vs Liabilitas + Aset Neto Tanpa & Dengan Pembatasan.
6. Laporan Aktivitas: Laba rugi nirlaba pemisahan terikat dan tidak terikat.
7. Laporan Arus Kas Langsung: Operasi, investasi, pendanaan.
8. Realisasi Penyaluran Gaza & Al-Quds: Monitoring anggaran vs realisasi bantuan lapangan.
9. Buku Kas Masuk (BKM) & Buku Kas Keluar (BKK): Pencetakan bukti voucher kas dan ekspor CSV/Excel.

------------------------------------------------------------------------
REKENING RESMI YAYASAN KPIPA:
------------------------------------------------------------------------
- Bank Syariah Indonesia (BSI) : 717 888 2020 a.n. Yayasan KPIPA Kemanusiaan
- Bank Mandiri                 : 131 00 2020 8888 a.n. Yayasan KPIPA Kemanusiaan
- Bank Muamalat                : 101 008 2020 a.n. Yayasan KPIPA Kemanusiaan
- QRIS Resmi KPIPA             : Mendukung semua e-wallet & mobile banking

------------------------------------------------------------------------
BANTUAN & DUKUNGAN TEKNIS:
------------------------------------------------------------------------
Email Sekretariat : sekretariat@kpipa.or.id
Email Keuangan    : keuangan@kpipa.my.id
WhatsApp Care     : +62 811-920-2020 / +62 812-8888-2020
Kantor            : Jl. Tebet Barat Dalam Raya No. 45, Jakarta Selatan 12810
========================================================================
