erd:viewLens

Tables (6)

issued_codes

  • code — VARCHAR(255) — Primary key — NOT NULL — 발급된 참여 코드(PK) — 온보딩 입력값을 이 명단과 대조해 검증
  • group_code — VARCHAR(32) — NOT NULL — 코드가 속한 그룹 (EXP|CON|TEST-*) — 서버가 그룹 확정 근거
  • createdAt — DATETIME — 행 생성 시각

participants

  • id — INT — Primary key — NOT NULL — 내부 PK(자동 증가)
  • anonymousId — VARCHAR(255) — NOT NULL — 익명 식별자(UUID) — 신원과 분리된 행동 데이터의 논리적 키
  • participantCode — VARCHAR(255) — Foreign key → issued_codes.code — 온보딩에 사용한 발급 코드 (= issued_codes.code)
  • group_code — VARCHAR(32) — NOT NULL — 배정 그룹 (EXP|CON|TEST-EXP|TEST-CON)
  • installDate — DATETIME — NOT NULL — 설치/온보딩 완료 시각 — 경과일·주차 계산 기준
  • createdAt — DATETIME — 행 생성 시각

period_reviews

  • id — INTEGER — Primary key — NOT NULL
  • anonymousId — TEXT — NOT NULL
  • periodIndex — INTEGER — NOT NULL
  • periodStart — TEXT — NOT NULL
  • periodEnd — TEXT — NOT NULL
  • isBaseline — INTEGER — NOT NULL
  • sessionCount — INTEGER
  • videoCount — INTEGER
  • categoryDistribution — TEXT
  • entropy — REAL
  • review — TEXT
  • reviewTopic — TEXT
  • source — TEXT
  • promptVersion — TEXT
  • llmStatus — TEXT
  • failureReason — TEXT
  • geminiMs — INTEGER
  • generatedAt — TEXT — NOT NULL
  • createdAt — TEXT
  • id (id2) — INT — Foreign key → participants.id — NOT NULL — 내부 PK(자동 증가)

popup_events

  • id — INT — Primary key — NOT NULL — 내부 PK(자동 증가)
  • anonymousId — VARCHAR(255) — Foreign key → participants.anonymousId — NOT NULL — 팝업 사용 참여자 (→ participants.anonymousId)
  • dwellMs — INT — 팝업 체류 시간(ms)
  • tabTodayClicks — INT — 오늘 탭 클릭 횟수
  • tabWeekClicks — INT — 주차별 탭 클릭 횟수
  • feedbackViewed — INT — 피드백 실제 열람 시 1 (개입 전달 핵심 지표)
  • openedAt — DATETIME — 팝업 오픈 시각 (engagement 최근성)
  • createdAt — DATETIME — 서버 저장 시각

sessions

  • id — INT — Primary key — NOT NULL — 내부 PK(자동 증가)
  • anonymousId — VARCHAR(255) — Foreign key → participants.anonymousId — NOT NULL — 세션 소유 참여자 (→ participants.anonymousId)
  • sessionId — VARCHAR(255) — NOT NULL — 세션 고유 ID(확장 생성, 중복 저장 방지)
  • startTime — DATETIME — NOT NULL — 세션 시작 시각(첫 영상 시청)
  • endTime — DATETIME — NOT NULL — 세션 종료 시각(10분 비활성 감지)
  • videoCount — INT — 세션 내 시청 영상 수
  • categoryDistribution — TEXT — 카테고리별 비율(JSON 문자열) — 다양성 계산 입력
  • entropy — DOUBLE — 카테고리 분포의 Shannon 엔트로피(다양성 지수)
  • totalMs — INT — 처리 지연 전체(분석 시작~피드백 완료, ms)
  • youtubeMs — INT — YouTube 카테고리 조회 소요(ms)
  • geminiMs — INT — LLM 리뷰 생성 소요(성공/폴백·타임아웃 대기 포함, ms)
  • llmStatus — VARCHAR(16) — LLM 결과 상태 (success | fallback)
  • failureReason — VARCHAR(32) — 폴백 사유 (timeout|http_error|empty_response|parse_error|network_error, 성공 시 NULL)
  • httpStatus — INT — http_error 시 HTTP 상태코드(429 쿼터 vs 5xx 구분)
  • timedOut — INT — 타임아웃으로 실패한 경우 1
  • createdAt — DATETIME — 서버 수신/저장 시각

video_events

  • id — INT — Primary key — NOT NULL — 내부 PK(자동 증가)
  • anonymousId — VARCHAR(255) — Foreign key → participants.anonymousId — NOT NULL — 시청 참여자 (→ participants.anonymousId)
  • videoId — VARCHAR(32) — NOT NULL — YouTube 영상 ID
  • title — TEXT — 영상 제목(시청 시점 스냅샷)
  • watchedAt — DATETIME — NOT NULL — 시청 감지 시각
  • createdAt — DATETIME — 서버 저장 시각