PERPUS

Tampilan

Instalasi ​

Memasang sistem PERPUS untuk sekolah baru melibatkan beberapa tahap berurutan: daftar akun sekolah, deploy website sekolah, lalu aktivasi tiap perangkat. Ikuti urutan berikut.

Ringkasan alur ​

  1. Daftar akun sekolah di Portal Sekolah → dapatkan kode lisensi.
  2. Deploy website sekolah lewat wizard di aplikasi Desktop (menu Website → Instalasi).
  3. Buka website sekolah hasil deploy → halaman /setup → aktivasi + buat akun admin pertama.
  4. Aktivasi aplikasi Desktop itu sendiri di halaman Lisensi.
  5. (Opsional) Aktivasi aplikasi Mobile di HP petugas.

Detail tiap langkah aktivasi ada di Aktivasi Lisensi. Bagian di bawah ini fokus pada tahap deploy website sekolah, yang hanya dilakukan sekali oleh satu petugas (biasanya admin) saat pertama kali memasang sistem.

1. Daftar akun sekolah ​

Buka Portal Sekolah → halaman Daftar (/signup):

  1. Isi Nama Sekolah / Penanggung Jawab, Email, dan Password (minimal 8 karakter).
  2. Klik Daftar. Sistem mengirim email verifikasi.
  3. Buka email dan klik link verifikasi, atau klik Kirim Ulang Email Verifikasi di dashboard portal bila belum diterima.
  4. Setelah email terverifikasi, di dashboard portal klik Buat Lisensi untuk mendapatkan kode lisensi berformat LSN-XXXX-XXXX-XXXX. Lisensi baru otomatis bertingkat Free.
  5. Simpan kode ini baik-baik — dipakai berulang di langkah-langkah berikutnya.
  6. Di menu Lisensi portal, daftarkan domain/URL yang akan dipakai website sekolah (contoh: nama-sekolah.pages.dev). Domain ini harus disetujui (approved) sebelum bisa didaftarkan dari wizard desktop di langkah berikutnya.

2. Deploy website sekolah lewat aplikasi Desktop ​

Pasang aplikasi Desktop di komputer perpustakaan, lalu buka menu Website → Instalasi. Wizard terdiri dari 8 langkah:

  1. Cek Environment — memeriksa Node.js dan koneksi internet ke Cloudflare. Klik Cek Environment, lalu Lanjut kalau semua sudah OK.
  2. Pilih Sumber Web — pilih "Hasil build siap-pakai (disarankan)" untuk pengguna umum.
  3. Akun Cloudflare — masukkan API Token Cloudflare (buat di dash.cloudflare.com/profile/api-tokens dengan izin Pages: Edit, D1: Edit, Account Settings: Read). Klik Test Koneksi untuk memverifikasi, lalu Lanjut. Token tersimpan aman di penyimpanan kredensial sistem operasi, bukan di file biasa.
  4. Konfigurasi Project — beri nama project Cloudflare Pages dan database. Opsional: aktifkan ImageKit (untuk penyimpanan foto — lihat Setelan ImageKit cara mendapatkan Private Key) dan custom domain.
  5. Jalankan Migration — sistem menyiapkan struktur database secara otomatis.
  6. Build & Deploy — sistem membangun dan menerbitkan website. Hasilnya berupa URL website sekolah, misalnya https://nama-sekolah.pages.dev.
  7. Set Secrets — masukkan Kode Lisensi yang didapat di langkah 1, klik Daftarkan untuk mendaftarkan instalasi ini ke server lisensi, lalu Simpan Secret & Lanjut.
  8. Selesai — ringkasan hasil deploy dan langkah selanjutnya ditampilkan.

3. Setup akun admin pertama di website ​

Buka URL website sekolah hasil deploy. Karena belum ada akun, sistem otomatis mengarahkan ke halaman /setup:

  1. Masukkan Kode Lisensi yang sama.
  2. Isi Username Admin dan Password Admin (minimal 8 karakter).
  3. Klik Aktivasi & Buat Akun.

Setelah berhasil, Anda otomatis masuk ke dashboard website sebagai admin pertama.

4. Aktivasi perangkat Desktop & Mobile ​

Lanjutkan ke Aktivasi Lisensi untuk mengaktifkan aplikasi Desktop (halaman Lisensi) dan aplikasi Mobile di HP petugas.

TIP

Kode lisensi yang sama dipakai berulang kali: untuk mendaftarkan instalasi website (langkah 2.7), lalu untuk mengaktifkan setiap perangkat (desktop, mobile) yang tersambung ke sekolah yang sama.