ZANI
Tables (34)
attention_events
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → session_participants.session_id — NOT NULL — 분석 이벤트가 발생한 세션 ID
- session_participant_id — BIGINT — Foreign key → session_participants.id — NOT NULL — 분석 대상 학생 세션 참여자 ID
- attention_score — TINYINT — 4단계 참여도 1~4. 4단계가 아닌 출력은 NULL
- occurred_offset_ms — BIGINT — NOT NULL — 세션 시작 기준 참여도 측정 시각(ms)
- confidence — DECIMAL(5, 4) — 상태 신뢰도 0~1
- signal_quality — DECIMAL(5, 4) — 입력 신호 품질 0~1
- created_at — DATETIME(6) — NOT NULL — 이벤트 저장 시각
- detector_outcome — VARCHAR(30) — 검출기 출력 7종. NOT_ENGAGED, BARELY_ENGAGED, ENGAGED, HIGHLY_ENGAGED, UNMEASURABLE, CAMERA_OFF, DETECTOR_UNAVAILABLE
- window_started_offset_ms — BIGINT — 10초 판정 창 시작 시각(ms). 즉시 확정 출력(CAMERA_OFF, DETECTOR_UNAVAILABLE)은 창이 없어 NULL
- low_engagement — BOOLEAN — 브라우저가 확률 합 0.35 기준으로 판단한 저참여 여부. 4단계 출력에만 있다
- feature_schema_version — VARCHAR(40) — 브라우저가 쓴 특징 추출 계약 버전(예: mediapipe_98_v1)
- engine_version — VARCHAR(40) — 브라우저가 쓴 추론 엔진·모델 버전
- client_event_id — VARCHAR(64) — 클라이언트가 만든 이벤트 식별자. 재시도 멱등의 기준
chat_messages
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → session_participants.session_id — NOT NULL — 메시지가 발생한 세션 ID
- sender_participant_id — BIGINT — Foreign key → session_participants.id — NOT NULL — 메시지를 보낸 세션 참여자 ID
- recipient_participant_id — BIGINT — Foreign key → session_participants.id — 비공개 메시지 수신자 ID, 공개 채팅은 NULL
- channel_type — VARCHAR(20) — NOT NULL — PUBLIC 또는 PRIVATE
- content — VARCHAR(1000) — NOT NULL — 메시지 본문, 최대 1000자
- occurred_offset_ms — BIGINT — NOT NULL — 세션 시작 기준 발생 시각(ms)
- created_at — DATETIME(6) — NOT NULL — 메시지 저장 시각
check_prompt_evidences
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- check_prompt_id — BIGINT — Foreign key → check_prompts.id — NOT NULL — 근거가 연결된 체크 프롬프트 ID
- attention_event_id — BIGINT — Foreign key → attention_events.id — 분석 이벤트 근거 ID
- interaction_event_id — BIGINT — Foreign key → interaction_events.id — 상호작용 이벤트 근거 ID
- evidence_type — VARCHAR(50) — NOT NULL — 근거의 역할 또는 유형
- created_at — DATETIME(6) — NOT NULL — 근거 연결 생성 시각
check_prompts
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → session_participants.session_id — NOT NULL — 프롬프트가 발생한 세션 ID
- session_participant_id — BIGINT — Foreign key → session_participants.id — NOT NULL — 프롬프트 대상 학생 세션 참여자 ID
- trigger_type — VARCHAR(50) — NOT NULL — 프롬프트 종류. 서버가 기록하는 것은 UNDERSTANDING_CHECK 뿐이다(자세·카메라 안내는 브라우저 안에서 끝난다)
- status — VARCHAR(20) — NOT NULL — OPEN, RESPONDED 또는 TIMEOUT
- response — VARCHAR(30) — OK, CONFUSED, MISSED 또는 NON_RESPONSE
- shown_offset_ms — BIGINT — NOT NULL — 프롬프트 표시 시각(ms)
- responded_offset_ms — BIGINT — 응답 시각(ms), 미응답은 NULL
- created_at — DATETIME(6) — NOT NULL — 프롬프트 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 응답 상태 수정 시각
coaching_histories
- id — BIGINT — Primary key — NOT NULL — TSID primary key
- trigger_id — VARCHAR(64) — NOT NULL — Idempotency key unique inside the session
- triggered_at — DATETIME(6) — NOT NULL — Absolute UTC time when coaching was triggered
- completed_at — DATETIME(6) — NOT NULL — Absolute UTC time when coaching processing completed
- denominator_count — INT — NOT NULL — Anonymous students included in the trigger snapshot
- selected_tip_type — VARCHAR(50) — Tip type selected before generation
- outcome_status — VARCHAR(30) — NOT NULL — TIP_DELIVERED or TIP_UNAVAILABLE
- transcript_status — VARCHAR(30) — NOT NULL — TRANSCRIBED, SKIPPED_NOT_REQUIRED, NOT_ATTEMPTED, TRANSCRIPTION_FAILED, or NO_TRANSCRIPT
- transcript_started_at — DATETIME(6) — Absolute UTC start of the real-time transcript interval
- transcript_ended_at — DATETIME(6) — Absolute UTC end of the real-time transcript interval
- topic — VARCHAR(500) — Topic extracted from the real-time transcript without retaining the full text
- tip_type — VARCHAR(50) — Delivered coaching tip type
- tip_title — VARCHAR(200) — Delivered coaching tip title
- tip_message — TEXT — Delivered coaching tip message
- unavailable_reason — VARCHAR(50) — Reason a coaching tip was not delivered
- created_at — DATETIME(6) — NOT NULL — Persistence time in UTC
- session_id — BIGINT — Foreign key → sessions.id — NOT NULL — Lecture session that owns this coaching result
coaching_history_response_counts
- id — BIGINT — Primary key — NOT NULL — TSID primary key
- coaching_history_id — BIGINT — Foreign key → coaching_histories.id — NOT NULL — Owning coaching history row
- response_type — VARCHAR(30) — NOT NULL — SIGNIFICANT, CONFUSED, MISSED, NON_RESPONSE, or UNMEASURABLE
- response_count — INT — NOT NULL — Exact anonymous student count
- created_at — DATETIME(6) — NOT NULL — Persistence time in UTC
group_alert_response_counts
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- group_alert_id — BIGINT — Foreign key → group_alerts.id — NOT NULL — 응답 분포가 집계된 집단 알림 ID
- response_type — VARCHAR(30) — NOT NULL — OK, CONFUSED, MISSED 또는 NO_RESPONSE
- response_count — INT — NOT NULL — 응답 유형에 해당하는 학생 수
- created_at — DATETIME(6) — NOT NULL — 응답 분포 생성 시각
group_alerts
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → sessions.id — NOT NULL — 집단 알림이 발생한 세션 ID
- alert_type — VARCHAR(50) — NOT NULL — 가장 강한 집단 알림 유형
- window_started_offset_ms — BIGINT — NOT NULL — 집계 구간 시작 시각(ms)
- window_ended_offset_ms — BIGINT — NOT NULL — 집계 구간 종료 시각(ms)
- numerator_count — INT — NOT NULL — 조건을 만족한 고유 학생 수
- denominator_count — INT — NOT NULL — 1분 이상 연속 접속한 학생 수
- occurred_offset_ms — BIGINT — NOT NULL — 알림 발생 시각(ms)
- created_at — DATETIME(6) — NOT NULL — 알림 생성 시각
instructor_notes
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → session_participants.session_id — NOT NULL — 메모 대상 세션 ID
- instructor_participant_id — BIGINT — Foreign key → session_participants.id — NOT NULL — 메모를 작성한 강사 세션 참여자 ID
- content — TEXT — 세션 전체 메모, 최대 5000자이며 빈 값 허용
- status — VARCHAR(20) — NOT NULL — DRAFT 또는 FINALIZED
- last_edited_at — DATETIME(6) — 마지막 입력 발생 시각
- finalized_at — DATETIME(6) — 수동 또는 자동 최종 확정 시각
- created_at — DATETIME(6) — NOT NULL — 메모 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 메모 수정 시각
instructor_report_insights
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- instructor_report_id — BIGINT — Foreign key → instructor_reports.id — NOT NULL — 인사이트가 포함된 강사 리포트 ID
- content — TEXT — NOT NULL — AI가 생성한 인사이트 내용
- started_offset_ms — BIGINT — 인사이트 대상 구간 시작 시각(ms), 전체 수업 대상이면 NULL
- ended_offset_ms — BIGINT — 인사이트 대상 구간 종료 시각(ms), 전체 수업 대상이면 NULL
- created_at — DATETIME(6) — NOT NULL — 인사이트 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 인사이트 수정 시각
- title — VARCHAR(200) — 인사이트 제목. AI 가 유형 목록 없이 직접 짓는다
- suggestion — TEXT — AI 가 제시한 개선 제안. content 는 그 제안의 근거다
instructor_report_scores
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- instructor_report_id — BIGINT — Foreign key → instructor_reports.id — NOT NULL — 평가 점수가 포함된 강사 리포트 ID
- evaluation_type — VARCHAR(30) — NOT NULL — DELIVERY, STRUCTURE_FLOW, INTERACTION 또는 DIFFICULTY_CONTROL
- score — TINYINT — NOT NULL — 분야별 평가 점수 0~100
- created_at — DATETIME(6) — NOT NULL — 평가 점수 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 평가 점수 수정 시각
instructor_reports
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → sessions.id — NOT NULL — 강사 리포트 대상 세션 ID
- overall_feedback — TEXT — NOT NULL — AI가 생성한 수업 종합 피드백
- published_at — DATETIME(6) — 강사 리포트 공개 완료 시각
- created_at — DATETIME(6) — NOT NULL — 강사 리포트 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 강사 리포트 수정 시각
- question_count — INT — 수업 전체에서 학생들이 남긴 질문 수. AI 가 공개 채팅에서 질문인 발화만 세어 판단한다
interaction_events
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → session_participants.session_id — NOT NULL — 상호작용이 발생한 세션 ID
- actor_participant_id — BIGINT — Foreign key → session_participants.id — 행위를 수행한 세션 참여자 ID, 시스템 이벤트는 NULL
- event_type — VARCHAR(50) — NOT NULL — 손들기, 이모지, 미디어 상태, 강사 제어 유형
- occurred_offset_ms — BIGINT — NOT NULL — 세션 시작 기준 발생 시각(ms)
- payload — JSON — NOT NULL — 이벤트 유형별 추가 데이터
- created_at — DATETIME(6) — NOT NULL — 이벤트 저장 시각
members
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- google_subject — VARCHAR(255) — NOT NULL — Google OAuth 사용자 고유 식별자
- email — VARCHAR(255) — NOT NULL — Google 계정 이메일
- display_name — VARCHAR(100) — NOT NULL — 서비스에 표시할 현재 이름
- profile_image_url — VARCHAR(500) — Google 프로필 이미지 주소
- created_at — DATETIME(6) — NOT NULL — 계정 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 계정 수정 시각
- deleted_at — DATETIME(6) — 소프트 삭제 시각
- retention_expires_at — DATETIME(6) — 최종 파기 예정 시각
- report_email_enabled — BOOLEAN — NOT NULL — 강의 리포트 완료 이메일 수신 여부. 기본 TRUE
notification_outbox
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — NOT NULL — 알림 대상 세션 ID
- member_id — BIGINT — NOT NULL — 수신 회원 ID
- email — VARCHAR(255) — NOT NULL — 발견 시점 스냅샷 이메일
- display_name — VARCHAR(100) — 발견 시점 스냅샷 이름
- type — VARCHAR(40) — NOT NULL — 알림 유형. 현재 REPORT_READY
- dedup_key — VARCHAR(200) — NOT NULL — 세션·수신자·유형 유일 키(멱등 등록)
- status — VARCHAR(30) — NOT NULL — 발송 상태. PENDING, IN_PROGRESS, SENT 또는 FAILED
- attempt_count — INT — NOT NULL — consumer 선점 횟수(백오프·재시도 상한 근거)
- next_attempt_at — DATETIME(6) — NOT NULL — 이 시각 이후에 다음 시도 가능(백오프)
- last_error — VARCHAR(500) — 마지막 발송 실패 사유(실패 기록)
- sent_at — DATETIME(6) — 발송 성공 시각
- created_at — DATETIME(6) — NOT NULL — 행 생성 시각(= 알림 등록 시각)
- updated_at — DATETIME(6) — NOT NULL — 상태 변경 시각
pipeline_jobs
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — NOT NULL — 사후 처리 대상 세션 ID
- status — VARCHAR(30) — NOT NULL — 처리 단계. QUEUED, TRANSCRIBING, ANALYZING, VALIDATING, PUBLISHED 또는 FAILED
- attempt_count — INT — NOT NULL — 현재 단계의 시도 횟수(백오프·재시도 상한 근거)
- next_attempt_at — DATETIME(6) — 이 시각 이후에 현재 단계를 재시도할 수 있다. 대기 중이 아니면 NULL
- last_error — VARCHAR(500) — 마지막 실패 사유(재시도·최종 실패 기록)
- created_at — DATETIME(6) — NOT NULL — 행 생성 시각(= 메모 확정 시각)
- updated_at — DATETIME(6) — NOT NULL — 단계 변경 시각
postclass_transcription_chunks
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — NOT NULL — 전사 대상 세션 ID
- recording_file_id — BIGINT — NOT NULL — 분할 대상 원본 트랙 파일(recording_files.id)
- chunk_index — INT — NOT NULL — 원본 안에서의 청크 순번(0부터)
- start_offset_ms — BIGINT — NOT NULL — FFmpeg segment CSV 의 원본 기준 시작 시각(ms). 절대 시간축 계산의 정본
- end_offset_ms — BIGINT — NOT NULL — FFmpeg segment CSV 의 원본 기준 종료 시각(ms)
- status — VARCHAR(30) — NOT NULL — PENDING, PROCESSING, SUCCEEDED, FAILED 또는 SKIPPED_SILENT
- attempt_count — INT — NOT NULL — 이 청크의 GMS 호출 시도 횟수
- lease_until — DATETIME(6) — PROCESSING 으로 선점한 시각의 만료점. 서버가 죽어 남은 행을 이 시각 이후에 회수한다
- next_attempt_at — DATETIME(6) — 이 시각 이후에 재시도할 수 있다. 대기 중이 아니면 NULL
- result_document — JSON — 성공한 청크의 전사 결과. 세그먼트 시각은 청크 기준 상대값이고 병합 시 start_offset_ms 를 더한다
- last_error — VARCHAR(500) — 마지막 실패 사유
- created_at — DATETIME(6) — NOT NULL — 행 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 상태 변경 시각
quiz_answers
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- quiz_question_id — BIGINT — Foreign key → quiz_options.quiz_question_id — NOT NULL — 응답한 퀴즈 문제 ID
- selected_quiz_option_id — BIGINT — Foreign key → quiz_options.id — NOT NULL — 학생이 선택한 퀴즈 선택지 ID
- answered_at — DATETIME(6) — NOT NULL — 문제 응답 시각
- created_at — DATETIME(6) — NOT NULL — 퀴즈 응답 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 퀴즈 응답 수정 시각
quiz_options
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- quiz_question_id — BIGINT — Foreign key → quiz_questions.id — NOT NULL — 선택지가 포함된 퀴즈 문제 ID
- option_text — TEXT — NOT NULL — 퀴즈 선택지 내용
- is_correct — BOOLEAN — NOT NULL — 정답 선택지 여부
- option_order — INT — NOT NULL — 문제 내 선택지 순서
- created_at — DATETIME(6) — NOT NULL — 퀴즈 선택지 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 퀴즈 선택지 수정 시각
quiz_questions
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- quiz_id — BIGINT — Foreign key → quizzes.id — NOT NULL — 문제가 포함된 AI 퀴즈 ID
- question_text — TEXT — NOT NULL — 퀴즈 문제 내용
- explanation — TEXT — 답안 제출 후 제공할 해설
- question_order — INT — NOT NULL — 퀴즈 내 문제 순서
- created_at — DATETIME(6) — NOT NULL — 퀴즈 문제 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 퀴즈 문제 수정 시각
- section_started_offset_ms — BIGINT — 문항이 가리키는 개념 설명 구간의 시작 시각(ms). 근거 구간을 특정하지 못했으면 NULL
quizzes
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- student_report_id — BIGINT — Foreign key → student_reports.id — NOT NULL — AI 퀴즈가 포함된 학생 리포트 ID
- title — VARCHAR(200) — NOT NULL — AI 퀴즈 제목
- description — TEXT — AI 퀴즈 설명
- estimated_duration_minutes — SMALLINT — 예상 풀이 시간(분)
- published_at — DATETIME(6) — 퀴즈 공개 완료 시각
- created_at — DATETIME(6) — NOT NULL — 퀴즈 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 퀴즈 수정 시각
recording_files
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → session_participants.session_id — NOT NULL — 녹화 파일이 속한 세션 ID
- recording_id — BIGINT — Foreign key → recordings.id — NOT NULL — 파일을 만든 녹화 실행 ID
- session_participant_id — BIGINT — Foreign key → session_participants.id — 개별 음성 파일의 화자 세션 참여자 ID
- file_type — VARCHAR(30) — NOT NULL — 파일 종류. 현재 Track Egress 만 저장하므로 TRACK 만 쓰인다(HLS, COMPOSITE, AUDIO 는 미사용)
- storage_key — VARCHAR(500) — NOT NULL — EC2 로컬 세션 디렉터리 기준 상대 경로. 절대 경로·드라이브 문자·상위 탈출을 넣지 않는다
- livekit_track_sid — VARCHAR(255) — 저장한 트랙의 LiveKit Track SID. 같은 트랙의 두 번째 세그먼트부터는 NULL
- started_offset_ms — BIGINT — 파일 또는 세그먼트 시작 시각(ms)
- ended_offset_ms — BIGINT — 파일 또는 세그먼트 종료 시각(ms)
- created_at — DATETIME(6) — NOT NULL — 파일 행 생성 시각
- track_source — VARCHAR(30) — 녹화된 트랙 종류. MICROPHONE, SCREEN_SHARE, SCREEN_SHARE_AUDIO, CAMERA(강사만)
recording_finalization_jobs
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — NOT NULL — 최종 병합 대상 세션 ID
- status — VARCHAR(30) — NOT NULL — PENDING, RUNNING, COMPLETED, FAILED
- attempt_count — INT — NOT NULL — 실제 worker 실행 횟수. Egress 정리 대기는 세지 않는다
- lease_token — INT — NOT NULL — RUNNING 실행권 fencing token
- lease_until — DATETIME(6) — RUNNING 실행권 만료 시각
- next_attempt_at — DATETIME(6) — 다음 실행 가능 시각
- last_error — VARCHAR(500) — 마지막 실패 사유. 경로·자격증명·원문은 넣지 않는다
- manifest_path — VARCHAR(500) — 컨테이너 내부 manifest 경로
- output_path — VARCHAR(500) — 컨테이너 내부 최종 MP4 경로
- output_size_bytes — BIGINT — 완성된 lecture.mp4 크기
- output_sha256 — CHAR(64) — 완성된 lecture.mp4 SHA-256
- started_at — DATETIME(6) — 첫 worker 실행 시작 시각
- completed_at — DATETIME(6) — 최종 MP4 확정 시각
- created_at — DATETIME(6) — NOT NULL
- updated_at — DATETIME(6) — NOT NULL
recording_outbox
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- dedup_key — VARCHAR(200) — NOT NULL — 중복 방지 키(예: track:{sessionId}:{trackSid})
- outbox_type — VARCHAR(40) — NOT NULL — 작업 종류(START_TRACK_EGRESS)
- session_id — BIGINT — NOT NULL — 대상 세션 ID
- payload — VARCHAR(2000) — NOT NULL — 작업 수행에 필요한 데이터(JSON, 익명 alias만 포함)
- status — VARCHAR(20) — NOT NULL — PENDING, IN_PROGRESS, COMPLETED 또는 FAILED
- attempt_count — INT — NOT NULL — 릴레이 시도 횟수(claim 시점에 증가)
- next_attempt_at — DATETIME(6) — NOT NULL — 이 시각 이후에만 릴레이가 소비한다(지수 백오프)
- last_error — VARCHAR(500) — 마지막 실패 사유
- created_at — DATETIME(6) — NOT NULL — 행 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 상태 수정 시각(IN_PROGRESS lease 만료 판단에 사용)
recording_webhook_events
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- event_id — VARCHAR(100) — NOT NULL — LiveKit webhook 이벤트 ID
- event_type — VARCHAR(60) — NOT NULL — track_published, egress_ended 등
- payload — TEXT — NOT NULL — 수신 원문(JSON) — 재처리·감사용
- status — VARCHAR(20) — NOT NULL — RECEIVED 또는 PROCESSED
- created_at — DATETIME(6) — NOT NULL — 수신 시각
- updated_at — DATETIME(6) — NOT NULL — 상태 수정 시각
recordings
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → sessions.id — NOT NULL — 녹화를 수행한 세션 ID
- livekit_egress_id — VARCHAR(255) — NOT NULL — LiveKit Egress 실행 식별자
- recording_type — VARCHAR(30) — NOT NULL — ROOM_COMPOSITE 또는 TRACK
- attempt_number — INT — NOT NULL — 최초 실행과 1회 재시도 순번
- status — VARCHAR(30) — NOT NULL — STARTING, RECORDING, COMPLETE, PARTIAL, FAILED
- started_at — DATETIME(6) — Egress 녹화 시작 시각
- ended_at — DATETIME(6) — Egress 녹화 종료 시각
- created_at — DATETIME(6) — NOT NULL — 녹화 행 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 녹화 상태 수정 시각
- session_participant_id — BIGINT — 이 Egress 가 녹화하는 트랙의 발행자 세션 참여자 ID. 종료 시 recording_files 로 옮긴다
- track_source — VARCHAR(30) — 녹화 대상 트랙 종류. MICROPHONE, SCREEN_SHARE, SCREEN_SHARE_AUDIO, CAMERA(강사만)
- livekit_track_sid — VARCHAR(255) — Egress 시작 시 지정한 LiveKit Track SID. webhook 페이로드에 track 정보가 없을 때의 정본
review_recommendations
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- student_report_id — BIGINT — Foreign key → student_reports.id — NOT NULL — 복습 추천이 포함된 학생 리포트 ID
- recommendation_type — VARCHAR(30) — NOT NULL — CONFUSED, MISSED, NO_RESPONSE, LOW_ENGAGEMENT 또는 QUESTION
- title — VARCHAR(200) — NOT NULL — 복습 추천 제목
- description — TEXT — NOT NULL — AI가 생성한 복습 추천 설명
- started_offset_ms — BIGINT — NOT NULL — 추천 복습 구간 시작 시각(ms)
- ended_offset_ms — BIGINT — NOT NULL — 추천 복습 구간 종료 시각(ms)
- priority — TINYINT — NOT NULL — 추천 우선순위, 값이 작을수록 먼저 노출
- created_at — DATETIME(6) — NOT NULL — 복습 추천 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 복습 추천 수정 시각
session_participants
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → sessions.id — NOT NULL — 참여한 세션 ID
- member_id — BIGINT — Foreign key → members.id — NOT NULL — 참여 회원 ID
- role — VARCHAR(20) — NOT NULL — INSTRUCTOR 또는 STUDENT
- first_joined_at — DATETIME(6) — 실제 미디어 연결이 확인된 최초 시각. NULL 이면 사후 자료 접근 자격이 없다. 입장 API 호출로는 채우지 않는다
- last_accessed_at — DATETIME(6) — 가장 최근 세션 접근 시각
- created_at — DATETIME(6) — NOT NULL — 참여자 행 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 참여자 행 수정 시각
session_reports
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → sessions.id — NOT NULL — 리포트 대상 세션 ID
- summary — TEXT — NOT NULL — 강사와 학생에게 공통으로 공개할 AI 수업 요약
- published_at — DATETIME(6) — 리포트 공개 완료 시각
- created_at — DATETIME(6) — NOT NULL — 리포트 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 리포트 수정 시각
session_sections
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → sessions.id — NOT NULL — 수업 내용 구간이 속한 세션 ID
- title — VARCHAR(200) — NOT NULL — 수업 내용 구간 제목
- summary — TEXT — 수업 내용 구간 요약
- started_offset_ms — BIGINT — NOT NULL — 수업 내용 구간 시작 시각(ms)
- ended_offset_ms — BIGINT — NOT NULL — 수업 내용 구간 종료 시각(ms)
- created_at — DATETIME(6) — NOT NULL — 수업 내용 구간 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 수업 내용 구간 수정 시각
session_status_changes
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → sessions.id — NOT NULL — 상태가 변경된 세션 ID
- from_status — VARCHAR(30) — 변경 전 미팅 상태, LIVE 또는 ENDED
- to_status — VARCHAR(30) — NOT NULL — 변경 후 미팅 상태, LIVE 또는 ENDED
- changed_at — DATETIME(6) — NOT NULL — 상태 전이 시각
- created_at — DATETIME(6) — NOT NULL — 행 생성 시각
sessions
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- host_member_id — BIGINT — Foreign key → members.id — NOT NULL — 세션을 생성하고 진행하는 강사 회원 ID
- title — VARCHAR(100) — NOT NULL — 수업 제목, 최대 100자
- invite_code — CHAR(8) — NOT NULL — 링크와 직접 입력에 함께 쓰는 참여 코드
- status — VARCHAR(30) — NOT NULL — 미팅 상태, LIVE 또는 ENDED
- started_at — DATETIME(6) — NOT NULL — 수업 시작 시각
- ended_at — DATETIME(6) — 수업 종료 시각
- note_due_at — DATETIME(6) — 강사 메모 자동 확정 예정 시각
- created_at — DATETIME(6) — NOT NULL — 세션 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 세션 수정 시각
- deleted_at — DATETIME(6) — 소프트 삭제 시각
- retention_expires_at — DATETIME(6) — 최종 파기 예정 시각
- analysis_status — VARCHAR(30) — NOT NULL — 분석 상태, NOT_STARTED, WAITING_FOR_NOTE, PROCESSING, COMPLETED 또는 FAILED
student_reports
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → session_participants.session_id — NOT NULL — 리포트 대상 세션 ID
- session_participant_id — BIGINT — Foreign key → session_participants.id — NOT NULL — 개인 리포트를 받는 학생 세션 참여자 ID
- participation_summary — TEXT — NOT NULL — AI가 생성한 학생 개인 참여도 요약
- published_at — DATETIME(6) — 개인 리포트 공개 완료 시각
- created_at — DATETIME(6) — NOT NULL — 개인 리포트 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 개인 리포트 수정 시각
- question_count — INT — 학생이 수업 중 남긴 질문 수. AI 가 공개 채팅에서 질문인 발화만 세어 판단한다
transcripts
- id — BIGINT — Primary key — NOT NULL — TSID 기본키
- session_id — BIGINT — Foreign key → sessions.id — NOT NULL — 전사 대상 세션 ID
- transcript_document — JSON — NOT NULL — 화자와 시간 구간을 포함한 전체 전사 JSON
- created_at — DATETIME(6) — NOT NULL — 전사 생성 시각
- updated_at — DATETIME(6) — NOT NULL — 전사 수정 시각