e-Rapor PAUD

Bab 1 Informasi Sistem

e-Rapor PAUD adalah sistem informasi akademik berbasis web yang dirancang khusus untuk satuan PAUD (Taman Kanak-Kanak, Kelompok Bermain, Taman Penitipan Anak) dalam mengelola data perkembangan anak, input capaian pembelajaran, dan mencetak rapor serta dokumen kelulusan.

Fitur Utama

• Manajemen Sekolah — Profil, logo, alamat, NPSN, akreditasi
• Manajemen Guru & Siswa — Data lengkap, import/export CSV
• Rombongan Belajar — Pembagian kelas dengan wali kelas
• Input Nilai Raport — Predikat (BB/MB/BSH/BSB) + deskripsi narasi
• Cetak Dokumen — Rapor (narrative format), SKTB, Ijazah, Profil
• Template Cetak — 3 tema (Formal, Casual, Ceria), 2 mode kop surat
• Manajemen Kelulusan — Alur kelulusan siswa

Teknologi

Struktur Aplikasi

Setelah instalasi, struktur folder utama:

Bab 2 Persyaratan Sistem

Tersedia dalam dua distribusi: dist_windows untuk instalasi mandiri di PC Windows, dan dist_hosting untuk deployment di server web publik.

Bab 3 Instalasi Windows dist_windows

Panduan langkah demi langkah untuk menjalankan e-Rapor PAUD di PC Windows menggunakan installer mandiri.

3.1. Unduh & Jalankan Installer

1. Unduh file installer
   Dapatkan file Setup_eRapor_PAUD_v1.0.0.exe dari penyedia aplikasi atau dari halaman selamat datang aplikasi (jika sudah berjalan).
2. Jalankan installer
   Klik dua kali file .exe. Jika muncul peringatan SmartScreen Windows, klik "Tetap jalankan" karena aplikasi ini menggunakan sertifikat tanda tangan yang aman.
3. Ikuti wizard
   Klik Next → Install → Finish. Installer akan menyalin semua file ke C:\Program Files\e-Rapor PAUD dan membuat shortcut di Start Menu & Desktop.
4. Service terinstall otomatis
   Setelah instalasi, sebuah jendela Command Prompt akan muncul sebentar untuk menginstall latar belakan service aplikasi.

3.2. Menjalankan Aplikasi

1. Buka shortcut
   Klik shortcut "e-Rapor PAUD (Mulai)" di Start Menu atau Desktop.
2. Tunggu proses startup
   Jendela Command Prompt akan menampilkan log:
   [1/3] Memulai PostgreSQL... [2/3] Menginstall dependensi... [3/3] Menjalankan server e-RAPOR...
3. Buka browser
   Akses http://localhost:3000. Halaman selamat datang akan muncul.

3.3. Menghentikan Aplikasi

• Jalankan stop.bat dari folder instalasi, atau
• Tekan Ctrl+C di jendela Command Prompt yang sedang berjalan.

3.4. Install Sebagai Windows Service (Otomatis)

Jika ingin aplikasi berjalan otomatis saat komputer menyala (tanpa perlu klik shortcut setiap kali), instal service menggunakan NSSM yang sudah tersedia:

1. Buka folder instalasi, klik kanan install-service.bat → Jalankan sebagai Administrator.
2. Service bernama "e-Rapor PAUD Server" akan terdaftar di Windows Services dan berjalan otomatis setiap startup.
3. Untuk menghapus service, jalankan remove-service.bat sebagai Administrator.

Bab 4 Deployment Hosting dist_hosting

Panduan untuk menjalankan e-Rapor PAUD di server hosting publik (web server) agar dapat diakses oleh banyak pengguna dari berbagai perangkat.

4.1. Persiapan File

1. Ekstrak folder dist_hosting
   Dapatkan folder dist_hosting/ dari paket distribusi. Folder ini berisi file yang sudah dioptimalkan untuk hosting.
2. Upload ke server
   Gunakan FTP / cPanel File Manager untuk mengupload seluruh isi folder ke direktori web server (biasanya public_html/ atau www/).
3. Pastikan mod_rewrite aktif
   File .htaccess sudah disertakan. Pastikan server Apache Anda memiliki modul mod_rewrite dan mod_headers aktif.

