# thilagavathi-04/qp-generation architecture

> Architecture diagram of the GitHub repository thilagavathi-04/qp-generation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thilagavathi-04/qp-generation
- Repository: https://github.com/thilagavathi-04/qp-generation

## Overview

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: [`frontend/src/App.jsx`](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/App.jsx) (Application routes), [`backend/main.py`](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/main.py) (REST endpoints), [`frontend/src/utils/api.js`](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/utils/api.js) (REST client), [`backend/core/database.py`](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/core/database.py) (Relational database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Teacher application"]
  node_app["Application routes<br/>[App.jsx]"]
  node_content_ui["Subject management"]
  node_generation_ui["Question generation"]
  node_bank_ui["Question bank<br/>[QuestionBank.jsx]"]
  node_blueprint_ui["Blueprint management"]
  node_paper_ui["Paper generation"]
  node_grading_ui["Grading dashboard"]
  node_results_ui["Evaluation results"]
  node_api_client["REST client<br/>[api.js]"]
end

subgraph group_api["API and content"]
  node_fastapi["REST endpoints<br/>[main.py]"]
  node_syllabus["Syllabus parsing<br/>[syllabus_parser.py]"]
  node_blueprints["Blueprint repository"]
end

subgraph group_generation["Generation and retrieval"]
  node_question_gen["Question generation"]
  node_rag_retrieval["RAG retrieval<br/>[rag_retrieval.py]"]
  node_rag_index["RAG indexing<br/>[rag_ingestion.py]"]
  node_vectors["Vector search<br/>[qdrant_client.py]"]
  node_image_processing["Image processing<br/>[image_extractor.py]"]
  node_image_lookup["Image lookup"]
end

subgraph group_assessment["Papers and assessment"]
  node_paper_gen["Paper assembly<br/>[paper_generator.py]"]
  node_grading["Answer evaluation<br/>[grading_engine.py]"]
end

subgraph group_storage["Persistence"]
  node_mysql[("Relational database<br/>[database.py]")]
  node_qdrant[("Vector database")]
end

node_teacher(("Teacher or student"))
node_ai_provider["LLM providers"]
node_filesystem[("Uploaded files")]

node_teacher -->|"uses"| node_app
node_app -->|"routes to"| node_content_ui
node_app -->|"routes to"| node_generation_ui
node_app -->|"routes to"| node_bank_ui
node_app -->|"routes to"| node_blueprint_ui
node_app -->|"routes to"| node_paper_ui
node_app -->|"routes to"| node_grading_ui
node_app -->|"routes to"| node_results_ui
node_content_ui -->|"calls"| node_api_client
node_generation_ui -->|"calls"| node_api_client
node_bank_ui -->|"calls"| node_api_client
node_blueprint_ui -.->|"calls"| node_api_client
node_paper_ui -->|"calls"| node_api_client
node_grading_ui -->|"calls"| node_api_client
node_results_ui -.->|"calls"| node_api_client
node_api_client -->|"HTTP requests"| node_fastapi
node_fastapi -->|"parses uploads"| node_syllabus
node_fastapi -->|"manages blueprints"| node_blueprints
node_fastapi -->|"generates questions"| node_question_gen
node_fastapi -->|"retrieves context"| node_rag_retrieval
node_fastapi -->|"builds papers"| node_paper_gen
node_fastapi -->|"evaluates submissions"| node_grading
node_fastapi -.->|"processes documents"| node_image_processing
node_question_gen -->|"retrieves context"| node_rag_retrieval
node_question_gen -->|"requests generation"| node_ai_provider
node_grading -->|"requests evaluation"| node_ai_provider
node_rag_index -->|"indexes chunks"| node_vectors
node_rag_retrieval -->|"searches vectors"| node_vectors
node_vectors -->|"stores vectors"| node_qdrant
node_syllabus -->|"saves parsed data"| node_mysql
node_blueprints -->|"reads and writes"| node_mysql
node_paper_gen -->|"loads questions"| node_mysql
node_paper_gen -->|"integrates images"| node_image_lookup
node_image_processing -.->|"provides images"| node_image_lookup
node_image_lookup -.->|"looks up images"| node_mysql
node_image_processing -->|"extracts files"| node_filesystem
node_paper_gen -->|"writes papers"| node_filesystem
node_grading -->|"stores results"| node_mysql

click node_app "https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/App.jsx"
click node_content_ui "https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/SubjectManagement.jsx"
click node_generation_ui "https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/QuestionGeneration.jsx"
click node_bank_ui "https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/QuestionBank.jsx"
click node_blueprint_ui "https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/BlueprintManagement.jsx"
click node_paper_ui "https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/QuestionPaperGeneration.jsx"
click node_grading_ui "https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/GradingDashboard.jsx"
click node_results_ui "https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/EvaluationResults.jsx"
click node_api_client "https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/utils/api.js"
click node_fastapi "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/main.py"
click node_syllabus "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/utils/syllabus_parser.py"
click node_blueprints "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/blueprint_repository.py"
click node_question_gen "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/question_generator.py"
click node_rag_retrieval "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/rag_retrieval.py"
click node_rag_index "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/rag_ingestion.py"
click node_vectors "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/qdrant_client.py"
click node_image_processing "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/image_extractor.py"
click node_image_lookup "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/image_integration.py"
click node_paper_gen "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/paper_generator.py"
click node_grading "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/grading_engine.py"
click node_mysql "https://github.com/thilagavathi-04/qp-generation/blob/main/backend/core/database.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_content_ui,node_generation_ui,node_bank_ui,node_blueprint_ui,node_paper_ui,node_grading_ui,node_results_ui,node_api_client toneBlue
class node_fastapi,node_syllabus,node_blueprints,node_filesystem toneAmber
class node_question_gen,node_rag_retrieval,node_rag_index,node_vectors,node_image_processing,node_image_lookup toneMint
class node_paper_gen,node_grading toneRose
class node_mysql,node_qdrant,node_teacher,node_ai_provider toneIndigo
```

## Components

### Teacher application

- [Application routes](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Subject management](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/SubjectManagement.jsx): `frontend/src/pages/SubjectManagement.jsx`
- [Question generation](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/QuestionGeneration.jsx): `frontend/src/pages/QuestionGeneration.jsx`
- [Question bank](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/QuestionBank.jsx): `frontend/src/pages/QuestionBank.jsx`
- [Blueprint management](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/BlueprintManagement.jsx): `frontend/src/pages/BlueprintManagement.jsx`
- [Paper generation](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/QuestionPaperGeneration.jsx): `frontend/src/pages/QuestionPaperGeneration.jsx`
- [Grading dashboard](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/GradingDashboard.jsx): `frontend/src/pages/GradingDashboard.jsx`
- [Evaluation results](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/pages/EvaluationResults.jsx): `frontend/src/pages/EvaluationResults.jsx`
- [REST client](https://github.com/thilagavathi-04/qp-generation/blob/main/frontend/src/utils/api.js): `frontend/src/utils/api.js`

### API and content

- [REST endpoints](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/main.py): `backend/main.py`
- [Syllabus parsing](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/utils/syllabus_parser.py): `backend/utils/syllabus_parser.py`
- [Blueprint repository](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/blueprint_repository.py): `backend/services/blueprint_repository.py`

### Generation and retrieval

- [Question generation](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/question_generator.py): `backend/services/question_generator.py`
- [RAG retrieval](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/rag_retrieval.py): `backend/services/rag_retrieval.py`
- [RAG indexing](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/rag_ingestion.py): `backend/services/rag_ingestion.py`
- [Vector search](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/qdrant_client.py): `backend/services/qdrant_client.py`
- [Image processing](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/image_extractor.py): `backend/services/image_extractor.py`
- [Image lookup](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/image_integration.py): `backend/services/image_integration.py`

### Papers and assessment

- [Paper assembly](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/paper_generator.py): `backend/services/paper_generator.py`
- [Answer evaluation](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/services/grading_engine.py): `backend/services/grading_engine.py`

### Persistence

- [Relational database](https://github.com/thilagavathi-04/qp-generation/blob/main/backend/core/database.py): `backend/core/database.py`
- **Vector database**

### Other components

- **Teacher or student**
- **LLM providers**
- **Uploaded files**

## Connections

- Teacher or student → Application routes: uses
- Application routes → Subject management: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Question generation: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Question bank: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Blueprint management: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Paper generation: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Grading dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Evaluation results: routes to (evidence: `frontend/src/App.jsx`)
- Subject management → REST client: calls (evidence: `frontend/src/utils/api.js`)
- Question generation → REST client: calls (evidence: `frontend/src/pages/QuestionGeneration.jsx`)
- Question bank → REST client: calls (evidence: `frontend/src/pages/QuestionBank.jsx`)
- Blueprint management → REST client: calls
- Paper generation → REST client: calls (evidence: `frontend/src/pages/QuestionPaperGeneration.jsx`)
- Grading dashboard → REST client: calls (evidence: `frontend/src/pages/GradingDashboard.jsx`)
- Evaluation results → REST client: calls
- REST client → REST endpoints: HTTP requests
- REST endpoints → Syllabus parsing: parses uploads (evidence: `backend/main.py`)
- REST endpoints → Blueprint repository: manages blueprints (evidence: `backend/main.py`)
- REST endpoints → Question generation: generates questions (evidence: `backend/main.py`)
- REST endpoints → RAG retrieval: retrieves context (evidence: `backend/main.py`)
- REST endpoints → Paper assembly: builds papers (evidence: `backend/main.py`)
- REST endpoints → Answer evaluation: evaluates submissions (evidence: `backend/main.py`)
- REST endpoints → Image processing: processes documents (evidence: `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 (evidence: `backend/services/qdrant_client.py`)
- RAG retrieval → Vector search: searches vectors (evidence: `backend/services/rag_retrieval.py`)
- Vector search → Vector database: stores vectors (evidence: `backend/services/qdrant_client.py`)
- Syllabus parsing → Relational database: saves parsed data (evidence: `backend/utils/syllabus_parser.py`)
- Blueprint repository → Relational database: reads and writes (evidence: `backend/services/blueprint_repository.py`)
- Paper assembly → Relational database: loads questions (evidence: `backend/services/paper_generator.py`)
- Paper assembly → Image lookup: integrates images (evidence: `backend/services/paper_generator.py`)
- Image processing → Image lookup: provides images (evidence: `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
