# vedangdhuri/opti-time-69 architecture

> Architecture diagram of the GitHub repository vedangdhuri/opti-time-69, 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/vedangdhuri/opti-time-69
- Repository: https://github.com/vedangdhuri/opti-time-69

## Overview

Opti-Time is a Django application for collecting academic scheduling inputs, generating class timetables, and reviewing schedules and workload. The repository contains three timetable implementations (the original class-based app, a v2 variant, and a shared timetable app), plus user accounts and institutional dashboards. The main generation workflow is visible in the excerpts; several other README-listed features are represented at their documented app level. Unsampled implementation details and integrations are not inferred.

Main entry points: [`myapp/views.py`](https://github.com/vedangdhuri/opti-time-69/blob/master/myapp/views.py) (Accounts And Dashboard), [`class_timetable/views.py`](https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable/views.py) (Schedule Views), [`class_timetable_v2/views.py`](https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable_v2/views.py) (V2 Schedule Views), [`timetable/views.py`](https://github.com/vedangdhuri/opti-time-69/blob/master/timetable/views.py) (Timetable Views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_class_schedule["Class Scheduling"]
  node_class_inputs["Class Inputs<br/>[forms.py]"]
  node_class_data[("Class Schedule Data<br/>[models.py]")]
  node_class_generation["Class Generator<br/>[utils.py]"]
  node_class_views["Schedule Views<br/>[views.py]"]
  node_v2_inputs["V2 Class Inputs<br/>[forms.py]"]
  node_v2_data[("V2 Schedule Data<br/>[models.py]")]
  node_v2_generation["V2 Generator<br/>[utils.py]"]
  node_v2_views["V2 Schedule Views<br/>[views.py]"]
end

subgraph group_shared_schedule["Shared Timetable"]
  node_shared_data[("Timetable Records<br/>[models.py]")]
  node_shared_generator["Timetable Generator<br/>[services.py]"]
  node_shared_views["Timetable Views<br/>[views.py]"]
end

subgraph group_accounts["Accounts And Overview"]
  node_accounts_data[("User Accounts<br/>[models.py]")]
  node_account_forms["Account Forms<br/>[forms.py]"]
  node_account_views["Accounts And Dashboard<br/>[views.py]"]
end

node_scheduler(("Scheduling User"))

node_scheduler -->|"requests schedules"| node_class_views
node_class_views -->|"uses forms"| node_class_inputs
node_class_views -->|"generates schedules"| node_class_generation
node_class_generation -->|"reads and writes"| node_class_data
node_class_inputs -->|"validates inputs"| node_class_data
node_scheduler -.->|"requests schedules"| node_v2_views
node_v2_views -->|"uses forms"| node_v2_inputs
node_v2_views -->|"generates schedules"| node_v2_generation
node_v2_generation -.->|"reads and writes"| node_v2_data
node_v2_inputs -->|"validates inputs"| node_v2_data
node_scheduler -->|"requests timetable"| node_shared_views
node_shared_views -->|"generates timetable"| node_shared_generator
node_shared_generator -->|"reads and writes"| node_shared_data
node_shared_views -->|"reads entries"| node_shared_data
node_scheduler -->|"uses account features"| node_account_views
node_account_views -->|"uses forms"| node_account_forms
node_account_views -->|"reads and updates"| node_accounts_data
node_account_views -->|"reads dashboard totals"| node_shared_data

click node_class_inputs "https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable/forms.py"
click node_class_data "https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable/models.py"
click node_class_generation "https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable/utils.py"
click node_class_views "https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable/views.py"
click node_v2_inputs "https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable_v2/forms.py"
click node_v2_data "https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable_v2/models.py"
click node_v2_generation "https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable_v2/utils.py"
click node_v2_views "https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable_v2/views.py"
click node_shared_data "https://github.com/vedangdhuri/opti-time-69/blob/master/timetable/models.py"
click node_shared_generator "https://github.com/vedangdhuri/opti-time-69/blob/master/timetable/services.py"
click node_shared_views "https://github.com/vedangdhuri/opti-time-69/blob/master/timetable/views.py"
click node_accounts_data "https://github.com/vedangdhuri/opti-time-69/blob/master/myapp/models.py"
click node_account_forms "https://github.com/vedangdhuri/opti-time-69/blob/master/myapp/forms.py"
click node_account_views "https://github.com/vedangdhuri/opti-time-69/blob/master/myapp/views.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_class_inputs,node_class_data,node_class_generation,node_class_views,node_v2_inputs,node_v2_data,node_v2_generation,node_v2_views,node_scheduler toneBlue
class node_shared_data,node_shared_generator,node_shared_views toneAmber
class node_accounts_data,node_account_forms,node_account_views toneMint
```

## Components

### Class Scheduling

- [Class Inputs](https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable/forms.py): `class_timetable/forms.py`
- [Class Schedule Data](https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable/models.py): `class_timetable/models.py`
- [Class Generator](https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable/utils.py): `class_timetable/utils.py`
- [Schedule Views](https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable/views.py): `class_timetable/views.py`
- [V2 Class Inputs](https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable_v2/forms.py): `class_timetable_v2/forms.py`
- [V2 Schedule Data](https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable_v2/models.py): `class_timetable_v2/models.py`
- [V2 Generator](https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable_v2/utils.py): `class_timetable_v2/utils.py`
- [V2 Schedule Views](https://github.com/vedangdhuri/opti-time-69/blob/master/class_timetable_v2/views.py): `class_timetable_v2/views.py`

### Shared Timetable

- [Timetable Records](https://github.com/vedangdhuri/opti-time-69/blob/master/timetable/models.py): `timetable/models.py`
- [Timetable Generator](https://github.com/vedangdhuri/opti-time-69/blob/master/timetable/services.py): `timetable/services.py`
- [Timetable Views](https://github.com/vedangdhuri/opti-time-69/blob/master/timetable/views.py): `timetable/views.py`

### Accounts And Overview

- [User Accounts](https://github.com/vedangdhuri/opti-time-69/blob/master/myapp/models.py): `myapp/models.py`
- [Account Forms](https://github.com/vedangdhuri/opti-time-69/blob/master/myapp/forms.py): `myapp/forms.py`
- [Accounts And Dashboard](https://github.com/vedangdhuri/opti-time-69/blob/master/myapp/views.py): `myapp/views.py`

### Other components

- **Scheduling User**

## Connections

- Scheduling User → Schedule Views: requests schedules
- Schedule Views → Class Inputs: uses forms (evidence: `class_timetable/views.py`)
- Schedule Views → Class Generator: generates schedules (evidence: `class_timetable/views.py`)
- Class Generator → Class Schedule Data: reads and writes (evidence: `class_timetable/utils.py`)
- Class Inputs → Class Schedule Data: validates inputs (evidence: `class_timetable/forms.py`)
- Scheduling User → V2 Schedule Views: requests schedules
- V2 Schedule Views → V2 Class Inputs: uses forms (evidence: `class_timetable_v2/views.py`)
- V2 Schedule Views → V2 Generator: generates schedules (evidence: `class_timetable_v2/views.py`)
- V2 Generator → V2 Schedule Data: reads and writes (evidence: `class_timetable_v2/utils.py`)
- V2 Class Inputs → V2 Schedule Data: validates inputs (evidence: `class_timetable_v2/forms.py`)
- Scheduling User → Timetable Views: requests timetable
- Timetable Views → Timetable Generator: generates timetable (evidence: `timetable/views.py`)
- Timetable Generator → Timetable Records: reads and writes (evidence: `timetable/services.py`)
- Timetable Views → Timetable Records: reads entries (evidence: `timetable/views.py`)
- Scheduling User → Accounts And Dashboard: uses account features
- Accounts And Dashboard → Account Forms: uses forms (evidence: `myapp/views.py`)
- Accounts And Dashboard → User Accounts: reads and updates (evidence: `myapp/views.py`)
- Accounts And Dashboard → Timetable Records: reads dashboard totals (evidence: `myapp/views.py`)
