# Persiapan instalasi baru di cPanel

Panduan ini untuk database baru dan belum menggantikan pengujian pada hosting. Kemampuan Application Manager/Setup Node.js, SSH/Terminal, versi Node.js, serta izin MySQL berbeda menurut penyedia. Pastikan Node.js memenuhi `engines` pada package.json, tersedia HTTPS dan domain, serta akun database memiliki hak untuk membuat dan mengubah tabel, indeks, dan constraint. Tanyakan juga apakah hosting menyediakan mysqldump, proses latar belakang yang terus berjalan, dan backup di lokasi terpisah.

Jangan kirim password, token, atau kunci enkripsi melalui chat. Jangan memakai instruksi ini untuk database yang sudah memiliki data operasional.

## Persiapan

1. Buat database dan pengguna database baru melalui cPanel, lalu berikan hak pada database tersebut. Catat nama database lengkap yang diberikan cPanel (termasuk prefix).
2. Siapkan aplikasi di direktori privat di luar `public_html`, dengan struktur paket tetap utuh. Konfigurasi web harus meneruskan permintaan aplikasi ke Node.js; jangan mempublikasikan folder `backend`, `.env`, `storage`, atau backup sebagai file statis. Pastikan domain memiliki HTTPS sebelum login.
3. Gunakan `app.js` di root sebagai startup file apabila sesuai dengan mekanisme Node.js hosting. File tersebut menjalankan backend dengan working directory `backend`; Node.js, Passenger, domain dan routing tetap harus diuji pada hosting.
4. Salin `backend/.env.example` menjadi `backend/.env` di server, atur `NODE_ENV=production`, `DB_HOST`, `DB_PORT`, `DB_NAME`, `DB_USER`, dan password database yang unik. Buat `APP_ENCRYPTION_KEY` acak dan rahasia minimal 24 karakter; simpan cadangan kunci secara aman karena data terenkripsi memerlukannya. Atur direktori storage yang bisa ditulis. Jangan menggunakan nilai contoh sebagai kredensial.
5. Instal dependensi dari lockfile di lingkungan Node.js yang disediakan hosting. Verifikasi berkas paket menggunakan `node scripts/verify-release.cjs .` sebelum menambahkan konfigurasi atau dependensi ke direktori paket, karena verifier menolak berkas tambahan.

## Inisialisasi database baru

Perintah berikut membutuhkan Terminal/SSH di server, setelah menguji pada database UAT baru dan memeriksa hak akses database. Proses migrasi proyek melakukan lebih dari pembuatan tabel; cadangkan database terlebih dahulu dan jangan menjalankannya pada database lain.

Dari direktori `backend`:

```sh
NODE_ENV=production DB_PRECREATED=1 node database/migrate.js
read -r -s -p 'Password awal Super Admin: ' INITIAL_ADMIN_PASSWORD; echo
export INITIAL_ADMIN_PASSWORD
NODE_ENV=production node database/seed.js
unset INITIAL_ADMIN_PASSWORD
NODE_ENV=production DB_PRECREATED=1 node database/migrate.js
NODE_ENV=production node scripts/preflight.js
```

Password awal harus minimal 12 karakter, mengandung huruf dan angka, dan maksimal 72 byte. Input tidak ditampilkan di terminal dan tidak boleh disimpan dalam file konfigurasi. Proses seed produksi menolak database dengan pengguna atau data operasional yang sudah ada. Jika inisialisasi terhenti, jangan mengulang seed secara membabi buta: periksa database dan pulihkan database UAT baru atau ikuti prosedur pemulihan yang telah diuji.

Migrasi dijalankan kembali setelah seed karena sebagian hak akses untuk role dasar bergantung pada role yang dibuat saat seed. Jangan menjalankan seed sebagai bagian dari update rutin. Selanjutnya masuk sebagai `superadmin` melalui HTTPS, pastikan password dan hak akses, lalu buat akun serta data master yang diperlukan.

## Sebelum membuka akses pengguna

Pastikan `/api/ready` berhasil, uji login dan setiap role, tiket hingga verifikasi, material, OPS, absensi (kamera/GPS membutuhkan HTTPS), penyimpanan dan unduhan bukti, notifikasi serta backup dan restore pada lingkungan terpisah. Konfirmasi worker dan backup otomatis tetap berjalan sesuai kebijakan hosting; aplikasi yang dihentikan ketika idle tidak dapat menjamin jadwal. Simpan backup database, storage unggahan, dan konfigurasi/kunci di lokasi terpisah yang aman.
