# anushkabadakh/timetable-management-system architecture

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

## Overview

This is the FastAPI backend for a college timetable management system. Its visible workflow is authenticated administration of academic resources, creation of a timetable, and management of its scheduled slots; dashboard APIs provide a reporting branch. The source also contains token authentication, database models, and slot-validation logic. The README describes conflict suggestions, alerts, PDF downloads, and utilization reports, but their implementations are not evident in the supplied excerpts, so those capabilities are represented only where the tree or documentation supports them. Edges are limited to wiring or dependencies shown in the excerpts and source index.

Main entry points: [`backend/app/main.py`](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/main.py) (FastAPI app), [`backend/app/database.py`](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/database.py) (Database session), [`backend/app/models`](https://github.com/anushkabadakh/timetable-management-system/tree/main/backend/app/models) (Academic models), [`backend/app/routers/timetable.py`](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/timetable.py) (Timetable routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_app["FastAPI app<br/>[main.py]"]
  node_auth["Authentication routes<br/>[auth.py]"]
  node_usercrud["User credentials<br/>[user.py]"]
  node_jwt["Token functions<br/>[jwt.py]"]
  node_deps["Current-user auth<br/>[deps.py]"]
  node_middleware["Timing middleware<br/>[middleware.py]"]
end

subgraph group_academic["Academic resources"]
  node_college["College routes<br/>[college.py]"]
  node_department["Department routes<br/>[department.py]"]
  node_faculty["Faculty routes<br/>[faculty.py]"]
  node_classroom["Classroom routes<br/>[classroom.py]"]
  node_subject["Subject routes<br/>[subject.py]"]
  node_resource_models[("Academic models")]
end

subgraph group_schedule["Timetable scheduling"]
  node_timetable_api["Timetable routes<br/>[timetable.py]"]
  node_slot_api["Slot routes<br/>[timetable_slots.py]"]
  node_slot_validation["Slot validation<br/>[slot_validation.py]"]
  node_schedule_models[("Schedule models<br/>[timetable.py]")]
  node_slot_model[("Timetable slot model<br/>[timetable_slots.py]")]
end

subgraph group_persistence["Persistence and reporting"]
  node_dashboard["Dashboard APIs<br/>[dashboard.py]"]
  node_db[("Database session<br/>[database.py]")]
  node_config["Application settings<br/>[config.py]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"registers routes"| node_auth
node_app -->|"registers routes"| node_college
node_app -->|"registers routes"| node_department
node_app -->|"registers routes"| node_faculty
node_app -->|"registers routes"| node_classroom
node_app -->|"registers routes"| node_subject
node_app -->|"registers routes"| node_timetable_api
node_app -->|"registers routes"| node_slot_api
node_app -->|"registers routes"| node_dashboard
node_app -->|"adds middleware"| node_middleware
node_auth -->|"gets session"| node_db
node_auth -->|"checks credentials"| node_usercrud
node_auth -->|"creates token"| node_jwt
node_deps -->|"decodes token"| node_jwt
node_deps -->|"loads user"| node_usercrud
node_deps -->|"gets session"| node_db
node_college -->|"queries data"| node_db
node_department -->|"queries data"| node_db
node_faculty -->|"queries data"| node_db
node_classroom -->|"queries data"| node_db
node_subject -->|"queries data"| node_db
node_college -->|"uses models"| node_resource_models
node_department -->|"uses models"| node_resource_models
node_faculty -->|"uses models"| node_resource_models
node_classroom -->|"uses models"| node_resource_models
node_subject -->|"uses models"| node_resource_models
node_timetable_api -->|"queries data"| node_db
node_timetable_api -->|"requires user"| node_deps
node_timetable_api -->|"reads and writes"| node_schedule_models
node_timetable_api -->|"validates references"| node_resource_models
node_slot_api -->|"queries data"| node_db
node_slot_api -->|"requires user"| node_deps
node_slot_api -->|"reads and writes"| node_slot_model
node_slot_api -->|"validates slots"| node_slot_validation
node_slot_model -->|"references timetable"| node_schedule_models
node_schedule_models -->|"owns slots"| node_slot_model
node_dashboard -->|"queries data"| node_db
node_db -->|"uses settings"| node_config

click node_app "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/main.py"
click node_auth "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/auth.py"
click node_usercrud "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/crud/user.py"
click node_jwt "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/crud/jwt.py"
click node_deps "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/crud/deps.py"
click node_middleware "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/middleware.py"
click node_college "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/college.py"
click node_department "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/department.py"
click node_faculty "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/faculty.py"
click node_classroom "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/classroom.py"
click node_subject "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/subject.py"
click node_resource_models "https://github.com/anushkabadakh/timetable-management-system/tree/main/backend/app/models"
click node_timetable_api "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/timetable.py"
click node_slot_api "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/timetable_slots.py"
click node_slot_validation "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/utils/slot_validation.py"
click node_schedule_models "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/models/timetable.py"
click node_slot_model "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/models/timetable_slots.py"
click node_dashboard "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/dashboard.py"
click node_db "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/database.py"
click node_config "https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/config.py"

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_auth,node_usercrud,node_jwt,node_deps,node_middleware,node_client toneBlue
class node_college,node_department,node_faculty,node_classroom,node_subject,node_resource_models toneAmber
class node_timetable_api,node_slot_api,node_slot_validation,node_schedule_models,node_slot_model toneMint
class node_dashboard,node_db,node_config toneRose
```

## Components

### API and access

- [FastAPI app](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication routes](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [User credentials](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/crud/user.py): `backend/app/crud/user.py`
- [Token functions](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/crud/jwt.py): `backend/app/crud/jwt.py`
- [Current-user auth](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/crud/deps.py): `backend/app/crud/deps.py`
- [Timing middleware](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/middleware.py): `backend/app/middleware.py`

### Academic resources

- [College routes](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/college.py): `backend/app/routers/college.py`
- [Department routes](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/department.py): `backend/app/routers/department.py`
- [Faculty routes](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/faculty.py): `backend/app/routers/faculty.py`
- [Classroom routes](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/classroom.py): `backend/app/routers/classroom.py`
- [Subject routes](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/subject.py): `backend/app/routers/subject.py`
- [Academic models](https://github.com/anushkabadakh/timetable-management-system/tree/main/backend/app/models): `backend/app/models`

### Timetable scheduling

- [Timetable routes](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/timetable.py): `backend/app/routers/timetable.py`
- [Slot routes](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/timetable_slots.py): `backend/app/routers/timetable_slots.py`
- [Slot validation](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/utils/slot_validation.py): `backend/app/utils/slot_validation.py`
- [Schedule models](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/models/timetable.py): `backend/app/models/timetable.py`
- [Timetable slot model](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/models/timetable_slots.py): `backend/app/models/timetable_slots.py`

### Persistence and reporting

- [Dashboard APIs](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/routers/dashboard.py): `backend/app/routers/dashboard.py`
- [Database session](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/database.py): `backend/app/database.py`
- [Application settings](https://github.com/anushkabadakh/timetable-management-system/blob/main/backend/app/config.py): `backend/app/config.py`

### Other components

- **API client**

## Connections

- API client → FastAPI app: sends requests
- FastAPI app → Authentication routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → College routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Department routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Faculty routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Classroom routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Subject routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Timetable routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Slot routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Dashboard APIs: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Timing middleware: adds middleware (evidence: `backend/app/main.py`)
- Authentication routes → Database session: gets session (evidence: `backend/app/routers/auth.py`)
- Authentication routes → User credentials: checks credentials (evidence: `backend/app/routers/auth.py`)
- Authentication routes → Token functions: creates token (evidence: `backend/app/routers/auth.py`)
- Current-user auth → Token functions: decodes token (evidence: `backend/app/crud/deps.py`)
- Current-user auth → User credentials: loads user (evidence: `backend/app/crud/deps.py`)
- Current-user auth → Database session: gets session (evidence: `backend/app/crud/deps.py`)
- College routes → Database session: queries data (evidence: `backend/app/routers/college.py`)
- Department routes → Database session: queries data (evidence: `backend/app/routers/department.py`)
- Faculty routes → Database session: queries data (evidence: `backend/app/routers/faculty.py`)
- Classroom routes → Database session: queries data (evidence: `backend/app/routers/classroom.py`)
- Subject routes → Database session: queries data (evidence: `backend/app/routers/subject.py`)
- College routes → Academic models: uses models (evidence: `backend/app/routers/college.py`)
- Department routes → Academic models: uses models (evidence: `backend/app/routers/department.py`)
- Faculty routes → Academic models: uses models (evidence: `backend/app/routers/faculty.py`)
- Classroom routes → Academic models: uses models (evidence: `backend/app/routers/classroom.py`)
- Subject routes → Academic models: uses models (evidence: `backend/app/routers/subject.py`)
- Timetable routes → Database session: queries data (evidence: `backend/app/routers/timetable.py`)
- Timetable routes → Current-user auth: requires user (evidence: `backend/app/routers/timetable.py`)
- Timetable routes → Schedule models: reads and writes (evidence: `backend/app/routers/timetable.py`)
- Timetable routes → Academic models: validates references (evidence: `backend/app/routers/timetable.py`)
- Slot routes → Database session: queries data (evidence: `backend/app/routers/timetable_slots.py`)
- Slot routes → Current-user auth: requires user (evidence: `backend/app/routers/timetable_slots.py`)
- Slot routes → Timetable slot model: reads and writes (evidence: `backend/app/routers/timetable_slots.py`)
- Slot routes → Slot validation: validates slots (evidence: `backend/app/routers/timetable_slots.py`)
- Timetable slot model → Schedule models: references timetable (evidence: `backend/app/models/timetable_slots.py`)
- Schedule models → Timetable slot model: owns slots (evidence: `backend/app/models/timetable.py`)
- Dashboard APIs → Database session: queries data (evidence: `backend/app/routers/dashboard.py`)
- Database session → Application settings: uses settings (evidence: `backend/app/database.py`)
