Lompat ke konten utama
StableTerakhir diperbarui: 16 Nov 2026, 17.12

Mekanisme Gating Paket dan Fitur

1. Ikhtisar & Nilai Bisnis

Dokumentasi ini menguraikan bagaimana DagangBot membatasi dan memberikan akses ke berbagai kapabilitas berdasarkan paket (Plan) yang dilanggan oleh pengguna. Mekanisme "Gating" tidak beroperasi secara dangkal melalui frontend (yang rentan dimanipulasi melalui modifikasi local storage), melainkan diawasi secara kaku melalui sistem perisai middleware di tingkat backend. Nilai bisnis utamanya meliputi:

  • Proteksi Kebocoran Pendapatan (Revenue Leakage): Mencegah pengguna memanggil endpoint yang membutuhkan biaya infrastruktur tinggi (seperti analitik Vision AI atau WhatsApp Broadcast) tanpa berlangganan paket yang sesuai.
  • Penyeragaman Parameter Kuota (Single Source of Truth): Seluruh batasan tier ditambatkan pada katalog harga (pricing facts) yang bersumber dari tabel PostgreSQL, sehingga marketing dapat mengubah limit fitur secara dinamis tanpa perlunya pengerahan ulang (re-deploy) kode aplikasi.
  • Pengalaman Upsell Kontekstual: Saat pengguna menyentuh batas fungsional, sistem mengembalikan struktur data kustom yang memberitahukan UI antarmuka untuk menawarkan paket khusus yang relevan untuk peningkatan kapasitas.

2. Alur Visual & Antarmuka

Pada antarmuka manajemen paket langganan, perubahan fitur paket dioperasikan melalui antarmuka matriks pembatas (limit matrix).

Mekanisme Feature Gating di Panel
Konfigurasi Gating Paket (Plan Feature) dan pengelolaan alur kelonggaran (Grace Period).

Dalam pandangan pengguna (tenant), batas-batas fitur yang tidak mereka miliki akan dirender dengan tampilan digembok. Apabila digembok, tombol aksi akan memicu jendela modal (pop-up) yang mendorong pengguna melakukan pembayaran mutasi paket (upgrade).

3. Panduan Langkah-demi-Langkah

Proses intersepsi perlindungan fitur (feature flag) pada lapisan API dijaga dengan alur sekuensial yang tertib pada lapisan otorisasi:

  1. 1

    Langkah 1: Ekstraksi Identitas Langganan (Subscription)

    Saat panggilan HTTP memasuki router Go Chi, middleware langsung menarik metadata berlangganan tenant dari konteks (context) JWT. Metadata ini mencakup ID penyewa, status pembayaran aktif, nilai batas kedaluwarsa, serta plan_id / plan_slug (contoh: growth_pro).

  2. 2

    Langkah 2: Inspeksi Silang pada Entitas Parameter Fitur

    Fungsi evaluasi gerbang fitur dijalankan dengan mengecek silang terhadap entitas parameter fitur paket. Untuk menghindari latensi koneksi berulang, hasil pemeriksaan kunci fitur (feature key) ini disinggahkan pada lapisan memori cepat (cache).

  3. 3

    Langkah 3: Evaluasi Masa Tenggang (Grace Period)

    Gating tidak mematikan layanan secara kejam pada detik kedaluwarsa. Sistem mengevaluasi toleransi kelonggaran (grace_until). Jika masa tenggang masih ada, sistem tetap memberikan napas bagi layanan asinkron latar belakang. Namun jika grace_until habis, paket terdegradasi secara tertib (downgrade).

  4. 4

    Langkah 4: Eksekusi Resolusi (Teruskan atau Tolak)

    Jika kriteria akses lolos, perutean dilanjutkan ke layanan terkait. Jika gagal, sistem memotong rantai dengan kode HTTP 403 Forbidden JSON berisikan kode galat FEATURE_NOT_AVAILABLE serta saran variabel upgrade_to.

4. Parameter & Spesifikasi Teknis

Mekanisme Gerbang Fitur (Feature Gate)

