Skip to content

An advanced web-based attendance management system built for the Mahinda Rajapaksha College Prefect Board. This system allows prefects to manage attendance efficiently using QR Code Scanning, with data stored securely in local storage, and includes a powerful Admin Dashboard with real-time analytics.

Notifications You must be signed in to change notification settings

RishBroProMax/attendance-system

Repository files navigation

🎓 MRCM - Prefect Board Attendance System v2

An advanced web-based attendance management system built for the Mahinda Rajapaksha College Prefect Board. This system allows prefects to manage attendance efficiently using QR Code Scanning, with data stored securely in local storage, and includes a powerful Admin Dashboard with real-time analytics.

🌐 Live App

🔗 Try it here


🚀 Features

  • 📲 QR Code Scanning for instant attendance marking
  • 🧠 Smart Local Storage system – no need for a backend
  • 📊 Admin Dashboard with real-time attendance analytics
  • 👤 Role-based system: Prefects and Admin
  • 💡 Minimal, fast, and user-friendly interface
  • 📱 Fully responsive on desktop, tablet, and mobile
  • ✅ Get full attendance report of the specific user

🛠️ Built With

  • Frontend: Next.js, React, Tailwind CSS
  • State Management: Local Storage (no external database)
  • Authentication: Simple local-based login
  • QR Scanning: JavaScript-based QR scanner
  • Deployment: Vercel

⚙️ Getting Started (For Developers)

  1. Clone the repo:
git clone https://github.com/RishBroProMax/attendance-system-v2.git
cd attendance-system-v2
  1. Install dependencies:
npm install --force
  1. Start development server:
npm run dev
  1. Open http://localhost:3000 in your browser 🚀

📊 Admin Dashboard

  • View total attendance stats
  • Analyze attendance per day, week, or month
  • Export local data if needed (manual backup option)
  • Secure admin login with dashboard access
  • Export to CSV file

🔐 Authentication

  • Prefects login locally using credentials
  • Admin has a separate login for full access
  • Auth data saved in browser storage

📸 QR Attendance ( Beta V0.9 )

  • Each student gets a unique QR code
  • Admin or Prefect can scan the code using a webcam/mobile camera
  • System auto-marks attendance in local records

💡 Why Local Storage?

  • ⚡ Super fast and lightweight
  • 📴 Works offline once loaded
  • 🔒 Data stays on device (no cloud required)
  • 📤 Easy to export manually if backup needed
  • 🧩 Easy Database Handel

🧩 Future Improvements

  • ✅ Sync with cloud backend (Firebase/Supabase)
  • ✅ Face recognition module (AI-based)
  • ✅ Enhanced security/auth layer
  • ✅ Google Sheet Connectable
  • ✅ Moderators Roles ( Developer, Admin, Attendance Marker )

🏫 Made For

Mahinda Rajapaksha College - Prefect Board
Developed with ❤️ by @RishBroProMax


💼 Hire Me

I specialize in building full-stack, high-performance web applications tailored for schools, startups, and custom use cases.

📬 Reach out:

Let’s build something great together!

📄 License

MIT License. Feel free to use, improve, or fork this project.


About

An advanced web-based attendance management system built for the Mahinda Rajapaksha College Prefect Board. This system allows prefects to manage attendance efficiently using QR Code Scanning, with data stored securely in local storage, and includes a powerful Admin Dashboard with real-time analytics.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages