How revaldo007/neet-portal works
NEET Examination Portal supports student registration, application submission and administration, then an approved student’s admit card and timed mock exam with results. The React app calls a FastAPI backend; backend routes implement the domain workflows over relational models. The README documents simulated payments and disk-based document uploads. Some frontend screens and backend routers were not excerpted, so their feature coverage and connections rely on README statements and SOURCE INDEX references rather than inspected implementation details.
Main entry points: main.py API Startup · database.py SQL Database · App.jsx Portal Navigation · application.py Application Routes
Components 19
Student and Admin UI
- Portal Navigation
frontend/src/App.jsx - Auth Context
frontend/src/context/AuthContext.jsx - Student Pages
frontend/src/pages - Admin Pages
frontend/src/pages/admin - HTTP Client
frontend/src/api/client.js
API and Identity
- Auth Routes
backend/app/routers/auth.py - Application Routes
backend/app/routers/application.py - Admin Routes
backend/app/routers/admin.py - API Startup
backend/app/main.py - JWT Security
backend/app/auth.py
Exam Workflows
- Exam Routes
backend/app/routers/exam.py - Exam Cycle Setup
frontend/src/pages/admin/AdminExamSchedule.jsx - Question Bank
frontend/src/pages/admin/AdminQuestions.jsx - Exam Results
frontend/src/pages/MockExam.jsx
Persistence and Files
- Domain Models
backend/app/models.py - SQL Database
backend/app/database.py - Document Files
backend/app/routers/application.py
Other components
- Student
- Administrator
Connections 28
- Student → Portal Navigation: uses
frontend/src/App.jsx - Administrator → Portal Navigation: uses
frontend/src/App.jsx - Portal Navigation → Auth Context: provides auth
frontend/src/App.jsx - Portal Navigation → Student Pages: routes student
frontend/src/App.jsx - Portal Navigation → Admin Pages: routes admin
frontend/src/App.jsx - Auth Context → HTTP Client: sends auth requests
frontend/src/context/AuthContext.jsx - Student Pages → HTTP Client: calls API
frontend/src/pages/ApplicationForm.jsx - Admin Pages → HTTP Client: calls API
frontend/src/pages/admin/AdminExamSchedule.jsx - HTTP Client → API Startup: requests backend
README.md - API Startup → Auth Routes: registers
backend/app/main.py - API Startup → Application Routes: registers
backend/app/main.py - API Startup → Exam Routes: registers
backend/app/main.py - API Startup → Admin Routes: registers
backend/app/main.py - Auth Routes → JWT Security: uses
backend/app/routers/auth.py - Auth Routes → SQL Database: queries
backend/app/routers/auth.py - Application Routes → JWT Security: checks student
backend/app/routers/application.py - Application Routes → SQL Database: reads and writes
backend/app/routers/application.py - Application Routes → Document Files: stores documents
backend/app/routers/application.py - Admin Routes → SQL Database: reads and writes
backend/app/routers/admin.py - Admin Routes → JWT Security: checks admin
backend/app/routers/admin.py - Exam Routes → SQL Database: reads and writes
backend/app/routers/exam.py - Exam Routes → JWT Security: checks student
backend/app/routers/exam.py - Domain Models → SQL Database: uses base
backend/app/models.py - API Startup → SQL Database: creates tables
backend/app/main.py - Exam Cycle Setup → Admin Pages: configures
frontend/src/App.jsx - Question Bank → Admin Pages: manages
frontend/src/App.jsx - Student Pages → Exam Results: includes exam
frontend/src/App.jsx - Exam Results → Exam Routes: submits exam