How cmd-jebi/careerpath-ai-fullstack works
CareerPath AI is a Philippine senior-high-school guidance tool. A student uses the career-track page to load the O*NET interest checklist, enter grades and interests, and request pathway recommendations; the app returns suggested tracks, clusters, and next steps, which the page displays and can export as a PDF. The backend also serves cluster and institution reference data and uses Gemini for recommendation generation. Evidence is limited to the README (empty) and the supplied source excerpts; the recommendation request’s exact frontend route is not visible, so that link is marked unverified.
Main entry points: app.py Recommendation generation · careerTrack.html Career track page · script.js Recommendation form · data.py Track and cluster guidance
Components 12
Guidance experience
- Career track page
frontend/careerTrack.html - Interest profiling
frontend/script.js - Recommendation form
frontend/script.js - Results and PDF
frontend/script.js
Recommendation service
- Flask API
backend/app.py - Checklist endpoint
backend/app.py - Recommendation generation
backend/app.py
Guidance knowledge
- O*NET questions
backend/data.py - Track and cluster guidance
backend/data.py - Institution suggestions
backend/data.py
Other components
- Student
- Gemini service
Connections 13
- Student → Career track page: uses
- Career track page → Interest profiling: hosts
- Career track page → Recommendation form: hosts
- Recommendation form → Results and PDF: displays results
frontend/script.js - Interest profiling → Checklist endpoint: loads checklist
frontend/script.js - Recommendation form → Recommendation generation: requests recommendations
- Flask API → Checklist endpoint: routes
backend/app.py - Flask API → Recommendation generation: routes
backend/app.py - Checklist endpoint → O*NET questions: returns questions
backend/app.py - Checklist endpoint → Track and cluster guidance: returns attribution
backend/app.py - Recommendation generation → Gemini service: generates content
backend/app.py - Recommendation generation → Track and cluster guidance: imports guidance
backend/app.py - Recommendation generation → Institution suggestions: imports institutions
backend/app.py