FCIS GPA Helper 🎓

FCIS GPA Helper is a lightweight Chrome extension built for Faculty of Computers and Information Sciences (FCIS), Ain Shams University students.

The extension automatically detects missing Semester GPA and Cumulative GPA (CGPA) values on the UMS Student Grades page, calculates them locally, and displays them using the native UMS interface.

No configuration or user interaction is required.

✨ Features

• 🎯 Automatically calculates missing Semester GPA.
• 🎯 Automatically calculates missing Cumulative GPA (CGPA).
• 🎯 Preserves existing GPA/CGPA values provided by the university system.
• 🎯 Supports both Arabic and English UMS interfaces natively.
• 🎯 Correctly handles repeated/improved courses by considering only the latest attempt.
• 🎯 Built-in Update Notification System to alert you when a new manual release is available on GitHub.
• 🎯 Secure and private: Runs locally inside your browser with no tracking or data collection.

📸 Interface Preview (Before vs After)

📁 Project Structure

FCIS GPA Helper/
├── assets/
│   └── icons/
├── manifest.json
└── src/
    ├── constants.js
    ├── parser.js
    ├── calculator.js
    ├── renderer.js
    ├── updater.js
    └── index.js

File Responsibilities

⚙️ How It Works

The extension follows this sequential flow layout:

UMS Student Grades Page
        │
        ▼
Parse HTML (Single-pass)
        │
        ▼
Extract Semesters & Courses
        │
        ▼
Sort Chronologically (Oldest -> Newest)
        │
        ▼
Calculate Semester GPA
        │
        ▼
Update Repeated Courses (Latest attempt replaces older one)
        │
        ▼
Calculate CGPA
        │
        ▼
Render Missing Values & UI Blocks
        │
        ▼
Check for Extension Updates