absensi-sekolah-qr-code
# Aplikasi Web Sistem Absensi Sekolah Berbasis `QR Code` <br> (+ Dukungan RFID) <a href="https://github.com/ikhsan3adi/absensi-sekolah-qr-code/actions/workflows/ci.yml"> <img src="https://img.shields.io/github/actions/workflow/status/ikhsan3adi/absensi-sekolah-qr-code/ci.yml?branch=master&style=for-the-badge&label=Continuous%20Integration&labelColor=%239f39b5&logo=github" alt="Continuous Integration"> </a> <a href="https://github.com/ikhsan3adi/absensi-sekolah-qr-code/stargazers"> <img src="https://img.shields.io/github/stars/ikhsan3adi/absensi-sekolah-qr-code?style=for-the-badge&labelColor=%239f39b5&color=%2300bcd4&logo=github" alt="GitHub Repo stars"> </a> <a href="https://github.com/ikhsan3adi/absensi-sekolah-qr-code/graphs/contributors"> <img src="https://img.shields.io/github/contributors-anon/ikhsan3adi/absensi-sekolah-qr-code?style=for-the-badge&labelColor=%239f39b5&color=%2300bcd4&logo=github" alt="GitHub Contributors"> </a> <a href="https://github.com/ikhsan3adi/absensi-sekolah-qr-code/network/members"> <img src="https://img.shields.io/github/forks/ikhsan3adi/absensi-sekolah-qr-code?style=for-the-badge&labelColor=%239f39b5&color=%2300bcd4&logo=github" alt="GitHub forks"> </a> <a href="https://github.com/ikhsan3adi/absensi-sekolah-qr-code/watchers"> <img src="https://img.shields.io/github/watchers/ikhsan3adi/absensi-sekolah-qr-code?style=for-the-badge&labelColor=%239f39b5&color=%2300bcd4&logo=github" alt="GitHub watchers"> </a> ---  Aplikasi Web Sistem Absensi Sekolah adalah sebuah proyek yang bertujuan untuk mengotomatisasi proses absensi di lingkungan sekolah. Aplikasi ini dikembangkan dengan menggunakan framework CodeIgniter 4 dan didesain untuk mempermudah pengelolaan dan pencatatan kehadiran siswa dan guru. > [Instalasi & Cara Penggunaan](#cara-penggunaan) ## Fitur Utama - **QR Code scanner.** Setiap siswa/guru menunjukkan qr code kepada perangkat yang dilengkapi dengan kamera. Aplikasi akan memvalidasi QR code dan mencatat kehadiran siswa ke dalam database. - **RFID Integration.** Dukungan presensi menggunakan RFID card sebagai alternatif QR Code. Setiap siswa/guru dapat menggunakan RFID card untuk melakukan presensi dengan validasi kode RFID yang unik. - **Notifikasi Presensi via WhatsApp**. Setelah berhasil scan dan presensi, pemberitahuan dikirim ke nomor hp siswa melalui whatsapp. - **Login petugas.** - **Dashboard petugas.** Petugas sekolah dapat dengan mudah memantau kehadiran siswa dalam periode waktu tertentu melalui tampilan yang disediakan. - **Dashboard Wali Kelas.** Fitur khusus untuk guru wali kelas dengan kemampuan: - Memantau kehadiran siswa di kelas yang diampu - Mengelola data kehadiran siswa per kelas - Generate QR code untuk siswa di kelasnya - Generate laporan kehadiran khusus untuk kelas yang diampu - **QR Code generator & downloader.** Petugas yang sudah login akan men-generate dan/atau mendownload qr code setiap siswa/guru. Setiap siswa akan diberikan QR code unik yang terkait dengan identitas siswa. QR code ini akan digunakan saat proses absensi. - **Ubah data absen siswa/guru.** Petugas dapat mengubah data absensi setiap siswa/guru. Misalnya mengubah data kehadiran dari `tanpa keterangan` menjadi `sakit` atau `izin`. - **Tambah, Ubah, Hapus(CRUD) data siswa/guru.** - **Tambah, Ubah, Hapus(CRUD) data kelas.** - **Lihat, Tambah, Ubah, Hapus(CRUD) data petugas.** (khusus petugas yang login sebagai **`superadmin`**). - **Generate Laporan.** Generate laporan dalam bentuk pdf. - **Import Data.** Import data secara massal menggunakan file CSV: - Import data siswa dalam jumlah banyak - Import data guru - Import data kelas - Import data jurusan - **Backup & Restore.** Backup dan restore database serta file foto/QR code. > [!NOTE] > > ## Framework dan Library Yang Digunakan > > - [CodeIgniter 4](https://github.com/codeigniter4/CodeIgniter4) > - [Material Dashboard Bootstrap 4](https://www.creative-tim.com/product/material-dashboard-bs4) > - [Myth Auth Library](https://github.com/lonnieezell/myth-auth) > - [Endroid QR Code Generator](https://github.com/endroid/qr-code) > - [ZXing JS QR Code Scanner](https://github.com/zxing-js/library) > - [Chart.js](https://www.chartjs.org/) > > --- > > - [Fonnte](https://fonnte.com/) - WhatsApp API untuk mengirim pesan notifikasi ## Pratinjau ### Sistem Presensi | <img src="./screenshots/new-scanner-1.9.10.png" height="320px" alt="RFID Scanner"> <br> (NEW) QR Code + RFID | | :---------------------------------------------------------------------------------------------------------------------------------------------------------: | |  <br> Hasil Presensi Masuk/Pulang (OLD) | | <img src="./screenshots/notif-wa.png" width="320px" alt="Notifikasi WA"> <br> Notifikasi otomatis dikirim ke nomor HP siswa/guru setelah berhasil presensi. | | --- ### Dashboard Admin |  <br> Dashboard Utama |  <br> Absensi Siswa |  <br> Absensi Guru | | :----------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------: | |  <br> Generate Laporan |  <br> Data Siswa |  <br> Data Guru | |  <br> Generate QR Code |  <br> Data kelas, jurusan, dan **penugasan Wali Kelas**. |  <br> Backup & Restore | |  <br> Edit Status Kehadiran |  <br> Login Petugas |  <br> Pengaturan | --- ### Dashboard Wali Kelas |  |  | | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------: | | Dashboard khusus untuk guru wali kelas dengan statistik kehadiran siswa di kelasnya. | Wali kelas dapat melihat dan mengelola kehadiran siswa di kelas yang diampu. | --- ## Skema Database Inti <img src="./screenshots/core-absensi-db-schema.svg" alt="Skema Database"> --- ## Donasi ❤ Klik link dibawah untuk mendukung pengembangan [](https://trakteer.id/ikhsan3adi/tip) [](https://saweria.co/xiboxann) --- ## Cara Penggunaan ### Persyaratan - [Composer](https://getcomposer.org/). - PHP 8.1+ dan MySQL/MariaDB atau [XAMPP](https://www.apachefriends.org/download.html) versi 8.1+ dengan mengaktifkan extension `intl` dan `gd`. - Pastikan perangkat memiliki kamera/webcam untuk menjalankan qr scanner. Bisa juga menggunakan kamera HP dengan bantuan software DroidCam. ### Instalasi #### 1. Clone/Download Repository ```bash git clone https://github.com/ikhsan3adi/absensi-sekolah-qr-code.git cd absensi-sekolah-qr-code ``` #### 2. Install Dependencies Install semua dependencies menggunakan Composer: ```bash composer install ``` #### 3. Konfigurasi Environment - Jika belum ada file `.env`, copy dari `.env.example`: ```bash cp .env.example .env ``` - Edit file `.env` dan sesuaikan konfigurasi database: ```env database.default.hostname = localhost database.default.database = db_absensi database.default.username = root database.default.password = database.default.DBDriver = MySQLi ``` #### 4. Buat Database Buat database baru di MySQL/MariaDB: ```sql CREATE DATABASE db_absensi; ``` #### 5. Jalankan Migration Migration akan membuat semua struktur tabel yang diperlukan: ```bash php spark migrate --all ``` **Tabel yang akan dibuat:** - `tb_jurusan` - Master jurusan - `tb_kelas` - Data kelas - `tb_kehadiran` - Master status kehadiran - `tb_guru` - Data guru - `tb_siswa` - Data siswa - `tb_presensi_guru` - Presensi guru - `tb_presensi_siswa` - Presensi siswa - `users` - Akun pengguna (ditambah kolom `is_superadmin`, `id_guru`) - `general_settings` - Pengaturan aplikasi #### 6. Jalankan Seeder Seeder akan mengisi data awal yang diperlukan: ```bash php spark db:seed DatabaseSeeder ``` **Data yang akan di-seed:** - Status kehadiran: Hadir, Sakit, Izin, Tanpa keterangan - Jurusan: OTKP, BDP, AKL, RPL - Kelas awal: X, XI, XII untuk semua jurusan - Akun superadmin default - Pengaturan umum aplikasi #### 7. Jalankan Aplikasi **Menggunakan PHP Built-in Server:** ```bash php spark serve ``` Aplikasi akan berjalan di `http://localhost:8080` **Atau menggunakan XAMPP/Apache:** - Pastikan Apache dan MySQL sudah running - Akses aplikasi melalui browser #### 8. Login Login menggunakan kredensial superadmin default: ```txt Username: superadmin Password: superadmin Email: [email protected] ``` > [!CAUTION] > > Segera ubah password default setelah login pertama kali! #### 9. Setup Tambahan - **Izinkan akses kamera** untuk fitur QR Scanner - **Untuk RFID**: Hubungkan RFID reader USB ke komputer - **Untuk notifikasi WhatsApp**: Lihat bagian [Konfigurasi](#konfigurasi) di bawah > **Untuk panduan lengkap tentang migration dan seeder**, lihat [MIGRATION_GUIDE.md](./MIGRATION_GUIDE.md) ### Daftar Roles <details> <summary>Klik untuk melihat daftar roles</summary> - **Super Admin** - Admin utama dengan akses penuh - **Staf Petugas** - Admin - Dapat mengakses fitur absensi / manajemen kehadiran - Dapat mengakses fitur generate laporan - Dapat mengakses fitur generate QR - **Kepsek** - Kepala Sekolah dengan akses terbatas* - Dapat mengakses fitur generate laporan - **Scanner** - Petugas scanner QR Code - Hanya memiliki akses ke halaman scanner QR Code* \* Akses dapat berubah jika dihubungkan ke data guru / di-assign sebagai wali kelas </details> ### Cara Menggunakan Akun Wali Kelas Fitur Wali Kelas memungkinkan guru untuk mengelola kehadiran siswa di kelas yang diampu. Berikut cara mengaktifkan dan menggunakan fitur ini: #### Persiapan Data Pastikan data berikut sudah tersedia: - **Data Guru** sudah terdaftar di sistem - **Data Kelas** sudah dibuat #### Menautkan Guru sebagai Wali Kelas 1. Login sebagai **admin/superadmin** 2. Buka menu **Kelas & Jurusan** → **Data Kelas** 3. Klik tombol **Edit** pada kelas yang akan ditugaskan wali kelas 4. Pada dropdown **"Wali Kelas"**, pilih nama guru yang akan menjadi wali kelas 5. Klik **Simpan** #### Menautkan Wali Kelas ke Akun Petugas 1. Login sebagai **superadmin** 2. Buka menu **Data Petugas** 3. Untuk membuat akun baru: - Klik **Tambah Petugas** - Isi data: Email, Username, Password - Pilih Role: **Admin** (bukan Superadmin) - Pada dropdown **"Hubungkan ke Guru"**, pilih nama guru - Klik **Simpan** 4. Untuk mengedit akun yang sudah ada: - Klik **Edit** pada akun petugas - Pada dropdown **"Hubungkan ke Guru"**, pilih nama guru - Klik **Update** #### Login sebagai Wali Kelas 1. Logout dari akun superadmin 2. Login menggunakan **username dan password** yang sudah dibuat/dihubungkan ke data guru 3. Setelah login, sistem akan otomatis mendeteksi bahwa akun tersebut terhubung dengan data guru yang menjadi wali kelas 4. Dashboard Wali Kelas akan muncul dengan data kelas yang diampu #### Fitur Dashboard Wali Kelas Setelah login sebagai wali kelas, Anda dapat: - **Melihat Statistik Kehadiran**: Grafik dan data kehadiran siswa di kelas yang diampu - **Mengelola Kehadiran Siswa**: Lihat detail kehadiran setiap siswa per tanggal - **Generate QR Code**: Download QR Code untuk siswa di kelas yang diampu - **Generate Laporan**: Buat laporan kehadiran khusus untuk kelas yang diampu dalam format PDF #### Catatan Penting - Satu akun petugas hanya bisa dihubungkan ke **satu data guru** - Guru yang belum ditugaskan sebagai wali kelas tidak akan melihat menu Dashboard Wali Kelas - Wali kelas hanya dapat melihat dan mengelola data siswa di kelasnya sendiri - Akun superadmin memiliki akses penuh ke semua fitur, termasuk fitur wali kelas ### Import Data dari CSV Aplikasi mendukung import data secara massal menggunakan file CSV: - **Import Data Siswa** - Buka menu Data Siswa > Import CSV. Download template [csv_guru_template.csv](./public/assets/file/csv_siswa_template.csv) dan upload setelah diisi. Contoh [csv_siswa_example.csv](./public/assets/file/csv_siswa_example.csv) > Pastikan id kelas cocok dengan data kelas yang ada di database - **Import Data Guru** - Buka menu Data Guru > Import CSV. Download template [csv_guru_template.csv](./public/assets/file/csv_guru_template.csv) dan upload setelah diisi. > Perhatikan untuk impor data guru & siswa: > > ```csv > ...,jenis_kelamin,... <- kolom > ...,Laki-laki,... # contoh nilai valid > ...,Perempuan,... # pastikan sama persis > ``` - **Import Data Jurusan dan Kelas** - Buka menu Kelas & Jurusan > Jurusan > Import (Jurusan/Kelas). Download template [csv_jurusan_template.csv](./public/assets/file/csv_jurusan_template.csv) atau [csv_kelas_template.csv](./public/assets/file/csv_kelas_template.csv) dan upload setelah diisi. > Penting untuk memastikan kolom jurusan pada csv kelas harus **SUDAH ADA** dan **$PERSIS \space SAMA$** dengan yang ada di database jurusan. > > Direkomendasikan untuk impor jurusan dahulu lalu impor kelas **Catatan:** Gunakan encoding UTF-8 dan delimiter koma (,). Sistem akan mengabaikan data duplikat. ### Konfigurasi > [!IMPORTANT] > > - Konfigurasi file `.env` untuk mengatur base url(terutama jika melakukan hosting), koneksi database dan pengaturan lainnya sesuai dengan lingkungan pengembangan Anda. > - Untuk mengaktifkan **notifikasi WhatsApp**, pertama-tama ubah variabel `.env` berikut dari `false` menjadi `true`. > > ```sh > # .env > # WA_NOTIFICATION=false # sebelum > WA_NOTIFICATION=true > ``` > > Lalu masukkan token WhatsApp API. > > ```sh > # .env > WA_NOTIFICATION=true > WHATSAPP_PROVIDER=Fonnte > WHATSAPP_TOKEN=XXXXXXXXXXXXXXXXX # ganti dengan token anda > ``` > > _**Untuk mendapatkan token, daftar di website [fonnte](https://md.fonnte.com/new/register.php) terlebih dahulu. Lalu daftarkan device anda dan [dapatkan token Fonnte Whatsapp API](https://docs.fonnte.com/token-api-key/)**_ > > - Untuk mengubah konfigurasi nama sekolah, tahun ajaran logo sekolah dll sudah disediakan pengaturan (khusus untuk superadmin). > - Logo Sekolah Rekomendasi 100x100px atau 1:1 dan berformat PNG/JPG. > - Jika ingin mengubah email, username & password dari superadmin, **sebelum melakukan seed database**, buka file `app\Database\Migrations\2023-08-18-000004_AddSuperadmin.php` lalu ubah & sesuaikan kode berikut: > > ```php > // INSERT INITIAL SUPERADMIN > $email = '[email protected]'; > $username = 'superadmin'; > $password = 'superadmin'; > ``` ## Docker Setup (Opsional) Untuk menjalankan aplikasi menggunakan Docker, pastikan Docker dan Docker Compose sudah terinstal di komputer Anda. ### 1. Jalankan Container Jalankan perintah berikut di root project: ```bash docker-compose up -d --build ``` Perintah ini akan membangun image dan menjalankan container untuk aplikasi web, database, dan phpMyAdmin. ### 2. Akses Aplikasi - **Aplikasi Utama**: Akses melalui browser di `http://localhost:8080/` - **phpMyAdmin**: Akses melalui browser di `http://localhost:8081/` ### 3. Konfigurasi Aplikasi sudah dikonfigurasi untuk terhubung dengan database container secara otomatis. ### 4. Menghentikan Container Untuk menghentikan container: ```bash docker-compose down ``` --- ## Kesimpulan Dengan aplikasi web sistem absensi sekolah berbasis QR code ini, diharapkan proses absensi di sekolah menjadi lebih efisien dan terotomatisasi. Proyek ini dapat diadaptasi dan dikembangkan lebih lanjut sesuai dengan kebutuhan dan persyaratan sekolah Anda. Jangan lupa beri star 👍 ## Contributing Kami menerima kontribusi dari komunitas terbuka untuk meningkatkan aplikasi ini. Jika Anda menemukan masalah, bug, atau memiliki saran untuk peningkatan, silakan buat issue baru dalam repositori ini atau ajukan pull request. ## Star History <a href="https://www.star-history.com/#ikhsan3adi/absensi-sekolah-qr-code&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ikhsan3adi/absensi-sekolah-qr-code&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ikhsan3adi/absensi-sekolah-qr-code&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=ikhsan3adi/absensi-sekolah-qr-code&type=Date" /> </picture> </a> ## Kontributor - [@ikhsan3adi](https://www.github.com/ikhsan3adi) - [@reactmore](https://www.github.com/reactmore) - [@janglapuk](https://www.github.com/janglapuk) - [@nanda443](https://www.github.com/nanda443) - [@kevindoni](https://www.github.com/kevindoni) - [@pandigresik](https://github.com/pandigresik) - [@hex4coder](https://github.com/hex4coder)