4.2. Konfigurasi Database (Supabase)

1. Buat akun Supabase
   Daftar di supabase.com (tersedia tier gratis).
2. Buat project baru
   Beri nama project (misal: erapor-paud) dan catat Project URL serta anon public key.
3. Jalankan schema SQL
   Buka halaman SQL Editor di dashboard Supabase, copy isi file supabase/schema.sql lalu jalankan.
4. Konfigurasi di aplikasi
   Edit file js/config.js pada baris:
   SUPABASE_URL: 'https://[project-id].supabase.co', SUPABASE_KEY: 'eyJhbGciOiJIUzI1NiIs...'
   Ganti dengan URL dan key dari project Anda.

4.3. Akses Aplikasi

Buka domain Anda (misal: https://erapor-paud.sch.id). Halaman selamat datang akan muncul. Anda dapat langsung melakukan registrasi sekolah dan memulai.

Bab 5 Registrasi & Login

5.1. Halaman Selamat Datang

Saat pertama kali membuka aplikasi, Anda akan melihat halaman selamat datang dengan tiga opsi:

• Masuk — Login untuk admin/guru yang sudah terdaftar
• Daftar Sekolah — Registrasi sekolah baru
• Lupa Password — Reset password jika lupa

5.2. Daftar Sekolah Baru

1. Klik tab "Daftar Sekolah" di halaman selamat datang.
2. Isi form pendaftaran dengan data:
   • Nama Sekolah (lengkap)
   • NPSN (Nomor Pokok Sekolah Nasional)
   • Alamat, Desa/Kelurahan, Kecamatan, Kota/Kabupaten
   • Provinsi
   • Nama Admin (penanggung jawab aplikasi)
   • Email Admin (untuk login & notifikasi)
   • Password (minimal 6 karakter)
3. Klik "Kirim Pendaftaran". Data sekolah dan akun admin akan dibuat otomatis.
4. Login otomatis — Setelah berhasil mendaftar, Anda akan langsung masuk ke dashboard.

5.3. Login

1. Masukkan Email (email admin yang didaftarkan) dan Password.
2. Pilih Kurikulum, Tahun Ajaran, dan Semester yang aktif.
3. Klik "Masuk". Dashboard utama akan tampil.

5.4. Menu Navigasi

Setelah login, sidebar kiri menampilkan menu berikut:

Bab 6 Input Data Master

Sebelum dapat mencetak rapor, semua data master harus diisi terlebih dahulu. Berikut urutan pengisian data yang disarankan.

6.1. Profil Sekolah

Buka menu Sekolah di sidebar. Isi:

• NPSN, NSS, akreditasi, tahun berdiri
• Alamat lengkap (jalan, desa, kecamatan, kota, provinsi)
• Kepala Sekolah & NIP Kepala Sekolah
• Logo sekolah (upload gambar persegi, akan tampil sebagai kop surat otomatis)

6.2. Data Guru

Buka menu Guru. Anda dapat:

• Tambah manual — Klik tombol "Tambah Guru", isi nama, NIP, jabatan, dll.
• Import CSV — Siapkan file CSV dengan format yang sesuai, lalu upload.
• Export CSV — Unduh data guru dalam format CSV untuk backup.

6.3. Data Siswa

Buka menu Siswa. Hal yang sama berlaku:

• Tambahkan siswa satu per satu atau import CSV.
• Setiap siswa dapat memiliki foto (upload pas foto).
• Data penting: Nama, NISN, tempat/tanggal lahir, jenis kelamin, nama orang tua/wali.

6.4. Rombongan Belajar (Rombel)

Buka menu Rombel:

1. Buat rombel baru — Tentukan nama kelas (misal: KB A, TK B1, dll).
2. Tentukan wali kelas — Pilih guru yang menjadi wali kelas.
3. Atur anggota — Pilih siswa mana saja yang masuk ke rombel ini.

6.5. Kurikulum & Aspek Penilaian

Buka Pengaturan → Kurikulum:

• Atur mata pelajaran / aspek perkembangan yang dinilai (Nilai Agama dan Moral, Fisik Motorik, Kognitif, Bahasa, Sosial-Emosional, Seni).
• Tentukan apakah setiap aspek menggunakan predikat (BB/MB/BSH/BSB) atau angka.
• Aktifkan fitur deskripsi otomatis AI (jika diinginkan).

Bab 7 Input Nilai Raport

Setelah semua data master terisi, langkah selanjutnya adalah menginput capaian pembelajaran siswa.

7.1. Memilih Rombel & Aspek

1. Buka menu Input Raport di sidebar.
2. Pilih Rombel (kelas) yang akan diinput.
3. Pilih Aspek Penilaian (misal: Nilai Agama dan Moral, Kognitif, dll.)
4. Tentukan mode input: Per Siswa (fokus satu siswa untuk semua aspek) atau Per Aspek (input satu aspek untuk semua siswa).

7.2. Format Input

Setiap aspek penilaian memiliki dua komponen:

• Predikat — Pilihan: BB (Belum Berkembang), MB (Mulai Berkembang), BSH (Berkembang Sesuai Harapan), BSB (Berkembang Sangat Baik).
• Deskripsi — Narasi capaian pembelajaran (maksimal 500 karakter untuk kerapihan cetak).

7.3. Projek P5 / P7

Selain aspek intrakurikuler, Anda juga dapat menambahkan projek (P5/P7):

• Projek memiliki tema, dimensi, dan deskripsi.
• Setiap siswa dapat memiliki beberapa projek.
• Projek akan tampil di halaman rapor pada bagian khusus.

7.4. Data Penunjang

Di halaman input nilai, Anda juga dapat mengisi data pendukung rapor:

• Tinggi Badan (TB), Berat Badan (BB), Lingkar Kepala (LK) per semester.
• Kehadiran — jumlah hari masuk, sakit, izin, tanpa keterangan.
• Catatan G7KAIH — Gerakan 7 Kebiasaan Anak Indonesia Hebat (jika diterapkan di sekolah).

Bab 8 Pengaturan Template Cetak

Fitur ini memungkinkan Anda mengatur tampilan dokumen cetak sesuai kebutuhan masing-masing sekolah.

8.1. Membuka Pengaturan Template

Buka Pengaturan → Template. Anda akan melihat daftar template yang sudah ada dan tombol untuk membuat template baru.

8.2. Membuat Template Baru

1. Klik "Buat Template" — Sebuah modal akan muncul.
2. Isi nama template (misal: "Rapor TK B 2026")
3. Pilih Gaya / Tema — Tersedia tiga tema:

   Tema	Ciri Khas
   Formal	Warna hijau tua, font resmi, layout klasik, cocok untuk dokumen resmi
   Casual	Warna hijau hangat, font modern, layout lebih santai
   Ceria	Warna cerah dengan aksen oranye, font playful, cocok untuk PAUD

4. Pilih mode Kop Surat — Dua opsi:
   • Otomatis — Kop surat akan digenerate otomatis dari logo, nama, dan alamat sekolah yang sudah diisi di profil.
   • Manual — Unggah gambar kop surat sendiri (format: PNG/JPG). Dilengkapi dengan alat crop untuk menyesuaikan ukuran cetak (2480×350 piksel).
5. Simpan template — Template akan aktif dan bisa dipilih saat mencetak.

8.3. Mengatur Template Default

Setelah membuat template, Anda dapat menetapkan salah satu sebagai template default dengan mengklik tombol "Jadikan Default" di baris template yang diinginkan. Template default akan otomatis terpilih saat membuka halaman cetak.

8.4. Preview Sebelum Cetak

Bab 9 Cetak Dokumen

Inti dari seluruh aplikasi. e-Rapor PAUD dapat mencetak berbagai jenis dokumen akademik dalam format PDF.

9.1. Halaman Cetak

Buka menu Cetak di sidebar. Halaman ini memiliki beberapa tab:

9.2. Mencetak Rapor

1. Pilih tab Rapor.
2. Pilih Template dari dropdown (template default terpilih otomatis).
3. Pilih Rombel (kelas) dan Siswa.
4. Pilih jenis rapor:
   • Rapor per Siswa — Rapor lengkap satu siswa (semua aspek, TB/BB/LK, kehadiran, P5, G7KAIH, tanda tangan).
   • Rapor Full — Rapor lengkap plus cover, profil, dan dokumen pendukung dalam satu file PDF.
5. Klik tombol "Cetak Rapor" atau "Cetak Full Rapor".
6. PDF akan terbuka di tab baru. Tekan Ctrl+P untuk mencetak ke printer atau Save as PDF untuk menyimpan.

9.3. Isi Rapor (Format Narrative)

Rapor menggunakan format narrative (deskriptif), bukan tabel angka. Formatnya meliputi:

• Kop Surat — Logo, nama sekolah, alamat (otomatis dari profil atau upload manual)
• Identitas Siswa — Nama, NISN, rombel, semester, foto
• Aspek Intrakurikuler — Predikat + deskripsi narasi untuk setiap aspek
• Muatan Lokal — Nilai muatan lokal (jika ada)
• Projek P5 — Tema, dimensi, dan deskripsi projek
• TB/BB/LK — Tinggi badan, berat badan, lingkar kepala
• Kehadiran — Statistik kehadiran per semester
• G7KAIH — Gerakan 7 Kebiasaan Anak Indonesia Hebat
• Tanda Tangan — Orang tua/wali, wali kelas, kepala sekolah

9.4. Mencetak SKTB & Ijazah

Pilih tab SKTB atau Ijazah, pilih siswa, lalu klik cetak. Format dokumen:

• SKTB — Surat Keterangan Tamat Belajar dengan narrative capaian, dilampiri kurikulum yang digunakan.
• Ijazah — Ijazah PAUD dengan format standar Dikdasmen.

9.5. Dokumen Umum

Bab 10 Pemecahan Masalah

10.1. Server Tidak Berjalan

10.2. PDF Tidak Muncul (Popup Terblokir)

Cara mengizinkan popup:

• Chrome: Klik ikon 🔒 di address bar → "Izinkan pop-up".
• Firefox: Klik ikon ⚠ di address bar → "Izinkan pop-up".
• Edge: Klik ikon 🔒 di address bar → "Izinkan".

10.3. Database Error

• Mode lokal: Pastikan folder pgsql\data ada dan tidak korup. Jalankan setup.bat untuk inisialisasi ulang.
• Mode Supabase: Periksa koneksi internet, pastikan URL dan key Supabase di js/config.js benar.
• Buka Pengaturan → About → "Jalankan Pengecekan" untuk mendiagnosis status sistem.

10.4. Lupa Password

1. Di halaman selamat datang, klik tab "Lupa Password".
2. Masukkan NPSN dan Email admin yang terdaftar.
3. Klik "Kirim". Jika data cocok, password akan direset dan dikirim ke email.
4. Gunakan password baru untuk login. Segera ganti di menu Pengaturan setelah masuk.

10.5. CSV Import Gagal

• Pastikan file CSV menggunakan delimiter koma (,) atau titik koma (;).
• Kolom header harus sesuai dengan format yang diharapkan (lihat contoh dengan mengekspor data yang sudah ada).
• Periksa apakah ada data duplikat (NISN/NIK yang sama).
• File CSV maksimal 2 MB.

10.6. Cetak Tidak Sesuai

• Kop surat tidak muncul: Pastikan template menggunakan mode yang benar. Untuk mode otomatis, periksa logo sekolah sudah diupload.
• Tema tidak berubah: Pastikan template yang dipilih memiliki gaya (formal/casual/ceria) yang diinginkan.
• Foto siswa tidak muncul: Pastikan foto sudah diupload di data siswa.
• Deskripsi terpotong: Deskripsi dibatasi 500 karakter. Persingkat narasi.

Penutup

Terima kasih telah menggunakan e-Rapor PAUD — Sistem Informasi Akademik yang dirancang khusus untuk memudahkan satuan PAUD dalam mengelola data dan mencetak dokumen rapor yang informatif dan menarik.

Aplikasi ini dikembangkan oleh Yayasan Al-Hikmah Ciptamargi sebagai kontribusi untuk meningkatkan kualitas administrasi pendidikan anak usia dini di Indonesia.

Kontak & Dukungan

Dokumentasi ini selesai disusun pada tahun 2026.
Hak cipta dilindungi undang-undang. © Yayasan Al-Hikmah Ciptamargi.