=============================================================
WEBSITE DONASI — PANTI ASUHAN DEWI KARUNIA INDONESIA
PHP Native + MySQL + Bootstrap 5
=============================================================

PERSYARATAN
- PHP 8.1+ disarankan; ekstensi PDO MySQL, fileinfo, session.
- MySQL 5.7+ atau MariaDB yang kompatibel.
- HTTPS wajib digunakan saat website dipublikasikan.

INSTALASI BARU
1. Buat database MySQL melalui cPanel/phpMyAdmin.
2. Impor database.sql ke database tersebut.
3. Unggah isi folder website ke document root/subfolder.
4. Edit config.php: DB_HOST, DB_NAME, DB_USER, DB_PASS. Jangan biarkan
   kredensial contoh atau password kosong.
5. Pastikan uploads/ dan uploads/private/ dapat ditulis PHP. Jangan
   memberi izin 777; gunakan 750/755 sesuai konfigurasi hosting.
6. Buat akun admin melalui terminal/SSH:
      php create_admin.php namaadmin 'KataSandiPanjangMinimal12'
   Script hanya dapat dijalankan melalui CLI. Hapus create_admin.php
   dari hosting setelah akun berhasil dibuat.
7. Login melalui /admin/login.php, lalu periksa konfigurasi kampanye.
8. Pastikan HTTPS aktif sebelum menerima donasi.

MIGRASI DARI VERSI SEBELUMNYA
- Cadangkan database dan seluruh folder uploads terlebih dahulu.
- Upload file versi baru dan perbarui config.php dengan kredensial DB lama.
- Jalankan sekali melalui SSH:
      php migrate_private_proofs.php
  Script memindahkan bukti transfer lama dari folder publik ke
  uploads/private/ dan memperbarui path di database. Hapus script
  tersebut setelah selesai.
- Akun admin lama tetap tersimpan. Login, lalu gunakan menu Ganti Sandi.
- Jangan mengimpor ulang database.sql ke database produksi karena dapat
  mengubah/menimpa data konfigurasi yang sudah ada.

KEAMANAN YANG DITERAPKAN
- Tidak ada lagi akun admin default admin/admin123 yang dibuat otomatis.
- Password admin menggunakan password_hash/password_verify.
- Pembatasan percobaan login per sesi, regenerasi ID sesi, cookie HttpOnly,
  SameSite, Secure saat HTTPS, dan strict session mode.
- Header keamanan dasar dan cache-control untuk halaman privat.
- Prepared statements PDO, output escaping, dan token CSRF.
- Bukti transfer disimpan di uploads/private/ yang ditolak akses langsung
  oleh web server; admin melihatnya melalui endpoint yang memeriksa sesi.
- Validasi upload memeriksa error, ukuran, ekstensi, MIME fileinfo,
  nama acak, dan melarang eksekusi skrip di folder uploads.
- Logout menggunakan POST + CSRF.
- Penghapusan donasi juga menghapus doa terkait dalam transaksi database.
- Pemilihan kode unik donasi diserialisasi dengan row lock pada kampanye.

CATATAN PENTING
- Aturan .htaccess memerlukan Apache. Jika hosting memakai Nginx,
  minta penyedia hosting menolak akses HTTP ke /uploads/private/.
- Jika hosting tidak menyediakan SSH/CLI, minta dukungan hosting
  menjalankan create_admin.php dan migrate_private_proofs.php melalui CLI.
- Pastikan backup rutin. Simpan bukti transfer dan data donatur sesuai
  kebijakan privasi yayasan; batasi akses hanya untuk petugas berwenang.
- Periksa konfigurasi email MAIL_FROM sebelum mengandalkan email otomatis.
- Jalankan uji coba donasi dengan nominal kecil sebelum membuka kampanye.
=============================================================


PEMBARUAN DESAIN PHP
- Tema biru dengan aksen hangat emas, animasi masuk lembut, progress shimmer,
  hover interaktif, dan dukungan prefers-reduced-motion.
- Tombol berbagi WhatsApp, Facebook, Instagram (salin tautan lalu buka Instagram),
  X, Telegram, salin tautan, serta Web Share API jika didukung browser.
- Halaman donasi menampilkan confetti setelah server berhasil menyimpan donasi
  dan bukti transfer. Status donasi tetap menunggu verifikasi admin.
- Menu Ganti Sandi tersedia di navigasi dashboard admin (password.php).

PENTING UNTUK VERSI LOKAL
- Gunakan salinan folder baru di C:\xampp\htdocs agar versi lama tetap aman.
- Salin config.php lama milik Anda ke folder baru hanya setelah membandingkan
  pengaturan database. Jangan menimpa database yang sudah berisi data.
- Pastikan akun admin lokal memiliki hash password yang valid; versi aman tidak
  membuat akun admin default otomatis. Gunakan akun yang sudah berhasil diuji.
- Instagram tidak menyediakan URL web standar untuk membagikan tautan secara
  langsung; tombol Instagram menyalin tautan dan membuka Instagram untuk ditempel.
- Belum dipublikasikan ke internet. Hosting, DNS domain, HTTPS, dan kredensial
  produksi harus dikonfigurasi oleh pemilik sebelum situs menerima donasi online.
