# 📘 DOKUMENTASI PROJECT
# SISTEM PENGUMUMAN KELULUSAN MTs
## Django + SQLite + QR Verification + PDF Generator

---

# 1. DESKRIPSI PROJECT

Project ini adalah sistem pengumuman kelulusan siswa MTs berbasis web menggunakan Python dan Django.

Sistem dibuat modern seperti portal pengumuman SPMB universitas/kampus dengan tampilan profesional, elegan, responsive, dan aman.

Siswa cukup memasukkan NISN untuk melihat hasil kelulusan dan mengunduh surat keterangan lulus dalam bentuk PDF yang dilengkapi QR Code verifikasi.

---

# 2. TUJUAN PROJECT

Tujuan utama sistem:

- Mempermudah pengumuman kelulusan siswa secara online
- Mengurangi kerumunan saat pengumuman
- Mempercepat distribusi surat kelulusan
- Menyediakan validasi surat berbasis QR Code
- Memberikan tampilan modern seperti portal kampus
- Siap digunakan ulang setiap tahun

---

# 3. TEKNOLOGI YANG DIGUNAKAN

## Backend
- Python 3.12+
- Django 5+

## Database
- SQLite

## Frontend
- Bootstrap 5
- Bootstrap Icons
- HTML5
- CSS3
- JavaScript

## Library Tambahan
- qrcode
- pillow
- weasyprint
- pandas
- openpyxl

---

# 4. FITUR UTAMA

## 4.1 Landing Page Modern

Halaman utama menampilkan:

- Logo sekolah
- Nama madrasah
- Judul pengumuman
- Tahun ajaran
- Form input NISN
- Tombol cek hasil
- Countdown pengumuman
- Background modern
- Gradient
- Glassmorphism effect

---

## 4.2 Cek Kelulusan Berdasarkan NISN

Siswa memasukkan NISN.

Sistem:
- mencari data siswa
- menampilkan hasil kelulusan

Jika ditemukan:
- tampil identitas siswa
- tampil status lulus/tidak lulus

---

## 4.3 Tampilan Hasil Kelulusan

Menampilkan:

- Foto siswa
- Nama lengkap
- NISN
- Kelas
- Status kelulusan
- QR Code
- Tombol download PDF

Jika lulus:
```text
SELAMAT!
ANDA DINYATAKAN LULUS