# aneshannachi/esi-grade architecture

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

- Interactive diagram: https://gitdiagram.com/aneshannachi/esi-grade
- Repository: https://github.com/aneshannachi/esi-grade

## Overview

ESI-Grade is a client-side academic grade calculator. Users choose an academic year and semester, enter assessment scores for the listed modules, and view weighted results with charts and export options. Grade data travels between pages in encoded URL parameters; the dashboard can also display semester averages and module details from query data. The shown excerpts establish the selection-to-entry-to-results flow and export calls. The welcome card’s navigation and any route into the dashboard are not visible in the sampled source, so those links are omitted.

Main entry points: [`app/semesters/page.jsx`](https://github.com/aneshannachi/esi-grade/blob/main/app/semesters/page.jsx) (Semester page), [`app/grades/page.jsx`](https://github.com/aneshannachi/esi-grade/blob/main/app/grades/page.jsx) (Grade entry page), [`components/Header.jsx`](https://github.com/aneshannachi/esi-grade/blob/main/components/Header.jsx) (Flow header), [`app/page.jsx`](https://github.com/aneshannachi/esi-grade/blob/main/app/page.jsx) (Home page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and navigation"]
  node_home["Home page<br/>[page.jsx]"]
  node_welcome["Welcome card<br/>[WelcomeCard.jsx]"]
  node_header["Flow header<br/>[Header.jsx]"]
  node_semester_page["Semester page<br/>[page.jsx]"]
  node_semester_card["Year and semester<br/>[SemesterCard.jsx]"]
end

subgraph group_grading["Grade entry"]
  node_grades_page["Grade entry page<br/>[page.jsx]"]
  node_grades_form["Grades form<br/>[GradesForm.jsx]"]
  node_course_catalog["Course catalog<br/>[coursesData.jsx]"]
end

subgraph group_results["Results and export"]
  node_results_page["Results page<br/>[page.jsx]"]
  node_results_card["Results and charts<br/>[ResultsCard.jsx]"]
  node_export["PDF and Excel export<br/>[exportUtils.js]"]
  node_dashboard["Dashboard<br/>[page.jsx]"]
end

node_user(("Student"))

node_user -->|"opens"| node_home
node_home -->|"renders"| node_header
node_home -->|"renders"| node_welcome
node_user -->|"selects semester"| node_semester_page
node_semester_page -->|"renders"| node_header
node_semester_page -->|"renders"| node_semester_card
node_semester_card -->|"returns selection"| node_semester_page
node_semester_page -->|"routes with selection"| node_grades_page
node_grades_page -->|"renders"| node_header
node_grades_page -->|"renders"| node_grades_form
node_grades_form -->|"loads module defaults"| node_course_catalog
node_grades_form -->|"submits grades"| node_grades_page
node_grades_page -->|"routes encoded grades"| node_results_page
node_results_page -->|"renders"| node_header
node_results_page -->|"renders results"| node_results_card
node_results_card -->|"calls export"| node_export
node_user -.->|"opens with query data"| node_dashboard

click node_home "https://github.com/aneshannachi/esi-grade/blob/main/app/page.jsx"
click node_welcome "https://github.com/aneshannachi/esi-grade/blob/main/components/WelcomeCard.jsx"
click node_header "https://github.com/aneshannachi/esi-grade/blob/main/components/Header.jsx"
click node_semester_page "https://github.com/aneshannachi/esi-grade/blob/main/app/semesters/page.jsx"
click node_semester_card "https://github.com/aneshannachi/esi-grade/blob/main/components/SemesterCard.jsx"
click node_grades_page "https://github.com/aneshannachi/esi-grade/blob/main/app/grades/page.jsx"
click node_grades_form "https://github.com/aneshannachi/esi-grade/blob/main/components/GradesForm.jsx"
click node_course_catalog "https://github.com/aneshannachi/esi-grade/blob/main/lib/coursesData.jsx"
click node_results_page "https://github.com/aneshannachi/esi-grade/blob/main/app/results/page.jsx"
click node_results_card "https://github.com/aneshannachi/esi-grade/blob/main/components/ResultsCard.jsx"
click node_export "https://github.com/aneshannachi/esi-grade/blob/main/lib/exportUtils.js"
click node_dashboard "https://github.com/aneshannachi/esi-grade/blob/main/app/dashboard/page.jsx"

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,node_welcome,node_header,node_semester_page,node_semester_card toneBlue
class node_grades_page,node_grades_form,node_course_catalog toneAmber
class node_results_page,node_results_card,node_export,node_dashboard toneMint
class node_user toneIndigo
```

## Components

### Entry and navigation

- [Home page](https://github.com/aneshannachi/esi-grade/blob/main/app/page.jsx): `app/page.jsx`
- [Welcome card](https://github.com/aneshannachi/esi-grade/blob/main/components/WelcomeCard.jsx): `components/WelcomeCard.jsx`
- [Flow header](https://github.com/aneshannachi/esi-grade/blob/main/components/Header.jsx): `components/Header.jsx`
- [Semester page](https://github.com/aneshannachi/esi-grade/blob/main/app/semesters/page.jsx): `app/semesters/page.jsx`
- [Year and semester](https://github.com/aneshannachi/esi-grade/blob/main/components/SemesterCard.jsx): `components/SemesterCard.jsx`

### Grade entry

- [Grade entry page](https://github.com/aneshannachi/esi-grade/blob/main/app/grades/page.jsx): `app/grades/page.jsx`
- [Grades form](https://github.com/aneshannachi/esi-grade/blob/main/components/GradesForm.jsx): `components/GradesForm.jsx`
- [Course catalog](https://github.com/aneshannachi/esi-grade/blob/main/lib/coursesData.jsx): `lib/coursesData.jsx`

### Results and export

- [Results page](https://github.com/aneshannachi/esi-grade/blob/main/app/results/page.jsx): `app/results/page.jsx`
- [Results and charts](https://github.com/aneshannachi/esi-grade/blob/main/components/ResultsCard.jsx): `components/ResultsCard.jsx`
- [PDF and Excel export](https://github.com/aneshannachi/esi-grade/blob/main/lib/exportUtils.js): `lib/exportUtils.js`
- [Dashboard](https://github.com/aneshannachi/esi-grade/blob/main/app/dashboard/page.jsx): `app/dashboard/page.jsx`

### Other components

- **Student**

## Connections

- Student → Home page: opens (evidence: `app/page.jsx`)
- Home page → Flow header: renders (evidence: `app/page.jsx`)
- Home page → Welcome card: renders (evidence: `app/page.jsx`)
- Student → Semester page: selects semester (evidence: `app/semesters/page.jsx`)
- Semester page → Flow header: renders (evidence: `app/semesters/page.jsx`)
- Semester page → Year and semester: renders (evidence: `app/semesters/page.jsx`)
- Year and semester → Semester page: returns selection (evidence: `components/SemesterCard.jsx`)
- Semester page → Grade entry page: routes with selection (evidence: `app/semesters/page.jsx`)
- Grade entry page → Flow header: renders (evidence: `app/grades/page.jsx`)
- Grade entry page → Grades form: renders (evidence: `app/grades/page.jsx`)
- Grades form → Course catalog: loads module defaults (evidence: `components/GradesForm.jsx`)
- Grades form → Grade entry page: submits grades (evidence: `app/grades/page.jsx`)
- Grade entry page → Results page: routes encoded grades (evidence: `app/grades/page.jsx`)
- Results page → Flow header: renders (evidence: `app/results/page.jsx`)
- Results page → Results and charts: renders results (evidence: `app/results/page.jsx`)
- Results and charts → PDF and Excel export: calls export (evidence: `components/ResultsCard.jsx`)
- Student → Dashboard: opens with query data
