How mhemanthsai456/major-project works
PathFinder.AI helps students choose career targets, assess skills and topic knowledge, follow personalized recommendations and roadmaps, study learning resources, and track progress. The main workflow runs from the browser through the React API client to Flask feature routes, recommendation logic, and relational storage. The graph also preserves career/project exploration and assessment-based skill updates. Route-to-feature details are grouped where source is not sampled; README architecture supports the main request flow, while inspected source confirms app registration and selected route behavior.
Main entry points: app.py Flask API · api.js API client · models.py Domain models · recommendation.py Recommendation engine
Components 23
Student experience
- React application
frontend/src/App.jsx - Authentication state
frontend/src/context/AuthContext.jsx - API client
frontend/src/services/api.js - Career exploration
frontend/src/pages/Careers.jsx - Learning dashboard
frontend/src/pages/Dashboard.jsx - Skill gap view
frontend/src/pages/SkillGapPage.jsx - Topic learning
frontend/src/pages/TopicDetail.jsx - Progress indicators
frontend/src/components/ProgressRing.jsx
API and domain
- Flask API
backend/app.py - Account routes
backend/routes/auth_routes.py - Career routes
backend/routes/career_routes.py - Topic routes
backend/routes/topic_routes.py - Recommendation engine
backend/recommendation.py - Token and auth logic
backend/utils/auth_utils.py
Learning journey
- Assessment routes
backend/routes/assessment_routes.py - Recommendation routes
backend/routes/recommendation_routes.py - Roadmap routes
backend/routes/roadmap_routes.py - Progress routes
backend/routes/progress_routes.py - Projects and resources
backend/routes
State and storage
- Domain models
backend/models.py - SQLAlchemy layer
backend/database.py - SQLite database
Other components
- Student
Connections 30
- Student → React application: uses
- React application → API client: requests data
- React application → Authentication state: provides auth
frontend/src/App.jsx - Authentication state → API client: calls
frontend/src/context/AuthContext.jsx - Career exploration → API client: requests data
frontend/src/pages/Careers.jsx - Learning dashboard → API client: requests data
frontend/src/pages/Dashboard.jsx - Skill gap view → API client: requests data
frontend/src/pages/SkillGapPage.jsx - Topic learning → API client: requests data
frontend/src/pages/TopicDetail.jsx - Learning dashboard → Progress indicators: renders
frontend/src/pages/Dashboard.jsx - API client → Flask API: sends JSON
- Flask API → Account routes: registers
backend/app.py - Flask API → Career routes: registers
backend/app.py - Flask API → Topic routes: registers
backend/app.py - Flask API → Assessment routes: registers
backend/app.py - Flask API → Recommendation routes: registers
backend/app.py - Flask API → Roadmap routes: registers
backend/app.py - Flask API → Progress routes: registers
backend/app.py - Flask API → Projects and resources: registers routes
backend/app.py - Account routes → Token and auth logic: uses
backend/routes/auth_routes.py - Account routes → Domain models: reads and writes
backend/routes/auth_routes.py - Career routes → Recommendation engine: calls
backend/routes/career_routes.py - Recommendation routes → Recommendation engine: calls
backend/routes/recommendation_routes.py - Roadmap routes → Recommendation engine: calls
backend/routes/roadmap_routes.py - Assessment routes → Domain models: records attempts
backend/routes/assessment_routes.py - Assessment routes → Domain models: updates mastery
backend/routes/assessment_routes.py - Topic routes → Domain models: queries topics
backend/routes/topic_routes.py - Progress routes → Domain models: tracks completion
backend/routes/progress_routes.py - Recommendation engine → Domain models: queries learning state
backend/recommendation.py - Domain models → SQLAlchemy layer: uses ORM
backend/models.py - SQLAlchemy layer → SQLite database: persists data