A role links a candidate profile to a specific class and tracks their current lifecycle state — the stage they occupy in the student journey, from prospect::cold through applicant::submitted to student::enrolled. Every state transition is recorded and timestamped.

Roles are the primary object for pipeline management. They support ownership assignment (the responsible staff member), withdrawal, and reinstatement. The conversion endpoint returns funnel analytics across any two lifecycle states.