스터디룸 PRD¶
스터디룸은 교사가 직접 개설·운영하는 학습 공간이다. 수업노트·과제·QnA가 한 곳에 쌓이고, 학생과 연결된 학부모는 거기서 성장 지표를 들여다본다. MS1(MVP-A)부터 자리 잡은 핵심 도메인이며, 구현 레벨의 확정 명세는 frd를 따른다.
목표 & 성공 기준 (지표)¶
- 문제: 선생님이 학생·학부모와 수업 흔적(노트·과제·질문·성취)을 모아 공유할 일관된 공간이 없다. 분산된 도구로는 학습 맥락이 휘발된다.
- 목표: 학습 공간 단위 제공 — 선생님엔 자기표현·과외 포트폴리오, 학생엔 소통·질문 동기, 학부모엔 자녀 학습 현황 가시성. 추후 협업·몰입형 공간으로 확장.
- 성공 지표: 스터디룸 생성 완료율(위저드 Step2 제출 / Step1 진입), 생성 후 학생 초대 전환율, 룸당 활성 학생 수·누적 수업노트 수, 학생·보호자 대시보드 재방문율. (KR: 생성된 스터디룸 수, 생성된 질문 수.) 트래킹 이벤트 정의는 frd.
대상 페르소나¶
- 교사(생성·운영 주체), 학생(초대 참여·조회), 학부모(연결 학생 종속·성장 지표 조회), 비회원(PUBLIC 룸 프리뷰).
범위 (포함 / 제외)¶
- In: 생성 위저드, 학생 초대, 목록·조회, 대시보드 진입(상세는 스터디룸 대시보드), publicId 기반 라우팅 개편.
- Out(Spec-Out/팔로우업): 학생·학부모 가입신청, 임시저장, 활성/비활성 토글, 휴지통, 커스텀 정렬, 타 교사 권한 초대, 수업로그 작성일↔룸 시작/종료 날짜 연동. (성진) 스터디룸 육성 기능(과제·출석 등 학업 행위 → 룸 점수 기여·랭킹화), 프리미엄 유료 기능.
- 확장 비전(UX 아이데이션): Forest 차용 공동 숲 가꾸기(집중·소통→나무/꽃 성장), 역할 기반 미션(멘토 답변=지식의 씨앗·질문=생명수), 협동 보상(팀 아이템 해금·룸 꾸미기), 지식 도감(질문/답변→지식 카드 수집·선생님 포트폴리오), 실험노트(수업노트+QnA→하루치 기록·PDF). MVP는 텍스트+아이콘 기반 점진 구현. 워딩 후보: 러닝랩·지식소·연구소.
요구사항 (유저 스토리 · 기능)¶
- 교사가 Step-by-step Wizard로 스터디룸을 생성(이름·공개범위·설명·수업정보) → 완료 모달에서 학생 초대 또는 룸 이동.
- 교사가 이메일로 학생을 초대 → 연결된 보호자 자동 입장 → 학생 수락 시 학생 프론트 노출.
- 학생·보호자가 대시보드에서 출석·진도·과제·성취도 등 성장 지표 조회(조회 전용).
-
비회원이 PUBLIC 스터디룸을 프리뷰로 둘러봄(스터디룸 소개(프리뷰) PRD).
-
생성·CRUD는 교사 전용. 학생/보호자/전체는 조회만(교사가 권한 부여). 보호자는 학생에 귀속 —
StudentGuardianLink.status = ACTIVE인 경우만 입장. 미연결 보호자는 입장 불가 + 전체공개 외 게시글 열람 불가. - 구성요소( 생성 필수): 이름(30자·ph "삼각함수 1-1 수업"), 설명(90자·TipTap·ph "선생님이 직접 운영하는 공간입니다. 나의 인생 수업을 만나보세요."), 공개범위(PUBLIC default/PRIVATE), *참여 학생 수(보호자 제외·학생만), 시작/종료날짜(시작=생성시점 default·종료=없음, MVP1 프론트 미노출 — 수업로그 작성일이 기간 벗어남 방지). 수업정보(Step2): 온/오프라인·1:1/1:N·과목(국/영/수/기타)·대상학년(초1~6/중1~3/고1~3/없음).
- 생성은 위저드 2-스텝, API는 Step 2 제출 시 1회(Step1+Step2 병합). 임시저장·새로고침 유지는 Spec-Out.
- 초대 권한: Owner(=생성 교사). 대상은 학생만(보호자 직접 초대 불가). 생성 시 학생 연결 필수 아님(생성이 초대보다 선행, 최소 0). 학생↔보호자 연결 각 4명. 초대 발송 시 LNB 빨간점·GNB 알림 생성(Sprint5).
- 기타 정책: 사용자당 스터디룸 5개·룸당 로그 1,000개. 삭제 시 DB Soft Delete(내용 cascade 삭제).
- 목록 정렬: 생성순(default) / 가나다순(스터디룸명).
- 입력 검증:
V-SR-01(이름 EMPTY)V-SR-02(이름 MAX)V-SR-03(공개범위 필수)V-SR-04(설명 MAX)V-SR-05(미지원 마크)V-SR-11(수업정보 미선택), 초대V-INV-01~03(EMPTY/NOT_FOUND/DUPLICATE). 상세 문구·노출 위치는 frd.
근거¶
- MS1 FDD(생성 위저드·초대·대시보드 본체) · 2차 스프린트 FRD(Why/정책 본체) · UX 아이데이션 · 학생 관점에서 정리.
오픈 이슈¶
- 초대 인원 정책(초기 룸당 학생 9명, 학원 기준 10명 미만)은 BM에 따라 재정의 예정.
- 생성 제한(사용자당 5개·룸당 로그 1,000개)의 향후 상향 여부.
- 활성화/비활성화 토글·커스텀 정렬·타 교사 권한 초대 우선순위(TBD).