WHMCloud - Web Hosting Management Platform

✨ Tentang Produk

WHMCloud adalah platform manajemen web hosting berbasis NestJS dan TypeScript yang menyediakan fondasi backend solid untuk mengelola seluruh siklus layanan hosting — dari registrasi pelanggan, manajemen paket, autentikasi aman, hingga pengelolaan data berbasis MySQL atau PostgreSQL. Antarmuka yang clean, minimalis, dan profesional memudahkan admin dan pelanggan mengelola layanan tanpa kerumitan teknis berlebih.

Dirancang untuk hosting provider lokal, reseller hosting, startup SaaS infrastruktur, dan developer yang ingin membangun platform hosting management tanpa memulai dari nol. Arsitektur modular NestJS memastikan kode terstruktur rapi dan mudah dikustomisasi sesuai kebutuhan bisnis Anda.

Data demo bersifat simulasi dan dapat direset sewaktu-waktu. Jangan gunakan data pribadi asli.

🚀 Fitur Unggulan

• Autentikasi JWT Aman — Login terverifikasi via JSON Web Token dengan Passport.js, memastikan setiap akses API terlindungi dari akses tidak sah.
• Manajemen User & Role — Multi-role dengan kontrol akses granular, memisahkan hak admin dan pelanggan secara jelas.
• Dual Database Support — Mendukung MySQL dan PostgreSQL, fleksibel disesuaikan dengan infrastruktur hosting Anda.
• ORM TypeORM Terstruktur — Pengelolaan database type-safe dengan migrasi skema otomatis dan relasi antar entitas yang mudah.
• Setup & Seed Otomatis — Script inisialisasi database dan pengisian data awal mempercepat proses deployment.
• Arsitektur Modular NestJS — Kode backend terorganisasi dalam modul independen, memudahkan penambahan fitur dan pemeliharaan jangka panjang.
• Enkripsi Password Bcrypt — Password dienkripsi sebelum disimpan, mengikuti standar keamanan industri untuk proteksi data sensitif.
• Validasi Data Request — Input dari client divalidasi menggunakan class-validator, mencegah data tidak valid masuk ke sistem.
• UUID Identifier — Identifier unik untuk entitas data, menghindari konflik ID dan meningkatkan keamanan dari serangan enumerasi.
• Environment Configuration — Konfigurasi aplikasi via dotenv, memudahkan pemisahan environment development, staging, dan production.

📊 Infografis Cepat

• Versi — 1.0.0 (Stable)
• Arsitektur — Monorepo (Backend NestJS + Frontend terpisah)
• Jumlah Role — Minimal 2 (Admin & Client/User)
• Database — MySQL & PostgreSQL
• ORM — TypeORM 0.3.x
• Bahasa — TypeScript 5.x
• Framework — NestJS 10.x
• Autentikasi — JWT + Passport.js
• Script Otomasi — Install Setup + Database Seed
• Mode Jalankan — Development (watch), Production (dist)

🔄 Alur Penggunaan

1. Ekstrak Source Code — Unduh dan ekstrak source code WHMCloud yang Anda beli ke server atau mesin lokal.
2. Install Dependencies — Masuk ke direktori backend/ lalu jalankan npm install untuk mengunduh dependensi.
3. Konfigurasi Environment — Salin .env.example menjadi .env, isi variabel koneksi database, secret JWT, dan port aplikasi.
4. Inisialisasi Database — Jalankan npm run install:setup untuk membuat struktur tabel database otomatis via TypeORM.
5. Seed Data Awal — Jalankan npm run seed untuk mengisi database dengan data default seperti akun admin dan paket hosting awal.
6. Jalankan Aplikasi — Development: npm run start:dev (mode watch). Production: npm run build lalu npm run start:prod.
7. Konfigurasi Frontend — Sambungkan frontend ke endpoint API backend, pastikan base URL API dikonfigurasi dengan benar.
8. Operasional Harian — Admin mengelola user, paket, dan monitoring. Pelanggan mendaftar, melihat layanan aktif, dan mengelola akun melalui portal client.

🗺️ Menu Aplikasi

🛡 Halaman Admin

