웹 세션 리플레이 · AI 컨텍스트 로깅 서비스 개발 계획 계획웹 MVP

1. 목표와 비범위

핵심 원칙은 화면 녹화가 아니라 단일 시간축의 구조화된 증거를 남기는 것이다. 운영자는 리플레이로 상황을 확인하고, AI는 같은 이벤트로 원인 후보와 영향도를 제시한다.

2. 권장 아키텍처

세션 수명주기

1. 서버가 sessionId를 발급하고 아동·회기·앱 버전·기기 익명 식별자와 연결한다.
2. SDK는 증가하는 sequence를 부여해 이벤트를 5초 또는 100건 단위로 압축 전송한다.
3. 네트워크 실패 시 IndexedDB에 보관하고 지수 백오프로 순서대로 재전송한다.
4. 종료 시 manifest를 확정하고 세션 메타데이터를 UPLOADED로 전환한 뒤 분석 큐에 한 번만 발행한다.
5. 분석 결과와 이슈를 저장하고 정책을 통과한 항목만 Slack 전송 큐에 넣는다.

3. 이벤트 계약과 웹 SDK

원본 DOM 이벤트와 업무 의미 이벤트를 분리하되, 공통 envelope로 합친다. 이 구조는 리플레이·검색·AI 분석에서 같은 기준 시각과 증거 ID를 사용하게 한다.

{
  "schemaVersion": "1.0",
  "eventId": "evt_01HXYZ",
  "sessionId": "sr_01HXYZ",
  "childId": "child_123",
  "lessonSessionId": "lesson_session_456",
  "timestamp": "2026-08-04T07:30:15.421Z",
  "sequence": 142,
  "source": "ppi-web",
  "eventType": "stt.completed",
  "payload": { "text": "[masked if needed]", "confidence": 0.82, "latencyMs": 630 }
}

4. 저장·조회 모델

S3: 변경 불가 원본과 분석 산출물

s3://ppi-session-replay-{env}/
  tenant/{tenantId}/child/{childId}/date=2026-08-04/session/{sessionId}/
    manifest.json
    replay/events-0001.ndjson.gz
    replay/rrweb-0001.ndjson.gz
    metrics/webrtc-summary.json.gz
    analysis/context-v1.json
    analysis/result-v1.json

manifest에는 파일 키, 시간 범위, 이벤트 수, SHA-256, 스키마 버전을 기록한다. 업로드 재시도는 동일한 eventId를 허용하고, server-side dedupe 후 manifest에 확정된 청크만 포함한다.

DynamoDB: 조회용 메타데이터

기간·앱 버전·복수 태그의 자유 조합 검색은 초기 DynamoDB 범위에 넣지 않는다. 우선 화면에서 필요한 단일 필터와 사전 집계만 지원하고, 실제 조회 패턴이 확인된 뒤 OpenSearch 도입 여부를 결정한다.

5. AI 이슈 분석 파이프라인

1. 정규화: 시간 정렬, 중복 제거, 클록 보정, 민감정보 제거, sequence gap 표시.
2. 규칙 사전 탐지: 명확하고 비용이 낮은 이상을 먼저 증거와 함께 계산.
3. 컨텍스트 축약: 오류 전후 구간, 수업 단계별 전환, 음성 turn, 네트워크 요약만 AI에 전달.
4. 구조화된 LLM 분석: JSON schema로 요약·이슈·심각도·증거·권장 조치를 생성.
5. 검증과 저장: 시간 범위와 evidenceEventId가 실제 이벤트에 존재하는지 확인한 뒤 저장; 실패는 DLQ와 재시도 정책으로 처리.

{
  "sessionId": "sr_01HXYZ",
  "summary": "STT 지연 이후 화면 진행이 정체된 세션입니다.",
  "severity": "HIGH",
  "issues": [{
    "type": "STT_MISRECOGNITION",
    "severity": "HIGH",
    "startMs": 732000,
    "endMs": 738000,
    "confidence": 0.91,
    "evidenceEventIds": ["evt_101", "evt_102"],
    "possibleCause": "낮은 STT 신뢰도와 재연결 구간이 겹침",
    "recommendedAction": "해당 구간의 마스킹된 전사와 네트워크 지표를 검토"
  }],
  "modelVersion": "analysis-prompt-v1"
}

6. PPI 웹 대시보드와 Slack

통합 타임라인 레인

UI · STT · LLM · TTS · Network · API/Error · AI Issue. 이벤트 밀집 구간은 집계 표시하고, AI 이슈는 심각도 색상과 evidence count를 함께 보인다.

Slack 알림 정책

• HIGH 이상, 세션 비정상 종료, 수업 미완료, STT/TTS 전체 실패, LiveKit 연결 실패만 즉시 전송
• MEDIUM은 30분 단위로 앱 버전·이슈 유형별 요약
• dedupeKey = issueType + appVersion + normalizedCause로 일정 시간 중복 억제
• 메시지에는 가명화된 아동 식별자, 지표, 권장 조치, 권한이 필요한 PPI 세션 링크만 포함

7. 단계별 개발 계획

8. 보안·보존·장애 대응

9. 측정 지표와 착수 체크리스트