# nishanttmaurya/sih20687 architecture

> Architecture diagram of the GitHub repository nishanttmaurya/sih20687, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nishanttmaurya/sih20687
- Repository: https://github.com/nishanttmaurya/sih20687

## Overview

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: [`app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt`](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt) (Attendance pipeline), [`app/src/main/java/com/sih/faceattendance/data/repository`](https://github.com/nishanttmaurya/sih20687/tree/main/app/src/main/java/com/sih/faceattendance/data/repository) (Data repositories), [`app/src/main/java/com/sih/faceattendance/MainActivity.kt`](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/MainActivity.kt) (Screen navigation), [`server/main.py`](https://github.com/nishanttmaurya/sih20687/blob/main/server/main.py) (FastAPI gateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile_ui["Android screens"]
  node_android_app["App setup"]
  node_navigation["Screen navigation<br/>[MainActivity.kt]"]
  node_attendance_screen["Attendance scan"]
  node_enrollment_screen["Face enrollment"]
  node_sessions_screen["Session selection<br/>[SessionsScreen.kt]"]
  node_queue_screen["Offline queue"]
  node_students_screen["Student database<br/>[StudentsScreen.kt]"]
end

subgraph group_verification["Biometric verification"]
  node_pipeline["Attendance pipeline"]
  node_face_detector["Face detection"]
  node_liveness["Liveness defense<br/>[LivenessEngine.kt]"]
  node_phone_detector["Replay detection"]
  node_embedding["Face embeddings"]
  node_similarity["Cosine matching"]
  node_location["GPS geofence<br/>[LocationHelper.kt]"]
end

subgraph group_local_data["Offline data"]
  node_database[("Room database")]
  node_repositories["Data repositories"]
end

subgraph group_connectivity["Sync and gateway"]
  node_network_monitor["Connectivity monitor<br/>[NetworkMonitor.kt]"]
  node_api_client["API client<br/>[NetworkClient.kt]"]
  node_api_service["Sync API"]
end

subgraph group_web_server["Server and web"]
  node_gateway["FastAPI gateway<br/>[main.py]"]
  node_onboarding["Web onboarding<br/>[onboarding_view.py]"]
  node_dashboard["Live dashboard<br/>[main.py]"]
end

node_student(("Student"))
node_institutional_hook["Institutional webhook"]

node_student -->|"uses app"| node_navigation
node_navigation -->|"opens scan"| node_attendance_screen
node_navigation -->|"opens enrollment"| node_enrollment_screen
node_navigation -->|"opens sessions"| node_sessions_screen
node_navigation -->|"opens queue"| node_queue_screen
node_navigation -->|"opens database"| node_students_screen
node_android_app -->|"initializes"| node_database
node_android_app -->|"initializes"| node_repositories
node_android_app -->|"initializes"| node_pipeline
node_android_app -->|"observes"| node_network_monitor
node_attendance_screen -->|"runs verification"| node_pipeline
node_pipeline -->|"detects faces"| node_face_detector
node_pipeline -->|"checks liveness"| node_liveness
node_pipeline -->|"checks replay"| node_phone_detector
node_pipeline -->|"extracts features"| node_embedding
node_embedding -->|"normalizes vectors"| node_similarity
node_pipeline -->|"matches and records"| node_repositories
node_pipeline -.->|"checks geofence"| node_location
node_enrollment_screen -->|"registers profiles"| node_repositories
node_sessions_screen -.->|"manages sessions"| node_repositories
node_repositories -->|"reads and writes"| node_database
node_network_monitor -->|"triggers sync"| node_repositories
node_repositories -->|"syncs records"| node_api_service
node_api_client -->|"creates client"| node_api_service
node_api_service -->|"sends sync requests"| node_gateway
node_gateway -->|"broadcasts SSE"| node_dashboard
node_gateway -->|"serves portal"| node_onboarding
node_onboarding -.->|"registers students"| node_gateway
node_gateway -.->|"dispatches webhook"| node_institutional_hook

click node_android_app "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt"
click node_navigation "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/MainActivity.kt"
click node_attendance_screen "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ui/screens/attendance/AttendanceScreen.kt"
click node_enrollment_screen "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ui/screens/enrollment/EnrollmentScreen.kt"
click node_sessions_screen "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ui/screens/sessions/SessionsScreen.kt"
click node_queue_screen "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ui/screens/queue/OfflineQueueScreen.kt"
click node_students_screen "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ui/screens/students/StudentsScreen.kt"
click node_pipeline "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt"
click node_face_detector "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/FaceDetectorEngine.kt"
click node_liveness "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/LivenessEngine.kt"
click node_phone_detector "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/PhoneDetectorEngine.kt"
click node_embedding "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/FaceEmbeddingEngine.kt"
click node_similarity "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/CosineSimilarity.kt"
click node_location "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/core/LocationHelper.kt"
click node_database "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/data/local/AttendanceDatabase.kt"
click node_repositories "https://github.com/nishanttmaurya/sih20687/tree/main/app/src/main/java/com/sih/faceattendance/data/repository"
click node_network_monitor "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/core/NetworkMonitor.kt"
click node_api_client "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/data/remote/NetworkClient.kt"
click node_api_service "https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/data/remote/AttendanceApiService.kt"
click node_gateway "https://github.com/nishanttmaurya/sih20687/blob/main/server/main.py"
click node_onboarding "https://github.com/nishanttmaurya/sih20687/blob/main/server/onboarding_view.py"
click node_dashboard "https://github.com/nishanttmaurya/sih20687/blob/main/server/main.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_android_app,node_navigation,node_attendance_screen,node_enrollment_screen,node_sessions_screen,node_queue_screen,node_students_screen toneBlue
class node_pipeline,node_face_detector,node_liveness,node_phone_detector,node_embedding,node_similarity,node_location toneAmber
class node_database,node_repositories,node_institutional_hook toneMint
class node_network_monitor,node_api_client,node_api_service toneRose
class node_gateway,node_onboarding,node_dashboard,node_student toneIndigo
```

## Components

### Android screens

- [App setup](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt): `app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt`
- [Screen navigation](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/MainActivity.kt): `app/src/main/java/com/sih/faceattendance/MainActivity.kt`
- [Attendance scan](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ui/screens/attendance/AttendanceScreen.kt): `app/src/main/java/com/sih/faceattendance/ui/screens/attendance/AttendanceScreen.kt`
- [Face enrollment](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ui/screens/enrollment/EnrollmentScreen.kt): `app/src/main/java/com/sih/faceattendance/ui/screens/enrollment/EnrollmentScreen.kt`
- [Session selection](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ui/screens/sessions/SessionsScreen.kt): `app/src/main/java/com/sih/faceattendance/ui/screens/sessions/SessionsScreen.kt`
- [Offline queue](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ui/screens/queue/OfflineQueueScreen.kt): `app/src/main/java/com/sih/faceattendance/ui/screens/queue/OfflineQueueScreen.kt`
- [Student database](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ui/screens/students/StudentsScreen.kt): `app/src/main/java/com/sih/faceattendance/ui/screens/students/StudentsScreen.kt`

### Biometric verification

- [Attendance pipeline](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt): `app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt`
- [Face detection](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/FaceDetectorEngine.kt): `app/src/main/java/com/sih/faceattendance/ml/FaceDetectorEngine.kt`
- [Liveness defense](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/LivenessEngine.kt): `app/src/main/java/com/sih/faceattendance/ml/LivenessEngine.kt`
- [Replay detection](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/PhoneDetectorEngine.kt): `app/src/main/java/com/sih/faceattendance/ml/PhoneDetectorEngine.kt`
- [Face embeddings](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/FaceEmbeddingEngine.kt): `app/src/main/java/com/sih/faceattendance/ml/FaceEmbeddingEngine.kt`
- [Cosine matching](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/ml/CosineSimilarity.kt): `app/src/main/java/com/sih/faceattendance/ml/CosineSimilarity.kt`
- [GPS geofence](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/core/LocationHelper.kt): `app/src/main/java/com/sih/faceattendance/core/LocationHelper.kt`

### Offline data

- [Room database](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/data/local/AttendanceDatabase.kt): `app/src/main/java/com/sih/faceattendance/data/local/AttendanceDatabase.kt`
- [Data repositories](https://github.com/nishanttmaurya/sih20687/tree/main/app/src/main/java/com/sih/faceattendance/data/repository): `app/src/main/java/com/sih/faceattendance/data/repository`

### Sync and gateway

- [Connectivity monitor](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/core/NetworkMonitor.kt): `app/src/main/java/com/sih/faceattendance/core/NetworkMonitor.kt`
- [API client](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/data/remote/NetworkClient.kt): `app/src/main/java/com/sih/faceattendance/data/remote/NetworkClient.kt`
- [Sync API](https://github.com/nishanttmaurya/sih20687/blob/main/app/src/main/java/com/sih/faceattendance/data/remote/AttendanceApiService.kt): `app/src/main/java/com/sih/faceattendance/data/remote/AttendanceApiService.kt`

### Server and web

- [FastAPI gateway](https://github.com/nishanttmaurya/sih20687/blob/main/server/main.py): `server/main.py`
- [Web onboarding](https://github.com/nishanttmaurya/sih20687/blob/main/server/onboarding_view.py): `server/onboarding_view.py`
- [Live dashboard](https://github.com/nishanttmaurya/sih20687/blob/main/server/main.py): `server/main.py`

### Other components

- **Student**
- **Institutional webhook**

## Connections

- Student → Screen navigation: uses app (evidence: `README.md`)
- Screen navigation → Attendance scan: opens scan (evidence: `app/src/main/java/com/sih/faceattendance/MainActivity.kt`)
- Screen navigation → Face enrollment: opens enrollment (evidence: `app/src/main/java/com/sih/faceattendance/MainActivity.kt`)
- Screen navigation → Session selection: opens sessions (evidence: `app/src/main/java/com/sih/faceattendance/MainActivity.kt`)
- Screen navigation → Offline queue: opens queue (evidence: `app/src/main/java/com/sih/faceattendance/MainActivity.kt`)
- Screen navigation → Student database: opens database (evidence: `app/src/main/java/com/sih/faceattendance/MainActivity.kt`)
- App setup → Room database: initializes (evidence: `app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt`)
- App setup → Data repositories: initializes (evidence: `app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt`)
- App setup → Attendance pipeline: initializes (evidence: `app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt`)
- App setup → Connectivity monitor: observes (evidence: `app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt`)
- Attendance scan → Attendance pipeline: runs verification (evidence: `app/src/main/java/com/sih/faceattendance/ui/screens/attendance/AttendanceScreen.kt`)
- Attendance pipeline → Face detection: detects faces (evidence: `app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt`)
- Attendance pipeline → Liveness defense: checks liveness (evidence: `app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt`)
- Attendance pipeline → Replay detection: checks replay (evidence: `app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt`)
- Attendance pipeline → Face embeddings: extracts features (evidence: `app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt`)
- Face embeddings → Cosine matching: normalizes vectors (evidence: `app/src/main/java/com/sih/faceattendance/ml/FaceEmbeddingEngine.kt`)
- Attendance pipeline → Data repositories: matches and records (evidence: `app/src/main/java/com/sih/faceattendance/ml/AttendancePipelineCoordinator.kt`)
- Attendance pipeline → GPS geofence: checks geofence
- Face enrollment → Data repositories: registers profiles (evidence: `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 (evidence: `app/src/main/java/com/sih/faceattendance/data/repository/StudentRepository.kt`)
- Connectivity monitor → Data repositories: triggers sync (evidence: `app/src/main/java/com/sih/faceattendance/AttendanceApplication.kt`)
- Data repositories → Sync API: syncs records (evidence: `app/src/main/java/com/sih/faceattendance/data/repository/AttendanceRepository.kt`)
- API client → Sync API: creates client (evidence: `app/src/main/java/com/sih/faceattendance/data/remote/NetworkClient.kt`)
- Sync API → FastAPI gateway: sends sync requests (evidence: `README.md`)
- FastAPI gateway → Live dashboard: broadcasts SSE (evidence: `README.md`)
- FastAPI gateway → Web onboarding: serves portal (evidence: `server/main.py`)
- Web onboarding → FastAPI gateway: registers students (evidence: `server/main.py`)
- FastAPI gateway → Institutional webhook: dispatches webhook (evidence: `README.md`)
