Panduan Instalasi KasPoint dari Nol Sampai Jalan

Daftar Isi

PoinTru.com - Satu hal yang sering bikin orang ragu mencobaKasPoint adalah proses instalasinya yang melibatkan Google Apps Script. Kedengarannya teknis dan menakutkan. Tapi Saya jamin, kalau Anda ikuti panduan ini langkah demi langkah, keseluruhan proses bisa selesai dalam 30-60 menit-bahkan tanpa pengalaman programming apapun.

Panduan instalasi KasPoint ini Saya tulis berdasarkan dokumentasi resmi v2.9 dan diperkaya dengan tips dari pengalaman nyata yang sering menjadi stumbling block bagi pemula. Yuk mulai!

Persiapan: Yang Perlu Disiapkan Sebelum Mulai

Sebelum memulai, pastikan Anda sudah punya:

• Akun Google aktif (Gmail biasa sudah cukup)
• Filecode_v26.js (kode backend Google Apps Script)
• Fileindex_v29.html (antarmuka frontend KasPoint)
• Browser Chrome atau Firefox versi terbaru
• Koneksi internet yang stabil

Tidak ada yang perlu dibeli atau didownload selain dua file tersebut. Semua infrastrukturnya sudah disediakan Google secara gratis.

Langkah	Platform	Estimasi Waktu
1. Buat Google Sheets baru	sheets.google.com	2 menit
2. Buka dan setup Apps Script	Extensions - Apps Script	10 menit
3. Deploy Web App	Apps Script Editor	5 menit
4. Jalankan manualSetupMenu	Apps Script Editor	3 menit
5. Setup sheet via menu KasPoint	Google Sheets	5 menit
6. Konfigurasi & login pertama	Browser (kaspoint.html)	10 menit

Langkah 1-3: Setup Backend Apps Script

Bagian ini adalah fondasi utama KasPoint. Ikuti dengan teliti:

Langkah 1 - Buat Google Sheets Baru

• Bukasheets.google.com dan login dengan akun Google Anda
• Klik tombol+ Blank untuk membuat spreadsheet baru
• Beri nama yang mudah diingat, misalnya:KasPoint Database

Langkah 2 - Buka dan Isi Apps Script

• Di Google Sheets yang baru dibuat, klik menuExtensions - Apps Script
• Tab baru akan terbuka dengan editor Apps Script
• Hapus seluruh kode default yang ada (biasanya berisi fungsimyFunction() kosong)
• Buka filecode_v26.js, salin semua isinya, dan paste ke editor Apps Script
• Cari baris paling atas yang berisiconst SALT = "KasPoint_051992";
• Ganti nilai SALT tersebut dengan string unik yang hanya Anda tahu, misalnya:const SALT = "TokoMaju_RahasiaKu_2025";
• Klik ikon Save atau tekan Ctrl+S, beri nama projectKasPoint

SANGAT PENTING: Ganti nilai SALT sebelum deploy. SALT digunakan untuk mengenkripsi semua password dan PIN. Setelah ada user yang terdaftar, jangan pernah ubah SALT lagi-semua password yang ada akan menjadi tidak valid dan pengguna tidak bisa login.

Langkah 3 - Deploy sebagai Web App