• Dashboard Admin — Ringkasan statistik platform: jumlah pelanggan aktif, layanan berjalan, notifikasi sistem.
• Manajemen User — Daftar pengguna terdaftar dengan kemampuan melihat detail, mengubah status, dan mengelola hak akses.
• Manajemen Paket Hosting — Kelola paket layanan: tambah paket baru, edit spesifikasi, atur harga, aktifkan/nonaktifkan paket.
• Kelola Layanan Aktif — Monitor seluruh layanan hosting aktif di semua pelanggan, termasuk status dan detail konfigurasi.
• Konfigurasi Sistem — Pengaturan global platform seperti koneksi server, parameter sistem, dan integrasi API eksternal.
• Manajemen Akun Admin — Pengaturan profil dan keamanan akun administrator, termasuk perubahan password.

👤 Halaman Client / User

• Dashboard Client — Tampilan ringkas layanan aktif, status akun, dan informasi terkini mengenai langganan.
• Layanan Saya — Daftar seluruh layanan hosting yang dimiliki beserta status aktif, detail konfigurasi, dan tanggal kedaluwarsa.
• Profil Akun — Pengelolaan informasi pribadi pelanggan: edit data diri dan perubahan password akun.
• Katalog Paket — Daftar paket hosting yang tersedia untuk dibeli atau di-upgrade oleh pelanggan.

🌐 Halaman Publik

• Landing Page — Halaman utama menampilkan informasi produk, fitur unggulan, dan ajakan untuk mendaftar atau login.
• Login — Form autentikasi untuk masuk ke sistem, mendukung validasi JWT dan penanganan error informatif.
• Register — Formulir pendaftaran akun baru dengan validasi input lengkap dan enkripsi password otomatis.

🛠️ Tech Stack & Arsitektur

• NestJS 10.x — Framework Node.js berbasis TypeScript dengan arsitektur modular, menyediakan struktur kode konsisten dan dukungan dependency injection untuk REST API skala enterprise.
• TypeScript 5.x — Static typing yang kuat untuk meningkatkan keandalan kode, kemudahan refactoring, dan deteksi bug sejak fase development.
• TypeORM 0.3.x — ORM modern dengan integrasi sempurna ke NestJS dan TypeScript, menyediakan fitur migrasi dan repository pattern untuk pengelolaan database.
• MySQL / PostgreSQL — Dua pilihan database relasional populer di industri hosting, fleksibel disesuaikan dengan infrastruktur yang sudah ada.
• JWT + Passport.js — Kombinasi standar industri untuk autentikasi stateless, memungkinkan verifikasi token tanpa session server-side.
• bcryptjs — Library hashing password dengan algoritma bcrypt yang terbukti aman dan mendukung cost factor yang dapat dikonfigurasi.
• undici — HTTP client modern berbasis Node.js untuk melakukan request ke API eksternal seperti WHM/cPanel API dengan performa tinggi.

🎯 Cocok Untuk

• Hosting Provider Lokal — Bisnis penyedia layanan web hosting yang ingin memiliki panel manajemen sendiri tanpa ketergantungan pada software pihak ketiga yang mahal.
• Reseller Hosting — Reseller yang ingin memberikan pengalaman portal client branded dan profesional dengan sistem yang dapat dikustomisasi penuh.
• Startup SaaS Infrastruktur — Tim startup yang membangun produk di bidang cloud infrastructure atau managed hosting dan membutuhkan fondasi backend solid.
• Developer Full-Stack — Pengembang yang ingin mempelajari atau mengadaptasi arsitektur NestJS + TypeORM untuk proyek manajemen layanan berbasis subscription.
• Perusahaan IT Internal — Perusahaan yang ingin membangun sistem manajemen hosting internal untuk kebutuhan infrastruktur tim atau client mereka sendiri.

❓ FAQ

Q: Apakah WHMCloud dapat langsung terhubung ke WHM/cPanel server yang sudah ada?

A: WHMCloud dibangun dengan library undici sebagai HTTP client untuk komunikasi ke API eksternal, memungkinkan integrasi dengan WHM/cPanel API. Konfigurasi koneksi spesifik perlu disesuaikan di file environment sesuai setup server Anda.

