Attendance & Timetable System

A complete lecture-wise attendance engine with dynamic batching, special allocations, timetable automation, lecture adjustment workflows, and a comprehensive analytics suite. This documentation covers all 12 administrative pages related to attendance management.

graph LR
    A[attendance-settings.php
Set Policy] --> B[time-slots.php
Define Slots]
    B --> C[class-slots.php
Assign Slots to Class]
    C --> D[timetable.php
Build Weekly Schedule]
    D --> E[batches.php
Create Lab Batches]
    E --> F[mark-attendance.php
Mark Daily Attendance]
    D --> G[special-allocation-timetable.php
Elective Schedule]
    F --> H[lecture-adjustments.php
Handle Swaps/Extras]
    F --> I[unlock-attendance.php
Unlock Locked Sessions]
    F --> J[reports.php
Analytics & Defaulters]
    J --> K[master-timetable.php
Export All Timetables]
    J --> L[export-reports.php
Excel Export Engine]
    

Step 1: Attendance Policy Configuration (`attendance-settings.php`)

The first page every HOD must configure. This page controls the most critical governance rule for the entire department's attendance system.

• Past Days Edit Window:
  Administrators set a numerical limit (e.g., 0 to 365 days) that dictates how far back in time a teacher is allowed to mark or modify attendance records. The system intelligently updates existing configurations without creating duplicate rules.
  Core Benefit: Setting it to zero enforces strict real-time-only marking. Setting it to seven provides a one-week grace period for teachers who may have missed marking during field trips. The HOD retains full override capability regardless of this global setting.
• Department-Scoped Settings:
  All configurations are strictly isolated by department. Each department autonomously manages its own policies without interfering with others. A live preview interface dynamically calculates and displays the exact "earliest allowed date" as the administrator adjusts the settings.

Step 2: Time-Slot Architecture (`time-slots.php`)

Time slots are the fundamental building blocks of the scheduling system. Every timetable entry, attendance session, and lecture adjustment relies on a predefined slot.

• Categorized Slot Types:
  Slots are classified into distinct categories: lecture, practical, break, or free. The system uses these classifications automatically: practical slots only accept lab subjects in the timetable builder, break periods are visually marked and disabled for attendance, and free slots are automatically skipped by the scheduling engine.
• One-Click Institutional Templates:
  Administrators can instantly deploy predefined templates, such as a standard academic day or a schedule optimized for practical labs. The system processes all slots simultaneously, eliminating the tedious process of entering them one by one.
  Core Benefit: An entire department's daily schedule structure can be configured in seconds, while built-in safeguards completely prevent duplicate or overlapping slot definitions.
• Deletion Safety Guard:
  Before a time slot can be removed, the system verifies if any active timetable entries currently use it. If dependencies are found, the deletion is safely blocked with a clear warning, ensuring that existing schedules are never broken.

Step 3: Assigning Slots to Classes (`class-slots.php`)

This module provides the flexibility to customize the daily schedule for individual classes, recognizing that different year levels often have different operational hours within the same department.

• Class-Specific Schedule Mapping:
  Administrators select a class and assign only the specific time slots relevant to them from the department's master list. When generating timetables, the system prioritizes these specific class schedules over the general departmental configuration.
  Core Benefit: A final-year class might operate on an eight-slot day including extensive lab work, while a second-year class might only use six theory slots—all seamlessly managed from a single, unified administrative interface.
• Interactive Assignment Summary:
  A dedicated panel provides a real-time overview of slot allocations across the entire department. Classes that have not yet been assigned a schedule are visually flagged with a warning indicator, offering a clear administrative checklist.

Step 4: Weekly Timetable Builder (`timetable.php`)

The core scheduling engine. It constructs the authoritative weekly framework that powers all subsequent attendance tracking, lecture modifications, and academic reporting.

• Intelligent Grid Editor:
  For every available period, administrators assign a subject, a designated teacher, the format (e.g., Theory or Practical), and an optional room location. The interface dynamically restricts selections to only those teachers pre-approved for specific subjects, preventing accidental misallocations.
• Automated Scheduling Engine:
  The most advanced feature in the module. When activated, the system executes a complex scheduling process that:
  1. Retrieves all subjects and their designated faculty for the target class.
  2. Automatically segregates subjects into lecture and laboratory pools based on their predefined characteristics.
  3. Distributes subjects evenly across the academic week using a balanced allocation approach.
  4. Proactive Conflict Prevention: Before confirming any placement, the engine scans the schedules of all other classes to verify the teacher is not already booked elsewhere at that exact moment.
  5. Enforces pedagogical limits, such as restricting a subject to one occurrence per day and adhering to maximum weekly lecture quotas.
  Core Benefit: A comprehensive, conflict-free weekly schedule for a class with multiple subjects can be generated instantly. The system also clearly reports any scheduling impossibilities, such as unresolvable teacher clashes.
