# shintoo-engineer/apr-academic-presence-register architecture

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

- Interactive diagram: https://gitdiagram.com/shintoo-engineer/apr-academic-presence-register
- Repository: https://github.com/shintoo-engineer/apr-academic-presence-register

## Overview

APR is an academic management portal presented through role-specific dashboards for students, faculty, HODs, and administrators. The principal workflow is sign-in, role-based dashboard access, and academic operations such as attendance, marks, and leave requests, with monitoring and report export for staff. The sampled implementation is a browser-side React app backed by localStorage and bundled sample data; README claims about a database backend, secure authentication, and synchronization are not verified by the excerpts. Several feature details are documented but their implementation was not sampled.

Main entry points: [`src/App.tsx`](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/App.tsx) (App Router), [`src/services/storageService.ts`](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/services/storageService.ts) (Storage Service), [`src/components/FacultyDashboard.tsx`](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/FacultyDashboard.tsx) (Faculty Dashboard), [`src/components/StudentDashboard.tsx`](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/StudentDashboard.tsx) (Student Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Portal and Access"]
  node_app["App Router<br/>[App.tsx]"]
  node_loginpage["Login Page<br/>[LoginPage.tsx]"]
  node_loginmodal["Login Modal<br/>[LoginModal.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
end

subgraph group_academic["Academic Workflows"]
  node_studentdash["Student Dashboard"]
  node_facultydash["Faculty Dashboard"]
end

subgraph group_oversight["Administration and Reporting"]
  node_hoddash["HOD Dashboard<br/>[HodDashboard.tsx]"]
  node_admindash["Admin Dashboard<br/>[AdminDashboard.tsx]"]
  node_reports["Report Export"]
  node_geofencemodal["Geofence Configuration<br/>[GeofenceModal.tsx]"]
end

subgraph group_runtime["Local Data and Rules"]
  node_studentdata["Student Records<br/>[studentsData.ts]"]
  node_academicdata["Academic Master Data"]
  node_geofencedata["Campus Geofence Rules<br/>[geofenceData.ts]"]
  node_storage["Storage Service<br/>[storageService.ts]"]
  node_browserstore[("Browser Local Storage")]
end

node_students(("Students"))
node_faculty(("Faculty"))
node_hod(("HOD"))
node_admin(("Admin"))

node_students -->|"use portal"| node_app
node_faculty -->|"use portal"| node_app
node_hod -->|"use portal"| node_app
node_admin -->|"use portal"| node_app
node_app -->|"renders"| node_loginpage
node_app -->|"renders"| node_loginmodal
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_studentdash
node_app -->|"routes to"| node_facultydash
node_app -->|"routes to"| node_hoddash
node_app -->|"routes to"| node_admindash
node_app -->|"renders"| node_geofencemodal
node_app -->|"reads and writes"| node_storage
node_app -->|"checks location"| node_geofencedata
node_studentdash -->|"reads and writes"| node_storage
node_facultydash -->|"reads and writes"| node_storage
node_hoddash -->|"reads and writes"| node_storage
node_admindash -->|"reads and writes"| node_storage
node_facultydash -->|"opens export"| node_reports
node_hoddash -->|"opens export"| node_reports
node_geofencemodal -->|"updates settings"| node_storage
node_facultydash -->|"checks location"| node_geofencedata
node_studentdash -->|"uses geofence"| node_geofencedata
node_app -->|"loads records"| node_studentdata
node_storage -->|"initializes sample data"| node_academicdata
node_storage -->|"persists records"| node_browserstore
node_loginmodal -->|"accesses session"| node_storage
node_loginpage -->|"accesses session"| node_storage
node_reports -->|"uses student records"| node_studentdata

click node_app "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/App.tsx"
click node_loginpage "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/LoginPage.tsx"
click node_loginmodal "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/LoginModal.tsx"
click node_navbar "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/Navbar.tsx"
click node_studentdash "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/StudentDashboard.tsx"
click node_facultydash "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/FacultyDashboard.tsx"
click node_hoddash "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/HodDashboard.tsx"
click node_admindash "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/AdminDashboard.tsx"
click node_reports "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/ReportsExportModal.tsx"
click node_geofencemodal "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/GeofenceModal.tsx"
click node_studentdata "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/data/studentsData.ts"
click node_academicdata "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/data/academicMasterData.ts"
click node_geofencedata "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/data/geofenceData.ts"
click node_storage "https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/services/storageService.ts"

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_app,node_loginpage,node_loginmodal,node_navbar toneBlue
class node_studentdash,node_facultydash toneAmber
class node_hoddash,node_admindash,node_reports,node_geofencemodal toneMint
class node_studentdata,node_academicdata,node_geofencedata,node_storage,node_browserstore toneRose
class node_students,node_faculty,node_hod,node_admin toneIndigo
```

## Components

### Portal and Access

- [App Router](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/App.tsx): `src/App.tsx`
- [Login Page](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/LoginPage.tsx): `src/components/LoginPage.tsx`
- [Login Modal](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/LoginModal.tsx): `src/components/LoginModal.tsx`
- [Navigation](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`

### Academic Workflows

- [Student Dashboard](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/StudentDashboard.tsx): `src/components/StudentDashboard.tsx`
- [Faculty Dashboard](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/FacultyDashboard.tsx): `src/components/FacultyDashboard.tsx`

### Administration and Reporting

- [HOD Dashboard](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/HodDashboard.tsx): `src/components/HodDashboard.tsx`
- [Admin Dashboard](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/AdminDashboard.tsx): `src/components/AdminDashboard.tsx`
- [Report Export](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/ReportsExportModal.tsx): `src/components/ReportsExportModal.tsx`
- [Geofence Configuration](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/components/GeofenceModal.tsx): `src/components/GeofenceModal.tsx`

### Local Data and Rules

- [Student Records](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/data/studentsData.ts): `src/data/studentsData.ts`
- [Academic Master Data](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/data/academicMasterData.ts): `src/data/academicMasterData.ts`
- [Campus Geofence Rules](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/data/geofenceData.ts): `src/data/geofenceData.ts`
- [Storage Service](https://github.com/shintoo-engineer/apr-academic-presence-register/blob/main/src/services/storageService.ts): `src/services/storageService.ts`
- **Browser Local Storage**

### Other components

- **Students**
- **Faculty**
- **HOD**
- **Admin**

## Connections

- Students → App Router: use portal
- Faculty → App Router: use portal
- HOD → App Router: use portal
- Admin → App Router: use portal
- App Router → Login Page: renders (evidence: `src/App.tsx`)
- App Router → Login Modal: renders (evidence: `src/App.tsx`)
- App Router → Navigation: renders (evidence: `src/App.tsx`)
- App Router → Student Dashboard: routes to (evidence: `src/App.tsx`)
- App Router → Faculty Dashboard: routes to (evidence: `src/App.tsx`)
- App Router → HOD Dashboard: routes to (evidence: `src/App.tsx`)
- App Router → Admin Dashboard: routes to (evidence: `src/App.tsx`)
- App Router → Geofence Configuration: renders (evidence: `src/App.tsx`)
- App Router → Storage Service: reads and writes (evidence: `src/App.tsx`)
- App Router → Campus Geofence Rules: checks location (evidence: `src/App.tsx`)
- Student Dashboard → Storage Service: reads and writes (evidence: `src/components/StudentDashboard.tsx`)
- Faculty Dashboard → Storage Service: reads and writes (evidence: `src/components/FacultyDashboard.tsx`)
- HOD Dashboard → Storage Service: reads and writes (evidence: `src/components/HodDashboard.tsx`)
- Admin Dashboard → Storage Service: reads and writes (evidence: `src/components/AdminDashboard.tsx`)
- Faculty Dashboard → Report Export: opens export (evidence: `src/components/FacultyDashboard.tsx`)
- HOD Dashboard → Report Export: opens export (evidence: `src/components/HodDashboard.tsx`)
- Geofence Configuration → Storage Service: updates settings (evidence: `src/components/GeofenceModal.tsx`)
- Faculty Dashboard → Campus Geofence Rules: checks location (evidence: `src/components/FacultyDashboard.tsx`)
- Student Dashboard → Campus Geofence Rules: uses geofence (evidence: `src/components/StudentDashboard.tsx`)
- App Router → Student Records: loads records (evidence: `src/App.tsx`)
- Storage Service → Academic Master Data: initializes sample data (evidence: `src/services/storageService.ts`)
- Storage Service → Browser Local Storage: persists records (evidence: `src/services/storageService.ts`)
- Login Modal → Storage Service: accesses session (evidence: `src/components/LoginModal.tsx`)
- Login Page → Storage Service: accesses session (evidence: `src/components/LoginPage.tsx`)
- Report Export → Student Records: uses student records (evidence: `src/components/ReportsExportModal.tsx`)
