How linaslabs/gradepilot works
GradePilot is a student-facing academic progress tracker. Students register or sign in, complete degree onboarding, then view their dashboard and manage academic years, modules, and assignments; the Pilot feature calculates grade progress and predictions. The client routes and server API are visible, and sampled controllers show persistence through Prisma. The README documents the product capabilities, but client-to-API calls and the Pilot calculation’s runtime integration were not shown, so those links are left unverified.
Main entry points: App.tsx Application router · apiRouter.js API dispatcher · prisma.js PostgreSQL via Prisma · app.js Express application
Components 21
Client experience
- Application router
grade-pilot-client/src/App.tsx - Auth state
grade-pilot-client/src/contexts/AuthContext.tsx - Login and registration
grade-pilot-client/src/pages/Login.tsx - Degree onboarding
grade-pilot-client/src/pages/Onboarding.tsx - Dashboard shell
grade-pilot-client/src/pages/DashboardLayout.tsx - User settings
grade-pilot-client/src/pages/Settings.tsx
Academic tracking
- Year overview
grade-pilot-client/src/pages/Overview.tsx - Year details
grade-pilot-client/src/pages/YearDetails.tsx - Academic editors
grade-pilot-client/src/components/ui - Grade Pilot
grade-pilot-client/src/utils/calculations.tsx - Degree management
grade-pilot-server/src/controllers/degreeControllers.js - Academic year management
grade-pilot-server/src/controllers/academicYearControllers.js - Module management
grade-pilot-server/src/controllers/moduleControllers.js - Assignment management
grade-pilot-server/src/controllers/assignmentControllers.js
API and security
- Express application
grade-pilot-server/src/app.js - API dispatcher
grade-pilot-server/src/routes/apiRouter.js - Authentication routes
grade-pilot-server/src/routes/authRouter.js - Authentication service
grade-pilot-server/src/controllers/authControllers.js - Degree routes
grade-pilot-server/src/routes/degreeRouter.js
Persistence and calculations
- PostgreSQL via Prisma
grade-pilot-server/src/lib/prisma.js
Other components
- Student
Connections 28
- Student → Application router: uses
grade-pilot-client/src/App.tsx - Application router → Auth state: provides auth
grade-pilot-client/src/App.tsx - Application router → Login and registration: routes to
grade-pilot-client/src/App.tsx - Application router → Degree onboarding: routes to
grade-pilot-client/src/App.tsx - Application router → Dashboard shell: routes to
grade-pilot-client/src/App.tsx - Application router → Year overview: routes to
grade-pilot-client/src/App.tsx - Application router → Year details: routes to
grade-pilot-client/src/App.tsx - Application router → User settings: routes to
grade-pilot-client/src/App.tsx - Student → Login and registration: authenticates
README.md - Student → Degree onboarding: enters degree
README.md - Student → Academic editors: manages records
README.md - Student → Grade Pilot: checks predictions
README.md - Express application → API dispatcher: mounts API
grade-pilot-server/src/app.js - API dispatcher → Authentication routes: dispatches auth
grade-pilot-server/src/routes/apiRouter.js - API dispatcher → Degree routes: dispatches degree
grade-pilot-server/src/routes/apiRouter.js - API dispatcher → Academic year management: dispatches year
- API dispatcher → Module management: dispatches modules
- API dispatcher → Assignment management: dispatches assignments
- Authentication routes → Authentication service: routes to
grade-pilot-server/src/routes/authRouter.js - Degree routes → Degree management: routes to
grade-pilot-server/src/routes/degreeRouter.js - Authentication service → PostgreSQL via Prisma: reads and writes
grade-pilot-server/src/controllers/authControllers.js - Degree management → PostgreSQL via Prisma: reads and writes
grade-pilot-server/src/controllers/degreeControllers.js - Academic year management → PostgreSQL via Prisma: reads and writes
grade-pilot-server/src/controllers/academicYearControllers.js - Module management → PostgreSQL via Prisma: reads and writes
grade-pilot-server/src/controllers/moduleControllers.js - Assignment management → PostgreSQL via Prisma: reads and writes
grade-pilot-server/src/controllers/assignmentControllers.js - Degree onboarding → Express application: submits degree
- Login and registration → Express application: sends credentials
- Year details → Express application: loads year data