SMARTKEY

Total pelanggan/outlet0

Aplikasi aktif0

Lisensi aktif0

Trial aktif0

Hampir expired0

Permintaan pending0

Aktivasi Terbaru

Tenant	Produk	Paket	Status	Expired

Daftar Produk

Daftar Paket

Produk	Paket	Harga	Durasi	Max Device	Fitur

Daftar Add-on

Produk	Kode Add-on	Nama	Harga	Status

Outlet / Tenant

Tenant ID	Outlet	Pemilik	Produk	Status	Aksi

Tambah / Edit Outlet

Checklist Tambah Outlet Pilih outlet atau isi form baru, lalu lengkapi tahap serial, lisensi, config client, dan push config.

BELUM DIPILIH

ISI Identitas outlet ISI Produk client ISI Serial/license ISI Config client

Identitas Outlet

Data bisnis dan pemilik untuk dashboard pusat.

Status

Jenis Bisnis

Nama Outlet

Pemilik

Nomor WA

Email

Alamat

Aplikasi Client

Pilih produk yang dipakai outlet dan isi endpoint/spreadsheet per produk.

Produk Dipakai

Konfigurasi Operasional Client

Nilai ini disimpan di pusat/proxy dan nanti tidak perlu diisi dari app client.

Google Spreadsheet ID (Database Utama)

Folder Drive ID (Bukti QC)

Retensi Foto QC (Hari)

Fonnte Token (WA API)

QRIS Statis String

Secret dan Properti Lanjutan

Gunakan hanya untuk kebutuhan teknis yang belum punya field khusus.

Server Secret (Kunci Injeksi)

Konfigurasi Tambahan Server Client (Manual)

Lisensi

License Key	Tenant	Outlet	Produk	Paket	Max Dev	Device Terdaftar	Status	Expired

Generate / Aktivasi Lisensi

Tenant

Produk

Paket

Status

Tanggal Mulai

Tanggal Expired

Device Terdaftar

Belum ada device terdaftar.

Klik tombol × di sebelah Device ID untuk menghapus 1 device. Klik “Reset Semua” untuk menghapus semua device sekaligus.

Catatan

Manajemen Langganan Add-on

Atur kuota, masa aktif (expire), hapus atau edit Add-on yang dibeli outlet.

Pilih lisensi di tabel untuk melihat/mengelola langganan Add-on.

Permintaan Aktivasi dari App Client

Permintaan paket dari app yang dijual akan masuk ke sini untuk di-approve atau ditolak.

Waktu	Outlet / Tenant	Info Kontak	Produk / Paket	Status	Aksi

Status Kesiapan SaaS

Checklist outlet yang sudah siap dipakai app client lewat serial key dan proxy.

Endpoint Integrasi App Client

Action	Kegunaan	Status Backend

Contoh Payload Validasi

Konfigurasi Client

Serial	Outlet	Produk	Paket	Status	Kesiapan

Payload KV / Proxy

Sinkronisasi Data App Lama (GAS ke D1)

Tarik data Snapshot secara langsung tanpa perlu login. (Membutuhkan sedikit penambahan kode di file Kode.gs Anda).

URL Endpoint GAS (Google Apps Script)

Admin Sync Token D1

Token D1 yang diperlukan untuk menyimpan data migrasi.

Audit Admin

Waktu	User	Action	Target	Catatan

Log Validasi Lisensi

Waktu	Tenant	Produk	Status	Pesan

Log Proxy / KV

Waktu	Serial	Produk	Status	Catatan

Pengaturan Sistem & Notifikasi

Konfigurasi global SmartKey Pusat termasuk integrasi WhatsApp Fonnte.

Nomor WhatsApp Admin

Nomor kontak pusat yang dihubungi oleh Client saat menunggu aktivasi atau error.

Nomor WA (Gunakan 62)

Contoh: 6281234567890. Akan menjadi link wa.me di app client.

Integrasi WhatsApp (Fonnte)

Pengaturan pengiriman pesan WA otomatis saat aktivasi disetujui.

Fonnte Token (Global)

Template Pesan Approve Aktivasi

Variabel yang tersedia: {outlet_name}, {owner_name}, {product}, {plan}, {serial_key}

Otomatisasi Database

Pengaturan penghapusan otomatis untuk lisensi dan tenant yang kadaluarsa.

Aktifkan Hapus Otomatis (Auto-Cleanup) Outlet Trial > 1 Bulan

Jika dicentang, lisensi Trial yang sudah kedaluwarsa lebih dari 30 hari akan dihapus otomatis dari Pusat dan data transaksi/pelanggannya di Produk terkait (seperti Kasir Laundry) akan terhapus bersih.

🔧 Migrasi Database

Jalankan migration DDL untuk mengaktifkan fitur baru. Aman dijalankan berulang kali.

Migration: Device Limit per Paket

Menambahkan kolom max_devices ke tabel Plans, dan mengkonversi data device_binding lama ke format JSON array. Wajib dijalankan sekali jika belum pernah.

Panduan Operasional SMARTKEY (Cloudflare D1)

Cara Menambah Outlet Baru

Tambah Tenant & Outlet: Buka tab Outlet di Dashboard Pusat ini, lalu klik "Tambah Tenant/Outlet".
Isi Data Outlet: Masukkan Nama Outlet, Owner, dan info kontak. Klik Simpan.
Buat Lisensi: Buka tab Lisensi, klik "Tambah Lisensi Baru". Pilih Outlet yang baru dibuat, produk yang dibeli, dan paketnya.
Berikan Serial Key: Berikan Serial Key (SK-...) yang dihasilkan ke pemilik Outlet untuk dimasukkan ke Aplikasi Kasir Android mereka.

Setup Aplikasi Client (Kasir)

Versi Aplikasi: Pastikan Outlet menggunakan Aplikasi Kasir versi terbaru yang sudah menembak ke Proxy Cloudflare (https://smartkey.id/api/smartkey).
Validasi Otomatis: Aplikasi Kasir akan otomatis tervalidasi lisensinya secara super cepat (<300ms) melalui jaringan Edge Cloudflare.
Spreadsheet POS: Transaksi kasir (penjualan, cuci, absen) milik outlet tetap tersimpan aman di Google Spreadsheet milik mereka sendiri, tidak membebani server pusat.

Migrasi App Lama

Client Belum Update: Jika ada outlet yang aplikasinya masih versi lama (nembak ke GAS Pusat), log validasi mereka akan terekam di Spreadsheet Pusat yang lama.
Tarik Data Harian: Gunakan tab Alat Migrasi > Sinkronisasi Data GAS ke D1 secara berkala untuk menarik log aktivasi terbaru dari Spreadsheet lama ke D1 sampai semua client update aplikasi.

Sistem Pusat sudah 100% Cloudflare D1: Tidak ada lagi Push Config manual dari Spreadsheet. Semua perubahan status lisensi, paket, atau suspend langsung aktif seketika.