College Companion – Automatic Attendance Tracker

A lightweight and smart automatic attendance tracker designed for college students. This application was originally planned to include assignment management and other utility features, but the current version focuses entirely on providing a fully automated attendance tracking system.

This app automatically marks your attendance based on your timetable, while still providing full control to make adjustments manually.

---

✅ Features

• Automatic Attendance Marking according to the timetable you create.

• Flexible Manual Adjustments for:

  • Absence
  • Lecture cancellation
  • Lecture switched/replaced by another
  • Extra lectures

• Easy Timetable Setup with start date selection.

• Stable and fully flexible system that adapts to any timetable changes.

---

📱 How to Use the App

1. Create Your Timetable

• Open the app
• Go to Menu → Create Schedule (Timetable)
• Choose the start date (the date when your semester started)
• Add all subjects with their timings
• Save

2. Viewing Attendance

• After saving, return to the Home Screen
• All your subjects will appear with live attendance updates

3. Making Changes

Use the Make Change button to manually update lectures:

• Mark Absent
• Mark Present
• Cancel a lecture
• Switch/Replace lecture with another
• Add Extra Lecture

4. End of Semester

• On the last day, press the STOP button to stop automatic attendance marking.

---

🔧 How It Works Internally

This app uses two important date pointers:

1. lastDate

The last date on which you opened the app.

2. currentDate

The date when you open the app right now.

Using these two, the app:

• Calculates how many days have passed
• Creates lecture entities according to your timetable
• Automatically marks attendance for each lecture

All lecture operations (present, absent, cancelled, switched, extra) are stored as actions on a lecture entity using a unique lecture ID.

A DatabaseHelper class manages:

• Creating lecture entries
• Storing attendance states
• Updating changes

---

🛠️ How to Run the Project (Flutter)

If someone wants to run or modify the code, here are the steps:

✅ 1. Clone the Repository

git clone https://github.com/your-username/your-repo-name.git](https://github.com/Scizor777/Auto-Attendance-Tracker.git
cd Auto-Attendance-Tracker

✅ 2. Install Dependencies

Run:

flutter pub get

This downloads all the required packages.

✅ 3. Run the App

flutter run

Or run from Android Studio / VS Code.