Skip to content

Latest commit

ย 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ SmartAttend Pro v6.0.0

Next-Generation Cloud Attendance & AI-Powered Academic Assistant

SmartAttend Pro is a modern, cloud-connected academic attendance platform designed to go beyond simply recording attendance.

It combines attendance analytics, AI assistance, intelligent notifications, OCR-based timetable extraction, predictive insights, voice interaction, gamification, and cloud data synchronization into a single responsive application.

The goal is simple:

Turn attendance data into actionable academic intelligence.


โœจ Why SmartAttend Pro?

Traditional attendance systems answer:

"What is my attendance?"

SmartAttend Pro aims to answer:

"Why is my attendance changing?" "What happens if I miss my next class?" "How many classes do I need to attend to reach my target?" "Which subjects are putting me at risk?" "What should I do next?"

This makes SmartAttend more than an attendance tracker โ€” it is an attendance intelligence platform.


๐Ÿง  Core Features

๐Ÿค– AIRA AI Assistant

AIRA โ€” AI Academic Intelligence & Response Assistant

A context-aware AI assistant integrated with the application's academic data.

Users can ask questions such as:

  • "What is my lowest attendance subject?"
  • "Can I skip tomorrow's class?"
  • "How many classes do I need to reach 85%?"
  • "What classes do I have today?"
  • "Which subjects are risky?"

AIRA can provide personalized responses based on the user's available attendance and timetable information.

๐ŸŽ™๏ธ Voice Interaction

AIRA also supports:

  • Voice input
  • Speech recognition
  • Text-to-speech responses

Making interaction more natural and accessible.


๐Ÿ“Š Smart Attendance Analytics

Track attendance across subjects with:

  • Overall attendance percentage
  • Subject-wise attendance
  • Present/absent statistics
  • Attendance targets
  • Attendance trends
  • Safe-to-skip calculations
  • Recovery requirements
  • Performance insights

The application maintains attendance data through a cloud-backed architecture.


๐Ÿ”ฎ Attendance Intelligence

SmartAttend transforms historical attendance data into useful decision-support features.

โš ๏ธ Attendance Risk Score

Subjects can be categorized based on their attendance situation:

๐ŸŸข Low ๐ŸŸก Medium ๐ŸŸ  High ๐Ÿ”ด Critical

The system considers factors such as current attendance, target percentage, conducted classes and recovery requirements.


๐Ÿงฎ What-If Attendance Simulator

Explore hypothetical scenarios without modifying real attendance data.

For example:

"What happens if I miss 2 DBMS classes?"

The simulator can estimate:

  • New projected attendance
  • Distance from target
  • Safe skips
  • Recovery requirements
  • Resulting attendance status

All simulations are non-destructive.


๐Ÿ“ˆ Attendance Forecast

Estimate future attendance based on available historical patterns and scheduled classes.

Example:

Current Attendance     78.4%
Projected Attendance   82.1%
Target                 85%
Trend                  โ†— Improving

Forecasts are clearly treated as estimates rather than guaranteed predictions.


๐ŸŽฏ AI Attendance Recovery Plan

When attendance falls below a target, SmartAttend can generate a recovery strategy.

Example:

DBMS
Current: 68%
Target: 75%

Recommended:
Attend the next 5 DBMS classes

Priority: HIGH

This converts raw attendance data into an actionable plan.


๐Ÿ“ธ AI Timetable Scanner

Manually entering an entire timetable can be tedious.

SmartAttend includes an OCR-powered timetable scanner that can process timetable images/documents and extract class information.

Workflow

Timetable Image
       โ†“
    OCR Scan
       โ†“
Extract Class Information
       โ†“
Review
       โ†“
Sync to Schedule

This significantly reduces manual timetable entry.


๐Ÿ”” Smart Notifications

SmartAttend generates context-aware attendance and schedule alerts.

Examples:

โš ๏ธ Your DBMS attendance has fallen below your target.

๐ŸŽฏ Attend the next 3 classes to recover above your target.

๐ŸŸข You are safely above your attendance target.

Notifications are designed around actionable information rather than generic reminders.


๐Ÿ“„ Attendance Reports

Generate structured attendance reports containing information such as:

  • Student details
  • College information
  • Roll number
  • Overall attendance
  • Subject-wise attendance
  • Attendance history

Reports can be exported as PDF.


๐Ÿ”ฅ Gamification

SmartAttend includes attendance-focused gamification to encourage consistency.

Features include:

  • Attendance streaks
  • Goals
  • Achievement badges
  • Progress indicators

The objective is to make maintaining good attendance more engaging.


โ˜๏ธ Cloud Architecture

SmartAttend uses Supabase as its cloud backend and source of truth.

The application uses cloud-backed storage for core academic information such as:

  • User profiles
  • Subjects
  • Classes
  • Attendance records
  • Holidays
  • User settings

Authentication sessions are persisted so users can return to their existing workspace.


๐Ÿ›ก๏ธ Data Integrity

Data safety is a core design principle.

SmartAttend treats cloud data as the authoritative source and separates:

REAL ATTENDANCE DATA
        โ†“
Analytics
        โ†“
Risk Analysis
        โ†“
Forecasting
        โ†“
Simulation
        โ†“
Recommendations

Simulation and predictive features do not need to modify historical attendance records.


๐Ÿ“ฑ Responsive Design

SmartAttend is designed for both:

  • ๐Ÿ’ป Desktop
  • ๐Ÿ“ฑ Mobile

The interface includes:

  • Responsive layouts
  • Touch-friendly controls
  • Dark mode
  • Mobile-friendly modals
  • Adaptive dashboards

