# shreyas-wagire/atlas---ttg architecture

> Architecture diagram of the GitHub repository shreyas-wagire/atlas---ttg, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shreyas-wagire/atlas---ttg
- Repository: https://github.com/shreyas-wagire/atlas---ttg

## Overview

ATLAS is a browser-based academic timetable studio. Users configure a semester with course loads, fixed/global constraints, resources, synchronization rules, and faculty availability; generation schedules sessions and produces validation, conflict, workload, resource, batch, faculty, and location views for inspection and export. The graph follows the documented configuration-to-generation workflow and indexed imports. Several algorithm and UI modules are unsampled, so their internal relationships are shown only where the excerpts, index, or README support them.

Main entry points: [`app/components/FileUpload.jsx`](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/FileUpload.jsx) (Studio workflow), [`app/utils/generateSmartTimetable.js`](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/generateSmartTimetable.js) (Generation orchestrator), [`app/utils/allocateSessions.js`](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/allocateSessions.js) (Session allocator), [`app/page.tsx`](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/page.tsx) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_studio["Timetable Studio"]
  node_page["App entry<br/>[page.tsx]"]
  node_studio_ui["Studio workflow<br/>[FileUpload.jsx]"]
end

subgraph group_inputs["Schedule Inputs"]
  node_courses["Course load"]
  node_global_constraints["Global constraints"]
  node_external_courses["External courses"]
  node_sync_rules["Sync rules"]
  node_faculty_constraints["Faculty availability"]
  node_load_parser["Load parser<br/>[parseLoadSheet.js]"]
  node_resource_parser["Resource parser"]
  node_faculty_parser["Availability parser"]
end

subgraph group_engine["Scheduling Engine"]
  node_generator["Generation orchestrator"]
  node_session_pool["Session pool"]
  node_allocator["Session allocator"]
  node_occupancy["College occupancy"]
  node_practical_packing["Practical packing"]
  node_daps["Priority scheduling<br/>[daps.js]"]
  node_cascade["Cascade repair<br/>[casc.js]"]
  node_optimizer["Timetable optimizer"]
end

subgraph group_outputs["Reports and Views"]
  node_validation["Validation and conflicts"]
  node_division_view["Division timetable<br/>[TimetableGrid.jsx]"]
  node_batch_view["Batch timetable"]
  node_faculty_view["Faculty timetable"]
  node_location_view["Room occupancy"]
  node_export["Workbook export<br/>[exportTimetable.js]"]
end

subgraph group_state["Semester State"]
  node_semester_ui["Semester dashboard"]
  node_semester_store[("Semester storage<br/>[semesterStore.js]")]
end

node_user(("Department user"))

node_user -->|"opens"| node_page
node_page -->|"renders"| node_studio_ui
node_studio_ui -->|"parses load"| node_load_parser
node_studio_ui -->|"parses resources"| node_resource_parser
node_studio_ui -->|"parses availability"| node_faculty_parser
node_studio_ui -->|"requests generation"| node_generator
node_studio_ui -->|"configures"| node_courses
node_studio_ui -->|"configures"| node_global_constraints
node_studio_ui -->|"configures"| node_external_courses
node_studio_ui -->|"configures"| node_sync_rules
node_studio_ui -->|"configures"| node_faculty_constraints
node_generator -->|"builds sessions"| node_session_pool
node_generator -->|"allocates sessions"| node_allocator
node_allocator -->|"checks occupancy"| node_occupancy
node_allocator -->|"packs practicals"| node_practical_packing
node_generator -->|"prioritizes sessions"| node_daps
node_generator -->|"repairs placement"| node_cascade
node_generator -->|"optimizes schedule"| node_optimizer
node_occupancy -->|"checks availability"| node_faculty_parser
node_generator -->|"produces diagnostics"| node_validation
node_generator -->|"generates view data"| node_division_view
node_generator -->|"generates view data"| node_batch_view
node_generator -->|"generates view data"| node_faculty_view
node_generator -->|"generates view data"| node_location_view
node_user -.->|"exports workbook"| node_export
node_semester_ui -->|"loads and saves"| node_semester_store
node_studio_ui -->|"shows semesters"| node_semester_ui
node_studio_ui -->|"saves results"| node_semester_store