• Integrated Batch Scheduling:
  During practical sessions, the interface automatically presents batch assignment options. The scheduling engine recognizes these divisions and correctly populates separate instances for each student group.
• Term-Based Version Control:
  Schedules are securely versioned by academic term. Generating a new timetable for an upcoming semester leaves the current semester's schedule entirely untouched, allowing for seamless advance planning.

Step 5: Practical Batch Management (`batches.php`)

Laboratory sessions inherently require dividing large classes into smaller, manageable groups. This module handles these structural student divisions.

• Intelligent Range Selection:
  Instead of manually selecting individual students, administrators can simply input numerical ranges (e.g., "1-20"). The interface instantly interprets this and selects the corresponding active students automatically.
  Core Benefit: Dividing a large class into multiple distinct lab batches is reduced to a task taking mere seconds, entirely eliminating the risk of human error during manual selection.
• Live Overlap Detection:
  The interface continuously indicates a student's current batch assignment. Attempting to assign a student to a second batch immediately triggers a clear visual warning, preventing administrative overlap.
  Core Benefit: Completely prevents the critical issue of "Phantom Overlap," where a single student is mistakenly scheduled for concurrent lab sessions, which inevitably corrupts attendance data.

Step 6: Marking Daily Attendance (`mark-attendance.php`)

The primary operational tool used by teaching staff daily, optimized for rapid entry, high accuracy, and automatic synchronization with leave records.

• Context-Aware Roster Loading:
  When a teacher selects a date, class, and time, the system automatically cross-references the official timetable to determine the correct subject and staff assignment. It then presents a precisely ordered roster of currently active students.
• Automated Leave Synchronization:
  Prior to displaying the roster, the system automatically checks for any officially approved student leave applications covering that specific date. These students are visually highlighted as being on sanctioned leave and their attendance status is automatically categorized as excused.
  Core Benefit: Total integration between leave management and daily attendance. Teachers are no longer responsible for manually tracking who is legitimately absent for medical or official reasons.
• Real-Time Statistical Feedback:
  The interface provides rapid-entry tools like "Mark All Present" alongside a live counter that continuously tallies present, absent, and on-leave students as the teacher makes individual adjustments.
• Safe Resubmission Protocol:
  If a teacher needs to correct an error within the permitted modification window, the system intelligently processes the update without duplicating the session record, ensuring the underlying data remains perfectly clean.
  Core Benefit: Faculty can easily correct unintentional mistakes—such as marking a latecomer absent—simply by resubmitting the form, without requiring administrative intervention.
• Automatic Term Alignment:
  Attendance sessions are automatically linked to the correct academic term by reading the underlying timetable data, removing the need for any manual categorization by the staff.

Step 7: Special Allocation Timetable (`special-allocation-timetable.php`)

A specialized scheduling interface designed for complex scenarios like cross-divisional electives, remedial support groups, or collaborative project teams.

• Cross-Divisional Grouping:
  This module supports groups comprised of students drawn from multiple different classes simultaneously. It assigns a unified weekly schedule specifically tailored to this merged cohort.
• Intelligent Schedule Inheritance:
  The system analyzes the composition of the special group and automatically inherits the appropriate daily time-slot configuration from the participating classes, ensuring schedule compatibility.
• Live Cross-Schedule Conflict Mapping:
  When assigning a teacher to a special group, the interface actively scans their regular class schedule. Any periods where the teacher is already committed are visually disabled and clearly labeled with the conflicting class name.
  Core Benefit: It is fundamentally impossible to accidentally double-book faculty members. The interface serves as a proactive, real-time map of teacher availability.
• Integrated Location Management:
  Each scheduled session allows for optional room assignments, which are permanently attached to the record and displayed on all student-facing materials.

Step 8: Lecture Adjustments (`lecture-adjustments.php`)

A dedicated workflow center for managing inevitable deviations from the standard timetable, including faculty substitutions, supplementary lectures, or official cancellations.

• Categorized Modification Types:
  The system distinctly tracks lecture swaps between faculty, supplementary sessions scheduled outside regular hours, and formal cancellations. Each type is visually distinct and recorded separately for accurate auditing.
