How techbypradnya/skillmaps-ai works
SkillGraph AI is an adaptive learning platform: learners create a profile and choose a target role, then explore a skill graph, assess proficiency, and receive gap analysis and an adaptive learning path. The platform also offers recommendations, progress dashboards, feedback, what-if planning, and an AI companion. The graph shows the backend route-to-service structure where source references support it. Frontend-to-backend calls are not evidenced in the excerpts, so those links are marked unverified.
Main entry points: misc_routes.py Learning feature routes · path_optimizer.py Adaptive path planning · main.py FastAPI application · api.ts Frontend API client
Components 31
Learner experience
- Sign in and signup
frontend/app/login/page.tsx - Profile onboarding
frontend/app/onboarding/page.tsx - Learning workspace
frontend/app/my-path/page.tsx - Assessment screen
frontend/app/assessment/page.tsx - Progress dashboard
frontend/app/dashboard/page.tsx - AI companion
frontend/app/companion/page.tsx - Frontend API client
frontend/lib/api.ts
API and identity
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/api/routes/auth_routes.py - Profile routes
backend/app/api/routes/profile.py - Skill graph routes
backend/app/api/routes/skill_graph_routes.py - Learning path routes
backend/app/api/routes/path_routes.py - Learning feature routes
backend/app/api/routes/misc_routes.py
Learning intelligence
- Learner profiling
backend/app/services/profiler.py - Skill graph engine
backend/app/services/skill_graph.py - Gap analysis
backend/app/services/gap_analyzer.py - Assessment engine
backend/app/services/assessment.py - Adaptive path planning
backend/app/services/path_optimizer.py - Resource recommendations
backend/app/services/recommendation.py - Readiness and dashboard
backend/app/services/dashboard.py - Companion chat
backend/app/services/companion.py - Scenario simulation
backend/app/services/what_if.py - Learning feedback
backend/app/services/feedback.py - Journey explanations
backend/app/services/explanation.py
Domain data
- Domain models
backend/app/models/models.py - Curated learning catalog
backend/app/data/seed_data.py - Database seeding
backend/app/db/seed.py - Database sessions
backend/app/db/session.py - Relational database
AI integration
- LLM provider
backend/app/services/llm_provider.py
Other components
- Learner
Connections 48
- Learner → Sign in and signup: signs in
- Learner → Profile onboarding: sets goals
- Learner → Learning workspace: learns
- Learner → Assessment screen: takes assessment
- Learner → Progress dashboard: checks progress
- Learner → AI companion: asks questions
- Sign in and signup → Frontend API client: uses
- Profile onboarding → Frontend API client: uses
- Learning workspace → Frontend API client: uses
- Assessment screen → Frontend API client: uses
- Progress dashboard → Frontend API client: uses
- AI companion → Frontend API client: uses
- Frontend API client → FastAPI application: calls API
- FastAPI application → Authentication routes: registers
backend/app/main.py - FastAPI application → Profile routes: registers
backend/app/main.py - FastAPI application → Skill graph routes: registers
backend/app/main.py - FastAPI application → Learning path routes: registers
backend/app/main.py - FastAPI application → Learning feature routes: registers
backend/app/main.py - FastAPI application → Database seeding: seeds on startup
backend/app/main.py - Authentication routes → Domain models: queries users
backend/app/api/routes/auth_routes.py - Authentication routes → Database sessions: gets sessions
backend/app/api/routes/auth_routes.py - Authentication routes → Learner profiling: uses security
- Profile routes → Learner profiling: profiles learners
backend/app/api/routes/profile.py - Profile routes → Domain models: queries profiles
backend/app/api/routes/profile.py - Skill graph routes → Skill graph engine: builds graph
backend/app/api/routes/skill_graph_routes.py - Skill graph routes → Gap analysis: analyzes gaps
backend/app/api/routes/skill_graph_routes.py - Learning path routes → Adaptive path planning: plans paths
backend/app/api/routes/path_routes.py - Learning feature routes → Assessment engine: generates and scores
backend/app/api/routes/misc_routes.py - Learning feature routes → Adaptive path planning: replans path
backend/app/api/routes/misc_routes.py - Learning feature routes → Resource recommendations: scores resources
backend/app/api/routes/misc_routes.py - Learning feature routes → Learning feedback: records feedback
backend/app/api/routes/misc_routes.py - Learning feature routes → Scenario simulation: simulates scenario
backend/app/api/routes/misc_routes.py - Learning feature routes → Companion chat: handles chat
backend/app/api/routes/misc_routes.py - Learning feature routes → Journey explanations: explains journey
backend/app/api/routes/misc_routes.py - Learning feature routes → Readiness and dashboard: builds dashboard
backend/app/api/routes/misc_routes.py - Assessment engine → LLM provider: generates text
backend/app/services/assessment.py - Companion chat → LLM provider: generates replies
backend/app/services/companion.py - Gap analysis → Skill graph engine: uses graph
backend/app/services/gap_analyzer.py - Adaptive path planning → Gap analysis: uses gap analysis
backend/app/services/path_optimizer.py - Adaptive path planning → Resource recommendations: selects resources
backend/app/services/path_optimizer.py - Adaptive path planning → Skill graph engine: orders skills
backend/app/services/path_optimizer.py - Readiness and dashboard → Gap analysis: uses gaps
backend/app/services/dashboard.py - Readiness and dashboard → Adaptive path planning: reads active path
backend/app/services/dashboard.py - Readiness and dashboard → Resource recommendations: uses recommendations
backend/app/services/dashboard.py - Companion chat → Gap analysis: uses learner gaps
backend/app/services/companion.py - Companion chat → Adaptive path planning: uses learner path
backend/app/services/companion.py - Journey explanations → Gap analysis: uses gaps
backend/app/services/explanation.py - Journey explanations → Adaptive path planning: uses path
backend/app/services/explanation.py