click node_page "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/page.tsx"
click node_studio_ui "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/FileUpload.jsx"
click node_courses "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/YearWiseCourses.jsx"
click node_global_constraints "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/GlobalConstraints.jsx"
click node_external_courses "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/ExternalCourses.jsx"
click node_sync_rules "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/SyncRuleBuilder.jsx"
click node_faculty_constraints "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/FacultyConstraints.jsx"
click node_load_parser "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/parseLoadSheet.js"
click node_resource_parser "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/parseResourcesSheet.js"
click node_faculty_parser "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/parseFacultyConstraints.js"
click node_generator "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/generateSmartTimetable.js"
click node_session_pool "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/generateSessionPool.js"
click node_allocator "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/allocateSessions.js"
click node_occupancy "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/collegeOccupancy.js"
click node_practical_packing "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/practicalPacking.js"
click node_daps "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/daps.js"
click node_cascade "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/casc.js"
click node_optimizer "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/optimizeTimetable.js"
click node_validation "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/GenerationReport.jsx"
click node_division_view "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/TimetableGrid.jsx"
click node_batch_view "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/BatchTimetableGrid.jsx"
click node_faculty_view "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/FacultyTimetableGrid.jsx"
click node_location_view "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/LocationTimetableGrid.jsx"
click node_export "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/exportTimetable.js"
click node_semester_ui "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/SemesterDashboard.jsx"
click node_semester_store "https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/semesterStore.js"

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_page,node_studio_ui,node_user toneBlue
class node_courses,node_global_constraints,node_external_courses,node_sync_rules,node_faculty_constraints,node_load_parser,node_resource_parser,node_faculty_parser toneAmber
class node_generator,node_session_pool,node_allocator,node_occupancy,node_practical_packing,node_daps,node_cascade,node_optimizer toneMint
class node_validation,node_division_view,node_batch_view,node_faculty_view,node_location_view,node_export toneRose
class node_semester_ui,node_semester_store toneIndigo
```

## Components

### Timetable Studio

- [App entry](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/page.tsx): `app/page.tsx`
- [Studio workflow](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/FileUpload.jsx): `app/components/FileUpload.jsx`

### Schedule Inputs

- [Course load](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/YearWiseCourses.jsx): `app/components/YearWiseCourses.jsx`
- [Global constraints](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/GlobalConstraints.jsx): `app/components/GlobalConstraints.jsx`
- [External courses](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/ExternalCourses.jsx): `app/components/ExternalCourses.jsx`
- [Sync rules](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/SyncRuleBuilder.jsx): `app/components/SyncRuleBuilder.jsx`
- [Faculty availability](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/FacultyConstraints.jsx): `app/components/FacultyConstraints.jsx`
- [Load parser](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/parseLoadSheet.js): `app/utils/parseLoadSheet.js`
- [Resource parser](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/parseResourcesSheet.js): `app/utils/parseResourcesSheet.js`
- [Availability parser](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/parseFacultyConstraints.js): `app/utils/parseFacultyConstraints.js`

### Scheduling Engine

- [Generation orchestrator](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/generateSmartTimetable.js): `app/utils/generateSmartTimetable.js`
- [Session pool](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/generateSessionPool.js): `app/utils/generateSessionPool.js`
- [Session allocator](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/allocateSessions.js): `app/utils/allocateSessions.js`
- [College occupancy](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/collegeOccupancy.js): `app/utils/collegeOccupancy.js`
- [Practical packing](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/practicalPacking.js): `app/utils/practicalPacking.js`
- [Priority scheduling](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/daps.js): `app/utils/daps.js`
- [Cascade repair](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/casc.js): `app/utils/casc.js`
- [Timetable optimizer](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/optimizeTimetable.js): `app/utils/optimizeTimetable.js`

### Reports and Views

- [Validation and conflicts](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/GenerationReport.jsx): `app/components/GenerationReport.jsx`
- [Division timetable](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/TimetableGrid.jsx): `app/components/TimetableGrid.jsx`
- [Batch timetable](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/BatchTimetableGrid.jsx): `app/components/BatchTimetableGrid.jsx`
- [Faculty timetable](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/FacultyTimetableGrid.jsx): `app/components/FacultyTimetableGrid.jsx`
- [Room occupancy](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/LocationTimetableGrid.jsx): `app/components/LocationTimetableGrid.jsx`
- [Workbook export](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/exportTimetable.js): `app/utils/exportTimetable.js`

### Semester State

- [Semester dashboard](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/components/SemesterDashboard.jsx): `app/components/SemesterDashboard.jsx`
- [Semester storage](https://github.com/shreyas-wagire/atlas---ttg/blob/main/app/utils/semesterStore.js): `app/utils/semesterStore.js`

### Other components

- **Department user**

## Connections

- Department user → App entry: opens (evidence: `app/page.tsx`)
- App entry → Studio workflow: renders (evidence: `app/page.tsx`)
- Studio workflow → Load parser: parses load (evidence: `app/components/FileUpload.jsx`)
- Studio workflow → Resource parser: parses resources (evidence: `app/components/FileUpload.jsx`)
- Studio workflow → Availability parser: parses availability (evidence: `app/components/FileUpload.jsx`)
- Studio workflow → Generation orchestrator: requests generation (evidence: `app/components/FileUpload.jsx`)
- Studio workflow → Course load: configures (evidence: `app/components/FileUpload.jsx`)
- Studio workflow → Global constraints: configures (evidence: `app/components/FileUpload.jsx`)
- Studio workflow → External courses: configures (evidence: `app/components/FileUpload.jsx`)
- Studio workflow → Sync rules: configures (evidence: `app/components/FileUpload.jsx`)
- Studio workflow → Faculty availability: configures (evidence: `app/components/FileUpload.jsx`)
- Generation orchestrator → Session pool: builds sessions (evidence: `app/utils/generateSmartTimetable.js`)
- Generation orchestrator → Session allocator: allocates sessions (evidence: `app/utils/generateSmartTimetable.js`)
- Session allocator → College occupancy: checks occupancy (evidence: `app/utils/allocateSessions.js`)
- Session allocator → Practical packing: packs practicals (evidence: `app/utils/allocateSessions.js`)
- Generation orchestrator → Priority scheduling: prioritizes sessions (evidence: `app/utils/generateSmartTimetable.js`)
- Generation orchestrator → Cascade repair: repairs placement (evidence: `app/utils/generateSmartTimetable.js`)
- Generation orchestrator → Timetable optimizer: optimizes schedule (evidence: `app/utils/generateSmartTimetable.js`)
- College occupancy → Availability parser: checks availability (evidence: `app/utils/collegeOccupancy.js`)
- Generation orchestrator → Validation and conflicts: produces diagnostics (evidence: `app/utils/generateSmartTimetable.js`)
- Generation orchestrator → Division timetable: generates view data (evidence: `app/utils/generateSmartTimetable.js`)
- Generation orchestrator → Batch timetable: generates view data (evidence: `app/utils/generateSmartTimetable.js`)
- Generation orchestrator → Faculty timetable: generates view data (evidence: `app/utils/generateSmartTimetable.js`)
- Generation orchestrator → Room occupancy: generates view data (evidence: `app/utils/generateSmartTimetable.js`)
- Department user → Workbook export: exports workbook (evidence: `README.md`)
- Semester dashboard → Semester storage: loads and saves (evidence: `app/components/SemesterDashboard.jsx`)
- Studio workflow → Semester dashboard: shows semesters (evidence: `app/components/FileUpload.jsx`)
- Studio workflow → Semester storage: saves results (evidence: `app/components/FileUpload.jsx`)
