How coe26-qp/question-paper-automation works
This is a question-paper automation system with separate exam-cell and external-faculty interfaces, an Express/MongoDB backend, and a Python service. The main workflow is exam-cell staff uploading and assigning a question bank, faculty reviewing or adding questions, and generating, previewing, and exporting patterned papers. The graph preserves those distinct stages and the question-bank, external-question, and paper state layers. Some routes and integrations are unsampled; their connections are omitted where the available excerpts and index do not establish them.
Main entry points: src/App.jsx Faculty routes · questionBankController.js Bank management · externalQuestionBankController.js External bank handling · src/App.jsx Exam-cell routes
Components 22
Exam-cell interface
- Exam-cell routes
frontend/exam-cell-frontend/src/App.jsx - Upload bank
frontend/exam-cell-frontend/src/pages/UploadQuestionBank.jsx - Paper preview
frontend/exam-cell-frontend/src/components/ExamCellPaperPreview.jsx
Faculty interface
- Faculty routes
frontend/external-frontend/src/App.jsx - Bank review
frontend/external-frontend/src/pages/ExternalQuestionBank.jsx - Add question
frontend/external-frontend/src/pages/AddQuestion.jsx - Paper preview
frontend/external-frontend/src/pages/GeneratedQuestionPaperPreview.jsx - Pattern sections
frontend/external-frontend/src/components/R24/IA1PartAGeneratedSection.jsx
Backend API
- API router
backend/src/app.js - Bank routes
backend/src/routes/questionBankRoutes.js - Bank management
backend/src/controllers/questionBankController.js - External bank routes
backend/src/routes/externalQuestionBankRoutes.js - External bank handling
backend/src/controllers/externalQuestionBankController.js - Question preview
backend/src/controllers/externalQuestionPreviewController.js
Paper generation
- Paper orchestration
backend/src/controllers/paperGenerationController.js - Pattern generators
backend/src/services/R24/IA1paperGenerationService.js
Domain data
- Question bank
backend/src/models/QuestionBank.js - External questions
backend/src/models/ExternalQuestion.js - Faculty access
backend/src/models/ExternalAccess.js - Generated papers
backend/src/models/QuestionPaper.js
Other components
- Exam-cell staff
- External faculty
Connections 23
- Exam-cell staff → Exam-cell routes: uses
frontend/exam-cell-frontend/src/App.jsx - Exam-cell routes → Upload bank: routes to
frontend/exam-cell-frontend/src/App.jsx - Exam-cell routes → Paper preview: routes to
frontend/exam-cell-frontend/src/App.jsx - External faculty → Faculty routes: uses
frontend/external-frontend/src/App.jsx - Faculty routes → Bank review: routes to
frontend/external-frontend/src/App.jsx - Faculty routes → Add question: routes to
frontend/external-frontend/src/App.jsx - Faculty routes → Paper preview: routes to
frontend/external-frontend/src/App.jsx - Paper preview → Pattern sections: renders
frontend/external-frontend/src/pages/GeneratedQuestionPaperPreview.jsx - API router → Bank routes: mounts
backend/src/app.js - Bank routes → Bank management: dispatches
backend/src/routes/questionBankRoutes.js - API router → External bank routes: mounts
backend/src/app.js - External bank routes → External bank handling: dispatches
backend/src/routes/externalQuestionBankRoutes.js - Bank management → Question bank: reads/writes
backend/src/controllers/questionBankController.js - Bank management → Faculty access: creates
backend/src/controllers/questionBankController.js - Bank management → Generated papers: reads
backend/src/controllers/questionBankController.js - External bank handling → Faculty access: reads
backend/src/controllers/externalQuestionBankController.js - External bank handling → Question bank: reads
backend/src/controllers/externalQuestionBankController.js - External bank handling → External questions: uses
backend/src/controllers/externalQuestionBankController.js - Question preview → Faculty access: reads
backend/src/controllers/externalQuestionPreviewController.js - Question preview → Question bank: reads
backend/src/controllers/externalQuestionPreviewController.js - Paper orchestration → Pattern generators: invokes
backend/src/controllers/paperGenerationController.js - Paper orchestration → Generated papers: reads/writes
backend/src/controllers/paperGenerationController.js - Pattern generators → External questions: reads
backend/src/services/R24/IA1paperGenerationService.js