# Instalasi Backend AI Agent V6.4

## Isi pembaruan

- AI Agent personal dengan pemisahan data faktual, hipotesis, dan rekomendasi.
- Next-best-action sesuai pola pengguna.
- Analitik shalat, Qur'an, dzikir, komunitas, dan Hafidz.
- Sinkronisasi Hafidz lintas perangkat.
- Retrieval Al-Umm Jilid 2 dengan referensi halaman PDF dan halaman buku.

## 1. Backup

Backup folder backend produksi dan export database MySQL melalui phpMyAdmin.

## 2. Upload

Upload isi folder `backend/` ke document root backend produksi:

`/home/USERNAME/sakinah.bgsx.biz.id/backend/`

Pertahankan `config.php` produksi. Paket ini tidak menyertakan file tersebut.

## 3. Aktifkan token upgrade

Isi sementara pada `backend/config.php`:

```php
'install_token' => 'TOKEN_ACAK_PANJANG',
```

## 4. Jalankan migrasi

Buka:

`https://sakinah.bgsx.biz.id/backend/upgrade_v640.php?token=TOKEN_ACAK_PANJANG`

Hasil yang benar memuat `"ok":true` dan `"version":"6.4.0"`.

## 5. Import knowledge Al-Umm

Mulai import:

`https://sakinah.bgsx.biz.id/backend/knowledge_import.php?token=TOKEN_ACAK_PANJANG&reset=1&limit=150`

Respons memberi `next_url`. Buka `next_url` berulang sampai:

```json
{"complete":true,"progress_percent":100}
```

Terdapat 961 potongan pengetahuan. Pada shared hosting, proses sengaja dilakukan bertahap agar tidak timeout.

## 6. Verifikasi

Buka:

- `https://sakinah.bgsx.biz.id/backend/health.php`
- `https://sakinah.bgsx.biz.id/backend/ai-chat.php`
- `https://sakinah.bgsx.biz.id/backend/admin/knowledge.php`

Health ideal menunjukkan:

- versi 6.4.0;
- knowledge source aktif;
- jumlah knowledge chunk 961;
- Hafidz analytics ready.

## 7. Kunci kembali

Setelah import selesai:

1. Hapus `upgrade_v640.php`.
2. Hapus `knowledge_import.php`.
3. Hapus atau blokir `migration_v640.php` dari akses publik.
4. Kosongkan kembali `install_token`.
5. Pastikan permission file 0644 dan folder 0755.

## Uji AI

Gunakan akun yang sudah memiliki data, lalu uji:

- `Analisis pola ibadah saya 30 hari dan pilih satu fokus utama.`
- `Buat rencana Hafidz dan murajaah selama tujuh hari.`
- `Jelaskan waktu shalat Ashar menurut Imam Asy-Syafi'i dan sertakan halaman sumber.`
- `Apa tindakan terbaik yang realistis untuk saya lakukan hari ini?`

Jawaban fiqih yang berdampak pada praktik personal tetap perlu dikonfirmasi kepada ustadz atau ulama yang kompeten. Hasil OCR kitab harus ditinjau bila dipakai sebagai materi publik.