# Panduan deploy landing page (production)

Landing page ini adalah aplikasi **Node.js (Next.js 16)**. Tidak bisa dijalankan hanya sebagai file PHP statis.

**Node wajib ≥ 20.9** (lihat `engines` di `package.json` / Next.js). **Node v16 tidak bisa** menjalankan `npm run build` proyek ini — upgrade dulu di VPS.

Apache atau Nginx di depan sebagai **reverse proxy** ke proses Next (`next start`, biasanya port **3000**).

Bridge kuota (**`quota.php`**) tetap di hosting Simdiklat; landing page memanggilnya lewat HTTPS.

---

## 1. Yang perlu disiapkan

| Item | Keterangan |
|------|------------|
| Server | VPS + **Node.js 20.9+** (bukan v16) |
| Web server | **Apache** (mod_proxy) atau Nginx |
| Domain | Subdomain resmi, mis. `seminar.bgtkntb.kemendikdasmen.go.id` |
| SSL | Let's Encrypt (certbot / certbot apache) |
| Bridge | `quota.php` + `quota-config.php` sudah aktif di server Simdiklat |
| Token | `QUOTA_REMOTE_SECRET` sama dengan `token` di `quota-config.php` |

---

## 1b. Upgrade Node di VPS (dari v16)

Proyek ini **tidak jalan di Node 16**. Contoh pakai **nvm** (user deploy, bukan root jika tidak perlu):

```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc   # atau ~/.zshrc
nvm install 20
nvm use 20
node -v            # harus v20.9.0 atau lebih baru
```

Atau [NodeSource](https://github.com/nodesource/distributions) untuk Node 20.x. Setelah itu, `npm ci` dan `npm run build` pakai Node yang sama (PM2 juga harus memakai Node 20 — jalankan `pm2` setelah `nvm use 20`, atau set `interpreter`).

---

## 2. Upload kode ke server

**Opsi A — Git (disarankan)**

```bash
# Di server
git clone <url-repositori-anda> /var/www/seminar-gtk
cd /var/www/seminar-gtk
npm ci
```

**Opsi B — ZIP**

1. Di komputer: `npm ci && npm run build` (opsional, bisa build di server).
2. Upload folder proyek **tanpa** `node_modules` dan tanpa `.env.local`.
3. Di server: `npm ci` lalu `npm run build`.

Jangan upload: `.env.local`, `node_modules`, `.next` dari mesin lain (lebih aman build di server).

---

## 3. Environment production

Next.js memuat **`.env.production`** saat `npm run build` dan `npm start` jika `NODE_ENV=production`. Alternatif: variabel sistem / PM2 `env` (jangan commit rahasia):

```env
NODE_ENV=production

SITE_URL=https://seminar.bgtkntb.kemendikdasmen.go.id

SIMDIKLAT_OFFLINE_URL=https://bgtkntb.kemendikdasmen.go.id/app/berajah//home/detail/102
SIMDIKLAT_ONLINE_URL=https://bgtkntb.kemendikdasmen.go.id/app/berajah//home/detail/103

# Kuota via bridge (tanpa MySQL langsung)
QUOTA_SOURCE=remote
QUOTA_REMOTE_URL=https://bgtkntb.kemendikdasmen.go.id/app/berajah/public/quota.php
QUOTA_REMOTE_SECRET=<token_sama_dengan_quota-config.php>

QUOTA_TABLE=pendaftaran
QUOTA_ACTIVITY_COLUMN=id_kegiatan
QUOTA_ACTIVITY_ID=102
QUOTA_ACTIVITY_ID_ONLINE=103
QUOTA_TOTAL=150
QUOTA_CACHE_TTL_SECONDS=45
```

**Jangan** set `QUOTA_MOCK_REGISTERED` di production.

---

## 4. Build dan jalankan

```bash
cd /var/www/seminar-gtk
npm run build
npm run start
# default port 3000
```

Uji dari server:

```bash
curl -s http://127.0.0.1:3000/api/health
curl -s http://127.0.0.1:3000/api/quota/offline
```

Harus `database: ok` dan JSON kuota.

---

## 5. PM2 (agar jalan terus)

```bash
npm install -g pm2
cd /var/www/seminar-gtk
pm2 start npm --name "seminar-gtk" -- start
pm2 save
pm2 startup
```

Setelah deploy baru:

```bash
git pull
npm ci
npm run build
pm2 restart seminar-gtk
```

---

## 6a. Apache + HTTPS (VPS Anda)

Aktifkan modul proxy (Debian/Ubuntu):

```bash
sudo a2enmod proxy proxy_http headers ssl rewrite
sudo systemctl restart apache2
```

Buat VirtualHost (ganti domain dan path sertifikat SSL):

```apache
<VirtualHost *:80>
    ServerName seminar.bgtkntb.kemendikdasmen.go.id
    Redirect permanent / https://seminar.bgtkntb.kemendikdasmen.go.id/
</VirtualHost>

<VirtualHost *:443>
    ServerName seminar.bgtkntb.kemendikdasmen.go.id

    SSLEngine on
    SSLCertificateFile    /etc/letsencrypt/live/seminar.../fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/seminar.../privkey.pem

    ProxyPreserveHost On
    ProxyPass / http://127.0.0.1:3000/
    ProxyPassReverse / http://127.0.0.1:3000/

    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-Forwarded-For "%{REMOTE_ADDR}s" env=REMOTE_ADDR
</VirtualHost>
```

```bash
sudo apache2ctl configtest && sudo systemctl reload apache2
sudo certbot --apache -d seminar.bgtkntb.kemendikdasmen.go.id
```

**Penting:** jangan arahkan DocumentRoot ke folder `.next` — seluruh lalu lintas harus ke **proxy** port 3000.

Jika port 3000 sudah dipakai, jalankan Next dengan `PORT=3001 npm start` dan sesuaikan `ProxyPass`.

---

## 6b. Nginx + HTTPS (alternatif)

Ganti `seminar.bgtkntb.kemendikdasmen.go.id` sesuai domain Anda.

```nginx
server {
    listen 80;
    server_name seminar.bgtkntb.kemendikdasmen.go.id;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name seminar.bgtkntb.kemendikdasmen.go.id;

    # ssl_certificate ... (certbot)

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

```bash
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d seminar.bgtkntb.kemendikdasmen.go.id
```

---

## 7. Checklist sebelum go-live

- [ ] Domain mengarah ke IP VPS (DNS A record)
- [ ] HTTPS aktif
- [ ] `SITE_URL` sesuai domain production
- [ ] Bridge `quota.php` mengembalikan `registered` dan `registered_online`
- [ ] Modal luring & daring, kuota, dan foto narasumber (jika sudah di-upload)
- [ ] Uji di **ponsel**: menu, modal, kartu pendaftaran, scroll halus
- [ ] Kedua URL Simdiklat detail/102 dan /103 bisa dibuka

---

## 8. Laravel Herd (lokal)

Herd di Mac hanya untuk development (`npm run dev`). Production tetap di VPS seperti di atas. Bisa memakai Herd untuk preview lokal di `http://landingseminar.test` jika folder ada di `~/Herd/`.

---

## 9. Pemecahan masalah

| Gejala | Solusi |
|--------|--------|
| Kuota kosong / error | Cek `QUOTA_REMOTE_URL`, token, dan upload ulang `quota.php` (versi dengan `registered_online`) |
| 502 Bad Gateway | Pastikan `pm2 status` running, port 3000 |
| Mock kuota muncul di prod | Hapus `QUOTA_MOCK_REGISTERED` dari env server |