How shubbham-kumarr/intelligent-academic-test-system works
IATS is a source-grounded academic testing platform for students and educators. Users authenticate, provide or select learning material, take assessments, and review results; educators also manage students and use performance reporting. The repository documents adaptive tests, automated grading, analytics, and AI remediation, though the backend test controller and several related modules are absent from the supplied tree. Edges for those capabilities are therefore limited to documented API calls or marked unverified; sampled source confirms PDF ingestion and authentication details.
Main entry points: api.ts REST client · App.tsx Route application · auth_controller.py Auth controller · AuthContext.tsx Auth state
Components 24
User experience
- Route application
frontend/src/App.tsx - Learning home
frontend/src/pages/HomePage.tsx - Sign-in page
frontend/src/pages/AuthPage.tsx - Student dashboard
frontend/src/pages/DashboardPage.tsx - Assessment taking
frontend/src/pages/TestsPage.tsx - Student administration
frontend/src/pages/AdminStudentsPage.tsx - Concept remediation
frontend/src/components/ConceptRemediationCard.tsx
Identity and access
- Auth state
frontend/src/context/AuthContext.tsx - Authentication endpoints
backend/app/v1/routes/auth_route.py - Auth controller
backend/app/v1/controllers/auth_controller.py
Learning services
- Source upload route
backend/app/v1/routes/source_route.py - Source ingestion
backend/app/v1/controllers/source_controller.py - PDF extraction
backend/app/services/pdf_service.py - Academic agent
backend/app/services/agent_service/academic_agent.py - Test generation modes
backend/app/services/test_service - Groq client
backend/app/services/agent_service/groq_client.py
API and persistence
- User records
backend/app/models/user_model.py - User serialization
backend/app/schemas/user_schema.py - Admin serialization
backend/app/schemas/admin_schema.py - REST client
frontend/src/services/api.ts
Other components
- Student
- Educator
- Groq API
- Flask REST API
Connections 30
- Route application → Learning home: routes to
frontend/src/App.tsx - Route application → Sign-in page: routes to
frontend/src/App.tsx - Route application → Student dashboard: routes to
frontend/src/App.tsx - Route application → Assessment taking: routes to
frontend/src/App.tsx - Route application → Student administration: routes to
frontend/src/App.tsx - Route application → Auth state: provides auth
frontend/src/App.tsx - Student → Learning home: uses
- Student → Sign-in page: signs in
- Educator → Student administration: manages learners
- Sign-in page → Auth state: authenticates through
frontend/src/pages/AuthPage.tsx - Auth state → Flask REST API: requests profile
frontend/src/context/AuthContext.tsx - Auth state → Authentication endpoints: calls login
frontend/src/context/AuthContext.tsx - Authentication endpoints → Auth controller: dispatches to
backend/app/v1/routes/auth_route.py - Auth controller → User records: reads and writes
backend/app/v1/controllers/auth_controller.py - Auth controller → User serialization: serializes with
backend/app/v1/controllers/auth_controller.py - Auth controller → Admin serialization: serializes with
backend/app/v1/controllers/auth_controller.py - Learning home → REST client: requests learning data
frontend/src/pages/HomePage.tsx - Assessment taking → REST client: requests assessments
frontend/src/pages/TestsPage.tsx - Student dashboard → REST client: requests metrics
frontend/src/pages/DashboardPage.tsx - Student administration → REST client: requests student data
frontend/src/pages/AdminStudentsPage.tsx - REST client → Flask REST API: calls REST endpoints
frontend/src/services/api.ts - REST client → Source upload route: uploads source
frontend/src/services/api.ts - Source upload route → Source ingestion: dispatches to
backend/app/v1/routes/source_route.py - Source ingestion → PDF extraction: extracts PDF text
backend/app/v1/controllers/source_controller.py - REST client → Academic agent: requests test generation
- Academic agent → Test generation modes: uses test modes
backend/app/services/agent_service/academic_agent.py - Academic agent → Groq client: requests completions
backend/app/services/agent_service/academic_agent.py - Groq client → Groq API: sends completions
backend/app/services/agent_service/groq_client.py - Assessment taking → Concept remediation: renders feedback
frontend/src/pages/TestsPage.tsx - Concept remediation → REST client: requests explanation
frontend/src/services/api.ts