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).

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
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
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
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 jikagrace_untilhabis, paket terdegradasi secara tertib (downgrade). - 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 ForbiddenJSON berisikan kode galatFEATURE_NOT_AVAILABLEserta saran variabelupgrade_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 Forbiddendengan kode galat internalFEATURE_NOT_AVAILABLE. - Saran Peningkatan (Upgrade): Respons galat memuat atribut
upgrade_toyang memberikan rekomendasi paket mana yang harus dibeli agar fitur tersebut terbuka. - Sumber Kebenaran: Resolusi izin gerbang ini mengevaluasi identitas tenant, mencari
PlanIDatauPlanSlug, 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:
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:
