🎓 EduPresence

Smart tracking and predictive analytics for student success.

About • Features • UI Showcase • Tech Stack • Getting Started • Roadmap

---

📖 About The Project

EduPresence is a next-generation smart classroom management system designed to revolutionize how educational institutions track student attendance and engagement. Gone are the days of tedious manual roll calls. EduPresence provides a seamless, multi-modal attendance tracking system and leverages predictive analytics to identify at-risk students before they fall behind.

Our core mission is to empower educators and counselors with actionable insights, enabling proactive interventions that foster a supportive and successful learning environment for every student.

---

✨ Key Features

• 📊 Dynamic Analytics Dashboard: A real-time, high-level overview of campus-wide metrics including total attendance, engagement scores, and weekly trends.

• 📲 Multiple Check-in Methods:

  • 📱 QR Code: Instant, scannable codes for quick check-ins.
  • 🎤 Voice Recognition: Hands-free, voice-activated attendance marking for modern classrooms.
  • ⌨️ Manual Entry: Traditional, reliable text-based entry for maximum flexibility.

• 🤖 Predictive Risk Alerts: An intelligent, AI-driven system that flags students showing signs of disengagement or poor attendance patterns.

• 📋 Actionable Intervention Reports: Automatically generated reports for counselors with detailed student data and a list of recommended actions to provide timely, effective support.

• 📈 Historical Data & Trends: Analyze attendance and engagement patterns over time to make informed, data-driven decisions for institutional improvement.

• 🔔 Real-time Notifications: Instant updates on student activity and critical system alerts to keep faculty informed.

---

💡 A Glimpse Inside

Since a picture is worth a thousand words, here's a textual walkthrough of the core user experience.

1. The Command Center: Dashboard

Imagine logging in to a clean, organized dashboard. At a glance, you see four key metrics in large, bold numbers:

• Total Students: 1248 (with an indicator showing +8% from last month)
• Present Today: 1087 (showing an 87% attendance rate)
• Risk Students: 23 (highlighted as needing intervention)
• Weekly Average: 92% (noted as Above target (85%))

Below these metrics, a live feed shows Recent Activity like "Nafees Hossain checked in via QR", and a progress bar section visualizes Today's Progress with an 87% Attendance Rate and 78% Engagement Score.

2. The Power of Choice: Check-in Methods

Navigating to the "Check-in Methods" tab, the user is presented with three clean, distinct cards:

QR Code Check-in 🤳

"Students can scan QR codes to check in instantly." A simple "Generate QR Code" button lies below.

Voice Check-in 🎙️

"Voice-activated attendance for hands-free checking." A prominent green "Start Voice" button invites interaction.

Manual Entry ✍️

"Traditional text-based attendance entry." A familiar "Manual Entry" button for straightforward cases.

3. The Proactive Assistant: AI Alerts

The "Alerts" tab is where EduPresence truly shines. It's not just data; it's a call to action. You see a "Weekly Alert Report for Counselors" with a card for an at-risk student:

Md Sahil Ansari

Reason: Poor attendance pattern, low engagement in activities.

Risk Level: High Risk

Data: Attendance: 45%, Engagement: 82%

---

Recommended Interventions:

• Schedule one-on-one meeting within 48 hours
• Connect with academic advisor for support plan
• Implement attendance monitoring system
• Contact emergency support services if needed

This transforms raw data into a clear, actionable plan to help students succeed.

---

🛠️ Tech Stack

This project is built with a modern, scalable, and efficient technology stack.

• 🖥️ Frontend: Next.js, React, Tailwind CSS
• ⚙️ Backend: Node.js, Next.js API Routes (Assumed)
• 🗃️ Database: PostgreSQL, Prisma (ORM) (Assumed)
• 🚀 Deployment: Vercel

---

🏁 Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

Make sure you have Node.js (v18+) and npm installed on your machine.

• npm

  npm install npm@latest -g

Installation

1. Clone the repo

   git clone [https://github.com/your-username/your-repo.git](https://github.com/your-username/your-repo.git)

2. Navigate to the project directory

   cd your-repo

3. Install NPM packages

   npm install

4. Set up your environment variables by creating a .env.local file.

   DATABASE_URL="your_database_url_here"
   NEXTAUTH_SECRET="your_super_secret_key_here"

5. Run the development server

   npm run dev

6. Open http://localhost:3000 with your browser to see the result!

---

🗺️ Roadmap

We have big plans for EduPresence! Here are some features we're excited about:

• 📱 Mobile Applications (iOS & Android) for students and faculty.
• 🔗 LMS Integration with Moodle, Canvas, and more.
• 💬 Automated Communication via email/SMS for alerts.
• 🧐 Deeper Analytics on course-level and department-level trends.
• 📸 Facial Recognition Check-in as an advanced attendance option.

See the open issues for a full list of proposed features and known bugs.

---

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

EduPresence Built with ❤ by Creative Techtians