How prajxal/adaptive-learning-system-with-integrated-analytics-pipeline works
LearnPath AI is an adaptive developer-learning platform: learners connect skill sources, receive a prerequisite-aware path and recommendations, study courses, and update progress through quizzes. The graph also includes the AI Mentor and its documented tool registry. The README describes the broader architecture; sampled source confirms application routing, database setup, dynamic roadmap resolution, and quiz generation, but not every router-to-service connection.
Main entry points: main.py FastAPI application · database.py PostgreSQL · App.tsx Web application · chat.py Chat routes
Components 22
Learner experience
- Web application
src/app/App.tsx - API clients
src/services/api.ts - Courses and roadmaps
src/app/pages/RoadmapDetailPage.tsx - Quiz experience
src/app/pages/QuizPage.tsx - AI Mentor
src/app/pages/AIMentorPage.tsx
Backend API
- FastAPI application
backend/main.py - Skill ingestion routes
backend/routers/github_auth.py - Roadmap and course routes
backend/routers/learning_path.py - Quiz routes
backend/routers/quiz.py - Chat routes
backend/routers/chat.py - Progress routes
backend/routers/progress.py
Learning services
- Skill synthesis
backend/services/skill_synthesizer.py - Dynamic roadmaps
backend/services/dynamic_roadmap_service.py - Course ranking
backend/services/learning_priority_service.py - Quiz generation and Elo
backend/services/quiz_generation_service.py - Mentor tool registry
backend/mcp_server/registry.py - Mentor context and tools
backend/mcp_server/tools.py
Persistence and integrations
- PostgreSQL
backend/db/database.py
Other components
- Learner
- GitHub
- Gemini API
- Resume upload
Connections 29
- Learner → Web application: uses
- Web application → Courses and roadmaps: routes to
- Web application → Quiz experience: routes to
- Web application → AI Mentor: routes to
- Courses and roadmaps → API clients: requests data
- Quiz experience → API clients: requests quiz
- AI Mentor → API clients: sends chat
- API clients → FastAPI application: HTTP requests
- FastAPI application → Skill ingestion routes: dispatches
- FastAPI application → Roadmap and course routes: dispatches
- FastAPI application → Quiz routes: dispatches
- FastAPI application → Chat routes: dispatches
- FastAPI application → Progress routes: dispatches
- GitHub → Skill ingestion routes: OAuth and repository data
- Resume upload → Skill ingestion routes: uploads resume
- Skill ingestion routes → Skill synthesis: synthesizes skills
- Skill synthesis → PostgreSQL: stores skill profile
- Roadmap and course routes → Dynamic roadmaps: resolves course states
- Roadmap and course routes → Course ranking: ranks courses
- Dynamic roadmaps → PostgreSQL: reads progress and graph
- Quiz routes → Quiz generation and Elo: generates and scores
- Quiz generation and Elo → Gemini API: requests quiz content
- Quiz generation and Elo → PostgreSQL: reads and stores quizzes
- Progress routes → PostgreSQL: reads and writes progress
- Chat routes → Mentor context and tools: builds user context
- Chat routes → Mentor tool registry: dispatches tool calls
- Mentor tool registry → Mentor context and tools: dispatches tools
- Mentor context and tools → PostgreSQL: queries learning data
- Chat routes → Gemini API: sends prompt and tools