=====================================================================
 PANDUAN UPLOAD TARQIA STUDENT KE HOSTING (cPanel / shared hosting)
=====================================================================

Kebutuhan hosting:
  - PHP 8.2 atau lebih baru (atur di cPanel > Select PHP Version)
  - Ekstensi PHP: intl, mbstring, mysqli, json (biasanya sudah aktif)
  - MySQL 5.7+ / MariaDB 10.3+

Isi zip:
  tarqia_app/     -> kode aplikasi (JANGAN taruh di dalam public_html)
  public_html/    -> file yang bisa diakses publik (index.php, assets)
  database.sql    -> struktur tabel + pengaturan awal + akun admin

---------------------------------------------------------------------
LANGKAH 1 - Buat database
---------------------------------------------------------------------
1. cPanel > MySQL Databases:
   - buat database baru (mis. namauser_tarqia)
   - buat user database + password
   - tambahkan user ke database dengan ALL PRIVILEGES
2. cPanel > phpMyAdmin > pilih database tadi > tab Import
   > pilih database.sql > Go.

---------------------------------------------------------------------
LANGKAH 2 - Upload file
---------------------------------------------------------------------
1. cPanel > File Manager > buka folder HOME (/home/namauser/),
   yaitu folder yang berisi public_html.
2. Upload tarqia-hosting.zip ke folder HOME tersebut, lalu Extract.
3. Hasilnya:
     /home/namauser/tarqia_app/
     /home/namauser/public_html/   (isi index.php, .htaccess, assets/)
   Jika public_html sudah berisi website lain, backup dulu.
   (database.sql dan PANDUAN-UPLOAD.txt boleh dihapus setelah selesai.)

   Catatan: aktifkan "Show Hidden Files" di File Manager agar file
   .htaccess dan .env terlihat.

---------------------------------------------------------------------
LANGKAH 3 - Isi konfigurasi
---------------------------------------------------------------------
Edit file  tarqia_app/.env  lalu ganti:
   app.baseURL               = 'https://domain-anda.com/'   (akhiri dengan /)
   database.default.database = nama database dari langkah 1
   database.default.username = user database
   database.default.password = password database

Jika domain sudah HTTPS, boleh ubah:
   app.forceGlobalSecureRequests = true

---------------------------------------------------------------------
LANGKAH 4 - Izin folder
---------------------------------------------------------------------
Folder  tarqia_app/writable  (beserta isinya) harus bisa ditulis
server: permission 755 untuk folder (atau 775 jika masih error).

---------------------------------------------------------------------
LANGKAH 5 - Coba buka
---------------------------------------------------------------------
Buka https://domain-anda.com/ lalu login dengan akun admin
yang sama seperti di komputer lokal. SEGERA ganti password
lewat menu Akun.

---------------------------------------------------------------------
Jika aplikasi dipasang di SUBDOMAIN / folder lain
---------------------------------------------------------------------
Misal document root subdomain = /home/namauser/tarqia.domain.com/
  - salin ISI folder public_html/ dari zip ke folder tersebut
    (bukan ke public_html utama)
  - tarqia_app/ tetap di /home/namauser/tarqia_app/
    -> karena sejajar, index.php tidak perlu diubah.
  - Jika letaknya lebih dalam, mis. /home/namauser/public_html/tarqia/,
    edit index.php di folder itu:
      require FCPATH . '../../tarqia_app/app/Config/Paths.php';
  - app.baseURL di .env = 'https://tarqia.domain.com/'

---------------------------------------------------------------------
Masalah umum
---------------------------------------------------------------------
- Halaman putih / error 500:
    cek tarqia_app/writable/logs/ untuk pesan error, pastikan
    versi PHP >= 8.2 dan writable bisa ditulis.
- "Unable to connect to the database": cek isi .env (langkah 3).
- Login berhasil tapi menu error "Server error (404)":
    pastikan file public_html/.htaccess ikut ter-upload dan
    app.baseURL sesuai domain (termasuk https dan / di akhir).
- Musik login tidak bunyi: browser memblokir autoplay; klik tombol
    "Putar Musik" (perilaku normal).

Memindahkan data dari Google Spreadsheet:
  Lakukan di komputer lokal (php spark tarqia:import <folder-csv>),
  lalu jalankan build-hosting.ps1 lagi untuk membuat database.sql
  terbaru. Atau export tabel dari phpMyAdmin lokal dan import ke hosting.
