How thilagavathi-04/qp-generation works
Quest Generator is a teacher-facing exam workflow: manage syllabus and educational content, generate and curate questions, assemble papers from blueprints, and evaluate student submissions. The React application calls a FastAPI API; backend services handle parsing, retrieval, generation, image processing, paper creation, and grading, with MySQL and Qdrant providing persistent and vector storage. The README documents the end-to-end workflow; some service connections are therefore shown from that documentation where the sampled source does not expose the call site.
Main entry points: App.jsx Application routes · main.py REST endpoints · api.js REST client · database.py Relational database
Components 25
Teacher application
- Application routes
frontend/src/App.jsx - Subject management
frontend/src/pages/SubjectManagement.jsx - Question generation
frontend/src/pages/QuestionGeneration.jsx - Question bank
frontend/src/pages/QuestionBank.jsx - Blueprint management
frontend/src/pages/BlueprintManagement.jsx - Paper generation
frontend/src/pages/QuestionPaperGeneration.jsx - Grading dashboard
frontend/src/pages/GradingDashboard.jsx - Evaluation results
frontend/src/pages/EvaluationResults.jsx - REST client
frontend/src/utils/api.js
API and content
- REST endpoints
backend/main.py - Syllabus parsing
backend/utils/syllabus_parser.py - Blueprint repository
backend/services/blueprint_repository.py
Generation and retrieval
- Question generation
backend/services/question_generator.py - RAG retrieval
backend/services/rag_retrieval.py - RAG indexing
backend/services/rag_ingestion.py - Vector search
backend/services/qdrant_client.py - Image processing
backend/services/image_extractor.py - Image lookup
backend/services/image_integration.py
Papers and assessment
- Paper assembly
backend/services/paper_generator.py - Answer evaluation
backend/services/grading_engine.py
Persistence
- Relational database
backend/core/database.py - Vector database
Other components
- Teacher or student
- LLM providers
- Uploaded files
Connections 38
- Teacher or student → Application routes: uses
- Application routes → Subject management: routes to
frontend/src/App.jsx - Application routes → Question generation: routes to
frontend/src/App.jsx - Application routes → Question bank: routes to
frontend/src/App.jsx - Application routes → Blueprint management: routes to
frontend/src/App.jsx - Application routes → Paper generation: routes to
frontend/src/App.jsx - Application routes → Grading dashboard: routes to
frontend/src/App.jsx - Application routes → Evaluation results: routes to
frontend/src/App.jsx - Subject management → REST client: calls
frontend/src/utils/api.js - Question generation → REST client: calls
frontend/src/pages/QuestionGeneration.jsx - Question bank → REST client: calls
frontend/src/pages/QuestionBank.jsx - Blueprint management → REST client: calls
- Paper generation → REST client: calls
frontend/src/pages/QuestionPaperGeneration.jsx - Grading dashboard → REST client: calls
frontend/src/pages/GradingDashboard.jsx - Evaluation results → REST client: calls
- REST client → REST endpoints: HTTP requests
- REST endpoints → Syllabus parsing: parses uploads
backend/main.py - REST endpoints → Blueprint repository: manages blueprints
backend/main.py - REST endpoints → Question generation: generates questions
backend/main.py - REST endpoints → RAG retrieval: retrieves context
backend/main.py - REST endpoints → Paper assembly: builds papers
backend/main.py - REST endpoints → Answer evaluation: evaluates submissions
backend/main.py - REST endpoints → Image processing: processes documents
backend/main.py - Question generation → RAG retrieval: retrieves context
- Question generation → LLM providers: requests generation
- Answer evaluation → LLM providers: requests evaluation
- RAG indexing → Vector search: indexes chunks
backend/services/qdrant_client.py - RAG retrieval → Vector search: searches vectors
backend/services/rag_retrieval.py - Vector search → Vector database: stores vectors
backend/services/qdrant_client.py - Syllabus parsing → Relational database: saves parsed data
backend/utils/syllabus_parser.py - Blueprint repository → Relational database: reads and writes
backend/services/blueprint_repository.py - Paper assembly → Relational database: loads questions
backend/services/paper_generator.py - Paper assembly → Image lookup: integrates images
backend/services/paper_generator.py - Image processing → Image lookup: provides images
backend/services/image_extractor.py - Image lookup → Relational database: looks up images
- Image processing → Uploaded files: extracts files
- Paper assembly → Uploaded files: writes papers
- Answer evaluation → Relational database: stores results