PRD — rp-session-detail
updated: 2026-05-29 · status: draft menu: 롤플레잉 > 히스토리 (activeMain: roleplaying / activeSub: history) entry:
rp-history의 "세션 상세 →" 클릭
1. 목적
학습자가 완료한 단일 롤플레잉 세션을 다시 열어 무엇이 잘됐고, 무엇을 다음 시도에서 고쳐야 하는지 판단하게 한다. 이 페이지는 단순 결과 리포트가 아니라, 지표별 평가와 AI 피드백을 통해 다음 개선 행동을 정리하는 회고 화면이다.
첨부된 기존 결과 화면은 기능 참고 자료로만 사용한다. 점수, 항목별 평가, 코칭 피드백 같은 기능 단위는 반영하되, 기존 이미지의 긴 리포트형 레이아웃과 섹션 배치는 와이어프레임에서 새로 정의한다.
더미 리포트 기준으로 시나리오마다 평가 모델과 지표 수가 달라진다. 예를 들어 퇴사자 면담은 ORISKS 6단계(Opening, Reason, Insight, Support, Kindness, Sum-up)로 평가되고, 1on1 대화는 OPEN FANS 8단계에 1on1 goal alignment 같은 추가 목적 충실도 지표가 붙는다. 따라서 이 페이지의 지표 영역은 고정 컬럼/고정 항목이 아니라 시나리오별 rubric 데이터에 따라 동적으로 렌더링되어야 한다.
추가 더미 JSON 기준으로 성과평가 피드백 대화는 OFEARS류 지표(Opening, Feeling, Evidence, Action, Reinforcement, Summarize 등)와 별도 감점 항목, 즉시 적용 가능한 스킬 3개, 종합 강점/개선점 묶음을 함께 내려준다. 따라서 세션 상세는 PDF 리포트형 데이터와 JSON 분석 결과형 데이터를 모두 수용하는 분석 결과 뷰어로 설계한다.
2. 사용자
- 주 사용자: 롤플레잉을 1회 이상 완료했고, 특정 세션 결과를 자세히 확인하려는 학습자
- 빈도: 세션 완료 직후, 재도전 직전, 코칭/리뷰 전에 반복 진입
- 진입 맥락:
rp-history에서 특정 세션 카드의 "세션 상세 →" 클릭 → 세션 결과 확인 → 히스토리로 복귀
3. 핵심 사용 흐름
rp-history에서 세션 상세로 진입하면 해당 세션의 상태와 기본 메타정보를 먼저 확인한다.- 이 세션에 적용된 분석 모델명과 평가 목적을 확인한다. 예:
ORISKS 기반 퇴사자 면담,OPEN FANS 기반 1on1. - 전체 점수와 합격/재도전 필요/분석 중 상태를 보고 현재 결과의 의미를 파악한다.
- 시나리오별 평가 지표에서 높은/낮은 항목과 감점 사유를 확인한다.
- AI 코칭에서 다음 시도에 바로 적용할 개선 포인트, 대화 스킬, 추천 표현을 확인한다.
- 필요한 내용을 확인한 뒤 히스토리로 돌아간다.
4. 주요 정보·액션
- 정보:
- 세션 메타 — 일시, 소요 시간, 시나리오, 캐릭터, 카테고리, 난이도, 트랙 태그
- 분석 상태 — 분석 완료 / 분석 중 / 산출물 일부 없음 / 오류 상태
- 분석 모델 — 모델명, 단계 수, 평가 목적, 지표별 만점. 예:
6단계 퇴사자 면담 모델 ORISKS,8단계 원온원 대화 모델 OPEN FANS - 결과 요약 — 총점, 합격 여부, 한 줄 총평, 감점 요약, 이번 세션의 핵심 강점 1개와 우선 개선점 1개
- 평가 지표 요약 — 시나리오별 rubric에 따라 달라지는 지표 목록. 각 지표는 코드/이름/설명/점수/만점/충족도/짧은 판정 문장을 가진다
- 지표별 상세 분석 — 지표별 판단 근거, 아쉬운 점 또는 문제점, 개선점 또는 개선방안, 권장 발화 예시
- AI 코칭 — 종합 요약, 잘한 점, 아쉬운 점, 개선방안, 즉시 적용 가능한 대화 기술 Top 3, 추천 답변/대체 표현
- 종합 분석 — 전체 comment, 강점 묶음, 개선점 묶음. 각 항목은 제목과 상세 설명을 여러 개 가질 수 있음
- 이전 시도 맥락 — 같은 시나리오·캐릭터의 직전 시도 점수/날짜가 있으면 변화만 간단히 표시
- 스텝별 추이 비교 — 같은 시나리오의 이전 3회차 시도와 현재 세션을 비교. 각 rubric 스텝마다 회차별 점수를 나란히 보여준다. 표시 범위: 최근 3회차 + 현재 세션(총 4열). 데이터가 없는 회차는 "—"로 표시.
- 총점 추이 — 같은 시나리오의 최근 10회차 총점을 시계열로 표시. 회차, 날짜, 총점을 포함. 데이터가 10회 미만이면 실제 시도 횟수만 표시.
- 액션:
- "히스토리로 돌아가기" — 기존 필터 상태를 유지한
rp-history로 복귀 - "다시 도전하기" — 같은 시나리오의
rp-scenario-detail로 이동 (캐릭터 재선택 가능). AI 코칭 섹션 하단 또는 Header 우측에 배치. 피드백 확인 직후 즉시 재도전이 이 페이지의 핵심 회고 루프임.
- "히스토리로 돌아가기" — 기존 필터 상태를 유지한
지표 데이터 구조 요구
- 평가 지표는 고정된 4~5개 카드가 아니라
rubric.sections[]형태의 반복 데이터로 본다. - 지표마다 만점이 다를 수 있다. 예:
10/15,21/25,8/10,17/20. - 지표마다 텍스트 필드명이 조금 다를 수 있다. 퇴사자 면담은
판단 근거/문제점/개선방안/권장 발화 예시, 1on1은근거/아쉬운 점/개선점/예시처럼 표현이 다르므로 UI 라벨은 표준화하되 원문 뉘앙스를 잃지 않아야 한다. - JSON 더미처럼 지표가
opening_score,opening_basis,opening_issue,opening_improve,opening_example,opening_quality처럼 prefix 기반으로 내려올 수 있다. 와이어프레임/목업 데이터에서는 이를sections[]로 정규화해 다룬다. - 감점 항목은 일반 지표와 별도로 올 수 있다. 예:
deduction.score,deduction.basis. 이 경우 총점 옆 또는 결과 요약 안에서 “왜 감점됐는지”를 독립적으로 보여준다. - 즉시 적용 가능한 스킬은
skills[]안에skill1~3,description1~3,example1~3처럼 묶여 내려올 수 있으므로, 화면에서는 3개 스킬 카드로 정규화한다. - 종합 분석은
comprehensive_analysis.comment,strengths[],improvements[]처럼 별도 요약 블록으로 올 수 있다. 강점/개선점 각각 제목과 상세가 여러 쌍으로 들어올 수 있어, 고정 3개로 가정하지 않는다. - 전체 점수와 지표 점수의 합산 규칙은 분석 모델이 내려주는 값을 우선한다. 프론트에서 만점 합산으로 총점을 재계산하지 않는다.
- 지표 수가 많아지는 경우(8개 이상)에도 한 화면에서 스캔 가능해야 하며, 와이어프레임에서는 요약 지표와 상세 지표를 분리하는 구조를 우선 검토한다.
수집할 사용자 액션 데이터
| trigger | 이벤트 | 프로퍼티 | 수집 사유 |
|---|---|---|---|
| "다시 도전하기" | rp_sessiondetail_retry_click |
sessionId, scenarioId | 피드백 확인→즉시 재도전(핵심 회고 루프, §1) |
| "히스토리로 돌아가기" | rp_sessiondetail_back_history |
sessionId | 회고 후 복귀 동선 |
- 자동 수집(권장): 세션 상세 조회
rp_sessiondetail_view(sessionId, modelCode, passState) — 피드백 회독 빈도/모델별 분포(회고 가치 측정). AI 코칭 섹션 스크롤 도달 측정은 후속(§5 추가 시). - PII: sessionId/scenarioId 등 식별자만. rubric 텍스트·점수 원문은 이벤트에 미포함.
5. 결정 필요 항목
- 신규 slug 확정 —
rp-session-detail확정 - 총점 표현 방식 — 점수 + 합격/재도전 필요 상태 항상 함께 표시
- 항목별 평가 기준 — 시나리오별 동적 rubric으로 처리. 평가 지표 수/명칭/만점/상세 필드는 시나리오마다 다를 수 있음
- 분석 중 세션 진입 시 화면 — 이 페이지 접근 불가. 분석 완료 후에만 진입 허용.
rp-history에서 분석 중 상태는 비활성 처리 - 이전 시도 비교 범위 — 같은 시나리오 기준으로 이전 3회차 + 현재 세션(스텝별 비교), 최근 10회차(총점 추이) 두 가지 뷰로 분리
- 스텝별 추이 비교 배치 — 별도 섹션으로 분리. "회차별 스텝 비교" 섹션을 독립적으로 배치
- 총점 추이 배치 — 별도 섹션으로 분리. "총점 추이" 섹션을 독립적으로 배치
- 총점 추이 시각화 방식 — 미니 라인 차트(SVG) + 숫자 테이블. 꺾은선 그래프로 상승/하락 추세를 시각화하고 하단에 회차·날짜·점수 행 표시
- 지표별 상세 분석 노출 방식 — 현재 와이어프레임 상태 유지. 접기/펼침 없이 모든 항목 직접 표시. 긴 문단은 그대로 노출
- 분석 결과 원천 데이터 형식 — JSON형 단일 포맷. PDF 리포트는 S3 링크로만 제공(별도 뷰어 없음). 프론트에서 JSON을 직접 렌더링