# 📘 MASTER TUTORIAL GDCONNECT
**"Connect Anywhere. Control Securely."**

Dokumen ini adalah panduan komprehensif untuk instalasi, konfigurasi, dan penggunaan platform GDConnect.

---

## 🛠️ MODUL 1: INSTALASI & KONFIGURASI SERVER (BACKEND)
*Dilakukan di Windows Server / VPS. Server ini adalah "Hub" yang mengelola otentikasi, kehadiran perangkat, dan signaling koneksi.*

### 1. Prasyarat Sistem
- **OS**: Windows Server 2019/2022/2025 atau Windows 10/11 (64-bit).
- **Runtime**: Node.js LTS v20.x atau v22.x.
- **Akses**: Hak Administrator penuh.

### 2. Konfigurasi Firewall (Buka Port Berikut)
Pastikan port ini terbuka di Firewall Windows dan Security Group Cloud Anda:

| Port | Protokol | Kegunaan |
| :--- | :--- | :--- |
| `5000` | TCP | GDConnect REST API (Otentikasi & Data) |
| `5001` | TCP | GDConnect WebSocket Signaling (Handshake) |
| `5002` | TCP | GDConnect Admin Dashboard (Web) |
| `3478` | UDP/TCP | STUN/TURN Server (NAT Traversal) |
| `49152-65535`| UDP | WebRTC Media Stream (Video & Audio) |

### 3. Langkah Instalasi Server
Buka **PowerShell sebagai Administrator**, masuk ke folder repository GDConnect, dan jalankan urutan berikut:

```powershell
# Step A: Build seluruh sistem dari source code
npm run build

# Step B: Jalankan Installer Server 
# (Membuat folder C:\GDConnect dan deploy file produksi)
powershell -ExecutionPolicy Bypass -File .\infrastructure\scripts\install.ps1

# Step C: Konfigurasi otomatis aturan Firewall Windows
powershell -ExecutionPolicy Bypass -File C:\GDConnect\scripts\firewall.ps1

# Step D: Mulai jalankan layanan sebagai Windows Services
powershell -ExecutionPolicy Bypass -File C:\GDConnect\scripts\start.ps1
```

### 4. Verifikasi Kesehatan
Jalankan probe kesehatan untuk memastikan server siap menerima koneksi:
```powershell
powershell -ExecutionPolicy Bypass -File C:\GDConnect\scripts\health-check.ps1
```
**Hasil Sukses:** $\text{Status: OK | API: UP | Signaling: UP}$

---

## 💻 MODUL 2: PENGGUNAAN APLIKASI DESKTOP
*Langkah ini dilakukan pada kedua komputer: **Controller** (Pengendali) dan **Host** (Target).*

### 1. Konfigurasi Komputer HOST (Target)
1. Buka aplikasi **GDConnect**.
2. **Hubungkan ke Server**:
   - Klik menu **Settings (Gerigi)**.
   - Ubah `Signaling & API Server URL` menjadi alamat IP Server Anda (contoh: `http://123.45.67.89:5000`).
3. **Ambil Device ID**:
   - Lihat pada kartu **"This Device"**.
   - Pastikan status: $\color{green}{\text{Online \& Ready}}$.
   - Salin **Device ID** (Contoh: `GD-719-153-918`) dan berikan kepada pengendali.

### 2. Konfigurasi Komputer CONTROLLER (Pengendali)
1. Buka aplikasi **GDConnect**.
2. Lakukan hal yang sama pada **Settings** $\rightarrow$ masukkan IP Server yang sama dengan Host.
3. **Hubungkan**:
   - Pada kartu **"Remote Device"**, masukkan **Device ID** target.
   - Klik tombol **Connect**.

### 3. Alur Otorisasi & Keamanan
1. **Permintaan**: Pengendali mengirim request $\rightarrow$ Server meneruskan ke Host.
2. **Persetujuan**: Host menerima notifikasi pop-up $\rightarrow$ Klik **"Accept / Izinkan"**.
3. **Koneksi**: Jalur WebRTC terbentuk secara otomatis.
   - **LAN**: Koneksi lokal super cepat jika satu jaringan.
   - **Internet**: Menggunakan STUN/TURN untuk menembus NAT/Firewall.

---

## 👨‍💼 MODUL 3: MANAJEMEN ADMIN DASHBOARD
*Digunakan oleh Administrator untuk monitoring seluruh infrastruktur.*

### 1. Cara Akses
Buka browser dan akses: `http://<IP_SERVER_ANDA>:5002`

### 2. Kredensial Login Default
- **Email**: `admin@gdconnect.local`
- **Password**: `GDConnectAdmin2026!`

### 3. Fitur Utama
- **Overview**: Statistik CPU/RAM server dan jumlah sesi aktif.
- **Devices**: Daftar semua perangkat terdaftar, cek status online/offline, dan fitur **Revoke Device** (mencabut akses perangkat).
- **Audit Logs**: Log lengkap histori koneksi (siapa, kapan, dan berapa lama).

---

## 🆘 TROUBLESHOOTING CEPAT

| Masalah | Solusi |
| :--- | :--- |
| **Status "Server Offline"** | Periksa apakah port `5000` dan `5001` terbuka. Jalankan `status.ps1` di server. |
| **Gagal Connect via Internet** | Pastikan port `3478 (UDP)` dan range `49152-65535 (UDP)` terbuka di firewall VPS. |
| **Sesi Lag / Patah-patah** | Di menu Settings klien, ubah `Quality Preset` ke `Low Bandwidth`. |
| **Lupa Password Admin** | Reset via database PostgreSQL pada tabel `users`. |
| **Stop Semua Layanan** | Jalankan: `powershell -ExecutionPolicy Bypass -File C:\GDConnect\scripts\stop.ps1`. |
