Panduan Setup WiseSherpa (Self-Hosted)

✅ Yang Perlu Disiapkan Dulu

• ✓VPS/server Linux (Ubuntu atau Debian) dengan akses SSH
• ✓Domain atau subdomain yang bisa kamu atur DNS-nya (mis. lewat Cloudflare)
• ✓API key OpenAI (dari platform.openai.com)
• ✓Kredensial OAuth Gmail dari Google Cloud Console
• ✓(Opsional, disarankan) Akun Vercel gratis untuk hosting frontend

🛠️ Tahapan Instalasi

1. 1
   Siapkan server & Docker

   SSH ke VPS kamu, lalu install Docker dan Docker Compose plugin kalau belum ada.

   curl -fsSL https://get.docker.com | sh

2. 2
   Unggah source code

   Salin folder backend dan frontend yang kamu terima ke server, taruh di direktori sendiri (mis. ~/wisesherpa) supaya tidak tercampur project lain.

   scp -r backend/ user@server:~/wisesherpa/

3. 3
   Konfigurasi backend

   Salin .env.production.example menjadi .env.production, lalu isi OPENAI_API_KEY kamu dan buat API_SHARED_SECRET acak.

   cp .env.production.example .env.production
   openssl rand -hex 32   # buat API_SHARED_SECRET

4. 4
   Siapkan kredensial Gmail

   Buat OAuth Client ID tipe "Desktop app" di Google Cloud Console, unduh sebagai gmail_credentials.json. Jalankan sekali di laptop untuk login sekali dan hasilkan gmail_token.json, lalu salin kedua file itu ke server (bukan lewat git).

5. 5
   Hubungkan backend ke internet

   Disarankan pakai Cloudflare Tunnel — tidak perlu buka port apapun di server, dan IP server tidak terekspos. Alternatif: reverse proxy biasa (Nginx/Caddy).

6. 6
   Jalankan backend

   Nyalakan semua container dengan satu perintah, lalu cek endpoint kesehatannya.

   docker compose up -d
   curl https://api-kamu.domain.com/health

7. 7
   Deploy frontend

   Disarankan pakai Vercel (gratis, HTTPS otomatis). Set environment variable BACKEND_API_URL dan BACKEND_API_KEY (harus sama persis dengan API_SHARED_SECRET di backend), lalu hubungkan custom domain kamu.

8. 8
   Mulai pakai

   Buka aplikasi di domain kamu, upload CV, sambungkan akun Gmail, klik Sync Now — dan Quest Board siap dipakai.