# siamsell/exam_scheduler architecture

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

- Interactive diagram: https://gitdiagram.com/siamsell/exam_scheduler
- Repository: https://github.com/siamsell/exam_scheduler

## Overview

This is a Streamlit exam-management application for UMBB. Its main workflow is authenticated data management, constrained exam scheduling, leadership validation, then schedule consultation by staff and students. The 499 KB frontend is a single sampled application file, so its distinct capabilities are represented as components sharing that path. Relationships among those capabilities follow the README’s documented workflow; implementation details beyond the excerpts are not assumed.

Main entry points: [`frontend/app.py`](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py) (Streamlit application), [`backend/database/schema.sql`](https://github.com/siamsell/exam_scheduler/blob/main/backend/database/schema.sql) (PostgreSQL database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and oversight"]
  node_streamlit_app["Streamlit application<br/>[app.py]"]
  node_authentication["Authentication and roles<br/>[app.py]"]
  node_dashboard["Statistics dashboard<br/>[app.py]"]
  node_strategic_view["Strategic view<br/>[app.py]"]
end

subgraph group_planning["Exam planning"]
  node_schedule_generator["Schedule generator<br/>[app.py]"]
  node_conflict_reporting["Conflict reporting<br/>[app.py]"]
  node_schedule_validation["Schedule validation<br/>[app.py]"]
  node_personal_schedules["Personal schedules<br/>[app.py]"]
end

subgraph group_operations["Academic operations"]
  node_department_management["Department management<br/>[app.py]"]
  node_specialty_management["Specialty management<br/>[app.py]"]
  node_training_management["Training management<br/>[app.py]"]
  node_module_management["Module management<br/>[app.py]"]
  node_student_management["Student management<br/>[app.py]"]
  node_professor_management["Professor management<br/>[app.py]"]
  node_room_management["Room management<br/>[app.py]"]
end

subgraph group_persistence["Persistence"]
  node_postgres[("PostgreSQL database<br/>[schema.sql]")]
end

node_user(("Faculty users"))

node_user -->|"uses"| node_streamlit_app
node_streamlit_app -->|"authenticates through"| node_authentication
node_authentication -->|"grants role access"| node_dashboard
node_authentication -->|"grants role access"| node_schedule_generator
node_authentication -->|"grants role access"| node_schedule_validation
node_authentication -->|"grants role access"| node_strategic_view
node_schedule_generator -->|"reports conflicts"| node_conflict_reporting
node_schedule_generator -->|"produces schedule for"| node_schedule_validation
node_schedule_validation -->|"releases schedule to"| node_personal_schedules
node_user -->|"consults"| node_personal_schedules
node_streamlit_app -->|"connects to"| node_postgres
node_streamlit_app -->|"presents statistics"| node_dashboard
node_streamlit_app -->|"presents indicators"| node_strategic_view
node_streamlit_app -->|"manages data"| node_department_management
node_streamlit_app -->|"manages data"| node_specialty_management
node_streamlit_app -->|"manages data"| node_training_management
node_streamlit_app -->|"manages data"| node_module_management
node_streamlit_app -->|"manages data"| node_student_management
node_streamlit_app -->|"manages data"| node_professor_management
node_streamlit_app -->|"manages data"| node_room_management

click node_streamlit_app "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_authentication "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_dashboard "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_strategic_view "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_schedule_generator "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_conflict_reporting "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_schedule_validation "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_personal_schedules "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_department_management "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_specialty_management "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_training_management "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_module_management "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_student_management "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_professor_management "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_room_management "https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py"
click node_postgres "https://github.com/siamsell/exam_scheduler/blob/main/backend/database/schema.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_streamlit_app,node_authentication,node_dashboard,node_strategic_view,node_user toneBlue
class node_schedule_generator,node_conflict_reporting,node_schedule_validation,node_personal_schedules toneAmber
class node_department_management,node_specialty_management,node_training_management,node_module_management,node_student_management,node_professor_management,node_room_management toneMint
class node_postgres toneRose
```

## Components

### Access and oversight

- [Streamlit application](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Authentication and roles](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Statistics dashboard](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Strategic view](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`

### Exam planning

- [Schedule generator](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Conflict reporting](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Schedule validation](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Personal schedules](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`

### Academic operations

- [Department management](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Specialty management](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Training management](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Module management](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Student management](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Professor management](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`
- [Room management](https://github.com/siamsell/exam_scheduler/blob/main/frontend/app.py): `frontend/app.py`

### Persistence

- [PostgreSQL database](https://github.com/siamsell/exam_scheduler/blob/main/backend/database/schema.sql): `backend/database/schema.sql`

### Other components

- **Faculty users**

## Connections

- Faculty users → Streamlit application: uses (evidence: `README.md`)
- Streamlit application → Authentication and roles: authenticates through (evidence: `README.md`)
- Authentication and roles → Statistics dashboard: grants role access (evidence: `README.md`)
- Authentication and roles → Schedule generator: grants role access (evidence: `README.md`)
- Authentication and roles → Schedule validation: grants role access (evidence: `README.md`)
- Authentication and roles → Strategic view: grants role access (evidence: `README.md`)
- Schedule generator → Conflict reporting: reports conflicts (evidence: `README.md`)
- Schedule generator → Schedule validation: produces schedule for (evidence: `README.md`)
- Schedule validation → Personal schedules: releases schedule to (evidence: `README.md`)
- Faculty users → Personal schedules: consults (evidence: `README.md`)
- Streamlit application → PostgreSQL database: connects to (evidence: `README.md`)
- Streamlit application → Statistics dashboard: presents statistics (evidence: `README.md`)
- Streamlit application → Strategic view: presents indicators (evidence: `README.md`)
- Streamlit application → Department management: manages data (evidence: `README.md`)
- Streamlit application → Specialty management: manages data (evidence: `README.md`)
- Streamlit application → Training management: manages data (evidence: `README.md`)
- Streamlit application → Module management: manages data (evidence: `README.md`)
- Streamlit application → Student management: manages data (evidence: `README.md`)
- Streamlit application → Professor management: manages data (evidence: `README.md`)
- Streamlit application → Room management: manages data (evidence: `README.md`)
