How y23-hte-project-119/skillsense works
SkillSense is an adaptive learning and assessment platform. A learner browses skills and their topic hierarchy, takes a generated or existing assessment, receives scored results and subtopic gap analysis, then can use remediation and targeted retests to build mastery. The graph also includes skill administration, learning materials, and mastery tracking. Backend route wiring and assessment behavior are excerpted; other feature branches are retained from the README and file tree, with uncertain internal links left unasserted.
Main entry points: main.py FastAPI server · App.jsx React application · api.js API client · assessments.py Assessment routes
Components 27
Learner experience
- React application
frontend/src/App.jsx - API client
frontend/src/services/api.js - Skill browsing
frontend/src/pages/SkillDetails.jsx - Assessment taking
frontend/src/pages/Assessment.jsx - Results and gaps
frontend/src/pages/AssessmentResults.jsx - Gap analysis
frontend/src/pages/SkillGapAnalysis.jsx - Skill dashboard
frontend/src/pages/Dashboard.jsx
REST API
- FastAPI server
backend/app/main.py - Skill catalog routes
backend/app/routes/skills.py - Topic routes
backend/app/routes/topics.py - Subtopic routes
backend/app/routes/subtopics.py - Learning material routes
backend/app/routes/learning_materials.py - Question routes
backend/app/routes/questions.py - Assessment routes
backend/app/routes/assessments.py - Diagnosis routes
backend/app/routes/gap_analysis.py - Remediation routes
backend/app/routes/remediation.py - Retest and mastery routes
backend/app/routes/retest_mastery.py
Assessment services
- AI question generation
backend/app/services/ai_generator.py - Gap diagnosis
backend/app/services/gap_diagnosis.py - Weakness explanations
backend/app/services/weakness_explainer.py - Mastery and retests
backend/app/services/mastery_engine.py
Learning data
- Database sessions
backend/app/db/database.py - Learning domain models
backend/app/db/models - API schemas
backend/app/db/schemas
Other components
- Learner
- MySQL
- Google Gemini API
Connections 33
- Learner → React application: uses
- React application → Skill browsing: routes to
frontend/src/App.jsx - React application → Assessment taking: routes to
frontend/src/App.jsx - React application → Results and gaps: routes to
frontend/src/App.jsx - React application → Gap analysis: routes to
frontend/src/App.jsx - React application → Skill dashboard: routes to
frontend/src/App.jsx - Skill browsing → API client: requests data
frontend/src/pages/SkillDetails.jsx - Assessment taking → API client: submits answers
frontend/src/pages/Assessment.jsx - Gap analysis → API client: requests analysis
frontend/src/pages/SkillGapAnalysis.jsx - Skill dashboard → API client: requests skills
frontend/src/pages/Dashboard.jsx - API client → FastAPI server: calls REST API
- FastAPI server → Skill catalog routes: registers
backend/app/main.py - FastAPI server → Topic routes: registers
backend/app/main.py - FastAPI server → Subtopic routes: registers
backend/app/main.py - FastAPI server → Learning material routes: registers
backend/app/main.py - FastAPI server → Question routes: registers
backend/app/main.py - FastAPI server → Assessment routes: registers
backend/app/main.py - FastAPI server → Diagnosis routes: registers
backend/app/main.py - FastAPI server → Remediation routes: registers
backend/app/main.py - FastAPI server → Retest and mastery routes: registers
backend/app/main.py - Assessment routes → Database sessions: gets sessions
backend/app/routes/assessments.py - Assessment routes → Learning domain models: reads and writes
backend/app/routes/assessments.py - Question routes → AI question generation: generates questions
backend/app/routes/questions.py - AI question generation → Google Gemini API: requests generation
- Diagnosis routes → Gap diagnosis: evaluates gaps
- Remediation routes → Weakness explanations: requests explanations
- Retest and mastery routes → Mastery and retests: handles retests
- Mastery and retests → Gap diagnosis: evaluates gaps
backend/app/services/mastery_engine.py - Mastery and retests → AI question generation: generates retest questions
backend/app/services/mastery_engine.py - Database sessions → Learning domain models: creates tables
backend/app/db/database.py - Database sessions → MySQL: connects to
- Assessment routes → API schemas: validates and responds
backend/app/routes/assessments.py - Gap diagnosis → Learning domain models: reads assessment data
backend/app/services/gap_diagnosis.py