G.8: Take Public Assessment

Summary

Guests complete an assessment through a public or assigned take-assessment token. The frontend loads the assessment, collects answers, submits the response, and shows a completion state.

Role

• Primary: Guest
• Secondary: Counselor, System

Entry Point

• URL: /assessments/public/:token
• URL: /assessments/take/:token

Preconditions

• Assessment or submission token is valid.
• Assessment is available and not expired.

Steps

1. Guest opens the assessment token URL.
2. Frontend loads assessment details and questions.
3. Guest answers required questions.
4. Guest submits the assessment.
5. Backend validates and stores the submission.
6. System may notify the assigning counselor.
7. Frontend shows the completion state.

Diagram

Edge Cases

• Expired token: Public assessment page shows expired or unavailable state.
• Validation errors: Required questions block submission.
• Already completed: Backend controls whether resubmission is allowed.

Current Implementation Notes

• Frontend: frontend/src/features/assessments/pages/public-assessment.tsx
• Backend: backend/internal/services/assessment_service.go

Screenshot Status

• Not captured.

Related Flows

• G.9 Shared Assessment Landing
• IE.7 Assessment Emails and Notifications