# ruxhi26/exam-schedule-management architecture

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

- Interactive diagram: https://gitdiagram.com/ruxhi26/exam-schedule-management
- Repository: https://github.com/ruxhi26/exam-schedule-management

## Overview

This is a small PHP exam-schedule management application. Its visible entry page presents admin and student access; the admin login verifies credentials and redirects to a dashboard that reports subject, room, and exam counts. The sampled subject handlers add, edit, and delete subjects. The entry page also advertises student timetable search and room/exam management, but their implementation files are absent from the supplied tree. Database connection wiring is uncertain because sampled pages reference config paths not present in the tree.

Main entry points: [`database.sql`](https://github.com/ruxhi26/exam-schedule-management/blob/main/database.sql) (MySQL database), [`index.php`](https://github.com/ruxhi26/exam-schedule-management/blob/main/index.php) (Landing page), [`login.php`](https://github.com/ruxhi26/exam-schedule-management/blob/main/login.php) (Admin login), [`dashboard.php`](https://github.com/ruxhi26/exam-schedule-management/blob/main/dashboard.php) (Admin dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and access"]
  node_landing["Landing page<br/>[index.php]"]
  node_admin_login["Admin login<br/>[login.php]"]
  node_session_guard["Session guards<br/>[auth.php]"]
  node_student_schedule["Student timetable"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Admin dashboard<br/>[dashboard.php]"]
  node_subject_add["Add subject<br/>[add.php]"]
  node_subject_edit["Edit subject<br/>[edit.php]"]
  node_subject_delete["Delete subject<br/>[delete.php]"]
  node_provision_admin["Provision admin<br/>[setup_admin.php]"]
  node_room_exam_management["Room and exam management"]
end

subgraph group_data["Data"]
  node_mysql[("MySQL database<br/>[database.sql]")]
end

node_visitor(("Visitor"))
node_admin_user(("Administrator"))
node_student_user(("Student"))

node_visitor -->|"opens"| node_landing
node_admin_user -->|"signs in"| node_admin_login
node_student_user -->|"opens"| node_landing
node_landing -->|"links to"| node_admin_login
node_landing -->|"links to"| node_student_schedule
node_landing -->|"advertises"| node_room_exam_management
node_admin_login -->|"queries credentials"| node_mysql
node_admin_login -->|"redirects to"| node_admin_dashboard
node_admin_dashboard -->|"counts records"| node_mysql
node_subject_add -->|"inserts subject"| node_mysql
node_subject_edit -->|"updates subject"| node_mysql
node_subject_delete -->|"deletes subject"| node_mysql
node_provision_admin -->|"stores credentials"| node_mysql

click node_landing "https://github.com/ruxhi26/exam-schedule-management/blob/main/index.php"
click node_admin_login "https://github.com/ruxhi26/exam-schedule-management/blob/main/login.php"
click node_session_guard "https://github.com/ruxhi26/exam-schedule-management/blob/main/auth.php"
click node_admin_dashboard "https://github.com/ruxhi26/exam-schedule-management/blob/main/dashboard.php"
click node_subject_add "https://github.com/ruxhi26/exam-schedule-management/blob/main/add.php"
click node_subject_edit "https://github.com/ruxhi26/exam-schedule-management/blob/main/edit.php"
click node_subject_delete "https://github.com/ruxhi26/exam-schedule-management/blob/main/delete.php"
click node_provision_admin "https://github.com/ruxhi26/exam-schedule-management/blob/main/setup_admin.php"
click node_mysql "https://github.com/ruxhi26/exam-schedule-management/blob/main/database.sql"

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_landing,node_admin_login,node_session_guard,node_student_schedule toneBlue
class node_admin_dashboard,node_subject_add,node_subject_edit,node_subject_delete,node_provision_admin,node_room_exam_management toneAmber
class node_mysql toneMint
class node_visitor,node_admin_user,node_student_user toneIndigo
```

## Components

### Entry and access

- [Landing page](https://github.com/ruxhi26/exam-schedule-management/blob/main/index.php): `index.php`
- [Admin login](https://github.com/ruxhi26/exam-schedule-management/blob/main/login.php): `login.php`
- [Session guards](https://github.com/ruxhi26/exam-schedule-management/blob/main/auth.php): `auth.php`
- **Student timetable**

### Administration

- [Admin dashboard](https://github.com/ruxhi26/exam-schedule-management/blob/main/dashboard.php): `dashboard.php`
- [Add subject](https://github.com/ruxhi26/exam-schedule-management/blob/main/add.php): `add.php`
- [Edit subject](https://github.com/ruxhi26/exam-schedule-management/blob/main/edit.php): `edit.php`
- [Delete subject](https://github.com/ruxhi26/exam-schedule-management/blob/main/delete.php): `delete.php`
- [Provision admin](https://github.com/ruxhi26/exam-schedule-management/blob/main/setup_admin.php): `setup_admin.php`
- **Room and exam management**

### Data

- [MySQL database](https://github.com/ruxhi26/exam-schedule-management/blob/main/database.sql): `database.sql`

### Other components

- **Visitor**
- **Administrator**
- **Student**

## Connections

- Visitor → Landing page: opens (evidence: `index.php`)
- Administrator → Admin login: signs in (evidence: `login.php`)
- Student → Landing page: opens (evidence: `index.php`)
- Landing page → Admin login: links to (evidence: `index.php`)
- Landing page → Student timetable: links to (evidence: `index.php`)
- Landing page → Room and exam management: advertises (evidence: `index.php`)
- Admin login → MySQL database: queries credentials (evidence: `login.php`)
- Admin login → Admin dashboard: redirects to (evidence: `login.php`)
- Admin dashboard → MySQL database: counts records (evidence: `dashboard.php`)
- Add subject → MySQL database: inserts subject (evidence: `add.php`)
- Edit subject → MySQL database: updates subject (evidence: `edit.php`)
- Delete subject → MySQL database: deletes subject (evidence: `delete.php`)
- Provision admin → MySQL database: stores credentials (evidence: `setup_admin.php`)
