# aman8704/geofencedattendancesystem architecture

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

- Interactive diagram: https://gitdiagram.com/aman8704/geofencedattendancesystem
- Repository: https://github.com/aman8704/geofencedattendancesystem

## Overview

SmartAttendance is an Android geofenced attendance app with separate professor and student workflows. Professors authenticate, create location-configured classes, and run attendance sessions; students authenticate, join with a code, and submit attendance after location verification. The README also documents histories, analytics, profiles, and CSV export. Source excerpts were not provided, so links below reflect documented workflows and capabilities, not verified Kotlin call chains; several feature-to-file assignments are based on the file tree.

Main entry points: [`app/src/main/java/com/example/smartattendance/professor/log_reg/ProfessorLoginActivity.kt`](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/professor/log_reg/ProfessorLoginActivity.kt) (Professor login), [`app/src/main/java/com/example/smartattendance/professor/professor_home/fragments/ProfessorClassesFragment.kt`](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/professor/professor_home/fragments/ProfessorClassesFragment.kt) (Class management), [`app/src/main/java/com/example/smartattendance/student/log_reg/StudentLoginActivity.kt`](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/log_reg/StudentLoginActivity.kt) (Student login), [`app/src/main/java/com/example/smartattendance/student/student_home/attendance/StudentAttendanceActivity.kt`](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/student_home/attendance/StudentAttendanceActivity.kt) (Location check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_professor["Professor tools"]
  node_professor_auth["Professor login"]
  node_professor_classes["Class management"]
  node_session_control["Session control"]
  node_professor_history["Attendance history"]
  node_csv_export["CSV export<br/>[CsvExporter.kt]"]
end

subgraph group_student["Student tools"]
  node_student_auth["Student login"]
  node_class_join["Join class"]
  node_student_report["Attendance report"]
  node_student_profile["Profile management"]
end

subgraph group_attendance["Attendance workflow"]
  node_location_check["Location check"]
  node_mark_attendance["Mark attendance"]
end

subgraph group_services["External services"]
  node_firebase_auth["Firebase Authentication"]
  node_location_service["GPS location"]
  node_firestore[("Firestore")]
end

node_professor_actor(("Professor"))
node_student_actor(("Student"))

node_professor_actor -->|"signs in"| node_professor_auth
node_professor_auth -->|"authenticates"| node_firebase_auth
node_professor_actor -->|"creates classes"| node_professor_classes
node_professor_classes -->|"configures location"| node_session_control
node_professor_actor -->|"starts session"| node_session_control
node_student_actor -->|"signs in"| node_student_auth
node_student_auth -->|"authenticates"| node_firebase_auth
node_student_actor -->|"joins by code"| node_class_join
node_student_actor -->|"gets location"| node_location_check
node_location_check -->|"reads GPS"| node_location_service
node_student_actor -->|"marks attendance"| node_mark_attendance
node_mark_attendance -->|"stores attendance"| node_firestore
node_professor_actor -->|"views history"| node_professor_history
node_professor_actor -->|"exports records"| node_csv_export
node_student_actor -->|"views report"| node_student_report
node_student_actor -->|"manages profile"| node_student_profile

click node_professor_auth "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/professor/log_reg/ProfessorLoginActivity.kt"
click node_professor_classes "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/professor/professor_home/fragments/ProfessorClassesFragment.kt"
click node_session_control "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/professor/professor_home/attendance/AttendanceRunningActivity.kt"
click node_professor_history "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/professor/professor_home/attendance/AttendanceHistoryActivity.kt"
click node_csv_export "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/utils/CsvExporter.kt"
click node_student_auth "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/log_reg/StudentLoginActivity.kt"
click node_class_join "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/dashboard/fragments/StudentClassesFragment.kt"
click node_location_check "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/student_home/attendance/StudentAttendanceActivity.kt"
click node_mark_attendance "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/student_home/attendance/StudentAttendanceActivity.kt"
click node_student_report "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/student_home/StudentAttendanceReportActivity.kt"
click node_student_profile "https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/student_home/profile/StudentCompleteProfileActivity.kt"

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_professor_auth,node_professor_classes,node_session_control,node_professor_history,node_csv_export toneBlue
class node_student_auth,node_class_join,node_student_report,node_student_profile toneAmber
class node_location_check,node_mark_attendance toneMint
class node_firebase_auth,node_location_service,node_firestore toneRose
class node_professor_actor,node_student_actor toneIndigo
```

## Components

### Professor tools

- [Professor login](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/professor/log_reg/ProfessorLoginActivity.kt): `app/src/main/java/com/example/smartattendance/professor/log_reg/ProfessorLoginActivity.kt`
- [Class management](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/professor/professor_home/fragments/ProfessorClassesFragment.kt): `app/src/main/java/com/example/smartattendance/professor/professor_home/fragments/ProfessorClassesFragment.kt`
- [Session control](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/professor/professor_home/attendance/AttendanceRunningActivity.kt): `app/src/main/java/com/example/smartattendance/professor/professor_home/attendance/AttendanceRunningActivity.kt`
- [Attendance history](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/professor/professor_home/attendance/AttendanceHistoryActivity.kt): `app/src/main/java/com/example/smartattendance/professor/professor_home/attendance/AttendanceHistoryActivity.kt`
- [CSV export](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/utils/CsvExporter.kt): `app/src/main/java/com/example/smartattendance/utils/CsvExporter.kt`

### Student tools

- [Student login](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/log_reg/StudentLoginActivity.kt): `app/src/main/java/com/example/smartattendance/student/log_reg/StudentLoginActivity.kt`
- [Join class](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/dashboard/fragments/StudentClassesFragment.kt): `app/src/main/java/com/example/smartattendance/student/dashboard/fragments/StudentClassesFragment.kt`
- [Attendance report](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/student_home/StudentAttendanceReportActivity.kt): `app/src/main/java/com/example/smartattendance/student/student_home/StudentAttendanceReportActivity.kt`
- [Profile management](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/student_home/profile/StudentCompleteProfileActivity.kt): `app/src/main/java/com/example/smartattendance/student/student_home/profile/StudentCompleteProfileActivity.kt`

### Attendance workflow

- [Location check](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/student_home/attendance/StudentAttendanceActivity.kt): `app/src/main/java/com/example/smartattendance/student/student_home/attendance/StudentAttendanceActivity.kt`
- [Mark attendance](https://github.com/aman8704/geofencedattendancesystem/blob/main/app/src/main/java/com/example/smartattendance/student/student_home/attendance/StudentAttendanceActivity.kt): `app/src/main/java/com/example/smartattendance/student/student_home/attendance/StudentAttendanceActivity.kt`

### External services

- **Firebase Authentication**
- **GPS location**
- **Firestore**

### Other components

- **Professor**
- **Student**

## Connections

- Professor → Professor login: signs in (evidence: `README.md`)
- Professor login → Firebase Authentication: authenticates (evidence: `README.md`)
- Professor → Class management: creates classes (evidence: `README.md`)
- Class management → Session control: configures location (evidence: `README.md`)
- Professor → Session control: starts session (evidence: `README.md`)
- Student → Student login: signs in (evidence: `README.md`)
- Student login → Firebase Authentication: authenticates (evidence: `README.md`)
- Student → Join class: joins by code (evidence: `README.md`)
- Student → Location check: gets location (evidence: `README.md`)
- Location check → GPS location: reads GPS (evidence: `README.md`)
- Student → Mark attendance: marks attendance (evidence: `README.md`)
- Mark attendance → Firestore: stores attendance (evidence: `README.md`)
- Professor → Attendance history: views history (evidence: `README.md`)
- Professor → CSV export: exports records (evidence: `README.md`)
- Student → Attendance report: views report (evidence: `README.md`)
- Student → Profile management: manages profile (evidence: `README.md`)
