# siddhu-1024/attendance-management-system architecture

> Architecture diagram of the GitHub repository siddhu-1024/attendance-management-system, 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/siddhu-1024/attendance-management-system
- Repository: https://github.com/siddhu-1024/attendance-management-system

## Overview

The repository’s main application is a Flask attendance-management system: staff sign in, manage attendance sessions, and review attendance summaries; students can view their attendance and timetable. The root-level app is the richer implementation, while the nested “Smart Class Room & Attendence System” directory contains a separate, simpler attendance app. The README is minimal, so the richer capabilities shown here come from sampled source and frontend API references; unsampled route details are not inferred.

Main entry points: [`models.py`](https://github.com/siddhu-1024/attendance-management-system/blob/main/models.py) (Domain models), [`app.py`](https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py) (Flask API and routes), [`Smart Class Room & Attendence System/app.py`](https://github.com/siddhu-1024/attendance-management-system/blob/main/Smart%20Class%20Room%20%26%20Attendence%20System/app.py) (Simple attendance app), [`static/script.js`](https://github.com/siddhu-1024/attendance-management-system/blob/main/static/script.js) (Portal controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_frontend["Portal controller<br/>[script.js]"]
  node_templates["Portal pages"]
  node_legacy_ui["Simple attendance UI<br/>[script.js]"]
end

subgraph group_attendance["Attendance workflows"]
  node_flask_app["Flask API and routes<br/>[app.py]"]
  node_attendance_ops["Attendance sessions<br/>[app.py]"]
  node_identity["Authentication and roles<br/>[app.py]"]
  node_student_portal["Student dashboard<br/>[app.py]"]
  node_timetable["Timetable service<br/>[app.py]"]
  node_legacy_app["Simple attendance app<br/>[app.py]"]
end

subgraph group_insights["Reports and insights"]
  node_analytics["Attendance analytics<br/>[app.py]"]
  node_history["Attendance history<br/>[app.py]"]
  node_exports["Report generation<br/>[export_utils.py]"]
end

subgraph group_data["Domain data"]
  node_models["Domain models<br/>[models.py]"]
  node_sqlite[("SQLite database<br/>[smart_classroom.db]")]
  node_legacy_models["Legacy models<br/>[models.py]"]
end

node_staff(("Staff user"))
node_student_user(("Student user"))

node_staff -->|"uses"| node_frontend
node_student_user -->|"uses"| node_frontend
node_frontend -->|"calls API"| node_flask_app
node_flask_app -.->|"renders pages"| node_templates
node_flask_app -->|"uses models"| node_models
node_flask_app -->|"uses reports"| node_exports
node_attendance_ops -.->|"reads and writes"| node_models
node_analytics -.->|"queries records"| node_models
node_history -.->|"queries sessions"| node_models
node_student_portal -.->|"queries student data"| node_models
node_timetable -.->|"queries schedule"| node_models
node_models -.->|"persists data"| node_sqlite
node_legacy_app -->|"uses models"| node_legacy_models
node_legacy_app -.->|"uses database"| node_sqlite
node_legacy_ui -->|"calls API"| node_legacy_app

click node_frontend "https://github.com/siddhu-1024/attendance-management-system/blob/main/static/script.js"
click node_templates "https://github.com/siddhu-1024/attendance-management-system/tree/main/templates"
click node_flask_app "https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py"
click node_attendance_ops "https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py"
click node_identity "https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py"
click node_student_portal "https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py"
click node_timetable "https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py"
click node_analytics "https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py"
click node_history "https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py"
click node_exports "https://github.com/siddhu-1024/attendance-management-system/blob/main/export_utils.py"
click node_models "https://github.com/siddhu-1024/attendance-management-system/blob/main/models.py"
click node_sqlite "https://github.com/siddhu-1024/attendance-management-system/blob/main/instance/smart_classroom.db"
click node_legacy_app "https://github.com/siddhu-1024/attendance-management-system/blob/main/Smart%20Class%20Room%20%26%20Attendence%20System/app.py"
click node_legacy_models "https://github.com/siddhu-1024/attendance-management-system/blob/main/Smart%20Class%20Room%20%26%20Attendence%20System/models.py"
click node_legacy_ui "https://github.com/siddhu-1024/attendance-management-system/blob/main/Smart%20Class%20Room%20%26%20Attendence%20System/static/script.js"

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_frontend,node_templates,node_legacy_ui,node_staff,node_student_user toneBlue
class node_flask_app,node_attendance_ops,node_identity,node_student_portal,node_timetable,node_legacy_app toneAmber
class node_analytics,node_history,node_exports toneMint
class node_models,node_sqlite,node_legacy_models toneRose
```

## Components

### Web interface

- [Portal controller](https://github.com/siddhu-1024/attendance-management-system/blob/main/static/script.js): `static/script.js`
- [Portal pages](https://github.com/siddhu-1024/attendance-management-system/tree/main/templates): `templates`
- [Simple attendance UI](https://github.com/siddhu-1024/attendance-management-system/blob/main/Smart%20Class%20Room%20%26%20Attendence%20System/static/script.js): `Smart Class Room & Attendence System/static/script.js`

### Attendance workflows

- [Flask API and routes](https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py): `app.py`
- [Attendance sessions](https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py): `app.py`
- [Authentication and roles](https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py): `app.py`
- [Student dashboard](https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py): `app.py`
- [Timetable service](https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py): `app.py`
- [Simple attendance app](https://github.com/siddhu-1024/attendance-management-system/blob/main/Smart%20Class%20Room%20%26%20Attendence%20System/app.py): `Smart Class Room & Attendence System/app.py`

### Reports and insights

- [Attendance analytics](https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py): `app.py`
- [Attendance history](https://github.com/siddhu-1024/attendance-management-system/blob/main/app.py): `app.py`
- [Report generation](https://github.com/siddhu-1024/attendance-management-system/blob/main/export_utils.py): `export_utils.py`

### Domain data

- [Domain models](https://github.com/siddhu-1024/attendance-management-system/blob/main/models.py): `models.py`
- [SQLite database](https://github.com/siddhu-1024/attendance-management-system/blob/main/instance/smart_classroom.db): `instance/smart_classroom.db`
- [Legacy models](https://github.com/siddhu-1024/attendance-management-system/blob/main/Smart%20Class%20Room%20%26%20Attendence%20System/models.py): `Smart Class Room & Attendence System/models.py`

### Other components

- **Staff user**
- **Student user**

## Connections

- Staff user → Portal controller: uses (evidence: `static/script.js`)
- Student user → Portal controller: uses (evidence: `static/script.js`)
- Portal controller → Flask API and routes: calls API (evidence: `static/script.js`)
- Flask API and routes → Portal pages: renders pages
- Flask API and routes → Domain models: uses models (evidence: `app.py`)
- Flask API and routes → Report generation: uses reports (evidence: `app.py`)
- Attendance sessions → Domain models: reads and writes (evidence: `app.py`)
- Attendance analytics → Domain models: queries records (evidence: `app.py`)
- Attendance history → Domain models: queries sessions (evidence: `app.py`)
- Student dashboard → Domain models: queries student data (evidence: `app.py`)
- Timetable service → Domain models: queries schedule (evidence: `app.py`)
- Domain models → SQLite database: persists data
- Simple attendance app → Legacy models: uses models (evidence: `Smart Class Room & Attendence System/app.py`)
- Simple attendance app → SQLite database: uses database
- Simple attendance UI → Simple attendance app: calls API (evidence: `Smart Class Room & Attendence System/static/script.js`)
