# hemanth2607-cyber/school_timetable_management architecture

> Architecture diagram of the GitHub repository hemanth2607-cyber/school_timetable_management, 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/hemanth2607-cyber/school_timetable_management
- Repository: https://github.com/hemanth2607-cyber/school_timetable_management

## Overview

This is a Flask school-management application. Users authenticate and work through role-scoped school and user administration, while administrators configure school data and access timetable, attendance, and substitution features. The sampled application code configures SQLite and queries its models; the scheduler module contains timetable-generation and teacher-substitution logic. The README is empty, and excerpts do not show template rendering or the scheduler’s invocation, so those connections are not asserted.

Main entry points: [`app.py`](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py) (Flask routes), [`scheduler_ai.py`](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/scheduler_ai.py) (Timetable generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_web_app["Flask routes<br/>[app.py]"]
  node_authentication["Authentication<br/>[app.py]"]
  node_dashboard["Role dashboard<br/>[app.py]"]
end

subgraph group_school_ops["School operations"]
  node_school_admin["School management<br/>[app.py]"]
  node_user_admin["User management<br/>[app.py]"]
  node_school_config["School configuration<br/>[app.py]"]
  node_attendance_api["Attendance API<br/>[app.py]"]
  node_school_db[("School database<br/>[app.py]")]
end

subgraph group_scheduling["Scheduling"]
  node_timetable_api["Timetable API<br/>[app.py]"]
  node_substitution_api["Substitution API<br/>[app.py]"]
  node_timetable_generator["Timetable generator<br/>[scheduler_ai.py]"]
  node_substitution_engine["Substitution engine<br/>[scheduler_ai.py]"]
end

node_user(("School staff"))

node_user -->|"uses"| node_web_app
node_web_app -->|"routes"| node_authentication
node_web_app -->|"routes"| node_dashboard
node_web_app -->|"routes"| node_school_admin
node_web_app -->|"routes"| node_user_admin
node_web_app -->|"routes"| node_school_config
node_web_app -->|"routes"| node_timetable_api
node_web_app -->|"routes"| node_attendance_api
node_web_app -->|"routes"| node_substitution_api
node_web_app -->|"queries"| node_school_db
node_web_app -.->|"imports"| node_timetable_generator

click node_web_app "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py"
click node_authentication "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py"
click node_dashboard "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py"
click node_school_admin "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py"
click node_user_admin "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py"
click node_school_config "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py"
click node_timetable_api "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py"
click node_attendance_api "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py"
click node_substitution_api "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py"
click node_school_db "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py"
click node_timetable_generator "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/scheduler_ai.py"
click node_substitution_engine "https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/scheduler_ai.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_web_app,node_authentication,node_dashboard toneBlue
class node_school_admin,node_user_admin,node_school_config,node_attendance_api,node_school_db toneAmber
class node_timetable_api,node_substitution_api,node_timetable_generator,node_substitution_engine toneMint
class node_user toneIndigo
```

## Components

### Web application

- [Flask routes](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py): `app.py`
- [Authentication](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py): `app.py`
- [Role dashboard](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py): `app.py`

### School operations

- [School management](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py): `app.py`
- [User management](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py): `app.py`
- [School configuration](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py): `app.py`
- [Attendance API](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py): `app.py`
- [School database](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py): `app.py`

### Scheduling

- [Timetable API](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py): `app.py`
- [Substitution API](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/app.py): `app.py`
- [Timetable generator](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/scheduler_ai.py): `scheduler_ai.py`
- [Substitution engine](https://github.com/hemanth2607-cyber/school_timetable_management/blob/main/scheduler_ai.py): `scheduler_ai.py`

### Other components

- **School staff**

## Connections

- School staff → Flask routes: uses
- Flask routes → Authentication: routes (evidence: `app.py`)
- Flask routes → Role dashboard: routes (evidence: `app.py`)
- Flask routes → School management: routes (evidence: `app.py`)
- Flask routes → User management: routes (evidence: `app.py`)
- Flask routes → School configuration: routes (evidence: `app.py`)
- Flask routes → Timetable API: routes (evidence: `app.py`)
- Flask routes → Attendance API: routes (evidence: `app.py`)
- Flask routes → Substitution API: routes (evidence: `app.py`)
- Flask routes → School database: queries (evidence: `app.py`)
- Flask routes → Timetable generator: imports (evidence: `app.py`)
