Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/craftingweb/majorgpa-backend

A common concern among students is the absence of major GPA information on their transcripts. Transcripts only show cumulative GPA (all classes that students took), not major GPA (classes that related to students major, for example, all Computer Science classes).
https://github.com/craftingweb/majorgpa-backend

expressjs nextjs

Last synced: 3 days ago
JSON representation

Host: GitHub
URL: https://github.com/craftingweb/majorgpa-backend
Owner: craftingweb
Created: 2024-01-22T15:35:27.000Z (10 months ago)
Default Branch: main
Last Pushed: 2024-01-25T13:47:04.000Z (10 months ago)
Last Synced: 2024-06-03T23:24:50.980Z (6 months ago)
Topics: expressjs, nextjs
Language: JavaScript
Homepage: https://major-gpa-wizard.vercel.app/
Size: 15.6 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        # Major GPA Wizard

A common concern among students is the absence of major GPA information on their transcripts. Transcripts only show cumulative GPA (all classes that students took), not major GPA (classes that related to students major, for example, all Computer Science classes). 

The [Major GPA Wizard](https://major-gpa-wizard.vercel.app/) is a user-friendly application designed to simplify the process of calculating major GPA from formatted PDF files.

## Key Features

### Automated CS Subject Detection

The application automatically identifies and extracts major CS subjects from uploaded PDFs, streamlining the GPA calculation process.

### GPA Calculation

It computes the total GPA based on the extracted CS subjects, offering a comprehensive overview of academic performance.

## How It Works

1. **File Upload:** Users upload their PDF files through a simple and intuitive interface.

2. **PDF Parsing:** The backend, built with Node.js and Express, uses the "pdfreader" package to efficiently parse PDF content.

3. **Data Filtering:** Parsed data is converted into JSON format, and filtering operations extract necessary information related to CS subjects.

4. **GPA Calculation:** The backend calculates the total GPA based on the extracted CS subjects, providing users with a clear understanding of their academic achievements.

## Technology Stack

### Frontend

- React.js

- Vite.js (for React project setup)

### Backend

- Node.js

- Express.js

- pdfreader (for PDF parsing)

- multer (for file uploading)

- cors (for handling CORS issues)

- dotenv (for managing environment variables)

## Frontend Implementation

The frontend utilizes React and Vite.js for a responsive and interactive user interface, including a header, a file input section, and a result table dynamically appearing after processing the PDF.

## Backend Implementation

Built with Node.js and Express.js, the backend employs the "pdfreader" package for efficient PDF parsing, "multer" middleware for file uploading, and other packages to handle CORS and environment variables.

### Backend Functions

- **parsePdf:** Parses the PDF content and returns the data.

- **API Route:** Accepts the uploaded PDF file and sends it to the parser function.

- **Data Filtering:** Processes the parsed data, filters relevant information, and returns it in JSON format.

## Challenges Faced

- **Frontend PDF Parsing:** Initial attempts to parse PDFs in the frontend using "tesseract.js" OCR faced challenges, resolved by switching to a Node.js backend with the "pdfreader" package.

- **File Upload:** Uploading and handling files on the server posed challenges, streamlined by the use of the "multer" middleware.

- **PDF to Image Conversion:** Exploring PDF to image conversion for OCR posed difficulties initially. Ultimately, the "pdfreader" package emerged as a suitable solution for parsing PDFs directly.





Link to frontend: https://github.com/VitaliPri/MajorGPA-Wizard