HandyCafe Docs
admin

Operasi Lisensi di Admin Cloud

Administrator platform HandyCafe yang berwenang dapat mengelola akses komersial seorang pelanggan dari halaman detail pelanggan. Halaman ini diawali dengan ikhtisar akun, status profil, status koneksi langsung serta jumlah lisensi Genesis. Setiap lisensi Genesis memiliki satu kartu operasi yang menampilkan paket aktifnya, batas PC dan konsol, saldo AI, saldo anggota, akses modul tambahan serta status Stripe.

Alat lawas dan beta disimpan di bagian terpisah yang dapat dibuka sendiri. Aktivitas ping dan perubahan profil tersedia di bagian Diagnostik serta riwayat perubahan. Dengan begitu alur kerja Genesis yang berlaku tetap terlihat tanpa menghapus alat dukungan yang lebih lama.

Melihat semua lisensi Genesis

Buka Lisensi di dasbor admin internal. Tab Genesis terbuka secara bawaan dan hanya menampilkan paket Free dan Genesis yang berlaku saat ini. Pemberian lisensi Beta terdahulu tetap berada di tab Beta yang terpisah.

Kartu ringkasan menampilkan jumlah lisensi total, aktif, berbayar serta gratis. Daftar dapat dicari berdasarkan kafe, akun, email, paket atau kunci lisensi. Administrator juga dapat memfilter berdasarkan jenis paket atau status. Setiap baris menampilkan kapasitas, akses Cloud dan Kafetaria, saldo AI, masa berlaku serta status. Pilih Kelola untuk membuka ruang kerja pelanggan bagi operasi paket, layanan, kredit dan penagihan.

Membuat lisensi Genesis pertama

Ketika sebuah akun belum memiliki lisensi Genesis, halaman detail pelanggan menampilkan formulir pembuatan lisensi alih-alih hasil kosong. Pilih paket Genesis yang aktif dan tanggal kedaluwarsa di masa depan. Tinjau paket, tanggal kedaluwarsa serta negara pada dialog konfirmasi. Pilih Buat lisensi untuk menetapkannya langsung ke akun pelanggan.

Akun harus memiliki nama kafe dan negara sebelum lisensi dibuat. Pilih Edit profil untuk melengkapi detail yang kurang. Paket menentukan batas PC sekaligus batas konsol. Tanggal kedaluwarsa yang dipilih berlaku hingga akhir hari UTC tersebut.

Operasi yang tersedia

  • Menetapkan paket Genesis. Lisensi manual menerima kapasitas dan tanggal kedaluwarsa dari paket yang dipilih. Langganan yang dikelola Stripe mengikuti aturan peningkatan dan penurunan paket yang berlaku, termasuk penagihan langsung atau perubahan terjadwal.
  • Mengelola Cloud dan Kafetaria. Hak akses Cloud diperbarui pada lisensi. Mengaktifkan Kafetaria juga menyiapkan atau mengaktifkan kembali tenant yang sesuai di handy.cafe; menonaktifkannya akan menangguhkan tenant tersebut. Kedua layanan itu tidak pernah disinkronkan selagi kunci database sedang ditahan.
  • Memberikan kredit AI. Bagian operasi Kredit menampilkan saldo AI lisensi terpilih sebelum administrator memasukkan jumlah pengisian. Pemberian kredit menambahkan kredit prabayar dalam USD ke dompet AI serta mencatat entri audit.
  • Memberikan kredit anggota. Menambahkan kredit bonus ke akun anggota HandyCafe dengan alamat email yang sama. Operasi ini tidak tersedia ketika tidak ada anggota yang cocok.
  • Mengubah tanggal penagihan berikutnya. Untuk langganan Stripe, tanggal diperbarui di Stripe lalu disinkronkan ke langganan serta lisensi lokal. Perubahan paket yang terjadwal harus dibatalkan lebih dulu.
  • Mengembalikan dana pembayaran. Administrator memilih transaksi Stripe yang dananya dapat dikembalikan, memilih alasan Stripe, memasukkan penjelasan internal yang wajib diisi lalu mengonfirmasi pengembalian dana. Pengembalian dana tidak membatalkan langganan atau mencabut akses produk.

Perilaku keamanan dan audit

Setiap tindakan yang mengubah data memerlukan konfirmasi di dasbor. Operasi backend berdampak besar dibatasi oleh kunci API admin, memvalidasi kepemilikan transaksi Stripe serta menulis catatan audit yang hanya dapat ditambah dan tidak dapat diubah. Riwayat pembayaran dimuat hanya ketika diminta dan dibatasi pada transaksi terbaru. Pengembalian dana menggunakan kunci idempotensi unik supaya pengiriman ganda yang tidak disengaja tidak terjadi.

Jika sebuah lisensi lama tidak lagi memiliki kunci teks biasa yang dapat dipulihkan, penyediaan Kafetaria otomatis akan berhenti secara aman dan dasbor melaporkan bahwa administrator harus menyelesaikan masalah kredensial lisensi itu lebih dulu.

Prefiks negara pada kunci lisensi

Kunci lisensi baru yang terikat akun memakai kode negara dua huruf dari profil pelanggan yang sudah lengkap, misalnya GEN-TR-... untuk lisensi Genesis yang dibuat admin atau HC-TR-... untuk lisensi akun yang netral paket. Pembuatan oleh admin dihentikan ketika profil tidak memiliki negara yang valid. Sistem tidak pernah membuat kunci GEN-XX-... atau HC-XX-... baru.

Memperbarui kolom negara pada lisensi yang sudah ada tidak serta-merta merotasi kunci aktifnya. Administrator harus mengoordinasikan koreksi negara dengan rotasi kunci karena server yang terpasang harus masuk kembali setelah kredensialnya berubah.