0.4v

테이블 (10)

교사 인증 코드 (teacher_invite_code)

  • 코드 ID (code_id) — BIGINT — 기본 키 — NOT NULL
  • 사용한 유저 ID (used_by_user_id) — BIGINT — 외래 키 → 유저.유저 ID — 가입 완료 시 세팅
  • 코드 (code) — VARCHAR(20) — NOT NULL — 사전 발급되는 교사 인증 코드, UNIQUE
  • 사용 여부 (is_used) — BOOLEAN — NOT NULL — 1회성 사용 여부
  • 발급 시각 (issued_at) — DATETIME — NOT NULL — 코드 유효성 검증에 필요
  • 사용 시각 (used_at) — DATETIME

그룹 (learning_group)

  • 그룹 ID (group_id) — BIGINT — 기본 키 — NOT NULL
  • 관리자 유저 ID (owner_user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL
  • 참여용 코드 (invite_code) — VARCHAR(20) — NOT NULL — UNIQUE
  • 그룹명 (group_name) — VARCHAR(100) — NOT NULL
  • 그룹 설명 (group_description) — VARCHAR(500)
  • 그룹 인원 (member_count) — INT — NOT NULL — 참여/탈퇴 시 트랜잭션으로 갱신

유저 (users)

  • 유저 ID (user_id) — BIGINT — 기본 키 — NOT NULL
  • 카카오 ID (kakao_id) — BIGINT — NOT NULL — 카카오 OAuth2.0에서 받아옴, 중복 가입 방지용 UNIQUE
  • 유저 역할 (role) — VARCHAR(255) — NOT NULL — ROLE_NO_INFO/ROLE_STUDENT/ROLE_TEACHER/ROLE_ADMIN
  • 실명 (real_name) — VARCHAR(255) — 온보딩 시 입력
  • 닉네임 (nickname) — VARCHAR(255) — 카카오 가입 시 자동 생성, 마이페이지에서 수정 가능
  • 이메일 (email) — VARCHAR(255) — NOT NULL — 카카오 OAuth2.0에서 받아옴
  • 핸드폰 번호 (phone_number) — VARCHAR(255) — 010-1234-1234 형식으로 하이픈 포함
  • 프로필 이미지 ID (profile_image_id) — INT — 프리셋 캐릭터 이미지 8종 중 선택(1~8)
  • 리프레시 토큰 해시 (refresh_token_hash) — VARCHAR(255) — 원문이 아닌 해시값 저장, 재로그인 시 덮어씀(1:1)
  • 리프레시 토큰 만료 시각 (refresh_token_expires_at) — DATETIME

유저 그룹 (group_member)

  • 유저 ID (user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL
  • 그룹 ID (group_id) — BIGINT — 외래 키 → 그룹.그룹 ID — NOT NULL

토론 발언 기록 (debate_transcript)

  • 발언 기록 ID (transcript_id) — BIGINT — 기본 키 — NOT NULL
  • 발언 유저 ID (user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL
  • 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL
  • 발언 내용 (transcript_content) — TEXT — NOT NULL
  • 발언 시각 (spoken_at) — DATETIME(3) — NOT NULL — 발언 시각 자체가 핵심 데이터
  • 발언 시간(ms) (speaking_duration_ms) — INT — NOT NULL

토론 주제 근거자료 (debate_topic_reference)

  • 근거자료 ID (reference_id) — BIGINT — 기본 키 — NOT NULL
  • 제목 (title) — VARCHAR(255) — NOT NULL — 근거자료 제목
  • 내용 (content) — TEXT — NOT NULL — 근거자료 원문(RAG 소스)
  • 임베딩 (embedding) — VECTOR(1536) — NOT NULL — pgvector 임베딩, RAG 유사도 검색용

토론 피드백 (debate_feedback)

  • 피드백 ID (feedback_id) — BIGINT — 기본 키 — NOT NULL
  • 피드백 대상 유저 ID (user_id) — BIGINT — 외래 키 → 유저.유저 ID — 개인 피드백이면 값 존재, 팀 피드백이면 NULL
  • 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL
  • 피드백 유형 (feedback_type) — VARCHAR(10) — NOT NULL — PERSONAL/TEAM
  • 진영 (side) — VARCHAR(10) — TEAM 피드백일 때만 사용(PRO/CON)
  • 피드백 내용 (feedback_content) — TEXT — NOT NULL — AI가 생성한 전체 피드백 리포트 원문

토론방 (debate_room)

  • 토론방 ID (debate_room_id) — BIGINT — 기본 키 — NOT NULL
  • 방장 유저 ID (host_user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL — 토론방 방장
  • 그룹 ID (group_id) — BIGINT — 외래 키 → 그룹.그룹 ID — NOT NULL
  • 방 이름 (room_name) — VARCHAR(100) — NOT NULL
  • 토론 주제 (debate_topic) — VARCHAR(500) — NOT NULL
  • 토론 종류 (debate_type) — VARCHAR(30) — NOT NULL
  • 생성 시각 (created_at) — DATETIME — NOT NULL — 목록 정렬·완료방 자동 정리 기준
  • 종료 시각 (ended_at) — DATETIME — 실시간 status는 Redis, 이건 영구 이력용

토론방 역할 설정 (debate_room_role)

  • 토론방 역할 ID (debate_room_role_id) — BIGINT — 기본 키 — NOT NULL
  • 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL — 같은 토론방 내 역할 번호는 중복 불가
  • 유저 ID (user_id) — BIGINT — 외래 키 → 유저.유저 ID — 역할 배정 전에는 NULL 가능
  • 역할 번호 (role_number) — INT — NOT NULL
  • 진영 (position) — VARCHAR(10) — NOT NULL — PRO/CON/OBSERVER
  • 역할명 (role_name) — VARCHAR(50)
  • 발언 가능 시간(초) (speaking_seconds) — INT — NOT NULL — 관전자는 0초, 역할별로 변경 가능

학생 성장 분석 (student_growth_analysis)

  • 분석 ID (analysis_id) — BIGINT — 기본 키 — NOT NULL
  • 분석 대상 유저 ID (user_id) — BIGINT — 외래 키 → 유저.유저 ID — NOT NULL
  • 토론방 ID (debate_room_id) — BIGINT — 외래 키 → 토론방.토론방 ID — NOT NULL — 어느 토론에서 나온 분석인지 추적
  • 분석 내용 (analysis_content) — TEXT — NOT NULL
  • 생성 시각 (created_at) — DATETIME — NOT NULL — 성장추이 그래프 x축으로 직접 사용