CerdasNet Hosting Platform

1. Latar belakang dan masalah

Layanan hosting umumnya membutuhkan banyak alat terpisah: panel kontrol, billing, DNS, notifikasi, dan monitoring. Akibatnya pengelolaan lambat, data tercecer, dan klien sering menunggu admin untuk hal sederhana.

2. Target yang ingin dicapai

Tujuan utama

Membangun platform hosting sendiri yang otomatis dari pembayaran sampai situs aktif, aman, dapat dipantau, dan siap berkembang menjadi beberapa server.

Sasaran terukur

Di luar cakupan (tahap awal)

• Hosting email penuh (SMTP/IMAP).
• Penjualan aplikasi berbayar tanpa lisensi resmi.
• Otomatisasi penuh failover database tanpa alat khusus.

3. Fitur dan manfaat

Ringkasan manfaat

4. Yang sudah ada dan dipakai ulang

5. Struktur folder yang diusulkan

src/hosting/
  bootstrap/     preflight: OS, root, port, token, WAHA; report.js
  edge/          listener 80/443, SNI, certs, hostRouter, limits
  cloudflare/    client, zones, dns, customHostnames, tokenCheck
  domains/       subdomain, customDomain, verification, nameserverTransfer
  accounts/ plans/ sites/(runtimes) supervisor/
  filemanager/   pathGuard.js, archive.js (batas anti zip bomb)
  terminal/ php/ databases/ apps/(catalog, licenses)
  backups/ resources/ cluster/ billing/ notify/
  routes/ controllers/ jobs/ validators/ utils/

public/hosting/  js, css, vendor (xterm.js, editor ringan)
views/hosting/   admin/ dan client/
tests/           unit/hosting-*.test.mjs, integration/hosting/

Prototipe di src/services/hosting/ (subdomain, pathGuard, cloudflareClient, hostRouter) dipindah ke src/hosting/ setelah struktur disetujui.

6. Tanggung jawab modul

7. Alur utama

A. Subdomain

1. Klien isi label dan pilih zona.
2. Validasi format dan daftar yang dipesan.
3. Cek kuota paket.
4. Job: buat record A proxied dan situs.
5. Aktif, notifikasi WAHA terkirim.

B. Domain sendiri

1. Klien isi domain, sistem tampilkan CNAME.
2. Custom hostname dibuat, TXT verifikasi ditampilkan.
3. Status dipantau, setelah aktif ditautkan ke situs.

C. Pindah nameserver

1. Kepemilikan domain dibuktikan dulu.
2. Zona dibuat, nameserver diberikan.
3. Klien mengubahnya di registrar.
4. Status dicek berkala, setelah aktif DNS otomatis.

D. Installer satu klik

1. Pilih aplikasi, domain, database.
2. Unduh dari sumber resmi, cek checksum, ekstrak.
3. Konfigurasi database, catat status.
4. Aplikasi berbayar: lisensi diverifikasi dulu.

E. Pembelian paket

1. Pembayaran lunas memicu fulfillment.
2. Akun, folder, kuota dibuat; gagal dicatat dan dicoba ulang.

8. Cluster beberapa VPS

Yang realistis

• Beberapa node aplikasi berjalan bersamaan di belakang load balancer.
• Failover otomatis dalam hitungan detik sampai menit, tergantung interval health check.
• Request yang sedang berjalan saat node mati akan gagal.
• Data yang belum tereplikasi bisa hilang saat node mati mendadak.

Peran node

Yang disinkronkan antar node

• Database: satu sumber kebenaran (primer), replika untuk baca.
• File situs: sumber masalah terbesar. Pilihan: object storage S3, NFS, atau rsync berkala dengan RPO jelas (K4).
• Sesi login: di database, bukan memori node.
• WAHA: hanya satu node memegang lease.
• Job terjadwal: satu pelaksana per waktu via lease.

Health check dan failover

• Heartbeat ke cluster_nodes; Cloudflare memeriksa /healthz dan mengeluarkan node gagal.
• Replika dinaikkan manual atau dengan skrip teruji. Otomatisasi penuh diputuskan terpisah.
• Semua VPS memakai kode sama; peran ditentukan CLUSTER_ROLE, daftar peer, dan koneksi database.

9. Penyimpanan dan data

/srv/cn/
  accounts/<akun>/sites/<situs>/   direktori kerja situs
  accounts/<akun>/home/            file manager dan terminal
  runtime/  cache/  backups/  logs/

Folder CerdasNet (kode, .env, database lokal) tidak boleh berada di dalam /srv/cn/accounts.

Migrasi mengikuti pola src/db/migrations/*.js; setiap migrasi punya down yang berfungsi.

10. Keamanan

• Isolasi akun: user Linux per akun, tidak sekuat container karena kernel dipakai bersama. Untuk pelanggan berbayar dalam jumlah besar, pertimbangkan container (K2).
• Environment kosong: proses situs tidak mewarisi .env atau secret.
• Path: semua akses file lewat pathGuard (symlink dan file belum ada).
• Arsip: batas jumlah dan ukuran file saat ekstrak.
• Terminal: akun aktif saja, batas idle, tercatat audit.
• Token: lewat secretsService, tidak di kode atau log.
• Rate limit: login, pembuatan situs, unggah.
• Lisensi: hanya produk berizin resmi; open source seperti WordPress boleh gratis.

11. Fase, kriteria selesai, dan perkiraan waktu

Perkiraan waktu bersifat indikatif untuk satu pengembang dan dapat berubah.

12. Contoh paket (usulan awal, belum final)

13. Keputusan sebelum Fase 1

14. Risiko dan mitigasi

15. Penutup dan persetujuan

Dengan persetujuan dokumen ini, pekerjaan dimulai dari Fase 0 dengan menjawab keputusan K1–K7, lalu lanjut ke Fase 1 (satu node).