How subratad27/adaptiq works
AdaptIQ is a student learning platform with teacher question-bank and quiz tools, adaptive or random practice, BKT mastery tracking, and teacher/research analytics. Students sign in, receive concept-targeted questions, submit answers, and review mastery and history; teachers manage learning content and inspect class or study results. The graph separates the React experience, API routing, learning logic, analytics, and persistence. Some endpoint-to-page wiring is not visible in the excerpts, so those links are omitted rather than inferred.
Main entry points: main.py FastAPI app · models.py Domain models · database.py SQLite database · main.jsx App routes
Components 24
Web experience
- App routes
frontend/src/main.jsx - Login
frontend/src/pages/Login.jsx - Practice quiz
frontend/src/pages/StudentQuiz.jsx - Mastery map
frontend/src/pages/MasteryMap.jsx - Quiz history
frontend/src/pages/QuizHistory.jsx - Teacher dashboard
frontend/src/pages/TeacherDashboard.jsx - Research page
frontend/src/pages/Research.jsx - API client
frontend/src/api/client.js
API and access
- FastAPI app
backend/app/main.py - Authentication
backend/app/routers/auth_router.py - Question bank
backend/app/routers/questions_router.py - Quiz publishing
backend/app/routers/quizzes_router.py - Token and passwords
backend/app/auth.py - API schemas
backend/app/schemas.py
Learning engine
- Practice endpoints
backend/app/routers/quiz_router.py - BKT engine
backend/app/bkt.py - Concepts
backend/app/routers/concepts_router.py
Analytics and research
- Class analytics
backend/app/routers/analytics_router.py - Learner simulation
backend/app/simulation.py
Persistence
- Domain models
backend/app/models.py - SQLite database
backend/app/database.py - Startup seed
backend/app/seed.py
Other components
- Student
- Teacher
Connections 48
- Student → Login: signs in
README.md - Teacher → Login: signs in
README.md - App routes → Login: routes to
frontend/src/main.jsx - App routes → Practice quiz: routes to
frontend/src/main.jsx - App routes → Mastery map: routes to
frontend/src/main.jsx - App routes → Quiz history: routes to
frontend/src/main.jsx - App routes → Teacher dashboard: routes to
frontend/src/main.jsx - App routes → Research page: routes to
frontend/src/main.jsx - Login → API client: calls
frontend/src/pages/Login.jsx - Practice quiz → API client: calls
frontend/src/pages/StudentQuiz.jsx - Mastery map → API client: calls
frontend/src/pages/MasteryMap.jsx - Quiz history → API client: calls
frontend/src/pages/QuizHistory.jsx - Teacher dashboard → API client: calls
frontend/src/pages/TeacherDashboard.jsx - Research page → API client: calls
frontend/src/pages/Research.jsx - FastAPI app → Authentication: registers
backend/app/main.py - FastAPI app → Question bank: registers
backend/app/main.py - FastAPI app → Quiz publishing: registers
backend/app/main.py - FastAPI app → Practice endpoints: registers
backend/app/main.py - FastAPI app → Class analytics: registers
backend/app/main.py - FastAPI app → Concepts: registers
backend/app/main.py - FastAPI app → Startup seed: runs at startup
backend/app/main.py - FastAPI app → SQLite database: creates tables
backend/app/main.py - Authentication → Token and passwords: uses
backend/app/routers/auth_router.py - Authentication → SQLite database: reads and writes
backend/app/routers/auth_router.py - Authentication → Domain models: uses
backend/app/routers/auth_router.py - Authentication → API schemas: validates with
backend/app/routers/auth_router.py - Question bank → SQLite database: reads and writes
backend/app/routers/questions_router.py - Question bank → Domain models: uses
backend/app/routers/questions_router.py - Question bank → API schemas: validates with
backend/app/routers/questions_router.py - Quiz publishing → SQLite database: reads and writes
backend/app/routers/quizzes_router.py - Quiz publishing → Domain models: uses
backend/app/routers/quizzes_router.py - Quiz publishing → API schemas: validates with
backend/app/routers/quizzes_router.py - Practice endpoints → SQLite database: reads and writes
backend/app/routers/quiz_router.py - Practice endpoints → Domain models: uses
backend/app/routers/quiz_router.py - Practice endpoints → API schemas: validates with
backend/app/routers/quiz_router.py - Practice endpoints → BKT engine: selects and updates
backend/app/routers/quiz_router.py - Concepts → SQLite database: reads
backend/app/routers/concepts_router.py - Concepts → Domain models: uses
backend/app/routers/concepts_router.py - Class analytics → SQLite database: reads
backend/app/routers/analytics_router.py - Class analytics → Domain models: uses
backend/app/routers/analytics_router.py - Class analytics → Learner simulation: runs
backend/app/routers/analytics_router.py - Learner simulation → SQLite database: reads and writes
backend/app/simulation.py - Learner simulation → Domain models: uses
backend/app/simulation.py - Learner simulation → BKT engine: uses
backend/app/simulation.py - Startup seed → Domain models: populates
backend/app/seed.py - Domain models → SQLite database: defines mapped tables
backend/app/models.py - Student → Practice quiz: practices
README.md - Student → Mastery map: reviews mastery
README.md