Onboarding Toko Baru

Gambaran Umum

Memulai bisnis baru menggunakan platform Point of Sale (POS) tidak lagi memerlukan proses pendaftaran yang rumit atau waktu tunggu yang lama. Modul onboarding di Temuya dirancang khusus untuk memastikan para pemilik usaha—baik dari kalangan Food and Beverage (F&B) maupun retail umum—dapat segera menggunakan aplikasi dalam hitungan menit. Proses yang diusung mengedepankan pengalaman pengguna yang mulus, di mana setiap langkah memandu pengguna secara natural tanpa memberikan beban teknis yang tidak perlu.

Esensi dari onboarding di Temuya adalah automatisasi. Ketika seorang pengusaha memutuskan untuk menggunakan layanan kita, sistem di balik layar akan bekerja keras menyiapkan segala infrastruktur awal yang dibutuhkan. Dengan begitu, setelah beberapa langkah pengisian formulir yang sederhana, pengguna akan disambut oleh dashboard yang sudah berisi contoh data relevan dengan jenis usahanya.

Skenario Bisnis: Membuka Gerai Pertama

Bayangkan seorang pengusaha muda bernama Budi yang baru saja menyewa sebuah tempat untuk merintis kedai kopi impiannya. Budi sedang mencari solusi kasir yang andal namun cepat dioperasikan karena hari peluncuran gerainya sudah dekat. Ia menemukan halaman registrasi Temuya. Di sana, Budi cukup memilih jenis usahanya sebagai “Food and Beverage”, mengisi nama kedainya “Kopi Senja”, serta memasukkan informasi kontak dasar.

Dalam hitungan detik setelah Budi menekan tombol daftar, sistem langsung mengarahkan Budi ke dashboard POS. Yang membuat Budi terkesan adalah, kasirnya tidak kosong melompong. Sudah ada kategori seperti “Kopi”, “Non-Kopi”, dan “Cemilan” beserta beberapa produk contoh yang bisa langsung ia coba transaksikan. Budi pun bisa segera berlatih menggunakan mesin kasir tersebut bersama pegawainya tanpa harus membuang waktu menginput data awal satu per satu. Itulah keajaiban pengalaman onboarding yang Temuya tawarkan.

Alur Kerja

Proses pembuatan toko ini terdiri dari beberapa langkah berurutan yang saling berkaitan, memastikan kelengkapan data sebelum toko benar-benar aktif.

1. Pemilihan Jenis Bisnis
   Pada langkah paling awal, pengguna dihadapkan pada pilihan esensial mengenai kategori usaha mereka. Apakah ini bisnis Food and Beverage yang memerlukan manajemen meja dan pengaturan dapur, atau bisnis Retail yang lebih berfokus pada manajemen stok barang dan varian produk. Pilihan ini akan menjadi landasan bagaimana sistem menata tampilan dan fitur bawaan ke depannya.

2. Pengisian Informasi Dasar
   Setelah menetapkan jenis bisnis, pengguna diminta melengkapi profil usahanya. Form ini mencakup nama toko, nomor telepon kontak, alamat email, dan jika ada, sebuah kode referral. Sistem memastikan antarmuka tetap bersih dengan validasi langsung di sisi peramban, sehingga kesalahan ketik dapat segera diperbaiki.

3. Pembuatan Identitas Unik (Slug Generation)
   Dari nama toko yang diinput, sistem akan secara cerdas meracik sebuah slug atau URL unik untuk toko tersebut. Misalnya, “Kopi Senja” akan diubah menjadi kopi-senja. Slug ini sangat krusial karena akan digunakan sebagai penanda tenant di dalam arsitektur sistem, memisahkan data toko Budi dari ribuan toko lainnya. Jika nama sudah ada, sistem akan menambahkan angka acak untuk memastikan keunikannya.

4. Inisialisasi Otomatis (Seed & Provisioning)
   Ini adalah tahap di mana sihir sesungguhnya terjadi. Setelah data disubmit, sistem akan menginisialisasi lingkungan khusus untuk toko baru ini. Kategori default akan dibentuk, beberapa produk dummy akan disuntikkan sesuai jenis bisnis yang dipilih pada langkah pertama, inventori awal akan diatur, dan toko akan diberikan token masa uji coba gratis secara otomatis agar dapat langsung menggunakan fitur premium dalam batas waktu tertentu.

flowchart TD
    A[Mulai Registrasi] --> B{Pilih Jenis Bisnis}
    B -->|F&B| C1[Set Template F&B]
    B -->|Retail| C2[Set Template Retail]
    C1 --> D[Isi Nama Toko & Kontak]
    C2 --> D
    D --> E[Sistem Auto-Generate Slug]
    E --> F[Kirim Request POST /api/tenants]
    F --> G[Sistem Backend Bekerja]
    
    subgraph Proses di Backend
    G --> H[Buat Record Tenant]
    H --> I[Buat Struktur Default Kategori]
    I --> J[Inject Produk Dummy]
    J --> K[Set Inventori Awal]
    K --> L[Berikan Token Trial]
    end
    
    L --> M[Selesai & Masuk Dashboard]

Teknologi & Infrastruktur

Infrastruktur onboarding dirancang untuk menangani pembuatan data secara serentak namun tetap menjaga integritas multi-tenant.

Endpoint utama yang bertanggung jawab atas proses ini adalah POST /api/tenants. Begitu payload diterima, berbagai fungsi orchestrator akan berjalan untuk menenun data-data relasional yang dibutuhkan. Proses ini dirancang menggunakan transaksi basis data yang solid, sehingga jika di tengah jalan terjadi kegagalan (misalnya server tiba-tiba penuh), seluruh proses akan dibatalkan (rollback) dan tidak ada data toko setengah matang yang tertinggal di sistem.

Endpoint	Method	Deskripsi	Parameter Utama
/api/tenants	POST	Mendaftarkan toko baru dan melakukan seeding awal	name, type, contact, referral
/api/tenants/check-slug	GET	Memeriksa ketersediaan nama unik toko	slug

Keterkaitan dengan Fitur Lain

Proses onboarding bukan sekadar pengisian formulir, melainkan pintu gerbang menuju berbagai subsistem Temuya:

• Billing dan Plan: Toko yang baru dibuat langsung dikaitkan dengan sistem penagihan. Sistem akan mengalokasikan token masa uji coba (trial token) sehingga pengguna dapat mencicipi fitur-fitur berbayar secara cuma-cuma selama beberapa waktu.
• Multi-Tenant Architecture: Setiap data yang dihasilkan saat onboarding akan diberi label Tenant ID yang spesifik. Ini menjamin data produk, kasir, dan laporan Budi tidak akan pernah tertukar atau bocor ke toko milik orang lain.
• Katalog Produk & Inventori: Data contoh (dummy data) yang disuntikkan langsung berinteraksi dengan modul katalog, memastikan struktur inventori awal sudah siap digunakan dan dioprek.

Hal Penting yang Perlu Diketahui

Satu hal yang patut mendapat perhatian lebih adalah pentingnya pemilihan tipe bisnis di awal. Sistem tidak memperkenankan pengguna untuk mengubah tipe bisnis secara sewenang-wenang setelah data awal terbuat, karena seluruh fondasi katalog dan operasional telah dikonfigurasi berdasarkan pilihan tersebut. Selain itu, karena proses provisioning menyuntikkan cukup banyak data ke dalam basis data, operasi ini sedikit membutuhkan waktu, sehingga antarmuka harus selalu memberikan umpan balik (seperti animasi memuat) yang jelas kepada pengguna agar mereka tidak berpikir aplikasi mengalami macet.