feat: Add Interactive GPA/CGPA Calculator and Target Predictor (#78)

[kartikbhardwaj1111]

🎓 feat: Add Interactive GPA/CGPA Calculator and Target Predictor (#78)

📌 Summary & Motivation

Resolves #78. Implements a dedicated GPA & CGPA Calculator & Target Predictor page inside the student workspace tailored to PES University's 10-point grading system (S=10, A=9, B=8, C=7, D=6, E=5, F=0).

---

🚀 Key Features Implemented:

1. SGPA Calculator (Semester GPA):

   • Dynamic course addition and deletion.
   • Credit weight selection ($1-5$ credits) and PESU grade mapping ($S-F$).
   • Real-time SGPA calculation and total points summary card.

2. CGPA Calculator (Cumulative GPA):

   • Past semester rows (Sem 1 through Sem 8) with SGPA and credit weighting.
   • Cumulative CGPA real-time calculation.

3. Target CGPA Predictor:

   • Calculates required upcoming SGPA given Current CGPA, Completed Credits, Target CGPA, and Upcoming Semester Credits.
   • Smart feasibility alerts: detects mathematically impossible targets (>10.00 SGPA) and provides achievable motivational goals.

4. Integration & Navigation:

   • Registered /gpa-calculator route in App.tsx.
   • Added GPA Calculator link with Calculator icon in Sidebar.tsx.
   • Fully accessible both within the authenticated student layout and directly for standalone testing.

---

🧪 Testing & Verification:

• Unit Tests: Added 7 comprehensive unit tests in src/pages/__tests__/GpaCalculatorPage.test.tsx (all passing).
• Build: Verified full production build with Vite (✓ built in 5.25s with 0 errors).
• Note on Testing Environment: As an external GSSOC contributor without active PESU student portal login credentials, I thoroughly verified the feature locally across all 3 calculator tabs using direct routing and automated test suites, ensuring it functions smoothly for logged-in PES students within the dashboard layout.

---

🎥 Demo Video:

(Drag and drop your video file GPA & CGPA Calculator.mp4 from your Desktop here)

GPA.CGPA.Calculator.mp4

[github-actions]

Hi @kartikbhardwaj1111, thanks for contributing to Nyay Setu! 🎉

I have automatically:

• 👤 Assigned this PR to you.
• 🏷️ Applied the gssoc:approved label.

Our workflows will now analyze your changes to classify:

• 📈 PR Difficulty: level:*
• 🧩 PR Type: type:*
• 🌟 PR Quality: quality:*

Tip

Ensure your PR description references the issue it resolves (e.g. Closes #123). This allows the bot to inherit any additional labels from that issue!

Happy coding! 🚀