🎓 Suez University GPA & Progress Advisor

📋 How to Get Your Student Data

1. Log in to the Suez University student portal: http://credit.suez.edu.eg/static/PortalStudent.html#
2. Open Developer Tools in your browser (F12 or Ctrl+Shift+I).
3. Go to the Network tab.
4. Navigate to the "Student Academic Register" page.
5. Find the network request named getJCI and click on it.
6. Go to the Response tab.
7. Copy the entire JSON content. This is the data you will need for the next section.

🚀 Run the Advisor on Your Own Fork

To use the GPA Advisor, you must first create your own copy (a "fork") of this repository. This allows you to run the action securely on your own GitHub account.

1. Click the "Fork" button at the top-right of the GitHub page, or click the button below to start.
2. Once you are on your forked repository, go to the "Actions" tab.
3. Click on "Run GPA & Progress Advisor" in the left sidebar.
4. Click the "Run workflow" button.
5. Now, create a GitHub Gist: go to gist.github.com and paste the student data you copied.
6. Give the Gist a filename (e.g., data.txt) and click "Create secret gist".
7. On the Gist page, click the "Raw" button and copy the URL from your browser.
8. Paste this Gist Raw URL into the workflow's input field back on GitHub Actions.
9. Click "Run workflow" and wait for the results in the action log!

💻 Run Locally on Your Machine

Prefer to run the script on your own computer? Here's how to set it up locally for faster, more private processing.

📋 Prerequisites

1. Install Python: Download Python from python.org. During installation, make sure to check "Add Python to PATH" on Windows.
2. Install Git (optional): Download from git-scm.com if you want to use Git commands, or just download the ZIP file.

📥 Download the Project

Option A: Download ZIP (Easiest)

1. Go to the GitHub repository
2. Click the green "Code" button
3. Select "Download ZIP"
4. Extract the ZIP file to a folder on your computer (e.g., Desktop)

Option B: Using Git (Advanced)

Step	Command	What it does
1	git clone https://github.com/EgyptianComrade/Suez-Canal-CS-GPA-Helper.git 📋 Copy	Downloads the project files to your computer

🔧 Open Terminal/Command Prompt

1. On Windows: Press Win + R, type "cmd" and press Enter, OR search for "Command Prompt" in the Start menu
2. On Mac: Press Cmd + Space, type "Terminal" and press Enter
3. On Linux: Press Ctrl + Alt + T
4. Navigate to the project folder using the cd command. For example: cd Desktop/my-mongo-project

📦 Install Dependencies

These are additional programs the script needs to work properly.

Step	Command	What it does
1	pip install -r requirements.txt 📋 Copy	Installs all the required Python packages

🚀 Run the GPA Calculator

Step	Command	What it does
1	python gpa_calculator.py 📋 Copy	Starts the GPA calculator program. You will be prompted to select your faculty (Computer Science or Engineering) at the start.

📝 Using the Program

1. When the program starts, select your faculty (Computer Science or Engineering).
2. Paste your student data as described above.
3. Follow the on-screen menu to view your GPA, progress, and more.

✨ Features

⚠️ Disclaimer

This tool is designed to help students track their academic progress at Suez University. While every effort has been made to ensure accuracy, please verify all calculations with your official university records. This tool is not affiliated with Suez University and should not replace official academic advising.