How edric2412/q-a works
This is an AI assessment and adaptive-learning product: faculty create and export question papers, grade student submissions, and review analytics; students review results and practice through an adaptive tutor. The frontend is a set of role-specific pages backed by a FastAPI application, PostgreSQL, and a Neo4j syllabus graph. The README documents additional exports, analytics, OCR, and tutoring capabilities that are not fully visible in the sampled code; those branches are represented at subsystem level. Arrows follow shown calls or documented workflows; unsampled internal details are omitted.
Main entry points: api.ts API client · page.tsx Faculty dashboard · main.py FastAPI application · learning.py Tutor session routes
Components 22
Web experience
- Sign in
frontend/app/page.tsx - Faculty dashboard
frontend/app/dashboard/page.tsx - Paper generator
frontend/app/generator/page.tsx - Saved paper view
frontend/app/paper/[id]/page.tsx - Evaluation setup
frontend/app/evaluate/page.tsx - Exam results
frontend/app/results/[exam_id]/page.tsx - Performance analytics
frontend/app/visualizations/[exam_id]/page.tsx - Student dashboard
frontend/app/student-dashboard/page.tsx - Learning interface
frontend/app/learning/page.tsx - API client
frontend/lib/api.ts
Assessment workflows
- FastAPI application
backend/app/main.py - Question generation
backend/app/services/question_generator.py - Answer evaluation
backend/app/routers/evaluator.py - PDF vision grading
backend/app/utils/vision_utils.py
Adaptive learning
- Tutor session routes
backend/app/routers/learning.py - Topic selection
backend/app/services/rl_agent.py - Prerequisite reasoning
backend/app/services/graph_service.py
Persistence and graphs
- PostgreSQL
backend/app/core/database.py - Syllabus knowledge graph
Other components
- Faculty
- Student
- Google Gemini
Connections 30
- Faculty → Sign in: signs in
frontend/app/page.tsx - Student → Sign in: signs in
frontend/app/page.tsx - Sign in → API client: authenticates via
frontend/app/page.tsx - Faculty → Faculty dashboard: manages assessments
- Faculty dashboard → Paper generator: opens generator
frontend/app/dashboard/page.tsx - Paper generator → API client: requests generation
frontend/app/generator/page.tsx - API client → FastAPI application: calls API
- FastAPI application → Question generation: generates questions
backend/app/main.py - Question generation → Google Gemini: generates with
- Question generation → Syllabus knowledge graph: syncs prerequisites
backend/app/services/question_generator.py - FastAPI application → PostgreSQL: reads and writes
backend/app/main.py - Faculty dashboard → Evaluation setup: opens evaluator
- Evaluation setup → API client: uploads submissions
frontend/app/evaluate/page.tsx - FastAPI application → Answer evaluation: routes evaluation
backend/app/main.py - Answer evaluation → PostgreSQL: stores evaluations
backend/app/routers/evaluator.py - Answer evaluation → PDF vision grading: grades scanned PDFs
backend/app/routers/evaluator.py - Answer evaluation → Google Gemini: grades with AI
- Student → Student dashboard: reviews progress
- Student dashboard → API client: loads evaluations
frontend/app/student-dashboard/page.tsx - Faculty dashboard → Exam results: reviews results
- Faculty dashboard → Performance analytics: opens analytics
- Student → Learning interface: practices topics
- Learning interface → API client: requests tutor session
- FastAPI application → Tutor session routes: mounts tutor routes
backend/app/main.py - Tutor session routes → PostgreSQL: tracks mastery
backend/app/routers/learning.py - Tutor session routes → Topic selection: selects topic
backend/app/routers/learning.py - Tutor session routes → Prerequisite reasoning: gets graph context
backend/app/routers/learning.py - Prerequisite reasoning → Syllabus knowledge graph: queries prerequisites
backend/app/services/graph_service.py - Prerequisite reasoning → PostgreSQL: checks mastery
backend/app/services/graph_service.py - Tutor session routes → Google Gemini: evaluates answers