SMP PGRI 1 Kuwarasan — System e-Rapot Online Berbasis Google Apps Script & GitHub Pages.
Aplikasi web modern, ringan, dan responsif untuk menampilkan Laporan Hasil Belajar Penilaian Sumatif Tengah Semester (PSTS) siswa secara instan melalui Nomor Induk Siswa (NIS). Sistem ini terintegrasi langsung dengan database Google Sheets dan dilengkapi dengan analisis kinerja belajar siswa secara otomatis.
![]() |
| Tampilan Dashboard |
![]() |
| Tampilan E-Rapor / Kartu Hasil Belajar |
- 🔍 Pencarian Cepat Berbasis NIS: Siswa/Orang tua cukup memasukkan NIS untuk melihat hasil belajar.
- 📜 Format PDF Resmi 1:1: Tampilan KOP sekolah, data siswa, dan tabel nilai disesuaikan dengan format cetak fisik A4 resmi sekolah.
- 🔤 Dukungan Terbilang Otomatis: Membaca nilai angka sekaligus teks terbilang (huruf) dari spreadsheet atau menggenerasinya secara otomatis.
- 📊 Catatan Evaluasi & Deskripsi Otomatis:
- Mengidentifikasi mata pelajaran unggulan (Kelebihan).
- Mendeteksi mata pelajaran di bawah KKTP (70) secara presisi.
- Memberikan rekomendasi tindakan siswa serta saran sinergi orang tua & guru secara dinamis.
- 🖨️ Siap Cetak / Export PDF: Aturan
@media printkhusus memastikan rapot muat rapi dalam 1 halaman A4.
[ Google Sheets (Database) ]
│
▼
[ Google Apps Script (REST API / doGet) ]
│ (JSON)
▼
[ Web Frontend (HTML5 + Tailwind CSS) ] ──► GitHub PagesAgar skrip dapat membaca data nilai dengan akurat, susun header kolom pada Google Sheets Anda seperti berikut:
| NIS | Nama | Kelas | Pai | Terbilang Pai | Pp | Terbilang Pp | B. Indo | Terbilang Bindo | Mat | Terbilang Mat | ... | Walas |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| XXXXX | XXXXXXX | 9X | 82 | Delapan Puluh Dua | 75 | Tujuh Puluh Lima | 83 | Delapan Puluh Tiga | 70 | Tujuh Puluh | ... | Catur P, S.Pd. |
- Aturan Penting:
- Pastikan kolom
NISdanNamaselalu ada. - Kolom terbilang diberi nama dengan awalan
Terbilang(contoh:Terbilang Pai,Terbilang Mat). Skrip akan otomatis memasangkannya dengan kolom mapel di sebelah kirinya. - Setiap sheet (tab) dapat dinamai sesuai nama kelas (contoh:
7A,8B,9A).
- Pastikan kolom
Berikut adalah langkah demi langkah untuk menerapkan aplikasi ini dari awal:
- Buka Google Sheets yang berisi data nilai siswa.
- Klik menu Ekstensi (Extensions) Apps Script.
- Hapus seluruh kode bawaan, lalu salin dan tempel kode
Code.gsdari repositori ini. - Sesuaikan objek
WALI_KELASatau pastikan kolomWalasdi spreadsheet terisi. - Simpan proyek dengan menekan tombol
Ctrl + S. - Klik Terapkan (Deploy) Penenerapan baru (New deployment).
- Pilih jenis: Aplikasi Web (Web App).
- Deskripsi:
PSTS API v1 - Jalankan sebagai (Execute as):
Saya (Me / Email Anda) - Yang memiliki akses (Who has access):
Siapa saja (Anyone)
- Deskripsi:
- Klik Terapkan (Deploy) dan berikan izin akses (Grant Access).
- Salin URL Aplikasi Web yang dihasilkan (URL ini berakhiran
/exec).
- Unduh atau clone repositori ini ke komputer Andagit clone [https://github.com/username-anda/nama-repo.git](https://github.com/username-anda/nama-repo.git)
- Ganti teks petik dengan URL Aplikasi Web yang Anda dapatkan pada Langkah 1.
- Simpan berkas
index.html.
- Push perubahan berkas
index.htmlke repositori GitHub Anda. - Buka repositori Anda di GitHub.
- Masuk ke menu Settings Pages.
- Pada bagian Build and deployment:
- Source: Pilih
Deploy from a branch. - Branch: Pilih
main(ataumaster) dan folder/ (root).
- Klik Save.
- Tunggu 1–2 menit, web rapot Anda akan aktif di URL:
https://username-anda.github.io/nama-repo/.
- Frontend: HTML5, JavaScript (ES6 Async/Fetch), Tailwind CSS CDN, FontAwesome Icons.
- Backend: Google Apps Script (V8 Engine).
- Database: Google Sheets.
- Hosting: GitHub Pages.
Proyek ini didistribusikan di bawah lisensi MIT License. Bebas digunakan, dimodifikasi, dan dikembangkan kembali untuk keperluan edukasi dan sekolah.
- Buka halaman utama repositori Anda di GitHub.
- Jika berkas
README.mdbelum ada, klik tombol Add file Create new file. - Beri nama berkas:
README.md. - Tempelkan seluruh teks Markdown di atas ke dalam editor.
- Klik tombol Commit changes... di pojok kanan atas.
Proyek ini dirilis di bawah lisensi MIT License dan dipersembahkan secara GRATIS untuk seluruh Guru dan Tenaga Kependidikan di seluruh Indonesia.
Anda bebas menggunakan, menggandakan, memodifikasi, dan menerapkan sistem e-Rapot ini di sekolah Anda masing-masing tanpa dipungut biaya.
Aplikasi ini dikembangkan dan didesain oleh Catur Pamungkas (Kang Toer). Jika Anda menggunakan atau mengembangkan ulang proyek ini, sangat dihargai untuk tetap mencantumkan kredit pengembang asli.
Yuk, terhubung dan dukung terus pengembangan karya-karya teknologi pendidikan lainnya! Kunjungi situs web resmi dan ikuti media sosial saya melalui tautan di bawah ini:
Silakan klik ikon atau tautan di bawah ini untuk terhubung secara langsung:
| Media Sosial | Tautan Resmi |
|---|---|
| pamungkas.toer | |
| @kangtoer | |
| @kangtoer | |
| @KangToer | |
| @kangtoer | |
| Join Channel WhatsApp |
GITHUB SOURCE :
https://github.com/kangtoer/PSTSGANJIL


Kolom Komentar
Komentar
Posting Komentar