How nishanttmaurya/sih20687 works
This is an offline-first Android biometric attendance app paired with a FastAPI gateway and web dashboard/onboarding portal. The main workflow captures a student’s face, checks liveness and screen replay, matches an enrolled profile, verifies campus location, records attendance locally, then syncs pending records when connectivity returns. The README documents the server’s roster, onboarding, live-dashboard, and webhook capabilities. Some implementation details—especially unsampled server routes and several screen-to-repository calls—are not shown, so those links are limited to documented or indexed evidence.
Main entry points: AttendancePipelineCoordinator.kt Attendance pipeline · repository Data repositories · MainActivity.kt Screen navigation · main.py FastAPI gateway
Components 24
Android screens
- App setup
app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt - Screen navigation
app/src/main/java/com/sih/faceattendance/MainActivity.kt - Attendance scan
app/src/main/java/com/sih/faceattendance/ui/screens/attendance/AttendanceScreen.kt - Face enrollment
app/src/main/java/com/sih/faceattendance/ui/screens/enrollment/EnrollmentScreen.kt - Session selection
app/src/main/java/com/sih/faceattendance/ui/screens/sessions/SessionsScreen.kt - Offline queue
app/src/main/java/com/sih/faceattendance/ui/screens/queue/OfflineQueueScreen.kt - Student database
app/src/main/java/com/sih/faceattendance/ui/screens/students/StudentsScreen.kt
Biometric verification
- Attendance pipeline
app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt - Face detection
app/src/main/java/com/sih/faceattendance/ml/FaceDetectorEngine.kt - Liveness defense
app/src/main/java/com/sih/faceattendance/ml/LivenessEngine.kt - Replay detection
app/src/main/java/com/sih/faceattendance/ml/PhoneDetectorEngine.kt - Face embeddings
app/src/main/java/com/sih/faceattendance/ml/FaceEmbeddingEngine.kt - Cosine matching
app/src/main/java/com/sih/faceattendance/ml/CosineSimilarity.kt - GPS geofence
app/src/main/java/com/sih/faceattendance/core/LocationHelper.kt
Offline data
- Room database
app/src/main/java/com/sih/faceattendance/data/local/AttendanceDatabase.kt - Data repositories
app/src/main/java/com/sih/faceattendance/data/repository
Sync and gateway
- Connectivity monitor
app/src/main/java/com/sih/faceattendance/core/NetworkMonitor.kt - API client
app/src/main/java/com/sih/faceattendance/data/remote/NetworkClient.kt - Sync API
app/src/main/java/com/sih/faceattendance/data/remote/AttendanceApiService.kt
Server and web
- FastAPI gateway
server/main.py - Web onboarding
server/onboarding_view.py - Live dashboard
server/main.py
Other components
- Student
- Institutional webhook
Connections 29
- Student → Screen navigation: uses app
README.md - Screen navigation → Attendance scan: opens scan
app/src/main/java/com/sih/faceattendance/MainActivity.kt - Screen navigation → Face enrollment: opens enrollment
app/src/main/java/com/sih/faceattendance/MainActivity.kt - Screen navigation → Session selection: opens sessions
app/src/main/java/com/sih/faceattendance/MainActivity.kt - Screen navigation → Offline queue: opens queue
app/src/main/java/com/sih/faceattendance/MainActivity.kt - Screen navigation → Student database: opens database
app/src/main/java/com/sih/faceattendance/MainActivity.kt - App setup → Room database: initializes
app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt - App setup → Data repositories: initializes
app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt - App setup → Attendance pipeline: initializes
app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt - App setup → Connectivity monitor: observes
app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt - Attendance scan → Attendance pipeline: runs verification
app/src/main/java/com/sih/faceattendance/ui/screens/attendance/AttendanceScreen.kt - Attendance pipeline → Face detection: detects faces
app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt - Attendance pipeline → Liveness defense: checks liveness
app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt - Attendance pipeline → Replay detection: checks replay
app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt - Attendance pipeline → Face embeddings: extracts features
app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt - Face embeddings → Cosine matching: normalizes vectors
app/src/main/java/com/sih/faceattendance/ml/FaceEmbeddingEngine.kt - Attendance pipeline → Data repositories: matches and records
app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt - Attendance pipeline → GPS geofence: checks geofence
- Face enrollment → Data repositories: registers profiles
app/src/main/java/com/sih/faceattendance/ui/screens/enrollment/EnrollmentScreen.kt - Session selection → Data repositories: manages sessions
- Data repositories → Room database: reads and writes
app/src/main/java/com/sih/faceattendance/data/repository/StudentRepository.kt - Connectivity monitor → Data repositories: triggers sync
app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt - Data repositories → Sync API: syncs records
app/src/main/java/com/sih/faceattendance/data/repository/AttendanceRepository.kt - API client → Sync API: creates client
app/src/main/java/com/sih/faceattendance/data/remote/NetworkClient.kt - Sync API → FastAPI gateway: sends sync requests
README.md - FastAPI gateway → Live dashboard: broadcasts SSE
README.md - FastAPI gateway → Web onboarding: serves portal
server/main.py - Web onboarding → FastAPI gateway: registers students
server/main.py - FastAPI gateway → Institutional webhook: dispatches webhook
README.md