• Administrative Approval Chain:
  Teaching staff initiate modification requests through their individual portals. This administrative interface acts as the central command center where the HOD can review, approve, or decline each request, creating a permanent, timestamped record of the decision.
  Core Benefit: Establishes a rigorous, verifiable audit trail for every single schedule deviation—a critical requirement for institutional inspections and accurate faculty remuneration.
• Comprehensive Filtering and Status Tracking:
  The interface provides powerful filtering capabilities and categorizes requests into clear statuses (Pending, Approved, Rejected) with live counters, ensuring no request is overlooked.

Step 9: Unlock Attendance (`unlock-attendance.php`)

A high-security administrative tool. Once a faculty member finalizes an attendance session, it becomes immutable. This interface is the sole mechanism to reverse that status.

• Immutable Session Protocol:
  Upon successful submission by a teacher, the attendance record is officially locked. The standard entry interface will categorically reject any further attempts to alter the data by the original user.
• Secure Override Mechanism:
  Authorized administrators can override this lock. However, the action is protected by a multi-step verification process displaying the exact class, subject, date, and staff member involved before the override is finalized. Strict permissions ensure administrators can only affect records within their own jurisdiction.
  Core Benefit: The protected override process guarantees academic integrity. It eliminates the risk of unauthorized retroactive modifications to attendance records.
• Auditable Session Overview:
  All recorded sessions are displayed in a responsive, easily searchable format, highlighting attendance metrics and focusing on recent activity to streamline administrative oversight.

Step 10: The Analytics Suite (`reports.php`)

The intelligence center of the module, consolidating multiple distinct reporting engines into a single, powerful analytical interface.

• Daily Operational Report:
  Provides a comprehensive snapshot of all academic activity on a given day, detailing classes, subjects, faculty involved, and precise attendance metrics, with options to customize the display format.
• Subject-Level Performance Analytics:
  Aggregates long-term data for specific classes, revealing overall lecture delivery rates and highlighting trends in student participation across different subjects.
• Macro-Level Monthly Summaries:
  Presents a high-level view of institutional activity, summarizing the volume of lectures and general attendance trends day-by-day, making it easy to spot irregular activity patterns.
• Faculty Workload Assessment:
  Analyzes academic delivery by individual staff members, categorizing their efforts into regular scheduled classes, extra sessions, and adjusted timetables over any given period.
  Core Benefit: Delivers impartial, quantifiable data essential for transparent faculty performance evaluations and accurate workload balancing.
• Advanced Defaulter Identification:
  Employs a sophisticated algorithm that analyzes a student's participation strictly on a per-subject basis before calculating an overall metric. This prevents situations where a student's perfect attendance in minor subjects artificially masks severe absenteeism in core modules.
  Core Benefit: Instantly produces rigorous, compliance-ready reports that identify at-risk students accurately and well ahead of critical academic deadlines.
• Print-Optimized Document Generation:
  Features a specialized engine designed to format complex data into clean, highly readable documents perfect for physical printing or professional PDF conversion, supporting various reporting formats from macro-summaries to detailed individual tracking.

Step 11: Master Timetable Viewer & Exporter (`master-timetable.php`)

A consolidated, high-level interface designed for broad administrative oversight and the rapid generation of official departmental documents.

• Simultaneous Multi-Class Visualization:
  Administrators can select and concurrently view the schedules of multiple distinct classes. The interface organizes these cleanly, allowing for rapid visual identification of structural gaps or operational inefficiencies across the department.
• Zero-Latency Export Technology:
  The module utilizes advanced browser-side technologies to instantly convert complex schedules into professional formats—including paginated PDFs, organized spreadsheets, and styled word processing documents—without requiring any communication with the server.
  Core Benefit: Generates official documentation for an entire department instantly, completely bypassing potential network delays or server strain.
• Intelligent Print Formatting:
  The interface is designed to automatically adapt when printed, stripping away navigation elements and menus to produce a perfectly formatted, distraction-free document directly from the web browser.

Step 12: Advanced Data Export Engine (`export-reports.php`)

A specialized backend component dedicated to compiling deep analytical data into universally compatible formats for external processing.

• Direct Spreadsheet Compilation:
  This engine mirrors the analytical rigor of the main reporting interface, ensuring data consistency, but focuses entirely on outputting structured, highly compatible spreadsheet files ready for deep external analysis.
• Intelligent Data Formatting:
  It automatically formats identifiers and standardizes data presentation, guaranteeing that the exported files are immediately useful without requiring manual cleanup or reformatting by staff.
  Core Benefit: Administrators can produce immaculate, university-compliant data sets with a single click, entirely eliminating reliance on complex third-party software integrations.