Lewati ke konten utama

General Settings & Themes (White-Label)

Modul General Settings memungkinkan perusahaan untuk mengubah wajah identitas (White-Labeling) platform Frog Cloud secara dinamis tanpa harus mengubah kode (re-deploy). Melalui modul ini, Super Admin dapat menyesuaikan parameter global seperti Nama Aplikasi, Tautan Hukum (Syarat & Ketentuan), hingga Palet Warna (Color Palette) utama.

Seluruh konfigurasi ini akan ditarik oleh Frontend maupun Mobile App (melalui modul Lookup) pada saat aplikasi pertama kali dimuat (Splash Screen/Booting).

Diagram Integrasi White-Label​

1. Pengaturan Identitas Aplikasi (App Settings)​

Pengaturan ini bersifat Singleton (hanya ada 1 baris di database). Digunakan untuk menyimpan informasi identitas korporat dan peraturan dasar operasional.

Mengambil Pengaturan Saat Ini​

Request
GET /api/backoffice/setting

Respons (200 OK): Akan merender formulir yang sudah terisi dengan data App Name, URL Kebijakan Privasi, Terms & Conditions, dll.

Menyimpan Perubahan Pengaturan​

Request
PUT /api/backoffice/setting/update
Content-Type: application/json
Request Body
{
  "app_name": "Frog Cloud Premium",
  "privacy_policy_url": "https://frogcloud.com/privacy",
  "terms_and_conditions_url": "https://frogcloud.com/terms",
  "maintenance_mode": false
}

2. Kustomisasi Tema Antarmuka (Color Themes)​

Frog Cloud mendukung konfigurasi tema UI yang dinamis. Admin dapat mengatur nilai Hex Color untuk warna tombol utama (Primary), Secondary, maupun pesan ralat (Error). Fitur ini sangat berguna apabila perusahaan melakukan re-branding visual.

Mengambil Konfigurasi Warna​

Request
GET /api/backoffice/setting/color

Respons (200 OK): Merespons dengan kamus warna Hex, contohnya:

{
  "primary_color": "#1E3A8A",
  "secondary_color": "#10B981",
  "error_color": "#EF4444"
}

Menyimpan Palet Warna Baru​

Request
POST /api/backoffice/setting/color
Content-Type: application/json
Request Body
{
  "primary_color": "#2563EB",
  "secondary_color": "#14B8A6",
  "error_color": "#DC2626"
}

3. Pengelolaan Firewall Rule Types​

Modul Firewall Rule Types digunakan untuk mendaftarkan jenis protokol jaringan standar (seperti TCP, UDP, ICMP) yang divalidasi ketika pengguna membuat konfigurasi Security Group atau aturan keamanan Firewall.

Mengambil Daftar Firewall Rule Types​

Request
GET /api/backoffice/setting/firewall-rule-types

Membuat Firewall Rule Type Baru​

Request
POST /api/backoffice/setting/firewall-rule-types/create
Content-Type: application/json
Request Body
{
  "name": "UDP Protocol",
  "protocol": "udp",
  "description": "User Datagram Protocol"
}

Memperbarui Firewall Rule Type​

Request
PUT /api/backoffice/setting/firewall-rule-types/{id}/update
Content-Type: application/json
Request Body
{
  "name": "TCP Protocol Updated",
  "protocol": "tcp",
  "description": "Updated Description"
}

Menghapus Firewall Rule Type​

Request
DELETE /api/backoffice/setting/firewall-rule-types/{id}/delete

Alur Integrasi Frontend (UI/UX)​

  1. Ketika Customer atau Admin membuka aplikasi web, Javascript di Frontend akan memanggil endpoint Lookup.
  2. Jika respons berhasil didapat, Frontend akan menyuntikkan kode CSS dinamis (CSS Variables) ke dalam DOM: 
    :root {
      --color-primary: #2563EB;
      --color-secondary: #14B8A6;
    }
  3. Jika API Backend gagal dihubungi, Frontend wajib menggunakan warna Fallback Default yang sudah di-hardcode untuk mencegah UI hancur.