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 — 서버 저장 시각