How shirodkarfalashree/favproct works
FAVPROCT is a multi-organization assessment platform. Users enter through the role-aware web app: administrators manage question banks, create exams, and allot them; students take allotted exams; teachers evaluate submissions and review results. The backend exposes API routes for these operations and persists organization, user, exam, cohort, and attempt data. The graph preserves the major role-specific product areas visible in the file tree; some page-to-API relationships are shown as unverified because the excerpts do not expose those calls.
Main entry points: app.js API application · App.jsx Role-based routing · api.js API client · admin.controller.js Admin management
Components 28
Web application
- Role-based routing
Frontend/src/App.jsx - Session state
Frontend/src/context/AuthContext.jsx - API client
Frontend/src/services/api.js - Landing and signup
Frontend/src/pages/LandingPage.jsx - Admin workspace
Frontend/src/pages/admin/ExamCreation.jsx - Question bank UI
Frontend/src/pages/admin/QuestionBank.jsx - Student exam portal
Frontend/src/pages/student/ExamPortal.jsx - Teacher evaluation
Frontend/src/pages/teacher/EvaluateExam.jsx - Superadmin workspace
Frontend/src/pages/superadmin/SuperAdminDashboard.jsx
Assessment workflows
- API application
Backend/src/app.js - Exam generation and allotment
Backend/src/controllers/generateExam.controller.js - Student attempt and grading
Backend/src/controllers/studentExam.controller.js - Admin management
Backend/src/controllers/admin.controller.js - Question bank management
Backend/src/controllers/questionBank.controller.js - Cohort management
Backend/src/controllers/cohort.controller.js
Organization and access
- Authentication
Backend/src/controllers/auth.controller.js - Organization provisioning
Backend/src/routes/organization.routes.js
Persistence and integrations
- User records
Backend/src/models/User.js - Generated exams
Backend/src/models/GeneratedExam.js - Student exam records
Backend/src/models/StudentExam.js - Cohort records
Backend/src/models/Cohort.js - Organization records
Backend/src/models/Organization.js - Question bank records
Backend/src/models/Questionbank.js - Email delivery
Backend/src/utils/emailService.js
Other components
- Users
- HTTP API
- MongoDB
- SMTP service
Connections 46
- Users → Role-based routing: open app
Frontend/src/App.jsx - Role-based routing → Landing and signup: routes to
Frontend/src/App.jsx - Role-based routing → Admin workspace: routes to
Frontend/src/App.jsx - Role-based routing → Student exam portal: routes to
Frontend/src/App.jsx - Role-based routing → Teacher evaluation: routes to
Frontend/src/App.jsx - Role-based routing → Superadmin workspace: routes to
Frontend/src/App.jsx - Role-based routing → Session state: provides session
Frontend/src/App.jsx - Landing and signup → Session state: uses session
Frontend/src/pages/LandingPage.jsx - Session state → API client: sends auth requests
Frontend/src/context/AuthContext.jsx - Admin workspace → API client: calls API
Frontend/src/pages/admin/ExamCreation.jsx - Question bank UI → API client: calls API
Frontend/src/pages/admin/QuestionBank.jsx - Student exam portal → API client: calls API
Frontend/src/pages/student/ExamPortal.jsx - Teacher evaluation → API client: calls API
Frontend/src/pages/teacher/EvaluateExam.jsx - Superadmin workspace → API client: calls API
Frontend/src/pages/superadmin/SuperAdminDashboard.jsx - API client → HTTP API: sends requests
- HTTP API → API application: routes requests
- API application → Authentication: mounts routes
Backend/src/app.js - API application → Organization provisioning: mounts routes
Backend/src/app.js - API application → Question bank management: mounts routes
Backend/src/app.js - API application → Exam generation and allotment: mounts routes
Backend/src/app.js - API application → Cohort management: mounts routes
Backend/src/app.js - API application → Admin management: mounts routes
Backend/src/app.js - API application → Student attempt and grading: mounts routes
Backend/src/app.js - Authentication → User records: reads and writes
Backend/src/controllers/auth.controller.js - Authentication → Organization records: reads organization
Backend/src/controllers/auth.controller.js - Organization provisioning → Organization records: creates organization
Backend/src/routes/organization.routes.js - Organization provisioning → User records: provisions admin
Backend/src/routes/organization.routes.js - Organization provisioning → Email delivery: sends invitation
Backend/src/routes/organization.routes.js - Exam generation and allotment → Generated exams: creates and reads
Backend/src/controllers/generateExam.controller.js - Exam generation and allotment → User records: assigns users
Backend/src/controllers/generateExam.controller.js - Exam generation and allotment → Student exam records: creates allotments
Backend/src/controllers/generateExam.controller.js - Exam generation and allotment → Email delivery: notifies assignees
Backend/src/controllers/generateExam.controller.js - Student attempt and grading → Student exam records: updates attempts
Backend/src/controllers/studentExam.controller.js - Student attempt and grading → Generated exams: loads exam
Backend/src/controllers/studentExam.controller.js - Student attempt and grading → User records: loads student
Backend/src/controllers/studentExam.controller.js - Admin management → User records: manages users
Backend/src/controllers/admin.controller.js - Admin management → Student exam records: reads attempts
Backend/src/controllers/admin.controller.js - Admin management → Cohort records: counts cohorts
Backend/src/controllers/admin.controller.js - Admin management → Generated exams: reads exams
Backend/src/controllers/admin.controller.js - Admin management → Email delivery: sends notices
Backend/src/controllers/admin.controller.js - Question bank management → Question bank records: manages bank data
- Cohort management → Cohort records: manages cohorts
Backend/src/controllers/cohort.controller.js - Email delivery → SMTP service: sends mail
Backend/src/utils/emailService.js - MongoDB → User records: stores records
- MongoDB → Generated exams: stores records
- MongoDB → Student exam records: stores records