Gerbang fitur diproses melalui lapisan verifikasi otorisasi fitur backend. Saat interseptor ini mendeteksi akses yang tidak sah berdasarkan paket saat ini:

  • Penolakan Akses: Sistem akan mengembalikan kode status HTTP 403 Forbidden dengan kode galat internal FEATURE_NOT_AVAILABLE.
  • Saran Peningkatan (Upgrade): Respons galat memuat atribut upgrade_to yang memberikan rekomendasi paket mana yang harus dibeli agar fitur tersebut terbuka.
  • Sumber Kebenaran: Resolusi izin gerbang ini mengevaluasi identitas tenant, mencari PlanID atau PlanSlug, kemudian mencocokkannya dengan parameter katalog fitur paket aktif.
  • Kondisi Penurunan Langganan (Downgrade): Jika langganan bulanan/trial berakhir tanpa perpanjangan, interseptor mengalihkan tenant ke MAX(lifetime_plan_id, Free). Apabila akun telah memenuhi ambang akumulasi top-up berbayar untuk suatu tier (Lifetime Tier), hak akses tier tersebut tetap aktif selamanya dan tidak turun ke paket Free; bila belum memiliki Lifetime Tier, akun jatuh ke paket dasar secara tertib.

Kunci fitur (Feature Keys) bersifat deterministik. Tabel di bawah menjabarkan pembatasan (plan catalog) unit boolean dan hitungan kaku yang tervalidasi pada registrasi backend:

Kunci Fitur Backend Jenis Evaluasi Free / Trial Starter Growth Pro Agency & White-Label
max_wa_instances Kuota Integer Max 1 WA Max 1 WA Max 3 WA Max 10 WA
knowledge_quota Kuota Integer 5 Dokumen 20 Dokumen 100 Dokumen 500 Dokumen
token_allocation Kuota Integer 10.000 Token 100.000 Token 500.000 Token 2.000.000 Token
multi_agent Boolean / Jml. (False) 1 Akun CS Max 5 Akun CS Max 15 Akun CS
aspri_full Boolean Akses Tidak Aktif Tidak Aktif Aktif Aktif
sub_accounts Boolean Akses Tidak Aktif Tidak Aktif Tidak Aktif Aktif
whatsapp_official_cloud Boolean Akses Tidak Aktif Tidak Aktif Aktif Aktif

5. Relasi & Integrasi

Modul gating langganan ini bersinergi sangat intim dengan tata kelola entitas paket dan katalog fitur sistem. Setiap instansi pesanan yang diproses senantiasa diverifikasi melalui modul fitur paket sebelum pesanan dinyatakan berhasil.

6. Pemecahan Masalah (Troubleshooting)

Gejala penolakan (rejection) fitur akibat kedaluwarsa atau degradasi (downgrade) sering membingungkan pelanggan. Pedoman tabel berikut merumuskan solusi atas skenario penyekatan rute API:

Gejala Kendala Akar Penyebab Tindakan Solusi
Rute API membalikkan HTTP 403 FEATURE_NOT_AVAILABLE Usaha mengakses batas alokasi di atas paket (tier) yang sedang aktif Telusuri muatan balik JSON upgrade_to, arahkan pengguna ke layar tagihan.
Fitur tetap bisa dipakai sesudah kedaluwarsa plan Masa tenggang (grace_until) belum melewati titik nol Perilaku normal; sistem akan mendegradasi paket setelah 3 hari berturut-turut.
Perubahan batas maksimum (limit) plan belum berlaku Lapisan cache menyimpan parameter fitur lama Segera muat ulang halaman atau hubungi tim bantuan platform untuk sinkronisasi seketika.
Tombol UI lenyap tanpa peringatan galat API Pemetaan fitur UI disembunyikan berdasarkan status paket (hidden flag) Konfirmasikan apakah properti kanonik plan memang sengaja tidak dirender (false).

7. Referensi Terkait

content/docs/advanced/plans-gating.mdx
Terakhir diperbarui: 16 Nov 2026, 17.12

Dokumentasi teknis DagangBot