Q: Database apa yang direkomendasikan: MySQL atau PostgreSQL?

A: Keduanya didukung penuh. Jika infrastruktur Anda sudah menggunakan MySQL (umum di shared hosting), pilih MySQL. Jika membutuhkan fitur database yang lebih advanced dan performa query kompleks, PostgreSQL adalah pilihan yang lebih baik. Konfigurasi cukup dilakukan di file .env.

Q: Apakah source code ini sudah production-ready?

A: WHMCloud versi 1.0.0 menyediakan fondasi backend yang solid dan siap digunakan. Namun diperlukan penyesuaian konfigurasi keamanan, setup HTTPS, dan kustomisasi sesuai kebutuhan bisnis spesifik Anda sebelum deploy ke production penuh.

Q: Seberapa mudah menambahkan fitur baru ke WHMCloud?

A: Sangat mudah, berkat arsitektur modular NestJS. Setiap fitur baru cukup dibuat sebagai modul baru yang independen (module, controller, service, entity), lalu didaftarkan ke AppModule. Pola ini mengikuti prinsip SOLID dan memudahkan pengembangan tim.

Q: Apakah WHMCloud mendukung multi-tenancy?

A: Arsitektur dasar WHMCloud dengan sistem role dan UUID identifier memberikan fondasi yang baik untuk pengembangan multi-tenancy. Implementasi penuh multi-tenancy dapat dikembangkan di atas codebase yang sudah ada sesuai kebutuhan skala bisnis Anda.

🚀 Cara Deploy

1. Ekstrak Source Code — Login ke VPS via SSH, ekstrak source code yang Anda beli ke direktori whmcloud/backend.
2. Install Dependencies — Pastikan Node.js 18+ terinstall, lalu jalankan npm install.
3. Konfigurasi Environment — Buat file .env dari template, isi DB_HOST, DB_USER, DB_PASS, DB_NAME, DB_TYPE (mysql/postgres), JWT_SECRET, dan PORT.
4. Setup & Seed Database — Jalankan npm run install:setup dan npm run seed untuk inisialisasi database dan pengisian data awal.
5. Build & Jalankan — Build dengan npm run build, lalu jalankan dengan PM2: pm2 start dist/main.js --name whmcloud-backend.
6. Setup Nginx & SSL — Konfigurasi Nginx sebagai reverse proxy ke port aplikasi, tambahkan SSL certificate via Let's Encrypt dengan Certbot untuk keamanan HTTPS.

📦 Yang Anda Dapatkan

• Source Code Backend Lengkap — Codebase NestJS + TypeScript yang terstruktur rapi dengan arsitektur modular siap dikembangkan.
• Dokumentasi Setup — Panduan instalasi dan konfigurasi environment untuk deployment di VPS atau Docker.
• Database Schema — Struktur database lengkap dengan entitas TypeORM dan script migrasi otomatis.
• Autentikasi JWT Ready — Sistem autentikasi aman dengan JWT dan Passport.js sudah terintegrasi penuh.
• Script Otomasi — Script setup dan seed untuk inisialisasi database dan pengisian data awal secara otomatis.
• Dual Database Support — Konfigurasi siap pakai untuk MySQL dan PostgreSQL, fleksibel disesuaikan dengan infrastruktur Anda.

💡 Mengapa Memilih WHMCloud

Membangun platform manajemen hosting dari nol membutuhkan waktu berbulan-bulan dan investasi besar. Dengan WHMCloud, Anda mendapatkan fondasi backend yang telah dirancang secara profesional menggunakan teknologi terkini — NestJS, TypeScript, dan TypeORM — yang siap dikembangkan lebih lanjut. Antarmuka yang clean dan minimalis memastikan pengalaman pengguna yang intuitif, baik untuk admin maupun pelanggan.

Arsitektur yang bersih, sistem autentikasi yang aman, dan dukungan dual database menjadikan WHMCloud sebagai titik awal yang ideal untuk bisnis hosting Anda. Hemat waktu development, fokus pada diferensiasi bisnis, dan mulai melayani pelanggan lebih cepat. Investasi sekali, manfaat jangka panjang.