How souravsahapartho/uiu-cgpa-calculator-ai works
UIU CGPA Calculator AI is an offline-first Flutter student companion, with a Cloudflare Worker providing a web interface and optional AI-advisor API. The principal workflow is to enter or import academic records, calculate GPA/CGPA, inspect progress and honors, and optionally plan courses or tuition. The README documents these capabilities; the supplied excerpts show Worker routing and AI fallback, but not Flutter screen wiring or local persistence implementation, so uncertain app-internal connections are omitted or marked unverified.
Main entry points: transcript_import_screen.dart Transcript import · trimester_gpa_screen.dart Trimester GPA · analytics_screen.dart Academic analytics · ai_advisor_screen.dart Advisor experience
Components 17
Student app
- Flutter app
lib/main.dart - App navigation
lib/screens/main_navigation_screen.dart - Student profile
lib/screens/profile_screen.dart
Academic records
- Transcript import
lib/screens/transcript_import_screen.dart - Transcript records
lib/models/semester_transcript.dart - Trimester GPA
lib/screens/trimester_gpa_screen.dart - UIU grading scale
lib/core/constants/uiu_grading_scale.dart - Academic analytics
lib/screens/analytics_screen.dart - Honors evaluation
lib/core/services/academic_distinction_engine.dart
Planning and fees
- Advisor experience
lib/screens/ai_advisor_screen.dart - Advisor engine
lib/core/services/academic_advisor_engine.dart - Tuition and PDF
lib/screens/tuition_fee_screen.dart - PDF generator
lib/core/utils/tuition_pdf_generator.dart
Web and advisor service
- Worker API
worker.js - AI advisor handler
worker.js
Other components
- Student
- Workers AI
Connections 13
- Student → Flutter app: uses
README.md - Student → Transcript import: imports records
README.md - Student → Trimester GPA: enters courses
README.md - Transcript import → Transcript records: creates records
- Trimester GPA → UIU grading scale: applies policy
README.md - Student → Academic analytics: reviews progress
README.md - Academic analytics → Honors evaluation: evaluates honors
- Student → Advisor experience: requests advice
README.md - Advisor experience → Advisor engine: uses fallback
- Student → Tuition and PDF: calculates fees
README.md - Tuition and PDF → PDF generator: exports receipt
README.md - Worker API → AI advisor handler: routes requests
worker.js - AI advisor handler → Workers AI: runs inference
worker.js