How harine77/examination_workflow_qp_management_system works
This is a role-based examination and question-paper workflow: faculty prepare and submit papers, successive reviewers and a panel evaluate them, and the HOD gives final approval or returns finalized papers. The React application provides role-specific screens; Express routes enforce workflow and access rules, with PostgreSQL-backed models and services for mapping, PDF work, and answer-key generation. The README documents capabilities such as scheduling, secure release, audit logging, and notifications, but sampled excerpts do not establish every implementation link or storage detail.
Main entry points: App.jsx Role-based routes · api.js HTTP API client · questionRoutes.js Paper and question API · QuestionPaper.js Question papers
Components 28
Web application
- Role-based routes
frontend/src/App.jsx - Paper authoring
frontend/src/components/QuestionPaperCreator.jsx - AI paper creation
frontend/src/pages/AICreatePaper.jsx - Scrutinizer review
frontend/src/pages/Scrutinizerdashboard.jsx - Paper viewing
frontend/src/pages/PaperView.jsx - HOD workflow screens
frontend/src/pages/HODDashboardV2.jsx - Panel review screens
frontend/src/pages/PanelPapers.jsx - HTTP API client
frontend/src/services/api.js
Paper workflow
- Paper and question API
backend/routes/questionRoutes.js - Scrutinizer workflow API
backend/routes/ScrutinizerRoutes.js - HOD workflow API
backend/routes/hodRoutes.js
Analysis and outputs
- AI generation API
backend/routes/aiGenerateRoutes.js - PDF API
backend/routes/pdfRoutes.js - CO and level mapping
backend/services/nlpService.js - Answer-key generation
backend/services/ollamaAnswerKeyService.js - PDF processing
backend/services/pdfService.js
Identity and access
- Client auth state
frontend/src/context/authContext.jsx - Authentication routes
backend/routes/authRoutes.js - JWT and role guards
backend/middleware/authMiddleware.js
Persistence
- Question papers
backend/models/QuestionPaper.js - Questions
backend/models/Question.js - Courses and outcomes
backend/models/CourseOutcome.js - User records
backend/models/user.js
Other components
- Faculty / setter
- Reviewers and panel
- HOD / administrator
- PostgreSQL
- Ollama model service
Connections 36
- Faculty / setter → Role-based routes: uses
README.md - Reviewers and panel → Role-based routes: uses
README.md - HOD / administrator → Role-based routes: uses
README.md - Role-based routes → Client auth state: provides auth
frontend/src/App.jsx - Role-based routes → Paper authoring: routes to
frontend/src/App.jsx - Role-based routes → AI paper creation: routes to
frontend/src/App.jsx - Role-based routes → Scrutinizer review: routes to
frontend/src/App.jsx - Role-based routes → Paper viewing: routes to
frontend/src/App.jsx - Role-based routes → HOD workflow screens: routes to
frontend/src/App.jsx - Role-based routes → Panel review screens: routes to
frontend/src/App.jsx - Client auth state → Authentication routes: authenticates via
frontend/src/context/authContext.jsx - Paper authoring → HTTP API client: submits requests
- AI paper creation → HTTP API client: sends requests
frontend/src/pages/AICreatePaper.jsx - Scrutinizer review → HTTP API client: sends requests
frontend/src/pages/Scrutinizerdashboard.jsx - HOD workflow screens → HTTP API client: sends requests
frontend/src/pages/HODDashboardV2.jsx - Panel review screens → HTTP API client: sends requests
- HTTP API client → Paper and question API: calls API
- Authentication routes → User records: uses accounts
backend/routes/authRoutes.js - Paper and question API → JWT and role guards: applies access
backend/routes/questionRoutes.js - Scrutinizer workflow API → JWT and role guards: applies access
backend/routes/ScrutinizerRoutes.js - HOD workflow API → JWT and role guards: applies access
backend/routes/hodRoutes.js - Paper and question API → Question papers: reads and updates
backend/routes/questionRoutes.js - Paper and question API → Questions: stores questions
backend/routes/questionRoutes.js - Paper and question API → CO and level mapping: analyzes questions
backend/routes/questionRoutes.js - Scrutinizer workflow API → Question papers: advances review
backend/routes/ScrutinizerRoutes.js - HOD workflow API → Question papers: finalizes papers
backend/routes/hodRoutes.js - HOD workflow API → Answer-key generation: generates key
backend/routes/hodRoutes.js - AI generation API → JWT and role guards: applies access
backend/routes/aiGenerateRoutes.js - PDF API → PDF processing: delegates PDF work
backend/routes/pdfRoutes.js - PDF API → Question papers: loads paper data
backend/routes/pdfRoutes.js - CO and level mapping → Courses and outcomes: uses outcomes
backend/services/nlpService.js - Answer-key generation → Ollama model service: requests generation
- Question papers → PostgreSQL: persists through ORM
- Questions → PostgreSQL: persists through ORM
- Courses and outcomes → PostgreSQL: persists through ORM
- User records → PostgreSQL: persists through ORM