# hasini8-debug/vtu-gptrack architecture

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

- Interactive diagram: https://gitdiagram.com/hasini8-debug/vtu-gptrack
- Repository: https://github.com/hasini8-debug/vtu-gptrack

## Overview

VTU GPTrack is a browser-based calculator for VTU students. Students can navigate from the home page to an SGPA calculator, which accepts course marks and credits and presents grade and SGPA results, or to a CGPA calculator, which combines semester SGPAs weighted by credits. A feedback form submits suggestions through a configured HTTP endpoint. The source excerpts show the calculation and interaction logic; page-to-script wiring and some HTML details were not sampled.

Main entry points: [`VTU-CGPA-calculator/script.js`](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js) (CGPA calculation), [`script.js`](https://github.com/hasini8-debug/vtu-gptrack/blob/main/script.js) (Card navigation), [`VTU-SGPA-Calculator/script.js`](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-SGPA-Calculator/script.js) (SGPA calculation), [`index.html`](https://github.com/hasini8-debug/vtu-gptrack/blob/main/index.html) (Home page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_home["Home and navigation"]
  node_home_page["Home page<br/>[index.html]"]
  node_home_navigation["Card navigation<br/>[script.js]"]
end

subgraph group_sgpa["SGPA calculator"]
  node_sgpa_inputs["Course inputs<br/>[script.js]"]
  node_sgpa_grades["Grade mapping<br/>[script.js]"]
  node_sgpa_calc["SGPA calculation<br/>[script.js]"]
  node_sgpa_results["SGPA results<br/>[script.js]"]
end

subgraph group_cgpa["CGPA calculator"]
  node_cgpa_semesters["Semester inputs<br/>[script.js]"]
  node_cgpa_validation["Input validation<br/>[script.js]"]
  node_cgpa_calc["CGPA calculation<br/>[script.js]"]
  node_cgpa_message["Motivational message<br/>[script.js]"]
  node_cgpa_results["CGPA results<br/>[script.js]"]
end

subgraph group_feedback["Feedback"]
  node_feedback_form["Feedback form<br/>[script.js]"]
  node_feedback_service["Form endpoint"]
end

node_student(("Student"))

node_student -->|"opens"| node_home_page
node_home_page -.->|"uses navigation"| node_home_navigation
node_home_navigation -->|"navigates to"| node_sgpa_inputs
node_home_navigation -->|"navigates to"| node_cgpa_semesters
node_student -->|"enters courses"| node_sgpa_inputs
node_sgpa_inputs -->|"provides marks"| node_sgpa_calc
node_sgpa_calc -->|"calculates grade points"| node_sgpa_grades
node_sgpa_calc -->|"displays totals"| node_sgpa_results
node_sgpa_results -->|"shows result"| node_student
node_student -->|"enters semesters"| node_cgpa_semesters
node_cgpa_semesters -->|"submits values"| node_cgpa_calc
node_cgpa_calc -->|"validates inputs"| node_cgpa_validation
node_cgpa_calc -->|"gets message"| node_cgpa_message
node_cgpa_calc -->|"displays result"| node_cgpa_results
node_cgpa_results -->|"shows result"| node_student
node_student -->|"submits suggestions"| node_feedback_form
node_feedback_form -->|"posts feedback"| node_feedback_service

click node_home_page "https://github.com/hasini8-debug/vtu-gptrack/blob/main/index.html"
click node_home_navigation "https://github.com/hasini8-debug/vtu-gptrack/blob/main/script.js"
click node_sgpa_inputs "https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-SGPA-Calculator/script.js"
click node_sgpa_grades "https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-SGPA-Calculator/script.js"
click node_sgpa_calc "https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-SGPA-Calculator/script.js"
click node_sgpa_results "https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-SGPA-Calculator/script.js"
click node_cgpa_semesters "https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js"
click node_cgpa_validation "https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js"
click node_cgpa_calc "https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js"
click node_cgpa_message "https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js"
click node_cgpa_results "https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js"
click node_feedback_form "https://github.com/hasini8-debug/vtu-gptrack/blob/main/script.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_home_page,node_home_navigation toneBlue
class node_sgpa_inputs,node_sgpa_grades,node_sgpa_calc,node_sgpa_results toneAmber
class node_cgpa_semesters,node_cgpa_validation,node_cgpa_calc,node_cgpa_message,node_cgpa_results toneMint
class node_feedback_form,node_feedback_service toneRose
class node_student toneIndigo
```

## Components

### Home and navigation

- [Home page](https://github.com/hasini8-debug/vtu-gptrack/blob/main/index.html): `index.html`
- [Card navigation](https://github.com/hasini8-debug/vtu-gptrack/blob/main/script.js): `script.js`

### SGPA calculator

- [Course inputs](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-SGPA-Calculator/script.js): `VTU-SGPA-Calculator/script.js`
- [Grade mapping](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-SGPA-Calculator/script.js): `VTU-SGPA-Calculator/script.js`
- [SGPA calculation](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-SGPA-Calculator/script.js): `VTU-SGPA-Calculator/script.js`
- [SGPA results](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-SGPA-Calculator/script.js): `VTU-SGPA-Calculator/script.js`

### CGPA calculator

- [Semester inputs](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js): `VTU-CGPA-calculator/script.js`
- [Input validation](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js): `VTU-CGPA-calculator/script.js`
- [CGPA calculation](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js): `VTU-CGPA-calculator/script.js`
- [Motivational message](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js): `VTU-CGPA-calculator/script.js`
- [CGPA results](https://github.com/hasini8-debug/vtu-gptrack/blob/main/VTU-CGPA-calculator/script.js): `VTU-CGPA-calculator/script.js`

### Feedback

- [Feedback form](https://github.com/hasini8-debug/vtu-gptrack/blob/main/script.js): `script.js`
- **Form endpoint**

### Other components

- **Student**

## Connections

- Student → Home page: opens (evidence: `README.md`)
- Home page → Card navigation: uses navigation
- Card navigation → Course inputs: navigates to (evidence: `script.js`)
- Card navigation → Semester inputs: navigates to (evidence: `script.js`)
- Student → Course inputs: enters courses (evidence: `README.md`)
- Course inputs → SGPA calculation: provides marks (evidence: `VTU-SGPA-Calculator/script.js`)
- SGPA calculation → Grade mapping: calculates grade points (evidence: `VTU-SGPA-Calculator/script.js`)
- SGPA calculation → SGPA results: displays totals (evidence: `VTU-SGPA-Calculator/script.js`)
- SGPA results → Student: shows result (evidence: `VTU-SGPA-Calculator/script.js`)
- Student → Semester inputs: enters semesters (evidence: `README.md`)
- Semester inputs → CGPA calculation: submits values (evidence: `VTU-CGPA-calculator/script.js`)
- CGPA calculation → Input validation: validates inputs (evidence: `VTU-CGPA-calculator/script.js`)
- CGPA calculation → Motivational message: gets message (evidence: `VTU-CGPA-calculator/script.js`)
- CGPA calculation → CGPA results: displays result (evidence: `VTU-CGPA-calculator/script.js`)
- CGPA results → Student: shows result (evidence: `VTU-CGPA-calculator/script.js`)
- Student → Feedback form: submits suggestions (evidence: `README.md`)
- Feedback form → Form endpoint: posts feedback (evidence: `script.js`)
