# harini-elite123/smart-geo-location-attendance-system-using-face-recognition architecture

> Architecture diagram of the GitHub repository harini-elite123/smart-geo-location-attendance-system-using-face-recognition, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition
- Repository: https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition

## Overview

This is a Flask-based attendance system using MongoDB, with face recognition and location checks at its center. The principal student flow is camera capture, face verification, GPS capture, then attendance submission; the backend also supports administrative, faculty, and student-management views. The excerpts establish the browser-side flow and some database operations, but omit the matching route implementations and much of the application, so those connections are left unverified rather than inferred.

Main entry points: [`app.py`](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/app.py) (Flask application), [`faculty.html`](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/faculty.html) (Faculty portal), [`location.js`](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/location.js) (Camera and GPS), [`student.html`](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/student.html) (Attendance page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_attendance["Attendance workflow"]
  node_attendance_page["Attendance page<br/>[student.html]"]
  node_browser_flow["Camera and GPS<br/>[location.js]"]
  node_attendance_api["Flask application<br/>[app.py]"]
  node_face_check["Face verification<br/>[app.py]"]
  node_location_check["Location validation<br/>[app.py]"]
  node_attendance_recording["Attendance recording<br/>[app.py]"]
  node_mongo[("MongoDB")]
end

subgraph group_management["User management"]
  node_student_admin["Student administration<br/>[admin_student.html]"]
  node_faculty_admin["Faculty administration<br/>[admin_faculty.html]"]
  node_student_profile["Student profile"]
end

subgraph group_reporting["Attendance reporting"]
  node_faculty_portal["Faculty portal<br/>[faculty.html]"]
  node_attendance_view["Attendance view"]
  node_analytics["Attendance analytics"]
  node_graphs["Attendance graphs"]
  node_history["Attendance history"]
end

node_student(("Student"))
node_faculty(("Faculty"))
node_admin(("Administrator"))

node_student -->|"opens"| node_attendance_page
node_attendance_page -.->|"uses"| node_browser_flow
node_browser_flow -->|"posts verification"| node_attendance_api
node_browser_flow -->|"submits attendance"| node_attendance_api
node_attendance_api -.->|"handles verification"| node_face_check
node_attendance_api -.->|"checks location"| node_location_check
node_attendance_api -.->|"records attendance"| node_attendance_recording
node_attendance_api -->|"reads and writes"| node_mongo
node_admin -.->|"manages students"| node_student_admin
node_admin -.->|"manages faculty"| node_faculty_admin
node_student -.->|"updates profile"| node_student_profile
node_faculty -.->|"opens"| node_faculty_portal
node_faculty_portal -.->|"views records"| node_attendance_view
node_faculty_portal -.->|"views analytics"| node_analytics
node_faculty_portal -.->|"views graphs"| node_graphs
node_faculty_portal -.->|"views history"| node_history

click node_attendance_page "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/student.html"
click node_browser_flow "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/location.js"
click node_attendance_api "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/app.py"
click node_face_check "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/app.py"
click node_location_check "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/app.py"
click node_attendance_recording "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/app.py"
click node_student_admin "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/admin_student.html"
click node_faculty_admin "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/admin_faculty.html"
click node_student_profile "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/student_profile.html"
click node_faculty_portal "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/faculty.html"
click node_attendance_view "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/view_attendance.html"
click node_analytics "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/attendance_analytics.html"
click node_graphs "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/attendance_graph.html"
click node_history "https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/attendance_history.html"

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_attendance_page,node_browser_flow,node_attendance_api,node_face_check,node_location_check,node_attendance_recording,node_mongo toneBlue
class node_student_admin,node_faculty_admin,node_student_profile toneAmber
class node_faculty_portal,node_attendance_view,node_analytics,node_graphs,node_history toneMint
class node_student,node_faculty,node_admin toneIndigo
```

## Components

### Attendance workflow

- [Attendance page](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/student.html): `student.html`
- [Camera and GPS](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/location.js): `location.js`
- [Flask application](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/app.py): `app.py`
- [Face verification](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/app.py): `app.py`
- [Location validation](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/app.py): `app.py`
- [Attendance recording](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/app.py): `app.py`
- **MongoDB**

### User management

- [Student administration](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/admin_student.html): `admin_student.html`
- [Faculty administration](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/admin_faculty.html): `admin_faculty.html`
- [Student profile](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/student_profile.html): `student_profile.html`

### Attendance reporting

- [Faculty portal](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/faculty.html): `faculty.html`
- [Attendance view](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/view_attendance.html): `view_attendance.html`
- [Attendance analytics](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/attendance_analytics.html): `attendance_analytics.html`
- [Attendance graphs](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/attendance_graph.html): `attendance_graph.html`
- [Attendance history](https://github.com/harini-elite123/smart-geo-location-attendance-system-using-face-recognition/blob/main/attendance_history.html): `attendance_history.html`

### Other components

- **Student**
- **Faculty**
- **Administrator**

## Connections

- Student → Attendance page: opens
- Attendance page → Camera and GPS: uses
- Camera and GPS → Flask application: posts verification (evidence: `location.js`)
- Camera and GPS → Flask application: submits attendance (evidence: `location.js`)
- Flask application → Face verification: handles verification (evidence: `app.py`)
- Flask application → Location validation: checks location (evidence: `app.py`)
- Flask application → Attendance recording: records attendance (evidence: `app.py`)
- Flask application → MongoDB: reads and writes (evidence: `app.py`)
- Administrator → Student administration: manages students
- Administrator → Faculty administration: manages faculty
- Student → Student profile: updates profile
- Faculty → Faculty portal: opens
- Faculty portal → Attendance view: views records
- Faculty portal → Attendance analytics: views analytics
- Faculty portal → Attendance graphs: views graphs
- Faculty portal → Attendance history: views history
