학생 초대 고도화 (초대 링크)¶
요지¶
MVP-C. 기존 가입 학생만 검색 초대하던 한계를 넘어, 선생님이 초대 링크를 공유해 신규 학생을 간편 초대. 로그인/가입 여부에 따라 로그인 → 회원가입 → 스터디룸 진입이 자연스럽게 이어지는 경험.
해결하는 문제¶
기존엔 가입 학생만 검색 초대 가능 → 신규 학생 유입 마찰. 링크 공유로 미가입 학생도 합류시키고, 가입/로그인을 "초대 수락을 위한 과정"으로 설계해 가입 후 자동으로 초대 흐름에 복귀시킨다.
핵심 동작¶
- 링크 단위: 스터디룸 1:1 초대장(테이블). 생성 주체는 선생님.
- 상태: Active / Expired(수동 만료) / Disabled(스터디룸 종료). 토글 ON→새 토큰, OFF→토큰 삭제.
- 토큰: Opaque Token(UUID) + 방 식별자 + RDB 검증(Stateless 미사용, 무결성 우선).
- 권한: 선생님(생성·비활성), 학생(수락), 보호자(수락 불가), 비로그인(로그인/가입 유도).
- 토큰 유지: 이메일 가입/로그인·소셜 리다이렉션 전 과정에서 초대 토큰 유지 → 가입 직후 초대장 노출.
- 분기: 로그인 학생(즉시 수락) / 비로그인 기존 회원(로그인 후) / 미가입(가입 후) / 기가입(스터디룸 조회 전환) / 만료·종료·무효(홈 이동).
상세 분기·토큰 유지·API·라우팅은 design·frd.