Hadira — School Attendance Backend (Go)

Hadira is an attendance backend for educational settings written in Go with Gin. Institutions, students, teachers, parents, classes, grade levels, rooms and their classifications, subjects, schedules, and staff assignments form the basis of attendance records. Each institution’s data is isolated, and dashboards and data access vary by superadmin, administrator, teacher, student, and parent roles.

Attendance covers sessions with participant rosters, refreshable QR tokens, geolocated check-in, manual entries, attendance corrections, lateness calculation, and attendance histories. Attendance policies, school weeks, semesters, and academic calendars determine the context of current activities, with readiness checks before activating an academic year. Academic administration includes student enrolment and placement, documented profile-update requests, and grade progression.

Reporting has several layers: summaries by student, class, and subject, second-generation reports with selectable dimensions, attendance matrices, and spreadsheet exports. Data imports run as jobs with statuses and downloadable failed rows. For operations, the service provides Prometheus metrics, OpenTelemetry tracing with a Jaeger exporter, zerolog structured logging, Swagger documentation, Postman collections, S3 file storage, and an extensive suite of unit and integration tests. The admin web application and Flutter mobile application consume this API.