# gael2053/sams-student-attendance-management-system architecture

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

## Overview

This is a terminal-based student attendance management system. A teacher logs in, selects attendance entry or reporting, and can clear saved records; attendance entry collects student, section and subject details, classifies the check-in time, then persists and displays the record. The graph separates orchestration, attendance processing, access/configuration and presentation/storage. The README gives only the product name, so capabilities and relationships here are based on the sampled source; the text file is the configured record store.

Main entry points: [`main.py`](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/main.py) (Menu orchestrator), [`attendance.py`](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py) (Attendance entry), [`storage.py`](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/storage.py) (Record persistence), [`UI.py`](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/UI.py) (Terminal display)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Application flow"]
  node_main["Menu orchestrator<br/>[main.py]"]
end

subgraph group_attendance["Attendance"]
  node_student_info["Student details<br/>[attendance.py]"]
  node_section_choice["Section selection<br/>[attendance.py]"]
  node_subject_choice["Subject selection<br/>[attendance.py]"]
  node_classification["Status classification<br/>[attendance.py]"]
  node_attendance_entry["Attendance entry<br/>[attendance.py]"]
  node_attendance_report["Records and summary<br/>[attendance.py]"]
end

subgraph group_support["Access and configuration"]
  node_login["Teacher login<br/>[auth.py]"]
  node_settings["System settings<br/>[config.py]"]
end

subgraph group_presentation_storage["Presentation and storage"]
  node_ui["Terminal display<br/>[UI.py]"]
  node_storage["Record persistence<br/>[storage.py]"]
  node_record_file[("Attendance records")]
end

node_teacher(("Teacher"))

node_teacher -->|"uses menu"| node_main
node_main -->|"authenticates"| node_login
node_main -->|"dispatches entry"| node_attendance_entry
node_main -->|"dispatches report"| node_attendance_report
node_main -->|"loads and clears"| node_storage
node_main -->|"saves on exit"| node_storage
node_main -->|"displays menu"| node_ui
node_login -->|"checks credentials"| node_settings
node_login -->|"shows banner"| node_ui
node_attendance_entry -->|"collects details"| node_student_info
node_attendance_entry -->|"selects section"| node_section_choice
node_attendance_entry -->|"selects subject"| node_subject_choice
node_attendance_entry -->|"classifies check-in"| node_classification
node_attendance_entry -->|"appends and saves"| node_storage
node_attendance_entry -->|"displays record"| node_ui
node_attendance_report -->|"uses subjects"| node_settings
node_attendance_report -->|"renders report"| node_ui
node_attendance_report -->|"reads records"| node_storage
node_storage -->|"gets file setting"| node_settings
node_storage -->|"prompts for deletion"| node_ui
node_storage -->|"reads writes deletes"| node_record_file

click node_main "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/main.py"
click node_login "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/auth.py"
click node_settings "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/config.py"
click node_student_info "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py"
click node_section_choice "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py"
click node_subject_choice "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py"
click node_classification "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py"
click node_attendance_entry "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py"
click node_attendance_report "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py"
click node_ui "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/UI.py"
click node_storage "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/storage.py"
click node_record_file "https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance_records.txt"

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_main toneBlue
class node_student_info,node_section_choice,node_subject_choice,node_classification,node_attendance_entry,node_attendance_report toneAmber
class node_login,node_settings toneMint
class node_ui,node_storage,node_record_file toneRose
class node_teacher toneIndigo
```

## Components

### Application flow

- [Menu orchestrator](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/main.py): `main.py`

### Attendance

- [Student details](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py): `attendance.py`
- [Section selection](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py): `attendance.py`
- [Subject selection](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py): `attendance.py`
- [Status classification](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py): `attendance.py`
- [Attendance entry](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py): `attendance.py`
- [Records and summary](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance.py): `attendance.py`

### Access and configuration

- [Teacher login](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/auth.py): `auth.py`
- [System settings](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/config.py): `config.py`

### Presentation and storage

- [Terminal display](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/UI.py): `UI.py`
- [Record persistence](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/storage.py): `storage.py`
- [Attendance records](https://github.com/gael2053/sams-student-attendance-management-system/blob/main/attendance_records.txt): `attendance_records.txt`

### Other components

- **Teacher**

## Connections

- Teacher → Menu orchestrator: uses menu (evidence: `main.py`)
- Menu orchestrator → Teacher login: authenticates (evidence: `main.py`)
- Menu orchestrator → Attendance entry: dispatches entry (evidence: `main.py`)
- Menu orchestrator → Records and summary: dispatches report (evidence: `main.py`)
- Menu orchestrator → Record persistence: loads and clears (evidence: `main.py`)
- Menu orchestrator → Record persistence: saves on exit (evidence: `main.py`)
- Menu orchestrator → Terminal display: displays menu (evidence: `main.py`)
- Teacher login → System settings: checks credentials (evidence: `auth.py`)
- Teacher login → Terminal display: shows banner (evidence: `auth.py`)
- Attendance entry → Student details: collects details (evidence: `attendance.py`)
- Attendance entry → Section selection: selects section (evidence: `attendance.py`)
- Attendance entry → Subject selection: selects subject (evidence: `attendance.py`)
- Attendance entry → Status classification: classifies check-in (evidence: `attendance.py`)
- Attendance entry → Record persistence: appends and saves (evidence: `attendance.py`)
- Attendance entry → Terminal display: displays record (evidence: `attendance.py`)
- Records and summary → System settings: uses subjects (evidence: `attendance.py`)
- Records and summary → Terminal display: renders report (evidence: `attendance.py`)
- Records and summary → Record persistence: reads records (evidence: `attendance.py`)
- Record persistence → System settings: gets file setting (evidence: `storage.py`)
- Record persistence → Terminal display: prompts for deletion (evidence: `storage.py`)
- Record persistence → Attendance records: reads writes deletes (evidence: `storage.py`)
