How rugved0014/vigilexam works
VigilExam is a desktop-and-web examination platform with role-based student, proctor, and administrator workflows. Students sign in, select an assigned test, complete a pre-check, start an attempt, take the exam, and view a result; proctors monitor live candidates and can warn or terminate attempts, while administrators manage exams and review analytics. The backend exposes HTTP and Socket.IO services backed by a JSON file store. The README describes native process monitoring and kiosk lockdown, but the sampled Electron excerpts do not show their implementation or wiring.
Main entry points: App.jsx Role router · index.js HTTP and socket server · AuthContext.jsx Authentication state · ExamKiosk.jsx Exam kiosk
Components 18
Client experience
- Role router
src/App.jsx - Authentication state
src/context/AuthContext.jsx - Login
src/pages/Login.jsx - Navigation bar
src/components/Navbar.jsx - Socket connection
src/context/SocketContext.jsx - Desktop shell
electron/main.js - OS monitoring and kiosk
electron/main.js
Exam workflow
- Student dashboard
src/pages/student/StudentDashboard.jsx - Pre-exam check
src/pages/student/PreCheckRoom.jsx - Exam kiosk
src/pages/student/ExamKiosk.jsx - Exam result
src/pages/student/ExamResult.jsx
Operations and oversight
- Live proctoring
src/pages/proctor/ProctorDashboard.jsx - Admin console
src/pages/admin/AdminDashboard.jsx
Backend services
- HTTP and socket server
server/index.js - JSON data store
server/db.js
Other components
- Student
- Proctor
- Administrator
Connections 29
- Student → Role router: uses
src/App.jsx - Proctor → Role router: uses
src/App.jsx - Administrator → Role router: uses
src/App.jsx - Role router → Authentication state: provides auth
src/App.jsx - Role router → Socket connection: provides socket
src/App.jsx - Role router → Navigation bar: renders
src/App.jsx - Role router → Login: renders
src/App.jsx - Login → Authentication state: signs in
src/pages/Login.jsx - Authentication state → HTTP and socket server: requests login
src/context/AuthContext.jsx - Role router → Student dashboard: routes student
src/App.jsx - Student dashboard → Role router: starts pre-check
src/App.jsx - Role router → Pre-exam check: renders pre-check
src/App.jsx - Pre-exam check → Role router: proceeds
src/App.jsx - Role router → HTTP and socket server: starts attempt
src/App.jsx - Role router → Exam kiosk: renders exam
src/App.jsx - Exam kiosk → Role router: submits result
src/App.jsx - Role router → Exam result: renders result
src/App.jsx - Role router → Live proctoring: routes proctor
src/App.jsx - Role router → Admin console: routes admin
src/App.jsx - Navigation bar → Authentication state: logs out
src/components/Navbar.jsx - Navigation bar → Socket connection: shows connection
src/components/Navbar.jsx - Socket connection → HTTP and socket server: connects socket
src/context/SocketContext.jsx - Live proctoring → HTTP and socket server: monitors and acts
- Admin console → HTTP and socket server: manages exams
- HTTP and socket server → JSON data store: reads and writes
server/index.js - HTTP and socket server → Live proctoring: streams alerts
README.md - HTTP and socket server → Exam kiosk: sends termination
server/index.js - Desktop shell → OS monitoring and kiosk: hosts capability
electron/main.js - OS monitoring and kiosk → Exam kiosk: enforces lockdown