AttendEase Documentation

📋 Platform Overview

AttendEase is a multi-tenant, cloud-ready attendance management platform built on ASP.NET 8.0 Minimal API with a PostgreSQL database. It serves educational institutions with role-based dashboards for SuperAdmins, Admins, Faculty, Students, and Parents.

👥 User Roles

🧩 Core Modules

Academic Structure

• Departments — Create/manage departments with name and code
• Courses — Define programs (B.Tech, M.Tech, etc.) with unique codes
• Subjects — Subjects with department linkage and type (Theory/Practical)
• Semesters — Auto-seeded numbered semesters (configurable count)
• Academic Years — CRUD with "Current" toggle, auto-seeded on tenant activation
• Course-Subject Offerings — Map subjects to course+semester+academic year
• Periods — Time slots with start/end times and break indicators
• Holidays — Date-based holiday management by academic year

Student Management

• CRUD — Full student lifecycle with roll number, course, semester, academic year
• Bulk Upload — CSV import with auto user-account and tag creation
• Promotion — Batch promote students to next semester
• Archival — Batch archive course-completed students
• Status Tracking — Active, Promoted, Completed, Archived states

User Management

• CRUD — Create users with role assignment, approval workflow
• Bulk Upload — CSV upload for teachers with subject assignments
• Teacher-Subject Mapping — Assign/unassign subjects to faculty
• Parent-Student Linking — Link parent accounts to student records
• Pending Approvals — Approve/reject self-registered teachers

✅ Attendance System

AttendEase supports two attendance modes:

Customizable Statuses

Default statuses: ● Present, ● Absent, ● Late. Admins can add custom statuses with any color code.

Reporting

• Aggregated student-level reports with Present/Absent/Late/Leave counts and percentage
• Course-wise breakdown summary for dashboard bar charts
• Activity-wise summary for extracurricular tracking
• Multi-filter: courseSubject, department, course, semester, academicYear, date range, tag

📅 Timetable Engine

• Grid Builder — Map CourseSubject to Day + Period + Faculty with conflict detection
• Bulk Save — Save entire timetable grid at once
• Faculty View — Teachers see their personal weekly schedule
• Current Period Detection — Auto-detects active period from IST time for frictionless attendance marking
• Student View — Students see their course timetable

🏷️ Tags & Activities

Tags provide a flexible categorization system with two types:

• Filter Tags — Group students (Batch A, Section 1) for filtered attendance marking
• Extracurricular Tags — Activities (NCC, NSS, Sports) with dedicated attendance tracking

Tags feature color-coded chips, bulk student assignment, and CSV auto-creation during student import.

📄 Notice Hub (CMS)

Admins can create custom HTML pages with advanced visibility controls:

• File Upload — Upload HTML files or ZIP archives (up to 10MB)
• Role Visibility — Restrict pages to specific roles
• Date Range — VisibleFrom / VisibleUntil scheduling
• Attendance Gate — Lock pages for students below minimum attendance %
• Course/Semester Scope — Target specific student groups
• Response Collection — Capture form data (JSON) per user, upsert or append mode

🔌 API Reference

AttendEase exposes ~105 RESTful API endpoints. Key groups:

Full API includes CRUD for departments, courses, subjects, semesters, academic years, periods, holidays, course-subjects, users, tags, tag-types, custom pages, and attendance statuses.

🏗️ Technical Architecture