Layanan pencarian dan perbandingan data publik sekolah di seluruh negeri

Halo. Saat mencari informasi sekolah, saya ingin mengurangi ketidaknyamanan karena harus bolak-balik antara berbagai situs dan file Excel, jadi saya membuat Uri Hakgyo Eottae.

Seluruh proses pengembangan dilakukan dengan pendekatan vibe coding. Ini bukan proyek yang selesai hanya dengan sekali meminta AI menghasilkan kode; saya membagi kebutuhan ke dalam dokumen, lalu berulang kali membandingkan hasil implementasi dengan data nyata dan memperbaiki kesalahan yang ditemukan. Khususnya untuk data sekolah, saya menilai bahwa yang lebih penting daripada tampilan yang meyakinkan adalah memastikan data tidak salah terhubung ke sekolah lain, sehingga saya menghabiskan waktu paling banyak pada pemetaan dan validasi.

Dalam layanan ini, pengguna dapat mencari nama sekolah, membandingkan sekolah dalam jenjang yang sama, membandingkan data publik per wilayah, serta memeriksa data capaian akademik per mata pelajaran dan hasil sidang komite penanganan kekerasan di sekolah. Angka yang dikonfirmasi dari sumber asli dan indikator hasil perhitungan sendiri ditampilkan secara terpisah.

Komposisi data

• Informasi dasar sekolah
• Kelas dan jumlah siswa
• Jumlah guru
• Informasi perpindahan siswa (masuk, keluar)
• Jam penyelesaian pendidikan keselamatan
• Hasil komite penanganan kekerasan di sekolah
• Capaian akademik per mata pelajaran (hanya skor rata-rata yang dicerminkan)

Susunan teknologi

• Next.js App Router, TypeScript, Tailwind CSS
• Firebase Firestore dan Firebase Admin SDK
• Deployment Vercel dan otomatisasi GitHub Actions
• search-index.json statis untuk pencarian di browser
• JSON statis untuk halaman detail sekolah, peringkat, dan perbandingan
• Pengumpulan data NEIS·Hakgyoallimi serta penerapan perubahan berbasis row_hash
• Alat impor materi publikasi manual yang mengenali struktur tabel pada file XLS Hakgyoallimi

Bagian yang lebih sulit dari perkiraan saat membuatnya

Yang paling rumit adalah pencocokan nama sekolah. Karena ada sekolah dengan nama yang sama, sekolah yang berganti nama, sekolah yang ditutup, dan sekolah dengan nama sama tetapi jenjang berbeda, menghubungkannya hanya berdasarkan nama sekolah dapat menimbulkan salah pemetaan. Saya mengubah pendekatannya dengan memprioritaskan kode sekolah, informasi kantor dinas pendidikan, wilayah, dan jenjang sekolah, lalu menyisakan item yang tidak bisa dipastikan secara otomatis sebagai target verifikasi terpisah.

File XLS untuk capaian akademik dan pengungkapan kekerasan di sekolah juga tidak selalu memiliki posisi kolom tabel yang sama persis. Jika dibaca dengan nomor kolom tertentu yang dipatok tetap, nilai yang salah bisa masuk namun tampak seperti angka yang normal, sehingga saya menambahkan tahap validasi yang memeriksa judul tabel dan header untuk membedakan format, serta memastikan nilai di luar rentang tidak ikut diterapkan.