================================================================
              TUNNEL SAAS v2 - Arsitektur Server-Side
================================================================

Versi 2 dari Tunnel: deploy template ke banyak domain tanpa
harus upload semua file ke tiap domain. Cukup upload 2 file
proxy kecil di client, semua logika tetap di server pusat.


----------------------------------------------------------------
ARSITEKTUR
----------------------------------------------------------------

   +----------+        +-----------------+        +---------------+
   | VISITOR  |   ->   | CLIENT DOMAIN   |   ->   | SERVER PUSAT  |
   +----------+        | (cuma 2 file)   |        | (semua logika |
                       |                 |        |  + data list) |
                       |  index.php      |        |               |
                       |  .htaccess      |        |  render.php   |
                       +-----------------+        |  tunnel/...   |
                              ^                   +---------------+
                              |                          |
                              +<-------------- HTML <----+


----------------------------------------------------------------
ISI PAKET
----------------------------------------------------------------

tunnel-saas/
├── README.txt                  (file ini)
├── client/                     (file yang di-upload ke domain client)
│   ├── index.php               (~3 KB - proxy)
│   ├── .htaccess               (~600 B - rewrite)
│   └── README-CLIENT.txt       (panduan setup di client)
└── server/                     (file yang dipasang di server pusat)
    ├── render.php              (endpoint utama)
    ├── saas_config.php         (KONFIGURASI - WAJIB DIEDIT)
    ├── .htaccess               (proteksi)
    └── README-SERVER.txt       (panduan setup di server)


----------------------------------------------------------------
ALUR PASANG (UNTUK OWNER)
----------------------------------------------------------------

LANGKAH 1: SERVER PUSAT (sekali setup)

   a) Project Tunnel utama sudah ada (folder c:/laragon/www/tunnel/)
   b) Upload folder server/ ke lokasi web-accessible
      (mis. tunnel-master.com/render/)
   c) Edit server/saas_config.php:
      - tunnel_path = path absolut ke folder project utama
      - api_keys    = daftar key + domain client yg diizinkan
   d) Test endpoint: harus muncul "Invalid API key" saat
      diakses tanpa key.

LANGKAH 2: TIAP CLIENT (per domain)

   a) Generate API key baru untuk client:
      php -r "echo bin2hex(random_bytes(20));"
   b) Tambahkan ke saas_config.php di server.
   c) Kirim API key + URL endpoint ke owner client.
   d) Owner client upload 2 file ke domain mereka,
      edit 2 baris di index.php (SERVER_URL + API_KEY).

Selesai. Domain client langsung tampil halaman lengkap
dengan domain mereka sendiri di canonical, OG, dst.


----------------------------------------------------------------
KEUNGGULAN v2 vs v1
----------------------------------------------------------------

   Aspek                v1 Tradisional        v2 SaaS
   ----------------------------------------------------------
   File di client       40+ file              2 file
   Ukuran upload        ~500 KB               ~4 KB
   Update template      Tiap client manual    Edit 1x di server
   Tambah brand         Edit list.txt client  Edit 1x di server
   Konsisten            Manual sync           Otomatis sync
   Skala                Linear (n x kerja)    Konstan (1x kerja)
   Hosting client       Penuh PHP + GD        Cukup PHP cURL
   Penjualan SaaS       Susah                 Mudah (per-key)


----------------------------------------------------------------
KAPAN PAKAI V1 vs V2?
----------------------------------------------------------------

GUNAKAN V1 (project utama c:/laragon/www/tunnel/) KALAU:
   - Cuma 1 domain
   - Mau full kontrol di lokal
   - Tidak butuh multi-tenant

GUNAKAN V2 (folder ini) KALAU:
   - Banyak domain dengan template sama
   - Mau jual akses sebagai SaaS
   - Mau update sentral (edit 1x di server, semua client kena)
   - Client gak teknis (gak mau upload banyak file)
   - Hosting client minimal


----------------------------------------------------------------
BACA SELANJUTNYA
----------------------------------------------------------------

   - client/README-CLIENT.txt   -> panduan untuk owner domain client
   - server/README-SERVER.txt   -> panduan untuk owner server pusat


----------------------------------------------------------------
TIDAK MENGGANTIKAN V1
----------------------------------------------------------------

Folder ini TIDAK menggantikan project utama. Project utama
(c:/laragon/www/tunnel/) tetap dibutuhkan sebagai SUMBER
yang dipakai render.php untuk render halaman.

Jadi struktur lengkap:

   c:\laragon\www\
   ├── tunnel\            (PROJECT UTAMA - tetap)
   │   ├── index.php
   │   ├── list.txt
   │   └── ...semua file project
   │
   └── tunnel-saas\       (FOLDER INI - SaaS layer)
       ├── client\        (upload ke client)
       └── server\        (deploy di server pusat)

================================================================
