============================================================
              SISTEM KEUANGAN MUSHOLA v1.0.0
============================================================
Aplikasi web sederhana untuk mengelola keuangan mushola
dibuat dengan PHP Native dan MySQL

------------------------------------------------------------
FITUR APLIKASI:
------------------------------------------------------------
1. Login Pengguna (Admin & Bendahara)
2. Dashboard Ringkasan Keuangan
3. Pengelolaan Jenis Penerimaan & Pengeluaran
4. Penerimaan: Tambah, Edit, Hapus, Upload Bukti
5. Pengeluaran: Tambah, Edit, Hapus, Upload Bukti
6. Pengelolaan Jenis Iuran
7. Iuran Anggota: Tambah, Edit, Hapus, Status, Cetak
8. Laporan Keuangan dengan Filter Tanggal & Jenis
9. Cetak Laporan PDF (via browser Print to PDF)
10. Laporan Jenis Iuran Anggota
11. Pengelolaan Pengguna Sistem

------------------------------------------------------------
CARA PEMASANGAN DI HOSTING:
------------------------------------------------------------

CARA 1: Instalasi Otomatis (Disarankan)
----------------------------------------
1. Upload semua file ke folder hosting Anda
   (contoh: public_html/keuangan atau public_html)
   
2. Buat folder "uploads/bukti" dan berikan permission 755
   atau 777 jika perlu (untuk upload bukti transaksi)
   
3. Akses melalui browser:
   http://domain-anda.com/install.php
   atau
   http://domain-anda.com/keuangan/install.php
   
4. Isi konfigurasi database:
   - Host: localhost (biasanya)
   - Username: username database hosting Anda
   - Password: password database hosting Anda
   - Nama Database: keuangan_mushola (atau nama lain)
   
5. Klik "Install Sekarang" dan tunggu proses selesai

6. Setelah berhasil, hapus file "install.php" untuk keamanan

7. Login dengan akun default:
   Username: admin
   Password: admin123

8. Segera ganti password admin setelah login pertama!


CARA 2: Instalasi Manual
------------------------
1. Buat database MySQL baru di hosting

2. Import file "database.sql" ke database tersebut
   (bisa melalui phpMyAdmin)

3. Edit file "config/config.php" sesuaikan dengan database Anda:
   - DB_HOST: localhost
   - DB_USER: username database
   - DB_PASS: password database
   - DB_NAME: nama database
   - APP_URL: url aplikasi Anda (contoh: https://mushola.com)

4. Upload semua file ke folder hosting

5. Buat folder "uploads/bukti" dengan permission 755

6. Akses aplikasi melalui browser
   Login default: admin / admin123


------------------------------------------------------------
STRUKTUR FOLDER:
------------------------------------------------------------
keuangan-mushola/
├── config/              # Konfigurasi aplikasi & database
│   ├── config.php       # File konfigurasi utama
│   └── database.php     # Koneksi database PDO
├── assets/              # File CSS, JS, Gambar
│   ├── css/style.css    # Stylesheet kustom
│   └── js/script.js     # Javascript kustom
├── includes/            # File include (header, footer, fungsi)
│   ├── header.php       # Header & Sidebar
│   ├── footer.php       # Footer
│   └── functions.php    # Fungsi-fungsi helper
├── auth/                # Autentikasi
│   ├── login.php        # Halaman login
│   └── logout.php       # Proses logout
├── cetak/               # File cetak laporan
│   ├── cetak_laporan_keuangan.php
│   ├── cetak_laporan_iuran.php
│   └── cetak_iuran_anggota.php
├── uploads/bukti/       # Folder upload bukti transaksi
├── index.php            # Halaman utama (redirect)
├── dashboard.php        # Dashboard
├── jenis_transaksi.php  # Jenis Penerimaan & Pengeluaran
├── penerimaan.php       # Data Penerimaan
├── pengeluaran.php      # Data Pengeluaran
├── jenis_iuran.php      # Jenis Iuran
├── iuran_anggota.php    # Data Iuran Anggota
├── laporan_keuangan.php # Laporan Keuangan
├── laporan_iuran.php    # Laporan Iuran
├── pengguna.php         # Kelola Pengguna
├── install.php          # Instalasi otomatis
├── database.sql         # Backup database
└── README.txt           # File ini


------------------------------------------------------------
PERSYARATAN SISTEM:
------------------------------------------------------------
- PHP 7.4 atau lebih baru
- MySQL 5.7 atau MariaDB 10.3
- Extension PHP: PDO, MySQLi, GD (untuk gambar)
- Web Server: Apache atau Nginx


------------------------------------------------------------
KEAMANAN:
------------------------------------------------------------
1. Selalu hapus file install.php setelah instalasi
2. Ganti password default admin segera setelah login
3. Gunakan password yang kuat (kombinasi huruf, angka, simbol)
4. Berikan permission folder uploads/bukti seperlunya (755)
5. Backup database secara berkala


------------------------------------------------------------
PETUNJUK PENGGUNAAN SINGKAT:
------------------------------------------------------------
1. Login ke aplikasi
2. Pertama kali, atur Jenis Transaksi di menu "Jenis Transaksi"
3. Atur Jenis Iuran di menu "Jenis Iuran"
4. Input data Penerimaan dan Pengeluaran sesuai transaksi
5. Input data anggota dan iurannya di menu "Iuran Anggota"
6. Lihat ringkasan di Dashboard
7. Cetak laporan di menu Laporan Keuangan / Laporan Iuran


------------------------------------------------------------
FITUR CETAK PDF:
------------------------------------------------------------
Aplikasi menggunakan fitur cetak browser. Cara menyimpan PDF:
1. Klik tombol "Cetak PDF" pada halaman laporan
2. Pada dialog print, pilih "Save as PDF" / "Simpan sebagai PDF"
3. Atur pengaturan dan simpan file PDF


------------------------------------------------------------
KONTAK & BANTUAN:
------------------------------------------------------------
Jika mengalami masalah dalam instalasi atau penggunaan:
1. Cek file config/config.php apakah konfigurasi benar
2. Cek permission folder uploads/bukti
3. Pastikan ekstensi PHP PDO aktif
4. Cek error log server untuk detail kesalahan

------------------------------------------------------------
CATATAN PENTING:
------------------------------------------------------------
- Aplikasi ini gratis dan bebas digunakan untuk keperluan
  pengelolaan keuangan mushola/masjid
- Dilarang memperjualbelikan aplikasi ini tanpa izin
- Pengembang tidak bertanggung jawab atas kerugian akibat
  penggunaan aplikasi ini

============================================================
            TERIMA KASIH - SEMOGA BERMANFAAT
============================================================