๐Ÿ—๏ธ Technology Stack

Technology Purpose
HTML5 Application structure
CSS / Tailwind CSS Styling & responsive UI
JavaScript Application logic
Supabase Cloud database & authentication
Chart.js Analytics visualization
Tesseract.js OCR / timetable scanning
jsPDF PDF report generation
Font Awesome Icons
Web Speech API Voice input / speech interaction

๐Ÿงฉ Architecture Overview

                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                    โ”‚   SmartAttend Pro    โ”‚
                    โ”‚      v6.0.0          โ”‚
                    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                               โ”‚
             โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
             โ”‚                 โ”‚                 โ”‚
             โ–ผ                 โ–ผ                 โ–ผ
       Attendance          Timetable           AIRA AI
        Engine              Engine           Assistant
             โ”‚                 โ”‚                 โ”‚
             โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                          โ”‚
                          โ–ผ
                 Intelligence Layer
                          โ”‚
          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
          โ–ผ               โ–ผ                โ–ผ
       Risk Score      Forecast         Simulator
          โ”‚               โ”‚                โ”‚
          โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                          โ–ผ
                 Recovery Planning
                          โ”‚
                          โ–ผ
                Smart Notifications
                          โ”‚
                          โ–ผ
                    Supabase Cloud

๐Ÿ” Authentication & Sessions

SmartAttend uses Supabase authentication with persistent sessions.

The application supports session persistence and automatic token refresh through the Supabase client configuration.


๐Ÿงฐ Smart Tools

SmartAttend Pro includes a collection of productivity and intelligence tools:

๐Ÿค– AIRA AI Studio

Context-aware academic assistant.

๐Ÿ”” Smart Notifications

Attendance and schedule alerts.

๐Ÿ“ธ Timetable Scanner

OCR-powered schedule extraction.

๐Ÿ“Š Analytics

Attendance trends and statistics.

๐Ÿงฎ Goal/Attendance Prediction

Calculates required attendance and safe-skip scenarios.

๐Ÿ“„ PDF Reports

Generate official attendance reports.


๐Ÿ› ๏ธ Getting Started

1. Clone the Repository

git clone https://github.com/YOUR_USERNAME/SmartAttend-Pro.git
cd SmartAttend-Pro

2. Configure Supabase

Create a Supabase project and configure the required database/authentication structure.

Update the application configuration with your Supabase project credentials.

Security note: Never commit private/service-role keys to GitHub. Frontend applications should only use appropriately scoped public/publishable credentials.

3. Run the Application

Because SmartAttend is primarily a web application, it can be served using a local development server.

For example:

python -m http.server 5500

Then open:

http://localhost:5500

๐Ÿ“‚ Project Structure

SmartAttend-Pro/
โ”‚
โ”œโ”€โ”€ index.html
โ”œโ”€โ”€ README.md
โ”‚
โ””โ”€โ”€ assets/
    โ”œโ”€โ”€ images/
    โ””โ”€โ”€ icons/

The exact structure may evolve as the application grows.


๐Ÿš€ Version 6.0.0 Highlights

Version 6.0.0 focuses on moving SmartAttend from a simple attendance utility toward a more intelligent academic platform.

Major capabilities

  • โ˜๏ธ Cloud-connected attendance
  • ๐Ÿค– AIRA AI Assistant
  • ๐Ÿ“Š Advanced attendance analytics
  • ๐Ÿ”ฎ Attendance forecasting
  • โš ๏ธ Attendance risk analysis
  • ๐Ÿงฎ What-if simulation
  • ๐ŸŽฏ Recovery planning
  • ๐Ÿ“ธ OCR timetable scanning
  • ๐Ÿ”” Smart notifications
  • ๐ŸŽ™๏ธ Voice interaction
  • ๐Ÿ“„ PDF reporting
  • ๐Ÿ”ฅ Attendance streaks & gamification
  • ๐ŸŒ™ Dark mode
  • ๐Ÿ“ฑ Responsive design

๐Ÿ”ฎ Roadmap

Planned/possible future enhancements include:

  • ๐Ÿ‘จโ€๐Ÿซ Faculty dashboard
  • ๐Ÿ“ฑ QR-based attendance
  • ๐Ÿ“… Smart academic calendar
  • ๐Ÿ“ก Offline-first synchronization
  • ๐Ÿ” Security & privacy center
  • ๐Ÿ‘ฅ Role-based Student / Faculty / Admin system
  • ๐Ÿ“Š Advanced institutional analytics
  • ๐Ÿ” Attendance anomaly detection
  • ๐Ÿ“š Academic performance correlation
  • ๐Ÿ”” Personalized attendance reminders

๐ŸŽฏ Project Vision

SmartAttend Pro is built around a simple idea:

Attendance should not just be recorded โ€” it should be understood.

By combining cloud data, analytics, AI assistance and intelligent recommendations, SmartAttend aims to help students make better academic decisions while providing a foundation that can evolve into a complete academic management platform.


๐Ÿ‘จโ€๐Ÿ’ป Developer

Waheed Mujtaba

Interested in building solutions at the intersection of:

  • Software Engineering
  • Artificial Intelligence
  • Data Analytics
  • Cloud Computing
  • Automation
  • Modern Web Applications

โญ Support

If you find SmartAttend Pro interesting, consider giving the repository a โญ on GitHub.

Feedback, ideas and contributions are welcome.


๐Ÿ“œ License

Add your preferred license here, such as MIT, Apache-2.0, or a proprietary license, depending on how you want to distribute the project.

About

A smart attendance tracker with percentage alerts, dark mode, and progress visualization. A very useful and interactive app for students for tracking there attendance.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages