G3B426/SNU-GM-Xaadirin

AI-powered Smart Attendance System using Face Recognition for Somalia National University – Galmudug Branch (SNU-GM). # SNU-GM Xaadirin **AI Agent Smart Attendance Management System Using Face Recognition** Somalia National University — Galmudug Branch An attendance system built around live face-recognition check-in: an admin registers students and teachers, students go through a guided camera-based face enrollment, and teachers run attendance sessions where the camera recognizes and marks each student present in real time. Everything else — faculty/department/batch/course structure, attendance history, marks, reports, document generation — is built around that core. ## Portals - **Admin** — three roles sharing one codebase, scoped by permission: - **Super Admin** — full access to everything. - **Faculty Admin** — scoped to one assigned faculty; view-only on Students/Teachers/Courses/Course Assign, full CRUD on that faculty's Departments/Batches. - **Registrar Admin** — university-wide Student/Teacher registration and records, full CRUD on the academic structure (Faculty/Department/ Batch/Course), Documents Center, and Reports. - **Teacher** — own profile, own courses, start/run attendance sessions via camera, attendance history, attendance marks, reports. - **Student** — own profile, account settings, own courses, attendance record, results. ## Core features - Student Registration with a guided, step-by-step **Face Enrollment** wizard (Front/Left/Right/Up/Down capture, live pose + quality + liveness feedback, duplicate-face detection before enrollment is allowed) plus an automatic professional white-background **Profile Photo** — the two are generated, stored, and tracked completely separately: the recognition embedding lives in `student_faces`, the enrollment reference image in `face_enrollment_images` / `face_enrollment/students/{code}/`, and the cropped profile portrait in `students.photo` / `img/students/`. - Live **Face Recognition Attendance** — a teacher starts a session, the camera (local webcam, or a classroom/mobile camera via a WHEP/WebRTC bridge) recognizes enrol …