Spaces:

NaikPranav11
/

Hirely-Backend

Runtime error

Test access verification with email
Test information and instructions display
Interactive test-taking interface with:
- Timer countdown with color coding
- Question navigation (previous/next)
- Progress indicator
- Answer summary
- Multiple question types support (multiple choice, text, coding)
- Auto-submit when time runs out
Results display (immediate or pending based on test settings)

✅ API Service Methods (frontend/src/services/api.js):

checkCandidateTestAccess(testResultId, email) - Verify access
startCandidateTest(testResultId, email) - Start test
submitCandidateTest(submission) - Submit answers
getCandidateTestResults(testResultId, email) - Get results

✅ Routing (frontend/src/App.jsx):

Public route added: /take-test/:testResultId
Route is accessible without authentication

How It Works

1. Recruiter Assigns Test

Go to Tests page
Click "Assign" on any test
Select candidate and set expiration (optional)
System creates test assignment and sends email

2. Candidate Receives Link

Email contains link format:

http://localhost:5173/take-test/{test_result_id}?email={candidate_email}

3. Candidate Takes Test

Click link → See test info and instructions
Click "Start Test" → Timer starts, questions appear
Answer questions → Navigate between questions
Submit test → Get immediate results (if configured)

4. Recruiter Views Results

Go to Tests page
Click "View Results" on the test
See all candidate scores and details

Testing the Flow

Quick Test Steps:

Start Backend:
```
cd backend
python api_app.py
```
Start Frontend:
```
cd frontend
npm run dev
```
Create and Assign Test:
- Login to recruiter dashboard
- Go to Tests page
- Create a new test with questions
- Assign it to a candidate
Get Test Link:
- Check database for test_result_id:
```
cd backend
python view_db.py
```
- Look for the TestResult record
Take Test:
- Open: http://localhost:5173/take-test/{test_result_id}?email={candidate_email}
- Complete the test
View Results:
- Check Tests page for results
- Or candidate sees immediate results (if configured)

Features Implemented

Security

✅ Email verification on every request
✅ No authentication required (uses test_result_id + email)
✅ One-time use (cannot retake unless configured)
✅ Expiration date checking
✅ Correct answers hidden until submission

User Experience

✅ Clean, intuitive interface
✅ Timer with color coding (green → yellow → red)
✅ Progress tracking
✅ Question navigation
✅ Answer summary
✅ Auto-submit on timeout
✅ Immediate or delayed results

Question Types Supported

✅ Multiple choice (radio buttons)
✅ Text (textarea)
✅ Coding (monospace textarea)

Scoring

✅ Automatic scoring
✅ Points per question
✅ Pass/fail determination
✅ Individual question scores
✅ Time tracking

Next Steps (Optional Enhancements)

Email Integration

Send test assignment email with link
Send test completion notification
Send results email (if delayed)

Implementation:

# In backend/api/endpoints/tests.py assign_test_to_candidate()
from modules.email_service import send_email

# After creating test_result
test_link = f"http://localhost:5173/take-test/{test_result.id}?email={candidate.email}"
send_email(
    to_email=candidate.email,
    subject=f"Test Assignment: {test.title}",
    body=f"You have been assigned a test. Click here to start: {test_link}"
)

Additional Features

Save progress (allow browser refresh)
Question bookmarking/flagging
Review answers before submission
Detailed question-by-question results
Test analytics for recruiters
Proctoring features (webcam, screen recording)

File Structure

backend/
├── api/endpoints/
│   ├── candidate_tests.py    # NEW: Public test endpoints
│   └── tests.py               # Existing: Recruiter test management
├── models/test.py             # Test and TestResult models
└── TEST_FLOW_GUIDE.md         # Complete documentation

frontend/
├── src/
│   ├── pages/
│   │   ├── TakeTest.jsx       # NEW: Candidate test interface
│   │   └── Tests.jsx          # Existing: Recruiter test management
│   ├── services/
│   │   └── api.js             # UPDATED: Added candidate test methods
│   └── App.jsx                # UPDATED: Added public route

API Endpoints Summary

Recruiter Endpoints (Authenticated)

POST /api/v1/tests/ - Create test
GET /api/v1/tests/ - List tests
PUT /api/v1/tests/{id} - Update test
DELETE /api/v1/tests/{id} - Delete test
POST /api/v1/tests/{id}/assign - Assign to candidate
GET /api/v1/tests/{id}/results - View all results

Candidate Endpoints (Public with email verification)

GET /api/v1/candidate-tests/access/{test_result_id} - Check access
POST /api/v1/candidate-tests/start - Start test
POST /api/v1/candidate-tests/submit - Submit answers
GET /api/v1/candidate-tests/result/{test_result_id} - View results

Database Schema

Test Table

Stores test configuration
Questions with correct answers
Settings (duration, passing score, etc.)

TestResult Table

One record per test assignment
Status: assigned → in_progress → completed
Stores answers and scores
Tracks timing and attempts

Troubleshooting

Test Link Not Working

Verify test_result_id exists in database
Check email matches candidate email exactly
Ensure test status is "assigned" or "in_progress"
Check expiration date

Timer Issues

Browser must support JavaScript
Don't refresh page during test
Auto-submit triggers at 0:00

Submission Fails

Check internet connection
Verify backend is running
Check browser console for errors
Ensure all required fields are filled

Success! 🎉

The complete candidate test-taking flow is now implemented and ready to use. Candidates can receive test links, take tests with a timer, and see their results immediately or later based on test configuration.