AI-powered career and course guidance system for South African High School Students.
# StudentPathGuide
> AI-powered career and course guidance system for South African high school students.
StudentPathGuide helps Grade 10β12 learners explore university courses, TVET programmes, bursaries, and career paths aligned with their subject marks and APS score β removing the confusion that comes from not knowing what to study after matric.
π **Live app:** student-path-guide-a644.vercel.app
---
## Table of contents
- Features
- Project structure
- Tech stack
- System diagrams
- Database schema
- API endpoints
- Getting started
- Environment variables
- Authors
---
## Features
- **APS calculator** β enter subject marks and instantly get your APS score (Life Orientation excluded automatically)
- **Course matching** β returns university courses the student qualifies for based on their APS
- **Subject improvement advisor** β shows which subjects to improve and by how much to reach a target course
- **AI chat assistant** β powered by Google Gemini, gives personalised career and course guidance
- **Career personality quiz** β 6-question quiz that identifies a student's career field and recommends matching courses
- **Application dates** β opening and closing dates for all major South African universities
- **Bursaries & scholarships** β browse and apply for available funding opportunities
- **TVET options** β explore TVET college programmes and career paths as an alternative to university
> No student personal information is stored. The database contains only reference data (courses, universities, bursaries, TVET programmes).
---
## Project structure
```
StudentPathGuide/
βββ client/ # Frontend β React.js + Tailwind CSS
βββ server/ # Backend β Node.js + Express REST API
βββ docs/ # Technical documentation and UML diagrams
βββ README.md
```
---
## Tech stack
| Layer | Technology | Purpose |
|-----------------|----------------------|--------------------------- β¦