How jatinthacker000-debug/nerdtutors works
NerdTutors is an AI-assisted exam management and grading platform. Teachers authenticate, curate reusable questions and batches, and publish test sessions; students take MCQ or written exams or submit scanned answer sheets. Evaluation produces scores and feedback that are stored for teacher review and student results pages. The README documents typed and OCR grading, analytics, exports, authentication, and subject-specific rubrics; sampled source confirms several Firestore writes and reads, but does not expose all page-to-API wiring, so uncertain links are omitted.
Main entry points: session-manager.js Test sessions · ocr-evaluate.js OCR grading API · excel-uploader.js Bulk question import · batch-manager.js Question batches
Components 25
Identity and portals
- Login portal
index.js - Student dashboard
dashboard.js - Admin portal
admin.js - Account settings
settings.html
Exam authoring
- Question catalog
js/admin-modules/question-manager.js - Bulk question import
js/admin-modules/excel-uploader.js - Question batches
batch-manager.js - Test sessions
js/admin-modules/session-manager.js - Questions and batches
- Test sessions
Assessment and grading
- MCQ exam
mcq-test.js - Written exam
test.html - Scanned submission
ocr-scan.html - Typed grading API
api/evaluate.js - OCR grading API
api/ocr-evaluate.js - Evaluation client
gemini-config.js - PDF answer review
js/admin-modules/answer-evaluator.js
Results and reporting
- Test results
- Student results
results.html - Performance analytics
dashboard.js - Reports and exports
admin.js
Other components
- Teacher
- Student
- Firebase Auth
- Google Gemini
Connections 26
- Teacher → Login portal: signs in
- Login portal → Firebase Auth: authenticates
- Teacher → Admin portal: manages exams
- Student → Student dashboard: views tests
- Student → MCQ exam: takes test
- Student → Written exam: takes test
- Student → Scanned submission: uploads sheets
- Question catalog → Questions and batches: writes and reads
- Bulk question import → Questions and batches: imports questions
- Bulk question import → Question catalog: refreshes list
- Question batches → Questions and batches: writes and reads batches
- Test sessions → Test sessions: writes and reads
- Question batches → Test sessions: supplies batches
- MCQ exam → Test sessions: loads session
- Written exam → Test sessions: loads session
- Evaluation client → Typed grading API: submits answers
- Typed grading API → Google Gemini: requests grading
- Scanned submission → OCR grading API: submits scans
- OCR grading API → Google Gemini: requests OCR grading
- PDF answer review → OCR grading API: requests evaluation
- Test sessions → Test results: reviews and edits
- Student dashboard → Test results: reads results
- Performance analytics → Test results: reads results
- Student results → Test results: shows report
- Reports and exports → Test results: exports grades
- Account settings → Firebase Auth: manages account