# Hotfix Restore Database v1.3.5

Hotfix ini bersifat kumulatif. Seluruh fitur backup database dan ekspor rincian donasi v1.3.4 tetap tersedia.

## Fitur restore

- Form **Restore database** pada menu **Dashboard > Cadangan & ekspor**.
- Hanya Super Admin yang dapat menjalankan restore dan mengunduh backup pengaman.
- Wajib memasukkan kata sandi Super Admin dan mengetik `PULIHKAN`.
- Hanya menerima file `.sql` maksimal 50 MB yang memiliki identitas backup aplikasi Amanah dan driver database yang sama.
- Sebelum data diganti, sistem otomatis menyimpan backup pengaman database aktif.
- Maksimal lima backup pengaman terbaru dipertahankan di `storage/app/private/backups`.
- Restore bersamaan dikunci agar dua proses tidak berjalan pada waktu yang sama.
- Riwayat restore disimpan secara privat di luar database sehingga tetap tersedia setelah database dipulihkan.

## Rincian riwayat

Riwayat menampilkan:

- nama file restore;
- tanggal dan waktu file backup dibuat;
- tanggal dan waktu restore hingga detik dalam WIB;
- nama petugas;
- ukuran file dan potongan checksum SHA-256;
- status berhasil atau gagal;
- nama serta tautan unduhan backup pengaman sebelum restore.

## Instalasi di cPanel

1. Backup database dan file aplikasi yang sedang aktif.
2. Unggah ZIP hotfix ke folder utama Laravel yang berisi `artisan`.
3. Ekstrak dan timpa file yang sama.
4. Pastikan `storage` dan `bootstrap/cache` dapat ditulis PHP.
5. Jalankan dari Terminal cPanel:

   ```bash
   php artisan optimize:clear
   ```

6. Login sebagai Super Admin dan buka **Cadangan & ekspor**.

Tidak ada migrasi database baru.

## Cara melakukan restore

1. Unduh backup database terbaru terlebih dahulu.
2. Pada bagian **Restore database**, pilih file SQL hasil backup aplikasi.
3. Masukkan kata sandi Super Admin.
4. Ketik `PULIHKAN`, lalu tekan **Restore database**.
5. Tunggu hingga pesan berhasil muncul dan periksa baris baru pada **Riwayat restore**.
6. Periksa transaksi, pengaturan payment gateway, akun pengguna, dan laporan setelah restore.

## Catatan penting

- Jangan mengunggah file SQL dari sumber yang tidak dipercaya.
- Jangan menutup browser atau menjalankan restore kedua selama proses berlangsung.
- Restore database tidak memulihkan gambar, favicon, bukti transfer, atau file lain di folder `storage/app`. File tersebut harus dicadangkan dan dipulihkan terpisah.
- Gunakan `.env` dan `APP_KEY` yang sama dengan backup agar data terenkripsi tetap dapat dibaca.
- Backup pengaman bersifat rahasia dan tidak boleh ditempatkan di folder publik.

