# Panduan cPanel — MBIZ NETWORK PHP Native

Paket PHP native ini dapat diunggah dan diedit manual melalui **File Manager** cPanel. Gunakan PHP 8.1 atau lebih baru dengan ekstensi `pdo_mysql`, `curl`, `mbstring`, dan `fileinfo` aktif.

## Struktur penempatan

Untuk keamanan, unggah paket ke direktori di luar `public_html`, misalnya `/home/CPANEL_USER/mbiz-network`. Kemudian arahkan **Document Root** domain atau subdomain ke folder `/home/CPANEL_USER/mbiz-network/public` melalui menu **Domains** di cPanel.

```text
/home/CPANEL_USER/mbiz-network/
├── .env                  ← dibuat dari CPANEL_ENVIRONMENT_TEMPLATE.txt; jangan ditempatkan di public/
├── public/               ← Document Root domain
│   ├── .htaccess
│   ├── index.php
│   ├── assets/
│   └── storage/          ← harus dapat ditulis oleh PHP
├── src/                  ← logika PHP yang dapat diedit manual
├── drizzle/              ← migrasi basis data MySQL
└── CPANEL_DEPLOY.md
```

Jika hosting hanya mengizinkan `public_html` sebagai document root utama, letakkan `src/` dan `.env` satu tingkat di atasnya, lalu salin **isi** folder `public/` ke `public_html/`. Jalur `../src/App.php` pada `public/index.php` harus tetap menunjuk ke folder `src/` yang berada di luar web root.

## Konfigurasi database dan akun admin

Buat database serta pengguna MySQL melalui **MySQL Databases**, lalu berikan seluruh hak akses database kepada pengguna tersebut. Salin `.env.example` menjadi `.env`, isi `DATABASE_URL`, dan tetapkan kredensial Super Admin yang kuat. Format koneksi adalah `mysql://PENGGUNA:KATA_SANDI@HOST:PORT/NAMA_DATABASE`; karakter khusus di pengguna atau kata sandi harus dienkode untuk URL.

Impor seluruh berkas SQL pada folder `migrations/` sesuai urutan dalam `MIGRATION_ORDER.txt` melalui phpMyAdmin. Berkas migrasi membentuk tabel aplikasi, inventaris, audit, recycle bin, dan konfigurasi retensi. Lakukan pencadangan database sebelum menjalankan migrasi pada instalasi yang sudah memiliki data.

## Penyimpanan file lokal

Mode cPanel memakai folder `public/storage/` untuk file unggahan. Pastikan folder tersebut dibuat dan memiliki izin tulis yang sesuai untuk proses PHP, umumnya `775` pada hosting yang menggunakan group permission. Nilai `LOCAL_STORAGE_PATH` pada `.env` harus menunjuk ke folder tersebut secara absolut.

## Pengeditan dan pemeliharaan

Halaman publik berada terutama di `src/App.php` dan gaya di `public/assets/app.css`. Anda dapat mengedit keduanya langsung melalui File Manager cPanel atau editor lokal, lalu unggah ulang berkas yang berubah. Jangan mengunggah `node_modules/`, `dist/`, `.git/`, `.env` berisi nilai asli, atau log pengembangan ke hosting.

> Fitur pengingat terjadwal yang sebelumnya memakai layanan terkelola perlu dijadwalkan ulang sesuai kebijakan hosting cPanel. Situs publik, autentikasi lokal, inventaris, unggahan file lokal, dan pengelolaan dasar tetap dapat dioperasikan dari paket PHP ini setelah database dan `.env` dikonfigurasi.