• Klik menuDeploy - New Deployment
• Klik ikon ️ di dialog yang muncul, pilihWeb app
• Isi pengaturan:Execute as: Me (wajib) danWho has access: Anyone (wajib)
• KlikDeploy - Authorize access
• Jika muncul peringatan "This app isn't verified", klikAdvanced - Go to KasPoint (unsafe) - Allow-ini normal untuk Apps Script personal
• SalinWeb App URL yang muncul (format:https://script.google.com/macros/s/XXXX/exec) dan simpan di tempat aman

Langkah 4-5: Aktivasi Menu KasPoint di Sheets

Nah sekarang ada langkah yang sering dilewatkan orang tapi sangat penting-menjalankanmanualSetupMenu:

Langkah 4 - Jalankan manualSetupMenu

• Di editor Apps Script, klikdropdown fungsi di pojok kiri atas editor (biasanya menampilkan nama fungsi saat ini)
• PilihmanualSetupMenu dari daftar
• Klik tombol ▶️Run
• Jika muncul popup authorize, klikAllow
• Kembali ke Google Sheets dan tekanF5 untuk refresh
• Menu KasPoint akan muncul di toolbar Google Sheets

Langkah 5 - Setup Semua Sheet Otomatis

• Di Google Sheets, klik menu KasPoint - Setup Awal (Buat Semua Sheet)
• Tunggu proses berjalan (biasanya 10-30 detik)
• Klik OK saat dialog konfirmasi muncul

Setelah ini, enam sheet otomatis terbuat: ACCOUNTS, TRANSACTIONS, DEBTS, ASSETS, USERS, dan CONFIG. Akun admin default juga sudah dibuat secara otomatis.

Jika menu KasPoint tidak muncul setelah refresh, coba buka Extensions - Apps Script - dropdown fungsi - pilih buildMenu_ - Run. Atau pasang trigger manual via menu Triggers (ikon jam) di editor Apps Script.

Langkah 6: Login Pertama dan Konfigurasi Awal

Sekarang bagian yang paling menyenangkan-menghidupkan aplikasi:

• Buka fileindex_v29.html di browser (dobel klik, atau drag ke browser)
• Di bagianKoneksi Apps Script yang muncul otomatis, paste Web App URL yang sudah Anda salin
• KlikSimpan URL - indikator berubah ke OK berwarna hijau
• Login dengan: Usernameadmin, Passwordadmin123
• Di v2.9, setelah login berhasil aplikasi langsung masuk ke halaman utama tanpa perlu reload

Setelah masuk, lakukan konfigurasi awal ini segera:

• Ganti password: Settings - Password - isi password lama admin123 dan password baru
• Buat PIN keamanan: Settings - PIN - buat PIN 4-6 digit
• Tambah akun saldo: Settings - Akun - Tambah Akun Baru (minimal buat akun Tunai, rekening Bank, dan Profit)
• Konfigurasi fee: Settings - Config - Akun Penampung Fee =Profit

Apa yang harus dilakukan jika deployment gagal dengan error "Authorization required"?

Error ini biasanya muncul karena proses otorisasi belum selesai. Ulangi langkah Deploy - New Deployment, dan saat proses otorisasi, pastikan Anda mengklik "Authorize access" dan menyelesaikan seluruh alur persetujuan Google. Jika muncul peringatan "app isn't verified", itu normal-klik Advanced - Go to KasPoint (unsafe) - Allow untuk melanjutkan.

Apakah URL Web App berubah jika saya update kode Apps Script?

URL tidak berubah jika Anda menggunakan "Update existing deployment". URL hanya berubah jika Anda membuat "New Deployment" yang benar-benar baru. Untuk update kode, selalu gunakan Deploy - Manage Deployments - Edit (ikon pensil) - ubah Version ke "New version" - Deploy. Ini memastikan URL tetap sama dan aplikasi HTML Anda tidak perlu dikonfigurasi ulang.

Bagaimana jika saya ingin mengakses KasPoint dari smartphone?

Host file kaspoint.html di layanan gratis. Cara termudah: buka Netlify Drop (app.netlify.com/drop), drag-and-drop file HTML ke halaman tersebut, dan dalam hitungan detik Anda mendapat URL publik yang bisa diakses dari browser smartphone manapun. Alternatif lain: GitHub Pages atau Vercel. Setelah dihost, URL Apps Script hanya perlu dikonfigurasi sekali di aplikasi.

Akhir Kata

Jadi, intinya instalasi KasPoint terdiri dari enam langkah utama yang semuanya bisa dikerjakan sendiri tanpa bantuan IT professional: buat Sheets, setup Apps Script, deploy Web App, aktifkan menu, setup sheet otomatis, dan login pertama. Dari pengalaman Saya, bagian yang paling sering menyebabkan kebingungan adalah proses otorisasi Google dan lupa menjalankan manualSetupMenu-dua hal yang justru paling penting dilakukan. Kalau ada pertanyaan, feel free buat komen di bawah ya!

Untuk membaca artikel lainnya, cek aja diSitemap.