Attendance & Timetable

The Attendance module gives students complete visibility into their lecture-wise attendance — with subject-wise breakdowns, monthly calendars, visual health indicators, and the ability to request corrections.

1. My Attendance Overview

The primary attendance page — a subject-wise card layout showing each subject's attendance health for the current semester.

1.1 Subject Attendance Cards

One Card per Subject: Each enrolled subject gets a card showing subject name, teacher name, total lectures held, total attended, and attendance percentage.
Progress Bar: A color-coded horizontal progress bar fills based on attendance %:
- Green (≥75%) — Safe zone. Text: "Attendance on track"
- Amber (60–74%) — Warning zone. Text: "Attendance needs improvement"
- Red (<60%) — Critical zone. Text: "Critical — immediate action required"
Lectures Needed Calculator: For red/amber subjects, the card automatically computes: "You need to attend X more consecutive lectures to reach 75%."
View Details Button: Navigates to the lecture history page filtered to that specific subject.

1.2 Summary Bar

Overall %: Aggregate attendance across all subjects combined.
Best Subject: Subject with the highest attendance (displayed as a "star" chip).
Lowest Subject: Subject most at risk — displayed with a warning icon.
Total Lectures Held: Sum of all lectures conducted by all teachers this semester.

Benefit: Students get a single-glance health check instead of calculating percentages manually from paper records. The automatic "lectures needed" calculator provides a concrete action plan.

2. Personal Timetable

The student's personal weekly timetable based on their enrolled class, configured by the HOD.

7-Day Grid View: A table showing all 7 days (Monday–Sunday) with time slots as columns. Each cell contains the subject name and teacher name for that slot.
Today Highlight: Current day's column is highlighted in a soft gold background.
Practical Batches: For practical subjects, the batch (A/B/C) is shown alongside — students in Batch A see their practical slots, not Batch B's.
Free Periods: Empty slots are shown as "Free" in grey — no subject assigned.
Export to PDF: Students can download their timetable as a clean, printable PDF.

3. Attendance Reports

A detailed analytics view with filters for date range and subject-level drill-down.

Report Type	Description	Available Filters
Subject-wise Summary	Attendance % per subject with held/attended counts	Academic year, semester
Monthly Calendar View	Calendar grid showing P (Present), A (Absent), H (Holiday) for each day	Subject, month/year
Date-Range Report	Attendance summary for a custom date range	From date, To date, subject
Leave Impact Analysis	Shows how approved leaves affected overall attendance %	Academic year

4. Lecture History

A chronological log of every lecture — showing exactly which lectures the student attended and missed.

Log Columns: Date, Day, Time Slot, Subject, Teacher, Status (Present ✅ / Absent ❌ / Leave 📋 / Holiday 🏖)
Filter Panel: Filter by subject, month, or status (show only absences).
Leave Integration: Lectures falling within an HOD-approved leave period are marked as "Leave" instead of "Absent" — protecting the student's attendance percentage.
Download: Export the lecture log as PDF or Excel for submitting to the office if required.

5. Attendance Adjustment Requests

If a student believes their attendance was marked incorrectly (e.g., present but marked absent due to a technical issue), they can submit a formal adjustment request.

Request Form Fields:
- Date of the lecture
- Subject
- Reason for requesting adjustment
- Supporting evidence (optional attachment)
Request Status: Submitted requests show status — Pending Teacher Review → Approved / Rejected by Teacher → HOD Override (if needed).
One Request Per Lecture: A student cannot submit duplicate requests for the same date/subject combination.
Teacher Action: The subject teacher receives the request in their panel and can approve/reject with a comment. On approval, the attendance entry is automatically corrected.

Benefit: Eliminates the chaos of students physically approaching teachers to fix attendance. The digital trail ensures transparency — no undocumented manual corrections.

Data Flow — Attendance Query

sequenceDiagram
    participant SYS as System
    participant PHP as Attendance Engine
    participant STU as Student

    STU->>PHP: Load attendance page
    PHP->>SYS: Get subject allocations for class
    SYS-->>PHP: List of subjects
    PHP->>SYS: Calculate attended vs held lectures per subject
    SYS-->>PHP: Subject-wise attendance counts
    PHP->>PHP: Compute % = (attended/held)*100 per subject
    PHP->>PHP: Classify as Green/Amber/Red + calculate lectures_needed
    PHP-->>STU: Render subject cards with progress bars

Overall Benefit: The Attendance module gives students complete, transparent visibility into their academic standing. The automatic calculator, urgency color coding, and adjustment request system together reduce attendance-related office visits by over 60% while improving student compliance with attendance requirements.

SLMT LMS