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)

Custom Portal URL

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	Data Payload (JSON)	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}

Pengalihan Portal Pelanggan

Konfigurasi pengalihan otomatis dari portal lama ke portal baru.

Aktifkan Pengalihan Otomatis (Redirect) vip.laundryaja.biz.id ke nota.smartkey.id

Jika dicentang, pelanggan yang membuka link lama akan otomatis dialihkan ke domain portal baru yang lebih cepat. Jika dimatikan (misalnya saat sistem baru bermasalah), link lama akan memuat database Google Apps Script (GAS) lama sebagai cadangan backup.

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 SMARTKEY versi terbaru. Konfigurasi lisensi dan koneksi API dikelola oleh aplikasi, bukan diinput manual oleh outlet.
Validasi Lisensi: Aplikasi memeriksa lisensi melalui API SmartKey Pusat. Saat migrasi domain selesai, layanan API menggunakan api.smartkey.id.
Data Operasional: Transaksi, layanan, pelanggan, pegawai, absensi, dan laporan aplikasi Laundry disimpan pada Cloudflare D1 sesuai tenant outlet.

Migrasi Data Outlet

Sumber Data: Untuk outlet dari sistem lama, gunakan file Excel .xlsx dengan format template yang ditentukan. Google Spreadsheet tidak diperlukan untuk alur migrasi baru.
Proses Aman: Buka Alat Migrasi, unggah file, periksa hasil validasi dan pemetaan kolom, lalu lakukan impor ke D1 setelah data dinyatakan benar.
Data Lama: Spreadsheet/GAS hanya dipertahankan sebagai arsip atau referensi migrasi; tidak digunakan sebagai sumber data operasional aplikasi Cloudflare.

Alamat Sistem SmartKey

Dashboard Developer: admin.smartkey.id. Akses ini khusus administrator dan akan dilindungi Cloudflare Access.
Layanan Aplikasi: api.smartkey.id. Domain ini hanya untuk endpoint integrasi lisensi, konfigurasi, dan QRIS; tidak digunakan untuk membuka dashboard.
Domain Lama: smartkey.id tetap aktif selama masa transisi. Jangan mengubah endpoint aplikasi sebelum pengujian API baru selesai.

Sistem Pusat menggunakan Cloudflare D1: Perubahan lisensi, paket, QRIS, dan status outlet dikelola dari dashboard Pusat. Lakukan migrasi data melalui Excel dan proses validasi sebelum impor.