为什么值得关注

它零配置、完全隐私、原生支持阿拉伯语和英语界面，填补了大学成绩系统的关键空白。

适合谁使用

艾因·夏姆斯大学计算机与信息科学学院的学生
使用UMS成绩门户的学生
需要快速计算GPA/累积GPA而不想手动操作的学生
希望使用纯本地解决方案的隐私敏感用户

典型使用场景

当系统显示学期GPA缺失时自动计算
处理重修课程（仅保留最后一次成绩）后获取累积GPA
无需外部数据共享即可验证成绩计算
作为学业规划的参考工具

项目优势

自动工作，无需任何配置或用户交互
完全本地且私密——无追踪、无数据收集，仅更新时进行一个网络请求
正确处理重修/提高课程，仅使用最新成绩
原生支持UMS的阿拉伯语和英语界面

使用前须知

仅适用于艾因·夏姆斯大学计算机与信息科学学院的特定UMS页面
需要手动安装（未上架Chrome网上应用店或Firefox附加组件商店）
Firefox下为临时安装，永久发行尚未可用

README 快速开始

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

File	Responsibility
`constants.js`	Grade mappings, dynamic thresholds, and shared language dictionaries
`parser.js`	Scrapes and extracts structural academic data from the UMS page
`calculator.js`	Mathematical utilities for calculating Semester GPA and CGPA
`renderer.js`	Injects calculated metric chips and hero containers into the page
`updater.js`	Performs secure semantic version comparisons against the upstream repository
`index.js`	Coordinates the full extension automation workflow lifecycle

⚙️ 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

项目描述

Automatically calculate and display missing GPA and CGPA for FCIS Ain Shams students.

FCIS-GPA-Helper