# notsmx/clas-scheduling-app architecture

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

- Interactive diagram: https://gitdiagram.com/notsmx/clas-scheduling-app
- Repository: https://github.com/notsmx/clas-scheduling-app

## Overview

CLAS is a Flask app for faculty and administrators to manage symposium events and sessions. Faculty authenticate, create or submit an event, then use scheduling options or submit it for scheduling; administrators can manage sessions and rooms, while visitors view the published schedule. The app also supports profiles, settings, and notifications. The graph reflects documented features and sampled imports/calls; unsampled route details are not inferred.

Main entry points: [`website/__init__.py`](https://github.com/notsmx/clas-scheduling-app/blob/main/website/__init__.py) (Flask app setup), [`website/models.py`](https://github.com/notsmx/clas-scheduling-app/blob/main/website/models.py) (Domain records), [`website/templates`](https://github.com/notsmx/clas-scheduling-app/tree/main/website/templates) (Jinja templates), [`website/auth.py`](https://github.com/notsmx/clas-scheduling-app/blob/main/website/auth.py) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application setup"]
  node_flask_app["Flask app setup<br/>[__init__.py]"]
  node_domain_data[("Domain records<br/>[models.py]")]
  node_templates["Jinja templates"]
end

subgraph group_identity["Identity and profiles"]
  node_google_oauth["Google OAuth client<br/>[oauth_client.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_profile["Profile and settings<br/>[views.py]"]
end

subgraph group_events["Events and scheduling"]
  node_event_routes["Event lifecycle<br/>[events.py]"]
  node_scheduler["Scheduling engine<br/>[scheduler.py]"]
  node_schedule_views["Home and schedule views<br/>[views.py]"]
end

subgraph group_operations["Administration and notices"]
  node_admin["Session administration<br/>[admin.py]"]
  node_notifications["Notifications<br/>[notifications.py]"]
end

node_faculty(("Faculty / admin"))
node_visitor(("Schedule visitor"))
node_google["Google identity provider"]

node_faculty -.->|"uses"| node_flask_app
node_visitor -.->|"views schedule"| node_flask_app
node_flask_app -->|"registers routes"| node_auth
node_flask_app -->|"registers routes"| node_event_routes
node_flask_app -->|"registers routes"| node_admin
node_flask_app -->|"registers routes"| node_notifications
node_flask_app -->|"initializes database"| node_domain_data
node_flask_app -->|"initializes OAuth"| node_google_oauth
node_auth -->|"requests authorization"| node_google_oauth
node_google_oauth -->|"registers client"| node_google
node_auth -->|"reads and writes users"| node_domain_data
node_auth -->|"renders forms"| node_templates
node_profile -->|"reads and updates profile"| node_domain_data
node_profile -->|"renders profile pages"| node_templates
node_event_routes -->|"reads and writes events"| node_domain_data
node_event_routes -->|"requests scheduling"| node_scheduler
node_event_routes -->|"renders event pages"| node_templates
node_scheduler -->|"queries and saves sessions"| node_domain_data
node_schedule_views -->|"queries sessions"| node_domain_data
node_schedule_views -->|"renders schedule"| node_templates
node_admin -->|"manages sessions"| node_domain_data
node_admin -->|"checks conflicts"| node_scheduler
node_admin -->|"renders admin pages"| node_templates
node_notifications -->|"reads and writes notices"| node_domain_data
node_notifications -->|"renders notice pages"| node_templates

click node_flask_app "https://github.com/notsmx/clas-scheduling-app/blob/main/website/__init__.py"
click node_google_oauth "https://github.com/notsmx/clas-scheduling-app/blob/main/website/oauth_client.py"
click node_auth "https://github.com/notsmx/clas-scheduling-app/blob/main/website/auth.py"
click node_profile "https://github.com/notsmx/clas-scheduling-app/blob/main/website/views.py"
click node_event_routes "https://github.com/notsmx/clas-scheduling-app/blob/main/website/events.py"
click node_scheduler "https://github.com/notsmx/clas-scheduling-app/blob/main/website/scheduler.py"
click node_schedule_views "https://github.com/notsmx/clas-scheduling-app/blob/main/website/views.py"
click node_admin "https://github.com/notsmx/clas-scheduling-app/blob/main/website/admin.py"
click node_notifications "https://github.com/notsmx/clas-scheduling-app/blob/main/website/notifications.py"
click node_domain_data "https://github.com/notsmx/clas-scheduling-app/blob/main/website/models.py"
click node_templates "https://github.com/notsmx/clas-scheduling-app/tree/main/website/templates"

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_flask_app,node_domain_data,node_templates toneBlue
class node_google_oauth,node_auth,node_profile toneAmber
class node_event_routes,node_scheduler,node_schedule_views toneMint
class node_admin,node_notifications toneRose
class node_faculty,node_visitor,node_google toneIndigo
```

## Components

### Application setup

- [Flask app setup](https://github.com/notsmx/clas-scheduling-app/blob/main/website/__init__.py): `website/__init__.py`
- [Domain records](https://github.com/notsmx/clas-scheduling-app/blob/main/website/models.py): `website/models.py`
- [Jinja templates](https://github.com/notsmx/clas-scheduling-app/tree/main/website/templates): `website/templates`

### Identity and profiles

- [Google OAuth client](https://github.com/notsmx/clas-scheduling-app/blob/main/website/oauth_client.py): `website/oauth_client.py`
- [Authentication](https://github.com/notsmx/clas-scheduling-app/blob/main/website/auth.py): `website/auth.py`
- [Profile and settings](https://github.com/notsmx/clas-scheduling-app/blob/main/website/views.py): `website/views.py`

### Events and scheduling

- [Event lifecycle](https://github.com/notsmx/clas-scheduling-app/blob/main/website/events.py): `website/events.py`
- [Scheduling engine](https://github.com/notsmx/clas-scheduling-app/blob/main/website/scheduler.py): `website/scheduler.py`
- [Home and schedule views](https://github.com/notsmx/clas-scheduling-app/blob/main/website/views.py): `website/views.py`

### Administration and notices

- [Session administration](https://github.com/notsmx/clas-scheduling-app/blob/main/website/admin.py): `website/admin.py`
- [Notifications](https://github.com/notsmx/clas-scheduling-app/blob/main/website/notifications.py): `website/notifications.py`

### Other components

- **Faculty / admin**
- **Schedule visitor**
- **Google identity provider**

## Connections

- Faculty / admin → Flask app setup: uses (evidence: `README.md`)
- Schedule visitor → Flask app setup: views schedule (evidence: `README.md`)
- Flask app setup → Authentication: registers routes (evidence: `website/__init__.py`)
- Flask app setup → Event lifecycle: registers routes (evidence: `website/__init__.py`)
- Flask app setup → Session administration: registers routes (evidence: `website/__init__.py`)
- Flask app setup → Notifications: registers routes (evidence: `website/__init__.py`)
- Flask app setup → Domain records: initializes database (evidence: `website/__init__.py`)
- Flask app setup → Google OAuth client: initializes OAuth (evidence: `website/__init__.py`)
- Authentication → Google OAuth client: requests authorization (evidence: `website/auth.py`)
- Google OAuth client → Google identity provider: registers client (evidence: `website/oauth_client.py`)
- Authentication → Domain records: reads and writes users (evidence: `website/auth.py`)
- Authentication → Jinja templates: renders forms (evidence: `website/auth.py`)
- Profile and settings → Domain records: reads and updates profile (evidence: `website/views.py`)
- Profile and settings → Jinja templates: renders profile pages (evidence: `website/views.py`)
- Event lifecycle → Domain records: reads and writes events (evidence: `website/events.py`)
- Event lifecycle → Scheduling engine: requests scheduling (evidence: `website/events.py`)
- Event lifecycle → Jinja templates: renders event pages (evidence: `website/events.py`)
- Scheduling engine → Domain records: queries and saves sessions (evidence: `website/scheduler.py`)
- Home and schedule views → Domain records: queries sessions (evidence: `website/views.py`)
- Home and schedule views → Jinja templates: renders schedule (evidence: `website/views.py`)
- Session administration → Domain records: manages sessions (evidence: `website/admin.py`)
- Session administration → Scheduling engine: checks conflicts (evidence: `website/admin.py`)
- Session administration → Jinja templates: renders admin pages (evidence: `website/admin.py`)
- Notifications → Domain records: reads and writes notices (evidence: `website/notifications.py`)
- Notifications → Jinja templates: renders notice pages (evidence: `website/notifications.py`)
