Secure QR AttendanceSystem Documentation

A teacher-led, QR-based attendance monitoring platform for schools — built with Next.js, Prisma, and PostgreSQL.

📷

Teacher-as-Scanner

Teachers use their phone camera to scan a student's QR code and instantly mark attendance PRESENT for the selected subject.

🛡️

Server-Side Validation

Every scan is verified end-to-end — the token must map to a real student, the teacher must own the subject, and the student must be enrolled.

🗂️

Full Admin Control

Bulk CSV import, per-section rosters, staff management, immutable audit logs, JSON backups, and one-click data reset.

📝

Appeals & Fallbacks

Manual roster toggles and evidence-based appeals ensure attendance is still correct when scanning is not possible.

🔒

Auditable by Design

Every mutation writes an activity log, and every attendance change writes an immutable audit record.

🎓

Thesis-Ready

Includes methodology, ER and data-flow diagrams, testing notes, and an honest limitations section for your writeup.

What is this?

The Secure QR Attendance System is a web-based attendance monitoring application for schools. It replaces manual roll-call with a fast, verifiable workflow: each student carries a personal QR code, and their teacher scans it to record attendance. Administrators manage the masterlist (sections, subjects, students, and staff), review appeals, and audit every change in the system.

This site documents the system from three angles:

User guides for Admins, Teachers, and Students.
Technical documentation covering architecture, the database schema, security, and the developer API.
Thesis material including methodology, system diagrams, and limitations.

New here?

Start with the System Overview to understand the actors and the core flow, then follow Getting Started to run the app locally.