Kebutuhan: Node.js 20.9 atau lebih baru dan MySQL/MariaDB (paling mudah pakai XAMPP atau Laragon).
Ekstrak file ZIP, lalu buka terminal (Command Prompt / PowerShell) di dalam folder spp-tk.
Install paket:
npm install
Salin .env.example menjadi .env.local. Isi bawaannya sudah cocok untuk XAMPP (user root tanpa password):
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=root
DB_PASSWORD=
DB_NAME=spp_tk
APP_URL=http://localhost:3000
DB_TIMEZONE=+07:00
Jalankan MySQL di XAMPP/Laragon, lalu buat database beserta data contohnya:
npm run setup
Atau import database/spp_tk.sql lewat phpMyAdmin (tab Import). Tanggal data contoh menyesuaikan hari saat import.
Jalankan aplikasi:
npm run dev
Buka http://localhost:3000 dan masuk dengan akun demo:
admin / admin123bendahara / tk12345guru / tk12345Ubah nama sekolah, tanggal jatuh tempo, rekening, dan template pesan di menu Pengaturan, atur tarif di Kelas & tarif, lalu ganti kata sandi akun demo.
Untuk dipakai sehari-hari: jalankan npm run build sekali, lalu npm start (lebih cepat dari mode dev). Agar portal wali bisa dibuka dari HP orang tua, isi APP_URL dengan alamat yang bisa diakses dari luar (misalnya hosting atau domain sekolah).
Pengingat otomatis (opsional): daftar di fonnte.com, isi token di Pengaturan, centang Aktifkan pengingat otomatis, lalu jadwalkan npm run pengingat sekali sehari lewat Task Scheduler (Windows) atau cron (Linux).
Dukung Papicode, jadi sponsor
Link kamu tampil di sini mulai Rp1.000.